Remove (String function)

Remove the occurrences of a specified substring (String class)

The Remove intrinsic function removes one or multiple occurrences of a specified substring from the method object (input) string, returning the modified version.

Syntax

%outString = string:Remove( substring, [Count= number])

Syntax terms

%outString	A string variable to receive the modified method object (input) string.
string	The method object (ie: input) string to which the method is applied.
substring	The substring that the method attempts to remove in the method object string. If string contains no occurrences of substring, %outString is set to a copy of string. If substring is null or longer than 256 characters, the request is cancelled.
Count	An optional, name-required, argument that is the number of occurrences of substring to remove. Only values greater than 0 are valid. If number is: less than the number of occurrences of the substring, only the first number occurrences are removed. greater than or equal to the number of occurrences of the substring, all occurrences of the given substring are removed. not specified, all occurrences are removed.

Usage notes

• The search for the target substring is context sensitive; case matters in the attempt to find and remove the target characters.
• Remove is equivalent to calling Replace method with an empty replacement string argument.
• Remove is available as of "Sirius Mods" Version 7.3.

Examples

1. The following request shows two examples of Remove calls against the same input string: the first call removes an occurrence of a specified substring; the second removes both occurrences of a different substring.

   begin %x is longstring %substr is string len 6 %repl is string len 2 %out is longstring %x = 'Remove me' %substr = ' me' %out = %x:remove(%substr) printText {~} is {%out} %substr = 'e' %out = %x:remove(%substr, Count=2) printText {~} is {%out} end

   The request output follows:

   %out is Remove %out is Rmov me

See also

Float class String class Unicode class	List of Float methods List of String methods List of Unicode methods List of Intrinsic methods	Float methods syntax String methods syntax Unicode methods syntax
Notation conventions for methods