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:

Copyright (C) 2021 East Asian Observatory