next up previous 264
Next: AST_CONVERT - Determine how to convert between two coordinate systems
Up: AST Routine Descriptions
Previous: AST_COLUMNSHAPE - Returns the shape of the values in a named column


AST_COLUMNSIZE - Get the number of bytes needed to hold a full column of data

Description:
This function returns the number of bytes of memory that must be allocated prior to retrieving the data from a column using AST_GETCOLUMNDATA.
Invocation:
RESULT = AST_COLUMNSIZE( THIS, COLUMN, STATUS )
Arguments:
THIS = INTEGER (Given)
Pointer to the Table.
COLUMN = CHARACTER $*$ ( $*$ ) (Given)
The character string holding the name of the column. Trailing spaces are ignored.
STATUS = INTEGER (Given and Returned)
The global status.
Returned Value:
AST_COLUMNNULL = INTEGER
The number of bytes required to store the column data.
Notes:
  • An error will be reported if the named column does not exist in the FitsTable.

  • Zero will be returned as the function value in an error occurs.


next up previous 264
Next: AST_CONVERT - Determine how to convert between two coordinate systems
Up: AST Routine Descriptions
Previous: AST_COLUMNSHAPE - Returns the shape of the values in a named column

AST A Library for Handling World Coordinate Systems in Astronomy
Starlink User Note 210
R.F. Warren-Smith & D.S. Berry
24th May 2011
E-mail:ussc@star.rl.ac.uk

Copyright (C) 2009 Science \& Technology Facilities Council