StreamBuffer Class Reference

The stream buffer is a small object collecting object data. More...

#include <GaudiKernel/StreamBuffer.h>

Collaboration diagram for StreamBuffer:

Classes
class	ContainedLink
	Definition of the contained link set. More...
class	DataIO
	A small base class to handle generic data streaming. More...
class	IdentifiedLink
	Definition of the contained link set. More...
class	Istream
	Reader for standard input streams. More...
class	Ostream
	Writer for standard output streams. More...

Public Types
enum	Mode { UNINITIALIZED , READING , WRITING }
	Streamer mode. More...
enum	SwapAction { SINGLE_BYTE , SWAP , NOSWAP }
	Data Sawp actions. More...
enum	State { INVALID = -1 , VALID }
	Link state defintions. More...
typedef std::vector< ContainedLink >	ContainedLinks
typedef std::vector< IdentifiedLink >	IdentifiedLinks
	Definition of the identifiable link set.
typedef void(*	AnalyzeFunction) (const void *data, int siz, const std::type_info &type)
	Definition of the buffer analyzer.

Public Member Functions
	StreamBuffer (bool do_swap=true)
	Standard constructor.
virtual	~StreamBuffer ()
	Standard destructor.
	StreamBuffer (const StreamBuffer &)=delete
	No copy.
StreamBuffer &	operator= (const StreamBuffer &)=delete
	No assignment.
const char *	data () const
	Read access to data buffer.
char *	data ()
	write access to data buffer
void	erase ()
	Reset the buffer.
char *	adopt () const
	Remove the data buffer and pass it to client. It's the client responsability to free the memory.
void	reserve (long len)
	Reserve buffer space; Default: 16 k buffer size.
void	extend (long len)
	Extend the buffer.
long	size () const
	Total buffer size.
ContainedLinks &	containedLinks ()
	Access to contained links.
const ContainedLinks &	containedLinks () const
	CONST Access to contained links.
IdentifiedLinks &	identifiedLinks ()
	Access to identified links.
const IdentifiedLinks &	identifiedLinks () const
	CONST Access to identified links.
void	setMode (Mode m)
	Set mode of the stream and allocate buffer.
bool	isReading () const
	Get stream buffer state.
bool	isWriting () const
	Get stream buffer state.
long	buffPointer () const
	Retrieve current buffer pointer.
void	setBuffPointer (long ptr)
	Retrieve current buffer pointer.
void	setAnalyzer (AnalyzeFunction fun=nullptr)
	Enable user analysis function.
void	swapToBuffer (const void *source, int siz)
	Swap buffers: int, long, short, float and double.
void	swapFromBuffer (void *target, int siz)
	Swap buffers: int, long, short, float and double.
StreamBuffer &	writeBytes (const char *str, long len)
	Write string to output stream.
void	getIdentifiedLink (DataObject *&pObject, long &hint)
void	addIdentifiedLink (const DataObject *pObject, long hint)
void	getContainedLink (ContainedObject *&pObject, long &hint, long &link)
void	addContainedLink (const ContainedObject *pObject, long hint, long link)
StreamBuffer &	operator<< (long long data)
	Output Streamer.
StreamBuffer &	operator>> (long long &data)
	Input Streamer.
StreamBuffer &	operator<< (int data)
	Output Streamer.
StreamBuffer &	operator>> (int &data)
	Input Streamer.
StreamBuffer &	operator<< (unsigned int data)
	Output Streamer.
StreamBuffer &	operator>> (unsigned int &data)
	Input Streamer.
StreamBuffer &	operator<< (long data)
	Output Streamer.
StreamBuffer &	operator>> (long &data)
	Input Streamer.
StreamBuffer &	operator<< (unsigned long data)
	Output Streamer.
StreamBuffer &	operator>> (unsigned long &data)
	Input Streamer.
StreamBuffer &	operator<< (short data)
	Output Streamer.
StreamBuffer &	operator>> (short &data)
	Input Streamer.
