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: 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