NAME
wcswidth,
wcswidth_l —
number of column positions in
wide-character string
LIBRARY
library “libc”
SYNOPSIS
#include
<wchar.h>
int
wcswidth(const
wchar_t *pwcs, size_t
n);
#include
<xlocale.h>
int
wcswidth_l(const
wchar_t *pwcs, size_t
n, locale_t
locale);
DESCRIPTION
Thewcswidth()
and wcswidth_l() functions determine the number of
column positions required for the first n characters of
pwcs, or until a null wide character (L'\0') is
encountered.
The
wcswidth_l()
function takes an explicit locale argument, whereas
the wcswidth() function uses the current global or
per-thread locale.
RETURN VALUES
The wcswidth() and
wcswidth_l() functions return 0 if
pwcs is an empty string (L""), -1 if a
non-printing wide character is encountered, otherwise they return the number
of column positions occupied.
SEE ALSO
STANDARDS
The wcswidth() function conforms to
IEEE Std 1003.1-2001 (“POSIX.1”).