$Web Selp Check: Difference between revisions

From m204wiki
Jump to navigation Jump to search
m (1 revision)
(Automatically generated page update)
Line 1: Line 1:
{{DISPLAYTITLE:$Web_Selp_Check}}
{{DISPLAYTITLE:$Web_Selp_Check}}
<span class="pageSubtitle"><section begin="desc" />Check parameters against a global select element<section end="desc" /></span>
<span class="pageSubtitle">Check parameters against a global select element</span>


<var>$Web_Selp_Check</var> 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 <var>$Web_Sel_xxx</var> functions is provided in <var>[[$Web_Selp]]</var>.  
<var>$Web_Selp_Check</var> 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 <var>$Web_Sel_xxx</var> functions is provided in <var>[[$Web_Selp]]</var>.  
Line 7: Line 7:


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


===Syntax terms===
===Syntax terms===

Revision as of 18:18, 10 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.