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

<@TOKENIZE>

Syntax

<@TOKENIZE VALUE=text CHARS=delimiters [{array attributes}]>

Description

Provides you with a way of sectioning a string into multiple pieces according to a set of delimiting characters. It accepts as attributes the VALUE of the text and the delimiting CHARS, and returns its results as an array. The result is a one row array, with a column for each token. If the entire string consisted of only delimiters, a one by one empty array is returned.

Each character in CHARS is taken as a separate delimiter.

There are array-returning attributes that can be used to specify prefixes and suffixes for the returned array, rows within the array, and columns within the rows. They are described in the section Array-to-Text Conversion Attributes. By default, the returned array is formatted as an HTML table.

Example

Note: There are extra spaces in the string specified in the VALUE attribute in the following example.

<@TOKENIZE VALUE=" There is no `try'. Do, or do not. " CHARS=" ,.">

The array returned looks like this:

See Also

Array-to-Text Conversion Attributes
<@LTRIM>
<@RTRIM>
<@SUBSTRING>

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

Copyright © 1999, Pervasive Software. All rights reserved.