Sound.Osc.Coding.Decode.Binary

Optimised decode function for Osc packets.

Documentation

get_packet :: Get (PacketOf Message)

Get an Osc Packet.

decodeMessage :: ByteString -> Message

Decode an Osc Message from a lazy ByteString.

>>> let b = ByteString.Lazy.pack [47,103,95,102,114,101,101,0,44,105,0,0,0,0,0,0]
>>> decodeMessage b == Message "/g_free" [Int32 0]
True

decodeBundle :: ByteString -> BundleOf Message

Decode an Osc BundleOf from a lazy ByteString.

decodePacket :: ByteString -> PacketOf Message

Decode an Osc packet from a lazy ByteString.

>>> let b = ByteString.Lazy.pack [47,103,95,102,114,101,101,0,44,105,0,0,0,0,0,0]
>>> decodePacket b == Packet_Message (Message "/g_free" [Int32 0])
True

decodePacket_strict :: ByteString -> PacketOf Message

Decode an Osc packet from a strict Char8 ByteString.

decodeMessageOr :: ByteString -> Either String Message

Either decode Osc message or return an error message. Prevents application halt for non-valid messagebundlepacket arrives.

>>> let b = ByteString.Lazy.pack [1,2,3,2,1]
>>> decodePacketOr b
Left "not enough bytes"

decodeBundleOr :: ByteString -> Either String Bundle

decodePacketOr :: ByteString -> Either String Packet