$Lstr ParseX: Difference between revisions

From m204wiki
Jump to navigation Jump to search
m (1 revision)
 
(31 intermediate revisions by 5 users not shown)
Line 2: Line 2:
<span class="pageSubtitle">Part of longstring following character in delimiter set</span>
<span class="pageSubtitle">Part of longstring following character in delimiter set</span>


<p class="warning">Most Sirius $functions have been deprecated in favor of Object Oriented methods. The OO equivalent for the $Lstr_ParseX function is in the [[StringTokenizer class]].</p>
<p class="warn"><b>Note: </b>Many $functions have been deprecated in favor of Object Oriented methods. The OO equivalent for the <var>$Lstr_ParseX</var> function is the <var>[[After (String function)|After]]</var> function; also see the <var>[[StringTokenizer class|StringTokenizer]]</var> class.</p>


This function returns the part(s) of a longstring that remain after removing the part of the string that is delimited by a character in a delimiter set.  
This function returns the part(s) of a longstring that remain after removing the part of the string that is delimited by a character in a delimiter set.  
Line 14: Line 14:
The third argument is a starting position in the first argument string and has a default of 1.
The third argument is a starting position in the first argument string and has a default of 1.
==Syntax==
==Syntax==
<p class="syntax"><section begin="syntax" />%PIECE = $Lstr_ParseX(string, delims, start_pos)
<p class="syntax"><span class="term">%PIECE</span> = <span class="literal">$Lstr_ParseX</span>(<span class="term">string</span>, <span class="term">delims</span>, [<span class="term">start_pos</span>])
<section end="syntax" /></p>
<p class="caption">$Lstr_ParseX Function
</p>
</p>
<p class="caption">%PIECE is a piece of the first argument string.</p>
 
<p>
%PIECE is a piece of the first argument string.</p>
For example, the following statement would set %JUNK to <tt>WANT|NOT</tt>:
For example, the following statement would set %JUNK to <tt>WANT|NOT</tt>:
<p class="code"> %JUNK = $Lstr_ParseX('WASTE NOT(WANT|NOT', '(|')
<p class="code"> %JUNK = $Lstr_ParseX('WASTE NOT(WANT|NOT', '(|')
Line 28: Line 28:
<p class="code"> %JUNK = $Lstr_ParseX('WASTE NOT(WANT|NOT', '|', 6)
<p class="code"> %JUNK = $Lstr_ParseX('WASTE NOT(WANT|NOT', '|', 6)
</p>
</p>
Note:
<ul>
<li>The <var>[[$ParseX]]</var> function differs somewhat from <var>$Lstr_ParseX</var>.  Specifically, <var>$ParseX</var> returns the prefix of the first argument (the characters prior to <var class="term">start_pos</var>) concatenated with the characters following the delimiter character.
</ul>


Note that this last result string is a concatenation of the characters that precede the starting position character in the initial string and the characters that follow the delimiter character. Also note that the characters that are '''not''' in this result string are exactly the characters that [[$Lstr_Parse]] would return for this same initial string.  
Note that this last result string is a concatenation of the characters that precede the starting position character in the initial string and the characters that follow the delimiter character. Also note that the characters that are '''not''' in this result string are exactly the characters that [[$Lstr_Parse]] would return for this same initial string.  
Line 33: Line 38:
<var>$Lstr_ParseX</var> returns a null string if none of the delimiter characters are found.<p>
<var>$Lstr_ParseX</var> returns a null string if none of the delimiter characters are found.<p>


==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>[[Japanese functions]]</li>
<li>Japanese functions</li>
<li>[[Sir2000 Field Migration Facility]]</li>
<li>[[Media:SirfieldNew.pdf|Sir2000 Field Migration Facility]]</li>


</ul>
</ul>
   
   
</p>
</p>
<p class="caption">Products authorizing $Lstr_ParseX
<p>
</p>
</p>




[[Category:$Functions|$Lstr_ParseX]]
[[Category:$Functions|$Lstr_ParseX]]

Latest revision as of 03:03, 19 March 2019

Part of longstring following character in delimiter set

Note: Many $functions have been deprecated in favor of Object Oriented methods. The OO equivalent for the $Lstr_ParseX function is the After function; also see the StringTokenizer class.

This function returns the part(s) of a longstring that remain after removing the part of the string that is delimited by a character in a delimiter set.

The $Lstr_ParseX function accepts three arguments and returns a longstring result that is a part of the first input long string.

The first argument is an arbitrary string or longstring.

The second argument is a string containing a set of delimiter characters.

The third argument is a starting position in the first argument string and has a default of 1.

Syntax

%PIECE = $Lstr_ParseX(string, delims, [start_pos])

%PIECE is a piece of the first argument string.

For example, the following statement would set %JUNK to WANT|NOT:

%JUNK = $Lstr_ParseX('WASTE NOT(WANT|NOT', '(|')

The statement below would set %JUNK to NOT:

%JUNK = $Lstr_ParseX('WASTE NOT(WANT|NOT', '|')

The following statement would set %JUNK to WASTENOT:

%JUNK = $Lstr_ParseX('WASTE NOT(WANT|NOT', '|', 6)

Note:

  • The $ParseX function differs somewhat from $Lstr_ParseX. Specifically, $ParseX returns the prefix of the first argument (the characters prior to start_pos) concatenated with the characters following the delimiter character.

Note that this last result string is a concatenation of the characters that precede the starting position character in the initial string and the characters that follow the delimiter character. Also note that the characters that are not in this result string are exactly the characters that $Lstr_Parse would return for this same initial string.

$Lstr_ParseX returns a null string if none of the delimiter characters are found.

Products authorizing $Lstr_ParseX