Standard C Library Functions                           fputws(3C)



NAME
     fputws - put wide character string on a stream

SYNOPSIS
     #include 
     #include 

     int fputws(const wchart *restrict s, FILE *restrict stream);


DESCRIPTION
     The fputws() function writes a character string  correspond-
     ing  to  the (null-terminated) wide character string pointed
     to by ws to the stream pointed to by  stream.  No  character
     corresponding to the terminating null wide-character code is
     written, nor is a NEWLINE character appended.


     The stctime and stmtime fields of the file will be  marked
     for  update between the successful execution of fputws() and
     the next successful completion of a call  to  fflush(3C)  or
     fclose(3C)  on  the  same  stream  or  a  call to exit(2) or
     abort(3C).

RETURN VALUES
     Upon successful completion, fputws() returns a  non-negative
     value. Otherwise, it returns -1, sets an error indicator for
     the stream, and sets errno to indicate the error.

ERORS
     Refer to fputwc(3C).

ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     
     ATRIBUTE TYPE               ATRIBUTE VALUE             
    
     Interface Stability          Standard                    
    
     MT-Level                     MT-Safe                     
    


SEE ALSO
     exit(2),  abort(3C),  fclose(3C),   fflush(3C),   fopen(3C),
     fputwc(3C), attributes(5), standards(5)





SunOS 5.11           Last change: 1 Nov 2003                    1