substrReturn part of a string
&reftitle.description;
stringsubstrstringstringintstartintlength
Returns the portion of string specified by the
start and length parameters.
&reftitle.parameters;
string
The input string. Must be one character or longer.
start
If start is non-negative, the returned string
will start at the start'th position in
string, counting from zero. For instance,
in the string 'abcdef', the character at
position 0 is 'a', the
character at position 2 is
'c', and so forth.
If start is negative, the returned string
will start at the start'th character
from the end of string.
If string is less than
start characters long, &false; will be returned.
Using a negative start
]]>
length
If length is given and is positive, the string
returned will contain at most length characters
beginning from start (depending on the length of
string).
If length is given and is negative, then that many
characters will be omitted from the end of string
(after the start position has been calculated when a
start is negative). If
start denotes the position of this truncation or
beyond, &false; will be returned.
If length is given and is 0,
&false; or &null;, an empty string will be returned.
If length is omitted, the substring starting from
start until the end of the string will be
returned.
Using a negative length
]]>
&reftitle.returnvalues;
Returns the extracted part of string; &return.falseforfailure;, or
an empty string.
&reftitle.changelog;
&Version;&Description;7.0.0
If string is equal to
start characters long, an empty string will be
returned. Prior to this version, &false; was returned in this case.
5.2.2 - 5.2.6
If the start parameter indicates the position of
a negative truncation or beyond, false is returned. Other versions get
the string from start.
&reftitle.examples;
Basic substr usage
]]>
substr casting behaviour
]]>
&example.outputs.7;
&example.outputs.5;
&reftitle.errors;
Returns &false; on error.
]]>
&reftitle.seealso;
strrchrsubstr_replacepreg_matchtrimmb_substrwordwrapString access and modification by character