$Web Selp Check

Check parameters against a global select element

$Web_Selp_Check validates that each value of a form and/or isindex parameter matches one of the options of a global select element. An overview of the $Web_Sel_xxx functions is provided in $Web_Selp.

$Web_Selp_Check takes three arguments and returns a numeric result code; for some types of errors, the current User Language request is cancelled.

Syntax

%rc = $Web_Selp_Check(global_name, param_name, [option_keywords])

Syntax terms

global_name	The name of the global select element containing the values to check against. The global select element with this name must have been created by $Web_Save_Sel.
param_name	The name of a form and/or an index parameter in the current web request. For each occurrence of this parameter, its value is checked to see if it is equal to one of the values in the options list.
option_keywords	An optional argument that is a string of blank-separated keywords specifying special processing for this $function; it can contain any of the following: CANCHECK Cancel request if any value of param_name not found in select options list NOCAN Don't cancel request if global_name not found NOFORM Don't look in form parameters NOISINDEX Don't look in isindex parameters NOISI Synonym for NOISINDEX

Return codes

Code	Meaning
0	All values of param_name equal to some value in global select element global_name.
1	Global_name not a saved global select element, and NOCAN option specified.
2	Some value of param_name not equal to any value in global select element global_name, and CANCHECK option not specified.
	Any other error results in cancellation of the User Language request.

Examples

See $Web_Selp for an extended example which includes use of $Web_Selp_Check.