Next: AST_PUTFITS - Store a FITS header card in a FitsChan
Up: AST Routine Descriptions
Previous: AST_PUTCARDS - Store a set of FITS header cards in a FitsChan
AST_PUTCOLUMNDATA
-
Retrieve all the data values stored in a column
- Description:
- This routine
copies data values from a supplied buffer into a named column. The
first element in the buffer becomes the first element in the first
row of the column. If the buffer does not completely fill the
column, then any trailing rows are filled with null values.
- Invocation:
- CALL AST_PUTCOLUMNDATA( THIS, COLUMN, CLEN, SIZE, COLDATA, STATUS )
- Arguments:
-
THIS = INTEGER (Given)
-
Pointer to the FitsTable.
-
COLUMN = CHARACTER
(
) (Given)
-
The character string holding the name of the column. Trailing
spaces are ignored.
-
CLEN = INTEGER (Given)
-
If the column holds character strings, then this must be set to
the length of each fixed length string in the supplied array.
This is often determined by the appropriate TFORMn keyword in
the binary table header. The supplied value is ignored if the
column does not hold character data.
-
SIZE = INTEGER (Given)
-
The size of the
COLDATA
array, in bytes. This should be an integer multiple of the
number of bytes needed to hold the full vector value stored in a
single cell of the column. An error is reported if this is not
the case.
-
COLDATA(
) = BYTE (Given)
-
An
area of memory holding the data to copy into the column. The values
should be stored in row order. If the column holds non-scalar values,
the elements of each value should be stored in "Fortran" order. No
data type conversion is performed.
-
STATUS = INTEGER (Given and Returned)
-
The global status.
Next: AST_PUTFITS - Store a FITS header card in a FitsChan
Up: AST Routine Descriptions
Previous: AST_PUTCARDS - Store a set of FITS header cards in a FitsChan
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