Auxiliary class for object writing with named access. More...

#include <JObjectWriter.hh>

Inheritance diagram for JLANG::JAccessibleObjectWriter< T >:

Public Types
typedef JSharedPointer< JAccessibleObjectOutput< T > >	helper_type

typedef JPointer< JAccessibleObjectOutput< T > >	pointer_type

typedef JStorage< JAccessibleObjectOutput< T >, JNew >	storage_type

typedef JNew< JAccessibleObjectOutput< T > >	memory_type

Public Member Functions
	JAccessibleObjectWriter ()
	Default constructor. More...

virtual JAccessibleObjectOutput< T > *	getHelper () const
	Get helper. More...

virtual bool	put (const T &object)=0
	Object output. 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 bool	is_open () const
	Check is device is open. More...

virtual void	open (const char *file_name)
	Open device. More...

virtual void	close ()
	Close device. More...

virtual bool	put (const T &object)
	Object output. More...

const JSharedPointer &	getSharedPointer () const
	Get shared pointer. More...

JSharedPointer &	getSharedPointer ()
	Get shared pointer. More...

void	setSharedPointer (const JSharedPointer &object)
	Set shared pointer. More...

virtual void	reset ()
	Reset pointer. More...

virtual void	reset ()
	Reset pointer. More...

void	reset (const JPointer< T > &pointer)
	Reset pointer. More...

void	reset (const JPointer< T > &pointer)
	Reset pointer. More...

void	reset (JAccessibleObjectOutput< T > *p)
	Reset pointer. More...

void	set (const JPointer< T > &pointer)
	Set pointer. More...

void	initialise ()
	Initialise counter. More...

void	attach (const JSharedCounter &object)
	Attach this counter to given shared counter object. More...

bool	detach ()
	Detach. More...

void	recreate ()
	Recreate object in memory. More...

void	create ()
	Create object in memory. More...

void	create (const unsigned int size)
	Create array of objects in memory. More...

virtual JAccessibleObjectOutput< T > *	get () const
	Get pointer. More...

JAccessibleObjectOutput< T > *const &	getReference () const
	Get rereference to internal pointer. More...

JAccessibleObjectOutput< T > *&	getReference ()
	Get rereference to internal pointer. More...

virtual bool	equals (const JAbstractPointer &object) const
	Equals. More...

bool	is_valid () const
	Check validity of pointer. More...

JAccessibleObjectOutput< T > *	operator-> () const
	Smart pointer operator. More...

	operator JAccessibleObjectOutput< T > * () const
	Type conversion operator. 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...

static void	release (JAccessibleObjectOutput< T > *p)
	Release memory. More...

Protected Member Functions
void	set (const JSharedPointer &object)
	Set pointer. More...

virtual void	set (JAccessibleObjectOutput< T > *p)
	Set pointer. More...

void	release ()
	Release memory. More...

Protected Attributes
int *	counter

JAccessibleObjectOutput< T > *	__p
	pointer to object More...

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

Detailed Description

template<class T>
struct JLANG::JAccessibleObjectWriter< T >

Auxiliary class for object writing with named access.

This class implements the JAbstractAccessibleObjectWriter interface.

Definition at line 58 of file JObjectWriter.hh.

Member Typedef Documentation

◆ helper_type

template<class T >

typedef JSharedPointer< JAccessibleObjectOutput<T> > JLANG::JAccessibleObjectWriter< T >::helper_type

Definition at line 64 of file JObjectWriter.hh.

◆ pointer_type

typedef JPointer<JAccessibleObjectOutput< T > > JLANG::JSharedPointer< JAccessibleObjectOutput< T > , JNew >::pointer_type

inherited

Definition at line 34 of file JSharedPointer.hh.

◆ storage_type

typedef JStorage<JAccessibleObjectOutput< T > , JNew > JLANG::JSharedPointer< JAccessibleObjectOutput< T > , JNew >::storage_type

inherited

Definition at line 35 of file JSharedPointer.hh.

◆ memory_type

typedef JNew <JAccessibleObjectOutput< T > > JLANG::JStorage< JAccessibleObjectOutput< T > , JNew >::memory_type

inherited

Definition at line 33 of file JStorage.hh.

