TableError.h

Classes

TableError -- Base error class for storage manager (full description)
TableInternalError -- Internal table error (full description)
TableDuplFile -- Table error; table (description) already exists (full description)
TableNoFile -- Table error; table (description) not found (full description)
TableDescNoName -- Table error; no name given to table description (full description)
TableInvOpt -- Table error; invalid table (description) option (full description)
TableInvType -- Table error; table type mismatch (full description)
TableInvColumnDesc -- Table error; invalid column description (full description)
TableInvHyperDesc -- Table error; invalid hypercolumn description (full description)
TableUnknownDesc -- Table error; unknown column description (full description)
TableInvDT -- Table error; invalid data type (full description)
TableInvOper -- Table error; invalid operation (full description)
TableArrayConformanceError -- Table error; non-conformant array (full description)
TableConformanceError -- Table error; table length conformance error (full description)
TableInvSort -- Table error; invalid sort (full description)
TableInvLogic -- Table error; invalid logical operation (full description)
TableInvExpr -- Table error; invalid select expression (full description)
TableVectorNonConform -- Table error; non-conformant table vectors (full description)
TableParseError -- Table error; invalid table command (full description)

class TableError : public AipsError

Interface

Public Members
TableError (Category c=GENERAL)
TableError (const String& message,Category c=GENERAL)
~TableError () throw()

Description

Synopsis

This is the generic StMan exception; catching this one means catching all Table* exceptions. Note that you have to catch AipsError to catch all possible exceptions.

Member Description

TableError (Category c=GENERAL)

The default constructor generates the message "Table error".

TableError (const String& message,Category c=GENERAL)

Construct with given message.

~TableError () throw()

class TableInternalError : public TableError

Interface

TableInternalError (const String& message,Category c=GENERAL)
~TableInternalError () throw()

Description

Synopsis

Internal table error (should never be thrown). If this is thrown, something is terribly wrong.

Member Description

TableInternalError (const String& message,Category c=GENERAL)

Add given message to string "Internal Table error: ".

~TableInternalError () throw()

class TableDuplFile : public TableError

Interface

TableDuplFile (const String& name, Category c=INVALID_ARGUMENT)
TableDuplFile (const String& name, const String& message,Category c=INVALID_ARGUMENT)
~TableDuplFile () throw()

Description

Synopsis

Table (description) with this name already exists.

Member Description

TableDuplFile (const String& name, Category c=INVALID_ARGUMENT)

This constructor generates a message telling that the a table or description with the given name already exists.

TableDuplFile (const String& name, const String& message,Category c=INVALID_ARGUMENT)

This constructor generates a message telling that the a table or description with the given name already exists. The given message is appended to it.

~TableDuplFile () throw()

class TableNoFile : public TableError

Interface

TableNoFile (const String& name,Category c=INVALID_ARGUMENT)
~TableNoFile () throw()

Description

Synopsis

Table (description) with this name could not be found.

Member Description

TableNoFile (const String& name,Category c=INVALID_ARGUMENT)

This constructor generates a message telling that the a table or description with the given name does not exist.

~TableNoFile () throw()

class TableDescNoName : public TableError

Interface

TableDescNoName (Category c=INITIALIZATION)
~TableDescNoName () throw()

Description

Synopsis

No name given for the table description. Only scratch descriptions can have no name (i.e. a blank name).

Member Description

TableDescNoName (Category c=INITIALIZATION)

The default constructor generates the message.

~TableDescNoName () throw()

class TableInvOpt : public TableError

Interface

TableInvOpt (const String& className, const String& message,Category c=INVALID_ARGUMENT)
~TableInvOpt () throw()

Description

Synopsis

Invalid Table(Desc) option given for the table (description).

Member Description

TableInvOpt (const String& className, const String& message,Category c=INVALID_ARGUMENT)

This constructor generates a message that an invalid option has been given. The class name is either Table or TableDesc. The given message will be appended to the total message.

~TableInvOpt () throw()

class TableInvType : public TableError

Interface

TableInvType (const String& typeIn, const String& typeFile, Category c=CONFORMANCE)
~TableInvType () throw()

Description

Synopsis

The given table type (i.e. name of the table description) does not match the type as stored in the table file.

Member Description

TableInvType (const String& typeIn, const String& typeFile, Category c=CONFORMANCE)

This constructor generates a message that the in table type mismatches the table type in the file.

~TableInvType () throw()

class TableInvColumnDesc : public TableError

Interface

TableInvColumnDesc (const String& columnName, const String& message,Category c=INVALID_ARGUMENT)
~TableInvColumnDesc () throw()

Description

Synopsis

The description of a column is invalid. The given default manager is unknown (i.e. not registered in DataManReg.cc).

Member Description

TableInvColumnDesc (const String& columnName, const String& message,Category c=INVALID_ARGUMENT)

This constructor generates a message that the column with the given name has an invalid description.

~TableInvColumnDesc () throw()

class TableInvHyperDesc : public TableError

Interface

TableInvHyperDesc (const String& hypercolumnName, const String& message,Category c=INVALID_ARGUMENT)
~TableInvHyperDesc () throw()

Description

Synopsis

The description of a hypercolumn is invalid. The referenced columns are unknown or invalid. The message explains the reason.

Member Description

TableInvHyperDesc (const String& hypercolumnName, const String& message,Category c=INVALID_ARGUMENT)

