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

Review Status

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

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

Review Status

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

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

Review Status

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

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

Review Status

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

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

Review Status

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

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

Review Status

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

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

Review Status

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

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

Review Status

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

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

Review Status

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

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

Review Status

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

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

Review Status

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

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

Review Status

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

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

Review Status

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

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

Review Status

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

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

Review Status

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

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

Review Status

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

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

Review Status

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

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

Review Status

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

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

Review Status

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

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()