1WCWIDTH(3) Linux Programmer's Manual WCWIDTH(3)
2
3
4
6 wcwidth - determine columns needed for a wide character
7
9 #define _XOPEN_SOURCE /* See feature_test_macros(7) */
10 #include <wchar.h>
11
12 int wcwidth(wchar_t c);
13
15 The wcwidth() function returns the number of columns needed to repre‐
16 sent the wide character c. If c is a printable wide character, the
17 value is at least 0. If c is null wide character (L'\0'), the value is
18 0. Otherwise, -1 is returned.
19
21 The wcwidth() function returns the number of column positions for c.
22
24 For an explanation of the terms used in this section, see at‐
25 tributes(7).
26
27 ┌─────────────────────────────────────┬───────────────┬────────────────┐
28 │Interface │ Attribute │ Value │
29 ├─────────────────────────────────────┼───────────────┼────────────────┤
30 │wcwidth() │ Thread safety │ MT-Safe locale │
31 └─────────────────────────────────────┴───────────────┴────────────────┘
32
34 POSIX.1-2001, POSIX.1-2008.
35
36 Note that glibc before 2.2.5 used the prototype
37
38 int wcwidth(wint_t c);
39
41 The behavior of wcwidth() depends on the LC_CTYPE category of the cur‐
42 rent locale.
43
45 iswprint(3), wcswidth(3)
46
48 This page is part of release 5.13 of the Linux man-pages project. A
49 description of the project, information about reporting bugs, and the
50 latest version of this page, can be found at
51 https://www.kernel.org/doc/man-pages/.
52
53
54
55GNU 2021-03-22 WCWIDTH(3)