Class for IO in a converted format. More...

#include <ConversionIO.h>

Inheritance diagram for casacore::ConversionIO:

Public Member Functions
	ConversionIO (DataConversion dataConversion, ByteIO byteIO, uInt bufferLength=4096, Bool takeOver=False)
	Constructor. More...

	ConversionIO (const ConversionIO &conversionIO)
	The copy constructor uses reference semantics. More...

ConversionIO &	operator= (const ConversionIO &conversionIO)
	The assignment operator uses reference semantics. More...

	~ConversionIO ()
	Destructor, deletes allocated memory. More...

virtual size_t	write (size_t nvalues, const Bool *value)
	Convert the values and write them to the ByteIO object. More...

virtual size_t	write (size_t nvalues, const Char *data)

virtual size_t	write (size_t nvalues, const uChar *data)

virtual size_t	write (size_t nvalues, const Short *data)

virtual size_t	write (size_t nvalues, const uShort *data)

virtual size_t	write (size_t nvalues, const Int *data)

virtual size_t	write (size_t nvalues, const uInt *data)

virtual size_t	write (size_t nvalues, const Int64 *data)

virtual size_t	write (size_t nvalues, const uInt64 *data)

virtual size_t	write (size_t nvalues, const Float *data)

virtual size_t	write (size_t nvalues, const Double *data)

virtual size_t	write (size_t nvalues, const Complex *value)

virtual size_t	write (size_t nvalues, const DComplex *value)

virtual size_t	write (size_t nvalues, const String *value)

virtual size_t	read (size_t nvalues, Bool *value)
	Read the values from the ByteIO object and convert them. More...

virtual size_t	read (size_t nvalues, Char *data)

virtual size_t	read (size_t nvalues, uChar *data)

virtual size_t	read (size_t nvalues, Short *data)

virtual size_t	read (size_t nvalues, uShort *data)

virtual size_t	read (size_t nvalues, Int *data)

virtual size_t	read (size_t nvalues, uInt *data)

virtual size_t	read (size_t nvalues, Int64 *data)

virtual size_t	read (size_t nvalues, uInt64 *data)

virtual size_t	read (size_t nvalues, Float *data)

virtual size_t	read (size_t nvalues, Double *data)

virtual size_t	read (size_t nvalues, Complex *value)

virtual size_t	read (size_t nvalues, DComplex *value)

virtual size_t	read (size_t nvalues, String *value)

Public Member Functions inherited from casacore::TypeIO
	TypeIO (ByteIO *byteIO, Bool takeOver=False)
	Constructor. More...

virtual	~TypeIO ()

const ByteIO &	byteIO () const
	Functions to return a reference to the ByteIO class. More...

ByteIO &	byteIO ()

Int64	seek (Int64 offset, ByteIO::SeekOption=ByteIO::Begin)
	This function sets the position on the given offset. More...

Int64	seek (Int offset, ByteIO::SeekOption=ByteIO::Begin)

Bool	isReadable () const
	Is the TypeIO stream readable? More...

Bool	isWritable () const
	Is the TypeIO stream writable? More...

Bool	isSeekable () const
	Is the TypeIO stream seekable? More...

Private Member Functions
void	init ()
	Initialize the `itsSize` and `itsCopy` variables. More...

Private Attributes
CountedPtr< DataConversion >	itsConversion

uInt	itsSizeChar

uInt	itsSizeuChar

uInt	itsSizeShort

uInt	itsSizeuShort

uInt	itsSizeInt

uInt	itsSizeuInt

uInt	itsSizeInt64

uInt	itsSizeuInt64

uInt	itsSizeFloat

uInt	itsSizeDouble

Bool	itsCopyChar

Bool	itsCopyuChar

Bool	itsCopyShort

Bool	itsCopyuShort

Bool	itsCopyInt

Bool	itsCopyuInt

Bool	itsCopyInt64

Bool	itsCopyuInt64

Bool	itsCopyFloat

Bool	itsCopyDouble

char *	itsBuffer

uInt	itsBufferLength

Additional Inherited Members
Protected Member Functions inherited from casacore::TypeIO
	TypeIO (const TypeIO &TypeIO)
	The copy constructor uses reference semantics. More...

TypeIO &	operator= (const TypeIO &typeIO)
	The assignment operator uses reference semantics. More...

Protected Attributes inherited from casacore::TypeIO
CountedPtr< ByteIO >	itsByteIO
	This variable keeps a pointer to a ByteIO. More...

Detailed Description

Class for IO in a converted format.

Intended use:

Public interface

Review Status

Reviewed By:: Friso Olnon
Date Reviewed:: 1996/11/06
Test programs:: tTypeIO

Prerequisite

ByteIO class and derived classes
TypeIO class
DataConversion

Synopsis

ConversionIO is a specialization of class TypeIO to store data in a converted format.

The class converts the data to/from external data and reads/writes them from/into the ByteIO object given at construction time. Conversion is only done when really needed. If not needed, the data is directly read or written.

This class is useful when data can be stored in one of multiple formats. Only at construction time the correct DataConversion class has to be given. Thereafter polymorphism ensures that the correct conversion is done when reading or writing.

Definition at line 74 of file ConversionIO.h.

Constructor & Destructor Documentation

casacore::ConversionIO::ConversionIO	(	DataConversion *	dataConversion,
		ByteIO *	byteIO,
		uInt	bufferLength = `4096`,
		Bool	takeOver = `False`
	)

Constructor.

The read/write functions will use the given ByteIO object as the data store and the given DataConversion object as the conversion engine.

The read and write functions use an intermediate buffer to hold the data in canonical format. For small arrays it uses a fixed buffer with length bufferLength. For arrays not fitting in this buffer, it uses a temporary buffer allocated on the heap.

If takeOver is True this this class will be responsible for deleting the DataConversion and ByteIO pointers. Otherwise it is the callers responsibility.

casacore::ConversionIO::ConversionIO ( const ConversionIO & conversionIO )

The copy constructor uses reference semantics.

casacore::ConversionIO::~ConversionIO ( )

Destructor, deletes allocated memory.

Member Function Documentation

void casacore::ConversionIO::init ( )

private

Initialize the itsSize and itsCopy variables.

ConversionIO& casacore::ConversionIO::operator= ( const ConversionIO & conversionIO )

The assignment operator uses reference semantics.

virtual size_t casacore::ConversionIO::read	(	size_t	nvalues,
		Bool *	value
	)

virtual

Read the values from the ByteIO object and convert them.

Bool, complex and String values are handled by the base class.

Reimplemented from casacore::TypeIO.

virtual size_t casacore::ConversionIO::read	(	size_t	nvalues,
		Char *	data
	)

virtual

Public Member Functions

Private Member Functions

Private Attributes

Additional Inherited Members