$Abbrev: Difference between revisions
mNo edit summary |
(Automatically generated page update) |
||
(26 intermediate revisions by 5 users not shown) | |||
Line 1: | Line 1: | ||
{{DISPLAYTITLE:$Abbrev}} | {{DISPLAYTITLE:$Abbrev}} | ||
<span class="pageSubtitle">Determine if string is abbreviation within list of words</span> | <span class="pageSubtitle">Determine if string is abbreviation within list of words</span> | ||
<p> | <p class="warn"><b>Note:</b> <i>Many $functions have been deprecated in favor of Object Oriented methods. There is currently no direct OO equivalent for <var>$Abbrev</var>. However, the <var>[[IsStartOf (String function)|IsStartOf]]</var> function can be used to determine whether one string is an initial substring (abbreviation) of another.</i></p> | ||
This function makes it possible to determine if a string is a valid abbreviation of one of a list of words. | This function makes it possible to determine if a string is a valid abbreviation of one of a list of words. | ||
==Syntax== | ==Syntax== | ||
<p class="syntax">< | <p class="syntax"><span class="term">%result</span> = <span class="literal">$Abbrev</span>(<span class="term">word_list</span>, <span class="term">string</span>) | ||
< | </p> | ||
===Syntax terms=== | |||
<table> | |||
<tr><th>%result</th> | |||
<td>A numeric value that indicates the relative position in <var class="term">word_list</var> of the first word for which <var class="term">string</var> is a valid abbreviation.</td></tr> | |||
< | <tr><th>word_list</th> | ||
<td>A list of blank-delimited words. </td></tr> | |||
The | <tr><th>string</th> | ||
<td>The word to be compared with the <var class="term">word_list</var> argument. </td></tr> | |||
</table> | |||
===Return codes=== | ===Return codes=== | ||
<p class="code">>0 - Number of matching word | <p class="code">>0 - Number of matching word | ||
0 - No matches found | 0 - No matches found | ||
- | -2 - First parameter missing or null | ||
- | -1 - Second parameter missing or null | ||
</p> | </p> | ||
==Examples== | ==Examples== | ||
Line 48: | Line 53: | ||
==Products authorizing {{PAGENAMEE}}== | ==Products authorizing {{PAGENAMEE}}== | ||
<ul class="smallAndTightList"> | <ul class="smallAndTightList"> | ||
<li>[[Sirius functions]]</li> | <li>[[List of $functions|Sirius functions]]</li> | ||
<li>[[Fast/Unload User Language Interface]]</li> | <li>[[Fast/Unload User Language Interface]]</li> | ||
<li>[[Janus Open Client]]</li> | <li>[[Media:JoclrNew.pdf|Janus Open Client]]</li> | ||
<li>[[Janus Open Server]]</li> | <li>[[Media:JosrvrNew.pdf|Janus Open Server]]</li> | ||
<li>[[Janus Sockets]]</li> | <li>[[Janus Sockets]]</li> | ||
<li>[[Janus Web Server]]</li> | <li>[[Janus Web Server]]</li> | ||
<li> | <li>Japanese functions</li> | ||
<li>[[Sir2000 Field Migration Facility]]</li> | <li>[[Media:SirfieldNew.pdf|Sir2000 Field Migration Facility]]</li> | ||
</ul> | </ul> | ||
[[Category:$Functions|$Abbrev]] | [[Category:$Functions|$Abbrev]] |
Latest revision as of 22:51, 20 September 2018
Determine if string is abbreviation within list of words
Note: Many $functions have been deprecated in favor of Object Oriented methods. There is currently no direct OO equivalent for $Abbrev. However, the IsStartOf function can be used to determine whether one string is an initial substring (abbreviation) of another.
This function makes it possible to determine if a string is a valid abbreviation of one of a list of words.
Syntax
%result = $Abbrev(word_list, string)
Syntax terms
%result | A numeric value that indicates the relative position in word_list of the first word for which string is a valid abbreviation. |
---|---|
word_list | A list of blank-delimited words. |
string | The word to be compared with the word_list argument. |
Return codes
>0 - Number of matching word 0 - No matches found -2 - First parameter missing or null -1 - Second parameter missing or null
Examples
- In the following example, %NUM is set to 2:
%NUM = $Abbrev('TOP BOTTOM MIDDLE MUDDLE', 'B')
- In the following example, %NUM is set to 3:
%NUM = $Abbrev('TOP BOTTOM MIDDLE MUDDLE', 'M')
- In the following example, %NUM is set to 4:
%NUM = $Abbrev('TOP BOTTOM MIDDLE MUDDLE', 'MU')
- In the following example, %NUM is set to 1:
%NUM = $Abbrev('TOP BOTTOM MIDDLE MUDDLE', 'TOP')
- In the following example, %NUM is set to 0:
%NUM = $Abbrev('TOP BOTTOM MIDDLE MUDDLE', 'MAD')