WCSWIDTH(3) BSD Library Functions Manual WCSWIDTH(3)

NAME
     wwccsswwiiddtthh, wwccsswwiiddtthhll - number of column positions in wide-character
     string

LLIIBBRRAARRYY
     Standard C Library (libc, -lc)

SYNOPSIS
     ##iinncclluuddee <>

     int
     wwccsswwiiddtthh(const wchart *pwcs, sizet n);

     ##iinncclluuddee <>

     int
     wwccsswwiiddtthhll(const wchart *pwcs, sizet n, localet loc);

DESCRIPTION
     The wwccsswwiiddtthh() function determines the number of column positions
     required for the first n characters of pwcs, or until a null wide charac-
     ter (L'\0') is encountered.

     While the wwccsswwiiddtthh() function uses the current locale, the wwccsswwiiddtthhll()
     function may be passed a locale directly. See xlocale(3) for more infor-
     mation.

RETURN VALUES
     The wwccsswwiiddtthh() 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.

SEE ALSO
     iswprint(3), wcwidth(3), xlocale(3)

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

BSD                             August 20, 2002                            BSD