CRequest::getForms

The CRequest::getForms function retrieves all values of a specified name which were read by POST or GET method.

int * getForms(
chchar * name // containing the name of the specified item
chstrarray * values // containing the multiple values of the specified name
);

Return Type

int
Upon successful completion, number of repeated values of a specified name is returned. Otherwise, zero is returned.

Parameters

name
A string which contains the name of the specified item.

values
A reference of an array which contains the multiple values of the specified name.

Remarks

This function retrieves all values of a specified name which were read by POST or GET method. The CRequest::getForm function retrieves one value of a specified name and the CRequest::getFormNameValue function retrieves all pairs of name and value.