WCSWIDTH(3) | Library Functions Manual | WCSWIDTH(3) |
wcswidth
,
wcswidth_l
— number of
column positions in wide-character string
Standard C Library (libc, -lc)
#include
<wchar.h>
int
wcswidth
(const wchar_t *pwcs,
size_t n);
#include <wchar.h>
#include <xlocale.h>
int
wcswidth_l
(const wchar_t *pwcs,
size_t n, locale_t loc);
The
wcswidth
()
function determines the number of column positions required for the first
n characters of pwcs, or until a
null wide character (L'\0') is encountered.
Although the
wcswidth
()
function uses the current locale, the
wcswidth_l
()
function may be passed a locale directly. See
xlocale(3) for more information.
The wcswidth
() function returns 0 if
pwcs is an empty string (L""), -1 if a
non-printing wide character is encountered; otherwise, it returns the number
of column positions occupied.
The wcswidth
() function conforms to
IEEE Std 1003.1-2001 (“POSIX.1”).
August 20, 2002 | macOS 14.6 |