casa  $Rev:20696$
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Defines
Public Member Functions | Private Member Functions | Private Attributes | Friends
casa::ColumnDescSet Class Reference

Set of table column descriptions. More...

#include <ColDescSet.h>

List of all members.

Public Member Functions

 ColumnDescSet ()
 Construct an empty column set.
 ColumnDescSet (const ColumnDescSet &)
 Copy constructor (copy semantics).
 ~ColumnDescSet ()
ColumnDescSetoperator= (const ColumnDescSet &)
 Assignment (copy semantics).
ColumnDescoperator[] (const String &name)
 Get a column by its name.
const ColumnDescoperator[] (const String &name) const
ColumnDescoperator[] (uInt index)
 Get a column by its index.
const ColumnDescoperator[] (uInt index) const
uInt ncolumn () const
 Get nr of columns in this set.
Bool isDefined (const String &name) const
 Test if a column is defined in this set.
Bool isEqual (const ColumnDescSet &other, Bool &equalDataTypes) const
 Test if this set equals another one.
Bool isSubset (const ColumnDescSet &other, Bool &equalDataTypes) const
 Test if this set is a subset of another one.
Bool isStrictSubset (const ColumnDescSet &other, Bool &equalDataTypes) const
 Test if this set is a strict subset of another one, thus if it is a subset and not equal.
Bool isSuperset (const ColumnDescSet &other, Bool &equalDataTypes) const
 Test if this set is a superset of another one.
Bool isStrictSuperset (const ColumnDescSet &other, Bool &equalDataTypes) const
 Test if this set is a strict superset of another one, thus if it is a superset and not equal.
Bool isDisjoint (const ColumnDescSet &other) const
 Test if this and the other column set are disjoint.
void show (ostream &os) const
 Get const access to the column descriptions.
void checkSubTableDesc () const
 Check recursevily if the descriptions of all subtables are known.

Private Member Functions

ColumnDescaddColumn (const ColumnDesc &)
 Add a column.
ColumnDescaddColumn (const ColumnDesc &, const String &newname)
 Add a column with another name.
void remove (const String &name)
 Remove a column.
void rename (const String &newname, const String &oldname)
 Rename a column in the set.
Bool allExist (const ColumnDescSet &, Bool &equalDataTypes) const
 Test if all columns are part of the other set.
void add (const ColumnDescSet &set)
 Add another (disjoint) column set.
void putFile (AipsIO &ios, const TableAttr &) const
 Put the object.
void getFile (AipsIO &, const TableAttr &)
 Get the object.

Private Attributes

SimpleOrderedMap< String,
ColumnDesc
cols_p
 The set of all columns.
Block< void * > colSeq_p
 The order of addition of column descriptions.

Friends

class TableDesc

Detailed Description

Set of table column descriptions.

Intended use:

Internal

Review Status

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

Prerequisite

Etymology

ColumnDescSet is the set of column descriptions in a table description.

Synopsis

ColumnDescSet is used by TableDesc to store all column descriptions.

In principle this class is only used internally by the table system. However, there is a function in TableDesc which gives const access to this class. This can be used by the user to call functions like isDisjoint.

Definition at line 76 of file ColDescSet.h.


Constructor & Destructor Documentation

Construct an empty column set.

Copy constructor (copy semantics).


Member Function Documentation

void casa::ColumnDescSet::add ( const ColumnDescSet set) [private]

Add another (disjoint) column set.

