AMX Axcess, Instruction Manual

Page: 85 / 144

Using Buffers
77
Axcess Programming Language
Buffer Keywords (Cont.)
GET_BUFFER_CHAR
THIS keyword is used to remove
characters from a buffer.
It has a two-part operation:
• First, it retrieves the first character in the buffer for your own utilization.
This creates the same effect as if you retrieved the first storage location
of a normal string array.
• Second, it removes that character from the buffer, causing all the other
characters to shift up one place. The second character is now the first,
the third is now the second, and so on.
Here is the syntax:
result = GET_BUFFER_CHAR (array)
The parameter passed to GET_BUFFER_CHAR must be an array, but
does not need to be a buffer. The keyword will operate identically in either
case. Only one byte (character) will be returned, and this value can be
assigned to a variable, array, or a cell in an array.
GET_MULTI_BUFFER_STRING
To access characters coming into
a multi-buffer, you must first use
GET_MULTI_BUFFER_STRING
to transfer these characters into
another array.
The syntax:
device = GET_MULTI_BUFFER_STRING (buffer, array)
The next string in the specified buffer is assigned to the specified array. All
three header bytes for the string are stripped before the string enters the
array.
The result of a GET_MULTI_BUFFER_STRING statement is the device
number of the card that received the string.