JIO::JBinaryFileReader< T, true > Class Template Reference

Template specialisation of JBinaryFileReader for serialisable data types. More...

#include <JBinaryFileReader.hh>

Inheritance diagram for JIO::JBinaryFileReader< T, true >:

Public Types
typedef JPointer< T >	pointer_type
	Type definition of pointer_type. More...
typedef JObjectIterator< T > ::pointer_type	pointer_type

Public Member Functions
	JBinaryFileReader ()
	Default constructor. More...
virtual bool	hasNext ()=0
	Check availability of next element. More...
virtual const pointer_type &	next ()=0
	Get next element. More...
virtual skip_type	skip (const skip_type ns)
	Skip items. More...
virtual bool	is_open () const =0
	Check is device is open. More...
virtual void	open (const char *file_name)=0
	Open device. More...
virtual void	close ()=0
	Close device. More...
virtual void	open (const char *file_name) override
	Open file. More...
virtual bool	is_open () const
	Check is file is open. More...
virtual void	close ()
	Close file. More...
virtual bool	getStatus () const override
	Status of reader. More...
virtual void	clear () override
	Clear status of reader. More...
virtual int	read (char *buffer, const int length) override
	Read byte array. More...
JReader &	operator>> (JSerialisable &object)
	Read serialisable data object. More...
JReader &	operator>> (bool &value)
JReader &	operator>> (char &value)
JReader &	operator>> (unsigned char &value)
JReader &	operator>> (short &value)
JReader &	operator>> (unsigned short &value)
JReader &	operator>> (int &value)
JReader &	operator>> (unsigned int &value)
JReader &	operator>> (long int &value)
JReader &	operator>> (unsigned long int &value)
JReader &	operator>> (long long int &value)
JReader &	operator>> (unsigned long long int &value)
JReader &	operator>> (float &value)
JReader &	operator>> (double &value)
JReader &	operator>> (long double &value)
JReader &	operator>> (JLANG::JObjectID &value)
JReader &	load (JSerialisable &object)
	Read object. More...
template<class T >
JReader &	load (T &object)
	Read object. More...
	operator bool () const
	Type conversion operator. More...
bool	operator! () const
	Negated status of this object. More...
virtual bool	setObject (T &object) override
	Set object. More...
virtual bool	hasNext () override
	Check availability of next element. More...
virtual const pointer_type &	next () override
	Get next element. More...

Static Public Member Functions
static void	Throw (const bool option)
	Enable/disable throw option. More...
static int	Throw (const JException &error, const int value=-1)
	Throw exception or return error. More...

Protected Attributes
std::istream &	in
T	object
	object More...
bool	has_next
	status More...

Static Protected Attributes
static bool	do_throw
	throw option More...

Detailed Description

template<class T>
class JIO::JBinaryFileReader< T, true >

Template specialisation of JBinaryFileReader for serialisable data types.

This class provides for an implementation of the JLANG::JAccessibleObjectIterator interface.

Definition at line 41 of file JBinaryFileReader.hh.

Member Typedef Documentation

template<class T>

typedef JPointer<T> JLANG::JObjectIterator< T >::pointer_type

inherited

Type definition of pointer_type.

Definition at line 58 of file JObjectIterator.hh.

template<class T>

typedef JObjectIterator<T>::pointer_type JLANG::JAbstractObjectIterator< T >::pointer_type

inherited

Definition at line 39 of file JAbstractObjectIterator.hh.

Constructor & Destructor Documentation

template<class T >

JIO::JBinaryFileReader< T, true >::JBinaryFileReader ( )

inline

Default constructor.

Definition at line 51 of file JBinaryFileReader.hh.

                        :
      JAccessibleBinaryInputStream(),
      JStreamReader           (static_cast<std::istream&> (*this)),
      JReaderObjectIterator<T>(static_cast<JStreamReader&>(*this))
    {}

Member Function Documentation

template<class T>

virtual bool JLANG::JObjectIterator< T >::hasNext ( )

pure virtualinherited

Check availability of next element.

Returns

true if the iteration has more elements; else false