StreamBuffer &	operator<< (unsigned short data)
	Output Streamer.
StreamBuffer &	operator>> (unsigned short &data)
	Input Streamer.
StreamBuffer &	operator<< (char data)
	Output Streamer.
StreamBuffer &	operator>> (char &data)
	Input Streamer.
StreamBuffer &	operator<< (unsigned char data)
	Output Streamer.
StreamBuffer &	operator>> (unsigned char &data)
	Input Streamer.
StreamBuffer &	operator<< (float data)
	Output Streamer.
StreamBuffer &	operator>> (float &data)
	Input Streamer.
StreamBuffer &	operator<< (double data)
	Output Streamer.
StreamBuffer &	operator>> (double &data)
	Input Streamer.
StreamBuffer &	operator>> (char *data)
	Streamer to read strings in (char*) format.
StreamBuffer &	operator<< (const char *data)
	Streamer to write strings in (char*) format.
StreamBuffer &	operator>> (std::string &data)
	Streamer to read strings in (std::string) format.
StreamBuffer &	operator<< (const std::string &data)
	Streamer to write strings in (std::string) format.
template<class TYPE>
StreamBuffer &	operator>> (TYPE *&refpObject)
	Streamer to read links to contained or identified objects.
StreamBuffer &	operator<< (const ContainedObject *pObject)
	Streamer to write links to contained objects.
StreamBuffer &	operator<< (const DataObject *pObject)
	Streamer to write links to identified objects.
void	serialize (DataIO &ioObject)
	Serialize the buffer using an IO object.

Protected Member Functions
SwapAction	swapBuffer (int siz) const
	Check for byte swapping.
template<class TYPE>
StreamBuffer &	getObjectPointer (const DataObject *, TYPE *&refpObject)
	Helper to distinguish between identified pointers and contained pointers.
template<class TYPE>
StreamBuffer &	getObjectPointer (const ContainedObject *, TYPE *&refpObject)
	Helper to distinguish between identified pointers and contained pointers.

Protected Attributes
Mode	m_mode = UNINITIALIZED
	Boolean indicating wether the stream is in read or write mode.
long	m_pointer = 0
	Current buffer pointer.
long	m_length = 0
	Total buffer length.
char *	m_buffer = nullptr
	Pointer to heap buffer.
bool	m_swapEnabled = true
	Flag indicating swapping.
ContainedLinks	m_containedLinks
	Container with links to contained objects.
IdentifiedLinks	m_identifiedLinks
	Container with links to contained objects.
AnalyzeFunction	m_analyzer = nullptr
	Hook function for analysis of data to the stream.

Friends
class	DataObject
	DataObject is friend.

Detailed Description

The stream buffer is a small object collecting object data.

The basic idea behind the StreamBuffer is generic object conversion. The StreamBuffer acts as a byte stream (hence inheriting from a std::string: DP: this is not true anymore and it is not a bad thing in my opinion) and stores any information streamed to the buffer. Since the information must be represented in a generic way on the fly byte swapping is performed. However, not only primitive data can be stored in the buffer, but also pointers to DataObjects (symbolic links) and pointers to contained objects. Automatically during serialization the persistent references to the corresponding objects and containers must be stored. These objects are accessible from the StreamBuffer object.

"On the fly" data conversion to non persistent

Author

M.Frank

Definition at line 47 of file StreamBuffer.h.

Member Typedef Documentation

AnalyzeFunction

typedef void(* StreamBuffer::AnalyzeFunction) (const void *data, int siz, const std::type_info &type)

Definition of the buffer analyzer.

Definition at line 144 of file StreamBuffer.h.

ContainedLinks

typedef std::vector<ContainedLink> StreamBuffer::ContainedLinks

Definition at line 140 of file StreamBuffer.h.

IdentifiedLinks

typedef std::vector<IdentifiedLink> StreamBuffer::IdentifiedLinks

Definition of the identifiable link set.

Definition at line 142 of file StreamBuffer.h.

