putws(3)                                                       putws(3)

  fputws()

  NAME

    fputws(), putws() - output a wide-character line to a stream

  SYNOPSIS

    #include 
    #include 

    int fputws (const wchar_t *str, FILE *stream)
    int putws (const wchar_t *str)

  DESCRIPTION

    The function fputws(3) writes the wide-character string pointed to by str
    to the stream pointed to by stream.

    The function putws(3) writes the wide-character string str and a
    terminating newline character, to the stream stdout.

  RETURN VALUES

    The fputws(3) function returns 0 on success and WEOF on error; putws(3)
    returns a nonnegative integer on success and WEOF on error.

  ERRORS

    fputws(3) and putws(3) can fail and set errno to the following values:

    [EBADF]
        The stream is not a writable stream.

    [EPIPE]
        An attempt is made to write to a pipe that is not open for reading by
        any process.

    [EFBIG]
        An attempt was made to write a file that exceeds the process's file
        size limit or the maximum file size.

    [EFAULT]
        Part of the data to be written to the file points outside the
        process's allocated address space.

    [EINVAL]
        The pointer associated with stream was negative.

    [ENOSPC]
        There is no free space remaining on the file system containing the
        file.

    [EIO]
        An I/O error occurred while reading from or writing to the file
        system.

    [EAGAIN]
        The file was marked for non-blocking I/O, and no data could be written
        immediately.

  SEE ALSO

    putwc(3)

    ferror(3)

  USAGE NOTES

    All of these functions are thread safe.

    None of these functions are async-signal safe.