$SubErs: Difference between revisions

From m204wiki
Jump to navigation Jump to search
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 [[to be entered]].</p>
<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>:


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>:


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>:


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>:


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" />

$SubErs Function

%STRING is part of the first argument string.

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)

Products authorizing $SubErs