Member Enumeration Documentation

Mode

enum StreamBuffer::Mode

Streamer mode.

Enumerator
UNINITIALIZED
READING
WRITING

Definition at line 113 of file StreamBuffer.h.

{ UNINITIALIZED, READING, WRITING };

State

enum StreamBuffer::State

Link state defintions.

Enumerator
INVALID
VALID

Definition at line 117 of file StreamBuffer.h.

{ INVALID = -1, VALID };

SwapAction

enum StreamBuffer::SwapAction

Data Sawp actions.

Enumerator
SINGLE_BYTE
SWAP
NOSWAP

Definition at line 115 of file StreamBuffer.h.

{ SINGLE_BYTE, SWAP, NOSWAP };

Constructor & Destructor Documentation

StreamBuffer() [1/2]

StreamBuffer::StreamBuffer ( bool do_swap = true )

inline

Standard constructor.

Definition at line 201 of file StreamBuffer.h.

: m_swapEnabled( do_swap ) {}

~StreamBuffer()

virtual StreamBuffer::~StreamBuffer ( )

inlinevirtual

Standard destructor.

Definition at line 203 of file StreamBuffer.h.

{ ::free( m_buffer ); }

StreamBuffer() [2/2]

StreamBuffer::StreamBuffer ( const StreamBuffer & )

delete

No copy.

Member Function Documentation

addContainedLink()

void StreamBuffer::addContainedLink ( const ContainedObject * pObject, long hint, long link )

inline

Definition at line 304 of file StreamBuffer.h.

                                                                                {
    m_containedLinks.push_back( ContainedLink( const_cast<ContainedObject*>( pObject ), hint, link ) );
  }

addIdentifiedLink()

void StreamBuffer::addIdentifiedLink ( const DataObject * pObject, long hint )

inline

Definition at line 293 of file StreamBuffer.h.

                                                                 {
    m_identifiedLinks.push_back( IdentifiedLink( const_cast<DataObject*>( pObject ), hint ) );
  }

adopt()

char * StreamBuffer::adopt ( ) const

inline

Remove the data buffer and pass it to client. It's the client responsability to free the memory.

Definition at line 215 of file StreamBuffer.h.

                      {
    char* ptr = m_buffer;
    m_containedLinks.erase( m_containedLinks.begin(), m_containedLinks.end() );
    m_identifiedLinks.erase( m_identifiedLinks.begin(), m_identifiedLinks.end() );
    m_buffer  = NULL; // char *
    m_pointer = 0;    // long
    m_length  = 0;    // long
    return ptr;
  }

buffPointer()

long StreamBuffer::buffPointer ( ) const

inline

Retrieve current buffer pointer.

Definition at line 267 of file StreamBuffer.h.

{ return m_pointer; }

containedLinks() [1/2]

ContainedLinks & StreamBuffer::containedLinks ( )

inline

Access to contained links.

Definition at line 244 of file StreamBuffer.h.

{ return m_containedLinks; }

containedLinks() [2/2]

const ContainedLinks & StreamBuffer::containedLinks ( ) const

inline

CONST Access to contained links.

Definition at line 246 of file StreamBuffer.h.

{ return m_containedLinks; }

data() [1/2]

char * StreamBuffer::data ( )

inline

write access to data buffer

Definition at line 211 of file StreamBuffer.h.

{ return m_buffer; }

data() [2/2]

const char * StreamBuffer::data ( ) const

inline

Read access to data buffer.

Definition at line 209 of file StreamBuffer.h.

{ return m_buffer; }

erase()

void StreamBuffer::erase ( )

inline

Reset the buffer.

Definition at line 213 of file StreamBuffer.h.

{ m_pointer = 0; }

extend()

void StreamBuffer::extend ( long len )

inline

Extend the buffer.

