$Web_Sel_Check

From m204wiki
Revision as of 16:00, 15 June 2012 by Alan (talk | contribs)
Jump to navigation Jump to search

<section begin="desc" />Check string against a global select element<section end="desc" />

$Web_Sel_Check validates that a string matches one of the options of a global select element. An overview of the $WEB_SEL_x functions is provided in $Web_Selp.

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

Syntax

<section begin="syntax" /> %RC = $Web_Sel_Check(global_name, selected_value, option_keywords) <section end="syntax" />

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. This is a required argument.
selected_value A string which is checked to see if it is equal to one of the values in the options list. This a required argument.
option_keywords A string of blank-separated keywords specifying special processing for this $function. Any of the following is valid:
CANCHECK Cancel request if selected_value not found in select options list
NOCAN Don't cancel request if global select element global_name not found

This an optional argument.

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

$WEB_SEL_CHECK return codes

The following statement will cancel the User Language request if the string 'DAY6' is not one of the values of the global select element 'DAYS.ESPERANTO':

%RC = $Web_Sel_Check('DAYS.ESPERANTO', 'DN6', 'CANCHECK')

See $Web_Selp for an extended example using other $WEB_SELx functions.