formline
picture
,
variables
Internal function used by formats, although you may
also call it. It formats a
list of values (
variables
) according to the contents of
picture
,
placing the
output into the format output accumulator,
$^A
.
When a
write
is done, the contents of
$^A
are written to
some filehandle, but you could also read
$^A
yourself
and set
$^A
back to
""
. Note that a format typically does
one
formline
per line of form, but the
formline
function
itself doesn't care how many newlines are embedded in the
picture
.
This means that the
~
and
~~
tokens will treat the
entire
picture
as a single line. Thus, you may need to use
multiple formlines to implement a single record-format, like the
format compiler.
Be careful if you put double quotes around the picture, since an
@
character may be taken to mean the beginning of an array name.
formline
always returns true.
See
Section 4.10, "Formats"
in
Chapter 4
for more information.