Uncombine_Levels; Upper_String; Variable_To_String (Variable Encode) - AMX NETLINX PROGRAMMING LANGUAGE Manual

Reserved Identifiers
Keywords & Run-Time Library Functions (Cont.)

UNCOMBINE_LEVELS

UPPER_STRING

VARIABLE_TO_STRING
(VARIABLE ENCODE)
158
This keyword reverses the effect of COMBINE_LEVELS. All combines related to
the specified virtual device-level are disabled.
SLONG UNCOMBINE_LEVELS VDL
Parameters:
VDL: The virtual device-channel passed to COMBINE_LEVELS.
Result:
0: Operation was successful
-1: Invalid virtual device-level
Result = COMBINE_LEVELS VDL, DLSetResult =
UNCOMBINE_LEVELS VDL
This function changes all alphabetic characters in the specified string to upper
case. The syntax:
CHAR[ ]UPPER_STRING (CHAR STRING[ ])
UPPER_STRING (WIDECHAR STRING[ ])
Parameters:
STRING: The character string to convert to upper case.
Result:
The converted character string.
UCString = UPPER_STRING(STRING)
This routine takes the variable ENCODE and creates entries in the buffer to rep-
resent that variable. The variable passed in can be of any type including
arrays, structures, and arrays of structures.
SINTEGER VARIABLE_TO_STRING(ENCODE, CHAR BUFFER[ ], LONG
POSITION)
Parameters:
• ENCODE: Any type of variable. This is the variable to be encoded.
• BUFFER: This is where the encode data is placed.
• POSITION: This is where the first byte of the encoding is placed. Is it also
modified to point to the next location after the last encoded byte. That means
that successive calls to this function can be made without modifying position.
Position should be set to one on the first call.
Result:
0: Encoded OK
-1: Encoded variable unrecognized type
-2: Encoded data would not fit into buffer; the buffer is too small.
Result = VARIABLE_TO_STRING (MyStruct, Buffer, Pos)
NetLinx Programming Language Reference Guide
WIDECHAR[ ]