astColumnShapeastColumnShape
-
Returns the shape of the values in a named column
- Description:
- This function
returns the number of dimensions spaned by each value in a named
column of a TableTable, together with the length of each dimension.
These are the values supplied when the column was created using
astAddColumnastAddColumn.
- Synopsis:
- void astColumnShape( AstTable
this, const char
column, int mxdim,
int
ndim, int
dims )
- Parameters:
-
this
-
Pointer to the Table.
-
column
-
The character string holding the upper case name of the column. Trailing
spaces are ignored.
-
mxdim
-
The length of the
"dims" array.
-
ndim
-
Pointer to an int in which to return the
number of dimensions spanned by values in the named column.
This will be zero if the column contains scalar values.
-
dims
-
Pointer to an
array in which to return the length of each dimension. Any
excess trailing elements will be filled with the value 1.
- Notes:
- No error is reported if the requested column cannot be found in the
given Table. A value of zero is returned for
"ndim" and the supplied values in "dims"
are left unchanged.
- A value of zero is returned for
"ndim"
if an error occurs.