$Web Sels Check: Difference between revisions
Jump to navigation
Jump to search
m (1 revision) |
mNo edit summary |
||
| Line 1: | Line 1: | ||
{{DISPLAYTITLE:$Web_Sels_Check}} | {{DISPLAYTITLE:$Web_Sels_Check}} | ||
<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]]. | $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]]. | ||
$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. | ||
==Syntax== | ==Syntax== | ||
<p class="syntax"><section begin="syntax" /> % | <p class="syntax"><section begin="syntax" />%rc = $Web_Sels_Check(delimited_strings, selected_value, [option_keywords]) | ||
<section end="syntax" /></p> | <section end="syntax" /></p> | ||
===Syntax terms=== | |||
<table class="syntaxTable"> | <table class="syntaxTable"> | ||
<tr><th>delimited_strings</th> | <tr><th>delimited_strings</th> | ||
<td>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.</td></tr> | |||
<tr><th>selected_value</th> | <tr><th>selected_value</th> | ||
<td>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.</td></tr> | |||
<td> | |||
<tr><th>option_keywords</th> | <tr><th>option_keywords</th> | ||
<td>A string of blank-separated keywords specifying special processing for this $function; it can contain any of the following:<table class="syntaxTable"> | |||
<td>A string of blank-separated keywords specifying special processing for this $function; it can contain any of the following:< | |||
<tr><th>CANCHECK</th> | <tr><th>CANCHECK</th> | ||
<td>Cancel request if ''selected_value'' not equal to any of the delimited strings | <td>Cancel request if ''selected_value'' not equal to any of the delimited strings | ||
</td></tr></table> | </td></tr></table> | ||
</td></tr></table> | </td></tr></table> | ||
===Return codes=== | |||
<table class="syntaxTable"> | <table class="syntaxTable"> | ||
<tr><th>Code</th> | <tr><th>Code</th> | ||
< | <th>Meaning</th></tr> | ||
<tr><th>0</th> | <tr><th>0</th> | ||
<td>''Selected_value'' equal to one of the delimited strings.</td></tr> | <td>''Selected_value'' equal to one of the delimited strings.</td></tr> | ||
<tr><th>2</th> | <tr><th>2</th> | ||
<td>''Selected_value'' not equal to any of the delimited strings, | <td>''Selected_value'' not equal to any of the delimited strings, and CANCHECK option not specified.</td></tr> | ||
and CANCHECK option not specified.<tr><th></th> | <tr><th></th> | ||
<td>Any other error results in cancellation of the <var class="product">User Language</var> request.</td></tr> | <td>Any other error results in cancellation of the <var class="product">User Language</var> request.</td></tr> | ||
</table> | </table> | ||
==Examples== | |||
<ol> | |||
<li>The following statement will cancel the <var class="product">User Language</var> request if the value of variable <tt>%SEL</tt> is not one of the strings<tt>DN0</tt>, <tt>DN1</tt>, etc.: | |||
<p class="code"> %RC = $Web_Sels_Check('/DN0/DN1/DN2/DN3/DN4' - | <p class="code"> %RC = $Web_Sels_Check('/DN0/DN1/DN2/DN3/DN4' - | ||
WITH '/DN5/DN6', %SEL, 'CANCHECK') | WITH '/DN5/DN6', %SEL, 'CANCHECK') | ||
</p> | </p> | ||
<li>See [[$Web_Selp]] for an extended example using other $Web_Sel* functions. | |||
See [[$Web_Selp]] for an extended example using other $ | </ol> | ||
[[Category:Janus Web Server $functions|$Web_Sels_Check]] | [[Category:Janus Web Server $functions|$Web_Sels_Check]] | ||
Revision as of 18:38, 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_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.
$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:
|
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.