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-character 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 Specification Volume 3.

SEE ALSO
wcswidth is part of the library. The full documentation for is maintained as a Texinfo manual. If info and are properly installed at your site, the command

    info

will give you access to the complete manual.