next up previous
Next: astRemapFrame - Modify a Frame's relationship to other Frames in a FrameSet
Up: AST Function Descriptions
Previous: astPutFits - Store a FITS header card in a FitsChan

astRead - Read an Object from a Channel   

Description:
This function reads the next Object from a Channel and returns a pointer to the new Object.

Synopsis:
AstObject *astRead( AstChannel *this )

Parameters:
this
Pointer to the Channel.

Returned Value:
astRead()
A pointer to the new Object. The class to which this will belong is determined by the input data, so is not known in advance.

Notes:
  • A null Object pointer (AST__NULL) will be returned, without error, if the Channel contains no further Objects to be read.
  • A null Object pointer will also be returned if this function is invoked with the AST error status set, or if it should fail for any reason.



next up previous
Next: astRemapFrame - Modify a Frame's relationship to other Frames in a FrameSet
Up: AST Function Descriptions
Previous: astPutFits - Store a FITS header card in a FitsChan

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

Copyright (C) 2003 Central Laboratory of the Research Councils