Moves the cursor to the next data item in a StreamMessage and returns its data type.

Syntax

FUNCTION moveToNext RETURNS CHARACTER.

Applies to

Message objects

Notes

  • 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.

See also

createStreamMessage procedure, writeBoolean procedure, writeByte procedure, writeBytesFromRaw procedure, writeChar procedure, writeDate procedure, writeDateTime procedure, writeDateTime-TZ procedure, writeDouble procedure, writeFloat procedure, writeInt procedure, writeLong procedure, writeLongString procedure, writeShort procedure, writeString procedure, endOfStream function, moveToNext procedure, readBytesToRaw procedure, readChar function, readDate function, readDateTime function, readDateTime-TZ function, readDecimal function, readInt function, readInt64 function, readLogical function, readLongString function, readLongStringCP function

For more information, see the StreamMessage.