createMessageParser

Creates a message parser, which enables you to parse a message.

Syntax

ogscript.createMessageParser (messageBytes);

Parameters

Parameter

Type

Required

Description

messageBytes

byte array

Yes

The source byte array.

Returns

Returns a MessageParser object (generally used to parse the various pieces of messages received over the network).

Example

In the following example, a variable named messageArray contains several pieces of data of various data types to be extracted by a message parser. A variable named parsedMessage is created to contain the extracted message content. Each element of the array is parsed and sent to the debug utility.

Tip: You can use the createMessageBuilder function to create messages.

var parsedMessage = ogscript.createMessageParser(messageArray); ogscript.debug(parsedMessage.readBoolean()); ogscript.debug(parsedMessage.readByte()); ogscript.debug(parsedMessage.readUnsignedByte()); ogscript.debug(parsedMessage.readShort()); ogscript.debug(parsedMessage.readUnsignedShort()); ogscript.debug(parsedMessage.readChar()); ogscript.debug(parsedMessage.readInt()); ogscript.debug(parsedMessage.readLong()); ogscript.debug(parsedMessage.readFloat()); ogscript.debug(parsedMessage.readDouble()); ogscript.debug(parsedMessage.readString(4)); ogscript.debug(parsedMessage.readUTF());</task>