Definition at line 232 of file StreamBuffer.h.

                          {
    if ( len + m_pointer > m_length ) {
      // We have to be a bit generous here in order not to run too often
      // into ::realloc().
      long new_len = ( m_length < 16384 ) ? 16384 : 2 * m_length;
      if ( m_length < len ) new_len += len;
      reserve( new_len );
    }
  }

getContainedLink()

void StreamBuffer::getContainedLink ( ContainedObject *& pObject, long & hint, long & link )

inline

Definition at line 297 of file StreamBuffer.h.

                                                                             {
    ContainedLink& l = m_containedLinks.back();
    pObject          = l.first;
    hint             = l.second;
    link             = l.third;
    m_containedLinks.pop_back();
  }

getIdentifiedLink()

void StreamBuffer::getIdentifiedLink ( DataObject *& pObject, long & hint )

inline

Definition at line 287 of file StreamBuffer.h.

                                                             {
    IdentifiedLink& l = m_identifiedLinks.back();
    pObject           = l.first;
    hint              = l.second;
    m_identifiedLinks.pop_back();
  }

getObjectPointer() [1/2]

template<class TYPE>

StreamBuffer & StreamBuffer::getObjectPointer ( const ContainedObject * , TYPE *& refpObject )

inlineprotected

Helper to distinguish between identified pointers and contained pointers.

This entry resolves contained pointers (= Pointers to ContainedObject instances.)

Definition at line 191 of file StreamBuffer.h.

                                                                                {
    ContainedLink&   link = m_containedLinks.back();
    ContainedObject* pObj = link.first;
    m_containedLinks.pop_back();
    refpObject = dynamic_cast<TYPE*>( pObj );
    return *this;
  }

getObjectPointer() [2/2]

template<class TYPE>

StreamBuffer & StreamBuffer::getObjectPointer ( const DataObject * , TYPE *& refpObject )

inlineprotected

Helper to distinguish between identified pointers and contained pointers.

This entry resolves identified pointers (= Pointers to DataObject instances.)

Definition at line 180 of file StreamBuffer.h.

                                                                           {
    IdentifiedLink& link = m_identifiedLinks.back();
    DataObject*     pObj = link.first;
    m_identifiedLinks.pop_back();
    refpObject = dynamic_cast<TYPE*>( pObj );
    return *this;
  }

identifiedLinks() [1/2]

IdentifiedLinks & StreamBuffer::identifiedLinks ( )

inline

Access to identified links.

Definition at line 249 of file StreamBuffer.h.

{ return m_identifiedLinks; }

identifiedLinks() [2/2]

const IdentifiedLinks & StreamBuffer::identifiedLinks ( ) const

inline

CONST Access to identified links.

Definition at line 251 of file StreamBuffer.h.

{ return m_identifiedLinks; }

isReading()

bool StreamBuffer::isReading ( ) const

inline

Get stream buffer state.

Definition at line 262 of file StreamBuffer.h.

{ return m_mode == READING; }

isWriting()

bool StreamBuffer::isWriting ( ) const

inline

Get stream buffer state.

Definition at line 265 of file StreamBuffer.h.

{ return m_mode == WRITING; }

operator<<() [1/15]

StreamBuffer & StreamBuffer::operator<< ( char data )

inline

Output Streamer.

Definition at line 410 of file StreamBuffer.h.

                                        {
    swapToBuffer( &data, sizeof( data ) );
    STREAM_ANALYSE( data, sizeof( data ) );
    return *this;
  }

operator<<() [2/15]

StreamBuffer & StreamBuffer::operator<< ( const char * data )

inline

Streamer to write strings in (char*) format.

Definition at line 461 of file StreamBuffer.h.

                                               {
    const char* ptr = 0 == data ? "" : data;
    size_t      len = strlen( ptr ) + 1;
    if ( 0 == m_analyzer )
      writeBytes( ptr, len );
    else { STREAM_ANALYSE( data, len ); }
    return *this;
  }

operator<<() [3/15]

StreamBuffer & StreamBuffer::operator<< ( const ContainedObject * pObject )

inline

Streamer to write links to contained objects.

