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:

Copyright (C) 2021 East Asian Observatory