Museum

SYSCALLS/VFMT - variable format package calls     82/01/04


Include files:

    Fortran:    /sys/ins/vfmt.ins.ftn
    Pascal:     /sys/ins/vfmt.ins.pas


Procedures and Functions:

    vfmt_$decode{n} (control, text, textlen, n_tokens, status, a1, ...an),
                     col = ...
        Decodes the text string (of length "textlen") into the supplied
        variables.  Function value is the column number where an error
        was detected.  "n" may be 2, 5, or 10.

    vfmt_$encode{n} (control, text, maxlen, textlen, a1, ...an)
        Encodes data from the control string and variables into "text" (whose
        maximum length in "maxlen" and actual length is returned in "textlen").

    vfmt_$read{n} (control, n_tokens, status, a1, ...an)
        Reads a record from the standard input stream and decodes it according
        to the control string.  "n" may be 2, 5, or 10.

    vfmt_$rs{n} (strid, control, n_tokens, status, a1, ...an)
        Same as vfmt_$read{n}, but reads a record from the specified stream.

    vfmt_$write{n} (control, a1, ...an)
        Writes one or more records to the standard output stream according
        to the specified control string and variable arguments.  "n" may be
        2, 5, or 10.

    vfmt_$ws{n} (strid, control, a1, ...an)
        Same as vfmt_$write{n}, but writes to the specified stream.


Control Summaries:

     Summary of Directives
     ---------------------

     %"     declare characters to be used as field delimiters
     %$     end control string
     %.     end control string, inserting new line character
     %%     output a single %
     %(     begin repeat range
     %)     end repeat range
     %/     insert new line character
     %A     encode/decode ASCII
     %F     encode/decode floating point
     %E     encode scientific floating point
     %D     encode/decode decimal
     %H     encode/decode hexadecimal
     %O     encode/decode octal
     %T     tab to certain column
     %X     skip columns


    Encoding Integer Numerical Data:

        %  [fw]  [Z]  [J]  [U | S | P]  [W | L]  {O | D | H}


    Encoding Floating Point Numerical Data:

        % [fw.dw | fw] [Z] [J] [S | P] [W | L] {F | E}


    Encoding ASCII Data:

        %  [fw]  [M length]  [Z]  [U | L]  A


    Decoding Integer Numeric Data:

        %  [fw]  [E]  [U | S]  [W | L]  {O | D | H}


    Decoding Floating Point Numeric Data:

        % [fw] [E] [S] [W | L] F


    Decoding ASCII Data:

        %  [fw]  [E]  [M length]  [K]  [Z]  [U | L]  A