Constructor & Destructor Documentation

◆ JAccessibleObjectWriter()

template<class T >

JLANG::JAccessibleObjectWriter< T >::JAccessibleObjectWriter ( )

inline

Default constructor.

Definition at line 69 of file JObjectWriter.hh.

70 {}

Member Function Documentation

◆ getHelper()

template<class T >

virtual JAccessibleObjectOutput<T>* JLANG::JAccessibleObjectWriter< T >::getHelper ( ) const

inlinevirtual

Get helper.

Returns: helper

Implements JLANG::JAbstractAccessibleObjectWriter< T >.

Definition at line 78 of file JObjectWriter.hh.

     {
       return this->get();
     }

◆ put() [1/2]

template<class T>

virtual bool JLANG::JObjectOutput< T >::put ( const T & object )

pure virtualinherited

Object output.

Parameters

object object

Returns: true if OK; else false

Implemented in JLANG::JNullOutput< T >, JNET::JControlHostObjectOutput< T >, JROOT::JRootObjectOutput< T, false >, JROOT::JTreeWriterObjectOutput< T >, JROOT::JRootStreamObjectOutput< T >, JLANG::JStreamObjectOutput< T >, JIO::JWriterObjectOutput< T >, JLANG::JAbstractObjectWriter< T >, JLANG::JNullOutput< JTail_t >, JNET::JControlHostObjectOutput< JTail_t >, JLANG::JStreamObjectOutput< JTail_t >, JLANG::JAbstractObjectWriter< JTail_t >, JLANG::JNullOutput< JHead_t >, JNET::JControlHostObjectOutput< JHead_t >, JLANG::JStreamObjectOutput< JHead_t >, JLANG::JAbstractObjectWriter< JHead_t >, JLANG::JObjectDemultiplexer< JBase_t, JTypeList< JHead_t, JTail_t > >, JLANG::JObjectDemultiplexer< JBase_t, JDerived_t >, JLANG::JObjectDemultiplexer< JBase_t, JTail_t >, JLANG::JObjectDemultiplexer< JBase_t, JHead_t >, JLANG::JStreamObjectOutput< Head >, and JLANG::JStreamObjectOutput< Evt >.

◆ is_open() [1/2]

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< JTail_t >, JLANG::JAbstractAccessibleObjectReader< JHead_t >, JLANG::JAbstractAccessibleObjectReader< KM3NETDAQ::JDAQEvent >, JLANG::JAbstractAccessibleObjectReader< JDAQSummaryslice >, JLANG::JAbstractAccessibleObjectReader< JTypeList< JDAQEvent, JTypelist_t > >, JLANG::JAccessibleOutputStream, JLANG::JAbstractAccessibleObjectWriter< T >, JROOT::JRootFile, JLANG::JNullAccess, JLANG::JGZFileWriter< T >, JLANG::JGZFileReader< T >, and JLANG::JAccessibleInputStream.

◆ open() [1/2]

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

pure virtualinherited

Open device.

Parameters

file_name file name

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

◆ close() [1/2]

virtual void JLANG::JAccessible::close ( )

pure virtualinherited

Close device.

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

◆ Throw() [1/2]

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;
     }

◆ Throw() [2/2]

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;
     }

◆ is_open() [2/2]

template<class T >

virtual bool JLANG::JAbstractAccessibleObjectWriter< T >::is_open ( ) const

inlinevirtualinherited

Check is device is open.

Returns: true if open; else false

Implements JLANG::JAccessible.

Definition at line 102 of file JAbstractObjectWriter.hh.

     {
       if (this->getHelper() != NULL)
         return this->getHelper()->is_open();
       else
         return false;
     }

◆ open() [2/2]

template<class T >

virtual void JLANG::JAbstractAccessibleObjectWriter< T >::open ( const char * file_name )

inlinevirtualinherited

Open device.

Parameters

file_name file name

Implements JLANG::JAccessible.

Reimplemented in JSUPPORT::JFileRecorder< T >.

Definition at line 116 of file JAbstractObjectWriter.hh.

     {
       if (this->getHelper() != NULL) {
         this->getHelper()->open(file_name);
       }
     }

◆ close() [2/2]

