$SubErs: Difference between revisions
m (1 revision) |
m (1 revision) |
(No difference)
|
Revision as of 20:33, 24 October 2012
Remove occurrence of one string from another
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)