Programmer Guide/Command Reference/SUBSTR

SUBSTR

var := SUBSTR string [ skip_count [ length ]]

The SUBSTR command extracts a substring from its first argument, string. The start of the substring to extract is denoted by the second parameter skip_count, denoting the number of characters to skip.

The length of the substring to extract is denoted by the third parameter, length. If you supply a negative number for length, its absolute value will be used, and skip_count will start at the end of the string.

string

The string from which to retrieve the substring.

skip_count

by denoting the number of characters to skip from the beginning (length≥0) or from the end of the string (length<0), skip_count indicates where to start extracting the substring. The default value is 0.

length

Its absolute value determines the length of the substring to extract. If length is less than zero, skip_count characters will be skipped from the end of the string; otherwise, they will be skipped from the beginning of the string. If omitted, the "remaining" part of the string will be extracted.

# skip 1 character, returning 'bcd'
#str := substr 'abcd' 1

# skip 2 characters, returning 'cd'
#str := substr 'abcd' 2

# skip 1 character, request 2 characters - returning 'bc'
#str := substr 'abcd' 1 2

# skip 2 character from the end, request 1 character, returning 'b'
#str := substr 'abcd' 2 -2