Implemented in JSUPPORT::JMultipleFileScanner< T >, JSUPPORT::JMultipleFileScanner<>, JSUPPORT::JMultipleFileScanner< JTail_t >, JSUPPORT::JMultipleFileScanner< JHead_t >, JSUPPORT::JMultipleFileScanner< KM3NETDAQ::KM3NETDAQ::JDAQEvent >, JSUPPORT::JMultipleFileScanner< JDAQSummaryslice >, JLANG::JNullIterator< T >, JSUPPORT::JSingleFileScanner< T >, JSUPPORT::JSingleFileScanner<>, JSUPPORT::JSingleFileScanner< JTail_t >, JSUPPORT::JSingleFileScanner< JHead_t >, JLANG::JObjectMultiplexer< JTypeList< JHead_t, JTail_t >, JBase_t >, JROOT::JRootFileReader< T, false >, JROOT::JMarkerAttributes, JROOT::JLineAttributes, JLANG::JObjectSampler< T, JSampler_t >, JLANG::JObjectSampler< JDAQSummaryslice, JRandomSampler >, JLANG::JPipe< T >, JLANG::JSTDObjectIterator< T >, JLANG::JPipe< JTail_t >, JLANG::JPipe< JHead_t >, JROOT::JTreeReaderObjectIterator< T >, JLANG::JObjectMultiplexer< JDerived_t, JBase_t >, JLANG::JObjectMultiplexer< JHead_t, JBase_t >, JLANG::JObjectMultiplexer< JTail_t, JBase_t >, JLANG::JAbstractObjectIterator< T >, JLANG::JAbstractObjectIterator< Head >, JLANG::JAbstractObjectIterator< JTail_t >, JLANG::JAbstractObjectIterator< JHead_t >, JLANG::JAbstractObjectIterator< JTriggerParameters >, JLANG::JAbstractObjectReader< T >, JLANG::JConversionIterator< JInput_t, JOutput_t >, JLANG::JAbstractObjectReader< JNullType >, JLANG::JAbstractObjectReader< const T >, JLANG::JAbstractObjectReader< JTail_t >, JLANG::JAbstractObjectReader< JHead_t >, JLANG::JAbstractObjectReader< KM3NETDAQ::KM3NETDAQ::JDAQEvent >, and JLANG::JAbstractObjectReader< JDAQSummaryslice >.

template<class T>

virtual const pointer_type& JLANG::JObjectIterator< T >::next ( )

pure virtualinherited

Get next element.

Returns

pointer to element

Implemented in JSUPPORT::JMultipleFileScanner< T >, JSUPPORT::JMultipleFileScanner<>, JSUPPORT::JMultipleFileScanner< JTail_t >, JSUPPORT::JMultipleFileScanner< JHead_t >, JSUPPORT::JMultipleFileScanner< KM3NETDAQ::KM3NETDAQ::JDAQEvent >, JSUPPORT::JMultipleFileScanner< JDAQSummaryslice >, JLANG::JNullIterator< T >, JSUPPORT::JSingleFileScanner< T >, JSUPPORT::JSingleFileScanner<>, JSUPPORT::JSingleFileScanner< JTail_t >, JSUPPORT::JSingleFileScanner< JHead_t >, JLANG::JObjectMultiplexer< JTypeList< JHead_t, JTail_t >, JBase_t >, JROOT::JRootFileReader< T, false >, JLANG::JObjectSampler< T, JSampler_t >, JLANG::JObjectSampler< JDAQSummaryslice, JRandomSampler >, JROOT::JMarkerAttributes, JLANG::JPipe< T >, JLANG::JPipe< JTail_t >, JLANG::JPipe< JHead_t >, JROOT::JLineAttributes, JROOT::JTreeReaderObjectIterator< T >, JLANG::JSTDObjectIterator< T >, JLANG::JObjectMultiplexer< JDerived_t, JBase_t >, JLANG::JObjectMultiplexer< JHead_t, JBase_t >, JLANG::JObjectMultiplexer< JTail_t, JBase_t >, JLANG::JAbstractObjectIterator< T >, JLANG::JAbstractObjectIterator< Head >, JLANG::JAbstractObjectIterator< JTail_t >, JLANG::JAbstractObjectIterator< JHead_t >, JLANG::JAbstractObjectIterator< JTriggerParameters >, JLANG::JAbstractObjectReader< T >, JLANG::JConversionIterator< JInput_t, JOutput_t >, JLANG::JAbstractObjectReader< JNullType >, JLANG::JAbstractObjectReader< const T >, JLANG::JAbstractObjectReader< JTail_t >, JLANG::JAbstractObjectReader< JHead_t >, JLANG::JAbstractObjectReader< KM3NETDAQ::KM3NETDAQ::JDAQEvent >, and JLANG::JAbstractObjectReader< JDAQSummaryslice >.

template<class T>

virtual skip_type JLANG::JObjectIterator< T >::skip ( const skip_type  ns )

inlinevirtualinherited

Skip items.

Parameters

ns	number of items to skip

Returns

number of items skipped