Links to contained objects are not stored immediately, but collected instead and analyzed later.

Parameters

pObject

Pointer to object to be loaded.

Returns

Reference to StreamBuffer object

Definition at line 504 of file StreamBuffer.h.

                                                             {
    STREAM_ANALYSE( pObject, sizeof( pObject ) );
    addContainedLink( pObject, INVALID, INVALID );
    return *this;
  }

operator<<() [4/15]

StreamBuffer & StreamBuffer::operator<< ( const DataObject * pObject )

inline

Streamer to write links to identified objects.

Links to identified objects are not stored immediately, but collected instead and analyzed later.

Parameters

pObject

Pointer to object to be loaded.

Returns

Reference to StreamBuffer object

Definition at line 516 of file StreamBuffer.h.

                                                        {
    STREAM_ANALYSE( pObject, sizeof( pObject ) );
    addIdentifiedLink( pObject, INVALID );
    return *this;
  }

operator<<() [5/15]

StreamBuffer & StreamBuffer::operator<< ( const std::string & data )

inline

Streamer to write strings in (std::string) format.

Definition at line 477 of file StreamBuffer.h.

                                                    {
    if ( 0 == m_analyzer ) {
      const char* ptr = data.c_str();
      long        len = data.length();
      writeBytes( ptr, len );
    } else {
      STREAM_ANALYSE( data, sizeof( data ) );
    }
    return *this;
  }

operator<<() [6/15]

StreamBuffer & StreamBuffer::operator<< ( double data )

inline

Output Streamer.

Definition at line 443 of file StreamBuffer.h.

                                          {
    swapToBuffer( &data, sizeof( data ) );
    STREAM_ANALYSE( data, sizeof( data ) );
    return *this;
  }

operator<<() [7/15]

StreamBuffer & StreamBuffer::operator<< ( float data )

inline

Output Streamer.

Definition at line 432 of file StreamBuffer.h.

                                         {
    swapToBuffer( &data, sizeof( data ) );
    STREAM_ANALYSE( data, sizeof( data ) );
    return *this;
  }

operator<<() [8/15]

StreamBuffer & StreamBuffer::operator<< ( int data )

inline

Output Streamer.

Definition at line 344 of file StreamBuffer.h.

                                       {
    swapToBuffer( &data, sizeof( data ) );
    STREAM_ANALYSE( data, sizeof( data ) );
    return *this;
  }

operator<<() [9/15]

StreamBuffer & StreamBuffer::operator<< ( long data )

inline

Output Streamer.

Definition at line 366 of file StreamBuffer.h.

                                        {
    swapToBuffer( &data, sizeof( data ) );
    STREAM_ANALYSE( data, sizeof( data ) );
    return *this;
  }

operator<<() [10/15]

StreamBuffer & StreamBuffer::operator<< ( long long data )

inline

Output Streamer.

Definition at line 333 of file StreamBuffer.h.

                                             {
    swapToBuffer( &data, sizeof( data ) );
    STREAM_ANALYSE( data, sizeof( data ) );
    return *this;
  }

operator<<() [11/15]

StreamBuffer & StreamBuffer::operator<< ( short data )

inline

Output Streamer.

Definition at line 388 of file StreamBuffer.h.

                                         {
    swapToBuffer( &data, sizeof( data ) );
    STREAM_ANALYSE( data, sizeof( data ) );
    return *this;
  }

operator<<() [12/15]

StreamBuffer & StreamBuffer::operator<< ( unsigned char data )

inline

Output Streamer.

Definition at line 421 of file StreamBuffer.h.

                                                 {
    swapToBuffer( &data, sizeof( data ) );
    STREAM_ANALYSE( data, sizeof( data ) );
    return *this;
  }

operator<<() [13/15]

StreamBuffer & StreamBuffer::operator<< ( unsigned int data )

inline

Output Streamer.

Definition at line 355 of file StreamBuffer.h.

                                                {
    swapToBuffer( &data, sizeof( data ) );
    STREAM_ANALYSE( data, sizeof( data ) );
    return *this;
  }