template<class T >

virtual void JLANG::JAbstractAccessibleObjectWriter< T >::close ( )

inlinevirtualinherited

Close device.

Implements JLANG::JAccessible.

Definition at line 127 of file JAbstractObjectWriter.hh.

     {
       if (this->getHelper() != NULL) {
         this->getHelper()->close();
       }
     }

◆ put() [2/2]

template<class T>

virtual bool JLANG::JAbstractObjectWriter< T >::put ( const T & object )

inlinevirtualinherited

Object output.

Parameters

object object

Returns: true if OK; else false

Implements JLANG::JObjectOutput< T >.

Definition at line 43 of file JAbstractObjectWriter.hh.

     {
       return (this->getHelper() != NULL && this->getHelper()->put(object));
     }

◆ getSharedPointer() [1/2]

const JSharedPointer& JLANG::JSharedPointer< JAccessibleObjectOutput< T > , JNew >::getSharedPointer ( ) const

inlineinherited

Get shared pointer.

Returns: this shared pointer

Definition at line 95 of file JSharedPointer.hh.

     {
       return static_cast<const JSharedPointer&>(*this);
     }

◆ getSharedPointer() [2/2]

JSharedPointer& JLANG::JSharedPointer< JAccessibleObjectOutput< T > , JNew >::getSharedPointer ( )

inlineinherited

Get shared pointer.

Returns: this shared pointer

Definition at line 106 of file JSharedPointer.hh.

     {
       return static_cast<JSharedPointer&>(*this);
     }

◆ setSharedPointer()

void JLANG::JSharedPointer< JAccessibleObjectOutput< T > , JNew >::setSharedPointer ( const JSharedPointer< JAccessibleObjectOutput< T > > & object )

inlineinherited

Set shared pointer.

Parameters

object shared pointer

Definition at line 117 of file JSharedPointer.hh.

     {
       if (this->get() != object.get()) {
  
         this->reset();
  
         if (object.is_valid()) {
           this->set(object);
         }
       }
     }

◆ reset() [1/5]

virtual void JLANG::JSharedPointer< JAccessibleObjectOutput< T > , JNew >::reset ( )

inlinevirtualinherited

Reset pointer.

The reference counter is decremented by one and the object pointed to previously is deleted when its reference counter is zero.

Reimplemented from JLANG::JStorage< JAccessibleObjectOutput< T >, JNew >.

Definition at line 171 of file JSharedPointer.hh.

     {
       if (this->detach()) {
         storage_type::reset();
       }
  
       pointer_type::reset();
     }

◆ reset() [2/5]

virtual void JLANG::JPointer< JAccessibleObjectOutput< T > >::reset

inlineinherited

Reset pointer.

Definition at line 84 of file JPointer.hh.

     { 
       this->__p = NULL;
     }

◆ reset() [3/5]

void JLANG::JPointer< JAccessibleObjectOutput< T > >::reset ( class T )

inlineinherited

Reset pointer.

Parameters

pointer pointer to object

Definition at line 108 of file JPointer.hh.

     {
       this->reset(pointer.get());
     }

◆ reset() [4/5]

void JLANG::JPointer< JAccessibleObjectOutput< T > >::reset ( const JPointer< T > & pointer )

inlineinherited

Reset pointer.

Parameters

pointer pointer to object

Definition at line 108 of file JPointer.hh.

     {
       this->reset(pointer.get());
     }

◆ reset() [5/5]

void JLANG::JAbstractPointer< JAccessibleObjectOutput< T > >::reset ( JAccessibleObjectOutput< T > * p )

inlineinherited

Reset pointer.

Parameters

p	pointer to object

Definition at line 94 of file JAbstractPointer.hh.

     {
       if (this->get() != p) {
  
         this->reset();
  
         if (p != NULL) {
           this->set(p);
         }
       }
     }

◆ set() [1/3]

void JLANG::JSharedPointer< JAccessibleObjectOutput< T > , JNew >::set ( const JSharedPointer< JAccessibleObjectOutput< T > > & object )

inlineprotectedinherited

Set pointer.

The reference counter of the shared object pointed to is incremented by one.

Parameters

object shared pointer

