f$Element
f$Element
Extract an element from an element list. This list contains names or descriptions separated by the separator symbol.
If the number element is no longer present, then an empty space is returned. This marks the end of the list. If the separator symbol does not appear in the text, then the entire text is returned.
Syntax: | Element = f$Element( Text, Number, Separator ) | ||
| Argument | Type | Meaning |
| Text | String | Item list |
| Number | Integer | Sequential tab number for the element searched |
| Separator | String | Separator symbol |
Result: | String | Element searched | |
Example: | A list of documents separated by the symbol ';' is available in a data field: Text = 'Document1;Document2;Document3' | ||
| The following results from this text: Name = f$Element( Text, 1, ';' ) → Name = 'Document1' Name = f$Element( Text, 1, '-' ) | ||