operator<<() [14/15]

StreamBuffer & StreamBuffer::operator<< ( unsigned long data )

inline

Output Streamer.

Definition at line 377 of file StreamBuffer.h.

                                                 {
    swapToBuffer( &data, sizeof( data ) );
    STREAM_ANALYSE( data, sizeof( data ) );
    return *this;
  }

operator<<() [15/15]

StreamBuffer & StreamBuffer::operator<< ( unsigned short data )

inline

Output Streamer.

Definition at line 399 of file StreamBuffer.h.

                                                  {
    swapToBuffer( &data, sizeof( data ) );
    STREAM_ANALYSE( data, sizeof( data ) );
    return *this;
  }

operator=()

StreamBuffer & StreamBuffer::operator= ( const StreamBuffer & )

delete

No assignment.

operator>>() [1/14]

StreamBuffer & StreamBuffer::operator>> ( char & data )

inline

Input Streamer.

Definition at line 416 of file StreamBuffer.h.

                                         {
    swapFromBuffer( &data, sizeof( data ) );
    return *this;
  }

operator>>() [2/14]

StreamBuffer & StreamBuffer::operator>> ( char * data )

inline

Streamer to read strings in (char*) format.

Definition at line 454 of file StreamBuffer.h.

                                         {
    long i, len;
    *this >> len;
    for ( i = 0, data[0] = 0; i < len; i++ ) { data[i] = m_buffer[m_pointer++]; }
    return *this;
  }

operator>>() [3/14]

StreamBuffer & StreamBuffer::operator>> ( double & data )

inline

Input Streamer.

Definition at line 449 of file StreamBuffer.h.

                                           {
    swapFromBuffer( &data, sizeof( data ) );
    return *this;
  }

operator>>() [4/14]

StreamBuffer & StreamBuffer::operator>> ( float & data )

inline

Input Streamer.

Definition at line 438 of file StreamBuffer.h.

                                          {
    swapFromBuffer( &data, sizeof( data ) );
    return *this;
  }

operator>>() [5/14]

StreamBuffer & StreamBuffer::operator>> ( int & data )

inline

Input Streamer.

Definition at line 350 of file StreamBuffer.h.

                                        {
    swapFromBuffer( &data, sizeof( data ) );
    return *this;
  }

operator>>() [6/14]

StreamBuffer & StreamBuffer::operator>> ( long & data )

inline

Input Streamer.

Definition at line 372 of file StreamBuffer.h.

                                         {
    swapFromBuffer( &data, sizeof( data ) );
    return *this;
  }

operator>>() [7/14]

StreamBuffer & StreamBuffer::operator>> ( long long & data )

inline

Input Streamer.

Definition at line 339 of file StreamBuffer.h.

                                              {
    swapFromBuffer( &data, sizeof( data ) );
    return *this;
  }

operator>>() [8/14]

StreamBuffer & StreamBuffer::operator>> ( short & data )

inline

Input Streamer.

Definition at line 394 of file StreamBuffer.h.

                                          {
    swapFromBuffer( &data, sizeof( data ) );
    return *this;
  }

operator>>() [9/14]

StreamBuffer & StreamBuffer::operator>> ( std::string & data )

inline

Streamer to read strings in (std::string) format.

Definition at line 470 of file StreamBuffer.h.

                                              {
    long i, len;
    *this >> len;
    for ( i = 0, data = ""; i < len; i++ ) { data.append( 1, m_buffer[m_pointer++] ); }
    return *this;
  }

operator>>() [10/14]

template<class TYPE>

StreamBuffer & StreamBuffer::operator>> ( TYPE *& refpObject )

inline

Streamer to read links to contained or identified objects.

The specified internal function call distinguishes between contained and identified objects.

Parameters

refpObject

Reference to pointer to object to be loaded.

Returns

Reference to StreamBuffer object

