$Words: Difference between revisions

From m204wiki
Jump to navigation Jump to search
mNo edit summary
mNo edit summary
 
Line 2: Line 2:
The <var>$Words</var> function returns the number of words in a specified string, delimited by a blank or optionally specified character.</p>
The <var>$Words</var> function returns the number of words in a specified string, delimited by a blank or optionally specified character.</p>


===Syntax===
==Syntax==
<p>The format of the <var>$Words</var> function is:</p>
<p>The format of the <var>$Words</var> function is:</p>
<p class="syntax">$Words('<span class="term">inputstring</span>', ['<span class="term">delimiter'</span>])
<p class="syntax">$Words('<span class="term">inputstring</span>', ['<span class="term">delimiter'</span>])
Line 14: Line 14:
</ul>
</ul>


===Usage===
==Usage==
<p>
<p>
Null values between delimiters are not considered words. For example,</p>
Null values between delimiters are not considered words. For example,</p>
Line 21: Line 21:
<p>returns a count of three words, not four.</p>
<p>returns a count of three words, not four.</p>


===Example===
==Example==
<p>
<p>
The following function returns 4, the number of words in the string when a blank delimits a word:</p>
The following function returns 4, the number of words in the string when a blank delimits a word:</p>

Latest revision as of 15:34, 18 August 2014

The $Words function returns the number of words in a specified string, delimited by a blank or optionally specified character.

Syntax

The format of the $Words function is:

$Words('inputstring', ['delimiter'])

Where:

  • inputstring is the input from which the specified word is to be extracted. inputstring can be a quoted literal or a %variable.
  • delimiter is an optional character to be used as a delimiter in parsing the input string into words. If delimiter is not specified, it defaults to a blank space.

Usage

Null values between delimiters are not considered words. For example,

$Words('ABC==D=XXX','=')

returns a count of three words, not four.

Example

The following function returns 4, the number of words in the string when a blank delimits a word:

$words ('NOW IS THE TIME')