This constructor generates a message that the hypercolumn with the given name has an invalid description.

~TableInvHyperDesc () throw()

class TableUnknownDesc : public TableError

Interface

TableUnknownDesc (const String& name,Category c=INITIALIZATION)
~TableUnknownDesc () throw()

Description

Synopsis

To be able to reconstruct the correct column description object from a stored table description, each column description type must register itself (see ColumnDesc.h and ColumnReg.cc).

Member Description

TableUnknownDesc (const String& name,Category c=INITIALIZATION)

This constructor generates a message that the class with the given name is unknown (not registered).

~TableUnknownDesc () throw()

class TableInvDT : public TableError

Interface

TableInvDT (Category c=CONFORMANCE)
TableInvDT (const String& columName,Category c=CONFORMANCE)
~TableInvDT () throw()

Description

Synopsis

Checking of the data type of a column is done at runtime. This error results from non-matching data types when constructing a ScalarColumn or ArrayColumn or from invalid data type promotions when doing a get or put.

Member Description

TableInvDT (Category c=CONFORMANCE)

The default constructor generates a generic "invalid data type" message.

TableInvDT (const String& columName,Category c=CONFORMANCE)

Put the name of the offending column in the "invalid data type" message.

~TableInvDT () throw()

class TableInvOper : public TableError

Interface

TableInvOper (Category c=INVALID_ARGUMENT)
TableInvOper (const String& message,Category c=INVALID_ARGUMENT)
~TableInvOper () throw()

Description

Synopsis

Invalid operation on a table. A request was done that could not be handled by the table system (e.g. sorting on a column containing arrays). The message tells what is wrong.

Invalid operation on a table.

Member Description

TableInvOper (Category c=INVALID_ARGUMENT)

The default constructor generates a generic "invalid operation" message.

TableInvOper (const String& message,Category c=INVALID_ARGUMENT)

Add given message to string "Invalid Table operation: ".

~TableInvOper () throw()

class TableArrayConformanceError : public TableError

Interface

TableArrayConformanceError (const String& message,Category c=CONFORMANCE)
~TableArrayConformanceError () throw()

Description

Synopsis

When putting a direct array, the shape of the array must conform the shape as defined for the table array. When getting an array, the receiving array must be zero-length or it must conform the shape of the table array.

Member Description

TableArrayConformanceError (const String& message,Category c=CONFORMANCE)

This constructor appends ": Table array conformance error" to the given message.

~TableArrayConformanceError () throw()

class TableConformanceError : public TableError

Interface

TableConformanceError (const String& message,Category c=CONFORMANCE)
~TableConformanceError () throw()

Description

Synopsis

When putting a column, the length of the vector must match the length of the table (i.e. its number of rows). When getting a column, the length of the vector must be zero or it must match the length of the table.

Member Description

TableConformanceError (const String& message,Category c=CONFORMANCE)

This constructor appends ": Table conformance error (#rows mismatch)" to the given message.

~TableConformanceError () throw()

class TableInvSort : public TableError

Interface

TableInvSort (Category c=INVALID_ARGUMENT)
TableInvSort (const String& message,Category c=INVALID_ARGUMENT)
~TableInvSort () throw()

Description

Synopsis

Invalid sort operation on a table. A sort can only be done on a scalar column.

Member Description

TableInvSort (Category c=INVALID_ARGUMENT)

The default constructor generates a generic "invalid sort" message.

TableInvSort (const String& message,Category c=INVALID_ARGUMENT)

This constructor appends the given message to the "invalid sort" message.

~TableInvSort () throw()

class TableInvLogic : public TableError

Interface

TableInvLogic (Category c=INVALID_ARGUMENT)
~TableInvLogic () throw()

Description

Synopsis

Invalid logical table operation. When combining tables using a union, difference, etc., the tables involved have to stem from the same root. I.e. they should all refer to the same underlying table.

Member Description

TableInvLogic (Category c=INVALID_ARGUMENT)

The default constructor generates the message.

~TableInvLogic () throw()

class TableInvExpr : public TableError

Interface

TableInvExpr (const String& message,Category c=INVALID_ARGUMENT)
TableInvExpr (const String& columnName, const String& message,Category c=INVALID_ARGUMENT)
~TableInvExpr () throw()

Description

Synopsis

Invalid table select expression. A column is not a scalar or belongs to another table than the table on which the selection will be done.

Member Description

TableInvExpr (const String& message,Category c=INVALID_ARGUMENT)

TableInvExpr (const String& columnName, const String& message,Category c=INVALID_ARGUMENT)

This constructor generates a message containing the name of the offending column. It appends the given message.

~TableInvExpr () throw()

class TableVectorNonConform : public TableError

Interface

TableVectorNonConform (Category c=CONFORMANCE)
~TableVectorNonConform () throw()

Description

Synopsis

Table vectors are not conformant (have different lengths)

Member Description

TableVectorNonConform (Category c=CONFORMANCE)

The default constructor generates the message.

~TableVectorNonConform () throw()

class TableParseError : public TableError

Interface

TableParseError (const String& commandString,Category c=INVALID_ARGUMENT)
~TableParseError () throw()

Description

Synopsis

The parser in TableGram/TableParse found an error in the given table command.

Member Description

TableParseError (const String& commandString,Category c=INVALID_ARGUMENT)

This constructor generates a message containing the table command.

~TableParseError () throw()