$Web_Sels_Check
Check string against a delimited list of strings
$Web_Sels_Check validates that a string matches one of a delimited list of strings. Note that although this is provided for a sort of symmetry in the $Web_Sel* functions, it is somewhat unnecessary; a simple $Oneof could do basically the same thing. An overview of the $Web_Sel* functions is provided in $Web_Selp.
$Web_Sels_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_Sels_Check(delimited_strings, [selected_value], [option_keywords])
Syntax terms
| delimited_strings | A string containing a delimited list of strings which are used to check the string. The first character of this argument is the delimiter that separates the values. The string should not contain a trailing delimiter unless one of the values is the null string, which is unlikely, at least when used with select option lists. This is a required argument. | ||
|---|---|---|---|
| selected_value | This optional argument is a string which is checked to see if it is equal to one of the delimited strings. This a required argument. | ||
| option_keywords | A string of blank-separated keywords specifying special processing for this $function; it can contain any of the following:
|
Return codes
| Code | Meaning |
|---|---|
| 0 | selected_value equal to one of the delimited strings. |
| 2 | selected_value not equal to any of the delimited strings, and CANCHECK option not specified. |
| Any other error results in cancellation of the User Language request. |
Examples
- The following statement will cancel the User Language request if the value of variable %SEL is not one of the stringsDN0, DN1, etc.:
%RC = $Web_Sels_Check('/DN0/DN1/DN2/DN3/DN4' - WITH '/DN5/DN6', %SEL, 'CANCHECK')
- See $Web_Selp for an extended example using other $Web_Sel* functions.