$SubErs: Difference between revisions
m (1 revision) |
mNo edit summary |
||
Line 2: | Line 2: | ||
<span class="pageSubtitle"><section begin="desc" />Remove occurrence of one string from another<section end="desc" /></span> | <span class="pageSubtitle"><section begin="desc" />Remove occurrence of one string from another<section end="desc" /></span> | ||
<p class="warning">Most Sirius $functions have been deprecated in favor of Object Oriented methods. The OO equivalent for the $SubErs function is [[ | <p class="warning">Most Sirius $functions have been deprecated in favor of Object Oriented methods. The OO equivalent for the $SubErs function is the [[Remove (String function)]].</p> | ||
This function removes an occurrence of one string from another. | This function removes an occurrence of one string from another. | ||
Line 15: | Line 15: | ||
The fourth argument is a repeat count indicating the number of occurrences to be removed. This is an optional argument and defaults to 1. | The fourth argument is a repeat count indicating the number of occurrences to be removed. This is an optional argument and defaults to 1. | ||
==Syntax== | ==Syntax== | ||
<p class="syntax"><section begin="syntax" /> %STRING = $SubErs(string, substring, start_pos, count) | <p class="syntax"><section begin="syntax" /> %STRING = $SubErs(string, substring, start_pos, count) | ||
Line 22: | Line 23: | ||
<p class="caption">%STRING is part of the first argument string.</p> | <p class="caption">%STRING is part of the first argument string.</p> | ||
For example, this statement sets %JUNK to <tt>CDABAB</tt>: | |||
<p class="code"> %JUNK = $SubErs('ABCDABAB', 'AB') | <p class="code"> %JUNK = $SubErs('ABCDABAB', 'AB') | ||
</p> | </p> | ||
This statement sets %JUNK to <tt>WE WAITED LONG ENOUGH</tt>: | |||
<p class="code"> %JUNK = $SubErs('WE HAVE WAITED LONG ENOUGH', 'HAVE ') | <p class="code"> %JUNK = $SubErs('WE HAVE WAITED LONG ENOUGH', 'HAVE ') | ||
</p> | </p> | ||
This statement sets %JUNK to <tt>WE HAVE AITED LONG ENOUGH</tt>: | |||
<p class="code"> %JUNK = $SubErs('WE HAVE WAITED LONG ENOUGH', 'W', 5) | <p class="code"> %JUNK = $SubErs('WE HAVE WAITED LONG ENOUGH', 'W', 5) | ||
</p> | </p> | ||
This statement sets %JUNK to <tt>E HAVE AITED LONG ENOUGH</tt>: | |||
<p class="code"> %JUNK = $SubErs('WE HAVE WAITED LONG ENOUGH', 'W', 1, 5) | <p class="code"> %JUNK = $SubErs('WE HAVE WAITED LONG ENOUGH', 'W', 1, 5) | ||
</p> | </p> | ||
Line 51: | Line 52: | ||
<li>[[Japanese functions]]</li> | <li>[[Japanese functions]]</li> | ||
<li>[[Sir2000 Field Migration Facility]]</li> | <li>[[Sir2000 Field Migration Facility]]</li> | ||
</ul> | </ul> | ||
<p class="caption">Products authorizing $SubErs | <p class="caption">Products authorizing $SubErs | ||
</p> | </p> | ||
[[Category:$Functions|$SubErs]] | [[Category:$Functions|$SubErs]] |
Revision as of 20:25, 8 February 2011
<section begin="desc" />Remove occurrence of one string from another<section end="desc" />
Most Sirius $functions have been deprecated in favor of Object Oriented methods. The OO equivalent for the $SubErs function is the Remove (String function).
This function removes an occurrence of one string from another.
The $SubErs function accepts four arguments and returns a string result that is part of the first argument string.
The first argument is an arbitrary string.
The second argument is another arbitrary string.
The third argument is a starting position in the first argument string.
The fourth argument is a repeat count indicating the number of occurrences to be removed. This is an optional argument and defaults to 1.
Syntax
<section begin="syntax" /> %STRING = $SubErs(string, substring, start_pos, count) <section end="syntax" />
For example, this statement sets %JUNK to CDABAB:
%JUNK = $SubErs('ABCDABAB', 'AB')
This statement sets %JUNK to WE WAITED LONG ENOUGH:
%JUNK = $SubErs('WE HAVE WAITED LONG ENOUGH', 'HAVE ')
This statement sets %JUNK to WE HAVE AITED LONG ENOUGH:
%JUNK = $SubErs('WE HAVE WAITED LONG ENOUGH', 'W', 5)
This statement sets %JUNK to E HAVE AITED LONG ENOUGH:
%JUNK = $SubErs('WE HAVE WAITED LONG ENOUGH', 'W', 1, 5)