Words (String function)
Sublist of list of words (String class)
[Introduced in Sirius Mods 7.9]
Words returns a substring of the method object string using word counts. The method returns a specified number of words, starting from a specified word and including consecutive following words.
Note that processing a string of words may be better accomplished with the StringTokenizer class.
Syntax
%outString = string:Words( start, [count], [Spaces= string])
Syntax terms
| %outString | The returned substring of string. %outString contains as many words as count, including and continuing from word number start. |
|---|---|
| string | The method object string, from which substring %outString is extracted. |
| start | The number of the word in string that is the start of the extracted %outString. start must be greater than or equal to 1, which designates the first word. If start is greater than the number of words in string, the null string is returned. |
| count | The number of words in string to extract to %outString. This is an optional argument; the default is to extract the rest of string starting at word number start. If count is greater than the number of words remaining in string starting with word number start, the remainder of the string starting at word number start is returned. This argument must be non-negative; if zero, the null string is returned. |
| Spaces | A set of "whitespace" characters, that is, characters that separate words. The default is the blank character. If the null string is provided, the blank character is used as the whitespace character. |
Usage notes
- Words is the OO version of $Lstr_SubWord.
Examples
The following fragment:
PrintText {~='aa bb cc':Words(2)}. PrintText {~='aa bb cc':Words(1, 2)}. PrintText {~='aa bb cc':Words(4, 1)}. PrintText {~='aa bb cc':Words(3, 2)}. PrintText {~='aa bb cc':Words(2, 0)}.
produces the following result:
'aa bb cc':Words(2)=bb cc. 'aa bb cc':Words(1, 2)=aa bb. 'aa bb cc':Words(4, 1)=. 'aa bb cc':Words(3, 2)=cc. 'aa bb cc':Words(2, 0)=.
See also
- List of StringTokenizer methods
- Word, which selects a word from a list of words
- WordCount, which counts the words in a list
- WordNumberIn and WordNumberOf, which returns the word number of a "needle" word within a "haystack" list of words