$Web Sels Check: Difference between revisions

From m204wiki
Jump to navigation Jump to search
mNo edit summary
Line 2: Line 2:
<span class="pageSubtitle"><section begin="desc" />Check string against a delimited list of strings<section end="desc" /></span>
<span class="pageSubtitle"><section begin="desc" />Check string against a delimited list of strings<section end="desc" /></span>


$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_SELx functions, it is somewhat unnecessary; a simple $ONEOF could do basically the same thing. An overview of the $WEB_SEL_x functions is provided in [[$Web_Selp]].  
<var>$Web_Sels_Check</var> 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 <var>$Oneof<var> could do basically the same thing. An overview of the $Web_Sel* functions is provided in <var>[[$Web_Selp]]</var>.  


$Web_Sels_Check takes three arguments and returns a numeric result code; for some types of errors, the current <var class="product">User Language</var> request is cancelled.
$Web_Sels_Check takes three arguments and returns a numeric result code; for some types of errors, the current <var class="product">User Language</var> request is cancelled.

Revision as of 18:40, 15 June 2012

<section begin="desc" />Check string against a delimited list of strings<section end="desc" />

$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

<section begin="syntax" />%rc = $Web_Sels_Check(delimited_strings, selected_value, [option_keywords]) <section end="syntax" />

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:
CANCHECK Cancel request if selected_value not equal to any of the delimited strings

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

  1. 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')

  2. See $Web_Selp for an extended example using other $Web_Sel* functions.