ASCIIFIELD

Retrieve, from an ASCII buffer, ASCII fields separated by a given character.

WebVue support - Yes.

The ASCII buffer should be terminated by a linefeed character - either \n or CHR(10).

If you do not terminate the buffer correctly, the last (right-most) field is not recognized.

You cannot enter a linefeed in a Send Text animation.

Syntax 1

RetVal = ASCIIFIELD(Mode, Handle, Index [, Sepa]);

Argument	Meaning
Handle	The handle of the buffer on which the operation is performed. Type LONG.
Index	The index of the field starting at 1. Type INTEGER.
Sepa	The separation character used. The default value is the comma: ",". Type STR.

Mode	Mnemonic	Action
1	LEN	Return the length of the field specified by the index. If the index is not given, the length (size) of the buffer is returned. Return type: INTEGER.
3	STR	Return the character string of the field specified by the index. If the index is out of range, the character string will be empty. Return type: STR.
4	INTEGER	Return the INTEGER value contained in the field specified by the index. If the index is out of range, the function returns 0. Return type: INTEGER.
5	LONG	Return the LONG value contained in the field specified by the index. If the index is out of range, the function returns 0. Return type: LONG.
6	DOUBLE	Return the REAL value contained in the field specified by the index. If the index is out of range, the function returns 0. Return type: DOUBLE.

RetVal = ASCIIFIELD(Mode, Handle [, Sepa]);

Return type: INTEGER.

Argument	Meaning
Handle	The handle of the buffer on which the operation is performed. Type LONG.
Sepa	The separation character used. The default value is the comma: ", ". Type STR.

Mode	Mnemonic	Action
2	COUNT	Return the number of fields in the buffer.

For an example, select the Example link above.