PARSE$
<< Click to Display Table of Contents >> Navigation: ThinBASIC Core Language > BuiltIn Functions > String functions > PARSE$ |
Description
Return a delimited field from a string expression.
Syntax
s = PARSE$(MainString, [ANY] StringDelimiter, Index)
Returns
String
Parameters
Name |
Type |
Optional |
Meaning |
MainString |
String |
No |
The string to be parsed. If StringExpression is empty or contains no delimiter character(s), the string is considered to contain exactly one field. In this case, PARSECOUNT returns 1. |
StringDelimiter |
String |
No |
Contains delimiter character(s). A delimiter is a character, list of characters, or string, that is used to mark the end of a field in StringExpression.
If the ANY is used, StringDelimiter contains a set of characters, any of which may act as a delimiter character. If the ANY keyword is omitted, the entire StringDelimiter string acts as a single delimiter. Delimiters are case-sensitive.
If StringDelimiter is an empty string, special rules apply. The delimiter is assumed to be a comma. Fields may optionally be enclosed in quotes. Such quotes are considered as special field delimiters and are not returned as part of the result string. Any characters that appear between a quote mark and the next comma delimiter character are discarded. If no leading quote is found, any leading or trailing spaces are trimmed before the result string is returned. |
Index |
Numeric |
No |
The delimited field number to return. The first field is 1. The maximum number of fields contained in MainString can be determined with the PARSECOUNT function. If Index is negative, parsing takes place from right to left. |
Remarks
Restrictions
See also
Examples