next up previous 264
Next: AST_PUTTABLE - Store a single FitsTable in a FitsChan
Up: AST Routine Descriptions
Previous: AST_PUTFITS - Store a FITS header card in a FitsChan


AST_PUTLINE - Store a text line read by a Channel source routine

Description:
This routine should only be used when implementing a routine which will be passed as the SOURCE argument to AST_CHANNEL. It should be used to pass back (to the AST library) each line of text read from the external data source. One such line should be passed back in this way for each invocation of the source routine.
Invocation:
CALL AST_PUTLINE( LINE, L, STATUS )
Arguments:
LINE = CHARACTER $*$ ( $*$ ) (Given)
A character string containing the line of input text which has been read.
L = INTEGER (Given)
The number of characters in the input line, which may be zero. If there is no more input available (e.g. an end of file has been reached), this value should be set negative and this will terminate the read operation on the Channel.
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 264
Next: AST_PUTTABLE - Store a single FitsTable in a FitsChan
Up: AST Routine Descriptions
Previous: AST_PUTFITS - Store a FITS header card 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