$Lstr_Word

From m204wiki
Revision as of 22:18, 8 February 2011 by 198.242.244.47 (talk) (Created page with "{{DISPLAYTITLE:$Lstr_Word}} <span class="pageSubtitle"><section begin="desc" />Return a word from a long string<section end="desc" /></span> <p class="warning">Most Sirius $func...")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

<section begin="desc" />Return a word from a long string<section end="desc" />

Most Sirius $functions have been deprecated in favor of Object Oriented methods. The OO equivalent for the $Lstr_Word function is to be entered.

This function takes a longstring input and a word number and returns a longstring containing a single word. A null string is returned if the word count in the input longstring is less than the word number.

The $Lstr_Word function accepts three arguments and returns a longstring result.

The first argument is an arbitrary longstring. This is a required argument.

The second argument is the number of the desired word. The first word in the input longstring is word 1.

The third argument is a string containing from 1 to 255 characters which are the delimiters for the longstring. This is an optional argument and defaults to a blank.

Syntax

<section begin="syntax" /> %RESULT = $Lstr_Word(longstring, n, delims) <section end="syntax" />

$Lstr_Word function

%RESULT is the :hp1.n:ehp1.th word in the longstring.

For example

%RES = $Lstr_Word('She sells sea-shells by the sea shore', 7)

sets %RES to "shore.&CQ. and

%RES = $Lstr_Word('She sells sea-shells by the sea shore', 7, '- ')

sets %RES to "sea&CQ.

For more information see :hdref refid=lstr..

$Lstr_Word is only available in Sirius Mods Version 6.5 and later. Prior to Version 7.3 (or Version 7.1 or 7.2, with maintenance applied), if the result of $Lstr_Word was longer than 255 bytes, either the request was cancelled or the result was truncated at 255 bytes.

Products authorizing $Lstr_Word