#include <SSMIndStringColumn.h>

Public Member Functions
	SSMIndStringColumn (SSMBase *aParent, int aDataType, uInt aColNr)
	Create a SSMIndStringColumn object with the given parent. More...

virtual	~SSMIndStringColumn ()

virtual void	getArrayV (rownr_t rownr, ArrayBase &dataPtr)
	Get an array value in the given row. More...

virtual void	putArrayV (rownr_t rownr, const ArrayBase &dataPtr)
	Put an array value in the given row. More...

void	setShape (rownr_t aRowNr, const IPosition &aShape)
	Set the shape of the array in the given row. More...

virtual IPosition	shape (rownr_t aRowNr)
	Get the shape of the array in the given row. More...

Bool	canChangeShape () const
	This storage manager can handle changing array shapes. More...

virtual Bool	isShapeDefined (rownr_t aRowNr)
	Is the shape defined (i.e. More...

virtual uInt	ndim (rownr_t aRowNr)
	Get the dimensionality of the item in the given row. More...

Public Member Functions inherited from casacore::SSMDirColumn
	SSMDirColumn (SSMBase *aParent, int aDataType, uInt aColNr)
	Create a SSMDirColumn object with the given parent. More...

virtual	~SSMDirColumn ()

virtual void	setMaxLength (uInt maxLength)
	An array of 'fixed length' strings is not handled specially, thus this function is ignored. More...

virtual void	deleteRow (rownr_t aRowNr)
	Remove the given row from the data bucket and possibly string bucket. More...

Public Member Functions inherited from casacore::SSMColumn
	SSMColumn (SSMBase *aParent, int aDataType, uInt aColNr)
	Create a SSMColumn object with the given parent. More...

virtual	~SSMColumn ()

virtual void	setShapeColumn (const IPosition &aShape)
	Set the shape of an array in the column. More...

virtual void	doCreate (rownr_t aNrRows)
	Let the object initialize itself for a newly created table. More...

virtual void	getFile (rownr_t aNrRows)
	Let the column object initialize itself for an existing table. More...

void	resync (rownr_t aNrRow)
	Resync the storage manager with the new file contents. More...

virtual void	getBool (rownr_t aRowNr, Bool *aDataPtr)
	Get the scalar value in the given row. More...

virtual void	getuChar (rownr_t aRowNr, uChar *aDataPtr)

virtual void	getShort (rownr_t aRowNr, Short *aDataPtr)

virtual void	getuShort (rownr_t aRowNr, uShort *aDataPtr)

virtual void	getInt (rownr_t aRowNr, Int *aDataPtr)

virtual void	getuInt (rownr_t aRowNr, uInt *aDataPtr)

virtual void	getInt64 (rownr_t aRowNr, Int64 *aDataPtr)

virtual void	getfloat (rownr_t aRowNr, float *aDataPtr)

virtual void	getdouble (rownr_t aRowNr, double *aDataPtr)

virtual void	getComplex (rownr_t aRowNr, Complex *aDataPtr)

virtual void	getDComplex (rownr_t aRowNr, DComplex *aDataPtr)

virtual void	getString (rownr_t aRowNr, String *aDataPtr)

virtual void	putBool (rownr_t aRowNr, const Bool *aDataPtr)
	Put the scalar value in the given row. More...

virtual void	putuChar (rownr_t aRowNr, const uChar *aDataPtr)

virtual void	putShort (rownr_t aRowNr, const Short *aDataPtr)

virtual void	putuShort (rownr_t aRowNr, const uShort *aDataPtr)

virtual void	putInt (rownr_t aRowNr, const Int *aDataPtr)

virtual void	putuInt (rownr_t aRowNr, const uInt *aDataPtr)

virtual void	putInt64 (rownr_t aRowNr, const Int64 *aDataPtr)

virtual void	putfloat (rownr_t aRowNr, const float *aDataPtr)

virtual void	putdouble (rownr_t aRowNr, const double *aDataPtr)

virtual void	putComplex (rownr_t aRowNr, const Complex *aDataPtr)

virtual void	putDComplex (rownr_t aRowNr, const DComplex *aDataPtr)

virtual void	putString (rownr_t aRowNr, const String *aDataPtr)

virtual void	getScalarColumnV (ArrayBase &aDataPtr)
	Get the scalar values of the entire column. More...

virtual void	putScalarColumnV (const ArrayBase &aDataPtr)
	Put the scalar values of the entire column. More...

virtual void	addRow (rownr_t aNewNrRows, rownr_t anOldNrRows, Bool doInit)
	Add (NewNrRows-OldNrRows) rows to the Column and initialize the new rows when needed. More...

uInt	getExternalSizeBytes () const
	Get the size of the dataType in bytes!! More...

uInt	getExternalSizeBits () const
	Get the size of the dataType in bits!! More...

uInt	getColNr ()
	get the sequence number of this column. More...

void	setColNr (uInt aColNr)
	set the sequence number of this column. More...

void	removeColumn ()
	If something special has to be done before removing the Column, as is the case with Strings, it can be done here. More...

Public Member Functions inherited from casacore::StManColumnBase
	StManColumnBase (int dataType)
	Default constructor. More...

	~StManColumnBase ()

virtual int	dataType () const
	Return the data type of the column. More...

DataType	dtype () const

Int	elemSize () const
	Return the size of an element of the column's data type. More...

Public Member Functions inherited from casacore::DataManagerColumn
	DataManagerColumn ()
	Create a column. More...

virtual	~DataManagerColumn ()
	Frees up the storage. More...

void	setIsFixedShape (Bool isFixedShape)
	Set the isFixedShape flag. More...

Bool	isFixedShape () const
	Is this a fixed shape column? More...

virtual String	dataTypeId () const
	Get the data type id of the column for dataType==TpOther. More...

virtual Bool	isWritable () const
	Test if data can be put into this column. More...

void	setFixedShapeColumn (const IPosition &shape)
	Set the shape of all (fixed-shaped) arrays in the column. More...

virtual void	setShapeTiled (rownr_t rownr, const IPosition &shape, const IPosition &tileShape)
	Set the shape and tile shape of an (variable-shaped) array in the given row. More...

virtual IPosition	tileShape (rownr_t rownr)
	Get the tile shape of the item in the given row. More...

ColumnCache &	columnCache ()
	Get access to the ColumnCache object. More...

const ColumnCache *	columnCachePtr () const

void	get (rownr_t rownr, Bool *dataPtr)
	Get the scalar value in the given row. More...

void	get (rownr_t rownr, uChar *dataPtr)

void	get (rownr_t rownr, Short *dataPtr)

void	get (rownr_t rownr, uShort *dataPtr)

void	get (rownr_t rownr, Int *dataPtr)

void	get (rownr_t rownr, uInt *dataPtr)

void	get (rownr_t rownr, Int64 *dataPtr)

void	get (rownr_t rownr, float *dataPtr)

void	get (rownr_t rownr, double *dataPtr)

void	get (rownr_t rownr, Complex *dataPtr)

void	get (rownr_t rownr, DComplex *dataPtr)

void	get (rownr_t rownr, String *dataPtr)

void	get (rownr_t rownr, void *dataPtr)
	This function is the get for all non-standard data types. More...

void	put (rownr_t rownr, const Bool *dataPtr)
	Put the scalar value into the given row. More...

void	put (rownr_t rownr, const uChar *dataPtr)

void	put (rownr_t rownr, const Short *dataPtr)

void	put (rownr_t rownr, const uShort *dataPtr)

void	put (rownr_t rownr, const Int *dataPtr)

void	put (rownr_t rownr, const uInt *dataPtr)

void	put (rownr_t rownr, const Int64 *dataPtr)

void	put (rownr_t rownr, const float *dataPtr)

void	put (rownr_t rownr, const double *dataPtr)

void	put (rownr_t rownr, const Complex *dataPtr)

void	put (rownr_t rownr, const DComplex *dataPtr)

void	put (rownr_t rownr, const String *dataPtr)

void	put (rownr_t rownr, const void *dataPtr)
	This function is the put for all non-standard data types. More...

virtual void	getScalarColumnCellsV (const RefRows &rownrs, ArrayBase &dataPtr)
	Get some scalar values in the column. More...

virtual void	putScalarColumnCellsV (const RefRows &rownrs, const ArrayBase &dataPtr)
	Put some scalar values in the column. More...

virtual void	getArrayColumnV (ArrayBase &data)
	Get all array values in the column. More...

virtual void	putArrayColumnV (const ArrayBase &data)
	Put all array values in the column. More...

virtual void	getArrayColumnCellsV (const RefRows &rownrs, ArrayBase &data)
	Get some array values in the column. More...

virtual void	putArrayColumnCellsV (const RefRows &rownrs, const ArrayBase &data)
	Put some array values in the column. More...

virtual void	getSliceV (rownr_t rownr, const Slicer &slicer, ArrayBase &data)
	Get a section of the array in the given row. More...

virtual void	putSliceV (rownr_t rownr, const Slicer &slicer, const ArrayBase &data)
	Put into a section of the array in the given row. More...

virtual void	getColumnSliceV (const Slicer &slicer, ArrayBase &data)
	Get a section of all arrays in the column. More...

virtual void	putColumnSliceV (const Slicer &slicer, const ArrayBase &data)
	Put into a section of all arrays in the column. More...

virtual void	getColumnSliceCellsV (const RefRows &rownrs, const Slicer &slicer, ArrayBase &data)
	Get a section of some arrays in the column. More...

virtual void	putColumnSliceCellsV (const RefRows &rownrs, const Slicer &slicer, const ArrayBase &data)
	Put into a section of some arrays in the column. More...

void	throwGet () const
	Throw an "invalid operation" exception for the default implementation of get. More...

void	throwPut () const
	Throw an "invalid operation" exception for the default implementation of put. More...

void	setColumnName (const String &colName)
	Set the column name. More...

const String &	columnName () const
	Get rhe column name. More...

Private Member Functions
	SSMIndStringColumn (const SSMIndStringColumn &)
	Forbid copy constructor. More...

SSMIndStringColumn &	operator= (const SSMIndStringColumn &)
	Forbid assignment. More...

Additional Inherited Members
Static Public Member Functions inherited from casacore::StManColumnBase
static Bool	isNativeDataType (int dtype)
	Test if the given data type is supported by storage managers. More...

Protected Member Functions inherited from casacore::SSMDirColumn
void	getValue (rownr_t aRowNr, void *data)
	Read the array data for the given row into the data buffer. More...

Protected Member Functions inherited from casacore::SSMColumn
void	shiftRows (char *aValue, rownr_t rowNr, rownr_t startRow, rownr_t endRow)
	Shift the rows in the bucket one to the left when removing the given row. More...

void	getValue (rownr_t aRowNr)
	Fill the cache with data of the bucket containing the given row. More...

Char *	getRowValue (Int *data, rownr_t aRowNr)
	Get the bucketnr, offset, and length of a variable length string. More...

void	putValue (rownr_t aRowNr, const void *aValue)
	Put the given value for the row into the correct data bucket. More...

void	putValueShortString (rownr_t aRowNr, const void *aValue, const String &string)
	Put the given string for the row into the correct data bucket. More...

void	getColumnValue (void *anArray, rownr_t aNrRows)
	Get the values for the entire column. More...

void	putColumnValue (const void *anArray, rownr_t aNrRows)
	Put the values from the array in the entire column. More...

Protected Member Functions inherited from casacore::DataManagerColumn
virtual void	getOther (rownr_t rownr, void *dataPtr)
	This function is the get for all non-standard data types. More...

virtual void	putOther (rownr_t rownr, const void *dataPtr)
	This function is the put for all non-standard data types. More...

void	getScalarColumnBase (ArrayBase &dataPtr)
	The default implementations of get and put functions. More...

void	putScalarColumnBase (const ArrayBase &dataPtr)

void	getScalarColumnCellsBase (const RefRows &rownrs, ArrayBase &dataPtr)

void	putScalarColumnCellsBase (const RefRows &rownrs, const ArrayBase &dataPtr)

void	getArrayColumnBase (ArrayBase &data)

void	putArrayColumnBase (const ArrayBase &data)

void	getArrayColumnCellsBase (const RefRows &rownrs, ArrayBase &data)

void	putArrayColumnCellsBase (const RefRows &rownrs, const ArrayBase &data)

void	getSliceBase (rownr_t rownr, const Slicer &slicer, ArrayBase &data)

void	putSliceBase (rownr_t rownr, const Slicer &slicer, const ArrayBase &data)

void	getColumnSliceBase (const Slicer &slicer, ArrayBase &data)

void	putColumnSliceBase (const Slicer &slicer, const ArrayBase &data)

void	getColumnSliceCellsBase (const RefRows &rownrs, const Slicer &slicer, ArrayBase &data)

void	putColumnSliceCellsBase (const RefRows &rownrs, const Slicer &slicer, const ArrayBase &data)

Protected Attributes inherited from casacore::SSMColumn
SSMBase *	itsSSMPtr
	Pointer to the parent storage manager. More...

uInt	itsExternalSizeBytes
	Length of column cell value in storage format (0 = variable length). More...

uInt	itsExternalSizeBits

uInt	itsColNr
	Column sequence number of this column. More...

IPosition	itsShape
	The shape of the column. More...

uInt	itsMaxLen
	The maximum length of a 'fixed length' string. More...

uInt	itsNrElem
	Number of elements in a value for this column. More...

uInt	itsNrCopy
	Number of values to be copied. More...

uInt	itsLocalSize
	The sizeof the datatype in local format. More...

void *	itsData
	The data in local format. More...

Conversion::ValueFunction *	itsWriteFunc
	Pointer to a convert function for writing. More...

Conversion::ValueFunction *	itsReadFunc
	Pointer to a convert function for reading. More...

Detailed Description

An Indirect String Array Column in the Standard Storage Manager.

Intended use:

Internal

Review Status

Reviewed By:: UNKNOWN
Date Reviewed:: before2004/08/25
Test programs:: tSSMStringHandler

Prerequisite

Etymology

SSMIndStringColumn represents an Indirect String Array Column in the Standard Storage Manager.

Synopsis

SSMIndStringColumn handles indirect variable shaped string arrays. Note that indirect fixed shape string arrays are handled by SSMDirColumn.

All string array access is handled by class SSMStringHandler, so SSMIndStringColumn is merely an interface to this class. The only thing it does is accessing the bucketnr, offset, and length in the data bucket.

Motivation

The reason that indirect string arrays are handled here instead of in SSMIndColumn is that the string buckets are more disk space efficient when string arrays are frequently updated.

Definition at line 86 of file SSMIndStringColumn.h.

Constructor & Destructor Documentation

◆ SSMIndStringColumn() [1/2]

casacore::SSMIndStringColumn::SSMIndStringColumn	(	SSMBase *	aParent,
		int	aDataType,
		uInt	aColNr
	)

Create a SSMIndStringColumn object with the given parent.

It initializes the various variables. It keeps the pointer to its parent (but does not own it).

◆ ~SSMIndStringColumn()

virtual casacore::SSMIndStringColumn::~SSMIndStringColumn ( )

virtual

◆ SSMIndStringColumn() [2/2]

casacore::SSMIndStringColumn::SSMIndStringColumn ( const SSMIndStringColumn & )

private

Forbid copy constructor.

Member Function Documentation

◆ canChangeShape()

Bool casacore::SSMIndStringColumn::canChangeShape ( ) const

virtual

This storage manager can handle changing array shapes.

Reimplemented from casacore::DataManagerColumn.

◆ getArrayV()

virtual void casacore::SSMIndStringColumn::getArrayV	(	rownr_t	rownr,
		ArrayBase &	dataPtr
	)

virtual

Get an array value in the given row.

An exception is thrown if no array is defined in this row.

Reimplemented from casacore::SSMDirColumn.

◆ isShapeDefined()

virtual Bool casacore::SSMIndStringColumn::isShapeDefined ( rownr_t aRowNr )

virtual

Is the shape defined (i.e.

is there an array) in this row?

Reimplemented from casacore::DataManagerColumn.

◆ ndim()

virtual uInt casacore::SSMIndStringColumn::ndim ( rownr_t aRowNr )

virtual

Get the dimensionality of the item in the given row.

Reimplemented from casacore::SSMColumn.

◆ operator=()

SSMIndStringColumn& casacore::SSMIndStringColumn::operator= ( const SSMIndStringColumn & )

private

Forbid assignment.

◆ putArrayV()

virtual void casacore::SSMIndStringColumn::putArrayV	(	rownr_t	rownr,
		const ArrayBase &	dataPtr
	)

virtual

Put an array value in the given row.

Reimplemented from casacore::SSMDirColumn.

◆ setShape()

void casacore::SSMIndStringColumn::setShape	(	rownr_t	aRowNr,
		const IPosition &	aShape
	)

virtual

Set the shape of the array in the given row.

Reimplemented from casacore::DataManagerColumn.

◆ shape()

virtual IPosition casacore::SSMIndStringColumn::shape ( rownr_t aRowNr )

virtual

Get the shape of the array in the given row.

Reimplemented from casacore::SSMColumn.

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

tables/DataMan/SSMIndStringColumn.h

Public Member Functions

Private Member Functions

Additional Inherited Members

Detailed Description

Intended use:

Review Status

Prerequisite

Etymology

Synopsis

Motivation

Constructor & Destructor Documentation

◆ SSMIndStringColumn() [1/2]

◆ ~SSMIndStringColumn()

◆ SSMIndStringColumn() [2/2]

Member Function Documentation

◆ canChangeShape()

◆ getArrayV()

◆ isShapeDefined()

◆ ndim()

◆ operator=()

◆ putArrayV()

◆ setShape()

◆ shape()