tomwalters@509: /*
tomwalters@509: 	oscpack -- Open Sound Control packet manipulation library
tomwalters@509: 	http://www.audiomulch.com/~rossb/oscpack
tomwalters@509: 
tomwalters@509: 	Copyright (c) 2004-2005 Ross Bencina <rossb@audiomulch.com>
tomwalters@509: 
tomwalters@509: 	Permission is hereby granted, free of charge, to any person obtaining
tomwalters@509: 	a copy of this software and associated documentation files
tomwalters@509: 	(the "Software"), to deal in the Software without restriction,
tomwalters@509: 	including without limitation the rights to use, copy, modify, merge,
tomwalters@509: 	publish, distribute, sublicense, and/or sell copies of the Software,
tomwalters@509: 	and to permit persons to whom the Software is furnished to do so,
tomwalters@509: 	subject to the following conditions:
tomwalters@509: 
tomwalters@509: 	The above copyright notice and this permission notice shall be
tomwalters@509: 	included in all copies or substantial portions of the Software.
tomwalters@509: 
tomwalters@509: 	Any person wishing to distribute modifications to the Software is
tomwalters@509: 	requested to send the modifications to the original developer so that
tomwalters@509: 	they can be incorporated into the canonical version.
tomwalters@509: 
tomwalters@509: 	THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
tomwalters@509: 	EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
tomwalters@509: 	MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
tomwalters@509: 	IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR
tomwalters@509: 	ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF
tomwalters@509: 	CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
tomwalters@509: 	WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
tomwalters@509: */
tomwalters@509: #include "OscReceivedElements.h"
tomwalters@509: 
tomwalters@509: #include <cassert>
tomwalters@509: 
tomwalters@509: #include "OscHostEndianness.h"
tomwalters@509: 
tomwalters@509: 
tomwalters@509: namespace osc{
tomwalters@509: 
tomwalters@509: 
tomwalters@509: // return the first 4 byte boundary after the end of a str4
tomwalters@509: // be careful about calling this version if you don't know whether
tomwalters@509: // the string is terminated correctly.
tomwalters@509: static inline const char* FindStr4End( const char *p )
tomwalters@509: {
tomwalters@509: 	if( p[0] == '\0' )    // special case for SuperCollider integer address pattern
tomwalters@509: 		return p + 4;
tomwalters@509: 
tomwalters@509:     p += 3;
tomwalters@509: 
tomwalters@509:     while( *p )
tomwalters@509:         p += 4;
tomwalters@509: 
tomwalters@509:     return p + 1;
tomwalters@509: }
tomwalters@509: 
tomwalters@509: 
tomwalters@509: // return the first 4 byte boundary after the end of a str4
tomwalters@509: // returns 0 if p == end or if the string is unterminated
tomwalters@509: static inline const char* FindStr4End( const char *p, const char *end )
tomwalters@509: {
tomwalters@509:     if( p >= end )
tomwalters@509:         return 0;
tomwalters@509: 
tomwalters@509: 	if( p[0] == '\0' )    // special case for SuperCollider integer address pattern
tomwalters@509: 		return p + 4;
tomwalters@509: 
tomwalters@509:     p += 3;
tomwalters@509:     end -= 1;
tomwalters@509: 
tomwalters@509:     while( p < end && *p )
tomwalters@509:         p += 4;
tomwalters@509: 
tomwalters@509:     if( *p )
tomwalters@509:         return 0;
tomwalters@509:     else
tomwalters@509:         return p + 1;
tomwalters@509: }
tomwalters@509: 
tomwalters@509: 
tomwalters@509: static inline unsigned long RoundUp4( unsigned long x )
tomwalters@509: {
tomwalters@509:     unsigned long remainder = x & 0x3UL;
tomwalters@509:     if( remainder )
tomwalters@509:         return x + (4 - remainder);
tomwalters@509:     else
tomwalters@509:         return x;
tomwalters@509: }
tomwalters@509: 
tomwalters@509: 
tomwalters@509: static inline int32 ToInt32( const char *p )
tomwalters@509: {
tomwalters@509: #ifdef OSC_HOST_LITTLE_ENDIAN
tomwalters@509:     union{
tomwalters@509:         osc::int32 i;
tomwalters@509:         char c[4];
tomwalters@509:     } u;
tomwalters@509: 
tomwalters@509:     u.c[0] = p[3];
tomwalters@509:     u.c[1] = p[2];
tomwalters@509:     u.c[2] = p[1];
tomwalters@509:     u.c[3] = p[0];
tomwalters@509: 
tomwalters@509:     return u.i;
tomwalters@509: #else
tomwalters@509: 	return *(int32*)p;
tomwalters@509: #endif
tomwalters@509: }
tomwalters@509: 
tomwalters@509: 
tomwalters@509: static inline uint32 ToUInt32( const char *p )
tomwalters@509: {
tomwalters@509: #ifdef OSC_HOST_LITTLE_ENDIAN
tomwalters@509:     union{
tomwalters@509:         osc::uint32 i;
tomwalters@509:         char c[4];
tomwalters@509:     } u;
tomwalters@509: 
tomwalters@509:     u.c[0] = p[3];
tomwalters@509:     u.c[1] = p[2];
tomwalters@509:     u.c[2] = p[1];
tomwalters@509:     u.c[3] = p[0];
tomwalters@509: 
tomwalters@509:     return u.i;
tomwalters@509: #else
tomwalters@509: 	return *(uint32*)p;
tomwalters@509: #endif
tomwalters@509: }
tomwalters@509: 
tomwalters@509: 
tomwalters@509: int64 ToInt64( const char *p )
tomwalters@509: {
tomwalters@509: #ifdef OSC_HOST_LITTLE_ENDIAN
tomwalters@509:     union{
tomwalters@509:         osc::int64 i;
tomwalters@509:         char c[4];
tomwalters@509:     } u;
tomwalters@509: 
tomwalters@509:     u.c[0] = p[7];
tomwalters@509:     u.c[1] = p[6];
tomwalters@509:     u.c[2] = p[5];
tomwalters@509:     u.c[3] = p[4];
tomwalters@509:     u.c[4] = p[3];
tomwalters@509:     u.c[5] = p[2];
tomwalters@509:     u.c[6] = p[1];
tomwalters@509:     u.c[7] = p[0];
tomwalters@509: 
tomwalters@509:     return u.i;
tomwalters@509: #else
tomwalters@509: 	return *(int64*)p;
tomwalters@509: #endif
tomwalters@509: }
tomwalters@509: 
tomwalters@509: 
tomwalters@509: uint64 ToUInt64( const char *p )
tomwalters@509: {
tomwalters@509: #ifdef OSC_HOST_LITTLE_ENDIAN
tomwalters@509:     union{
tomwalters@509:         osc::uint64 i;
tomwalters@509:         char c[4];
tomwalters@509:     } u;
tomwalters@509: 
tomwalters@509:     u.c[0] = p[7];
tomwalters@509:     u.c[1] = p[6];
tomwalters@509:     u.c[2] = p[5];
tomwalters@509:     u.c[3] = p[4];
tomwalters@509:     u.c[4] = p[3];
tomwalters@509:     u.c[5] = p[2];
tomwalters@509:     u.c[6] = p[1];
tomwalters@509:     u.c[7] = p[0];
tomwalters@509: 
tomwalters@509:     return u.i;
tomwalters@509: #else
tomwalters@509: 	return *(uint64*)p;
tomwalters@509: #endif
tomwalters@509: }
tomwalters@509: 
tomwalters@509: //------------------------------------------------------------------------------
tomwalters@509: 
tomwalters@509: bool ReceivedPacket::IsBundle() const
tomwalters@509: {
tomwalters@509:     return (Size() > 0 && Contents()[0] == '#');
tomwalters@509: }
tomwalters@509: 
tomwalters@509: //------------------------------------------------------------------------------
tomwalters@509: 
tomwalters@509: bool ReceivedBundleElement::IsBundle() const
tomwalters@509: {
tomwalters@509:     return (Size() > 0 && Contents()[0] == '#');
tomwalters@509: }
tomwalters@509: 
tomwalters@509: 
tomwalters@509: int32 ReceivedBundleElement::Size() const
tomwalters@509: {
tomwalters@509:     return ToUInt32( size_ );
tomwalters@509: }
tomwalters@509: 
tomwalters@509: //------------------------------------------------------------------------------
tomwalters@509: 
tomwalters@509: bool ReceivedMessageArgument::AsBool() const
tomwalters@509: {
tomwalters@509:     if( !typeTag_ )
tomwalters@509:         throw MissingArgumentException();
tomwalters@509: 	else if( *typeTag_ == TRUE_TYPE_TAG )
tomwalters@509: 		return true;
tomwalters@509: 	else if( *typeTag_ == FALSE_TYPE_TAG )
tomwalters@509: 		return false;
tomwalters@509: 	else
tomwalters@509: 		throw WrongArgumentTypeException();
tomwalters@509: }
tomwalters@509: 
tomwalters@509: 
tomwalters@509: bool ReceivedMessageArgument::AsBoolUnchecked() const
tomwalters@509: {
tomwalters@509:     if( !typeTag_ )
tomwalters@509:         throw MissingArgumentException();
tomwalters@509: 	else if( *typeTag_ == TRUE_TYPE_TAG )
tomwalters@509: 		return true;
tomwalters@509:     else
tomwalters@509: 	    return false;
tomwalters@509: }
tomwalters@509: 
tomwalters@509: 
tomwalters@509: int32 ReceivedMessageArgument::AsInt32() const
tomwalters@509: {
tomwalters@509:     if( !typeTag_ )
tomwalters@509:         throw MissingArgumentException();
tomwalters@509: 	else if( *typeTag_ == INT32_TYPE_TAG )
tomwalters@509: 		return AsInt32Unchecked();
tomwalters@509: 	else
tomwalters@509: 		throw WrongArgumentTypeException();
tomwalters@509: }
tomwalters@509: 
tomwalters@509: 
tomwalters@509: int32 ReceivedMessageArgument::AsInt32Unchecked() const
tomwalters@509: {
tomwalters@509: #ifdef OSC_HOST_LITTLE_ENDIAN
tomwalters@509:     union{
tomwalters@509:         osc::int32 i;
tomwalters@509:         char c[4];
tomwalters@509:     } u;
tomwalters@509: 
tomwalters@509:     u.c[0] = argument_[3];
tomwalters@509:     u.c[1] = argument_[2];
tomwalters@509:     u.c[2] = argument_[1];
tomwalters@509:     u.c[3] = argument_[0];
tomwalters@509: 
tomwalters@509:     return u.i;
tomwalters@509: #else
tomwalters@509: 	return *(int32*)argument_;
tomwalters@509: #endif
tomwalters@509: }
tomwalters@509: 
tomwalters@509: 
tomwalters@509: float ReceivedMessageArgument::AsFloat() const
tomwalters@509: {
tomwalters@509:     if( !typeTag_ )
tomwalters@509:         throw MissingArgumentException();
tomwalters@509: 	else if( *typeTag_ == FLOAT_TYPE_TAG )
tomwalters@509: 		return AsFloatUnchecked();
tomwalters@509: 	else
tomwalters@509: 		throw WrongArgumentTypeException();
tomwalters@509: }
tomwalters@509: 
tomwalters@509: 
tomwalters@509: float ReceivedMessageArgument::AsFloatUnchecked() const
tomwalters@509: {
tomwalters@509: #ifdef OSC_HOST_LITTLE_ENDIAN
tomwalters@509:     union{
tomwalters@509:         float f;
tomwalters@509:         char c[4];
tomwalters@509:     } u;
tomwalters@509: 
tomwalters@509:     u.c[0] = argument_[3];
tomwalters@509:     u.c[1] = argument_[2];
tomwalters@509:     u.c[2] = argument_[1];
tomwalters@509:     u.c[3] = argument_[0];
tomwalters@509: 
tomwalters@509:     return u.f;
tomwalters@509: #else
tomwalters@509: 	return *(float*)argument_;
tomwalters@509: #endif
tomwalters@509: }
tomwalters@509: 
tomwalters@509: 
tomwalters@509: char ReceivedMessageArgument::AsChar() const
tomwalters@509: {
tomwalters@509:     if( !typeTag_ )
tomwalters@509:         throw MissingArgumentException();
tomwalters@509: 	else if( *typeTag_ == CHAR_TYPE_TAG )
tomwalters@509: 		return AsCharUnchecked();
tomwalters@509: 	else
tomwalters@509: 		throw WrongArgumentTypeException();
tomwalters@509: }
tomwalters@509: 
tomwalters@509: 
tomwalters@509: char ReceivedMessageArgument::AsCharUnchecked() const
tomwalters@509: {
tomwalters@509:     return (char)ToInt32( argument_ );
tomwalters@509: }
tomwalters@509: 
tomwalters@509: 
tomwalters@509: uint32 ReceivedMessageArgument::AsRgbaColor() const
tomwalters@509: {
tomwalters@509:     if( !typeTag_ )
tomwalters@509:         throw MissingArgumentException();
tomwalters@509: 	else if( *typeTag_ == RGBA_COLOR_TYPE_TAG )
tomwalters@509: 		return AsRgbaColorUnchecked();
tomwalters@509: 	else
tomwalters@509: 		throw WrongArgumentTypeException();
tomwalters@509: }
tomwalters@509: 
tomwalters@509: 
tomwalters@509: uint32 ReceivedMessageArgument::AsRgbaColorUnchecked() const
tomwalters@509: {
tomwalters@509: 	return ToUInt32( argument_ );
tomwalters@509: }
tomwalters@509: 
tomwalters@509: 
tomwalters@509: uint32 ReceivedMessageArgument::AsMidiMessage() const
tomwalters@509: {
tomwalters@509:     if( !typeTag_ )
tomwalters@509:         throw MissingArgumentException();
tomwalters@509: 	else if( *typeTag_ == MIDI_MESSAGE_TYPE_TAG )
tomwalters@509: 		return AsMidiMessageUnchecked();
tomwalters@509: 	else
tomwalters@509: 		throw WrongArgumentTypeException();
tomwalters@509: }
tomwalters@509: 
tomwalters@509: 
tomwalters@509: uint32 ReceivedMessageArgument::AsMidiMessageUnchecked() const
tomwalters@509: {
tomwalters@509: 	return ToUInt32( argument_ );
tomwalters@509: }
tomwalters@509: 
tomwalters@509: 
tomwalters@509: int64 ReceivedMessageArgument::AsInt64() const
tomwalters@509: {
tomwalters@509:     if( !typeTag_ )
tomwalters@509:         throw MissingArgumentException();
tomwalters@509: 	else if( *typeTag_ == INT64_TYPE_TAG )
tomwalters@509: 		return AsInt64Unchecked();
tomwalters@509: 	else
tomwalters@509: 		throw WrongArgumentTypeException();
tomwalters@509: }
tomwalters@509: 
tomwalters@509: 
tomwalters@509: int64 ReceivedMessageArgument::AsInt64Unchecked() const
tomwalters@509: {
tomwalters@509:     return ToInt64( argument_ );
tomwalters@509: }
tomwalters@509: 
tomwalters@509: 
tomwalters@509: uint64 ReceivedMessageArgument::AsTimeTag() const
tomwalters@509: {
tomwalters@509:     if( !typeTag_ )
tomwalters@509:         throw MissingArgumentException();
tomwalters@509: 	else if( *typeTag_ == TIME_TAG_TYPE_TAG )
tomwalters@509: 		return AsTimeTagUnchecked();
tomwalters@509: 	else
tomwalters@509: 		throw WrongArgumentTypeException();
tomwalters@509: }
tomwalters@509: 
tomwalters@509: 
tomwalters@509: uint64 ReceivedMessageArgument::AsTimeTagUnchecked() const
tomwalters@509: {
tomwalters@509:     return ToUInt64( argument_ );
tomwalters@509: }
tomwalters@509: 
tomwalters@509: 
tomwalters@509: double ReceivedMessageArgument::AsDouble() const
tomwalters@509: {
tomwalters@509:     if( !typeTag_ )
tomwalters@509:         throw MissingArgumentException();
tomwalters@509: 	else if( *typeTag_ == DOUBLE_TYPE_TAG )
tomwalters@509: 		return AsDoubleUnchecked();
tomwalters@509: 	else
tomwalters@509: 		throw WrongArgumentTypeException();
tomwalters@509: }
tomwalters@509: 
tomwalters@509: 
tomwalters@509: double ReceivedMessageArgument::AsDoubleUnchecked() const
tomwalters@509: {
tomwalters@509: #ifdef OSC_HOST_LITTLE_ENDIAN
tomwalters@509:     union{
tomwalters@509:         double d;
tomwalters@509:         char c[8];
tomwalters@509:     } u;
tomwalters@509: 
tomwalters@509:     u.c[0] = argument_[7];
tomwalters@509:     u.c[1] = argument_[6];
tomwalters@509:     u.c[2] = argument_[5];
tomwalters@509:     u.c[3] = argument_[4];
tomwalters@509:     u.c[4] = argument_[3];
tomwalters@509:     u.c[5] = argument_[2];
tomwalters@509:     u.c[6] = argument_[1];
tomwalters@509:     u.c[7] = argument_[0];
tomwalters@509: 
tomwalters@509:     return u.d;
tomwalters@509: #else
tomwalters@509: 	return *(double*)argument_;
tomwalters@509: #endif
tomwalters@509: }
tomwalters@509: 
tomwalters@509: 
tomwalters@509: const char* ReceivedMessageArgument::AsString() const
tomwalters@509: {
tomwalters@509:     if( !typeTag_ )
tomwalters@509:         throw MissingArgumentException();
tomwalters@509: 	else if( *typeTag_ == STRING_TYPE_TAG )
tomwalters@509: 		return argument_;
tomwalters@509: 	else
tomwalters@509: 		throw WrongArgumentTypeException();
tomwalters@509: }
tomwalters@509: 
tomwalters@509: 
tomwalters@509: const char* ReceivedMessageArgument::AsSymbol() const
tomwalters@509: {
tomwalters@509:     if( !typeTag_ )
tomwalters@509:         throw MissingArgumentException();
tomwalters@509: 	else if( *typeTag_ == SYMBOL_TYPE_TAG )
tomwalters@509: 		return argument_;
tomwalters@509: 	else
tomwalters@509: 		throw WrongArgumentTypeException();
tomwalters@509: }
tomwalters@509: 
tomwalters@509: 
tomwalters@509: void ReceivedMessageArgument::AsBlob( const void*& data, unsigned long& size ) const
tomwalters@509: {
tomwalters@509:     if( !typeTag_ )
tomwalters@509:         throw MissingArgumentException();
tomwalters@509: 	else if( *typeTag_ == BLOB_TYPE_TAG )
tomwalters@509: 		AsBlobUnchecked( data, size );
tomwalters@509: 	else
tomwalters@509: 		throw WrongArgumentTypeException();
tomwalters@509: }
tomwalters@509: 
tomwalters@509: 
tomwalters@509: void ReceivedMessageArgument::AsBlobUnchecked( const void*& data, unsigned long& size ) const
tomwalters@509: {
tomwalters@509:     size = ToUInt32( argument_ );
tomwalters@509: 	data = (void*)(argument_+4);
tomwalters@509: }
tomwalters@509: 
tomwalters@509: //------------------------------------------------------------------------------
tomwalters@509: 
tomwalters@509: void ReceivedMessageArgumentIterator::Advance()
tomwalters@509: {
tomwalters@509:     if( !value_.typeTag_ )
tomwalters@509:         return;
tomwalters@509:         
tomwalters@509:     switch( *value_.typeTag_++ ){
tomwalters@509:         case '\0':
tomwalters@509:             // don't advance past end
tomwalters@509:             --value_.typeTag_;
tomwalters@509:             break;
tomwalters@509:             
tomwalters@509:         case TRUE_TYPE_TAG:
tomwalters@509:         case FALSE_TYPE_TAG:
tomwalters@509:         case NIL_TYPE_TAG:
tomwalters@509:         case INFINITUM_TYPE_TAG:
tomwalters@509: 
tomwalters@509:             // zero length
tomwalters@509:             break;
tomwalters@509: 
tomwalters@509:         case INT32_TYPE_TAG:
tomwalters@509:         case FLOAT_TYPE_TAG: 					
tomwalters@509:         case CHAR_TYPE_TAG:
tomwalters@509:         case RGBA_COLOR_TYPE_TAG:
tomwalters@509:         case MIDI_MESSAGE_TYPE_TAG:
tomwalters@509: 
tomwalters@509:             value_.argument_ += 4;
tomwalters@509:             break;
tomwalters@509: 
tomwalters@509:         case INT64_TYPE_TAG:
tomwalters@509:         case TIME_TAG_TYPE_TAG:
tomwalters@509:         case DOUBLE_TYPE_TAG:
tomwalters@509: 				
tomwalters@509:             value_.argument_ += 8;
tomwalters@509:             break;
tomwalters@509: 
tomwalters@509:         case STRING_TYPE_TAG: 
tomwalters@509:         case SYMBOL_TYPE_TAG:
tomwalters@509: 
tomwalters@509:             // we use the unsafe function FindStr4End(char*) here because all of
tomwalters@509:             // the arguments have already been validated in
tomwalters@509:             // ReceivedMessage::Init() below.
tomwalters@509:             
tomwalters@509:             value_.argument_ = FindStr4End( value_.argument_ );
tomwalters@509:             break;
tomwalters@509: 
tomwalters@509:         case BLOB_TYPE_TAG:
tomwalters@509:             {
tomwalters@509:                 uint32 blobSize = ToUInt32( value_.argument_ );
tomwalters@509:                 value_.argument_ = value_.argument_ + 4 + RoundUp4( blobSize );
tomwalters@509:             }
tomwalters@509:             break;
tomwalters@509: 
tomwalters@509:         default:    // unknown type tag
tomwalters@509:             // don't advance
tomwalters@509:             --value_.typeTag_;
tomwalters@509:             break;
tomwalters@509:             
tomwalters@509: 
tomwalters@509:         //    not handled:
tomwalters@509:         //    [ Indicates the beginning of an array. The tags following are for
tomwalters@509:         //        data in the Array until a close brace tag is reached.
tomwalters@509:         //    ] Indicates the end of an array.
tomwalters@509:     }
tomwalters@509: }
tomwalters@509: 
tomwalters@509: //------------------------------------------------------------------------------
tomwalters@509: 
tomwalters@509: ReceivedMessage::ReceivedMessage( const ReceivedPacket& packet )
tomwalters@509:     : addressPattern_( packet.Contents() )
tomwalters@509: {
tomwalters@509:     Init( packet.Contents(), packet.Size() );
tomwalters@509: }
tomwalters@509: 
tomwalters@509: 
tomwalters@509: ReceivedMessage::ReceivedMessage( const ReceivedBundleElement& bundleElement )
tomwalters@509:     : addressPattern_( bundleElement.Contents() )
tomwalters@509: {
tomwalters@509:     Init( bundleElement.Contents(), bundleElement.Size() );
tomwalters@509: }
tomwalters@509: 
tomwalters@509: 
tomwalters@509: bool ReceivedMessage::AddressPatternIsUInt32() const
tomwalters@509: {
tomwalters@509: 	return (addressPattern_[0] == '\0');
tomwalters@509: }
tomwalters@509: 
tomwalters@509: 
tomwalters@509: uint32 ReceivedMessage::AddressPatternAsUInt32() const
tomwalters@509: {
tomwalters@509:     return ToUInt32( addressPattern_ );
tomwalters@509: }
tomwalters@509: 
tomwalters@509: 
tomwalters@509: void ReceivedMessage::Init( const char *message, unsigned long size )
tomwalters@509: {
tomwalters@509:     if( size == 0 )
tomwalters@509:         throw MalformedMessageException( "zero length messages not permitted" );
tomwalters@509: 
tomwalters@509:     if( (size & 0x03L) != 0 )
tomwalters@509:         throw MalformedMessageException( "message size must be multiple of four" );
tomwalters@509: 
tomwalters@509:     const char *end = message + size;
tomwalters@509: 
tomwalters@509:     typeTagsBegin_ = FindStr4End( addressPattern_, end );
tomwalters@509:     if( typeTagsBegin_ == 0 ){
tomwalters@509:         // address pattern was not terminated before end
tomwalters@509:         throw MalformedMessageException( "unterminated address pattern" );
tomwalters@509:     }
tomwalters@509: 
tomwalters@509:     if( typeTagsBegin_ == end ){
tomwalters@509:         // message consists of only the address pattern - no arguments or type tags.
tomwalters@509:         typeTagsBegin_ = 0;
tomwalters@509:         typeTagsEnd_ = 0;
tomwalters@509:         arguments_ = 0;
tomwalters@509:             
tomwalters@509:     }else{
tomwalters@509:         if( *typeTagsBegin_ != ',' )
tomwalters@509:             throw MalformedMessageException( "type tags not present" );
tomwalters@509: 
tomwalters@509:         if( *(typeTagsBegin_ + 1) == '\0' ){
tomwalters@509:             // zero length type tags
tomwalters@509:             typeTagsBegin_ = 0;
tomwalters@509:             typeTagsEnd_ = 0;
tomwalters@509:             arguments_ = 0;
tomwalters@509: 
tomwalters@509:         }else{
tomwalters@509:             // check that all arguments are present and well formed
tomwalters@509:                 
tomwalters@509:             arguments_ = FindStr4End( typeTagsBegin_, end );
tomwalters@509:             if( arguments_ == 0 ){
tomwalters@509:                 throw MalformedMessageException( "type tags were not terminated before end of message" );
tomwalters@509:             }
tomwalters@509: 
tomwalters@509:             ++typeTagsBegin_; // advance past initial ','
tomwalters@509:             
tomwalters@509:             const char *typeTag = typeTagsBegin_;
tomwalters@509:             const char *argument = arguments_;
tomwalters@509:                         
tomwalters@509:             do{
tomwalters@509:                 switch( *typeTag ){
tomwalters@509:                     case TRUE_TYPE_TAG:
tomwalters@509:                     case FALSE_TYPE_TAG:
tomwalters@509:                     case NIL_TYPE_TAG:
tomwalters@509:                     case INFINITUM_TYPE_TAG:
tomwalters@509: 
tomwalters@509:                         // zero length
tomwalters@509:                         break;
tomwalters@509: 
tomwalters@509:                     case INT32_TYPE_TAG:
tomwalters@509:                     case FLOAT_TYPE_TAG:
tomwalters@509:                     case CHAR_TYPE_TAG:
tomwalters@509:                     case RGBA_COLOR_TYPE_TAG:
tomwalters@509:                     case MIDI_MESSAGE_TYPE_TAG:
tomwalters@509: 
tomwalters@509:                         if( argument == end )
tomwalters@509:                             throw MalformedMessageException( "arguments exceed message size" );
tomwalters@509:                         argument += 4;
tomwalters@509:                         if( argument > end )
tomwalters@509:                             throw MalformedMessageException( "arguments exceed message size" );
tomwalters@509:                         break;
tomwalters@509: 
tomwalters@509:                     case INT64_TYPE_TAG:
tomwalters@509:                     case TIME_TAG_TYPE_TAG:
tomwalters@509:                     case DOUBLE_TYPE_TAG:
tomwalters@509: 
tomwalters@509:                         if( argument == end )
tomwalters@509:                             throw MalformedMessageException( "arguments exceed message size" );
tomwalters@509:                         argument += 8;
tomwalters@509:                         if( argument > end )
tomwalters@509:                             throw MalformedMessageException( "arguments exceed message size" );
tomwalters@509:                         break;
tomwalters@509: 
tomwalters@509:                     case STRING_TYPE_TAG: 
tomwalters@509:                     case SYMBOL_TYPE_TAG:
tomwalters@509:                     
tomwalters@509:                         if( argument == end )
tomwalters@509:                             throw MalformedMessageException( "arguments exceed message size" );
tomwalters@509:                         argument = FindStr4End( argument, end );
tomwalters@509:                         if( argument == 0 )
tomwalters@509:                             throw MalformedMessageException( "unterminated string argument" );
tomwalters@509:                         break;
tomwalters@509: 
tomwalters@509:                     case BLOB_TYPE_TAG:
tomwalters@509:                         {
tomwalters@509:                             if( argument + 4 > end )
tomwalters@509:                                 MalformedMessageException( "arguments exceed message size" );
tomwalters@509:                                 
tomwalters@509:                             uint32 blobSize = ToUInt32( argument );
tomwalters@509:                             argument = argument + 4 + RoundUp4( blobSize );
tomwalters@509:                             if( argument > end )
tomwalters@509:                                 MalformedMessageException( "arguments exceed message size" );
tomwalters@509:                         }
tomwalters@509:                         break;
tomwalters@509:                         
tomwalters@509:                     default:
tomwalters@509:                         throw MalformedMessageException( "unknown type tag" );
tomwalters@509: 
tomwalters@509:                     //    not handled:
tomwalters@509:                     //    [ Indicates the beginning of an array. The tags following are for
tomwalters@509:                     //        data in the Array until a close brace tag is reached.
tomwalters@509:                     //    ] Indicates the end of an array.
tomwalters@509:                 }
tomwalters@509: 
tomwalters@509:             }while( *++typeTag != '\0' );
tomwalters@509:             typeTagsEnd_ = typeTag;
tomwalters@509:         }
tomwalters@509:     }
tomwalters@509: }
tomwalters@509: 
tomwalters@509: //------------------------------------------------------------------------------
tomwalters@509: 
tomwalters@509: ReceivedBundle::ReceivedBundle( const ReceivedPacket& packet )
tomwalters@509:     : elementCount_( 0 )
tomwalters@509: {
tomwalters@509:     Init( packet.Contents(), packet.Size() );
tomwalters@509: }
tomwalters@509: 
tomwalters@509: 
tomwalters@509: ReceivedBundle::ReceivedBundle( const ReceivedBundleElement& bundleElement )
tomwalters@509:     : elementCount_( 0 )
tomwalters@509: {
tomwalters@509:     Init( bundleElement.Contents(), bundleElement.Size() );
tomwalters@509: }
tomwalters@509: 
tomwalters@509: 
tomwalters@509: void ReceivedBundle::Init( const char *bundle, unsigned long size )
tomwalters@509: {
tomwalters@509:     if( size < 16 )
tomwalters@509:         throw MalformedBundleException( "packet too short for bundle" );
tomwalters@509: 
tomwalters@509:     if( (size & 0x03L) != 0 )
tomwalters@509:         throw MalformedBundleException( "bundle size must be multiple of four" );
tomwalters@509: 
tomwalters@509:     if( bundle[0] != '#'
tomwalters@509:         || bundle[1] != 'b'
tomwalters@509:         || bundle[2] != 'u'
tomwalters@509:         || bundle[3] != 'n'
tomwalters@509:         || bundle[4] != 'd'
tomwalters@509:         || bundle[5] != 'l'
tomwalters@509:         || bundle[6] != 'e'
tomwalters@509:         || bundle[7] != '\0' )
tomwalters@509:             throw MalformedBundleException( "bad bundle address pattern" );    
tomwalters@509: 
tomwalters@509:     end_ = bundle + size;
tomwalters@509: 
tomwalters@509:     timeTag_ = bundle + 8;
tomwalters@509: 
tomwalters@509:     const char *p = timeTag_ + 8;
tomwalters@509:         
tomwalters@509:     while( p < end_ ){
tomwalters@509:         if( p + 4 > end_ )
tomwalters@509:             throw MalformedBundleException( "packet too short for elementSize" );
tomwalters@509: 
tomwalters@509:         uint32 elementSize = ToUInt32( p );
tomwalters@509:         if( (elementSize & 0x03L) != 0 )
tomwalters@509:             throw MalformedBundleException( "bundle element size must be multiple of four" );
tomwalters@509: 
tomwalters@509:         p += 4 + elementSize;
tomwalters@509:         if( p > end_ )
tomwalters@509:             throw MalformedBundleException( "packet too short for bundle element" );
tomwalters@509: 
tomwalters@509:         ++elementCount_;
tomwalters@509:     }
tomwalters@509: 
tomwalters@509:     if( p != end_ )
tomwalters@509:         throw MalformedBundleException( "bundle contents " );
tomwalters@509: }
tomwalters@509: 
tomwalters@509: 
tomwalters@509: uint64 ReceivedBundle::TimeTag() const
tomwalters@509: {
tomwalters@509:     return ToUInt64( timeTag_ );
tomwalters@509: }
tomwalters@509: 
tomwalters@509: 
tomwalters@509: } // namespace osc
tomwalters@509: