$Web Selp Check: Difference between revisions

Latest revision as of 17:12, 16 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.

@@ Line 42: / Line 42: @@
 <tr><th>Code</th>
 <th>Meaning</th></tr>
-<tr><th>0</th>
-<td>'''All''' values of ''param_name'' equal to some value in
+<tr><td>0</td>
-global select element ''global_name''. </td></tr>
+<td>'''All''' values of <var class="term">param_name</var> equal to some value in
-<tr><th>1</th>
+global select element <var class="term">global_name</var>. </td></tr>
-<td>''Global_name'' not a saved global select element, and NOCAN option
+<tr><td>1</td>
+<td>''Global_name'' not a saved global select element, and <var>NOCAN</var> option
 specified.</td></tr>
-<tr><th>2</th>
-<td>'''Some''' value of ''param_name'' not equal to any value in
+<tr><td>2</td>
-global select element ''global_name'', and CANCHECK option not specified.</td></tr>
+<td>'''Some''' value of <var class="term">param_name</var> not equal to any value in
+global select element <var class="term">global_name</var>, and <var>CANCHECK</var> option not specified.</td></tr>
 <tr><th></th>
 <td>Any other error results in cancellation of the <var class="product">User Language</var> request.</td></tr>