Definition at line 494 of file StreamBuffer.h.

                                                {
    return getObjectPointer( refpObject, refpObject );
  }

operator>>() [11/14]

StreamBuffer & StreamBuffer::operator>> ( unsigned char & data )

inline

Input Streamer.

Definition at line 427 of file StreamBuffer.h.

                                                  {
    swapFromBuffer( &data, sizeof( data ) );
    return *this;
  }

operator>>() [12/14]

StreamBuffer & StreamBuffer::operator>> ( unsigned int & data )

inline

Input Streamer.

Definition at line 361 of file StreamBuffer.h.

                                                 {
    swapFromBuffer( &data, sizeof( data ) );
    return *this;
  }

operator>>() [13/14]

StreamBuffer & StreamBuffer::operator>> ( unsigned long & data )

inline

Input Streamer.

Definition at line 383 of file StreamBuffer.h.

                                                  {
    swapFromBuffer( &data, sizeof( data ) );
    return *this;
  }

operator>>() [14/14]

StreamBuffer & StreamBuffer::operator>> ( unsigned short & data )

inline

Input Streamer.

Definition at line 405 of file StreamBuffer.h.

                                                   {
    swapFromBuffer( &data, sizeof( data ) );
    return *this;
  }

reserve()

void StreamBuffer::reserve ( long len )

inline

Reserve buffer space; Default: 16 k buffer size.

Definition at line 225 of file StreamBuffer.h.

                           {
    if ( len > m_length ) {
      m_length = ( len < 16384 ) ? 16384 : len;
      m_buffer = (char*)::realloc( m_buffer, m_length );
    }
  }

serialize()

void StreamBuffer::serialize ( DataIO & ioObject )

inline

Serialize the buffer using an IO object.

The streambuffer object will make use of a DataIO object, which can be specialized for streaming to any representation like e.g. disk files, Root files, Objectivity etc.

Parameters

ioObject

Reference to data IO object.

Definition at line 528 of file StreamBuffer.h.

                                     {
    ioObject.serialize( *this );
    m_pointer = 0;
  }

setAnalyzer()

void StreamBuffer::setAnalyzer ( AnalyzeFunction fun = nullptr )

inline

Enable user analysis function.

Definition at line 271 of file StreamBuffer.h.

{ m_analyzer = fun; }

setBuffPointer()

void StreamBuffer::setBuffPointer ( long ptr )

inline

Retrieve current buffer pointer.

Definition at line 269 of file StreamBuffer.h.

{ m_pointer = ptr; }

setMode()

void StreamBuffer::setMode ( Mode m )

inline

Set mode of the stream and allocate buffer.

Definition at line 254 of file StreamBuffer.h.

                         {
    m_mode    = m;
    m_pointer = 0;
    m_containedLinks.erase( m_containedLinks.begin(), m_containedLinks.end() );
    m_identifiedLinks.erase( m_identifiedLinks.begin(), m_identifiedLinks.end() );
  }

size()

long StreamBuffer::size ( ) const

inline

Total buffer size.

Definition at line 242 of file StreamBuffer.h.

{ return m_length; }

swapBuffer()

StreamBuffer::SwapAction StreamBuffer::swapBuffer ( int siz ) const

inlineprotected

Check for byte swapping.

Definition at line 537 of file StreamBuffer.h.

                                                                      {
  switch ( siz ) {
  case 1:
    return SINGLE_BYTE;
  default:
#if defined( __alpha ) && !defined( __VMS )
    //    return m_swapEnabled ? SWAP : NOSWAP;
    return NOSWAP;
#elif defined( __sun ) && defined( __SVR4 ) && defined( __i386 )
    //    return m_swapEnabled ? SWAP : NOSWAP;
    return NOSWAP;
#elif defined( __APPLE__ )
    //    return m_swapEnabled ? SWAP : NOSWAP;
    return SWAP;
#elif defined( __linux ) && !defined( __powerpc )
    //    return m_swapEnabled ? SWAP : NOSWAP;
    return NOSWAP;
#else
    return m_swapEnabled ? SWAP : NOSWAP;
//    return NOSWAP;
#endif
  }
}

