<@SUBSTRING>
Syntax
<@SUBSTRING STR=str
START=start NUMCHARS=numChars
[ENCODING=encoding]>
Description
Extracts a NUMCHARS long
substring, starting at START from STR and returns
a copy of the extracted substring.
If the string contains any spaces except
for spaces embedded within meta tags, the string must be quoted.
All three attributes are mandatory. If a
syntax error is encountered while the expression is parsed (no
attributes at all, no string, or no number of characters) the tag
returns an empty string.
Examples
<@SUBSTRING STR="alpha"
START="3" NUMCHARS="2">
This example returns "ph", the
two characters starting at the third position.
<@SUBSTRING STR="<@INCLUDE
FILE='<@APPFILEPATH>BrownFox.txt'>" START="3"
NUMCHARS="2">
This example returns "e " and a
space, which are the two characters starting at the third position in
"The Quick Brown Fox Jumps Over The Lazy Dog" (the contents
of theBrownFox.txt file).
See Also
Encoding
Attribute
<@LEFT>
<@LOCATE>
<@REPLACE>
<@RIGHT>
|