manpagez: man pages & more
man wcswidth(3)
Home | html | info | man
wcswidth(3)              BSD 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 <wchar.h>
     #include <xlocale.h>

     int
     wcswidth_l(const wchar_t *pwcs, size_t n, locale_t loc);


DESCRIPTION

     The wcswidth() 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.

     Although the wcswidth() function uses the current locale, the
     wcswidth_l() function may be passed a locale directly. See xlocale(3) for
     more information.


RETURN VALUES

     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.


SEE ALSO

     iswprint(3), wcwidth(3), xlocale(3)


STANDARDS

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

BSD                             August 20, 2002                            BSD

Mac OS X 10.8 - Generated Fri Aug 31 19:27:51 CDT 2012
© manpagez.com 2000-2024
Individual documents may contain additional copyright information.