$Web Sel Check: Difference between revisions
mNo edit summary |
mNo edit summary |
||
| Line 4: | Line 4: | ||
$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 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. | $Web_Sel_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" /> %RC = $Web_Sel_Check(global_name, selected_value, option_keywords) | <p class="syntax"><section begin="syntax" /> %RC = $Web_Sel_Check(global_name, selected_value, option_keywords) | ||
| Line 35: | Line 35: | ||
<td>''Selected_value'' not equal to any of the values in global select element ''global_name'', and CANCHECK option not specified.</td></tr> | <td>''Selected_value'' not equal to any of the values in global select element ''global_name'', and CANCHECK option not specified.</td></tr> | ||
<tr><th></th> | <tr><th></th> | ||
<td>Any other error results in cancellation of the User Language request.</td></tr> | <td>Any other error results in cancellation of the <var class="product">User Language</var> request.</td></tr> | ||
</table> | </table> | ||
<p class="caption">$WEB_SEL_CHECK return codes</p> | <p class="caption">$WEB_SEL_CHECK return codes</p> | ||
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': | The following statement will cancel the <var class="product">User Language</var> request if the string 'DAY6' is not one of the values of the global select element 'DAYS.ESPERANTO': | ||
<p class="code"> %RC = $Web_Sel_Check('DAYS.ESPERANTO', 'DN6', 'CANCHECK') | <p class="code"> %RC = $Web_Sel_Check('DAYS.ESPERANTO', 'DN6', 'CANCHECK') | ||
Revision as of 16:00, 15 June 2012
<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:
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.