$SubErs

Remove occurrence of one string from another

Note: Most Sirius $functions have been deprecated in favor of Object Oriented methods. The OO equivalent for the $SubErs function is the Remove 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.

Syntax

%string = $SubErs(string, substring, start_pos, [count])

Syntax terms

%string	The part of the string argument that remains after substring is removed from it.
string	An arbitrary string.
substring	Another arbitrary string.
start_pos	A starting position within string.
count	A repeat count indicating the number of occurrences of substring to be removed. This is an optional argument, and it defaults to 1.

Examples

1. This statement sets %JUNK to CDABAB:

   %JUNK = $SubErs('ABCDABAB', 'AB')

2. This statement sets %JUNK to WE WAITED LONG ENOUGH:

   %JUNK = $SubErs('WE HAVE WAITED LONG ENOUGH', 'HAVE ')

3. This statement sets %JUNK to WE HAVE AITED LONG ENOUGH:

   %JUNK = $SubErs('WE HAVE WAITED LONG ENOUGH', 'W', 5)

4. This statement sets %JUNK to E HAVE AITED LONG ENOUGH:

   %JUNK = $SubErs('WE HAVE WAITED LONG ENOUGH', 'W', 1, 5)

Products authorizing $SubErs

• Sirius functions
• Fast/Unload User Language Interface
• Janus Open Client
• Janus Open Server
• Janus Sockets
• Janus Web Server
• Japanese functions
• Sir2000 Field Migration Facility