chrono::ChStreamInBinary Class Reference

Description

Base class for all BINARY INPUT streams.

Implemented in a way such that the stream is platform independent (see the 'little endian' stuff in 'floating point to persistent data' topics). Defines some << operators from basic types, converting all them into calls to the Output() function. At least some inherited class should be used by the user in order to get some practical effect (file saving, etc.)

#include <ChStream.h>

Inheritance diagram for chrono::ChStreamInBinary:
Collaboration diagram for chrono::ChStreamInBinary:

Public Member Functions

template<class T >
ChStreamInBinaryoperator>> (T &obj)
 Generic >> operator for all classes which implement serialization by means of a method named 'void StreamIn(ChStreamInBinary&)'.
 
ChStreamInBinaryoperator>> (char &Val)
 Specialized operators for basic primitives (numbers like long, double, int, and booleans). More...
 
ChStreamInBinaryoperator>> (bool &Val)
 
ChStreamInBinaryoperator>> (int &Val)
 
ChStreamInBinaryoperator>> (unsigned int &Val)
 
ChStreamInBinaryoperator>> (double &Val)
 
ChStreamInBinaryoperator>> (float &Val)
 
ChStreamInBinaryoperator>> (long &Val)
 
ChStreamInBinaryoperator>> (unsigned long &Val)
 
ChStreamInBinaryoperator>> (unsigned long long &Val)
 
ChStreamInBinaryoperator>> (std::string &str)
 
ChStreamInBinaryoperator>> (char *str)
 Specialized operator for C strings.
 
template<class T >
void GenericBinaryInput (T &ogg)
 Generic operator for raw binary streaming of generic objects. More...
 
template<class t >
t * AbstractReadCreate (t **mObj)
 Extract an object from the archive, and assignes the pointer to it. More...
 
template<class t >
t * AbstractReadAllCreate (t **mObj)
 Extract an object from the archive, and assigns the pointer to it. More...
 
int VersionRead ()
 Some objects may write class version at the beginning of the streamed data, they can use this function to read class from stream.
 
- Public Member Functions inherited from chrono::ChStreamIn
virtual bool End_of_stream () const
 Returns true if end of stream reached. More...
 
- Public Member Functions inherited from chrono::ChBinaryArchive
bool IsBigEndianMachine ()
 Returns true if the machine where the code runs has big endian byte ordering, returns false otherwise.
 
void Init ()
 Reinitialize the vector of pointers to loaded/saved objects.
 
int PutPointer (void *object)
 Put a pointer in pointer vector, but only if it was not previously inserted. More...
 

Additional Inherited Members

- Public Types inherited from chrono::ChStream
enum  eChMode { CHFILE_NORMAL = 0, CHFILE_NOWRITE, CHFILE_SAFEWRITE, CHFILE_OPENLATER }
 [Obsolete] Modes for chrono files (the ch-modes). More...
 
enum  eChStreamError { CHSTREAM_OK = 0, CHSTREAM_EOF, CHSTREAM_FAIL }
 Errors for chrono files (the ch-modes). More...
 
- Protected Member Functions inherited from chrono::ChStreamIn
virtual void Input (char *data, size_t n)=0
 Inputs a raw chunk of data, from pointer 'data' up to 'n' chars (bytes). More...
 
- Protected Attributes inherited from chrono::ChBinaryArchive
bool big_endian_machine
 
std::vector< void * > objects_pointers
 Vector of pointers to stored/retrieved objects.
 

Member Function Documentation

◆ AbstractReadAllCreate()

template<class t >
t* chrono::ChStreamInBinary::AbstractReadAllCreate ( t **  mObj)
inline

Extract an object from the archive, and assigns the pointer to it.

This function can be used to load objects whose class is not known in advance (anyway, assuming the class had been registered with Chrono class factory registration). It creates the object of the proper downcasted class, and deserializes it. Note: the object must be saved with ChStreamOutBinary::AbstractWrite() Also, the AbstractWrite()-AbstractReadCreate() mechanism avoids storing/creating multiple times the shared objects. Supports only objects with Chrono RTTI and serializer member StreamIn().

◆ AbstractReadCreate()

template<class t >
t* chrono::ChStreamInBinary::AbstractReadCreate ( t **  mObj)
inline

Extract an object from the archive, and assignes the pointer to it.

This function can be used to load objects whose class is not known in advance (anyway, assuming the class had been registered with Chrono class factory registration). It creates the object of the proper downcasted class, and deserializes it. Note: the object must be saved with ChStreamOutBinary::AbstractWrite(). Also, the AbstractWrite()-AbstractReadCreate() mechanism avoids storing/creating multiple times the shared objects. Supports only objects with Chrono RTTI and serializer member StreamIn().

◆ GenericBinaryInput()

template<class T >
void chrono::ChStreamInBinary::GenericBinaryInput ( T &  ogg)
inline

Generic operator for raw binary streaming of generic objects.

WARNING: raw byte streaming! If class 'T' contains double, int, long, etc, these may give problems when loading on another platform which has big-endian ordering, if generated on a little-endian platform.

◆ operator>>()

ChStreamInBinary & chrono::ChStreamInBinary::operator>> ( char &  Val)

Specialized operators for basic primitives (numbers like long, double, int, and booleans).

Handle byte ordering issues in little.endian/big.endian representations, for cross platform portability.


The documentation for this class was generated from the following files:
  • /builds/uwsbel/chrono/src/chrono/core/ChStream.h
  • /builds/uwsbel/chrono/src/chrono/core/ChStream.cpp