Definition at line 188 of file JSharedPointer.hh.

     {
       pointer_type::set(object.get());
  
       this->attach(object);
     }

◆ set() [2/3]

virtual void JLANG::JSharedPointer< JAccessibleObjectOutput< T > , JNew >::set ( JAccessibleObjectOutput< T > * p )

inlineprotectedvirtualinherited

Set pointer.

The reference counter of the shared object pointed to is initialised to one.

Parameters

p	pointer to derived class object

Reimplemented from JLANG::JPointer< JAccessibleObjectOutput< T > >.

Definition at line 202 of file JSharedPointer.hh.

     {
       pointer_type::set(p);
  
       this->initialise();
     }

◆ set() [3/3]

void JLANG::JPointer< JAccessibleObjectOutput< T > >::set ( const JPointer< T > & pointer )

inlineinherited

Set pointer.

Parameters

pointer pointer to object

Definition at line 96 of file JPointer.hh.

     {
       this->set(pointer.get());
     }

◆ initialise()

void JLANG::JSharedCounter::initialise ( )

inlineinherited

Initialise counter.

Definition at line 33 of file JSharedCounter.hh.

     {
       detach();
  
       counter = new int(1);
     }

◆ attach()

void JLANG::JSharedCounter::attach ( const JSharedCounter & object )

inlineinherited

Attach this counter to given shared counter object.

Parameters

object shared counter

Definition at line 46 of file JSharedCounter.hh.

     {
       detach();
  
       counter = object.counter;
  
       if (counter != NULL) {
         ++(*counter);
       }
     }

◆ detach()

bool JLANG::JSharedCounter::detach ( )

inlineinherited

Detach.

Returns: true if counter at zero; else false

Definition at line 63 of file JSharedCounter.hh.

     {
       if (counter != NULL) {
  
         if (--(*counter) == 0) {
  
           delete counter;
  
           counter = NULL;
  
           return true;
         }
  
         counter = NULL;
       }
  
       return false;
     }

◆ recreate()

void JLANG::JStorage< JAccessibleObjectOutput< T > , JNew >::recreate ( )

inlineinherited

Recreate object in memory.

A new object is created if no memory is allocated yet, else the previously created object is maintained.

Definition at line 57 of file JStorage.hh.

     {
       if (!this->is_valid()) {
         this->set(memory_type::create());
       }
     }

◆ create() [1/2]

void JLANG::JStorage< JAccessibleObjectOutput< T > , JNew >::create ( )

inlineinherited

Create object in memory.

The memory allocated by a previously created object will be released.

Definition at line 69 of file JStorage.hh.

     {
       this->reset(memory_type::create());
     }

◆ create() [2/2]

void JLANG::JStorage< JAccessibleObjectOutput< T > , JNew >::create ( const unsigned int size )

inlineinherited

Create array of objects in memory.

The memory allocated by previously created objects will be released.

Parameters

size	number of elements

Definition at line 81 of file JStorage.hh.

     {
       this->reset(memory_type::create(size));
     }

◆ release() [1/2]

void JLANG::JStorage< JAccessibleObjectOutput< T > , JNew >::release ( )

inlineprotectedinherited

Release memory.

Definition at line 91 of file JStorage.hh.

     { 
       memory_type::release(this->get());
     }

◆ release() [2/2]

static void JLANG::JNew< JAccessibleObjectOutput< T > >::release ( JAccessibleObjectOutput< T > * p )

inlinestaticinherited

Release memory.

Parameters

p	pointer to data

Definition at line 41 of file JMemory.hh.

     {
       delete p;
     }

◆ get()

virtual JAccessibleObjectOutput< T > * JLANG::JPointer< JAccessibleObjectOutput< T > >::get ( ) const

inlinevirtualinherited

Get pointer.

Returns: pointer to object

Implements JLANG::JAbstractPointer< JAccessibleObjectOutput< T > >.

Definition at line 64 of file JPointer.hh.

     {
       return this->__p;
     }

◆ getReference() [1/2]

JAccessibleObjectOutput< T > * const& JLANG::JPointer< JAccessibleObjectOutput< T > >::getReference ( ) const

inlineinherited

Get rereference to internal pointer.

Returns: reference to internal pointer

