[TOC] [Prev] [Next] [Bottom]

<@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 the BrownFox.txt file).

See Also

Encoding Attribute
<@LEFT>
<@LOCATE>
<@REPLACE>
<@RIGHT>

[TOC] [Prev] [Next] [Bottom]

Copyright © 1999, Pervasive Software. All rights reserved.