wcswidth(3C)						   Standard C Library Functions 					      wcswidth(3C)

NAME

       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 determines 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.

RETURN VALUES

       The wcswidth() function either returns 0 (if pwcs points to a null wide-character code), or returns the number of column  positions  to	be
       occupied  by  the wide-character string pointed to by pwcs, or returns -1 (if any of the first n wide-character codes in the wide-character
       string pointed to by pwcs is not a printing wide-character code).

ERRORS

       No errors are defined.

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |CSI			     |Enabled			   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Standard			   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |MT-Safe with exceptions	   |
       +-----------------------------+-----------------------------+

SEE ALSO

       setlocale(3C), wcwidth(3C), attributes(5), standards(5)

SunOS 5.10							    14 Aug 2002 						      wcswidth(3C)