1 .\" Copyright (c) Bruno Haible <haible@clisp.cons.org>
3 .\" This is free documentation; you can redistribute it and/or
4 .\" modify it under the terms of the GNU General Public License as
5 .\" published by the Free Software Foundation; either version 2 of
6 .\" the License, or (at your option) any later version.
8 .\" References consulted:
9 .\" GNU glibc-2 source code and manual
10 .\" Dinkumware C library reference http://www.dinkumware.com/
11 .\" OpenGroup's Single Unix specification http://www.UNIX-systems.org/online.html
13 .TH WCWIDTH 3 1999-07-25 "GNU" "Linux Programmer's Manual"
15 wcwidth \- determine columns needed for a wide character
18 .B #define _XOPEN_SOURCE
21 .BI "int wcwidth(wchar_t " c );
24 The \fBwcwidth\fP() function returns the number of columns
25 needed to represent the wide character \fIc\fP.
26 If \fIc\fP is a printable wide character, the value
28 If \fIc\fP is L'\\0', the value is 0. Otherwise \-1 is returned.
30 The \fBwcwidth\fP() function returns the number of
31 column positions for \fIc\fP.
35 Note that glibc before 2.2.5 used the prototype
38 .BI "int wcwidth(wint_t " c );
41 The behaviour of \fBwcwidth\fP() depends on the LC_CTYPE category of the
46 .BR feature_test_macros (7)