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. More...
typedef void(*	AnalyzeFunction) (const void *data, int siz, const std::type_info &type)
	Definition of the buffer analyzer. More...

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

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

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

Friends
class	DataObject
	DataObject is friend. More...

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 51 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 145 of file StreamBuffer.h.

ContainedLinks

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

Definition at line 141 of file StreamBuffer.h.

IdentifiedLinks

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

Definition of the identifiable link set.

Definition at line 143 of file StreamBuffer.h.

Member Enumeration Documentation

Mode

enum StreamBuffer::Mode

Streamer mode.

Enumerator
UNINITIALIZED
READING
WRITING

Definition at line 117 of file StreamBuffer.h.

{ UNINITIALIZED, READING, WRITING };

State

enum StreamBuffer::State

Link state defintions.

Enumerator
INVALID
VALID

Definition at line 121 of file StreamBuffer.h.

{ INVALID = -1, VALID };

SwapAction

enum StreamBuffer::SwapAction

Data Sawp actions.

Enumerator
SINGLE_BYTE
SWAP
NOSWAP

Definition at line 119 of file StreamBuffer.h.

{ SINGLE_BYTE, SWAP, NOSWAP };

Constructor & Destructor Documentation

StreamBuffer()

StreamBuffer::StreamBuffer ( bool  do_swap = true )

inline

Standard constructor.

Definition at line 202 of file StreamBuffer.h.

: m_swapEnabled( do_swap ) {}

~StreamBuffer()

virtual StreamBuffer::~StreamBuffer ( )

inlinevirtual

Standard destructor.

Definition at line 204 of file StreamBuffer.h.

{ ::free( m_buffer ); }

Member Function Documentation

addContainedLink()

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

inline

Definition at line 301 of file StreamBuffer.h.

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

addIdentifiedLink()

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

inline

