Class indicating a null Table object. More...

#include <NullTable.h>

Inheritance diagram for casacore::NullTable:

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

virtual	~NullTable ()

virtual Bool	isNull () const override
	The table is a null table. More...

virtual void	reopenRW () override
	All functions throw a "null table" exception. More...

virtual Bool	asBigEndian () const override
	Is the table stored in big or little endian format? More...

virtual const StorageOption &	storageOption () const override
	Get the storage option used for the table. More...

virtual Bool	isMultiUsed (Bool checkSubTable) const override
	Is the table in use (i.e. More...

virtual const TableLock &	lockOptions () const override
	Get the locking info. More...

virtual void	mergeLock (const TableLock &lockOptions) override
	Merge the given lock info with the existing one. More...

virtual Bool	hasLock (FileLocker::LockType) const override
	Has this process the read or write lock, thus can the table be read or written safely? More...

virtual Bool	lock (FileLocker::LockType, uInt nattempts) override
	Try to lock the table for read or write access. More...

virtual void	unlock () override
	Unlock the table. More...

virtual void	flush (Bool fsync, Bool recursive) override
	Flush the table, i.e. More...

virtual void	resync () override
	Resync the Table object with the table file. More...

virtual uInt	getModifyCounter () const override
	Get the modify counter. More...

virtual Bool	isWritable () const override
	Test if this table is writable. More...

virtual void	deepCopy (const String &newName, const Record &dataManagerInfo, const StorageOption &, int tableOption, Bool valueCopy, int endianFormat, Bool noRows) const override

virtual TableDesc	actualTableDesc () const override
	Get the actual table description. More...

virtual Record	dataManagerInfo () const override
	Get the data manager info. More...

virtual TableRecord &	keywordSet () override
	Get readonly access to the table keyword set. More...

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

virtual BaseColumn *	getColumn (uInt columnIndex) const override
	Get a column object using its index. More...

virtual BaseColumn *	getColumn (const String &columnName) const override
	Get a column object using its name. More...

virtual Bool	canAddRow () const override
	Test if it is possible to add a row to this table. More...

virtual void	addRow (rownr_t nrrow, Bool initialize) override
	Add one or more rows and possibly initialize them. More...

virtual Bool	canRemoveRow () const override
	Test if it is possible to remove a row from this table. More...

virtual void	removeRow (rownr_t rownr) override
	Remove rows. More...

virtual DataManager *	findDataManager (const String &name, Bool byColumn) const override
	Find the data manager with the given name or for the given column. More...

virtual void	addColumn (const ColumnDesc &columnDesc, Bool addToParent) override
	Add one or more columns to the table. More...

virtual void	addColumn (const ColumnDesc &columnDesc, const String &dataManager, Bool byName, Bool addToParent) override

virtual void	addColumn (const ColumnDesc &columnDesc, const DataManager &dataManager, Bool addToParent) override

virtual void	addColumn (const TableDesc &tableDesc, const DataManager &dataManager, Bool addToParent) override

virtual Bool	canRemoveColumn (const Vector< String > &columnNames) const override
	Test if columns can be removed. More...

virtual void	removeColumn (const Vector< String > &columnNames) override
	Remove columns. More...

virtual Bool	canRenameColumn (const String &columnName) const override
	Test if a column can be renamed. More...

virtual void	renameColumn (const String &newName, const String &oldName) override
	Rename a column. More...

virtual void	renameHypercolumn (const String &newName, const String &oldName) override
	Rename a hypercolumn. More...

virtual Vector< rownr_t >	rowNumbers () const override
	Get a vector of row numbers. More...

virtual BaseTable *	root () override
	Get pointer to root table (i.e. More...

virtual Bool	rowOrder () const override
	Tell if the table is in row order. More...

virtual Vector< rownr_t > *	rowStorage () override
	By the default the table cannot return the storage of rownrs. More...

virtual Bool	adjustRownrs (rownr_t nrrow, Vector< rownr_t > &rownrs, Bool determineOrder) const override
	Adjust the row numbers to be the actual row numbers in the root table. More...

virtual BaseTable *	doSort (PtrBlock< BaseColumn * > &, const Block< CountedPtr< BaseCompare > > &, const Block< Int > &sortOrder, int sortOption, std::shared_ptr< Vector< rownr_t >> sortIterBoundaries, std::shared_ptr< Vector< size_t >> sortIterKeyIdxChange) override
	Do the actual sort. More...

virtual void	renameSubTables (const String &newName, const String &oldName) override
	Rename the subtables (used by rename function). More...

Public Member Functions inherited from casacore::BaseTable
	BaseTable (const String &tableName, int tableOption, rownr_t nrrow)
	Initialize the object. More...

	BaseTable (MPI_Comm mpiComm, const String &tableName, int tableOption, rownr_t nrrow)
	MPI version of the constructor. More...

void	BaseTableCommon (const String &tableName, int tableOption, rownr_t nrrow)
	Common code shared by the MPI constructor and non-MPI constructor. More...

virtual	~BaseTable ()

void	link ()
	Link to this BaseTable object (i.e. More...

virtual void	setTableChanged ()
	Set the table to being changed. More...

void	doNotWrite ()
	Do not write the table (used in in case of exceptions). More...

Bool	isColumnWritable (const String &columnName) const
	Test if the given column is writable. More...

Bool	isColumnWritable (uInt columnIndex) const

Bool	isColumnStored (const String &columnName) const
	Test if the given column is stored (otherwise it is virtual). More...

Bool	isColumnStored (uInt columnIndex) const

const String &	tableName () const
	Get the table name. More...

virtual void	getPartNames (Block< String > &names, Bool recursive) const
	Get the names of the tables this table consists of. More...

virtual void	rename (const String &newName, int tableOption)
	Rename the table. More...

virtual void	copy (const String &newName, int tableOption) const
	Copy the table and all its subtables. More...

virtual int	tableType () const
	Get the table type. More...

int	tableOption () const
	Get the table option. More...

void	markForDelete (Bool callback, const String &oldName)
	Mark the table for delete. More...

void	unmarkForDelete (Bool callback, const String &oldName)
	Unmark the table for delete. More...

Bool	isMarkedForDelete () const
	Test if the table is marked for delete. More...

const TableDesc &	tableDesc () const
	Get the table description. More...

void	showStructure (std::ostream &, Bool showDataMan, Bool showColumns, Bool showSubTables, Bool sortColumns, Bool cOrder)
	Show the table structure (implementation of Table::showStructure). More...

TableInfo &	tableInfo ()
	Get access to the TableInfo object. More...

virtual void	flushTableInfo ()
	Write the TableInfo object. More...

rownr_t	nrow () const
	Get number of rows. More...

void	removeRow (const Vector< rownr_t > &rownrs)

void	removeRow (const Vector< uInt > &rownrs)

BaseTable *	select (const TableExprNode &, rownr_t maxRow, rownr_t offset)
	Select rows using the given expression (which can be null). More...

BaseTable *	select (rownr_t maxRow, rownr_t offset)
	Select maxRow rows and skip first offset rows. More...

BaseTable *	select (const Vector< rownr_t > &rownrs)
	Select rows using a vector of row numbers. More...

BaseTable *	select (const Block< Bool > &mask)
	Select rows using a mask block. More...

BaseTable *	project (const Block< String > &columnNames)
	Project the given columns (i.e. More...

BaseTable *	tabAnd (BaseTable *)
	Do logical operations on a table. More...

BaseTable *	tabOr (BaseTable *)
	union with another table More...

BaseTable *	tabSub (BaseTable *)
	subtract another table More...

BaseTable *	tabXor (BaseTable *)
	xor with another table More...

BaseTable *	tabNot ()
	take complement More...

BaseTable *	sort (const Block< String > &columnNames, const Block< CountedPtr< BaseCompare > > &compareObjects, const Block< Int > &sortOrder, int sortOption, std::shared_ptr< Vector< rownr_t >> sortIterBoundaries=nullptr, std::shared_ptr< Vector< size_t >> sortIterKeyIdxChange=nullptr)
	Sort a table on one or more columns of scalars. More...

BaseTableIterator *	makeIterator (const Block< String > &columnNames, const Block< CountedPtr< BaseCompare > > &, const Block< Int > &orders, int option, bool cacheIterationBoundaries=false)
	Create an iterator. More...

void	addColumns (const TableDesc &tableDesc, const Record &dmInfo, Bool addToParent)
	Add one or more columns to the table. More...

Bool	checkRemoveColumn (const Vector< String > &columnNames, Bool throwException) const
	Check if the set of columns can be removed. More...

RefTable *	makeRefTable (Bool rowOrder, rownr_t initialNrrow)
	Create a RefTable object. More...

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

int	traceId () const
	Get the table's trace-id. More...

Private Member Functions
	NullTable (const NullTable &)
	Copy constructor is forbidden, because copying a table requires some more knowledge (like table name of result). More...

NullTable &	operator= (const NullTable &)
	Assignment is forbidden, because copying a table requires some more knowledge (like table name of result). More...

TableError	makeError (const String &name) const
	Make an exception message with the name of the function. More...

Additional Inherited Members
Static Public Member Functions inherited from casacore::BaseTable
static void	unlink (BaseTable *)
	Unlink from a BaseTable. More...

static TableInfo	tableInfo (const String &tableName)
	Get the table info of the table with the given name. More...

Protected Member Functions inherited from casacore::BaseTable
void	scratchCallback (Bool isScratch, const String &oldName) const
	Do the callback for scratch tables (if callback is set). More...

Bool	makeTableDir ()
	Create the table directory when needed (and possible). More...

void	trueDeepCopy (const String &newName, const Record &dataManagerInfo, const StorageOption &, int tableOption, int endianFormat, Bool noRows) const
	Make a true deep copy of the table. More...

void	prepareCopyRename (const String &newName, int tableOption) const
	Prepare for copying or renaming a table. More...

void	throwIfTableExists ()
	Check if the table already exists. More...

Bool	openedForWrite () const
	Test if the table is opened for write. More...

void	writeStart (AipsIO &, Bool bigEndian)
	Start writing a table. More...

void	writeEnd (AipsIO &)
	End writing a table. More...

Bool	shouldNotWrite () const
	Should the table be written. More...

void	getTableInfo ()
	Read the TableInfo object. More...

Protected Attributes inherited from casacore::BaseTable
uInt	nrlink_p

rownr_t	nrrow_p

rownr_t	nrrowToAdd_p

CountedPtr< TableDesc >	tdescPtr_p

String	name_p

int	option_p

Bool	noWrite_p

Bool	delete_p

TableInfo	info_p

Bool	madeDir_p

int	itsTraceId

Detailed Description

Class indicating a null Table object.

Intended use:

Internal

Review Status

Reviewed By:: UNKNOWN
Date Reviewed:: before2004/08/25

Prerequisite

BaseTable

Etymology

NullTable represents a null table object, i.e. a Table object without an underlying table.

Synopsis

NullTable is used to represent a null table. The default Table constructor used to a create a null pointer which resulted in core dumps when the Table object was actually used. The NullTable object makes it possible to catch such cases and throw an appropriate exception.

Definition at line 68 of file NullTable.h.

Constructor & Destructor Documentation

casacore::NullTable::NullTable ( )

Default constructor.

virtual casacore::NullTable::~NullTable ( )

virtual

casacore::NullTable::NullTable ( const NullTable & )

private

Copy constructor is forbidden, because copying a table requires

some more knowledge (like table name of result).

Declaring it private, makes it unusable.

Member Function Documentation

virtual TableDesc casacore::NullTable::actualTableDesc ( ) const

overridevirtual

Get the actual table description.

Public Member Functions

Private Member Functions

Additional Inherited Members