Programmer Guide/Command Reference/SUBSTR: Difference between revisions
From STX Wiki
Jump to navigationJump to search
m (1 revision: Initial import) |
(→SUBSTR) |
||
| Line 2: | Line 2: | ||
==SUBSTR== | ==SUBSTR== | ||
var := SUBSTR <var>string</var> [ <var>skip_count</var> [ <var>length</var> ]] | |||
The <code>SUBSTR</code> command extracts a substring from its first argument, <var>string</var>. The start of the substring to extract is denoted by the second parameter <var>skip_count</code>, denoting the number of characters to skip. | |||
The length of the substring to extract is denoted by the third parameter, <var>length</var>. If you supply a negative number for <var>length</var>, its absolute value will be used, ''and'' <var>skip_count</var> will start at the ''end'' of the string. | |||
;<var>string</var> | ;<var>string</var> | ||
:The string from which to retrieve the substring. | :The string from which to retrieve the substring. | ||
;<var>skip_count</var> | |||
;<var> | :by denoting the number of characters to skip from the beginning (<var>length</var>≥0) or from the end of the string (<var>length</var><0), <var>skip_count</var> indicates where to start extracting the substring. The default value is <code>0</code>. | ||
: | |||
;<var>length</var> | ;<var>length</var> | ||
:Its absolute value determines the length of the substring to extract. If <var>length</var> is less than zero, <var>skip_count</var> 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 1 character from the end, request 2 characters, returning 'ab' | |||
#str := substr ' | #str := substr 'abcd' 1 -2 | ||
Revision as of 16:57, 3 July 2013
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 1 character from the end, request 2 characters, returning 'ab' #str := substr 'abcd' 1 -2
