$Abbrev

Determine if string is abbreviation within list of words

Most Sirius $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

<section begin="syntax" />%result = $Abbrev(word_list, string) <section end="syntax" />

%result is a numeric value that indicates the relative position in word_list of the first word for which string is a valid abbreviation.

The first argument is a list of blank-delimited words.

The second argument is the word to be compared with the blank-delimited word_list argument.

Return codes

>0 - Number of matching word 0 - No matches found -1 - First parameter missing or null -2 - Second parameter missing or null

Examples

1. In the following example, %NUM is set to 2:

   %NUM = $Abbrev('TOP BOTTOM MIDDLE MUDDLE', 'B')

2. In the following example, %NUM is set to 3:

   %NUM = $Abbrev('TOP BOTTOM MIDDLE MUDDLE', 'M')

3. In the following example, %NUM is set to 4:

   %NUM = $Abbrev('TOP BOTTOM MIDDLE MUDDLE', 'MU')

4. In the following example, %NUM is set to 1:

   %NUM = $Abbrev('TOP BOTTOM MIDDLE MUDDLE', 'TOP')

5. In the following example, %NUM is set to 0:

   %NUM = $Abbrev('TOP BOTTOM MIDDLE MUDDLE', 'MAD')

Products authorizing $Abbrev

• Sirius functions
• Fast/Unload User Language Interface
• Janus Open Client
• Janus Open Server
• Janus Sockets
• Janus Web Server
• Japanese functions
• Sir2000 Field Migration Facility