Reimplemented in JLANG::JPipe< T >, JLANG::JPipe< JTail_t >, JLANG::JPipe< JHead_t >, JLANG::JSTDObjectIterator< T >, JLANG::JAbstractObjectReader< T >, JLANG::JAbstractObjectReader< JNullType >, JLANG::JAbstractObjectReader< const T >, JLANG::JAbstractObjectReader< JTail_t >, JLANG::JAbstractObjectReader< JHead_t >, JLANG::JAbstractObjectReader< KM3NETDAQ::KM3NETDAQ::JDAQEvent >, and JLANG::JAbstractObjectReader< JDAQSummaryslice >.

Definition at line 90 of file JObjectIterator.hh.

    {
      skip_type i = 0;

      for ( ; i != ns && hasNext(); ++i) {
        next();
      }

      return i;
    }

virtual bool JLANG::JAccessible::is_open ( ) const

pure virtualinherited

Check is device is open.

Returns

true if open; else false

Implemented in JROOT::JTreeReaderAccessibleObjectIterator< T >, JLANG::JAbstractAccessibleObjectReader< T >, JLANG::JAbstractAccessibleObjectReader< JNullType >, JLANG::JAbstractAccessibleObjectReader< JTail_t >, JLANG::JAbstractAccessibleObjectReader< JHead_t >, JLANG::JAbstractAccessibleObjectReader< KM3NETDAQ::KM3NETDAQ::JDAQEvent >, JLANG::JAbstractAccessibleObjectReader< JDAQSummaryslice >, JLANG::JAccessibleOutputStream, JLANG::JAbstractAccessibleObjectWriter< T >, JROOT::JRootFile, JLANG::JNullAccess, JLANG::JGZFileWriter< T >, JLANG::JGZFileReader< T >, and JLANG::JAccessibleInputStream.

virtual void JLANG::JAccessible::open ( const char *  file_name )

pure virtualinherited

Open device.

Parameters

file_name

file name

Implemented in JROOT::JRootOutputFile, JROOT::JRootFileReader< T, true >, JROOT::JRootFileWriter< T >, JROOT::JTreeReaderAccessibleObjectIterator< T >, JLANG::JAbstractAccessibleObjectReader< T >, JLANG::JAbstractAccessibleObjectReader< JNullType >, JLANG::JAbstractAccessibleObjectReader< JTail_t >, JLANG::JAbstractAccessibleObjectReader< JHead_t >, JLANG::JAbstractAccessibleObjectReader< KM3NETDAQ::KM3NETDAQ::JDAQEvent >, JLANG::JAbstractAccessibleObjectReader< JDAQSummaryslice >, JROOT::JRootInputFile, JLANG::JAccessibleOutputStream, JROOT::JRootFileReader< T, false >, JLANG::JAbstractAccessibleObjectWriter< T >, JSUPPORT::JAutoTreeWriter< JKey_t >, JSUPPORT::JAutoTreeWriter< JNET::JTag >, JSUPPORT::JFileRecorder< T >, JLANG::JAccessibleBinaryOutputStream, JLANG::JNullAccess, JLANG::JGZFileWriter< T >, JSUPPORT::JFileScanner< T >, JSUPPORT::JFileScanner< JNullType >, JSUPPORT::JFileScanner< JTail_t >, JSUPPORT::JFileScanner< JHead_t >, JSUPPORT::JFileScanner< KM3NETDAQ::KM3NETDAQ::JDAQEvent >, JSUPPORT::JFileScanner< JDAQSummaryslice >, JLANG::JGZFileReader< T >, JLANG::JAccessibleInputStream, JSUPPORT::JTreeRecorder< T >, JSUPPORT::JTreeRecorder< JDAQTimesliceTypes_t >, and JLANG::JAccessibleBinaryInputStream.

virtual void JLANG::JAccessible::close ( )

pure virtualinherited

Close device.

Implemented in JROOT::JRootOutputFile, JROOT::JTreeReaderAccessibleObjectIterator< T >, JLANG::JAbstractAccessibleObjectReader< T >, JLANG::JAbstractAccessibleObjectReader< JNullType >, JLANG::JAbstractAccessibleObjectReader< JTail_t >, JLANG::JAbstractAccessibleObjectReader< JHead_t >, JLANG::JAbstractAccessibleObjectReader< KM3NETDAQ::KM3NETDAQ::JDAQEvent >, JLANG::JAbstractAccessibleObjectReader< JDAQSummaryslice >, JROOT::JRootInputFile, JLANG::JAccessibleOutputStream, JLANG::JAbstractAccessibleObjectWriter< T >, JSUPPORT::JAutoTreeWriter< JKey_t >, JSUPPORT::JAutoTreeWriter< JNET::JTag >, JLANG::JGZFileWriter< T >, JLANG::JNullAccess, JLANG::JGZFileReader< T >, JLANG::JAccessibleInputStream, JSUPPORT::JTreeRecorder< T >, and JSUPPORT::JTreeRecorder< JDAQTimesliceTypes_t >.

