After (String function)

Part of string after a substring (String class)

[Introduced in Model 204 7.5]

After operates on a string and returns the portion of that string after a user-specified delimiter. To get the portion of the string before a delimiter, use the Before string method.

Syntax

%outString = string:After( substring, [Start= number])

Syntax terms

%outString	A string or longstring variable. if a string is specified it must be long enough to hold the resulting parsed string. If a string is defined shorter than needed to hold the result, a request canceling error occurs.
string	A string or longstring variable that holds the string to be parsed.
substring	A string or longstring variable that holds the separator character or characters on which parsing occurs.
Start	number: The starting point for parsing. The default value is 1, indicating the beginning of the string. This is a name-optional argument and cannot be 0. If a value larger than the string is specified, the method always returns a null string.

Usage notes

If a starting value is entered, the %outString is the content of the string beginning after the first occurrence of the delimiter string encountered after the specified start point, and ending at the end of the string. The delimiter string is not a list of individual delimiters, but a single delimiter which may be multiple characters. In other words, if your delimiter is 'ok', the method looks for occurrences of those two lower-case letters and returns a value after said occurrence, This method is always case-sensitive.

Examples

The following request prints the following string (note the initial blank!):

I am the Walrus! Koo Koo Kachoo!

begin %x is string len 64 initial('I am the Eggman! I am the Walrus! Koo Koo Kachoo!') printText {%x:after('!')} end

The following request prints

Koo Koo Kachoo!

begin %x is string len 64 initial('I am the Eggman! I am the Walrus! Koo Koo Kachoo!') printText {%x:after('!',start=20)} end

The following prints each blank-delimited word, one at a time.

begin %x is string len 64 initial('I am the Eggman! I am the Walrus! Koo Koo Kachoo!') repeat while %x:length print %x:before(' ') %x = %x:after(' ') end repeat end

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

The Before string method.