putws(3W) — DG/UX R4.11



putws(3W)                         SDK R4.11                        putws(3W)


NAME
       putws, fputws  - put a wchart string on a stream

SYNOPSIS
       #include <stdio.h>
       #include <widec.h>
       int putws(const wchart *s);

       #include <stdio.h>
       #include <wchar.h>
       int fputws(const wchart *s, FILE *stream);

DESCRIPTION
       putws (available only when linking with libw) transforms the wchart
       null-terminated wchart string pointed to by s into a byte string in
       EUC, and writes the string followed by a newline character to stdout.

       fputws transforms the wchart null-terminated wchart string pointed
       to by s into a byte string in EUC, and writes the string to the named
       output stream.

       Neither function writes the terminating wchart null character.

   Errors
       On success, both functions return the number of wchart characters
       transformed and written (not including the newline character in the
       case of putws).  Otherwise they return EOF.

   Considerations for Threads Programming
                     +---------+-----------------------------+
                     |         |                      async- |
                     |function | reentrant   cancel   cancel |
                     |         |             point     safe  |
                     +---------+-----------------------------+
                     |fputws   |     Y         N        N    |
                     |putws    |     N         -        -    |
                     +---------+-----------------------------+
REFERENCES
       reentrant(3), ferror(3S), fopen(3S), fread(3S), printf(3S),
       stdio(3S), putwc(3W)

NOTICES
       putws appends a newline character while fputws does not.


Licensed material--property of copyright holder(s)
Museum
