Access to a scalar table column with arbitrary data type. More...

#include <MSFitsOutput.h>

Inheritance diagram for casacore::ScalarColumn< T >:

Public Member Functions
	ScalarColumn ()
	The default constructor creates a null object, i.e. More...

	ScalarColumn (const Table &, const String &columnName)
	Construct for the given column in the given table. More...

	ScalarColumn (const TableColumn &)
	Construct from the given table column. More...

	ScalarColumn (const ScalarColumn< T > &)
	Copy constructor (reference semantics). More...

	~ScalarColumn ()

virtual TableColumn *	clone () const
	Clone the object. More...

ScalarColumn< T > &	operator= (const ScalarColumn< T > &)
	Assignment uses reference semantics, thus works the same as function reference. More...

void	reference (const ScalarColumn< T > &)
	Change the reference to another column. More...

void	attach (const Table &table, const String &columnName)
	Attach a column to the object. More...

void	get (uInt rownr, T &value) const
	Get the data from a particular cell (i.e. More...

T	get (uInt rownr) const

T	operator() (uInt rownr) const

void	getColumn (Vector< T > &vec, Bool resize=False) const
	Get the vector of all values in the column. More...

Vector< T >	getColumn () const
	Get the vector of all values in the column. More...

void	getColumnRange (const Slicer &rowRange, Vector< T > &vec, Bool resize=False) const
	Get the vector of a range of values in the column. More...

Vector< T >	getColumnRange (const Slicer &rowRange) const
	Get the vector of a range of values in the column. More...

void	getColumnCells (const RefRows &rownrs, Vector< T > &vec, Bool resize=False) const
	Get the vector of some values in the column. More...

Vector< T >	getColumnCells (const RefRows &rownrs) const
	Get the vector of some values in the column. More...

void	put (uInt rownr, const T &value)
	Put the value in a particular cell (i.e. More...

void	put (uInt rownr, const ScalarColumn< T > &that)
	Copy the value of a cell of that column to a cell of this column. More...

void	put (uInt thisRownr, const ScalarColumn< T > &that, uInt thatRownr)
	Use possibly different row numbers for that (i.e. More...

void	put (uInt rownr, const TableColumn &that, Bool=False)
	Copy the value of a cell of that column to a cell of this column. More...

void	put (uInt thisRownr, const TableColumn &that, uInt thatRownr, Bool=False)
	Use possibly different row numbers for that (i.e. More...

void	putColumn (const Vector< T > &vec)
	Put the vector of all values in the column. More...

void	putColumnRange (const Slicer &rowRange, const Vector< T > &vec)
	Put the vector of a range of values in the column. More...

void	putColumnCells (const RefRows &rownrs, const Vector< T > &vec)
	Put the vector of some values in the column. More...

void	fillColumn (const T &value)
	Put the same value in all cells of the column. More...

void	putColumn (const ScalarColumn< T > &that)
	Put the contents of a column with the same data type into this column. More...

Public Member Functions inherited from casacore::TableColumn
	TableColumn ()
	The default constructor creates a null object, i.e. More...

	TableColumn (const Table &, const String &columnName)
	Construct the object for a column in the table using its name. More...

	TableColumn (const Table &, uInt columnIndex)
	Construct the object for a column in the table using its index. More...

	TableColumn (const TableColumn &)
	Copy constructor (reference semantics). More...

virtual	~TableColumn ()

TableColumn &	operator= (const TableColumn &)
	Assignment has reference semantics. More...

void	reference (const TableColumn &)
	Change the reference to another column. More...

void	attach (const Table &table, const String &columnName)
	Attach a column to the object. More...

void	attach (const Table &table, uInt columnIndex)

Bool	isNull () const
	Test if the object is null, i.e. More...

void	throwIfNull () const
	Throw an exception if the object is null, i.e. More...

Bool	isWritable () const
	Test if the column can be written to, thus if the column and the underlying table can be written to. More...

Bool	isWritableAtAll () const
	Test if the column is writable at all (virtual columns might not be). More...

void	checkWritable () const
	Check if the column is writable and throw an exception if not. More...

const TableRecord &	keywordSet () const
	Get readonly access to the column keyword set. More...

TableRecord &	rwKeywordSet ()
	Get read/write access to the column keyword set. More...

const ColumnDesc &	columnDesc () const
	Get const access to the column description. More...

Table	table () const
	Get the Table object this column belongs to. More...

uInt	nrow () const
	Get the number of rows in the column. More...

Bool	canChangeShape () const
	Can the shape of an already existing non-FixedShape array be changed? This depends on the storage manager. More...

uInt	ndimColumn () const
	Get the global #dimensions of an array (ie. More...

IPosition	shapeColumn () const
	Get the global shape of an array (ie. More...

Bool	isDefined (uInt rownr) const
	Test if the given cell contains a defined value. More...

Bool	hasContent (uInt rownr=0) const
	Does the column has content in the given row (default is the first row)? It has if it is defined and does not contain an empty array. More...

uInt	ndim (uInt rownr) const
	Get the #dimensions of an array in a particular cell. More...

IPosition	shape (uInt rownr) const
	Get the shape of an array in a particular cell. More...

IPosition	tileShape (uInt rownr) const
	Get the tile shape of an array in a particular cell. More...

void	getScalar (uInt rownr, Bool &value) const
	Get the value of a scalar in the given row. More...

void	getScalar (uInt rownr, uChar &value) const

void	getScalar (uInt rownr, Short &value) const

void	getScalar (uInt rownr, uShort &value) const

void	getScalar (uInt rownr, Int &value) const

void	getScalar (uInt rownr, uInt &value) const

void	getScalar (uInt rownr, Int64 &value) const

void	getScalar (uInt rownr, float &value) const

void	getScalar (uInt rownr, double &value) const

void	getScalar (uInt rownr, Complex &value) const

void	getScalar (uInt rownr, DComplex &value) const

void	getScalar (uInt rownr, String &value) const

Bool	asBool (uInt rownr) const
	Get the value from the row and convert it to the required type. More...

uChar	asuChar (uInt rownr) const

Short	asShort (uInt rownr) const

uShort	asuShort (uInt rownr) const

Int	asInt (uInt rownr) const

uInt	asuInt (uInt rownr) const

Int64	asInt64 (uInt rownr) const

float	asfloat (uInt rownr) const

double	asdouble (uInt rownr) const

Complex	asComplex (uInt rownr) const

DComplex	asDComplex (uInt rownr) const

String	asString (uInt rownr) const

void	getScalarValue (uInt rownr, Bool *value, const String &) const
	Get the value of a scalar in the given row. More...

void	getScalarValue (uInt rownr, uChar *value, const String &) const

void	getScalarValue (uInt rownr, Short *value, const String &) const

void	getScalarValue (uInt rownr, uShort *value, const String &) const

void	getScalarValue (uInt rownr, Int *value, const String &) const

void	getScalarValue (uInt rownr, uInt *value, const String &) const

void	getScalarValue (uInt rownr, Int64 *value, const String &) const

void	getScalarValue (uInt rownr, float *value, const String &) const

void	getScalarValue (uInt rownr, double *value, const String &) const

void	getScalarValue (uInt rownr, Complex *value, const String &) const

void	getScalarValue (uInt rownr, DComplex *value, const String &) const

void	getScalarValue (uInt rownr, String *value, const String &) const

void	getScalarValue (uInt rownr, void *value, const String &dataTypeId) const

void	put (uInt rownr, const TableColumn &that, Bool preserveTileShape=False)
	Copy the value of a cell of that column to a cell of this column. More...

void	putColumn (const TableColumn &that)
	Copy the values of that column to this column. More...

void	putScalar (uInt rownr, const Bool &value)
	Put the value of a scalar in the given row. More...

void	putScalar (uInt rownr, const uChar &value)

void	putScalar (uInt rownr, const Short &value)

void	putScalar (uInt rownr, const uShort &value)

void	putScalar (uInt rownr, const Int &value)

void	putScalar (uInt rownr, const uInt &value)

void	putScalar (uInt rownr, const Int64 &value)

void	putScalar (uInt rownr, const float &value)

void	putScalar (uInt rownr, const double &value)

void	putScalar (uInt rownr, const Complex &value)

void	putScalar (uInt rownr, const DComplex &value)

void	putScalar (uInt rownr, const String &value)

void	putScalar (uInt rownr, const Char *value)

void	checkRowNumber (uInt rownr) const
	Check if the row number is valid. More...

void	setMaximumCacheSize (uInt nbytes) const
	Set the maximum cache size (in bytes) to be used by a storage manager. More...

Protected Attributes
Bool	canAccessColumn_p
	Keep a switch to determine if an entire column can be accessed. More...

Bool	reaskAccessColumn_p
	Keep a switch to know if access knowledge is permanent or has to be asked again the next time. More...

Protected Attributes inherited from casacore::TableColumn
BaseTable *	baseTabPtr_p

BaseColumn *	baseColPtr_p

const ColumnCache *	colCachePtr_p

Bool	canChangeShape_p

Bool	isColWritable_p

Private Member Functions
void	checkDataType () const
	Check if the data type matches the column data type. More...

Additional Inherited Members
Protected Member Functions inherited from casacore::TableColumn
BaseColumn *	baseColPtr () const
	Get the baseColPtr_p of this TableColumn object. More...

BaseColumn *	baseColPtr (const TableColumn &that) const
	Get the baseColPtr_p of another TableColumn object. More...

Detailed Description

template<class T>
class casacore::ScalarColumn< T >

Access to a scalar table column with arbitrary data type.

Intended use:

Public interface

Review Status

Reviewed By:: dschieb
Date Reviewed:: 1994/08/10
Test programs:: none

Prerequisite

Etymology

ScalarColumn<T> gives read and write access to a column in a table containing a scalar with data type T.

Synopsis

The class ScalarColumn allows read and write access to a column containing scalar values with an arbitrary data type. It is possible to get the data in an individual cell (i.e. table row) and to get the column as a whole.

A default constructor is defined to allow construction of an array of ScalarColumn objects. However, this constructs an object not referencing a column. Functions like get, etc. will fail (i.e. result in a segmentation fault) when used on such objects. The functions isNull and throwIfNull can be used to test on this. The functions attach and reference can fill in the object.

Example

See module Tables.

Definition at line 41 of file MSFitsOutput.h.

Constructor & Destructor Documentation

template<class T>

casacore::ScalarColumn< T >::ScalarColumn ( )

The default constructor creates a null object, i.e.

it does not reference a table column. The sole purpose of this constructor is to allow construction of an array of ScalarColumn objects. The functions reference and attach can be used to make a null object reference a column. Note that get functions, etc. will cause a segmentation fault when operating on a null object. It was felt it was too expensive to test on null over and over again. The user should use the isNull or throwIfNull function in case of doubt.

template<class T>

casacore::ScalarColumn< T >::ScalarColumn	(	const Table &	,
		const String &	columnName
	)

Construct for the given column in the given table.

template<class T>

casacore::ScalarColumn< T >::ScalarColumn ( const TableColumn & )

explicit

Construct from the given table column.

This constructor is useful if first a table column was constructed, its type is determined and thereafter used to construct the correct column object.

template<class T>

casacore::ScalarColumn< T >::ScalarColumn ( const ScalarColumn< T > & )

Copy constructor (reference semantics).

template<class T>

casacore::ScalarColumn< T >::~ScalarColumn ( )

Member Function Documentation

template<class T>

void casacore::ScalarColumn< T >::attach	(	const Table &	table,
		const String &	columnName
	)

inline

Attach a column to the object.

This is in fact only a shorthand for
reference (ScalarColumn<T> (table, columnName));

Definition at line 131 of file ScalarColumn.h.

Referenced by casa::ScantableSourceIterator::ScantableSourceIterator().

template<class T>

void casacore::ScalarColumn< T >::checkDataType ( ) const

private

Check if the data type matches the column data type.

template<class T>

virtual TableColumn* casacore::ScalarColumn< T >::clone ( ) const

virtual

Clone the object.

Reimplemented from casacore::TableColumn.

template<class T>

void casacore::ScalarColumn< T >::fillColumn ( const T & value )

Put the same value in all cells of the column.

template<class T>

void casacore::ScalarColumn< T >::get	(	uInt	rownr,
		T &	value
	)		const

inline

Get the data from a particular cell (i.e.

table row). The row numbers count from 0 until #rows-1.

Definition at line 137 of file ScalarColumn.h.

Referenced by casa::BaselineTable::getAntenna(), casa::BaselineTable::getBeam(), casa::BaselineTable::getScan(), casa::BaselineTable::getSpw(), and casa::BaselineTable::getTime().

template<class T>

T casacore::ScalarColumn< T >::get ( uInt rownr ) const

inline

Definition at line 147 of file ScalarColumn.h.

template<class T>

void casacore::ScalarColumn< T >::getColumn	(	Vector< T > &	vec,
		Bool	resize = `False`
	)		const

Get the vector of all values in the column.

According to the assignment rules of class Array, the destination vector must be empty or its length must be the number of cells in the column (i.e. the number of rows in the table).

Referenced by casa::BaselineTable::getNChan(), casa::Scantable2MSReader::isFloatData(), casa::ScantableFrequenciesIterator::ScantableFrequenciesIterator(), and casa::ScantableSourceIterator::ScantableSourceIterator().

template<class T>

Vector<T> casacore::ScalarColumn< T >::getColumn ( ) const

Get the vector of all values in the column.

template<class T>

void casacore::ScalarColumn< T >::getColumnCells	(	const RefRows &	rownrs,
		Vector< T > &	vec,
		Bool	resize = `False`
	)		const

Get the vector of some values in the column.

The Slicer object can be used to specify start, end (or length), and stride of the rows to get. According to the assignment rules of class Array, the destination vector must be empty or its length must be the number of cells in the column (i.e. the number of rows in the RefRows object).

template<class T>

Vector<T> casacore::ScalarColumn< T >::getColumnCells ( const RefRows & rownrs ) const

Get the vector of some values in the column.

template<class T>

void casacore::ScalarColumn< T >::getColumnRange	(	const Slicer &	rowRange,
		Vector< T > &	vec,
		Bool	resize = `False`
	)		const

Get the vector of a range of values in the column.

The Slicer object can be used to specify start, end (or length), and stride of the rows to get. According to the assignment rules of class Array, the destination vector must be empty or its length must be the number of cells in the column (i.e. the number of rows in the slicer).

template<class T>

Vector<T> casacore::ScalarColumn< T >::getColumnRange ( const Slicer & rowRange ) const

Get the vector of a range of values in the column.

The Slicer object can be used to specify start, end (or length), and stride of the rows to get..

template<class T>

T casacore::ScalarColumn< T >::operator() ( uInt rownr ) const

inline

Definition at line 153 of file ScalarColumn.h.

template<class T>

ScalarColumn<T>& casacore::ScalarColumn< T >::operator= ( const ScalarColumn< T > & )

Assignment uses reference semantics, thus works the same as function reference.

template<class T>

void casacore::ScalarColumn< T >::put	(	uInt	rownr,
		const T &	value
	)

inline

Put the value in a particular cell (i.e.

table row). The row numbers count from 0 until #rows-1.

Definition at line 198 of file ScalarColumn.h.

template<class T>

void casacore::ScalarColumn< T >::put	(	uInt	rownr,
		const ScalarColumn< T > &	that
	)

inline

Copy the value of a cell of that column to a cell of this column.

The data types of both columns must be the same.

Use the same row numbers for both cells.

Definition at line 206 of file ScalarColumn.h.

template<class T>

void casacore::ScalarColumn< T >::put	(	uInt	thisRownr,
		const ScalarColumn< T > &	that,
		uInt	thatRownr
	)

Use possibly different row numbers for that (i.e.

input) and and this (i.e. output) cell.

template<class T>

void casacore::ScalarColumn< T >::put	(	uInt	rownr,
		const TableColumn &	that,
		Bool	= `False`
	)

inline

Copy the value of a cell of that column to a cell of this column.

This function uses a generic TableColumn object as input. If possible the data will be promoted to the data type of this column. Otherwise an exception is thrown.

Use the same row numbers for both cells.

Definition at line 219 of file ScalarColumn.h.

template<class T>

void casacore::ScalarColumn< T >::put	(	uInt	thisRownr,
		const TableColumn &	that,
		uInt	thatRownr,
		Bool	= `False`
	)

virtual

Use possibly different row numbers for that (i.e.

input) and and this (i.e. output) cell.

Reimplemented from casacore::TableColumn.

template<class T>

void casacore::ScalarColumn< T >::putColumn ( const Vector< T > & vec )

Put the vector of all values in the column.

The length of the vector must be the number of cells in the column (i.e. the number of rows in the table).

template<class T>

void casacore::ScalarColumn< T >::putColumn ( const ScalarColumn< T > & that )

Put the contents of a column with the same data type into this column.

To put the contents of a column with a different data type into this column, the function TableColumn::putColumn can be used (provided the data type promotion is possible). In fact, this function is an assignment operator with copy semantics.

template<class T>

void casacore::ScalarColumn< T >::putColumnCells	(	const RefRows &	rownrs,
		const Vector< T > &	vec
	)

Put the vector of some values in the column.

The length of the vector must be the number of cells in the RefRows object.

template<class T>

void casacore::ScalarColumn< T >::putColumnRange	(	const Slicer &	rowRange,
		const Vector< T > &	vec
	)

Put the vector of a range of values in the column.

The Slicer object can be used to specify start, end (or length), and stride of the rows to put. The length of the vector must be the number of cells in the slice.

template<class T>

void casacore::ScalarColumn< T >::reference ( const ScalarColumn< T > & )

Change the reference to another column.

This is in fact an assignment operator with reference semantics. It removes the reference to the current column and creates a reference to the column referenced in the other object. It will handle null objects correctly.

Referenced by casacore::ScalarColumn< casacore::String >::attach().

Member Data Documentation

template<class T>

Bool casacore::ScalarColumn< T >::canAccessColumn_p

mutableprotected

Keep a switch to determine if an entire column can be accessed.

True = yes; False = no.

Definition at line 260 of file ScalarColumn.h.

template<class T>

Bool casacore::ScalarColumn< T >::reaskAccessColumn_p

mutableprotected

Keep a switch to know if access knowledge is permanent or has to be asked again the next time.

Definition at line 263 of file ScalarColumn.h.

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

casa/casacore/msfits/MSFits/MSFitsOutput.h
casa/casacore/tables/Tables/ScalarColumn.h

Public Member Functions

Protected Attributes

Private Member Functions

Additional Inherited Members

Detailed Description

template<class T> class casacore::ScalarColumn< T >

Intended use:

Review Status

Prerequisite

Etymology

Synopsis

Example

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation

template<class T>
class casacore::ScalarColumn< T >