If the sets are not disjoint (i.e. the other set contains a column with an already existing name, an exception is thrown and nothing of the other set is added.

Add a column.

An exception is thrown if a column with this name already exists.

Referenced by casa::TableDesc::addColumn().

ColumnDesc& casa::ColumnDescSet::addColumn ( const ColumnDesc ,
const String newname 
) [private]

Add a column with another name.

An exception is thrown if a column with this name already exists.

Bool casa::ColumnDescSet::allExist ( const ColumnDescSet ,
Bool equalDataTypes 
) const [private]

Test if all columns are part of the other set.

The flag equalDataTypes is set to True if the data types of the columns in both sets are the same.

Check recursevily if the descriptions of all subtables are known.

Referenced by casa::TableDesc::checkSubTableDesc().

void casa::ColumnDescSet::getFile ( AipsIO ,
const TableAttr  
) [private]

Get the object.

Bool casa::ColumnDescSet::isDefined ( const String name) const [inline]

Test if a column is defined in this set.

Definition at line 112 of file ColDescSet.h.

References cols_p, and casa::SimpleOrderedMap< K, V >::isDefined().

Referenced by casa::TableDesc::isColumn().

Test if this and the other column set are disjoint.

Bool casa::ColumnDescSet::isEqual ( const ColumnDescSet other,
Bool equalDataTypes 
) const

Test if this set equals another one.

It is equal if the number of columns is equal and all field names in this set occur in the other too. The order of the columns is not important.
The flag equalDataTypes is set to True if the data types of all columns match.

Bool casa::ColumnDescSet::isStrictSubset ( const ColumnDescSet other,
Bool equalDataTypes 
) const

Test if this set is a strict subset of another one, thus if it is a subset and not equal.

Referenced by isStrictSuperset().

Bool casa::ColumnDescSet::isStrictSuperset ( const ColumnDescSet other,
Bool equalDataTypes 
) const [inline]

Test if this set is a strict superset of another one, thus if it is a superset and not equal.

Definition at line 138 of file ColDescSet.h.

References isStrictSubset().

Bool casa::ColumnDescSet::isSubset ( const ColumnDescSet other,
Bool equalDataTypes 
) const

Test if this set is a subset of another one.

It is similar to isEqual above.

Referenced by isSuperset().

Bool casa::ColumnDescSet::isSuperset ( const ColumnDescSet other,
Bool equalDataTypes 
) const [inline]

Test if this set is a superset of another one.

Definition at line 133 of file ColDescSet.h.

References isSubset().

uInt casa::ColumnDescSet::ncolumn ( ) const [inline]

Get nr of columns in this set.

Definition at line 108 of file ColDescSet.h.

References cols_p, and casa::SimpleOrderedMap< K, V >::ndefined().

Referenced by casa::TableDesc::ncolumn().

ColumnDescSet& casa::ColumnDescSet::operator= ( const ColumnDescSet )

Assignment (copy semantics).

ColumnDesc& casa::ColumnDescSet::operator[] ( const String name)

Get a column by its name.

const ColumnDesc& casa::ColumnDescSet::operator[] ( const String name) const [inline]

Definition at line 95 of file ColDescSet.h.

References casa::name().

ColumnDesc& casa::ColumnDescSet::operator[] ( uInt  index) [inline]

Get a column by its index.

Definition at line 101 of file ColDescSet.h.

References colSeq_p.

const ColumnDesc& casa::ColumnDescSet::operator[] ( uInt  index) const [inline]

Definition at line 103 of file ColDescSet.h.

References colSeq_p.

void casa::ColumnDescSet::putFile ( AipsIO ios,
const TableAttr  
) const [private]

Put the object.

void casa::ColumnDescSet::remove ( const String name) [private]

Remove a column.

An exception is thrown if the column with this name does not exist.

Referenced by casa::TableDesc::removeColumn().

void casa::ColumnDescSet::rename ( const String newname,
const String oldname 
) [private]

Rename a column in the set.

An exception is thrown if the new name already exists or if the old name does not exist.

void casa::ColumnDescSet::show ( ostream &  os) const

Get const access to the column descriptions.

Show the columns in the set.


Friends And Related Function Documentation

friend class TableDesc [friend]

Definition at line 78 of file ColDescSet.h.


Member Data Documentation

The set of all columns.

Definition at line 192 of file ColDescSet.h.

Referenced by isDefined(), and ncolumn().

The order of addition of column descriptions.

Definition at line 196 of file ColDescSet.h.

Referenced by operator[]().


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