1 .\" Copyright (c) Bruno Haible <haible@clisp.cons.org>
3 .\" %%%LICENSE_START(GPLv2+_DOC_ONEPARA)
4 .\" This is free documentation; you can redistribute it and/or
5 .\" modify it under the terms of the GNU General Public License as
6 .\" published by the Free Software Foundation; either version 2 of
7 .\" the License, or (at your option) any later version.
10 .\" References consulted:
11 .\" GNU glibc-2 source code and manual
12 .\" Dinkumware C library reference http://www.dinkumware.com/
13 .\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html
15 .TH WCWIDTH 3 2014-01-22 "GNU" "Linux Programmer's Manual"
17 wcwidth \- determine columns needed for a wide character
20 .BR "#define _XOPEN_SOURCE" " /* See feature_test_macros(7) */"
23 .BI "int wcwidth(wchar_t " c );
28 function returns the number of columns
29 needed to represent the wide character
33 is a printable wide character, the value
37 is null wide character (L\(aq\\0\(aq), the value is 0.
38 Otherwise, \-1 is returned.
42 function returns the number of
46 .SS Multithreading (see pthreads(7))
49 function is thread-safe with exceptions.
50 It can be safely used in multithreaded applications, as long as
52 is not called to change the locale during its execution.
56 Note that glibc before 2.2.5 used the prototype
59 .BI "int wcwidth(wint_t " c );
72 This page is part of release 3.79 of the Linux
75 A description of the project,
76 information about reporting bugs,
77 and the latest version of this page,
79 \%http://www.kernel.org/doc/man\-pages/.