1 # SOME DESCRIPTIVE TITLE
2 # Copyright (C) YEAR Free Software Foundation, Inc.
3 # This file is distributed under the same license as the PACKAGE package.
4 # FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
9 "Project-Id-Version: PACKAGE VERSION\n"
10 "POT-Creation-Date: 2012-03-22 04:26+0900\n"
11 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
12 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
13 "Language-Team: LANGUAGE <LL@li.org>\n"
16 "Content-Type: text/plain; charset=CHARSET\n"
17 "Content-Transfer-Encoding: 8bit\n"
20 #: build/C/man3/btowc.3:14
26 #: build/C/man3/btowc.3:14 build/C/man3/wctob.3:14
32 #: build/C/man3/btowc.3:14 build/C/man3/fgetws.3:16 build/C/man3/fputws.3:14 build/C/man3/fwide.3:14 build/C/man3/getwchar.3:15 build/C/man3/mbrlen.3:14 build/C/man3/mbrtowc.3:15 build/C/man3/mbsinit.3:14 build/C/man3/mbsnrtowcs.3:13 build/C/man3/mbsrtowcs.3:14 build/C/man3/putwchar.3:15 build/C/man3/ungetwc.3:14 build/C/man3/wcpcpy.3:13 build/C/man3/wcpncpy.3:13 build/C/man3/wcrtomb.3:14 build/C/man3/wcscasecmp.3:13 build/C/man3/wcscat.3:14 build/C/man3/wcschr.3:14 build/C/man3/wcscmp.3:14 build/C/man3/wcscpy.3:14 build/C/man3/wcscspn.3:14 build/C/man3/wcsdup.3:13 build/C/man3/wcslen.3:14 build/C/man3/wcsncasecmp.3:13 build/C/man3/wcsncat.3:14 build/C/man3/wcsncmp.3:14 build/C/man3/wcsncpy.3:14 build/C/man3/wcsnlen.3:13 build/C/man3/wcsnrtombs.3:13 build/C/man3/wcspbrk.3:14 build/C/man3/wcsrchr.3:14 build/C/man3/wcsrtombs.3:14 build/C/man3/wcsspn.3:14 build/C/man3/wcsstr.3:14 build/C/man3/wcstok.3:14 build/C/man3/wcswidth.3:13 build/C/man3/wctob.3:14 build/C/man3/wcwidth.3:13 build/C/man3/wmemchr.3:14 build/C/man3/wmemcmp.3:13 build/C/man3/wmemcpy.3:14 build/C/man3/wmemmove.3:14 build/C/man3/wmemset.3:14
38 #: build/C/man3/btowc.3:14 build/C/man3/fgetws.3:16 build/C/man3/fputws.3:14 build/C/man3/fwide.3:14 build/C/man3/getwchar.3:15 build/C/man3/mbrlen.3:14 build/C/man3/mbrtowc.3:15 build/C/man3/mbsinit.3:14 build/C/man3/mbsnrtowcs.3:13 build/C/man3/mbsrtowcs.3:14 build/C/man3/putwchar.3:15 build/C/man3/ungetwc.3:14 build/C/man3/wcpcpy.3:13 build/C/man3/wcpncpy.3:13 build/C/man3/wcrtomb.3:14 build/C/man3/wcscasecmp.3:13 build/C/man3/wcscat.3:14 build/C/man3/wcschr.3:14 build/C/man3/wcscmp.3:14 build/C/man3/wcscpy.3:14 build/C/man3/wcscspn.3:14 build/C/man3/wcsdup.3:13 build/C/man3/wcslen.3:14 build/C/man3/wcsncasecmp.3:13 build/C/man3/wcsncat.3:14 build/C/man3/wcsncmp.3:14 build/C/man3/wcsncpy.3:14 build/C/man3/wcsnlen.3:13 build/C/man3/wcsnrtombs.3:13 build/C/man3/wcspbrk.3:14 build/C/man3/wcsrchr.3:14 build/C/man3/wcsrtombs.3:14 build/C/man3/wcsspn.3:14 build/C/man3/wcsstr.3:14 build/C/man3/wcstoimax.3:23 build/C/man3/wcstok.3:14 build/C/man3/wcswidth.3:13 build/C/man3/wctob.3:14 build/C/man3/wcwidth.3:13 build/C/man3/wmemchr.3:14 build/C/man3/wmemcmp.3:13 build/C/man3/wmemcpy.3:14 build/C/man3/wmemmove.3:14 build/C/man3/wmemset.3:14
40 msgid "Linux Programmer's Manual"
44 #: build/C/man3/btowc.3:15 build/C/man3/fgetws.3:17 build/C/man3/fputws.3:15 build/C/man3/fwide.3:15 build/C/man3/getwchar.3:16 build/C/man3/mbrlen.3:15 build/C/man3/mbrtowc.3:16 build/C/man3/mbsinit.3:15 build/C/man3/mbsnrtowcs.3:14 build/C/man3/mbsrtowcs.3:15 build/C/man3/putwchar.3:16 build/C/man3/ungetwc.3:15 build/C/man3/wcpcpy.3:14 build/C/man3/wcpncpy.3:14 build/C/man3/wcrtomb.3:15 build/C/man3/wcscasecmp.3:14 build/C/man3/wcscat.3:15 build/C/man3/wcschr.3:15 build/C/man3/wcscmp.3:15 build/C/man3/wcscpy.3:15 build/C/man3/wcscspn.3:15 build/C/man3/wcsdup.3:14 build/C/man3/wcslen.3:15 build/C/man3/wcsncasecmp.3:14 build/C/man3/wcsncat.3:15 build/C/man3/wcsncmp.3:15 build/C/man3/wcsncpy.3:15 build/C/man3/wcsnlen.3:14 build/C/man3/wcsnrtombs.3:14 build/C/man3/wcspbrk.3:15 build/C/man3/wcsrchr.3:15 build/C/man3/wcsrtombs.3:15 build/C/man3/wcsspn.3:15 build/C/man3/wcsstr.3:15 build/C/man3/wcstoimax.3:24 build/C/man3/wcstok.3:15 build/C/man3/wcswidth.3:14 build/C/man3/wctob.3:15 build/C/man3/wcwidth.3:14 build/C/man3/wmemchr.3:15 build/C/man3/wmemcmp.3:14 build/C/man3/wmemcpy.3:15 build/C/man3/wmemmove.3:15 build/C/man3/wmemset.3:15
50 #: build/C/man3/btowc.3:17
51 msgid "btowc - convert single byte to wide character"
55 #: build/C/man3/btowc.3:17 build/C/man3/fgetws.3:19 build/C/man3/fputws.3:17 build/C/man3/fwide.3:17 build/C/man3/getwchar.3:18 build/C/man3/mbrlen.3:17 build/C/man3/mbrtowc.3:18 build/C/man3/mbsinit.3:17 build/C/man3/mbsnrtowcs.3:16 build/C/man3/mbsrtowcs.3:17 build/C/man3/putwchar.3:18 build/C/man3/ungetwc.3:17 build/C/man3/wcpcpy.3:16 build/C/man3/wcpncpy.3:17 build/C/man3/wcrtomb.3:17 build/C/man3/wcscasecmp.3:16 build/C/man3/wcscat.3:17 build/C/man3/wcschr.3:17 build/C/man3/wcscmp.3:17 build/C/man3/wcscpy.3:17 build/C/man3/wcscspn.3:17 build/C/man3/wcsdup.3:16 build/C/man3/wcslen.3:17 build/C/man3/wcsncasecmp.3:16 build/C/man3/wcsncat.3:17 build/C/man3/wcsncmp.3:17 build/C/man3/wcsncpy.3:17 build/C/man3/wcsnlen.3:16 build/C/man3/wcsnrtombs.3:16 build/C/man3/wcspbrk.3:17 build/C/man3/wcsrchr.3:17 build/C/man3/wcsrtombs.3:17 build/C/man3/wcsspn.3:18 build/C/man3/wcsstr.3:17 build/C/man3/wcstoimax.3:26 build/C/man3/wcstok.3:17 build/C/man3/wcswidth.3:16 build/C/man3/wctob.3:17 build/C/man3/wcwidth.3:16 build/C/man3/wmemchr.3:17 build/C/man3/wmemcmp.3:16 build/C/man3/wmemcpy.3:17 build/C/man3/wmemmove.3:17 build/C/man3/wmemset.3:17
61 #: build/C/man3/btowc.3:20 build/C/man3/fgetws.3:22 build/C/man3/fputws.3:20 build/C/man3/fwide.3:20 build/C/man3/getwchar.3:21 build/C/man3/mbrlen.3:20 build/C/man3/mbrtowc.3:21 build/C/man3/mbsinit.3:20 build/C/man3/mbsnrtowcs.3:19 build/C/man3/mbsrtowcs.3:20 build/C/man3/putwchar.3:21 build/C/man3/ungetwc.3:20 build/C/man3/wcpcpy.3:19 build/C/man3/wcpncpy.3:20 build/C/man3/wcrtomb.3:20 build/C/man3/wcscasecmp.3:19 build/C/man3/wcscat.3:20 build/C/man3/wcschr.3:20 build/C/man3/wcscmp.3:20 build/C/man3/wcscpy.3:20 build/C/man3/wcscspn.3:20 build/C/man3/wcsdup.3:19 build/C/man3/wcslen.3:20 build/C/man3/wcsncasecmp.3:19 build/C/man3/wcsncat.3:20 build/C/man3/wcsncmp.3:20 build/C/man3/wcsncpy.3:20 build/C/man3/wcsnlen.3:19 build/C/man3/wcsnrtombs.3:19 build/C/man3/wcspbrk.3:20 build/C/man3/wcsrchr.3:20 build/C/man3/wcsrtombs.3:20 build/C/man3/wcsspn.3:21 build/C/man3/wcsstr.3:20 build/C/man3/wcstok.3:20 build/C/man3/wctob.3:20 build/C/man3/wmemchr.3:20 build/C/man3/wmemcmp.3:19 build/C/man3/wmemcpy.3:20 build/C/man3/wmemmove.3:20 build/C/man3/wmemset.3:20
63 msgid "B<#include E<lt>wchar.hE<gt>>\n"
67 #: build/C/man3/btowc.3:22
69 msgid "B<wint_t btowc(int >I<c>B<);>\n"
73 #: build/C/man3/btowc.3:23 build/C/man3/fgetws.3:25 build/C/man3/fputws.3:23 build/C/man3/fwide.3:42 build/C/man3/getwchar.3:24 build/C/man3/mbrlen.3:23 build/C/man3/mbrtowc.3:25 build/C/man3/mbsinit.3:23 build/C/man3/mbsnrtowcs.3:42 build/C/man3/mbsrtowcs.3:24 build/C/man3/putwchar.3:24 build/C/man3/ungetwc.3:23 build/C/man3/wcpcpy.3:41 build/C/man3/wcpncpy.3:42 build/C/man3/wcrtomb.3:23 build/C/man3/wcscasecmp.3:41 build/C/man3/wcscat.3:23 build/C/man3/wcschr.3:23 build/C/man3/wcscmp.3:23 build/C/man3/wcscpy.3:23 build/C/man3/wcscspn.3:23 build/C/man3/wcsdup.3:41 build/C/man3/wcslen.3:23 build/C/man3/wcsncasecmp.3:41 build/C/man3/wcsncat.3:23 build/C/man3/wcsncmp.3:23 build/C/man3/wcsncpy.3:23 build/C/man3/wcsnlen.3:41 build/C/man3/wcsnrtombs.3:42 build/C/man3/wcspbrk.3:23 build/C/man3/wcsrchr.3:23 build/C/man3/wcsrtombs.3:24 build/C/man3/wcsspn.3:24 build/C/man3/wcsstr.3:23 build/C/man3/wcstoimax.3:38 build/C/man3/wcstok.3:24 build/C/man3/wcswidth.3:23 build/C/man3/wctob.3:23 build/C/man3/wcwidth.3:23 build/C/man3/wmemchr.3:23 build/C/man3/wmemcmp.3:22 build/C/man3/wmemcpy.3:23 build/C/man3/wmemmove.3:23 build/C/man3/wmemset.3:23
79 #: build/C/man3/btowc.3:37
81 "The B<btowc>() function converts I<c>, interpreted as a multibyte sequence "
82 "of length 1, starting in the initial shift state, to a wide character and "
83 "returns it. If I<c> is B<EOF> or not a valid multibyte sequence of length "
84 "1, the B<btowc>() function returns B<WEOF>."
88 #: build/C/man3/btowc.3:37 build/C/man3/fgetws.3:44 build/C/man3/fputws.3:35 build/C/man3/fwide.3:69 build/C/man3/getwchar.3:41 build/C/man3/mbrlen.3:54 build/C/man3/mbrtowc.3:88 build/C/man3/mbsinit.3:69 build/C/man3/mbsnrtowcs.3:101 build/C/man3/mbsrtowcs.3:74 build/C/man3/putwchar.3:40 build/C/man3/ungetwc.3:48 build/C/man3/wcpcpy.3:57 build/C/man3/wcpncpy.3:66 build/C/man3/wcrtomb.3:67 build/C/man3/wcscasecmp.3:52 build/C/man3/wcscat.3:38 build/C/man3/wcschr.3:32 build/C/man3/wcscmp.3:32 build/C/man3/wcscpy.3:40 build/C/man3/wcscspn.3:36 build/C/man3/wcsdup.3:56 build/C/man3/wcslen.3:32 build/C/man3/wcsncasecmp.3:53 build/C/man3/wcsncat.3:37 build/C/man3/wcsncmp.3:34 build/C/man3/wcsncpy.3:47 build/C/man3/wcsnlen.3:57 build/C/man3/wcsnrtombs.3:104 build/C/man3/wcspbrk.3:34 build/C/man3/wcsrchr.3:32 build/C/man3/wcsrtombs.3:79 build/C/man3/wcsspn.3:36 build/C/man3/wcsstr.3:32 build/C/man3/wcstok.3:55 build/C/man3/wcswidth.3:32 build/C/man3/wctob.3:38 build/C/man3/wcwidth.3:32 build/C/man3/wmemchr.3:31 build/C/man3/wmemcmp.3:30 build/C/man3/wmemcpy.3:39 build/C/man3/wmemmove.3:36 build/C/man3/wmemset.3:31
94 #: build/C/man3/btowc.3:47
96 "The B<btowc>() function returns the wide character converted from the "
97 "single byte I<c>. If I<c> is B<EOF> or not a valid multibyte sequence of "
98 "length 1, it returns B<WEOF>."
102 #: build/C/man3/btowc.3:47 build/C/man3/fgetws.3:50 build/C/man3/fputws.3:41 build/C/man3/fwide.3:77 build/C/man3/getwchar.3:47 build/C/man3/mbrlen.3:67 build/C/man3/mbrtowc.3:101 build/C/man3/mbsinit.3:74 build/C/man3/mbsnrtowcs.3:111 build/C/man3/mbsrtowcs.3:84 build/C/man3/putwchar.3:46 build/C/man3/ungetwc.3:53 build/C/man3/wcpcpy.3:61 build/C/man3/wcpncpy.3:70 build/C/man3/wcrtomb.3:77 build/C/man3/wcscasecmp.3:66 build/C/man3/wcscat.3:41 build/C/man3/wcschr.3:38 build/C/man3/wcscmp.3:43 build/C/man3/wcscpy.3:43 build/C/man3/wcscspn.3:48 build/C/man3/wcsdup.3:66 build/C/man3/wcslen.3:37 build/C/man3/wcsncasecmp.3:69 build/C/man3/wcsncat.3:40 build/C/man3/wcsncmp.3:46 build/C/man3/wcsncpy.3:50 build/C/man3/wcsnlen.3:67 build/C/man3/wcsnrtombs.3:115 build/C/man3/wcspbrk.3:41 build/C/man3/wcsrchr.3:38 build/C/man3/wcsrtombs.3:92 build/C/man3/wcsspn.3:47 build/C/man3/wcsstr.3:43 build/C/man3/wcstoimax.3:48 build/C/man3/wcstok.3:60 build/C/man3/wcswidth.3:38 build/C/man3/wctob.3:43 build/C/man3/wcwidth.3:37 build/C/man3/wmemchr.3:37 build/C/man3/wmemcmp.3:44 build/C/man3/wmemcpy.3:42 build/C/man3/wmemmove.3:39 build/C/man3/wmemset.3:34
104 msgid "CONFORMING TO"
108 #: build/C/man3/btowc.3:49 build/C/man3/fgetws.3:52 build/C/man3/fputws.3:43 build/C/man3/fwide.3:79
109 msgid "C99, POSIX.1-2001."
113 #: build/C/man3/btowc.3:49 build/C/man3/fgetws.3:52 build/C/man3/fputws.3:43 build/C/man3/fwide.3:79 build/C/man3/getwchar.3:49 build/C/man3/mbrlen.3:69 build/C/man3/mbrtowc.3:103 build/C/man3/mbsinit.3:76 build/C/man3/mbsnrtowcs.3:113 build/C/man3/mbsrtowcs.3:86 build/C/man3/putwchar.3:48 build/C/man3/ungetwc.3:55 build/C/man3/wcrtomb.3:79 build/C/man3/wcscasecmp.3:70 build/C/man3/wcsncasecmp.3:73 build/C/man3/wcsnrtombs.3:117 build/C/man3/wcsrtombs.3:94 build/C/man3/wcstok.3:62 build/C/man3/wcswidth.3:40 build/C/man3/wctob.3:45 build/C/man3/wcwidth.3:45
119 #: build/C/man3/btowc.3:56
121 "The behavior of B<btowc>() depends on the B<LC_CTYPE> category of the "
126 #: build/C/man3/btowc.3:66
128 "This function should never be used. It does not work for encodings which "
129 "have state, and unnecessarily treats single bytes differently from multibyte "
130 "sequences. Use either B<mbtowc>(3) or the thread-safe B<mbrtowc>(3) "
135 #: build/C/man3/btowc.3:66 build/C/man3/fgetws.3:71 build/C/man3/fputws.3:58 build/C/man3/fwide.3:96 build/C/man3/getwchar.3:62 build/C/man3/mbrlen.3:76 build/C/man3/mbrtowc.3:110 build/C/man3/mbsinit.3:83 build/C/man3/mbsnrtowcs.3:122 build/C/man3/mbsrtowcs.3:95 build/C/man3/putwchar.3:60 build/C/man3/ungetwc.3:62 build/C/man3/wcpcpy.3:63 build/C/man3/wcpncpy.3:72 build/C/man3/wcrtomb.3:88 build/C/man3/wcscasecmp.3:77 build/C/man3/wcscat.3:43 build/C/man3/wcschr.3:40 build/C/man3/wcscmp.3:45 build/C/man3/wcscpy.3:45 build/C/man3/wcscspn.3:50 build/C/man3/wcsdup.3:71 build/C/man3/wcslen.3:39 build/C/man3/wcsncasecmp.3:80 build/C/man3/wcsncat.3:42 build/C/man3/wcsncmp.3:48 build/C/man3/wcsncpy.3:52 build/C/man3/wcsnlen.3:69 build/C/man3/wcsnrtombs.3:126 build/C/man3/wcspbrk.3:43 build/C/man3/wcsrchr.3:40 build/C/man3/wcsrtombs.3:103 build/C/man3/wcsspn.3:49 build/C/man3/wcsstr.3:45 build/C/man3/wcstoimax.3:50 build/C/man3/wcstok.3:78 build/C/man3/wcswidth.3:47 build/C/man3/wctob.3:61 build/C/man3/wcwidth.3:52 build/C/man3/wmemchr.3:39 build/C/man3/wmemcmp.3:46 build/C/man3/wmemcpy.3:44 build/C/man3/wmemmove.3:41 build/C/man3/wmemset.3:36
141 #: build/C/man3/btowc.3:70
142 msgid "B<mbtowc>(3), B<mbrtowc>(3), B<wctob>(3)"
146 #: build/C/man3/btowc.3:70 build/C/man3/fgetws.3:74 build/C/man3/fputws.3:61 build/C/man3/fwide.3:99 build/C/man3/getwchar.3:65 build/C/man3/mbrlen.3:78 build/C/man3/mbrtowc.3:112 build/C/man3/mbsinit.3:86 build/C/man3/mbsnrtowcs.3:125 build/C/man3/mbsrtowcs.3:99 build/C/man3/putwchar.3:63 build/C/man3/ungetwc.3:64 build/C/man3/wcpcpy.3:66 build/C/man3/wcpncpy.3:75 build/C/man3/wcrtomb.3:90 build/C/man3/wcscasecmp.3:80 build/C/man3/wcscat.3:48 build/C/man3/wcschr.3:46 build/C/man3/wcscmp.3:49 build/C/man3/wcscpy.3:51 build/C/man3/wcscspn.3:54 build/C/man3/wcsdup.3:74 build/C/man3/wcslen.3:41 build/C/man3/wcsncasecmp.3:83 build/C/man3/wcsncat.3:45 build/C/man3/wcsncmp.3:51 build/C/man3/wcsncpy.3:54 build/C/man3/wcsnlen.3:72 build/C/man3/wcsnrtombs.3:129 build/C/man3/wcspbrk.3:47 build/C/man3/wcsrchr.3:43 build/C/man3/wcsrtombs.3:107 build/C/man3/wcsspn.3:52 build/C/man3/wcsstr.3:48 build/C/man3/wcstoimax.3:58 build/C/man3/wcstok.3:81 build/C/man3/wcswidth.3:50 build/C/man3/wctob.3:65 build/C/man3/wcwidth.3:55 build/C/man3/wmemchr.3:42 build/C/man3/wmemcmp.3:49 build/C/man3/wmemcpy.3:49 build/C/man3/wmemmove.3:44 build/C/man3/wmemset.3:38
152 #: build/C/man3/btowc.3:77 build/C/man3/fgetws.3:81 build/C/man3/fputws.3:68 build/C/man3/fwide.3:106 build/C/man3/getwchar.3:72 build/C/man3/mbrlen.3:85 build/C/man3/mbrtowc.3:119 build/C/man3/mbsinit.3:93 build/C/man3/mbsnrtowcs.3:132 build/C/man3/mbsrtowcs.3:106 build/C/man3/putwchar.3:70 build/C/man3/ungetwc.3:71 build/C/man3/wcpcpy.3:73 build/C/man3/wcpncpy.3:82 build/C/man3/wcrtomb.3:97 build/C/man3/wcscasecmp.3:87 build/C/man3/wcscat.3:55 build/C/man3/wcschr.3:53 build/C/man3/wcscmp.3:56 build/C/man3/wcscpy.3:58 build/C/man3/wcscspn.3:61 build/C/man3/wcsdup.3:81 build/C/man3/wcslen.3:48 build/C/man3/wcsncasecmp.3:90 build/C/man3/wcsncat.3:52 build/C/man3/wcsncmp.3:58 build/C/man3/wcsncpy.3:61 build/C/man3/wcsnlen.3:79 build/C/man3/wcsnrtombs.3:136 build/C/man3/wcspbrk.3:54 build/C/man3/wcsrchr.3:50 build/C/man3/wcsrtombs.3:114 build/C/man3/wcsspn.3:59 build/C/man3/wcsstr.3:55 build/C/man3/wcstoimax.3:65 build/C/man3/wcstok.3:88 build/C/man3/wcswidth.3:57 build/C/man3/wctob.3:72 build/C/man3/wcwidth.3:62 build/C/man3/wmemchr.3:49 build/C/man3/wmemcmp.3:56 build/C/man3/wmemcpy.3:56 build/C/man3/wmemmove.3:51 build/C/man3/wmemset.3:45
154 "This page is part of release 3.37 of the Linux I<man-pages> project. A "
155 "description of the project, and information about reporting bugs, can be "
156 "found at http://www.kernel.org/doc/man-pages/."
160 #: build/C/man3/fgetws.3:16
166 #: build/C/man3/fgetws.3:16 build/C/man3/fputws.3:14 build/C/man3/mbrtowc.3:15 build/C/man3/mbsrtowcs.3:14 build/C/man3/wcrtomb.3:14 build/C/man3/wcscat.3:14 build/C/man3/wcscpy.3:14 build/C/man3/wcslen.3:14 build/C/man3/wcsncat.3:14 build/C/man3/wcsncmp.3:14 build/C/man3/wcsncpy.3:14 build/C/man3/wcsstr.3:14 build/C/man3/wcstok.3:14 build/C/man3/wcwidth.3:13
172 #: build/C/man3/fgetws.3:19
173 msgid "fgetws - read a wide-character string from a FILE stream"
177 #: build/C/man3/fgetws.3:24
179 msgid "B<wchar_t *fgetws(wchar_t *>I<ws>B<, int >I<n>B<, FILE *>I<stream>B<);>\n"
183 #: build/C/man3/fgetws.3:38
185 "The B<fgetws>() function is the wide-character equivalent of the "
186 "B<fgets>(3) function. It reads a string of at most I<n-1> wide characters "
187 "into the wide-character array pointed to by I<ws>, and adds a terminating "
188 "null wide character (L\\(aq\\e0\\(aq). It stops reading wide characters "
189 "after it has encountered and stored a newline wide character. It also stops "
190 "when end of stream is reached."
194 #: build/C/man3/fgetws.3:41
196 "The programmer must ensure that there is room for at least I<n> wide "
197 "characters at I<ws>."
201 #: build/C/man3/fgetws.3:44 build/C/man3/fputws.3:35 build/C/man3/getwchar.3:41 build/C/man3/putwchar.3:40
202 msgid "For a nonlocking counterpart, see B<unlocked_stdio>(3)."
206 #: build/C/man3/fgetws.3:50
208 "The B<fgetws>() function, if successful, returns I<ws>. If end of stream "
209 "was already reached or if an error occurred, it returns NULL."
213 #: build/C/man3/fgetws.3:59
215 "The behavior of B<fgetws>() depends on the B<LC_CTYPE> category of the "
220 #: build/C/man3/fgetws.3:67
222 "In the absence of additional information passed to the B<fopen>(3) call, it "
223 "is reasonable to expect that B<fgetws>() will actually read a multibyte "
224 "string from the stream and then convert it to a wide-character string."
228 #: build/C/man3/fgetws.3:71
230 "This function is unreliable, because it does not permit to deal properly "
231 "with null wide characters that may be present in the input."
235 #: build/C/man3/fgetws.3:74 build/C/man3/getwchar.3:65
236 msgid "B<fgetwc>(3), B<unlocked_stdio>(3)"
240 #: build/C/man3/fputws.3:14
246 #: build/C/man3/fputws.3:17
247 msgid "fputws - write a wide-character string to a FILE stream"
251 #: build/C/man3/fputws.3:22
253 msgid "B<int fputws(const wchar_t *>I<ws>B<, FILE *>I<stream>B<);>\n"
257 #: build/C/man3/fputws.3:32
259 "The B<fputws>() function is the wide-character equivalent of the "
260 "B<fputs>(3) function. It writes the wide-character string starting at "
261 "I<ws>, up to but not including the terminating null wide character "
262 "(L\\(aq\\e0\\(aq), to I<stream>."
266 #: build/C/man3/fputws.3:41
268 "The B<fputws>() function returns a nonnegative integer if the operation was "
269 "successful, or -1 to indicate an error."
273 #: build/C/man3/fputws.3:50
275 "The behavior of B<fputws>() depends on the B<LC_CTYPE> category of the "
280 #: build/C/man3/fputws.3:58
282 "In the absence of additional information passed to the B<fopen>(3) call, it "
283 "is reasonable to expect that B<fputws>() will actually write the multibyte "
284 "string corresponding to the wide-character string I<ws>."
288 #: build/C/man3/fputws.3:61 build/C/man3/putwchar.3:63
289 msgid "B<fputwc>(3), B<unlocked_stdio>(3)"
293 #: build/C/man3/fwide.3:14
299 #: build/C/man3/fwide.3:14
305 #: build/C/man3/fwide.3:17
306 msgid "fwide - set and determine the orientation of a FILE stream"
310 #: build/C/man3/fwide.3:22
312 msgid "B<int fwide(FILE *>I<stream>B<, int >I<mode>B<);>\n"
316 #: build/C/man3/fwide.3:27 build/C/man3/mbsnrtowcs.3:27 build/C/man3/wcpcpy.3:26 build/C/man3/wcpncpy.3:27 build/C/man3/wcscasecmp.3:26 build/C/man3/wcsdup.3:26 build/C/man3/wcsncasecmp.3:26 build/C/man3/wcsnlen.3:26 build/C/man3/wcsnrtombs.3:27
317 msgid "Feature Test Macro Requirements for glibc (see B<feature_test_macros>(7)):"
321 #: build/C/man3/fwide.3:31
326 #: build/C/man3/fwide.3:33
327 msgid "_XOPEN_SOURCE\\ E<gt>=\\ 500 || _ISOC99_SOURCE ||"
331 #: build/C/man3/fwide.3:35
332 msgid "_ISOC95_SOURCE /* Since glibc 2.12 */ ||"
336 #: build/C/man3/fwide.3:37
337 msgid "_POSIX_C_SOURCE\\ E<gt>=\\ 200112L;"
341 #: build/C/man3/fwide.3:40
342 msgid "or I<cc\\ -std=c99>"
346 #: build/C/man3/fwide.3:57
348 "When I<mode> is zero, the B<fwide>() function determines the current "
349 "orientation of I<stream>. It returns a positive value if I<stream> is "
350 "wide-character oriented, that is, if wide-character I/O is permitted but "
351 "char I/O is disallowed. It returns a negative value if I<stream> is byte "
352 "oriented, i.e., if char I/O is permitted but wide-character I/O is "
353 "disallowed. It returns zero if I<stream> has no orientation yet; in this "
354 "case the next I/O operation might change the orientation (to byte oriented "
355 "if it is a char I/O operation, or to wide-character oriented if it is a "
356 "wide-character I/O operation)."
360 #: build/C/man3/fwide.3:60
362 "Once a stream has an orientation, it cannot be changed and persists until "
363 "the stream is closed."
367 #: build/C/man3/fwide.3:69
369 "When I<mode> is nonzero, the B<fwide>() function first attempts to set "
370 "I<stream>'s orientation (to wide-character oriented if I<mode> is greater "
371 "than 0, or to byte oriented if I<mode> is less than 0). It then returns a "
372 "value denoting the current orientation, as above."
376 #: build/C/man3/fwide.3:77
378 "The B<fwide>() function returns the stream's orientation, after possibly "
379 "changing it. A positive return value means wide-character oriented. A "
380 "negative return value means byte oriented. A return value of zero means "
385 #: build/C/man3/fwide.3:87
387 "Wide-character output to a byte oriented stream can be performed through the "
388 "B<fprintf>(3) function with the B<%lc> and B<%ls> directives."
392 #: build/C/man3/fwide.3:96
394 "Char oriented output to a wide-character oriented stream can be performed "
395 "through the B<fwprintf>(3) function with the B<%c> and B<%s> directives."
399 #: build/C/man3/fwide.3:99
400 msgid "B<fprintf>(3), B<fwprintf>(3)"
404 #: build/C/man3/getwchar.3:15
410 #: build/C/man3/getwchar.3:15 build/C/man3/mbrlen.3:14 build/C/man3/putwchar.3:15 build/C/man3/wcschr.3:14 build/C/man3/wcscmp.3:14 build/C/man3/wcscspn.3:14 build/C/man3/wcspbrk.3:14 build/C/man3/wcsrchr.3:14 build/C/man3/wcsspn.3:14 build/C/man3/wmemchr.3:14 build/C/man3/wmemcmp.3:13 build/C/man3/wmemcpy.3:14 build/C/man3/wmemmove.3:14 build/C/man3/wmemset.3:14
416 #: build/C/man3/getwchar.3:18
417 msgid "getwchar - read a wide character from standard input"
421 #: build/C/man3/getwchar.3:23
423 msgid "B<wint_t getwchar(void);>\n"
427 #: build/C/man3/getwchar.3:38
429 "The B<getwchar>() function is the wide-character equivalent of the "
430 "B<getchar>(3) function. It reads a wide character from I<stdin> and "
431 "returns it. If the end of stream is reached, or if I<ferror(stdin)> becomes "
432 "true, it returns B<WEOF>. If a wide-character conversion error occurs, it "
433 "sets I<errno> to B<EILSEQ> and returns B<WEOF>."
437 #: build/C/man3/getwchar.3:47
439 "The B<getwchar>() function returns the next wide-character from standard "
444 #: build/C/man3/getwchar.3:49 build/C/man3/mbrlen.3:69 build/C/man3/mbrtowc.3:103 build/C/man3/mbsinit.3:76 build/C/man3/mbsrtowcs.3:86 build/C/man3/putwchar.3:48 build/C/man3/ungetwc.3:55 build/C/man3/wcrtomb.3:79 build/C/man3/wcscat.3:43 build/C/man3/wcschr.3:40 build/C/man3/wcscmp.3:45 build/C/man3/wcscpy.3:45 build/C/man3/wcscspn.3:50 build/C/man3/wcslen.3:39 build/C/man3/wcsncat.3:42 build/C/man3/wcsncmp.3:48 build/C/man3/wcsncpy.3:52 build/C/man3/wcspbrk.3:43 build/C/man3/wcsrchr.3:40 build/C/man3/wcsrtombs.3:94 build/C/man3/wcsspn.3:49 build/C/man3/wcsstr.3:45 build/C/man3/wcstoimax.3:50 build/C/man3/wcstok.3:62 build/C/man3/wctob.3:45 build/C/man3/wmemchr.3:39 build/C/man3/wmemcmp.3:46 build/C/man3/wmemcpy.3:44 build/C/man3/wmemmove.3:41 build/C/man3/wmemset.3:36
449 #: build/C/man3/getwchar.3:56
451 "The behavior of B<getwchar>() depends on the B<LC_CTYPE> category of the "
456 #: build/C/man3/getwchar.3:62
458 "It is reasonable to expect that B<getwchar>() will actually read a "
459 "multibyte sequence from standard input and then convert it to a wide "
464 #: build/C/man3/mbrlen.3:14
470 #: build/C/man3/mbrlen.3:17
471 msgid "mbrlen - determine number of bytes in next multibyte character"
475 #: build/C/man3/mbrlen.3:22
478 "B<size_t mbrlen(const char *>I<s>B<, size_t >I<n>B<, mbstate_t "
483 #: build/C/man3/mbrlen.3:34
485 "The B<mbrlen>() function inspects at most I<n> bytes of the multibyte "
486 "string starting at I<s> and extracts the next complete multibyte character. "
487 "It updates the shift state I<*ps>. If the multibyte character is not the "
488 "null wide character, it returns the number of bytes that were consumed from "
489 "I<s>. If the multibyte character is the null wide character, it resets the "
490 "shift state I<*ps> to the initial state and returns 0."
494 #: build/C/man3/mbrlen.3:42
496 "If the I<n> bytes starting at I<s> do not contain a complete multibyte "
497 "character, B<mbrlen>() returns I<(size_t)\\ -2>. This can happen even if "
498 "I<n> E<gt>= I<MB_CUR_MAX>, if the multibyte string contains redundant shift "
503 #: build/C/man3/mbrlen.3:50
505 "If the multibyte string starting at I<s> contains an invalid multibyte "
506 "sequence before the next complete character, B<mbrlen>() returns "
507 "I<(size_t)\\ -1> and sets I<errno> to B<EILSEQ>. In this case, the effects "
508 "on I<*ps> are undefined."
512 #: build/C/man3/mbrlen.3:54
514 "If I<ps> is a NULL pointer, a static anonymous state only known to the "
515 "B<mbrlen>() function is used instead."
519 #: build/C/man3/mbrlen.3:67
521 "The B<mbrlen>() function returns the number of bytes parsed from the "
522 "multibyte sequence starting at I<s>, if a non-null wide character was "
523 "recognized. It returns 0, if a null wide character was recognized. It "
524 "returns I<(size_t)\\ -1> and sets I<errno> to B<EILSEQ>, if an invalid "
525 "multibyte sequence was encountered. It returns I<(size_t)\\ -2> if it "
526 "couldn't parse a complete multibyte character, meaning that I<n> should be "
531 #: build/C/man3/mbrlen.3:76
533 "The behavior of B<mbrlen>() depends on the B<LC_CTYPE> category of the "
538 #: build/C/man3/mbrlen.3:78
539 msgid "B<mbrtowc>(3)"
543 #: build/C/man3/mbrtowc.3:15
549 #: build/C/man3/mbrtowc.3:18
550 msgid "mbrtowc - convert a multibyte sequence to a wide character"
554 #: build/C/man3/mbrtowc.3:24
557 "B<size_t mbrtowc(wchar_t *>I<pwc>B<, const char *>I<s>B<, size_t >I<n>B<, "
558 "mbstate_t *>I<ps>B<);>\n"
562 #: build/C/man3/mbrtowc.3:41
564 "The main case for this function is when I<s> is not NULL and I<pwc> is not "
565 "NULL. In this case, the B<mbrtowc>() function inspects at most I<n> bytes "
566 "of the multibyte string starting at I<s>, extracts the next complete "
567 "multibyte character, converts it to a wide character and stores it at "
568 "I<*pwc>. It updates the shift state I<*ps>. If the converted wide "
569 "character is not L\\(aq\\e0\\(aq (the null wide character), it returns the "
570 "number of bytes that were consumed from I<s>. If the converted wide "
571 "character is L\\(aq\\e0\\(aq, it resets the shift state I<*ps> to the "
572 "initial state and returns 0."
576 #: build/C/man3/mbrtowc.3:49
578 "If the I<n> bytes starting at I<s> do not contain a complete multibyte "
579 "character, B<mbrtowc>() returns I<(size_t)\\ -2>. This can happen even if "
580 "I<n> E<gt>= I<MB_CUR_MAX>, if the multibyte string contains redundant shift "
585 #: build/C/man3/mbrtowc.3:57
587 "If the multibyte string starting at I<s> contains an invalid multibyte "
588 "sequence before the next complete character, B<mbrtowc>() returns "
589 "I<(size_t)\\ -1> and sets I<errno> to B<EILSEQ>. In this case, the effects "
590 "on I<*ps> are undefined."
594 #: build/C/man3/mbrtowc.3:64
596 "A different case is when I<s> is not NULL but I<pwc> is NULL. In this case "
597 "the B<mbrtowc>() function behaves as above, except that it does not store "
598 "the converted wide character in memory."
602 #: build/C/man3/mbrtowc.3:78
604 "A third case is when I<s> is NULL. In this case, I<pwc> and I<n> are "
605 "ignored. If the conversion state represented by I<*ps> denotes an "
606 "incomplete multibyte character conversion, the B<mbrtowc>() function "
607 "returns I<(size_t)\\ -1>, sets I<errno> to B<EILSEQ>, and leaves I<*ps> in "
608 "an undefined state. Otherwise, the B<mbrtowc>() function puts I<*ps> in "
609 "the initial state and returns 0."
613 #: build/C/man3/mbrtowc.3:84
615 "In all of the above cases, if I<ps> is a NULL pointer, a static anonymous "
616 "state only known to the mbrtowc function is used instead. Otherwise, I<*ps> "
617 "must be a valid I<mbstate_t> object. An I<mbstate_t> object I<a> can be "
618 "initialized to the initial state by zeroing it, for example using"
622 #: build/C/man3/mbrtowc.3:87
623 msgid "memset(&a, 0, sizeof(a));"
627 #: build/C/man3/mbrtowc.3:101
629 "The B<mbrtowc>() function returns the number of bytes parsed from the "
630 "multibyte sequence starting at I<s>, if a non-L\\(aq\\e0\\(aq wide character "
631 "was recognized. It returns 0, if a L\\(aq\\e0\\(aq wide character was "
632 "recognized. It returns I<(size_t)\\ -1> and sets I<errno> to B<EILSEQ>, if "
633 "an invalid multibyte sequence was encountered. It returns I<(size_t)\\ -2> "
634 "if it couldn't parse a complete multibyte character, meaning that I<n> "
635 "should be increased."
639 #: build/C/man3/mbrtowc.3:110
641 "The behavior of B<mbrtowc>() depends on the B<LC_CTYPE> category of the "
646 #: build/C/man3/mbrtowc.3:112
647 msgid "B<mbsrtowcs>(3)"
651 #: build/C/man3/mbsinit.3:14
657 #: build/C/man3/mbsinit.3:14
663 #: build/C/man3/mbsinit.3:17
664 msgid "mbsinit - test for initial shift state"
668 #: build/C/man3/mbsinit.3:22
670 msgid "B<int mbsinit(const mbstate_t *>I<ps>B<);>\n"
674 #: build/C/man3/mbsinit.3:31
676 "Character conversion between the multibyte representation and the wide "
677 "character representation uses conversion state, of type I<mbstate_t>. "
678 "Conversion of a string uses a finite-state machine; when it is interrupted "
679 "after the complete conversion of a number of characters, it may need to save "
680 "a state for processing the remaining characters. Such a conversion state is "
681 "needed for the sake of encodings such as ISO-2022 and UTF-7."
685 #: build/C/man3/mbsinit.3:41
687 "The initial state is the state at the beginning of conversion of a string. "
688 "There are two kinds of state: The one used by multibyte to wide character "
689 "conversion functions, such as B<mbsrtowcs>(3), and the one used by wide "
690 "character to multibyte conversion functions, such as B<wcsrtombs>(3), but "
691 "they both fit in a I<mbstate_t>, and they both have the same representation "
692 "for an initial state."
696 #: build/C/man3/mbsinit.3:49
698 "For 8-bit encodings, all states are equivalent to the initial state. For "
699 "multibyte encodings like UTF-8, EUC-*, BIG5 or SJIS, the wide character to "
700 "multibyte conversion functions never produce non-initial states, but the "
701 "multibyte to wide-character conversion functions like B<mbrtowc>(3) do "
702 "produce non-initial states when interrupted in the middle of a character."
706 #: build/C/man3/mbsinit.3:53
708 "One possible way to create an I<mbstate_t> in initial state is to set it to "
713 #: build/C/man3/mbsinit.3:57
716 " mbstate_t state;\n"
717 " memset(&state,0,sizeof(mbstate_t));\n"
721 #: build/C/man3/mbsinit.3:60
722 msgid "On Linux, the following works as well, but might generate compiler warnings:"
726 #: build/C/man3/mbsinit.3:63
728 msgid " mbstate_t state = { 0 };\n"
732 #: build/C/man3/mbsinit.3:69
734 "The function B<mbsinit>() tests whether I<*ps> corresponds to an initial "
739 #: build/C/man3/mbsinit.3:74
741 "B<mbsinit>() returns nonzero if I<*ps> is an initial state, or if I<ps> is "
742 "a NULL pointer. Otherwise it returns 0."
746 #: build/C/man3/mbsinit.3:83
748 "The behavior of B<mbsinit>() depends on the B<LC_CTYPE> category of the "
753 #: build/C/man3/mbsinit.3:86
754 msgid "B<mbsrtowcs>(3), B<wcsrtombs>(3)"
758 #: build/C/man3/mbsnrtowcs.3:13
764 #: build/C/man3/mbsnrtowcs.3:13 build/C/man3/wcpcpy.3:13 build/C/man3/wcpncpy.3:13 build/C/man3/wcsnlen.3:13
770 #: build/C/man3/mbsnrtowcs.3:16
771 msgid "mbsnrtowcs - convert a multibyte string to a wide-character string"
775 #: build/C/man3/mbsnrtowcs.3:22
778 "B<size_t mbsnrtowcs(wchar_t *>I<dest>B<, const char **>I<src>B<,>\n"
779 "B< size_t >I<nms>B<, size_t >I<len>B<, mbstate_t "
784 #: build/C/man3/mbsnrtowcs.3:30
785 msgid "B<mbsnrtowcs>():"
789 #: build/C/man3/mbsnrtowcs.3:33 build/C/man3/wcpcpy.3:32 build/C/man3/wcpncpy.3:33 build/C/man3/wcscasecmp.3:32 build/C/man3/wcsdup.3:32 build/C/man3/wcsncasecmp.3:32 build/C/man3/wcsnlen.3:32 build/C/man3/wcsnrtombs.3:33
791 msgid "Since glibc 2.10:"
795 #: build/C/man3/mbsnrtowcs.3:36 build/C/man3/wcpcpy.3:35 build/C/man3/wcpncpy.3:36 build/C/man3/wcscasecmp.3:35 build/C/man3/wcsdup.3:35 build/C/man3/wcsncasecmp.3:35 build/C/man3/wcsnlen.3:35 build/C/man3/wcsnrtombs.3:36
796 msgid "_XOPEN_SOURCE\\ E<gt>=\\ 700 || _POSIX_C_SOURCE\\ E<gt>=\\ 200809L"
800 #: build/C/man3/mbsnrtowcs.3:36 build/C/man3/wcpcpy.3:35 build/C/man3/wcpncpy.3:36 build/C/man3/wcscasecmp.3:35 build/C/man3/wcsdup.3:35 build/C/man3/wcsncasecmp.3:35 build/C/man3/wcsnlen.3:35 build/C/man3/wcsnrtombs.3:36
802 msgid "Before glibc 2.10:"
806 #: build/C/man3/mbsnrtowcs.3:39 build/C/man3/wcpcpy.3:38 build/C/man3/wcpncpy.3:39 build/C/man3/wcscasecmp.3:38 build/C/man3/wcsdup.3:38 build/C/man3/wcsncasecmp.3:38 build/C/man3/wcsnlen.3:38 build/C/man3/wcsnrtombs.3:39
811 #: build/C/man3/mbsnrtowcs.3:50
813 "The B<mbsnrtowcs>() function is like the B<mbsrtowcs>(3) function, except "
814 "that the number of bytes to be converted, starting at I<*src>, is limited to "
819 #: build/C/man3/mbsnrtowcs.3:67
821 "If I<dest> is not a NULL pointer, the B<mbsnrtowcs>() function converts at "
822 "most I<nms> bytes from the multibyte string I<*src> to a wide-character "
823 "string starting at I<dest>. At most I<len> wide characters are written to "
824 "I<dest>. The shift state I<*ps> is updated. The conversion is effectively "
825 "performed by repeatedly calling I<mbrtowc(dest, *src, n, ps)> where I<n> is "
826 "some positive number, as long as this call succeeds, and then incrementing "
827 "I<dest> by one and I<*src> by the number of bytes consumed. The conversion "
828 "can stop for three reasons:"
832 #: build/C/man3/mbsnrtowcs.3:67 build/C/man3/mbsrtowcs.3:39
838 #: build/C/man3/mbsnrtowcs.3:74 build/C/man3/mbsrtowcs.3:46
840 "An invalid multibyte sequence has been encountered. In this case I<*src> is "
841 "left pointing to the invalid multibyte sequence, I<(size_t)\\ -1> is "
842 "returned, and I<errno> is set to B<EILSEQ>."
846 #: build/C/man3/mbsnrtowcs.3:74 build/C/man3/mbsrtowcs.3:46
852 #: build/C/man3/mbsnrtowcs.3:81
854 "The I<nms> limit forces a stop, or I<len> non-L\\(aq\\e0\\(aq wide "
855 "characters have been stored at I<dest>. In this case I<*src> is left "
856 "pointing to the next multibyte sequence to be converted, and the number of "
857 "wide characters written to I<dest> is returned."
861 #: build/C/man3/mbsnrtowcs.3:81 build/C/man3/mbsrtowcs.3:52
867 #: build/C/man3/mbsnrtowcs.3:90
869 "The multibyte string has been completely converted, including the "
870 "terminating null wide character (\\(aq\\e0\\(aq) (which has the side effect "
871 "of bringing back I<*ps> to the initial state). In this case I<*src> is set "
872 "to NULL, and the number of wide characters written to I<dest>, excluding the "
873 "terminating null wide character, is returned."
877 #: build/C/man3/mbsnrtowcs.3:95
879 "If I<dest> is NULL, I<len> is ignored, and the conversion proceeds as above, "
880 "except that the converted wide characters are not written out to memory, and "
881 "that no destination length limit exists."
885 #: build/C/man3/mbsnrtowcs.3:98
887 "In both of the above cases, if I<ps> is a NULL pointer, a static anonymous "
888 "state only known to the mbsnrtowcs function is used instead."
892 #: build/C/man3/mbsnrtowcs.3:101 build/C/man3/mbsrtowcs.3:74
894 "The programmer must ensure that there is room for at least I<len> wide "
895 "characters at I<dest>."
899 #: build/C/man3/mbsnrtowcs.3:111
901 "The B<mbsnrtowcs>() function returns the number of wide characters that "
902 "make up the converted part of the wide-character string, not including the "
903 "terminating null wide character. If an invalid multibyte sequence was "
904 "encountered, I<(size_t)\\ -1> is returned, and I<errno> set to B<EILSEQ>."
908 #: build/C/man3/mbsnrtowcs.3:113 build/C/man3/wcpcpy.3:63 build/C/man3/wcpncpy.3:72 build/C/man3/wcsnlen.3:69 build/C/man3/wcsnrtombs.3:117
909 msgid "POSIX.1-2008."
913 #: build/C/man3/mbsnrtowcs.3:120
915 "The behavior of B<mbsnrtowcs>() depends on the B<LC_CTYPE> category of the "
920 #: build/C/man3/mbsnrtowcs.3:122 build/C/man3/mbsrtowcs.3:95 build/C/man3/wcrtomb.3:88 build/C/man3/wcsnrtombs.3:126 build/C/man3/wcsrtombs.3:103
921 msgid "Passing NULL as I<ps> is not multithread safe."
925 #: build/C/man3/mbsnrtowcs.3:125
926 msgid "B<iconv>(3), B<mbsrtowcs>(3)"
930 #: build/C/man3/mbsrtowcs.3:14
936 #: build/C/man3/mbsrtowcs.3:17
937 msgid "mbsrtowcs - convert a multibyte string to a wide-character string"
941 #: build/C/man3/mbsrtowcs.3:23
944 "B<size_t mbsrtowcs(wchar_t *>I<dest>B<, const char **>I<src>B<,>\n"
945 "B< size_t >I<len>B<, mbstate_t *>I<ps>B<);>\n"
949 #: build/C/man3/mbsrtowcs.3:39
951 "If I<dest> is not a NULL pointer, the B<mbsrtowcs>() function converts the "
952 "multibyte string I<*src> to a wide-character string starting at I<dest>. At "
953 "most I<len> wide characters are written to I<dest>. The shift state I<*ps> "
954 "is updated. The conversion is effectively performed by repeatedly calling "
955 "I<mbrtowc(dest, *src, n, ps)> where I<n> is some positive number, as long as "
956 "this call succeeds, and then incrementing I<dest> by one and I<*src> by the "
957 "number of bytes consumed. The conversion can stop for three reasons:"
961 #: build/C/man3/mbsrtowcs.3:52
963 "I<len> non-L\\(aq\\e0\\(aq wide characters have been stored at I<dest>. In "
964 "this case I<*src> is left pointing to the next multibyte sequence to be "
965 "converted, and the number of wide characters written to I<dest> is returned."
969 #: build/C/man3/mbsrtowcs.3:60
971 "The multibyte string has been completely converted, including the "
972 "terminating null wide character (\\(aq\\e0\\(aq), which has the side effect "
973 "of bringing back I<*ps> to the initial state. In this case I<*src> is set "
974 "to NULL, and the number of wide characters written to I<dest>, excluding the "
975 "terminating null wide character, is returned."
979 #: build/C/man3/mbsrtowcs.3:65
981 "If I<dest> is NULL, I<len> is ignored, and the conversion proceeds as above, "
982 "except that the converted wide characters are not written out to memory, and "
983 "that no length limit exists."
987 #: build/C/man3/mbsrtowcs.3:71
989 "In both of the above cases, if I<ps> is a NULL pointer, a static anonymous "
990 "state only known to the B<mbsrtowcs>() function is used instead."
994 #: build/C/man3/mbsrtowcs.3:84
996 "The B<mbsrtowcs>() function returns the number of wide characters that make "
997 "up the converted part of the wide-character string, not including the "
998 "terminating null wide character. If an invalid multibyte sequence was "
999 "encountered, I<(size_t)\\ -1> is returned, and I<errno> set to B<EILSEQ>."
1003 #: build/C/man3/mbsrtowcs.3:93
1005 "The behavior of B<mbsrtowcs>() depends on the B<LC_CTYPE> category of the "
1010 #: build/C/man3/mbsrtowcs.3:99
1011 msgid "B<iconv>(3), B<mbsnrtowcs>(3), B<mbstowcs>(3)"
1015 #: build/C/man3/putwchar.3:15
1021 #: build/C/man3/putwchar.3:18
1022 msgid "putwchar - write a wide character to standard output"
1026 #: build/C/man3/putwchar.3:23
1028 msgid "B<wint_t putwchar(wchar_t >I<wc>B<);>\n"
1032 #: build/C/man3/putwchar.3:37
1034 "The B<putwchar>() function is the wide-character equivalent of the "
1035 "B<putchar>(3) function. It writes the wide character I<wc> to I<stdout>. "
1036 "If I<ferror(stdout)> becomes true, it returns B<WEOF>. If a wide character "
1037 "conversion error occurs, it sets I<errno> to B<EILSEQ> and returns B<WEOF>. "
1038 "Otherwise it returns I<wc>."
1042 #: build/C/man3/putwchar.3:46
1044 "The B<putwchar>() function returns I<wc> if no error occurred, or B<WEOF> "
1045 "to indicate an error."
1049 #: build/C/man3/putwchar.3:55
1051 "The behavior of B<putwchar>() depends on the B<LC_CTYPE> category of the "
1056 #: build/C/man3/putwchar.3:60
1058 "It is reasonable to expect that B<putwchar>() will actually write the "
1059 "multibyte sequence corresponding to the wide character I<wc>."
1063 #: build/C/man3/ungetwc.3:14
1069 #: build/C/man3/ungetwc.3:14
1075 #: build/C/man3/ungetwc.3:17
1076 msgid "ungetwc - push back a wide character onto a FILE stream"
1080 #: build/C/man3/ungetwc.3:22
1082 msgid "B<wint_t ungetwc(wint_t >I<wc>B<, FILE *>I<stream>B<);>\n"
1086 #: build/C/man3/ungetwc.3:30
1088 "The B<ungetwc>() function is the wide-character equivalent of the "
1089 "B<ungetc>(3) function. It pushes back a wide character onto I<stream> and "
1094 #: build/C/man3/ungetwc.3:34
1096 "If I<wc> is B<WEOF>, it returns B<WEOF>. If I<wc> is an invalid wide "
1097 "character, it sets I<errno> to B<EILSEQ> and returns B<WEOF>."
1101 #: build/C/man3/ungetwc.3:41
1103 "If I<wc> is a valid wide character, it is pushed back onto the stream and "
1104 "thus becomes available for future wide-character read operations. The "
1105 "file-position indicator is decremented by one or more. The end-of-file "
1106 "indicator is cleared. The backing storage of the file is not affected."
1110 #: build/C/man3/ungetwc.3:44
1112 "Note: I<wc> need not be the last wide-character read from the stream; it can "
1113 "be any other valid wide character."
1117 #: build/C/man3/ungetwc.3:48
1119 "If the implementation supports multiple push-back operations in a row, the "
1120 "pushed-back wide characters will be read in reverse order; however, only one "
1121 "level of push-back is guaranteed."
1125 #: build/C/man3/ungetwc.3:53
1127 "The B<ungetwc>() function returns I<wc> when successful, or B<WEOF> upon "
1132 #: build/C/man3/ungetwc.3:62
1134 "The behavior of B<ungetwc>() depends on the B<LC_CTYPE> category of the "
1139 #: build/C/man3/ungetwc.3:64
1140 msgid "B<fgetwc>(3)"
1144 #: build/C/man3/wcpcpy.3:13
1150 #: build/C/man3/wcpcpy.3:16
1151 msgid "wcpcpy - copy a wide-character string, returning a pointer to its end"
1155 #: build/C/man3/wcpcpy.3:21
1157 msgid "B<wchar_t *wcpcpy(wchar_t *>I<dest>B<, const wchar_t *>I<src>B<);>\n"
1161 #: build/C/man3/wcpcpy.3:29
1162 msgid "B<wcpcpy>():"
1166 #: build/C/man3/wcpcpy.3:51
1168 "The B<wcpcpy>() function is the wide-character equivalent of the "
1169 "B<stpcpy>(3) function. It copies the wide-character string pointed to by "
1170 "I<src>, including the terminating null wide character (L\\(aq\\e0\\(aq), to "
1171 "the array pointed to by I<dest>."
1175 #: build/C/man3/wcpcpy.3:53 build/C/man3/wcpncpy.3:63 build/C/man3/wcscat.3:35 build/C/man3/wcscpy.3:36 build/C/man3/wcsncat.3:34 build/C/man3/wcsncpy.3:44
1176 msgid "The strings may not overlap."
1180 #: build/C/man3/wcpcpy.3:57 build/C/man3/wcscpy.3:40
1182 "The programmer must ensure that there is room for at least I<wcslen(src)+1> "
1183 "wide characters at I<dest>."
1187 #: build/C/man3/wcpcpy.3:61
1189 "B<wcpcpy>() returns a pointer to the end of the wide-character string "
1190 "I<dest>, that is, a pointer to the terminating null wide character."
1194 #: build/C/man3/wcpcpy.3:66
1195 msgid "B<strcpy>(3), B<wcscpy>(3)"
1199 #: build/C/man3/wcpncpy.3:13
1205 #: build/C/man3/wcpncpy.3:17
1207 "wcpncpy - copy a fixed-size string of wide characters, returning a pointer "
1212 #: build/C/man3/wcpncpy.3:22
1215 "B<wchar_t *wcpncpy(wchar_t *>I<dest>B<, const wchar_t *>I<src>B<, size_t "
1220 #: build/C/man3/wcpncpy.3:30
1221 msgid "B<wcpncpy>():"
1225 #: build/C/man3/wcpncpy.3:61
1227 "The B<wcpncpy>() function is the wide-character equivalent of the "
1228 "B<stpncpy>(3) function. It copies at most I<n> wide characters from the "
1229 "wide-character string pointed to by I<src>, including the terminating null "
1230 "wide (L\\(aq\\e0\\(aq), to the array pointed to by I<dest>. Exactly I<n> "
1231 "wide characters are written at I<dest>. If the length I<wcslen(src)> is "
1232 "smaller than I<n>, the remaining wide characters in the array pointed to by "
1233 "I<dest> are filled with L\\(aq\\e0\\(aq characters. If the length "
1234 "I<wcslen(src)> is greater or equal to I<n>, the string pointed to by I<dest> "
1235 "will not be L\\(aq\\e0\\(aq terminated."
1239 #: build/C/man3/wcpncpy.3:66 build/C/man3/wcsncpy.3:47 build/C/man3/wmemcpy.3:39 build/C/man3/wmemmove.3:36
1241 "The programmer must ensure that there is room for at least I<n> wide "
1242 "characters at I<dest>."
1246 #: build/C/man3/wcpncpy.3:70
1248 "B<wcpncpy>() returns a pointer to the last wide character written, that is, "
1253 #: build/C/man3/wcpncpy.3:75
1254 msgid "B<stpncpy>(3), B<wcsncpy>(3)"
1258 #: build/C/man3/wcrtomb.3:14
1264 #: build/C/man3/wcrtomb.3:17
1265 msgid "wcrtomb - convert a wide character to a multibyte sequence"
1269 #: build/C/man3/wcrtomb.3:22
1271 msgid "B<size_t wcrtomb(char *>I<s>B<, wchar_t >I<wc>B<, mbstate_t *>I<ps>B<);>\n"
1275 #: build/C/man3/wcrtomb.3:37
1277 "The main case for this function is when I<s> is not NULL and I<wc> is not a "
1278 "null wide character (L\\(aq\\e0\\(aq). In this case, the B<wcrtomb>() "
1279 "function converts the wide character I<wc> to its multibyte representation "
1280 "and stores it at the beginning of the character array pointed to by I<s>. "
1281 "It updates the shift state I<*ps>, and returns the length of said multibyte "
1282 "representation, that is, the number of bytes written at I<s>."
1286 #: build/C/man3/wcrtomb.3:52
1288 "A different case is when I<s> is not NULL, but I<wc> is a null wide "
1289 "character (L\\(aq\\e0\\(aq). In this case the B<wcrtomb>() function stores "
1290 "at the character array pointed to by I<s> the shift sequence needed to bring "
1291 "I<*ps> back to the initial state, followed by a \\(aq\\e0\\(aq byte. It "
1292 "updates the shift state I<*ps> (i.e., brings it into the initial state), and "
1293 "returns the length of the shift sequence plus one, that is, the number of "
1294 "bytes written at I<s>."
1298 #: build/C/man3/wcrtomb.3:56
1300 "A third case is when I<s> is NULL. In this case I<wc> is ignored, and the "
1301 "function effectively returns"
1305 #: build/C/man3/wcrtomb.3:58
1307 msgid " wcrtomb(buf, L\\(aq\\e0\\(aq, ps)\n"
1311 #: build/C/man3/wcrtomb.3:62
1312 msgid "where I<buf> is an internal anonymous buffer."
1316 #: build/C/man3/wcrtomb.3:67
1318 "In all of the above cases, if I<ps> is a NULL pointer, a static anonymous "
1319 "state only known to the B<wcrtomb>() function is used instead."
1323 #: build/C/man3/wcrtomb.3:77
1325 "The B<wcrtomb>() function returns the number of bytes that have been or "
1326 "would have been written to the byte array at I<s>. If I<wc> can not be "
1327 "represented as a multibyte sequence (according to the current locale), "
1328 "I<(size_t)\\ -1> is returned, and I<errno> set to B<EILSEQ>."
1332 #: build/C/man3/wcrtomb.3:86
1334 "The behavior of B<wcrtomb>() depends on the B<LC_CTYPE> category of the "
1339 #: build/C/man3/wcrtomb.3:90
1340 msgid "B<wcsrtombs>(3)"
1344 #: build/C/man3/wcscasecmp.3:13
1350 #: build/C/man3/wcscasecmp.3:13 build/C/man3/wcsdup.3:13 build/C/man3/wcsncasecmp.3:13
1356 #: build/C/man3/wcscasecmp.3:16
1357 msgid "wcscasecmp - compare two wide-character strings, ignoring case"
1361 #: build/C/man3/wcscasecmp.3:21
1363 msgid "B<int wcscasecmp(const wchar_t *>I<s1>B<, const wchar_t *>I<s2>B<);>\n"
1367 #: build/C/man3/wcscasecmp.3:29
1368 msgid "B<wcscasecmp>():"
1372 #: build/C/man3/wcscasecmp.3:52
1374 "The B<wcscasecmp>() function is the wide-character equivalent of the "
1375 "B<strcasecmp>(3) function. It compares the wide-character string pointed "
1376 "to by I<s1> and the wide-character string pointed to by I<s2>, ignoring case "
1377 "differences (B<towupper>(3), B<towlower>(3))."
1381 #: build/C/man3/wcscasecmp.3:62
1383 "The B<wcscasecmp>() function returns zero if the wide-character strings at "
1384 "I<s1> and I<s2> are equal except for case distinctions. It returns a "
1385 "positive integer if I<s1> is greater than I<s2>, ignoring case. It returns "
1386 "a negative integer if I<s1> is smaller than I<s2>, ignoring case."
1390 #: build/C/man3/wcscasecmp.3:62 build/C/man3/wcsncasecmp.3:65 build/C/man3/wcsnlen.3:63
1396 #: build/C/man3/wcscasecmp.3:66
1397 msgid "The B<wcscasecmp>() function is provided in glibc since version 2.1."
1401 #: build/C/man3/wcscasecmp.3:70 build/C/man3/wcsdup.3:71 build/C/man3/wcsncasecmp.3:73
1403 "POSIX.1-2008. This function is not specified in POSIX.1-2001, and is not "
1404 "widely available on other systems."
1408 #: build/C/man3/wcscasecmp.3:77
1410 "The behavior of B<wcscasecmp>() depends on the B<LC_CTYPE> category of the "
1415 #: build/C/man3/wcscasecmp.3:80
1416 msgid "B<strcasecmp>(3), B<wcscmp>(3)"
1420 #: build/C/man3/wcscat.3:14
1426 #: build/C/man3/wcscat.3:17
1427 msgid "wcscat - concatenate two wide-character strings"
1431 #: build/C/man3/wcscat.3:22
1433 msgid "B<wchar_t *wcscat(wchar_t *>I<dest>B<, const wchar_t *>I<src>B<);>\n"
1437 #: build/C/man3/wcscat.3:33
1439 "The B<wcscat>() function is the wide-character equivalent of the "
1440 "B<strcat>(3) function. It copies the wide-character string pointed to by "
1441 "I<src>, including the terminating null wide character (L\\(aq\\e0\\(aq), to "
1442 "the end of the wide-character string pointed to by I<dest>."
1446 #: build/C/man3/wcscat.3:38
1448 "The programmer must ensure that there is room for at least I<wcslen(dest) + "
1449 "wcslen(src) + 1> wide characters at I<dest>."
1453 #: build/C/man3/wcscat.3:41
1454 msgid "B<wcscat>() returns I<dest>."
1458 #: build/C/man3/wcscat.3:48
1459 msgid "B<strcat>(3), B<wcpcpy>(3), B<wcscpy>(3), B<wcsncat>(3)"
1463 #: build/C/man3/wcschr.3:14
1469 #: build/C/man3/wcschr.3:17
1470 msgid "wcschr - search a wide character in a wide-character string"
1474 #: build/C/man3/wcschr.3:22
1476 msgid "B<wchar_t *wcschr(const wchar_t *>I<wcs>B<, wchar_t >I<wc>B<);>\n"
1480 #: build/C/man3/wcschr.3:32
1482 "The B<wcschr>() function is the wide-character equivalent of the "
1483 "B<strchr>(3) function. It searches the first occurrence of I<wc> in the "
1484 "wide-character string pointed to by I<wcs>."
1488 #: build/C/man3/wcschr.3:38
1490 "The B<wcschr>() function returns a pointer to the first occurrence of I<wc> "
1491 "in the wide-character string pointed to by I<wcs>, or NULL if I<wc> does not "
1492 "occur in the string."
1496 #: build/C/man3/wcschr.3:46
1497 msgid "B<strchr>(3), B<wcspbrk>(3), B<wcsrchr>(3), B<wcsstr>(3), B<wmemchr>(3)"
1501 #: build/C/man3/wcscmp.3:14
1507 #: build/C/man3/wcscmp.3:17
1508 msgid "wcscmp - compare two wide-character strings"
1512 #: build/C/man3/wcscmp.3:22
1514 msgid "B<int wcscmp(const wchar_t *>I<s1>B<, const wchar_t *>I<s2>B<);>\n"
1518 #: build/C/man3/wcscmp.3:32
1520 "The B<wcscmp>() function is the wide-character equivalent of the "
1521 "B<strcmp>(3) function. It compares the wide-character string pointed to by "
1522 "I<s1> and the wide-character string pointed to by I<s2>."
1526 #: build/C/man3/wcscmp.3:43
1528 "The B<wcscmp>() function returns zero if the wide-character strings at "
1529 "I<s1> and I<s2> are equal. It returns an integer greater than zero if at "
1530 "the first differing position I<i>, the corresponding wide-character I<s1[i]> "
1531 "is greater than I<s2[i]>. It returns an integer less than zero if at the "
1532 "first differing position I<i>, the corresponding wide-character I<s1[i]> is "
1533 "less than I<s2[i]>."
1537 #: build/C/man3/wcscmp.3:49
1538 msgid "B<strcmp>(3), B<wcscasecmp>(3), B<wmemcmp>(3)"
1542 #: build/C/man3/wcscpy.3:14
1548 #: build/C/man3/wcscpy.3:17
1549 msgid "wcscpy - copy a wide-character string"
1553 #: build/C/man3/wcscpy.3:22
1555 msgid "B<wchar_t *wcscpy(wchar_t *>I<dest>B<, const wchar_t *>I<src>B<);>\n"
1559 #: build/C/man3/wcscpy.3:34
1561 "The B<wcscpy>() function is the wide-character equivalent of the "
1562 "B<strcpy>(3) function. It copies the wide-character string pointed to by "
1563 "I<src>, including the terminating null wide character (L\\(aq\\e0\\(aq), to "
1564 "the array pointed to by I<dest>."
1568 #: build/C/man3/wcscpy.3:43
1569 msgid "B<wcscpy>() returns I<dest>."
1573 #: build/C/man3/wcscpy.3:51
1574 msgid "B<strcpy>(3), B<wcpcpy>(3), B<wcscat>(3), B<wcsdup>(3), B<wmemcpy>(3)"
1578 #: build/C/man3/wcscspn.3:14
1584 #: build/C/man3/wcscspn.3:17
1585 msgid "wcscspn - search a wide-character string for any of a set of wide characters"
1589 #: build/C/man3/wcscspn.3:22
1591 msgid "B<size_t wcscspn(const wchar_t *>I<wcs>B<, const wchar_t *>I<reject>B<);>\n"
1595 #: build/C/man3/wcscspn.3:36
1597 "The B<wcscspn>() function is the wide-character equivalent of the "
1598 "B<strcspn>(3) function. It determines the length of the longest initial "
1599 "segment of I<wcs> which consists entirely of wide-characters not listed in "
1600 "I<reject>. In other words, it searches for the first occurrence in the "
1601 "wide-character string I<wcs> of any of the characters in the wide-character "
1606 #: build/C/man3/wcscspn.3:48
1608 "The B<wcscspn>() function returns the number of wide characters in the "
1609 "longest initial segment of I<wcs> which consists entirely of wide-characters "
1610 "not listed in I<reject>. In other words, it returns the position of the "
1611 "first occurrence in the wide-character string I<wcs> of any of the "
1612 "characters in the wide-character string I<reject>, or I<wcslen(wcs)> if "
1617 #: build/C/man3/wcscspn.3:54
1618 msgid "B<strcspn>(3), B<wcspbrk>(3), B<wcsspn>(3)"
1622 #: build/C/man3/wcsdup.3:13
1628 #: build/C/man3/wcsdup.3:16
1629 msgid "wcsdup - duplicate a wide-character string"
1633 #: build/C/man3/wcsdup.3:21
1635 msgid "B<wchar_t *wcsdup(const wchar_t *>I<s>B<);>\n"
1639 #: build/C/man3/wcsdup.3:29
1640 msgid "B<wcsdup>():"
1644 #: build/C/man3/wcsdup.3:50
1646 "The B<wcsdup>() function is the wide-character equivalent of the "
1647 "B<strdup>(3) function. It allocates and returns a new wide-character "
1648 "string whose initial contents is a duplicate of the wide-character string "
1649 "pointed to by I<s>."
1653 #: build/C/man3/wcsdup.3:56
1655 "Memory for the new wide-character string is obtained with B<malloc>(3), and "
1656 "should be freed with B<free>(3)."
1660 #: build/C/man3/wcsdup.3:62
1662 "The B<wcsdup>() function returns a pointer to the new wide-character "
1663 "string, or NULL if sufficient memory was not available."
1667 #: build/C/man3/wcsdup.3:62
1673 #: build/C/man3/wcsdup.3:63
1679 #: build/C/man3/wcsdup.3:66
1680 msgid "Insufficient memory available to allocate duplicate string."
1684 #: build/C/man3/wcsdup.3:74
1685 msgid "B<strdup>(3), B<wcscpy>(3)"
1689 #: build/C/man3/wcslen.3:14
1695 #: build/C/man3/wcslen.3:17
1696 msgid "wcslen - determine the length of a wide-character string"
1700 #: build/C/man3/wcslen.3:22
1702 msgid "B<size_t wcslen(const wchar_t *>I<s>B<);>\n"
1706 #: build/C/man3/wcslen.3:32
1708 "The B<wcslen>() function is the wide-character equivalent of the "
1709 "B<strlen>(3) function. It determines the length of the wide-character "
1710 "string pointed to by I<s>, excluding the terminating null wide character "
1711 "(L\\(aq\\e0\\(aq)."
1715 #: build/C/man3/wcslen.3:37
1716 msgid "The B<wcslen>() function returns the number of wide characters in I<s>."
1720 #: build/C/man3/wcslen.3:41
1721 msgid "B<strlen>(3)"
1725 #: build/C/man3/wcsncasecmp.3:13
1731 #: build/C/man3/wcsncasecmp.3:16
1732 msgid "wcsncasecmp - compare two fixed-size wide-character strings, ignoring case"
1736 #: build/C/man3/wcsncasecmp.3:21
1739 "B<int wcsncasecmp(const wchar_t *>I<s1>B<, const wchar_t *>I<s2>B<, size_t "
1744 #: build/C/man3/wcsncasecmp.3:29
1745 msgid "B<wcsncasecmp>():"
1749 #: build/C/man3/wcsncasecmp.3:53
1751 "The B<wcsncasecmp>() function is the wide-character equivalent of the "
1752 "B<strncasecmp>(3) function. It compares the wide-character string pointed "
1753 "to by I<s1> and the wide-character string pointed to by I<s2>, but at most "
1754 "I<n> wide characters from each string, ignoring case differences "
1755 "(B<towupper>(3), B<towlower>(3))."
1759 #: build/C/man3/wcsncasecmp.3:65
1761 "The B<wcsncasecmp>() function returns zero if the wide-character strings at "
1762 "I<s1> and I<s2>, truncated to at most length I<n>, are equal except for case "
1763 "distinctions. It returns a positive integer if truncated I<s1> is greater "
1764 "than truncated I<s2>, ignoring case. It returns a negative integer if "
1765 "truncated I<s1> is smaller than truncated I<s2>, ignoring case."
1769 #: build/C/man3/wcsncasecmp.3:69
1770 msgid "The B<wcsncasecmp>() function is provided in glibc since version 2.1."
1774 #: build/C/man3/wcsncasecmp.3:80
1776 "The behavior of B<wcsncasecmp>() depends on the B<LC_CTYPE> category of the "
1781 #: build/C/man3/wcsncasecmp.3:83
1782 msgid "B<strncasecmp>(3), B<wcsncmp>(3)"
1786 #: build/C/man3/wcsncat.3:14
1792 #: build/C/man3/wcsncat.3:17
1793 msgid "wcsncat - concatenate two wide-character strings"
1797 #: build/C/man3/wcsncat.3:22
1800 "B<wchar_t *wcsncat(wchar_t *>I<dest>B<, const wchar_t *>I<src>B<, size_t "
1805 #: build/C/man3/wcsncat.3:32
1807 "The B<wcsncat>() function is the wide-character equivalent of the "
1808 "B<strncat>(3) function. It copies at most I<n> wide characters from the "
1809 "wide-character string pointed to by I<src> to the end of the wide-character "
1810 "string pointed to by I<dest>, and adds a terminating null wide character "
1811 "(L\\(aq\\e0\\(aq)."
1815 #: build/C/man3/wcsncat.3:37
1817 "The programmer must ensure that there is room for at least I<wcslen(dest) + "
1818 "n + 1> wide characters at I<dest>."
1822 #: build/C/man3/wcsncat.3:40
1823 msgid "B<wcsncat>() returns I<dest>."
1827 #: build/C/man3/wcsncat.3:45
1828 msgid "B<strncat>(3), B<wcscat>(3)"
1832 #: build/C/man3/wcsncmp.3:14
1838 #: build/C/man3/wcsncmp.3:17
1839 msgid "wcsncmp - compare two fixed-size wide-character strings"
1843 #: build/C/man3/wcsncmp.3:22
1846 "B<int wcsncmp(const wchar_t *>I<s1>B<, const wchar_t *>I<s2>B<, size_t "
1851 #: build/C/man3/wcsncmp.3:34
1853 "The B<wcsncmp>() function is the wide-character equivalent of the "
1854 "B<strncmp>(3) function. It compares the wide-character string pointed to "
1855 "by I<s1> and the wide-character string pointed to by I<s2>, but at most I<n> "
1856 "wide characters from each string. In each string, the comparison extends "
1857 "only up to the first occurrence of a nulll wide character (L\\(aq\\e0\\(aq), "
1862 #: build/C/man3/wcsncmp.3:46
1864 "The B<wcsncmp>() function returns zero if the wide-character strings at "
1865 "I<s1> and I<s2>, truncated to at most length I<n>, are equal. It returns an "
1866 "integer greater than zero if at the first differing position I<i> (I<i> "
1867 "E<lt> I<n>), the corresponding wide-character I<s1[i]> is greater than "
1868 "I<s2[i]>. It returns an integer less than zero if at the first differing "
1869 "position I<i> (I<i> E<lt> I<n>), the corresponding wide-character I<s1[i]> "
1870 "is less than I<s2[i]>."
1874 #: build/C/man3/wcsncmp.3:51
1875 msgid "B<strncmp>(3), B<wcsncasecmp>(3)"
1879 #: build/C/man3/wcsncpy.3:14
1885 #: build/C/man3/wcsncpy.3:17
1886 msgid "wcsncpy - copy a fixed-size string of wide characters"
1890 #: build/C/man3/wcsncpy.3:22
1893 "B<wchar_t *wcsncpy(wchar_t *>I<dest>B<, const wchar_t *>I<src>B<, size_t "
1898 #: build/C/man3/wcsncpy.3:42
1900 "The B<wcsncpy>() function is the wide-character equivalent of the "
1901 "B<strncpy>(3) function. It copies at most I<n> wide characters from the "
1902 "wide-character string pointed to by I<src>, including the terminating null "
1903 "wide character (L\\(aq\\e0\\(aq), to the array pointed to by I<dest>. "
1904 "Exactly I<n> wide characters are written at I<dest>. If the length "
1905 "I<wcslen(src)> is smaller than I<n>, the remaining wide characters in the "
1906 "array pointed to by I<dest> are filled with null wide characters. If the "
1907 "length I<wcslen(src)> is greater or equal to I<n>, the string pointed to by "
1908 "I<dest> will not be terminated by a null wide character."
1912 #: build/C/man3/wcsncpy.3:50
1913 msgid "B<wcsncpy>() returns I<dest>."
1917 #: build/C/man3/wcsncpy.3:54
1918 msgid "B<strncpy>(3)"
1922 #: build/C/man3/wcsnlen.3:13
1928 #: build/C/man3/wcsnlen.3:16
1929 msgid "wcsnlen - determine the length of a fixed-size wide-character string"
1933 #: build/C/man3/wcsnlen.3:21
1935 msgid "B<size_t wcsnlen(const wchar_t *>I<s>B<, size_t >I<maxlen>B<);>\n"
1939 #: build/C/man3/wcsnlen.3:29
1940 msgid "B<wcsnlen>():"
1944 #: build/C/man3/wcsnlen.3:57
1946 "The B<wcsnlen>() function is the wide-character equivalent of the "
1947 "B<strnlen>(3) function. It returns the number of wide-characters in the "
1948 "string pointed to by I<s>, not including the terminating null wide character "
1949 "(L\\(aq\\e0\\(aq), but at most I<maxlen> wide characters (note: this "
1950 "parameter is not a byte count). In doing this, B<wcsnlen>() looks only at "
1951 "the first I<maxlen> wide characters at I<s> and never beyond I<s+maxlen>."
1955 #: build/C/man3/wcsnlen.3:63
1957 "The B<wcsnlen>() function returns I<wcslen(s)>, if that is less than "
1958 "I<maxlen>, or I<maxlen> if there is no null wide character among the first "
1959 "I<maxlen> wide characters pointed to by I<s>."
1963 #: build/C/man3/wcsnlen.3:67
1964 msgid "The B<wcsnlen>() function is provided in glibc since version 2.1."
1968 #: build/C/man3/wcsnlen.3:72
1969 msgid "B<strnlen>(3), B<wcslen>(3)"
1973 #: build/C/man3/wcsnrtombs.3:13
1979 #: build/C/man3/wcsnrtombs.3:13 build/C/man3/wcsrtombs.3:14
1985 #: build/C/man3/wcsnrtombs.3:16
1986 msgid "wcsnrtombs - convert a wide-character string to a multibyte string"
1990 #: build/C/man3/wcsnrtombs.3:22
1993 "B<size_t wcsnrtombs(char *>I<dest>B<, const wchar_t **>I<src>B<, size_t "
1995 "B< size_t >I<len>B<, mbstate_t *>I<ps>B<);>\n"
1999 #: build/C/man3/wcsnrtombs.3:30
2000 msgid "B<wcsnrtombs>():"
2004 #: build/C/man3/wcsnrtombs.3:50
2006 "The B<wcsnrtombs>() function is like the B<wcsrtombs>(3) function, except "
2007 "that the number of wide characters to be converted, starting at I<*src>, is "
2008 "limited to I<nwc>."
2012 #: build/C/man3/wcsnrtombs.3:69
2014 "If I<dest> is not a NULL pointer, the B<wcsnrtombs>() function converts at "
2015 "most I<nwc> wide characters from the wide-character string I<*src> to a "
2016 "multibyte string starting at I<dest>. At most I<len> bytes are written to "
2017 "I<dest>. The shift state I<*ps> is updated. The conversion is effectively "
2018 "performed by repeatedly calling I<wcrtomb(dest, *src, ps)>, as long as this "
2019 "call succeeds, and then incrementing I<dest> by the number of bytes written "
2020 "and I<*src> by one. The conversion can stop for three reasons:"
2024 #: build/C/man3/wcsnrtombs.3:77 build/C/man3/wcsrtombs.3:52
2026 "1. A wide character has been encountered that can not be represented as a "
2027 "multibyte sequence (according to the current locale). In this case I<*src> "
2028 "is left pointing to the invalid wide character, I<(size_t)\\ -1> is "
2029 "returned, and I<errno> is set to B<EILSEQ>."
2033 #: build/C/man3/wcsnrtombs.3:84
2035 "2. I<nwc> wide characters have been converted without encountering a null "
2036 "wide character (L\\(aq\\e0\\(aq), or the length limit forces a stop. In "
2037 "this case I<*src> is left pointing to the next wide character to be "
2038 "converted, and the number of bytes written to I<dest> is returned."
2042 #: build/C/man3/wcsnrtombs.3:92
2044 "3. The wide-character string has been completely converted, including the "
2045 "terminating null wide character (which has the side effect of bringing back "
2046 "I<*ps> to the initial state). In this case I<*src> is set to NULL, and the "
2047 "number of bytes written to I<dest>, excluding the terminating null byte "
2048 "(\\(aq\\e0\\(aq), is returned."
2052 #: build/C/man3/wcsnrtombs.3:97
2054 "If I<dest> is NULL, I<len> is ignored, and the conversion proceeds as above, "
2055 "except that the converted bytes are not written out to memory, and that no "
2056 "destination length limit exists."
2060 #: build/C/man3/wcsnrtombs.3:101
2062 "In both of the above cases, if I<ps> is a NULL pointer, a static anonymous "
2063 "state only known to the wcsnrtombs function is used instead."
2067 #: build/C/man3/wcsnrtombs.3:104 build/C/man3/wcsrtombs.3:79
2069 "The programmer must ensure that there is room for at least I<len> bytes at "
2074 #: build/C/man3/wcsnrtombs.3:115
2076 "The B<wcsnrtombs>() function returns the number of bytes that make up the "
2077 "converted part of multibyte sequence, not including the terminating null "
2078 "byte. If a wide character was encountered which could not be converted, "
2079 "I<(size_t)\\ -1> is returned, and I<errno> set to B<EILSEQ>."
2083 #: build/C/man3/wcsnrtombs.3:124
2085 "The behavior of B<wcsnrtombs>() depends on the B<LC_CTYPE> category of the "
2090 #: build/C/man3/wcsnrtombs.3:129
2091 msgid "B<iconv>(3), B<wcsrtombs>(3)"
2095 #: build/C/man3/wcspbrk.3:14
2101 #: build/C/man3/wcspbrk.3:17
2102 msgid "wcspbrk - search a wide-character string for any of a set of wide characters"
2106 #: build/C/man3/wcspbrk.3:22
2109 "B<wchar_t *wcspbrk(const wchar_t *>I<wcs>B<, const wchar_t "
2110 "*>I<accept>B<);>\n"
2114 #: build/C/man3/wcspbrk.3:34
2116 "The B<wcspbrk>() function is the wide-character equivalent of the "
2117 "B<strpbrk>(3) function. It searches for the first occurrence in the "
2118 "wide-character string pointed to by I<wcs> of any of the characters in the "
2119 "wide-character string pointed to by I<accept>."
2123 #: build/C/man3/wcspbrk.3:41
2125 "The B<wcspbrk>() function returns a pointer to the first occurrence in "
2126 "I<wcs> of any of the characters listed in I<accept>. If I<wcs> contains "
2127 "none of these characters, NULL is returned."
2131 #: build/C/man3/wcspbrk.3:47
2132 msgid "B<strpbrk>(3), B<wcschr>(3), B<wcscspn>(3)"
2136 #: build/C/man3/wcsrchr.3:14
2142 #: build/C/man3/wcsrchr.3:17
2143 msgid "wcsrchr - search a wide character in a wide-character string"
2147 #: build/C/man3/wcsrchr.3:22
2149 msgid "B<wchar_t *wcsrchr(const wchar_t *>I<wcs>B<, wchar_t >I<wc>B<);>\n"
2153 #: build/C/man3/wcsrchr.3:32
2155 "The B<wcsrchr>() function is the wide-character equivalent of the "
2156 "B<strrchr>(3) function. It searches the last occurrence of I<wc> in the "
2157 "wide-character string pointed to by I<wcs>."
2161 #: build/C/man3/wcsrchr.3:38
2163 "The B<wcsrchr>() function returns a pointer to the last occurrence of I<wc> "
2164 "in the wide-character string pointed to by I<wcs>, or NULL if I<wc> does not "
2165 "occur in the string."
2169 #: build/C/man3/wcsrchr.3:43
2170 msgid "B<strrchr>(3), B<wcschr>(3)"
2174 #: build/C/man3/wcsrtombs.3:14
2180 #: build/C/man3/wcsrtombs.3:17
2181 msgid "wcsrtombs - convert a wide-character string to a multibyte string"
2185 #: build/C/man3/wcsrtombs.3:23
2188 "B<size_t wcsrtombs(char *>I<dest>B<, const wchar_t **>I<src>B<,>\n"
2189 "B< size_t >I<len>B<, mbstate_t *>I<ps>B<);>\n"
2193 #: build/C/man3/wcsrtombs.3:42
2195 "If I<dest> is not a NULL pointer, the B<wcsrtombs>() function converts the "
2196 "wide-character string I<*src> to a multibyte string starting at I<dest>. At "
2197 "most I<len> bytes are written to I<dest>. The shift state I<*ps> is "
2198 "updated. The conversion is effectively performed by repeatedly calling "
2199 "I<wcrtomb(dest, *src, ps)>, as long as this call succeeds, and then "
2200 "incrementing I<dest> by the number of bytes written and I<*src> by one. The "
2201 "conversion can stop for three reasons:"
2205 #: build/C/man3/wcsrtombs.3:58
2207 "2. The length limit forces a stop. In this case I<*src> is left pointing to "
2208 "the next wide character to be converted, and the number of bytes written to "
2209 "I<dest> is returned."
2213 #: build/C/man3/wcsrtombs.3:67
2215 "3. The wide-character string has been completely converted, including the "
2216 "terminating null wide character (L\\(aq\\e0\\(aq), which has the side effect "
2217 "of bringing back I<*ps> to the initial state. In this case I<*src> is set "
2218 "to NULL, and the number of bytes written to I<dest>, excluding the "
2219 "terminating null byte (\\(aq\\e0\\(aq), is returned."
2223 #: build/C/man3/wcsrtombs.3:72
2225 "If I<dest> is NULL, I<len> is ignored, and the conversion proceeds as above, "
2226 "except that the converted bytes are not written out to memory, and that no "
2227 "length limit exists."
2231 #: build/C/man3/wcsrtombs.3:76
2233 "In both of the above cases, if I<ps> is a NULL pointer, a static anonymous "
2234 "state only known to the wcsrtombs function is used instead."
2238 #: build/C/man3/wcsrtombs.3:92
2240 "The B<wcsrtombs>() function returns the number of bytes that make up the "
2241 "converted part of multibyte sequence, not including the terminating null "
2242 "byte. If a wide character was encountered which could not be converted, "
2243 "I<(size_t)\\ -1> is returned, and I<errno> set to B<EILSEQ>."
2247 #: build/C/man3/wcsrtombs.3:101
2249 "The behavior of B<wcsrtombs>() depends on the B<LC_CTYPE> category of the "
2254 #: build/C/man3/wcsrtombs.3:107
2255 msgid "B<iconv>(3), B<wcsnrtombs>(3), B<wcstombs>(3)"
2259 #: build/C/man3/wcsspn.3:14
2265 #: build/C/man3/wcsspn.3:18
2267 "wcsspn - advance in a wide-character string, skipping any of a set of wide "
2272 #: build/C/man3/wcsspn.3:23
2274 msgid "B<size_t wcsspn(const wchar_t *>I<wcs>B<, const wchar_t *>I<accept>B<);>\n"
2278 #: build/C/man3/wcsspn.3:36
2280 "The B<wcsspn>() function is the wide-character equivalent of the "
2281 "B<strspn>(3) function. It determines the length of the longest initial "
2282 "segment of I<wcs> which consists entirely of wide-characters listed in "
2283 "I<accept>. In other words, it searches for the first occurrence in the "
2284 "wide-character string I<wcs> of a wide-character not contained in the "
2285 "wide-character string I<accept>."
2289 #: build/C/man3/wcsspn.3:47
2291 "The B<wcsspn>() function returns the number of wide characters in the "
2292 "longest initial segment of I<wcs> which consists entirely of wide-characters "
2293 "listed in I<accept>. In other words, it returns the position of the first "
2294 "occurrence in the wide-character string I<wcs> of a wide-character not "
2295 "contained in the wide-character string I<accept>, or I<wcslen(wcs)> if there "
2300 #: build/C/man3/wcsspn.3:52
2301 msgid "B<strspn>(3), B<wcscspn>(3)"
2305 #: build/C/man3/wcsstr.3:14
2311 #: build/C/man3/wcsstr.3:17
2312 msgid "wcsstr - locate a substring in a wide-character string"
2316 #: build/C/man3/wcsstr.3:22
2319 "B<wchar_t *wcsstr(const wchar_t *>I<haystack>B<, const wchar_t "
2320 "*>I<needle>B<);>\n"
2324 #: build/C/man3/wcsstr.3:32
2326 "The B<wcsstr>() function is the wide-character equivalent of the "
2327 "B<strstr>(3) function. It searches for the first occurrence of the "
2328 "wide-character string I<needle> (without its terminating null wide character "
2329 "(L\\(aq\\e0\\(aq)) as a substring in the wide-character string I<haystack>."
2333 #: build/C/man3/wcsstr.3:39
2335 "The B<wcsstr>() function returns a pointer to the first occurrence of "
2336 "I<needle> in I<haystack>. It returns NULL if I<needle> does not occur as a "
2337 "substring in I<haystack>."
2341 #: build/C/man3/wcsstr.3:43
2343 "Note the special case: If I<needle> is the empty wide-character string, the "
2344 "return value is always I<haystack> itself."
2348 #: build/C/man3/wcsstr.3:48
2349 msgid "B<strstr>(3), B<wcschr>(3)"
2353 #: build/C/man3/wcstoimax.3:23
2359 #: build/C/man3/wcstoimax.3:23
2365 #: build/C/man3/wcstoimax.3:26
2366 msgid "wcstoimax, wcstoumax - convert wide-character string to integer"
2370 #: build/C/man3/wcstoimax.3:29
2372 msgid "B<#include E<lt>stddef.hE<gt>>\n"
2376 #: build/C/man3/wcstoimax.3:31
2378 msgid "B<#include E<lt>inttypes.hE<gt>>\n"
2382 #: build/C/man3/wcstoimax.3:34
2385 "B<intmax_t wcstoimax(const wchar_t *>I<nptr>B<, wchar_t **>I<endptr>B<, int "
2390 #: build/C/man3/wcstoimax.3:37
2393 "B<uintmax_t wcstoumax(const wchar_t *>I<nptr>B<, wchar_t **>I<endptr>B<, int "
2398 #: build/C/man3/wcstoimax.3:48
2400 "These functions are just like B<wcstol>(3) and B<wcstoul>(3), except that "
2401 "they return a value of type I<intmax_t> and I<uintmax_t>, respectively."
2404 #. FIXME . the pages referred to by the following xrefs are not yet written
2406 #: build/C/man3/wcstoimax.3:58
2408 "B<imaxabs>(3), B<imaxdiv>(3), B<strtoimax>(3), B<strtoumax>(3), "
2409 "B<wcstol>(3), B<wcstoul>(3)"
2413 #: build/C/man3/wcstok.3:14
2419 #: build/C/man3/wcstok.3:17
2420 msgid "wcstok - split wide-character string into tokens"
2424 #: build/C/man3/wcstok.3:23
2427 "B<wchar_t *wcstok(wchar_t *>I<wcs>B<, const wchar_t *>I<delim>B<, wchar_t "
2432 #: build/C/man3/wcstok.3:34
2434 "The B<wcstok>() function is the wide-character equivalent of the "
2435 "B<strtok>(3) function, with an added argument to make it multithread-safe. "
2436 "It can be used to split a wide-character string I<wcs> into tokens, where a "
2437 "token is defined as a substring not containing any wide-characters from "
2442 #: build/C/man3/wcstok.3:55
2444 "The search starts at I<wcs>, if I<wcs> is not NULL, or at I<*ptr>, if I<wcs> "
2445 "is NULL. First, any delimiter wide-characters are skipped, that is, the "
2446 "pointer is advanced beyond any wide-characters which occur in I<delim>. If "
2447 "the end of the wide-character string is now reached, B<wcstok>() returns "
2448 "NULL, to indicate that no tokens were found, and stores an appropriate value "
2449 "in I<*ptr>, so that subsequent calls to B<wcstok>() will continue to return "
2450 "NULL. Otherwise, the B<wcstok>() function recognizes the beginning of a "
2451 "token and returns a pointer to it, but before doing that, it zero-terminates "
2452 "the token by replacing the next wide-character which occurs in I<delim> with "
2453 "a null wide character (L\\(aq\\e0\\(aq), and it updates I<*ptr> so that "
2454 "subsequent calls will continue searching after the end of recognized token."
2458 #: build/C/man3/wcstok.3:60
2460 "The B<wcstok>() function returns a pointer to the next token, or NULL if no "
2461 "further token was found."
2465 #: build/C/man3/wcstok.3:65
2467 "The original I<wcs> wide-character string is destructively modified during "
2472 #: build/C/man3/wcstok.3:65
2478 #: build/C/man3/wcstok.3:67
2480 "The following code loops over the tokens contained in a wide-character "
2485 #: build/C/man3/wcstok.3:77
2488 "wchar_t *wcs = ...;\n"
2491 "for (token = wcstok(wcs, \" \\et\\en\", &state);\n"
2493 " token = wcstok(NULL, \" \\et\\en\", &state)) {\n"
2499 #: build/C/man3/wcstok.3:81
2500 msgid "B<strtok>(3), B<wcschr>(3)"
2504 #: build/C/man3/wcswidth.3:13
2510 #: build/C/man3/wcswidth.3:13
2516 #: build/C/man3/wcswidth.3:16
2517 msgid "wcswidth - determine columns needed for a fixed-size wide-character string"
2521 #: build/C/man3/wcswidth.3:20
2524 "B<#define _XOPEN_SOURCE> /* See feature_test_macros(7) */\n"
2525 "B<#include E<lt>wchar.hE<gt>>\n"
2529 #: build/C/man3/wcswidth.3:22
2531 msgid "B<int wcswidth(const wchar_t *>I<s>B<, size_t >I<n>B<);>\n"
2535 #: build/C/man3/wcswidth.3:32
2537 "The B<wcswidth>() function returns the number of columns needed to "
2538 "represent the wide-character string pointed to by I<s>, but at most I<n> "
2539 "wide characters. If a nonprintable wide character occurs among these "
2540 "characters, -1 is returned."
2544 #: build/C/man3/wcswidth.3:38
2546 "The B<wcswidth>() function returns the number of column positions for the "
2547 "wide-character string I<s>, truncated to at most length I<n>."
2551 #: build/C/man3/wcswidth.3:40 build/C/man3/wcwidth.3:39
2552 msgid "POSIX.1-2001."
2556 #: build/C/man3/wcswidth.3:47
2558 "The behavior of B<wcswidth>() depends on the B<LC_CTYPE> category of the "
2563 #: build/C/man3/wcswidth.3:50
2564 msgid "B<iswprint>(3), B<wcwidth>(3)"
2568 #: build/C/man3/wctob.3:14
2574 #: build/C/man3/wctob.3:17
2575 msgid "wctob - try to represent a wide character as a single byte"
2579 #: build/C/man3/wctob.3:22
2581 msgid "B<int wctob(wint_t >I<c>B<);>\n"
2585 #: build/C/man3/wctob.3:32
2587 "The B<wctob>() function tests whether the multibyte representation of the "
2588 "wide character I<c>, starting in the initial state, consists of a single "
2589 "byte. If so, it is returned as an I<unsigned char>."
2593 #: build/C/man3/wctob.3:38
2595 "Never use this function. It cannot help you in writing internationalized "
2596 "programs. Internationalized programs must never distinguish single-byte and "
2597 "multibyte characters."
2601 #: build/C/man3/wctob.3:43
2603 "The B<wctob>() function returns the single-byte representation of I<c>, if "
2604 "it exists, of B<EOF> otherwise."
2608 #: build/C/man3/wctob.3:52
2610 "The behavior of B<wctob>() depends on the B<LC_CTYPE> category of the "
2615 #: build/C/man3/wctob.3:61
2617 "This function should never be used. Internationalized programs must never "
2618 "distinguish single-byte and multibyte characters. Use either B<wctomb>(3) "
2619 "or the thread-safe B<wcrtomb>(3) instead."
2623 #: build/C/man3/wctob.3:65
2624 msgid "B<btowc>(3), B<wcrtomb>(3), B<wctomb>(3)"
2628 #: build/C/man3/wcwidth.3:13
2634 #: build/C/man3/wcwidth.3:16
2635 msgid "wcwidth - determine columns needed for a wide character"
2639 #: build/C/man3/wcwidth.3:20
2642 "B<#define _XOPEN_SOURCE> /* See feature_test_macros(7) */\n"
2643 "B<#include E<lt>wchar.hE<gt>>\n"
2647 #: build/C/man3/wcwidth.3:22
2649 msgid "B<int wcwidth(wchar_t >I<c>B<);>\n"
2653 #: build/C/man3/wcwidth.3:32
2655 "The B<wcwidth>() function returns the number of columns needed to represent "
2656 "the wide character I<c>. If I<c> is a printable wide character, the value "
2657 "is at least 0. If I<c> is null wide character (L\\(aq\\e0\\(aq), the value "
2658 "is 0. Otherwise -1 is returned."
2662 #: build/C/man3/wcwidth.3:37
2663 msgid "The B<wcwidth>() function returns the number of column positions for I<c>."
2667 #: build/C/man3/wcwidth.3:41
2668 msgid "Note that glibc before 2.2.5 used the prototype"
2672 #: build/C/man3/wcwidth.3:44
2674 msgid "B<int wcwidth(wint_t >I<c>B<);>\n"
2678 #: build/C/man3/wcwidth.3:52
2680 "The behavior of B<wcwidth>() depends on the B<LC_CTYPE> category of the "
2685 #: build/C/man3/wcwidth.3:55
2686 msgid "B<iswprint>(3), B<wcswidth>(3)"
2690 #: build/C/man3/wmemchr.3:14
2696 #: build/C/man3/wmemchr.3:17
2697 msgid "wmemchr - search a wide character in a wide-character array"
2701 #: build/C/man3/wmemchr.3:22
2704 "B<wchar_t *wmemchr(const wchar_t *>I<s>B<, wchar_t >I<c>B<, size_t "
2709 #: build/C/man3/wmemchr.3:31
2711 "The B<wmemchr>() function is the wide-character equivalent of the "
2712 "B<memchr>(3) function. It searches the I<n> wide characters starting at "
2713 "I<s> for the first occurrence of the wide character I<c>."
2717 #: build/C/man3/wmemchr.3:37
2719 "The B<wmemchr>() function returns a pointer to the first occurrence of I<c> "
2720 "among the I<n> wide characters starting at I<s>, or NULL if I<c> does not "
2721 "occur among these."
2725 #: build/C/man3/wmemchr.3:42
2726 msgid "B<memchr>(3), B<wcschr>(3)"
2730 #: build/C/man3/wmemcmp.3:13
2736 #: build/C/man3/wmemcmp.3:16
2737 msgid "wmemcmp - compare two arrays of wide-characters"
2741 #: build/C/man3/wmemcmp.3:21
2744 "B<int wmemcmp(const wchar_t *>I<s1>B<, const wchar_t *>I<s2>B<, size_t "
2749 #: build/C/man3/wmemcmp.3:30
2751 "The B<wmemcmp>() function is the wide-character equivalent of the "
2752 "B<memcmp>(3) function. It compares the I<n> wide-characters starting at "
2753 "I<s1> and the I<n> wide-characters starting at I<s2>."
2757 #: build/C/man3/wmemcmp.3:44
2759 "The B<wmemcmp>() function returns zero if the wide-character arrays of size "
2760 "I<n> at I<s1> and I<s2> are equal. It returns an integer greater than zero "
2761 "if at the first differing position I<i> (I<i> E<lt> I<n>), the corresponding "
2762 "wide-character I<s1[i]> is greater than I<s2[i]>. It returns an integer "
2763 "less than zero if at the first differing position I<i> (I<i> E<lt> I<n>), "
2764 "the corresponding wide-character I<s1[i]> is less than I<s2[i]>."
2768 #: build/C/man3/wmemcmp.3:49
2769 msgid "B<memcmp>(3), B<wcscmp>(3)"
2773 #: build/C/man3/wmemcpy.3:14
2779 #: build/C/man3/wmemcpy.3:17
2780 msgid "wmemcpy - copy an array of wide-characters"
2784 #: build/C/man3/wmemcpy.3:22
2787 "B<wchar_t *wmemcpy(wchar_t *>I<dest>B<, const wchar_t *>I<src>B<, size_t "
2792 #: build/C/man3/wmemcpy.3:31
2794 "The B<wmemcpy>() function is the wide-character equivalent of the "
2795 "B<memcpy>(3) function. It copies I<n> wide characters from the array "
2796 "starting at I<src> to the array starting at I<dest>."
2800 #: build/C/man3/wmemcpy.3:36
2802 "The arrays may not overlap; use B<wmemmove>(3) to copy between overlapping "
2807 #: build/C/man3/wmemcpy.3:42
2808 msgid "B<wmemcpy>() returns I<dest>."
2812 #: build/C/man3/wmemcpy.3:49
2813 msgid "B<memcpy>(3), B<wcscpy>(3), B<wmemmove>(3), B<wmempcpy>(3)"
2817 #: build/C/man3/wmemmove.3:14
2823 #: build/C/man3/wmemmove.3:17
2824 msgid "wmemmove - copy an array of wide-characters"
2828 #: build/C/man3/wmemmove.3:22
2831 "B<wchar_t *wmemmove(wchar_t *>I<dest>B<, const wchar_t *>I<src>B<, size_t "
2836 #: build/C/man3/wmemmove.3:33
2838 "The B<wmemmove>() function is the wide-character equivalent of the "
2839 "B<memmove>(3) function. It copies I<n> wide characters from the array "
2840 "starting at I<src> to the array starting at I<dest>. The arrays may "
2845 #: build/C/man3/wmemmove.3:39
2846 msgid "B<wmemmove>() returns I<dest>."
2850 #: build/C/man3/wmemmove.3:44
2851 msgid "B<memmove>(3), B<wmemcpy>(3)"
2855 #: build/C/man3/wmemset.3:14
2861 #: build/C/man3/wmemset.3:17
2862 msgid "wmemset - fill an array of wide-characters with a constant wide character"
2866 #: build/C/man3/wmemset.3:22
2868 msgid "B<wchar_t *wmemset(wchar_t *>I<wcs>B<, wchar_t >I<wc>B<, size_t >I<n>B<);>\n"
2872 #: build/C/man3/wmemset.3:31
2874 "The B<wmemset>() function is the wide-character equivalent of the "
2875 "B<memset>(3) function. It fills the array of I<n> wide-characters starting "
2876 "at I<wcs> with I<n> copies of the wide character I<wc>."
2880 #: build/C/man3/wmemset.3:34
2881 msgid "B<wmemset>() returns I<wcs>."
2885 #: build/C/man3/wmemset.3:38
2886 msgid "B<memset>(3)"