next up previous
Next: AST_GETMAPPING - Obtain a Mapping that converts between two Frames in a FrameSet
Up: AST Routine Descriptions
Previous: AST_GETFRAME - Obtain a pointer to a specified Frame in a FrameSet

   
AST_GETLINE - Obtain text to be written by a Channel sink routine

Description:
This routine should only be used when implementing a routine which will be passed as the SINK argument to AST_CHANNEL. It should be used to obtain (from the AST library) each line of text which is to be written to the external data sink. One such line should be obtained in this way for each invocation of the sink routine.

Invocation:
CALL AST_GETLINE( LINE, L, STATUS )

Arguments:
LINE = CHARACTER * ( * ) (Returned)
The line of text to be written. Depending on the length of character variable supplied, the returned text may be truncated if necessary. Note, however, that it will not be padded with blanks in order to fill this variable.
L = INTEGER (Returned)
The number of characters returned, which may be zero. Note that characters beyond the L'th character in the LINE variable are not modified and may therefore contain junk.
STATUS = INTEGER (Given and Returned)
The global status.

Notes:
  • This routine is only available in the Fortran interface to the AST library.



next up previous
Next: AST_GETMAPPING - Obtain a Mapping that converts between two Frames in a FrameSet
Up: AST Routine Descriptions
Previous: AST_GETFRAME - Obtain a pointer to a specified Frame in a FrameSet

AST A Library for Handling World Coordinate Systems in Astronomy
Starlink User Note 210
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