CORBA 2.6.1 Programmer's Reference

void read( char *pp_sink, const unsigned long pv_count );
Attempts to copy pv_count bytes from the list of Fw_MDs in the Fw_Message to the location
pointed to by pp_sink. The transfer begins at the ip_user_read of the current read
Fw_MD. If the current Fw_MD is exhausted, the next Fw_MD is made the current and the operation
continues until pv_count bytes have been transferred or the list of Fw_MDs is exhausted.
iv_bytes_read is incremented by the lesser of pv_count or the actual number of bytes read..
void align_read( const unsigned long pv_count );
Calculates how many bytes are needed to advance iv_bytes_read to be a multiple of
pv_count, then calls skip_read on the current read Fw_MD with that value. If the current
read Fw_MD is exhausted, the next Fw_MD is made the current read Fw_MD and the operation
continues until completion or the list of Fw_MDs is exhausted. iv_bytes_read is incremented
by count required to achieve alignment.
void read( char *pp_sink, const unsigned long pv_count, unsigned long
pv_align );
Helper routine that is identical to the previous read method, except that align_read(
pv_align) is called first. This method is used by the ORB when demarshalling common data
representation (CDR) encoded messages.
long read_long( void );
Helper routine that reads an aligned signed long from the Fw_Message.
unsigned long read_ulong( void );
Helper routine that reads an aligned unsigned long from the Fw_Message.
void skip_read( const unsigned long pv_count );
Performs a skip_read on the current read Fw_MD. If the current read Fw_MD is exhausted,
the next Fw_MD is made the current read Fw_MD and the operation continues until pv_count
bytes have been skipped or the list of Fw_MDs is exhausted. iv_bytes_read is incremented by
the lesser of pv_count or the actual number of bytes read.
void reset_read( void );
Walks through the list of Fw_MDs, calling reset_read on each. Sets iv_bytes_read to its
original value. Sets the current read Fw_MD to the first Fw_MD in the list in the Fw_Message.
void begin_write( long pv_buffer_size = DEFAULT_BUFFER_SIZE);
Prepares an empty Fw_Message for write operations by obtaining an Fw_MD and placing it as
the first Fw_MD in the list in the Fw_Message, and making that Fw_MD the current write
Fw_MD. All Fw_MDs obtained by an Fw_Message for write operations have a size of
Fw_Message::DEFAULT_BUFFER_SIZE.
void write( char *pp_source, const unsigned long pv_count );
Transfers pv_count bytes from pp_source into the Fw_Message, starting after the last
logical data byte in the Fw_Message. This is accomplished by calling write on the current
write Fw_MD. If the Fw_MD is full, a new Fw_MD is obtained, added to the list in the