Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ fputws(3S) — SunOS 5.6

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

exit(2)

abort(3C)

fclose(3S)

fflush(3S)

fopen(3S)

fputwc(3S)

attributes(5)

fputws(3S)

NAME

fputws − put wide character string on a stream

SYNOPSIS

#include <stdio.h>
#include <wchar.h>

int fputws(const wchar_t ∗s, FILE ∗stream);

DESCRIPTION

The fputws() function writes a character string corresponding 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.

The st_ctime and st_mtime 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(3S) or fclose(3S) on the same stream or a call to exit(2) or abort(3C). 

RETURN VALUES

Upon successful completion, fputws() returns a non-negative number.  Otherwise it returns −1, sets an error indicator for the stream and errno is set to indicate the error. 

ERRORS

Refer to fputwc(3S). 

USAGE

The fputws() function does not append a NEWLINE character. 

ATTRIBUTES

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE ATTRIBUTE VALUE
MT-Level MT-Safe

SEE ALSO

exit(2), abort(3C), fclose(3S), fflush(3S), fopen(3S), fputwc(3S), attributes(5)

SunOS 5.6  —  Last change: 22 Apr 1997

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026