CRequest::getFormNameValue

The CRequest::getFormNameValue function retrieves all name/value pairs that were read by POST or GET method.

int getFormNameValue(
chstrarray &names // containing all names
chstrarray &values // containing all values
);

Return Type

int
Upon successful completion, the number of name/value pairs is returned. Otherwise, -1 is returned.

Parameters

names
A reference of an array that contains names of the pairs.

values
A reference of an array that contains values of the pairs.

Remarks

This function retrieves all pairs of name and value that were read by POST or GET method. The name and value in one pair will be saved in corresponding positions of the retrieved arrays. CRequest::getForms function retrieves all values of items with the same name and CRequest::getForm function retrieves a value of the specified name.