Definition at line 119 of file JPointer.hh.

     {
       return __p;
     }

◆ getReference() [2/2]

JAccessibleObjectOutput< T > * & JLANG::JPointer< JAccessibleObjectOutput< T > >::getReference ( )

inlineinherited

Get rereference to internal pointer.

Returns: reference to internal pointer

Definition at line 130 of file JPointer.hh.

     {
       return __p;
     }

◆ equals()

virtual bool JLANG::JAbstractPointer< JAccessibleObjectOutput< T > >::equals ( const JAbstractPointer< JAccessibleObjectOutput< T > > & object ) const

inlinevirtualinherited

Equals.

The equality is evaluated by comparison of the internal pointers.

Parameters

object abstract pointer

Returns: true if equals; else false

Definition at line 50 of file JAbstractPointer.hh.

     {
       return this->get() == object.get();
     }

◆ is_valid()

bool JLANG::JAbstractPointer< JAccessibleObjectOutput< T > >::is_valid ( ) const

inlineinherited

Check validity of pointer.

Returns: true if pointer not null; else false

Definition at line 83 of file JAbstractPointer.hh.

     { 
       return this->get() != NULL; 
     }

◆ operator->()

JAccessibleObjectOutput< T > * JLANG::JAbstractPointer< JAccessibleObjectOutput< T > >::operator-> ( ) const

inlineinherited

Smart pointer operator.

Returns: pointer to object

Definition at line 112 of file JAbstractPointer.hh.

     { 
       if (!is_valid())
         throw JNullPointerException("JAbstractPointer::operator->()");
       else
         return this->get();
     }

◆ operator JAccessibleObjectOutput< T > *()

JLANG::JAbstractPointer< JAccessibleObjectOutput< T > >::operator JAccessibleObjectOutput< T > * ( ) const

inlineinherited

Type conversion operator.

Returns: pointer to object

Definition at line 126 of file JAbstractPointer.hh.

     {
       return this->get();
     }

Member Data Documentation

◆ do_throw

bool JLANG::JThrow< JAccessible >::do_throw

staticprotectedinherited

throw option

Set default throw option to true.

Definition at line 28 of file JThrow.hh.

◆ counter

int* JLANG::JSharedCounter::counter

protectedinherited

Definition at line 83 of file JSharedCounter.hh.

◆ __p

JAccessibleObjectOutput< T > * JLANG::JPointer< JAccessibleObjectOutput< T > >::__p

protectedinherited

pointer to object

Definition at line 136 of file JPointer.hh.

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

JObjectWriter.hh

Public Types

Public Member Functions

Static Public Member Functions

Protected Member Functions

Protected Attributes

Static Protected Attributes

Detailed Description

template<class T> struct JLANG::JAccessibleObjectWriter< T >

Member Typedef Documentation

◆ helper_type

◆ pointer_type

◆ storage_type

◆ memory_type

Constructor & Destructor Documentation

◆ JAccessibleObjectWriter()

Member Function Documentation

◆ getHelper()

◆ put() [1/2]

◆ is_open() [1/2]

◆ open() [1/2]

◆ close() [1/2]

◆ Throw() [1/2]

◆ Throw() [2/2]

◆ is_open() [2/2]

◆ open() [2/2]

◆ close() [2/2]

◆ put() [2/2]

◆ getSharedPointer() [1/2]

◆ getSharedPointer() [2/2]

◆ setSharedPointer()

◆ reset() [1/5]

◆ reset() [2/5]

◆ reset() [3/5]

◆ reset() [4/5]

◆ reset() [5/5]

◆ set() [1/3]

◆ set() [2/3]

◆ set() [3/3]

◆ initialise()

◆ attach()

◆ detach()

◆ recreate()

◆ create() [1/2]

◆ create() [2/2]

◆ release() [1/2]

◆ release() [2/2]

◆ get()

◆ getReference() [1/2]

◆ getReference() [2/2]

◆ equals()

◆ is_valid()

◆ operator->()

◆ operator JAccessibleObjectOutput< T > *()

Member Data Documentation

◆ do_throw

◆ counter

◆ __p

template<class T>
struct JLANG::JAccessibleObjectWriter< T >