|
FUNCTION moveToNext RETURNS CHARACTER.
|
Possible return values include the Unknown value (?), boolean, byte, short, char, int, long, float, double, string, or byte.
The Unknown value (?)is returned when the value of the item is NULL.
When the message is received or after reset procedure is called, the cursor is set before the first data item.
It is an error to try to move the cursor beyond the last item.
moveToNext procedure function cannot precisely determine certain data types. It is important to be aware of the following limitations:
String values — moveToNext procedure returns the longchar value for a data item consisting of a string longer than 32K. If the item is a string of 32K or less, the function returns the string value for both CHARACTER and LONGCHAR data. In the latter case, it is the responsibility of the ABL programmer to know the order of items in the StreamMessage and to call the correct function to interpret the data appropriately.
Date values — moveToNext procedure returns the string value for all date items. The ABL programmer must know the order of items in the StreamMessage and call the correct function to interpret the data appropriately.
INT64 values — moveToNext procedure returns the long value for INT64 message data. It is the responsibility of the ABL programmer to know the order of items in the StreamMessage and to call the correct function to interpret the data appropriately.