NAME    [Toc]    [Back]

     wcwidth -- number of column positions of a wide-character code

LIBRARY    [Toc]    [Back]

     Standard C Library (libc, -lc)

SYNOPSIS    [Toc]    [Back]

     #include <wchar.h>

     int
     wcwidth(wchar_t wc);

DESCRIPTION    [Toc]    [Back]

     The wcwidth() function determines the number of column positions required
     to display the wide character wc.

RETURN VALUES    [Toc]    [Back]

     The wcwidth() function returns 0 if the wc argument is a null wide character
 (L'\0'), -1 if wc is not printable, otherwise it returns the number
     of column positions the character occupies.

EXAMPLES    [Toc]    [Back]

     This code fragment reads text from standard input and breaks lines that
     are more than 20 column positions wide, similar to the fold(1) utility:

	   wint_t ch;
	   int column, w;

	   column = 0;
	   while ((ch = getwchar()) != WEOF) {
		   if ((w = wcwidth(ch)) > 0)
			   column += w;
		   if (column >= 20) {
			   putwchar(L'\n');
			   column = 0;
		   }
		   putwchar(ch);
		   if (ch == L'\n')
			   column = 0;
	   }

SEE ALSO    [Toc]    [Back]

     iswprint(3), wcswidth(3)

STANDARDS    [Toc]    [Back]

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


FreeBSD 5.2.1			October 3, 2002 		 FreeBSD 5.2.1