static void JLANG::JThrow< JAccessible >::Throw ( const bool  option )

inlinestaticinherited

Enable/disable throw option.

Parameters

option

true enable; false disable

Definition at line 37 of file JThrow.hh.

    {
      do_throw = option;
    }

static int JLANG::JThrow< JAccessible >::Throw ( const JException &  error, const int  value = -1  )

inlinestaticinherited

Throw exception or return error.

Parameters

error	exception
value	return code

Returns

return code

Definition at line 50 of file JThrow.hh.

    {
      using namespace std;
      
      if (do_throw) {
        throw error;
      }

      cerr << error.what() << endl;
      
      return value;
    }

virtual void JLANG::JAccessibleBinaryInputStream::open ( const char *  file_name )

inlineoverridevirtualinherited

Open file.

Parameters

file_name

file name

Reimplemented from JLANG::JAccessibleInputStream.

Definition at line 52 of file JAccessibleBinaryStream.hh.

    {
      std::ifstream::open(file_name, std::ios::binary);
    }

virtual bool JLANG::JAccessibleInputStream::is_open ( ) const

inlinevirtualinherited

Check is file is open.

Returns

true if open; else false

Implements JLANG::JAccessible.

Definition at line 53 of file JAccessibleStream.hh.

    {
      return std::ifstream::is_open();
    }

virtual void JLANG::JAccessibleInputStream::close ( )

inlinevirtualinherited

Close file.

Implements JLANG::JAccessible.

Definition at line 77 of file JAccessibleStream.hh.

    {
      std::ifstream::close();
    }

virtual bool JIO::JStreamReader::getStatus ( ) const

inlineoverridevirtualinherited

Status of reader.

Returns

status of this reader

Implements JLANG::JAbstractObjectStatus.

Definition at line 43 of file JStreamIO.hh.

    { 
      return (bool) in; 
    }

virtual void JIO::JStreamReader::clear ( )

inlineoverridevirtualinherited

Clear status of reader.

Reimplemented from JIO::JReader.

Definition at line 52 of file JStreamIO.hh.

    {
      in.clear();
    }

virtual int JIO::JStreamReader::read ( char *  buffer, const int  length  )

inlineoverridevirtualinherited

Read byte array.

Parameters

buffer	pointer to byte array
length	number of bytes

Returns

number of bytes read

Implements JLANG::JBinaryInput.

Definition at line 65 of file JStreamIO.hh.

    { 
      in.read(buffer, length); 

      return in.gcount();
    }

JReader& JIO::JReader::operator>> ( JSerialisable &  object )

inlineinherited

Read serialisable data object.

Parameters

object

serialisable data object

Returns

JReader

Definition at line 81 of file JSerialisable.hh.

    { 
      return object.read(*this); 
    }

JReader& JIO::JReader::operator>> ( bool &  value )

inlineinherited

Definition at line 87 of file JSerialisable.hh.

{ read((char*) &value, sizeof(bool));                   return *this; }

JReader& JIO::JReader::operator>> ( char &  value )

inlineinherited

Definition at line 88 of file JSerialisable.hh.

{ read((char*) &value, sizeof(char));                   return *this; }

JReader& JIO::JReader::operator>> ( unsigned char &  value )

inlineinherited

Definition at line 89 of file JSerialisable.hh.

{ read((char*) &value, sizeof(unsigned char));          return *this; }

JReader& JIO::JReader::operator>> ( short &  value )

inlineinherited

Definition at line 90 of file JSerialisable.hh.

{ read((char*) &value, sizeof(short));                  return *this; }

JReader& JIO::JReader::operator>> ( unsigned short &  value )

inlineinherited

Definition at line 91 of file JSerialisable.hh.

{ read((char*) &value, sizeof(unsigned short));         return *this; }

JReader& JIO::JReader::operator>> ( int &  value )

inlineinherited

Definition at line 92 of file JSerialisable.hh.

{ read((char*) &value, sizeof(int));                    return *this; }

JReader& JIO::JReader::operator>> ( unsigned int &  value )

inlineinherited

Definition at line 93 of file JSerialisable.hh.

{ read((char*) &value, sizeof(unsigned int));           return *this; }

JReader& JIO::JReader::operator>> ( long int &  value )

