fputws(3)

fputws3

Output a line of wide characters to a stream

Usage

#include <stdio.h>

#include <wchar.h>

int

fputws(const wchar_t *restrict ws, FILE *restrict stream);

#include <stdio.h>

#include <wchar.h>

#include <xlocale.h>

int

fputws_l(const wchar_t *restrict ws, FILE *restrict stream, locale_t loc);

Library

Standard C Library (libc, -lc)

Overview

The fputws() function writes the wide character string pointed to by ws to the stream pointed to by stream.

Although the fputws() function uses the current locale, the fputws_l() function may be passed a locale directly. See xlocale(3) for more information.

Return values

The fputws() function returns 0 on success and -1 on error.

Errors

The fputws() function will fail if:

[EBADF]

The stream argument supplied is not a writable stream.

The fputws() function may also fail and set errno for any of the errors specified for the routine write(2).

Releases

145 releases since Mac OS X 10.3; the text changed 2 times.

  1. 10.3–10.4.11
  2. 10.5–10.6.8
  3. 10.7–26.5

Standards

The fputws() function conforms to IEEE Std 1003.1-2001 (“POSIX.1”).

From Libc 1752.120.2 in macOS 26.5. Parsed by carta from the page's mdoc source.