$Web Selp Check: Difference between revisions

From m204wiki
Jump to navigation Jump to search
(Automatically generated page update)
(Automatically generated page update)
Line 7: Line 7:


==Syntax==
==Syntax==
<p class="syntax"><span class="term">%rc</span> = $Web_Selp_Check(global_name, param_name, [option_keywords])
<p class="syntax"><span class="term">%rc</span> = <span class="literal">$Web_Selp_Check</span>(<span class="term">global_name, param_name, [option_keywords])
</p>
</p>



Revision as of 19:56, 12 April 2013

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.