#include <cgicc/Cgicc.h>
Public Member Functions | |
Overloaded Operators | |
bool | operator== (const Cgicc &cgi) const |
Compare two Cgiccs for equality. | |
bool | operator!= (const Cgicc &cgi) const |
Compare two Cgiccs for inequality. | |
Cgicc & | operator= (const Cgicc &cgi) |
Assign one Cgicc to another. | |
Library Information | |
Information on this installation of cgicc | |
const char * | getCompileDate () const |
Get the date on which this library was compiled. | |
const char * | getCompileTime () const |
Get the time at which this library was compiled. | |
const char * | getVersion () const |
Get the version number of cgicc. | |
const char * | getHost () const |
Get the platform for which Cgicc was configured. | |
Form Element Access | |
Information on submitted form elements | |
bool | queryCheckbox (const std::string &elementName) const |
Query whether a checkbox is checked. | |
form_iterator | operator[] (const std::string &name) |
Find a radio button in a radio group, or a selected list item. | |
std::string | operator() (const std::string &name) const |
Find a radio button in a radio group, or a selected list item. | |
const_form_iterator | operator[] (const std::string &name) const |
Find a radio button in a radio group, or a selected list item. | |
form_iterator | getElement (const std::string &name) |
Find a radio button in a radio group, or a selected list item. | |
const_form_iterator | getElement (const std::string &name) const |
Find a radio button in a radio group, or a selected list item. | |
bool | getElement (const std::string &name, std::vector< FormEntry > &result) const |
Find multiple checkboxes in a group or selected items in a list. | |
form_iterator | getElementByValue (const std::string &value) |
Find a radio button in a radio group, or a selected list item. | |
const_form_iterator | getElementByValue (const std::string &value) const |
Find a radio button in a radio group, or a selected list item. | |
bool | getElementByValue (const std::string &value, std::vector< FormEntry > &result) const |
Find multiple checkboxes in a group or selected items in a list. | |
const std::vector< FormEntry > & | operator * () const |
Get all the submitted form entries, excluding files. | |
const std::vector< FormEntry > & | getElements () const |
Get all the submitted form elements, excluding files. | |
Uploaded File Access | |
file_iterator | getFile (const std::string &name) |
Find an uploaded file. | |
const_file_iterator | getFile (const std::string &name) const |
Find an uploaded file. | |
const std::vector< FormFile > & | getFiles () const |
Environment Access | |
const CgiEnvironment & | getEnvironment () const |
Save and Restore | |
void | save (const std::string &filename) const |
Save the current CGI environment to a file. | |
void | restore (const std::string &filename) |
Restore from a previously-saved CGI environment. |
Cgicc is used to retrieve information on specific HTML form elements (such as checkboxes, radio buttons, and text fields), on uploaded files, and to save, restore, and retrieve information on the CGI environment.
Normally, you will instantiate an object of this type in main()
:
int main(int argc, char **argv) { try { cgicc::Cgicc cgi; // do something with cgi } catch(const exception& e) { //handle the error } }
Definition at line 103 of file Cgicc.h.
cgicc::Cgicc::Cgicc | ( | CgiInput * | input = 0 |
) |
cgicc::Cgicc::Cgicc | ( | const Cgicc & | cgi | ) | [inline] |
cgicc::Cgicc::~Cgicc | ( | ) |
Destructor.
Delete this Cgicc object
cgicc::Cgicc::Cgicc | ( | CgiInput * | input = 0 |
) |
cgicc::Cgicc::Cgicc | ( | const Cgicc & | cgi | ) | [inline] |
cgicc::Cgicc::~Cgicc | ( | ) |
Destructor.
Delete this Cgicc object
bool cgicc::Cgicc::operator== | ( | const Cgicc & | cgi | ) | const [inline] |
Compare two Cgiccs for equality.
Cgiccs are equal if they represent the same environment.
cgi | The Cgicc to compare to this one. |
true
if the two Cgiccs are equal, false
otherwise. Definition at line 154 of file Cgicc.h.
References fEnvironment.
bool cgicc::Cgicc::operator!= | ( | const Cgicc & | cgi | ) | const [inline] |
const char* cgicc::Cgicc::getCompileDate | ( | ) | const |
Get the date on which this library was compiled.
This is a string of the form mmm dd yyyy
.
Referenced by main().
const char* cgicc::Cgicc::getCompileTime | ( | ) | const |
Get the time at which this library was compiled.
This is a string of the form hh:mm:ss
in 24-hour time.
Referenced by main().
const char* cgicc::Cgicc::getVersion | ( | ) | const |
Get the version number of cgicc.
The version number is a string of the form #
.#.
Referenced by main().
const char* cgicc::Cgicc::getHost | ( | ) | const |
bool cgicc::Cgicc::queryCheckbox | ( | const std::string & | elementName | ) | const |
Query whether a checkbox is checked.
elementName | The name of the element to query |
true
if the desired checkbox was checked, false
if not Referenced by main(), and showForm().
form_iterator cgicc::Cgicc::operator[] | ( | const std::string & | name | ) | [inline] |
std::string cgicc::Cgicc::operator() | ( | const std::string & | name | ) | const |
Find a radio button in a radio group, or a selected list item.
name | The name of the radio button or list item to find. |
const_form_iterator cgicc::Cgicc::operator[] | ( | const std::string & | name | ) | const [inline] |
form_iterator cgicc::Cgicc::getElement | ( | const std::string & | name | ) |
Find a radio button in a radio group, or a selected list item.
name | The name of the radio button or list item to find. |
Referenced by main(), and showForm().
const_form_iterator cgicc::Cgicc::getElement | ( | const std::string & | name | ) | const |
Find a radio button in a radio group, or a selected list item.
name | The name of the radio button or list item to find. |
bool cgicc::Cgicc::getElement | ( | const std::string & | name, | |
std::vector< FormEntry > & | result | |||
) | const |
Find multiple checkboxes in a group or selected items in a list.
name | The name of the checkboxes or list to find. | |
result | A vector to hold the result. |
true
if any elements were found, false
if not. form_iterator cgicc::Cgicc::getElementByValue | ( | const std::string & | value | ) |
Find a radio button in a radio group, or a selected list item.
value | The value of the radio button or list item to find. |
const_form_iterator cgicc::Cgicc::getElementByValue | ( | const std::string & | value | ) | const |
Find a radio button in a radio group, or a selected list item.
value | The value of the radio button or list item to find. |
bool cgicc::Cgicc::getElementByValue | ( | const std::string & | value, | |
std::vector< FormEntry > & | result | |||
) | const |
Find multiple checkboxes in a group or selected items in a list.
value | The value of the checkboxes or list to find. | |
result | A vector to hold the result. |
const std::vector<FormEntry>& cgicc::Cgicc::operator * | ( | ) | const [inline] |
const std::vector<FormEntry>& cgicc::Cgicc::getElements | ( | ) | const [inline] |
Get all the submitted form elements, excluding files.
Definition at line 348 of file Cgicc.h.
Referenced by dumpList(), and main().
file_iterator cgicc::Cgicc::getFile | ( | const std::string & | name | ) |
Find an uploaded file.
name | The name of the file. |
Referenced by main().
const_file_iterator cgicc::Cgicc::getFile | ( | const std::string & | name | ) | const |
Find an uploaded file.
name | The name of the file. |
const std::vector<FormFile>& cgicc::Cgicc::getFiles | ( | ) | const [inline] |
const CgiEnvironment& cgicc::Cgicc::getEnvironment | ( | ) | const [inline] |
Get the current runtime environment.
Definition at line 394 of file Cgicc.h.
Referenced by main(), and printForm().
void cgicc::Cgicc::save | ( | const std::string & | filename | ) | const |
Save the current CGI environment to a file.
This is useful for debugging CGI applications.
filename | The name of the file to which to save. |
Referenced by main().
void cgicc::Cgicc::restore | ( | const std::string & | filename | ) |
Restore from a previously-saved CGI environment.
This is useful for debugging CGI applications.
filename | The name of the file from which to restore. |
Referenced by main().