Definition at line 290 of file StreamBuffer.h.

                                                                 {
    m_identifiedLinks.push_back( IdentifiedLink( (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 212 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 264 of file StreamBuffer.h.

{ return m_pointer; }

containedLinks() [1/2]

ContainedLinks& StreamBuffer::containedLinks ( )

inline

Access to contained links.

Definition at line 241 of file StreamBuffer.h.

{ return m_containedLinks; }

containedLinks() [2/2]

const ContainedLinks& StreamBuffer::containedLinks ( ) const

inline

CONST Access to contained links.

Definition at line 243 of file StreamBuffer.h.

{ return m_containedLinks; }

data() [1/2]

const char* StreamBuffer::data ( ) const

inline

Read access to data buffer.

Definition at line 206 of file StreamBuffer.h.

{ return m_buffer; }

data() [2/2]

char* StreamBuffer::data ( )

inline

write access to data buffer

Definition at line 208 of file StreamBuffer.h.

{ return m_buffer; }

erase()

void StreamBuffer::erase ( )

inline

Reset the buffer.

Definition at line 210 of file StreamBuffer.h.

{ m_pointer = 0; }

extend()

void StreamBuffer::extend ( long  len )

inline

Extend the buffer.

Definition at line 229 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 294 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 284 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 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 181 of file StreamBuffer.h.

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

getObjectPointer() [2/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 192 of file StreamBuffer.h.

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

identifiedLinks() [1/2]

IdentifiedLinks& StreamBuffer::identifiedLinks ( )

inline

Access to identified links.

Definition at line 246 of file StreamBuffer.h.

{ return m_identifiedLinks; }

identifiedLinks() [2/2]

const IdentifiedLinks& StreamBuffer::identifiedLinks ( ) const

inline

CONST Access to identified links.

Definition at line 248 of file StreamBuffer.h.

{ return m_identifiedLinks; }

isReading()

bool StreamBuffer::isReading ( ) const

inline

Get stream buffer state.

Definition at line 259 of file StreamBuffer.h.

{ return m_mode == READING; }

isWriting()

bool StreamBuffer::isWriting ( ) const

inline

Get stream buffer state.

Definition at line 262 of file StreamBuffer.h.

{ return m_mode == WRITING; }

operator<<() [1/15]

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

inline

Output Streamer.

Definition at line 330 of file StreamBuffer.h.

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

operator<<() [2/15]

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

inline

Output Streamer.

Definition at line 341 of file StreamBuffer.h.

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

operator<<() [3/15]

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

inline

Output Streamer.

Definition at line 352 of file StreamBuffer.h.

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

operator<<() [4/15]

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

inline

Output Streamer.

Definition at line 363 of file StreamBuffer.h.

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

operator<<() [5/15]

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

inline

Output Streamer.

Definition at line 374 of file StreamBuffer.h.

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

operator<<() [6/15]

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

inline

Output Streamer.

Definition at line 385 of file StreamBuffer.h.

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

operator<<() [7/15]

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

inline

Output Streamer.

Definition at line 396 of file StreamBuffer.h.

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

operator<<() [8/15]

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

inline

Output Streamer.

Definition at line 407 of file StreamBuffer.h.

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

operator<<() [9/15]

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

inline

Output Streamer.

Definition at line 418 of file StreamBuffer.h.

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

operator<<() [10/15]

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

inline

Output Streamer.

Definition at line 429 of file StreamBuffer.h.

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

operator<<() [11/15]

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

inline

Output Streamer.

Definition at line 440 of file StreamBuffer.h.

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

operator<<() [12/15]

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

inline

Streamer to write strings in (char*) format.

Definition at line 458 of file StreamBuffer.h.

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

operator<<() [13/15]

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

inline

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

Definition at line 476 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<<() [14/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 503 of file StreamBuffer.h.

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

operator<<() [15/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 515 of file StreamBuffer.h.

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

operator>>() [1/14]

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

inline

Input Streamer.

Definition at line 336 of file StreamBuffer.h.

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

operator>>() [2/14]

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

inline

Input Streamer.

Definition at line 347 of file StreamBuffer.h.

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

operator>>() [3/14]

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

inline

Input Streamer.

Definition at line 358 of file StreamBuffer.h.

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

operator>>() [4/14]

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

inline

Input Streamer.

Definition at line 369 of file StreamBuffer.h.

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

operator>>() [5/14]

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

inline

Input Streamer.

Definition at line 380 of file StreamBuffer.h.

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

operator>>() [6/14]

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

inline

Input Streamer.

Definition at line 391 of file StreamBuffer.h.

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

operator>>() [7/14]

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

inline

Input Streamer.

Definition at line 402 of file StreamBuffer.h.

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

operator>>() [8/14]

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

inline

Input Streamer.

Definition at line 413 of file StreamBuffer.h.

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

operator>>() [9/14]

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

inline

Input Streamer.

Definition at line 424 of file StreamBuffer.h.

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

operator>>() [10/14]

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

inline

Input Streamer.

Definition at line 435 of file StreamBuffer.h.

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

operator>>() [11/14]

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

inline

Input Streamer.

Definition at line 446 of file StreamBuffer.h.

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

operator>>() [12/14]

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

inline

Streamer to read strings in (char*) format.

Definition at line 451 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>>() [13/14]

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

inline

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

Definition at line 469 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>>() [14/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 493 of file StreamBuffer.h.

                                                {
    return getObjectPointer( refpObject, refpObject );
  }

reserve()

void StreamBuffer::reserve ( long  len )

inline

Reserve buffer space; Default: 16 k buffer size.

Definition at line 222 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 527 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 268 of file StreamBuffer.h.

{ m_analyzer = fun; }

setBuffPointer()

void StreamBuffer::setBuffPointer ( long  ptr )

inline

Retrieve current buffer pointer.

Definition at line 266 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 251 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 239 of file StreamBuffer.h.

{ return m_length; }

swapBuffer()

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

inlineprotected

Check for byte swapping.

Definition at line 536 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;
#elif defined( BORLAND ) || defined( _WIN32 ) || defined( WIN32 )
    //    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 590 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 564 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 276 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 Function Documentation

DataObject

friend class DataObject

friend

DataObject is friend.

Definition at line 147 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 172 of file StreamBuffer.h.

m_buffer

char* StreamBuffer::m_buffer = nullptr

mutableprotected

Pointer to heap buffer.

Definition at line 160 of file StreamBuffer.h.

m_containedLinks

ContainedLinks StreamBuffer::m_containedLinks

mutableprotected

Container with links to contained objects.

Definition at line 166 of file StreamBuffer.h.

m_identifiedLinks

IdentifiedLinks StreamBuffer::m_identifiedLinks

mutableprotected

Container with links to contained objects.

Definition at line 169 of file StreamBuffer.h.

m_length

long StreamBuffer::m_length = 0

mutableprotected

Total buffer length.

Definition at line 157 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 151 of file StreamBuffer.h.

m_pointer

long StreamBuffer::m_pointer = 0

mutableprotected

Current buffer pointer.

Definition at line 154 of file StreamBuffer.h.

m_swapEnabled

bool StreamBuffer::m_swapEnabled = true

protected

Flag indicating swapping.

Definition at line 163 of file StreamBuffer.h.

---

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

• GaudiKernel/GaudiKernel/StreamBuffer.h