inlineinherited

Definition at line 94 of file JSerialisable.hh.

{ read((char*) &value, sizeof(long int));               return *this; }

JReader& JIO::JReader::operator>> ( unsigned long int &  value )

inlineinherited

Definition at line 95 of file JSerialisable.hh.

{ read((char*) &value, sizeof(unsigned long int));      return *this; }

JReader& JIO::JReader::operator>> ( long long int &  value )

inlineinherited

Definition at line 96 of file JSerialisable.hh.

{ read((char*) &value, sizeof(long long int));          return *this; }

JReader& JIO::JReader::operator>> ( unsigned long long int &  value )

inlineinherited

Definition at line 97 of file JSerialisable.hh.

{ read((char*) &value, sizeof(unsigned long long int)); return *this; }

JReader& JIO::JReader::operator>> ( float &  value )

inlineinherited

Definition at line 98 of file JSerialisable.hh.

{ read((char*) &value, sizeof(float));                  return *this; }

JReader& JIO::JReader::operator>> ( double &  value )

inlineinherited

Definition at line 99 of file JSerialisable.hh.

{ read((char*) &value, sizeof(double));                 return *this; }

JReader& JIO::JReader::operator>> ( long double &  value )

inlineinherited

Definition at line 100 of file JSerialisable.hh.

{ read((char*) &value, sizeof(long double));            return *this; }

JReader& JIO::JReader::operator>> ( JLANG::JObjectID &  value )

inlineinherited

Definition at line 101 of file JSerialisable.hh.

{ return (*this) >> value.getID(); }

JReader& JIO::JReader::load ( JSerialisable &  object )

inlineinherited

Read object.

Parameters

object

object

Returns

this reader

Definition at line 110 of file JSerialisable.hh.

    {
      return object.read(*this);
    }

template<class T >

JReader& JIO::JReader::load ( T &  object )

inlineinherited

Read object.

Parameters

object

object

Returns

this reader

Definition at line 123 of file JSerialisable.hh.

    {
      return *this >> object;
    }

JLANG::JAbstractObjectStatus::operator bool ( ) const

inlineinherited

Type conversion operator.

Returns

status of this object

Definition at line 33 of file JAbstractObjectStatus.hh.

    {
      return this->getStatus();
    }

bool JLANG::JAbstractObjectStatus::operator! ( ) const

inlineinherited

Negated status of this object.

Returns

negated status of this object

Definition at line 44 of file JAbstractObjectStatus.hh.

    {
      return !(this->getStatus());
    }

template<class T >

virtual bool JIO::JReaderObjectIterator< T >::setObject ( T &  object )

inlineoverridevirtualinherited

Set object.

Parameters

object

reference to object to be set

Returns

true if set; else false

Implements JLANG::JAbstractObjectIterator< T >.

Reimplemented in JSUPPORT::JDAQFileReader< T, true >.

Definition at line 48 of file JReaderObjectIterator.hh.

    {
      return setObject(object, JLANG::JBool<JLANG::JConversion<T,JSerialisable>::is_derived>());
    }

template<class T>

virtual bool JLANG::JAbstractObjectIterator< T >::hasNext ( )

inlineoverridevirtualinherited

Check availability of next element.

Returns

true if the iteration has more elements; else false

Implements JLANG::JObjectIterator< T >.

Definition at line 56 of file JAbstractObjectIterator.hh.

    {
      if (!has_next) {
        has_next = this->setObject(object);
      }

      return has_next;
    }

template<class T>

virtual const pointer_type& JLANG::JAbstractObjectIterator< T >::next ( )

inlineoverridevirtualinherited

Get next element.

Returns

pointer to element

Implements JLANG::JObjectIterator< T >.

Definition at line 71 of file JAbstractObjectIterator.hh.

    {
      if (has_next)
        ps.reset(&this->object);
      else
        ps.reset(NULL);

      has_next = false;
      
      return ps;
    }

Member Data Documentation

bool JLANG::JThrow< JAccessible >::do_throw

staticprotectedinherited

throw option

Set default throw option to true.

Definition at line 28 of file JThrow.hh.

std::istream& JIO::JStreamReader::in

protectedinherited

Definition at line 73 of file JStreamIO.hh.

template<class T>

T JLANG::JAbstractObjectIterator< T >::object

protectedinherited

object

Definition at line 34 of file JAbstractObjectIterator.hh.

template<class T>

bool JLANG::JAbstractObjectIterator< T >::has_next

protectedinherited

status

Definition at line 35 of file JAbstractObjectIterator.hh.

---

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

• JBinaryFileReader.hh