swapFromBuffer()

void StreamBuffer::swapFromBuffer ( void * target, int siz )

inline

Swap buffers: int, long, short, float and double.

Swap bytes from the stream buffer to target buffer with arbitray size.

Definition at line 588 of file StreamBuffer.h.

                                                                {
  char* tar = (char*)target;
  char* src = m_buffer + m_pointer;
  switch ( swapBuffer( siz ) ) {
  case SINGLE_BYTE:
    *tar = *src;
    break;
  case SWAP:
#ifdef __APPLE__
    for ( int i = 0, j = siz - 1; i < siz; i++, j-- ) tar[j] = src[i];
#else
    ::swab( src, tar, siz );
#endif
    break;
  case NOSWAP:
    std::copy_n( src, siz, tar );
    break;
  default:
    break;
  }
  m_pointer += siz;
}

swapToBuffer()

void StreamBuffer::swapToBuffer ( const void * source, int siz )

inline

Swap buffers: int, long, short, float and double.

Swap bytes from a source buffer to the stream buffer with arbitray size.

Definition at line 562 of file StreamBuffer.h.

                                                                    {
  char buff[8], *tar, *src = (char*)source;
  extend( m_pointer + siz );
  tar = m_buffer + m_pointer;
  switch ( swapBuffer( siz ) ) {
  case SINGLE_BYTE:
    *tar = *src;
    break;
  case SWAP:
#ifdef __APPLE__
    for ( int i = 0, j = siz - 1; i < siz; i++, j-- ) tar[j] = src[i];
#else
    ::swab( src, buff, siz );
#endif
    src = buff;
    [[fallthrough]];
  case NOSWAP:
    std::copy_n( src, siz, tar );
    break;
  default:
    break;
  }
  m_pointer += siz;
}

writeBytes()

StreamBuffer & StreamBuffer::writeBytes ( const char * str, long len )

inline

Write string to output stream.

Definition at line 279 of file StreamBuffer.h.

                                                        {
    extend( m_pointer + len + 4 );
    *this << len;
    std::copy_n( str, len, data() + buffPointer() );
    m_pointer += len;
    return *this;
  }

Friends And Related Symbol Documentation

DataObject

friend class DataObject

friend

DataObject is friend.

Definition at line 146 of file StreamBuffer.h.

Member Data Documentation

m_analyzer

AnalyzeFunction StreamBuffer::m_analyzer = nullptr

protected

Hook function for analysis of data to the stream.

Definition at line 171 of file StreamBuffer.h.

m_buffer

char* StreamBuffer::m_buffer = nullptr

mutableprotected

Pointer to heap buffer.

Definition at line 159 of file StreamBuffer.h.

m_containedLinks

ContainedLinks StreamBuffer::m_containedLinks

mutableprotected

Container with links to contained objects.

Definition at line 165 of file StreamBuffer.h.

m_identifiedLinks

IdentifiedLinks StreamBuffer::m_identifiedLinks

mutableprotected

Container with links to contained objects.

Definition at line 168 of file StreamBuffer.h.

m_length

long StreamBuffer::m_length = 0

mutableprotected

Total buffer length.

Definition at line 156 of file StreamBuffer.h.

m_mode

Mode StreamBuffer::m_mode = UNINITIALIZED

protected

Boolean indicating wether the stream is in read or write mode.

Definition at line 150 of file StreamBuffer.h.

m_pointer

long StreamBuffer::m_pointer = 0

mutableprotected

Current buffer pointer.

Definition at line 153 of file StreamBuffer.h.

m_swapEnabled

bool StreamBuffer::m_swapEnabled = true

protected

Flag indicating swapping.

Definition at line 162 of file StreamBuffer.h.

---

The documentation for this class was generated from the following file:

• GaudiKernel/include/GaudiKernel/StreamBuffer.h