Standard C Library Functions                         wcswidth(3C)



NAME
     wcswidth - number of column positions  of  a  wide-character
     string

SYNOPSIS
     #include 

     int wcswidth(const wchart *pwcs, sizet 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).

ERORS
     No errors are defined.

ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     CSI                          Enabled                     
    
     Interface Stability          Standard                    
    
     MT-Level                     MT-Safe with exceptions     
    


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








SunOS 5.11          Last change: 14 Aug 2002                    1