DragonFly On-Line Manual Pages

WCSWIDTH(3)           DragonFly Library Functions Manual           WCSWIDTH(3)

NAME
     wcswidth, wcswidth_l -- number of column positions in wide-character
     string

LIBRARY
     Standard C Library (libc, -lc)

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
     The wcswidth() 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
     iswprint(3), wcwidth(3), xlocale(3)

STANDARDS
     The wcswidth() function conforms to IEEE Std 1003.1-2001 (``POSIX.1'').

DragonFly 3.7                  December 27, 2013                 DragonFly 3.7