WCSWIDTH(3) NEWLIB WCSWIDTH(3)NAME
7.27 `wcswidth'--number of column positions of a wide-character string
SYNOPSIS
#include <wchar.h>
int wcswidth(const wchar_t *PWCS, size_t N);
DESCRIPTION
The `wcswidth' function shall determine the number of column positions
required for N wide-character codes (or fewer than N wide-character
codes if a null wide-character code is encountered before N wide-char‐
acter codes are exhausted) in the string pointed to by PWCS.
RETURNS
The `wcswidth' function either shall return 0 (if PWCS points to a null
wide-character code), or return the number of column positions to be
occupied by the wide-character string pointed to by PWCS, or return -1
(if any of the first N wide-character codes in the wide-character
string pointed to by PWCS is not a printable wide-character code).
PORTABILITY
`wcswidth' has been introduced in the Single UNIX Specification Volume
2. `wcswidth' has been marked as an extension in the Single UNIX Spec‐
ification Volume 3.
SEE ALSOwcswidth is part of the library. The full documentation for is main‐
tained as a Texinfo manual. If info and are properly installed at your
site, the command
info
will give you access to the complete manual.
NEWLIB April 2010 WCSWIDTH(3)