NAME

Tibco::Rv::Msg::Field - Manipulate a Tibco message field

SYNOPSIS

   my ( $field ) = $msg->createField( name => 'myField' );
   $field->i8( 123 );
   $field->opaque( "abc\0abc" );
   $field->ipaddr32( '66.35.250.150' );
   $field->u64array( [ 1, 123, 3030 ] );
   print "U64Array\n" if ( $field->type == Tibco::Rv::Msg::U64ARRAY );
   print "Count: ", $field->count, "; size: ", $field->size, "\n";

DESCRIPTION

Message Field-manipulating class. Holds a single value, like a C enum, along with a name and an id.

CONSTRUCTOR

$field = new Tibco::Rv::Msg::Field( %args )

   %args:
      name => $name,
      id => $id

Creates a Tibco::Rv::Msg::Field, with name and id as given in %args (name defaults '' and id defaults to 0, if not specified). $field is initialized with boolean value Tibco::Rv::FALSE.

METHODS

$name = $field->name

Returns $field's name.

$field->name( $name )

Sets $field's name to $name. If $name is undef, sets name to ''.

$id = $field->id

Returns $field's id.

$field->id( $id )

Sets $field's id.

$count = $field->count

Returns $field's count. For array types, $count is the number of elements in the array. For all other types, $count is 1.

$size = $field->size

Returns $field's size. For array types, $size is the size in bytes of one element of the array. For all other types, $size is the size in bytes of the data (for strings, this includes the NULL terminator, and for xml or opaque fields, this is the total number of bytes).

$type = $field->type

Returns the Tibco::Rv::Msg Message Type Constant representing the type of data contained in the field.

$value = $field-><type>

Gets the $value currently held in $field. Dies with a Tibco::Rv::ARG_CONFLICT Status message if <type> does not match the type of data currently held by $field.

$field-><type>( $value )

   <type> can be:
      bool, str, opaque, xml,
      f32, f64, i8, i16, i32, i64, u8, u16, u32, u64,
      ipaddr32, ipport16, date, or msg

Sets the value of $field to $value, changing $field to type <type> if it is not already.

$valueAryRef = $field-><type>array

Same as <type>, except it returns an array reference of values.

$field-><type>array( [ $val1, $val2, ... ] )

   <type> can be:
      f32, f64, i8, i16, i32, i64, u8, u16, u32, u64

Some as <type>, except it must be given an array reference of values.

AUTHOR

Paul Sturm <sturm@branewave.com>

CPAN RT