vfmt_ws2() — Apollo

VFMT_$WS2                         Domain/OS                          VFMT_$WS2


NAME
     vfmt_$ws2 - formatted write to a stream

SYNOPSIS (C)
     #include <apollo/base.h>
     #include <apollo/vfmt.h>

     void vfmt_$ws2(
          ios_$id_t &stream_id,
          char *control_string,
          ...)

SYNOPSIS (Pascal)
     %include '/sys/ins/base.ins.pas';
     %include '/sys/ins/vfmt.ins.pas';

     procedure vfmt_$ws2(
          in stream_id: ios_$id_t;
          in control_string: univ vfmt_$string_t;
          in a1, a2: univ vfmt_$generic_signed_arg);

SYNOPSIS (FORTRAN)
     %include '/sys/ins/base.ins.ftn'
     %include '/sys/ins/vfmt.ins.ftn'

           integer*2 nchar
           parameter (nchar = 128)

           integer*2 stream_id
           character control_string*(nchar)
           integer*4 a1, a2

           call vfmt_$ws2(stream_id, control_string, a1, a2)

DESCRIPTION
     Vfmt_$ws2 encodes up to two source variables into an ASCII string whose
     format is defined by control_string, and writes the result to the stream
     specified by stream_id.

     stream_id
          The stream ID of the stream to write to.

     control_string
          A VFMT format string defining how to format the source variables.

     a1, a2
          Up to two source variables containing data to encode into ASCII.

NOTES
     A string field in control_string requires two source variables:  a char-
     acter array containing the value of the string, and a 2-byte integer
     variable specifying the number of bytes in the string.

SEE ALSO
     vfmt_$ws, vfmt_$ws10, vfmt_$ws5.
Museum
