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: 2015-01-04 23:49+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=UTF-8\n"
17 "Content-Transfer-Encoding: 8bit\n"
20 #: build/C/man3/btowc.3:16
26 #: build/C/man3/btowc.3:16 build/C/man3/wctob.3:16
32 #: build/C/man3/btowc.3:16 build/C/man3/fgetws.3:18 build/C/man3/fputws.3:16 build/C/man3/fwide.3:16 build/C/man3/getwchar.3:17 build/C/man3/mbrlen.3:16 build/C/man3/mbrtowc.3:17 build/C/man3/mbsinit.3:16 build/C/man3/mbsnrtowcs.3:15 build/C/man3/mbsrtowcs.3:16 build/C/man3/putwchar.3:17 build/C/man3/ungetwc.3:16 build/C/man3/wcpcpy.3:15 build/C/man3/wcpncpy.3:15 build/C/man3/wcrtomb.3:16 build/C/man3/wcscasecmp.3:15 build/C/man3/wcscat.3:16 build/C/man3/wcschr.3:16 build/C/man3/wcscmp.3:16 build/C/man3/wcscpy.3:16 build/C/man3/wcscspn.3:16 build/C/man3/wcsdup.3:15 build/C/man3/wcslen.3:16 build/C/man3/wcsncasecmp.3:15 build/C/man3/wcsncat.3:16 build/C/man3/wcsncmp.3:16 build/C/man3/wcsncpy.3:16 build/C/man3/wcsnlen.3:15 build/C/man3/wcsnrtombs.3:15 build/C/man3/wcspbrk.3:16 build/C/man3/wcsrchr.3:16 build/C/man3/wcsrtombs.3:16 build/C/man3/wcsspn.3:16 build/C/man3/wcsstr.3:16 build/C/man3/wcstok.3:16 build/C/man3/wcswidth.3:15 build/C/man3/wctob.3:16 build/C/man3/wcwidth.3:15 build/C/man3/wmemchr.3:16 build/C/man3/wmemcmp.3:15 build/C/man3/wmemcpy.3:16 build/C/man3/wmemmove.3:16 build/C/man3/wmemset.3:16
38 #: build/C/man3/btowc.3:16 build/C/man3/fgetws.3:18 build/C/man3/fputws.3:16 build/C/man3/fwide.3:16 build/C/man3/getwchar.3:17 build/C/man3/mbrlen.3:16 build/C/man3/mbrtowc.3:17 build/C/man3/mbsinit.3:16 build/C/man3/mbsnrtowcs.3:15 build/C/man3/mbsrtowcs.3:16 build/C/man3/putwchar.3:17 build/C/man3/ungetwc.3:16 build/C/man3/wcpcpy.3:15 build/C/man3/wcpncpy.3:15 build/C/man3/wcrtomb.3:16 build/C/man3/wcscasecmp.3:15 build/C/man3/wcscat.3:16 build/C/man3/wcschr.3:16 build/C/man3/wcscmp.3:16 build/C/man3/wcscpy.3:16 build/C/man3/wcscspn.3:16 build/C/man3/wcsdup.3:15 build/C/man3/wcslen.3:16 build/C/man3/wcsncasecmp.3:15 build/C/man3/wcsncat.3:16 build/C/man3/wcsncmp.3:16 build/C/man3/wcsncpy.3:16 build/C/man3/wcsnlen.3:15 build/C/man3/wcsnrtombs.3:15 build/C/man3/wcspbrk.3:16 build/C/man3/wcsrchr.3:16 build/C/man3/wcsrtombs.3:16 build/C/man3/wcsspn.3:16 build/C/man3/wcsstr.3:16 build/C/man3/wcstoimax.3:24 build/C/man3/wcstok.3:16 build/C/man3/wcswidth.3:15 build/C/man3/wctob.3:16 build/C/man3/wcwidth.3:15 build/C/man3/wmemchr.3:16 build/C/man3/wmemcmp.3:15 build/C/man3/wmemcpy.3:16 build/C/man3/wmemmove.3:16 build/C/man3/wmemset.3:16
40 msgid "Linux Programmer's Manual"
44 #: 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:16 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:17 build/C/man3/wcsstr.3:17 build/C/man3/wcstoimax.3:25 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
50 #: build/C/man3/btowc.3:19
51 msgid "btowc - convert single byte to wide character"
55 #: build/C/man3/btowc.3:19 build/C/man3/fgetws.3:21 build/C/man3/fputws.3:19 build/C/man3/fwide.3:19 build/C/man3/getwchar.3:20 build/C/man3/mbrlen.3:19 build/C/man3/mbrtowc.3:20 build/C/man3/mbsinit.3:19 build/C/man3/mbsnrtowcs.3:18 build/C/man3/mbsrtowcs.3:19 build/C/man3/putwchar.3:20 build/C/man3/ungetwc.3:19 build/C/man3/wcpcpy.3:18 build/C/man3/wcpncpy.3:19 build/C/man3/wcrtomb.3:19 build/C/man3/wcscasecmp.3:18 build/C/man3/wcscat.3:19 build/C/man3/wcschr.3:19 build/C/man3/wcscmp.3:19 build/C/man3/wcscpy.3:19 build/C/man3/wcscspn.3:19 build/C/man3/wcsdup.3:18 build/C/man3/wcslen.3:19 build/C/man3/wcsncasecmp.3:18 build/C/man3/wcsncat.3:19 build/C/man3/wcsncmp.3:19 build/C/man3/wcsncpy.3:19 build/C/man3/wcsnlen.3:18 build/C/man3/wcsnrtombs.3:18 build/C/man3/wcspbrk.3:19 build/C/man3/wcsrchr.3:19 build/C/man3/wcsrtombs.3:19 build/C/man3/wcsspn.3:20 build/C/man3/wcsstr.3:19 build/C/man3/wcstoimax.3:27 build/C/man3/wcstok.3:19 build/C/man3/wcswidth.3:18 build/C/man3/wctob.3:19 build/C/man3/wcwidth.3:18 build/C/man3/wmemchr.3:19 build/C/man3/wmemcmp.3:18 build/C/man3/wmemcpy.3:19 build/C/man3/wmemmove.3:19 build/C/man3/wmemset.3:19
61 #: build/C/man3/btowc.3:22 build/C/man3/fgetws.3:24 build/C/man3/fputws.3:22 build/C/man3/fwide.3:22 build/C/man3/getwchar.3:23 build/C/man3/mbrlen.3:22 build/C/man3/mbrtowc.3:23 build/C/man3/mbsinit.3:22 build/C/man3/mbsnrtowcs.3:21 build/C/man3/mbsrtowcs.3:22 build/C/man3/putwchar.3:23 build/C/man3/ungetwc.3:22 build/C/man3/wcpcpy.3:21 build/C/man3/wcpncpy.3:22 build/C/man3/wcrtomb.3:22 build/C/man3/wcscasecmp.3:21 build/C/man3/wcscat.3:22 build/C/man3/wcschr.3:22 build/C/man3/wcscmp.3:22 build/C/man3/wcscpy.3:22 build/C/man3/wcscspn.3:22 build/C/man3/wcsdup.3:21 build/C/man3/wcslen.3:22 build/C/man3/wcsncasecmp.3:21 build/C/man3/wcsncat.3:22 build/C/man3/wcsncmp.3:22 build/C/man3/wcsncpy.3:22 build/C/man3/wcsnlen.3:21 build/C/man3/wcsnrtombs.3:21 build/C/man3/wcspbrk.3:22 build/C/man3/wcsrchr.3:22 build/C/man3/wcsrtombs.3:22 build/C/man3/wcsspn.3:23 build/C/man3/wcsstr.3:22 build/C/man3/wcstok.3:22 build/C/man3/wctob.3:22 build/C/man3/wmemchr.3:22 build/C/man3/wmemcmp.3:21 build/C/man3/wmemcpy.3:22 build/C/man3/wmemmove.3:22 build/C/man3/wmemset.3:22
63 msgid "B<#include E<lt>wchar.hE<gt>>\n"
67 #: build/C/man3/btowc.3:24
69 msgid "B<wint_t btowc(int >I<c>B<);>\n"
73 #: build/C/man3/btowc.3:25 build/C/man3/fgetws.3:27 build/C/man3/fputws.3:25 build/C/man3/fwide.3:42 build/C/man3/getwchar.3:26 build/C/man3/mbrlen.3:25 build/C/man3/mbrtowc.3:27 build/C/man3/mbsinit.3:25 build/C/man3/mbsnrtowcs.3:44 build/C/man3/mbsrtowcs.3:26 build/C/man3/putwchar.3:26 build/C/man3/ungetwc.3:25 build/C/man3/wcpcpy.3:43 build/C/man3/wcpncpy.3:44 build/C/man3/wcrtomb.3:25 build/C/man3/wcscasecmp.3:43 build/C/man3/wcscat.3:25 build/C/man3/wcschr.3:25 build/C/man3/wcscmp.3:25 build/C/man3/wcscpy.3:25 build/C/man3/wcscspn.3:25 build/C/man3/wcsdup.3:43 build/C/man3/wcslen.3:25 build/C/man3/wcsncasecmp.3:43 build/C/man3/wcsncat.3:25 build/C/man3/wcsncmp.3:25 build/C/man3/wcsncpy.3:25 build/C/man3/wcsnlen.3:43 build/C/man3/wcsnrtombs.3:44 build/C/man3/wcspbrk.3:25 build/C/man3/wcsrchr.3:25 build/C/man3/wcsrtombs.3:26 build/C/man3/wcsspn.3:26 build/C/man3/wcsstr.3:25 build/C/man3/wcstoimax.3:39 build/C/man3/wcstok.3:26 build/C/man3/wcswidth.3:25 build/C/man3/wctob.3:25 build/C/man3/wcwidth.3:25 build/C/man3/wmemchr.3:25 build/C/man3/wmemcmp.3:24 build/C/man3/wmemcpy.3:25 build/C/man3/wmemmove.3:25 build/C/man3/wmemset.3:25
79 #: build/C/man3/btowc.3:39
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:39 build/C/man3/fgetws.3:46 build/C/man3/fputws.3:37 build/C/man3/fwide.3:69 build/C/man3/getwchar.3:49 build/C/man3/mbrlen.3:81 build/C/man3/mbrtowc.3:150 build/C/man3/mbsinit.3:76 build/C/man3/mbsnrtowcs.3:150 build/C/man3/mbsrtowcs.3:113 build/C/man3/putwchar.3:52 build/C/man3/ungetwc.3:68 build/C/man3/wcpcpy.3:62 build/C/man3/wcpncpy.3:89 build/C/man3/wcrtomb.3:93 build/C/man3/wcscasecmp.3:58 build/C/man3/wcscat.3:44 build/C/man3/wcschr.3:37 build/C/man3/wcscmp.3:37 build/C/man3/wcscpy.3:45 build/C/man3/wcscspn.3:42 build/C/man3/wcsdup.3:59 build/C/man3/wcslen.3:36 build/C/man3/wcsncasecmp.3:60 build/C/man3/wcsncat.3:47 build/C/man3/wcsncmp.3:42 build/C/man3/wcsncpy.3:65 build/C/man3/wcsnlen.3:64 build/C/man3/wcsnrtombs.3:146 build/C/man3/wcspbrk.3:39 build/C/man3/wcsrchr.3:37 build/C/man3/wcsrtombs.3:112 build/C/man3/wcsspn.3:41 build/C/man3/wcsstr.3:36 build/C/man3/wcstok.3:74 build/C/man3/wcswidth.3:38 build/C/man3/wctob.3:42 build/C/man3/wcwidth.3:39 build/C/man3/wmemchr.3:38 build/C/man3/wmemcmp.3:38 build/C/man3/wmemcpy.3:48 build/C/man3/wmemmove.3:46 build/C/man3/wmemset.3:39
94 #: build/C/man3/btowc.3:49
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:49 build/C/man3/fgetws.3:52 build/C/man3/fputws.3:43 build/C/man3/fwide.3:77 build/C/man3/getwchar.3:55 build/C/man3/mbrlen.3:110 build/C/man3/mbrtowc.3:179 build/C/man3/mbsinit.3:89 build/C/man3/mbsnrtowcs.3:163 build/C/man3/mbsrtowcs.3:126 build/C/man3/putwchar.3:60 build/C/man3/ungetwc.3:82 build/C/man3/wcpcpy.3:72 build/C/man3/wcpncpy.3:98 build/C/man3/wcrtomb.3:109 build/C/man3/wcscasecmp.3:91 build/C/man3/wcscat.3:53 build/C/man3/wcschr.3:52 build/C/man3/wcscmp.3:64 build/C/man3/wcscpy.3:54 build/C/man3/wcscspn.3:66 build/C/man3/wcsdup.3:70 build/C/man3/wcslen.3:47 build/C/man3/wcsncasecmp.3:96 build/C/man3/wcsncat.3:56 build/C/man3/wcsncmp.3:78 build/C/man3/wcsncpy.3:74 build/C/man3/wcsnlen.3:87 build/C/man3/wcsnrtombs.3:160 build/C/man3/wcspbrk.3:54 build/C/man3/wcsrchr.3:52 build/C/man3/wcsrtombs.3:126 build/C/man3/wcsspn.3:65 build/C/man3/wcsstr.3:61 build/C/man3/wcstoimax.3:60 build/C/man3/wcstok.3:84 build/C/man3/wcswidth.3:55 build/C/man3/wctob.3:50 build/C/man3/wcwidth.3:53 build/C/man3/wmemchr.3:56 build/C/man3/wmemcmp.3:75 build/C/man3/wmemcpy.3:57 build/C/man3/wmemmove.3:55 build/C/man3/wmemset.3:48
104 msgid "CONFORMING TO"
108 #: build/C/man3/btowc.3:51 build/C/man3/fgetws.3:54 build/C/man3/fputws.3:45 build/C/man3/fwide.3:79
109 msgid "C99, POSIX.1-2001."
113 #: build/C/man3/btowc.3:51 build/C/man3/fgetws.3:54 build/C/man3/fputws.3:45 build/C/man3/fwide.3:79 build/C/man3/getwchar.3:57 build/C/man3/mbrlen.3:112 build/C/man3/mbrtowc.3:181 build/C/man3/mbsinit.3:91 build/C/man3/mbsnrtowcs.3:165 build/C/man3/mbsrtowcs.3:128 build/C/man3/putwchar.3:62 build/C/man3/ungetwc.3:84 build/C/man3/wcrtomb.3:111 build/C/man3/wcscasecmp.3:95 build/C/man3/wcsncasecmp.3:100 build/C/man3/wcsnrtombs.3:162 build/C/man3/wcsrtombs.3:128 build/C/man3/wcstok.3:86 build/C/man3/wcswidth.3:57 build/C/man3/wctob.3:52 build/C/man3/wcwidth.3:61
119 #: build/C/man3/btowc.3:58
121 "The behavior of B<btowc>() depends on the B<LC_CTYPE> category of the "
126 #: build/C/man3/btowc.3:68
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:68 build/C/man3/fgetws.3:73 build/C/man3/fputws.3:60 build/C/man3/fwide.3:96 build/C/man3/getwchar.3:70 build/C/man3/mbrlen.3:119 build/C/man3/mbrtowc.3:188 build/C/man3/mbsinit.3:98 build/C/man3/mbsnrtowcs.3:176 build/C/man3/mbsrtowcs.3:139 build/C/man3/putwchar.3:75 build/C/man3/ungetwc.3:91 build/C/man3/wcpcpy.3:74 build/C/man3/wcpncpy.3:100 build/C/man3/wcrtomb.3:122 build/C/man3/wcscasecmp.3:102 build/C/man3/wcscat.3:55 build/C/man3/wcschr.3:54 build/C/man3/wcscmp.3:66 build/C/man3/wcscpy.3:56 build/C/man3/wcscspn.3:68 build/C/man3/wcsdup.3:75 build/C/man3/wcslen.3:49 build/C/man3/wcsncasecmp.3:107 build/C/man3/wcsncat.3:58 build/C/man3/wcsncmp.3:80 build/C/man3/wcsncpy.3:76 build/C/man3/wcsnlen.3:89 build/C/man3/wcsnrtombs.3:173 build/C/man3/wcspbrk.3:56 build/C/man3/wcsrchr.3:54 build/C/man3/wcsrtombs.3:139 build/C/man3/wcsspn.3:67 build/C/man3/wcsstr.3:63 build/C/man3/wcstoimax.3:62 build/C/man3/wcstok.3:104 build/C/man3/wcswidth.3:64 build/C/man3/wctob.3:68 build/C/man3/wcwidth.3:68 build/C/man3/wmemchr.3:58 build/C/man3/wmemcmp.3:77 build/C/man3/wmemcpy.3:59 build/C/man3/wmemmove.3:57 build/C/man3/wmemset.3:50
141 #: build/C/man3/btowc.3:72
142 msgid "B<mbrtowc>(3), B<mbtowc>(3), B<wctob>(3)"
146 #: build/C/man3/btowc.3:72 build/C/man3/fgetws.3:76 build/C/man3/fputws.3:63 build/C/man3/fwide.3:99 build/C/man3/getwchar.3:73 build/C/man3/mbrlen.3:121 build/C/man3/mbrtowc.3:191 build/C/man3/mbsinit.3:104 build/C/man3/mbsnrtowcs.3:181 build/C/man3/mbsrtowcs.3:145 build/C/man3/putwchar.3:78 build/C/man3/ungetwc.3:93 build/C/man3/wcpcpy.3:77 build/C/man3/wcpncpy.3:103 build/C/man3/wcrtomb.3:125 build/C/man3/wcscasecmp.3:105 build/C/man3/wcscat.3:60 build/C/man3/wcschr.3:60 build/C/man3/wcscmp.3:70 build/C/man3/wcscpy.3:62 build/C/man3/wcscspn.3:72 build/C/man3/wcsdup.3:78 build/C/man3/wcslen.3:51 build/C/man3/wcsncasecmp.3:110 build/C/man3/wcsncat.3:61 build/C/man3/wcsncmp.3:83 build/C/man3/wcsncpy.3:78 build/C/man3/wcsnlen.3:92 build/C/man3/wcsnrtombs.3:177 build/C/man3/wcspbrk.3:60 build/C/man3/wcsrchr.3:57 build/C/man3/wcsrtombs.3:145 build/C/man3/wcsspn.3:70 build/C/man3/wcsstr.3:66 build/C/man3/wcstoimax.3:70 build/C/man3/wcstok.3:107 build/C/man3/wcswidth.3:67 build/C/man3/wctob.3:72 build/C/man3/wcwidth.3:71 build/C/man3/wmemchr.3:61 build/C/man3/wmemcmp.3:80 build/C/man3/wmemcpy.3:64 build/C/man3/wmemmove.3:60 build/C/man3/wmemset.3:52
152 #: build/C/man3/btowc.3:80 build/C/man3/fgetws.3:84 build/C/man3/fputws.3:71 build/C/man3/fwide.3:107 build/C/man3/getwchar.3:81 build/C/man3/mbrlen.3:129 build/C/man3/mbrtowc.3:199 build/C/man3/mbsinit.3:112 build/C/man3/mbsnrtowcs.3:189 build/C/man3/mbsrtowcs.3:153 build/C/man3/putwchar.3:86 build/C/man3/ungetwc.3:101 build/C/man3/wcpcpy.3:85 build/C/man3/wcpncpy.3:111 build/C/man3/wcrtomb.3:133 build/C/man3/wcscasecmp.3:113 build/C/man3/wcscat.3:68 build/C/man3/wcschr.3:68 build/C/man3/wcscmp.3:78 build/C/man3/wcscpy.3:70 build/C/man3/wcscspn.3:80 build/C/man3/wcsdup.3:86 build/C/man3/wcslen.3:59 build/C/man3/wcsncasecmp.3:118 build/C/man3/wcsncat.3:69 build/C/man3/wcsncmp.3:91 build/C/man3/wcsncpy.3:86 build/C/man3/wcsnlen.3:100 build/C/man3/wcsnrtombs.3:185 build/C/man3/wcspbrk.3:68 build/C/man3/wcsrchr.3:65 build/C/man3/wcsrtombs.3:153 build/C/man3/wcsspn.3:78 build/C/man3/wcsstr.3:74 build/C/man3/wcstoimax.3:78 build/C/man3/wcstok.3:115 build/C/man3/wcswidth.3:75 build/C/man3/wctob.3:80 build/C/man3/wcwidth.3:79 build/C/man3/wmemchr.3:69 build/C/man3/wmemcmp.3:88 build/C/man3/wmemcpy.3:72 build/C/man3/wmemmove.3:68 build/C/man3/wmemset.3:60
154 "This page is part of release 3.76 of the Linux I<man-pages> project. A "
155 "description of the project, information about reporting bugs, and the latest "
156 "version of this page, can be found at "
157 "\\%http://www.kernel.org/doc/man-pages/."
161 #: build/C/man3/fgetws.3:18
167 #: build/C/man3/fgetws.3:18 build/C/man3/fputws.3:16
173 #: build/C/man3/fgetws.3:21
174 msgid "fgetws - read a wide-character string from a FILE stream"
178 #: build/C/man3/fgetws.3:26
180 msgid "B<wchar_t *fgetws(wchar_t *>I<ws>B<, int >I<n>B<, FILE *>I<stream>B<);>\n"
184 #: build/C/man3/fgetws.3:40
186 "The B<fgetws>() function is the wide-character equivalent of the "
187 "B<fgets>(3) function. It reads a string of at most I<n-1> wide characters "
188 "into the wide-character array pointed to by I<ws>, and adds a terminating "
189 "null wide character (L\\(aq\\e0\\(aq). It stops reading wide characters "
190 "after it has encountered and stored a newline wide character. It also stops "
191 "when end of stream is reached."
195 #: build/C/man3/fgetws.3:43
197 "The programmer must ensure that there is room for at least I<n> wide "
198 "characters at I<ws>."
202 #: build/C/man3/fgetws.3:46 build/C/man3/fputws.3:37 build/C/man3/getwchar.3:49 build/C/man3/putwchar.3:52
203 msgid "For a nonlocking counterpart, see B<unlocked_stdio>(3)."
207 #: build/C/man3/fgetws.3:52
209 "The B<fgetws>() function, if successful, returns I<ws>. If end of stream "
210 "was already reached or if an error occurred, it returns NULL."
214 #: build/C/man3/fgetws.3:61
216 "The behavior of B<fgetws>() depends on the B<LC_CTYPE> category of the "
221 #: build/C/man3/fgetws.3:69
223 "In the absence of additional information passed to the B<fopen>(3) call, it "
224 "is reasonable to expect that B<fgetws>() will actually read a multibyte "
225 "string from the stream and then convert it to a wide-character string."
229 #: build/C/man3/fgetws.3:73
231 "This function is unreliable, because it does not permit to deal properly "
232 "with null wide characters that may be present in the input."
236 #: build/C/man3/fgetws.3:76 build/C/man3/getwchar.3:73
237 msgid "B<fgetwc>(3), B<unlocked_stdio>(3)"
241 #: build/C/man3/fputws.3:16
247 #: build/C/man3/fputws.3:19
248 msgid "fputws - write a wide-character string to a FILE stream"
252 #: build/C/man3/fputws.3:24
254 msgid "B<int fputws(const wchar_t *>I<ws>B<, FILE *>I<stream>B<);>\n"
258 #: build/C/man3/fputws.3:34
260 "The B<fputws>() function is the wide-character equivalent of the "
261 "B<fputs>(3) function. It writes the wide-character string starting at "
262 "I<ws>, up to but not including the terminating null wide character "
263 "(L\\(aq\\e0\\(aq), to I<stream>."
267 #: build/C/man3/fputws.3:43
269 "The B<fputws>() function returns a nonnegative integer if the operation was "
270 "successful, or -1 to indicate an error."
274 #: build/C/man3/fputws.3:52
276 "The behavior of B<fputws>() depends on the B<LC_CTYPE> category of the "
281 #: build/C/man3/fputws.3:60
283 "In the absence of additional information passed to the B<fopen>(3) call, it "
284 "is reasonable to expect that B<fputws>() will actually write the multibyte "
285 "string corresponding to the wide-character string I<ws>."
289 #: build/C/man3/fputws.3:63 build/C/man3/putwchar.3:78
290 msgid "B<fputwc>(3), B<unlocked_stdio>(3)"
294 #: build/C/man3/fwide.3:16
300 #: build/C/man3/fwide.3:16
306 #: build/C/man3/fwide.3:19
307 msgid "fwide - set and determine the orientation of a FILE stream"
311 #: build/C/man3/fwide.3:24
313 msgid "B<int fwide(FILE *>I<stream>B<, int >I<mode>B<);>\n"
317 #: build/C/man3/fwide.3:29 build/C/man3/mbsnrtowcs.3:29 build/C/man3/wcpcpy.3:28 build/C/man3/wcpncpy.3:29 build/C/man3/wcscasecmp.3:28 build/C/man3/wcsdup.3:28 build/C/man3/wcsncasecmp.3:28 build/C/man3/wcsnlen.3:28 build/C/man3/wcsnrtombs.3:29
318 msgid "Feature Test Macro Requirements for glibc (see B<feature_test_macros>(7)):"
322 #: build/C/man3/fwide.3:33
327 #: build/C/man3/fwide.3:35
328 msgid "_XOPEN_SOURCE\\ E<gt>=\\ 500 || _ISOC99_SOURCE ||"
332 #: build/C/man3/fwide.3:37
333 msgid "_POSIX_C_SOURCE\\ E<gt>=\\ 200112L;"
337 #: build/C/man3/fwide.3:40
338 msgid "or I<cc\\ -std=c99>"
342 #: build/C/man3/fwide.3:57
344 "When I<mode> is zero, the B<fwide>() function determines the current "
345 "orientation of I<stream>. It returns a positive value if I<stream> is "
346 "wide-character oriented, that is, if wide-character I/O is permitted but "
347 "char I/O is disallowed. It returns a negative value if I<stream> is byte "
348 "oriented\\(emthat is, if char I/O is permitted but wide-character I/O is "
349 "disallowed. It returns zero if I<stream> has no orientation yet; in this "
350 "case the next I/O operation might change the orientation (to byte oriented "
351 "if it is a char I/O operation, or to wide-character oriented if it is a "
352 "wide-character I/O operation)."
356 #: build/C/man3/fwide.3:60
358 "Once a stream has an orientation, it cannot be changed and persists until "
359 "the stream is closed."
363 #: build/C/man3/fwide.3:69
365 "When I<mode> is nonzero, the B<fwide>() function first attempts to set "
366 "I<stream>'s orientation (to wide-character oriented if I<mode> is greater "
367 "than 0, or to byte oriented if I<mode> is less than 0). It then returns a "
368 "value denoting the current orientation, as above."
372 #: build/C/man3/fwide.3:77
374 "The B<fwide>() function returns the stream's orientation, after possibly "
375 "changing it. A positive return value means wide-character oriented. A "
376 "negative return value means byte oriented. A return value of zero means "
381 #: build/C/man3/fwide.3:87
383 "Wide-character output to a byte oriented stream can be performed through the "
384 "B<fprintf>(3) function with the B<%lc> and B<%ls> directives."
388 #: build/C/man3/fwide.3:96
390 "Char oriented output to a wide-character oriented stream can be performed "
391 "through the B<fwprintf>(3) function with the B<%c> and B<%s> directives."
395 #: build/C/man3/fwide.3:99
396 msgid "B<fprintf>(3), B<fwprintf>(3)"
400 #: build/C/man3/getwchar.3:17
406 #: build/C/man3/getwchar.3:17 build/C/man3/putwchar.3:17
412 #: build/C/man3/getwchar.3:20
413 msgid "getwchar - read a wide character from standard input"
417 #: build/C/man3/getwchar.3:25
419 msgid "B<wint_t getwchar(void);>\n"
423 #: build/C/man3/getwchar.3:46
425 "The B<getwchar>() function is the wide-character equivalent of the "
426 "B<getchar>(3) function. It reads a wide character from I<stdin> and "
427 "returns it. If the end of stream is reached, or if I<ferror(stdin)> becomes "
428 "true, it returns B<WEOF>. If a wide-character conversion error occurs, it "
429 "sets I<errno> to B<EILSEQ> and returns B<WEOF>."
433 #: build/C/man3/getwchar.3:55
435 "The B<getwchar>() function returns the next wide-character from standard "
440 #: build/C/man3/getwchar.3:57 build/C/man3/mbrlen.3:112 build/C/man3/mbrtowc.3:181 build/C/man3/mbsinit.3:91 build/C/man3/mbsrtowcs.3:128 build/C/man3/putwchar.3:62 build/C/man3/ungetwc.3:84 build/C/man3/wcrtomb.3:111 build/C/man3/wcscat.3:55 build/C/man3/wcschr.3:54 build/C/man3/wcscmp.3:66 build/C/man3/wcscpy.3:56 build/C/man3/wcscspn.3:68 build/C/man3/wcslen.3:49 build/C/man3/wcsncat.3:58 build/C/man3/wcsncmp.3:80 build/C/man3/wcsncpy.3:76 build/C/man3/wcspbrk.3:56 build/C/man3/wcsrchr.3:54 build/C/man3/wcsrtombs.3:128 build/C/man3/wcsspn.3:67 build/C/man3/wcsstr.3:63 build/C/man3/wcstoimax.3:62 build/C/man3/wcstok.3:86 build/C/man3/wctob.3:52 build/C/man3/wmemchr.3:58 build/C/man3/wmemcmp.3:77 build/C/man3/wmemcpy.3:59 build/C/man3/wmemmove.3:57 build/C/man3/wmemset.3:50
445 #: build/C/man3/getwchar.3:64
447 "The behavior of B<getwchar>() depends on the B<LC_CTYPE> category of the "
452 #: build/C/man3/getwchar.3:70
454 "It is reasonable to expect that B<getwchar>() will actually read a "
455 "multibyte sequence from standard input and then convert it to a wide "
460 #: build/C/man3/mbrlen.3:16
466 #: build/C/man3/mbrlen.3:16
472 #: build/C/man3/mbrlen.3:19
473 msgid "mbrlen - determine number of bytes in next multibyte character"
477 #: build/C/man3/mbrlen.3:24
480 "B<size_t mbrlen(const char *>I<s>B<, size_t >I<n>B<, mbstate_t "
485 #: build/C/man3/mbrlen.3:43
487 "The B<mbrlen>() function inspects at most I<n> bytes of the multibyte "
488 "string starting at I<s> and extracts the next complete multibyte character. "
489 "It updates the shift state I<*ps>. If the multibyte character is not the "
490 "null wide character, it returns the number of bytes that were consumed from "
491 "I<s>. If the multibyte character is the null wide character, it resets the "
492 "shift state I<*ps> to the initial state and returns 0."
496 #: build/C/man3/mbrlen.3:59
498 "If the I<n> bytes starting at I<s> do not contain a complete multibyte "
499 "character, B<mbrlen>() returns I<(size_t)\\ -2>. This can happen even if "
500 "I<n> E<gt>= I<MB_CUR_MAX>, if the multibyte string contains redundant shift "
505 #: build/C/man3/mbrlen.3:75
507 "If the multibyte string starting at I<s> contains an invalid multibyte "
508 "sequence before the next complete character, B<mbrlen>() returns "
509 "I<(size_t)\\ -1> and sets I<errno> to B<EILSEQ>. In this case, the effects "
510 "on I<*ps> are undefined."
514 #: build/C/man3/mbrlen.3:81
516 "If I<ps> is NULL, a static anonymous state known only to the B<mbrlen>() "
517 "function is used instead."
521 #: build/C/man3/mbrlen.3:104
523 "The B<mbrlen>() function returns the number of bytes parsed from the "
524 "multibyte sequence starting at I<s>, if a non-null wide character was "
525 "recognized. It returns 0, if a null wide character was recognized. It "
526 "returns I<(size_t)\\ -1> and sets I<errno> to B<EILSEQ>, if an invalid "
527 "multibyte sequence was encountered. It returns I<(size_t)\\ -2> if it "
528 "couldn't parse a complete multibyte character, meaning that I<n> should be "
533 #: build/C/man3/mbrlen.3:104 build/C/man3/mbrtowc.3:173 build/C/man3/mbsinit.3:84 build/C/man3/ungetwc.3:77 build/C/man3/wcpcpy.3:67 build/C/man3/wcpncpy.3:93 build/C/man3/wcscasecmp.3:83 build/C/man3/wcscat.3:48 build/C/man3/wcschr.3:47 build/C/man3/wcscmp.3:59 build/C/man3/wcscpy.3:49 build/C/man3/wcscspn.3:61 build/C/man3/wcslen.3:42 build/C/man3/wcsncasecmp.3:88 build/C/man3/wcsncat.3:51 build/C/man3/wcsncmp.3:73 build/C/man3/wcsncpy.3:69 build/C/man3/wcsnlen.3:82 build/C/man3/wcspbrk.3:49 build/C/man3/wcsrchr.3:47 build/C/man3/wcsspn.3:60 build/C/man3/wcsstr.3:56 build/C/man3/wcstoimax.3:49 build/C/man3/wcstok.3:79 build/C/man3/wcswidth.3:47 build/C/man3/wcwidth.3:45 build/C/man3/wmemchr.3:51 build/C/man3/wmemcmp.3:70 build/C/man3/wmemcpy.3:52 build/C/man3/wmemmove.3:50 build/C/man3/wmemset.3:43
539 #: build/C/man3/mbrlen.3:105 build/C/man3/mbrtowc.3:174 build/C/man3/mbsinit.3:85 build/C/man3/ungetwc.3:78 build/C/man3/wcpcpy.3:68 build/C/man3/wcpncpy.3:94 build/C/man3/wcscasecmp.3:84 build/C/man3/wcscat.3:49 build/C/man3/wcschr.3:48 build/C/man3/wcscmp.3:60 build/C/man3/wcscpy.3:50 build/C/man3/wcscspn.3:62 build/C/man3/wcslen.3:43 build/C/man3/wcsncasecmp.3:89 build/C/man3/wcsncat.3:52 build/C/man3/wcsncmp.3:74 build/C/man3/wcsncpy.3:70 build/C/man3/wcsnlen.3:83 build/C/man3/wcspbrk.3:50 build/C/man3/wcsrchr.3:48 build/C/man3/wcsspn.3:61 build/C/man3/wcsstr.3:57 build/C/man3/wcstoimax.3:50 build/C/man3/wcstok.3:80 build/C/man3/wcswidth.3:48 build/C/man3/wcwidth.3:46 build/C/man3/wmemchr.3:52 build/C/man3/wmemcmp.3:71 build/C/man3/wmemcpy.3:53 build/C/man3/wmemmove.3:51 build/C/man3/wmemset.3:44
541 msgid "Multithreading (see pthreads(7))"
545 #: build/C/man3/mbrlen.3:110
547 "The B<mbrlen>() function is thread-safe with exceptions. It is not "
548 "thread-safe if called with a NULL I<ps> parameter."
552 #: build/C/man3/mbrlen.3:119
554 "The behavior of B<mbrlen>() depends on the B<LC_CTYPE> category of the "
559 #: build/C/man3/mbrlen.3:121
560 msgid "B<mbrtowc>(3)"
564 #: build/C/man3/mbrtowc.3:17
570 #: build/C/man3/mbrtowc.3:17 build/C/man3/mbsinit.3:16 build/C/man3/mbsnrtowcs.3:15 build/C/man3/mbsrtowcs.3:16 build/C/man3/wcrtomb.3:16 build/C/man3/wcsnrtombs.3:15 build/C/man3/wcsrtombs.3:16
576 #: build/C/man3/mbrtowc.3:20
577 msgid "mbrtowc - convert a multibyte sequence to a wide character"
581 #: build/C/man3/mbrtowc.3:26
584 "B<size_t mbrtowc(wchar_t *>I<pwc>B<, const char *>I<s>B<, size_t >I<n>B<, "
585 "mbstate_t *>I<ps>B<);>\n"
589 #: build/C/man3/mbrtowc.3:54
591 "The main case for this function is when I<s> is not NULL and I<pwc> is not "
592 "NULL. In this case, the B<mbrtowc>() function inspects at most I<n> bytes "
593 "of the multibyte string starting at I<s>, extracts the next complete "
594 "multibyte character, converts it to a wide character and stores it at "
595 "I<*pwc>. It updates the shift state I<*ps>. If the converted wide "
596 "character is not L\\(aq\\e0\\(aq (the null wide character), it returns the "
597 "number of bytes that were consumed from I<s>. If the converted wide "
598 "character is L\\(aq\\e0\\(aq, it resets the shift state I<*ps> to the "
599 "initial state and returns 0."
603 #: build/C/man3/mbrtowc.3:70
605 "If the I<n> bytes starting at I<s> do not contain a complete multibyte "
606 "character, B<mbrtowc>() returns I<(size_t)\\ -2>. This can happen even if "
607 "I<n> E<gt>= I<MB_CUR_MAX>, if the multibyte string contains redundant shift "
612 #: build/C/man3/mbrtowc.3:86
614 "If the multibyte string starting at I<s> contains an invalid multibyte "
615 "sequence before the next complete character, B<mbrtowc>() returns "
616 "I<(size_t)\\ -1> and sets I<errno> to B<EILSEQ>. In this case, the effects "
617 "on I<*ps> are undefined."
621 #: build/C/man3/mbrtowc.3:96
623 "A different case is when I<s> is not NULL but I<pwc> is NULL. In this case, "
624 "the B<mbrtowc>() function behaves as above, except that it does not store "
625 "the converted wide character in memory."
629 #: build/C/man3/mbrtowc.3:128
631 "A third case is when I<s> is NULL. In this case, I<pwc> and I<n> are "
632 "ignored. If the conversion state represented by I<*ps> denotes an "
633 "incomplete multibyte character conversion, the B<mbrtowc>() function "
634 "returns I<(size_t)\\ -1>, sets I<errno> to B<EILSEQ>, and leaves I<*ps> in "
635 "an undefined state. Otherwise, the B<mbrtowc>() function puts I<*ps> in "
636 "the initial state and returns 0."
640 #: build/C/man3/mbrtowc.3:146
642 "In all of the above cases, if I<ps> is NULL, a static anonymous state known "
643 "only to the B<mbrtowc>() function is used instead. Otherwise, I<*ps> must "
644 "be a valid I<mbstate_t> object. An I<mbstate_t> object I<a> can be "
645 "initialized to the initial state by zeroing it, for example using"
649 #: build/C/man3/mbrtowc.3:149
650 msgid "memset(&a, 0, sizeof(a));"
654 #: build/C/man3/mbrtowc.3:173
656 "The B<mbrtowc>() function returns the number of bytes parsed from the "
657 "multibyte sequence starting at I<s>, if a non-L\\(aq\\e0\\(aq wide character "
658 "was recognized. It returns 0, if a L\\(aq\\e0\\(aq wide character was "
659 "recognized. It returns I<(size_t)\\ -1> and sets I<errno> to B<EILSEQ>, if "
660 "an invalid multibyte sequence was encountered. It returns I<(size_t)\\ -2> "
661 "if it couldn't parse a complete multibyte character, meaning that I<n> "
662 "should be increased."
666 #: build/C/man3/mbrtowc.3:179
668 "The B<mbrtowc>() function is thread-safe with exceptions. It is not "
669 "thread-safe if called with a NULL I<ps> parameter."
673 #: build/C/man3/mbrtowc.3:188
675 "The behavior of B<mbrtowc>() depends on the B<LC_CTYPE> category of the "
680 #: build/C/man3/mbrtowc.3:191
681 msgid "B<mbsinit>(3), B<mbsrtowcs>(3)"
685 #: build/C/man3/mbsinit.3:16
691 #: build/C/man3/mbsinit.3:19
692 msgid "mbsinit - test for initial shift state"
696 #: build/C/man3/mbsinit.3:24
698 msgid "B<int mbsinit(const mbstate_t *>I<ps>B<);>\n"
702 #: build/C/man3/mbsinit.3:34
704 "Character conversion between the multibyte representation and the wide "
705 "character representation uses conversion state, of type I<mbstate_t>. "
706 "Conversion of a string uses a finite-state machine; when it is interrupted "
707 "after the complete conversion of a number of characters, it may need to save "
708 "a state for processing the remaining characters. Such a conversion state is "
709 "needed for the sake of encodings such as ISO-2022 and UTF-7."
713 #: build/C/man3/mbsinit.3:46
715 "The initial state is the state at the beginning of conversion of a string. "
716 "There are two kinds of state: The one used by multibyte to wide character "
717 "conversion functions, such as B<mbsrtowcs>(3), and the one used by wide "
718 "character to multibyte conversion functions, such as B<wcsrtombs>(3), but "
719 "they both fit in a I<mbstate_t>, and they both have the same representation "
720 "for an initial state."
724 #: build/C/man3/mbsinit.3:54
726 "For 8-bit encodings, all states are equivalent to the initial state. For "
727 "multibyte encodings like UTF-8, EUC-*, BIG5 or SJIS, the wide character to "
728 "multibyte conversion functions never produce non-initial states, but the "
729 "multibyte to wide-character conversion functions like B<mbrtowc>(3) do "
730 "produce non-initial states when interrupted in the middle of a character."
734 #: build/C/man3/mbsinit.3:58
736 "One possible way to create an I<mbstate_t> in initial state is to set it to "
741 #: build/C/man3/mbsinit.3:62
744 " mbstate_t state;\n"
745 " memset(&state,0,sizeof(mbstate_t));\n"
749 #: build/C/man3/mbsinit.3:65
750 msgid "On Linux, the following works as well, but might generate compiler warnings:"
754 #: build/C/man3/mbsinit.3:68
756 msgid " mbstate_t state = { 0 };\n"
760 #: build/C/man3/mbsinit.3:76
762 "The function B<mbsinit>() tests whether I<*ps> corresponds to an initial "
767 #: build/C/man3/mbsinit.3:84
769 "B<mbsinit>() returns nonzero if I<*ps> is an initial state, or if I<ps> is "
770 "NULL. Otherwise, it returns 0."
774 #: build/C/man3/mbsinit.3:89
775 msgid "The B<mbsinit>() function is thread-safe."
779 #: build/C/man3/mbsinit.3:98
781 "The behavior of B<mbsinit>() depends on the B<LC_CTYPE> category of the "
786 #: build/C/man3/mbsinit.3:104
787 msgid "B<mbrlen>(3), B<mbrtowc>(3), B<wcrtomb>(3), B<mbsrtowcs>(3), B<wcsrtombs>(3)"
791 #: build/C/man3/mbsnrtowcs.3:15
797 #: build/C/man3/mbsnrtowcs.3:18
798 msgid "mbsnrtowcs - convert a multibyte string to a wide-character string"
802 #: build/C/man3/mbsnrtowcs.3:24
805 "B<size_t mbsnrtowcs(wchar_t *>I<dest>B<, const char **>I<src>B<,>\n"
806 "B< size_t >I<nms>B<, size_t >I<len>B<, mbstate_t "
811 #: build/C/man3/mbsnrtowcs.3:32
812 msgid "B<mbsnrtowcs>():"
816 #: build/C/man3/mbsnrtowcs.3:35 build/C/man3/wcpcpy.3:34 build/C/man3/wcpncpy.3:35 build/C/man3/wcscasecmp.3:34 build/C/man3/wcsdup.3:34 build/C/man3/wcsncasecmp.3:34 build/C/man3/wcsnlen.3:34 build/C/man3/wcsnrtombs.3:35
818 msgid "Since glibc 2.10:"
822 #: build/C/man3/mbsnrtowcs.3:38 build/C/man3/wcpcpy.3:37 build/C/man3/wcpncpy.3:38 build/C/man3/wcscasecmp.3:37 build/C/man3/wcsdup.3:37 build/C/man3/wcsncasecmp.3:37 build/C/man3/wcsnlen.3:37 build/C/man3/wcsnrtombs.3:38
823 msgid "_XOPEN_SOURCE\\ E<gt>=\\ 700 || _POSIX_C_SOURCE\\ E<gt>=\\ 200809L"
827 #: build/C/man3/mbsnrtowcs.3:38 build/C/man3/wcpcpy.3:37 build/C/man3/wcpncpy.3:38 build/C/man3/wcscasecmp.3:37 build/C/man3/wcsdup.3:37 build/C/man3/wcsncasecmp.3:37 build/C/man3/wcsnlen.3:37 build/C/man3/wcsnrtombs.3:38
829 msgid "Before glibc 2.10:"
833 #: build/C/man3/mbsnrtowcs.3:41 build/C/man3/wcpcpy.3:40 build/C/man3/wcpncpy.3:41 build/C/man3/wcscasecmp.3:40 build/C/man3/wcsdup.3:40 build/C/man3/wcsncasecmp.3:40 build/C/man3/wcsnlen.3:40 build/C/man3/wcsnrtombs.3:41
838 #: build/C/man3/mbsnrtowcs.3:54
840 "The B<mbsnrtowcs>() function is like the B<mbsrtowcs>(3) function, except "
841 "that the number of bytes to be converted, starting at I<*src>, is limited to "
846 #: build/C/man3/mbsnrtowcs.3:87
848 "If I<dest> is not NULL, the B<mbsnrtowcs>() function converts at most "
849 "I<nms> bytes from the multibyte string I<*src> to a wide-character string "
850 "starting at I<dest>. At most I<len> wide characters are written to "
851 "I<dest>. The shift state I<*ps> is updated. The conversion is effectively "
852 "performed by repeatedly calling I<mbrtowc(dest, *src, n, ps)> where I<n> is "
853 "some positive number, as long as this call succeeds, and then incrementing "
854 "I<dest> by one and I<*src> by the number of bytes consumed. The conversion "
855 "can stop for three reasons:"
859 #: build/C/man3/mbsnrtowcs.3:87 build/C/man3/mbsrtowcs.3:55 build/C/man3/wcsnrtombs.3:87
865 #: build/C/man3/mbsnrtowcs.3:98 build/C/man3/mbsrtowcs.3:66
867 "An invalid multibyte sequence has been encountered. In this case, I<*src> "
868 "is left pointing to the invalid multibyte sequence, I<(size_t)\\ -1> is "
869 "returned, and I<errno> is set to B<EILSEQ>."
873 #: build/C/man3/mbsnrtowcs.3:98 build/C/man3/mbsrtowcs.3:66 build/C/man3/wcsnrtombs.3:99
879 #: build/C/man3/mbsnrtowcs.3:114
881 "The I<nms> limit forces a stop, or I<len> non-L\\(aq\\e0\\(aq wide "
882 "characters have been stored at I<dest>. In this case, I<*src> is left "
883 "pointing to the next multibyte sequence to be converted, and the number of "
884 "wide characters written to I<dest> is returned."
888 #: build/C/man3/mbsnrtowcs.3:114 build/C/man3/mbsrtowcs.3:77 build/C/man3/wcsnrtombs.3:111
894 #: build/C/man3/mbsnrtowcs.3:128
896 "The multibyte string has been completely converted, including the "
897 "terminating null wide character (\\(aq\\e0\\(aq) (which has the side effect "
898 "of bringing back I<*ps> to the initial state). In this case, I<*src> is set "
899 "to NULL, and the number of wide characters written to I<dest>, excluding the "
900 "terminating null wide character, is returned."
904 #: build/C/man3/mbsnrtowcs.3:137
906 "If I<dest> is NULL, I<len> is ignored, and the conversion proceeds as above, "
907 "except that the converted wide characters are not written out to memory, and "
908 "that no destination length limit exists."
912 #: build/C/man3/mbsnrtowcs.3:144
914 "In both of the above cases, if I<ps> is NULL, a static anonymous state known "
915 "only to the B<mbsnrtowcs>() function is used instead."
919 #: build/C/man3/mbsnrtowcs.3:150 build/C/man3/mbsrtowcs.3:113
921 "The programmer must ensure that there is room for at least I<len> wide "
922 "characters at I<dest>."
926 #: build/C/man3/mbsnrtowcs.3:163
928 "The B<mbsnrtowcs>() function returns the number of wide characters that "
929 "make up the converted part of the wide-character string, not including the "
930 "terminating null wide character. If an invalid multibyte sequence was "
931 "encountered, I<(size_t)\\ -1> is returned, and I<errno> set to B<EILSEQ>."
935 #: build/C/man3/mbsnrtowcs.3:165 build/C/man3/wcpcpy.3:74 build/C/man3/wcpncpy.3:100 build/C/man3/wcsnlen.3:89 build/C/man3/wcsnrtombs.3:162
936 msgid "POSIX.1-2008."
940 #: build/C/man3/mbsnrtowcs.3:172
942 "The behavior of B<mbsnrtowcs>() depends on the B<LC_CTYPE> category of the "
947 #: build/C/man3/mbsnrtowcs.3:176 build/C/man3/mbsrtowcs.3:139 build/C/man3/wcrtomb.3:122 build/C/man3/wcsnrtombs.3:173 build/C/man3/wcsrtombs.3:139
948 msgid "Passing NULL as I<ps> is not multithread safe."
952 #: build/C/man3/mbsnrtowcs.3:181
953 msgid "B<iconv>(3), B<mbrtowc>(3) B<mbsinit>(3), B<mbsrtowcs>(3)"
957 #: build/C/man3/mbsrtowcs.3:16
963 #: build/C/man3/mbsrtowcs.3:19
964 msgid "mbsrtowcs - convert a multibyte string to a wide-character string"
968 #: build/C/man3/mbsrtowcs.3:25
971 "B<size_t mbsrtowcs(wchar_t *>I<dest>B<, const char **>I<src>B<,>\n"
972 "B< size_t >I<len>B<, mbstate_t *>I<ps>B<);>\n"
976 #: build/C/man3/mbsrtowcs.3:55
978 "If I<dest> is not NULL, the B<mbsrtowcs>() function converts the multibyte "
979 "string I<*src> to a wide-character string starting at I<dest>. At most "
980 "I<len> wide characters are written to I<dest>. The shift state I<*ps> is "
981 "updated. The conversion is effectively performed by repeatedly calling "
982 "I<mbrtowc(dest, *src, n, ps)> where I<n> is some positive number, as long as "
983 "this call succeeds, and then incrementing I<dest> by one and I<*src> by the "
984 "number of bytes consumed. The conversion can stop for three reasons:"
988 #: build/C/man3/mbsrtowcs.3:77
990 "I<len> non-L\\(aq\\e0\\(aq wide characters have been stored at I<dest>. In "
991 "this case, I<*src> is left pointing to the next multibyte sequence to be "
992 "converted, and the number of wide characters written to I<dest> is returned."
996 #: build/C/man3/mbsrtowcs.3:90
998 "The multibyte string has been completely converted, including the "
999 "terminating null wide character (\\(aq\\e0\\(aq), which has the side effect "
1000 "of bringing back I<*ps> to the initial state. In this case, I<*src> is set "
1001 "to NULL, and the number of wide characters written to I<dest>, excluding the "
1002 "terminating null wide character, is returned."
1006 #: build/C/man3/mbsrtowcs.3:99
1008 "If I<dest> is NULL, I<len> is ignored, and the conversion proceeds as above, "
1009 "except that the converted wide characters are not written out to memory, and "
1010 "that no length limit exists."
1014 #: build/C/man3/mbsrtowcs.3:107
1016 "In both of the above cases, if I<ps> is NULL, a static anonymous state known "
1017 "only to the B<mbsrtowcs>() function is used instead."
1021 #: build/C/man3/mbsrtowcs.3:126
1023 "The B<mbsrtowcs>() function returns the number of wide characters that make "
1024 "up the converted part of the wide-character string, not including the "
1025 "terminating null wide character. If an invalid multibyte sequence was "
1026 "encountered, I<(size_t)\\ -1> is returned, and I<errno> set to B<EILSEQ>."
1030 #: build/C/man3/mbsrtowcs.3:135
1032 "The behavior of B<mbsrtowcs>() depends on the B<LC_CTYPE> category of the "
1037 #: build/C/man3/mbsrtowcs.3:145
1038 msgid "B<iconv>(3), B<mbrtowc>(3), B<mbsinit>(3), B<mbsnrtowcs>(3), B<mbstowcs>(3)"
1042 #: build/C/man3/putwchar.3:17
1048 #: build/C/man3/putwchar.3:20
1049 msgid "putwchar - write a wide character to standard output"
1053 #: build/C/man3/putwchar.3:25
1055 msgid "B<wint_t putwchar(wchar_t >I<wc>B<);>\n"
1059 #: build/C/man3/putwchar.3:49
1061 "The B<putwchar>() function is the wide-character equivalent of the "
1062 "B<putchar>(3) function. It writes the wide character I<wc> to I<stdout>. "
1063 "If I<ferror(stdout)> becomes true, it returns B<WEOF>. If a wide character "
1064 "conversion error occurs, it sets I<errno> to B<EILSEQ> and returns B<WEOF>. "
1065 "Otherwise, it returns I<wc>."
1069 #: build/C/man3/putwchar.3:60
1071 "The B<putwchar>() function returns I<wc> if no error occurred, or B<WEOF> "
1072 "to indicate an error."
1076 #: build/C/man3/putwchar.3:69
1078 "The behavior of B<putwchar>() depends on the B<LC_CTYPE> category of the "
1083 #: build/C/man3/putwchar.3:75
1085 "It is reasonable to expect that B<putwchar>() will actually write the "
1086 "multibyte sequence corresponding to the wide character I<wc>."
1090 #: build/C/man3/ungetwc.3:16
1096 #: build/C/man3/ungetwc.3:16
1102 #: build/C/man3/ungetwc.3:19
1103 msgid "ungetwc - push back a wide character onto a FILE stream"
1107 #: build/C/man3/ungetwc.3:24
1109 msgid "B<wint_t ungetwc(wint_t >I<wc>B<, FILE *>I<stream>B<);>\n"
1113 #: build/C/man3/ungetwc.3:34
1115 "The B<ungetwc>() function is the wide-character equivalent of the "
1116 "B<ungetc>(3) function. It pushes back a wide character onto I<stream> and "
1121 #: build/C/man3/ungetwc.3:50
1123 "If I<wc> is B<WEOF>, it returns B<WEOF>. If I<wc> is an invalid wide "
1124 "character, it sets I<errno> to B<EILSEQ> and returns B<WEOF>."
1128 #: build/C/man3/ungetwc.3:59
1130 "If I<wc> is a valid wide character, it is pushed back onto the stream and "
1131 "thus becomes available for future wide-character read operations. The "
1132 "file-position indicator is decremented by one or more. The end-of-file "
1133 "indicator is cleared. The backing storage of the file is not affected."
1137 #: build/C/man3/ungetwc.3:64
1139 "Note: I<wc> need not be the last wide-character read from the stream; it can "
1140 "be any other valid wide character."
1144 #: build/C/man3/ungetwc.3:68
1146 "If the implementation supports multiple push-back operations in a row, the "
1147 "pushed-back wide characters will be read in reverse order; however, only one "
1148 "level of push-back is guaranteed."
1152 #: build/C/man3/ungetwc.3:77
1154 "The B<ungetwc>() function returns I<wc> when successful, or B<WEOF> upon "
1159 #: build/C/man3/ungetwc.3:82
1160 msgid "The B<ungetwc>() function is thread-safe."
1164 #: build/C/man3/ungetwc.3:91
1166 "The behavior of B<ungetwc>() depends on the B<LC_CTYPE> category of the "
1171 #: build/C/man3/ungetwc.3:93
1172 msgid "B<fgetwc>(3)"
1176 #: build/C/man3/wcpcpy.3:15
1182 #: build/C/man3/wcpcpy.3:15
1188 #: build/C/man3/wcpcpy.3:18
1189 msgid "wcpcpy - copy a wide-character string, returning a pointer to its end"
1193 #: build/C/man3/wcpcpy.3:23
1195 msgid "B<wchar_t *wcpcpy(wchar_t *>I<dest>B<, const wchar_t *>I<src>B<);>\n"
1199 #: build/C/man3/wcpcpy.3:31
1200 msgid "B<wcpcpy>():"
1204 #: build/C/man3/wcpcpy.3:54
1206 "The B<wcpcpy>() function is the wide-character equivalent of the "
1207 "B<stpcpy>(3) function. It copies the wide-character string pointed to by "
1208 "I<src>, including the terminating null wide character (L\\(aq\\e0\\(aq), to "
1209 "the array pointed to by I<dest>."
1213 #: build/C/man3/wcpcpy.3:56 build/C/man3/wcpncpy.3:83 build/C/man3/wcscat.3:39 build/C/man3/wcscpy.3:39 build/C/man3/wcsncat.3:42 build/C/man3/wcsncpy.3:59
1214 msgid "The strings may not overlap."
1218 #: build/C/man3/wcpcpy.3:62 build/C/man3/wcscpy.3:45
1220 "The programmer must ensure that there is room for at least I<wcslen(src)+1> "
1221 "wide characters at I<dest>."
1225 #: build/C/man3/wcpcpy.3:67
1227 "B<wcpcpy>() returns a pointer to the end of the wide-character string "
1228 "I<dest>, that is, a pointer to the terminating null wide character."
1232 #: build/C/man3/wcpcpy.3:72
1233 msgid "The B<wcpcpy>() function is thread-safe."
1237 #: build/C/man3/wcpcpy.3:77
1238 msgid "B<strcpy>(3), B<wcscpy>(3)"
1242 #: build/C/man3/wcpncpy.3:15
1248 #: build/C/man3/wcpncpy.3:15
1254 #: build/C/man3/wcpncpy.3:19
1256 "wcpncpy - copy a fixed-size string of wide characters, returning a pointer "
1261 #: build/C/man3/wcpncpy.3:24
1264 "B<wchar_t *wcpncpy(wchar_t *>I<dest>B<, const wchar_t *>I<src>B<, size_t "
1269 #: build/C/man3/wcpncpy.3:32
1270 msgid "B<wcpncpy>():"
1274 #: build/C/man3/wcpncpy.3:81
1276 "The B<wcpncpy>() function is the wide-character equivalent of the "
1277 "B<stpncpy>(3) function. It copies at most I<n> wide characters from the "
1278 "wide-character string pointed to by I<src>, including the terminating null "
1279 "wide (L\\(aq\\e0\\(aq), to the array pointed to by I<dest>. Exactly I<n> "
1280 "wide characters are written at I<dest>. If the length I<wcslen(src)> is "
1281 "smaller than I<n>, the remaining wide characters in the array pointed to by "
1282 "I<dest> are filled with L\\(aq\\e0\\(aq characters. If the length "
1283 "I<wcslen(src)> is greater than or equal to I<n>, the string pointed to by "
1284 "I<dest> will not be L\\(aq\\e0\\(aq terminated."
1288 #: build/C/man3/wcpncpy.3:89 build/C/man3/wcsncpy.3:65 build/C/man3/wmemcpy.3:48 build/C/man3/wmemmove.3:46
1290 "The programmer must ensure that there is room for at least I<n> wide "
1291 "characters at I<dest>."
1295 #: build/C/man3/wcpncpy.3:93
1297 "B<wcpncpy>() returns a pointer to the last wide character written, that is, "
1302 #: build/C/man3/wcpncpy.3:98
1303 msgid "The B<wcpncpy>() function is thread-safe."
1307 #: build/C/man3/wcpncpy.3:103
1308 msgid "B<stpncpy>(3), B<wcsncpy>(3)"
1312 #: build/C/man3/wcrtomb.3:16
1318 #: build/C/man3/wcrtomb.3:19
1319 msgid "wcrtomb - convert a wide character to a multibyte sequence"
1323 #: build/C/man3/wcrtomb.3:24
1325 msgid "B<size_t wcrtomb(char *>I<s>B<, wchar_t >I<wc>B<, mbstate_t *>I<ps>B<);>\n"
1329 #: build/C/man3/wcrtomb.3:48
1331 "The main case for this function is when I<s> is not NULL and I<wc> is not a "
1332 "null wide character (L\\(aq\\e0\\(aq). In this case, the B<wcrtomb>() "
1333 "function converts the wide character I<wc> to its multibyte representation "
1334 "and stores it at the beginning of the character array pointed to by I<s>. "
1335 "It updates the shift state I<*ps>, and returns the length of said multibyte "
1336 "representation, that is, the number of bytes written at I<s>."
1340 #: build/C/man3/wcrtomb.3:72
1342 "A different case is when I<s> is not NULL, but I<wc> is a null wide "
1343 "character (L\\(aq\\e0\\(aq). In this case, the B<wcrtomb>() function "
1344 "stores at the character array pointed to by I<s> the shift sequence needed "
1345 "to bring I<*ps> back to the initial state, followed by a \\(aq\\e0\\(aq "
1346 "byte. It updates the shift state I<*ps> (i.e., brings it into the initial "
1347 "state), and returns the length of the shift sequence plus one, that is, the "
1348 "number of bytes written at I<s>."
1352 #: build/C/man3/wcrtomb.3:80
1354 "A third case is when I<s> is NULL. In this case, I<wc> is ignored, and the "
1355 "function effectively returns"
1359 #: build/C/man3/wcrtomb.3:82
1361 msgid " wcrtomb(buf, L\\(aq\\e0\\(aq, ps)\n"
1365 #: build/C/man3/wcrtomb.3:86
1366 msgid "where I<buf> is an internal anonymous buffer."
1370 #: build/C/man3/wcrtomb.3:93
1372 "In all of the above cases, if I<ps> is NULL, a static anonymous state known "
1373 "only to the B<wcrtomb>() function is used instead."
1377 #: build/C/man3/wcrtomb.3:109
1379 "The B<wcrtomb>() function returns the number of bytes that have been or "
1380 "would have been written to the byte array at I<s>. If I<wc> can not be "
1381 "represented as a multibyte sequence (according to the current locale), "
1382 "I<(size_t)\\ -1> is returned, and I<errno> set to B<EILSEQ>."
1386 #: build/C/man3/wcrtomb.3:118
1388 "The behavior of B<wcrtomb>() depends on the B<LC_CTYPE> category of the "
1393 #: build/C/man3/wcrtomb.3:125
1394 msgid "B<mbsinit>(3), B<wcsrtombs>(3)"
1398 #: build/C/man3/wcscasecmp.3:15
1404 #: build/C/man3/wcscasecmp.3:15 build/C/man3/wcsncasecmp.3:15 build/C/man3/wcstoimax.3:24 build/C/man3/wcswidth.3:15 build/C/man3/wcwidth.3:15
1410 #: build/C/man3/wcscasecmp.3:18
1411 msgid "wcscasecmp - compare two wide-character strings, ignoring case"
1415 #: build/C/man3/wcscasecmp.3:23
1417 msgid "B<int wcscasecmp(const wchar_t *>I<s1>B<, const wchar_t *>I<s2>B<);>\n"
1421 #: build/C/man3/wcscasecmp.3:31
1422 msgid "B<wcscasecmp>():"
1426 #: build/C/man3/wcscasecmp.3:58
1428 "The B<wcscasecmp>() function is the wide-character equivalent of the "
1429 "B<strcasecmp>(3) function. It compares the wide-character string pointed "
1430 "to by I<s1> and the wide-character string pointed to by I<s2>, ignoring case "
1431 "differences (B<towupper>(3), B<towlower>(3))."
1435 #: build/C/man3/wcscasecmp.3:79
1437 "The B<wcscasecmp>() function returns zero if the wide-character strings at "
1438 "I<s1> and I<s2> are equal except for case distinctions. It returns a "
1439 "positive integer if I<s1> is greater than I<s2>, ignoring case. It returns "
1440 "a negative integer if I<s1> is smaller than I<s2>, ignoring case."
1444 #: build/C/man3/wcscasecmp.3:79 build/C/man3/wcsncasecmp.3:84 build/C/man3/wcsnlen.3:78
1450 #: build/C/man3/wcscasecmp.3:83
1451 msgid "The B<wcscasecmp>() function is provided in glibc since version 2.1."
1455 #: build/C/man3/wcscasecmp.3:91
1457 "The B<wcscasecmp>() function is thread-safe with exceptions. It can be "
1458 "safely used in multithreaded applications, as long as B<setlocale>(3) is "
1459 "not called to change the locale during its execution."
1463 #: build/C/man3/wcscasecmp.3:95 build/C/man3/wcsdup.3:75 build/C/man3/wcsncasecmp.3:100
1465 "POSIX.1-2008. This function is not specified in POSIX.1-2001, and is not "
1466 "widely available on other systems."
1470 #: build/C/man3/wcscasecmp.3:102
1472 "The behavior of B<wcscasecmp>() depends on the B<LC_CTYPE> category of the "
1477 #: build/C/man3/wcscasecmp.3:105
1478 msgid "B<strcasecmp>(3), B<wcscmp>(3)"
1482 #: build/C/man3/wcscat.3:16
1488 #: build/C/man3/wcscat.3:16 build/C/man3/wcschr.3:16 build/C/man3/wcscmp.3:16 build/C/man3/wcscpy.3:16 build/C/man3/wcscspn.3:16
1494 #: build/C/man3/wcscat.3:19
1495 msgid "wcscat - concatenate two wide-character strings"
1499 #: build/C/man3/wcscat.3:24
1501 msgid "B<wchar_t *wcscat(wchar_t *>I<dest>B<, const wchar_t *>I<src>B<);>\n"
1505 #: build/C/man3/wcscat.3:37
1507 "The B<wcscat>() function is the wide-character equivalent of the "
1508 "B<strcat>(3) function. It copies the wide-character string pointed to by "
1509 "I<src>, including the terminating null wide character (L\\(aq\\e0\\(aq), to "
1510 "the end of the wide-character string pointed to by I<dest>."
1514 #: build/C/man3/wcscat.3:44
1516 "The programmer must ensure that there is room for at least "
1517 "I<wcslen(dest)>+I<wcslen(src)>+1 wide characters at I<dest>."
1521 #: build/C/man3/wcscat.3:48
1522 msgid "B<wcscat>() returns I<dest>."
1526 #: build/C/man3/wcscat.3:53
1527 msgid "The B<wcscat>() function is thread-safe."
1531 #: build/C/man3/wcscat.3:60
1532 msgid "B<strcat>(3), B<wcpcpy>(3), B<wcscpy>(3), B<wcsncat>(3)"
1536 #: build/C/man3/wcschr.3:16
1542 #: build/C/man3/wcschr.3:19
1543 msgid "wcschr - search a wide character in a wide-character string"
1547 #: build/C/man3/wcschr.3:24
1549 msgid "B<wchar_t *wcschr(const wchar_t *>I<wcs>B<, wchar_t >I<wc>B<);>\n"
1553 #: build/C/man3/wcschr.3:37
1555 "The B<wcschr>() function is the wide-character equivalent of the "
1556 "B<strchr>(3) function. It searches the first occurrence of I<wc> in the "
1557 "wide-character string pointed to by I<wcs>."
1561 #: build/C/man3/wcschr.3:47
1563 "The B<wcschr>() function returns a pointer to the first occurrence of I<wc> "
1564 "in the wide-character string pointed to by I<wcs>, or NULL if I<wc> does not "
1565 "occur in the string."
1569 #: build/C/man3/wcschr.3:52
1570 msgid "The B<wcschr>() function is thread-safe."
1574 #: build/C/man3/wcschr.3:60
1575 msgid "B<strchr>(3), B<wcspbrk>(3), B<wcsrchr>(3), B<wcsstr>(3), B<wmemchr>(3)"
1579 #: build/C/man3/wcscmp.3:16
1585 #: build/C/man3/wcscmp.3:19
1586 msgid "wcscmp - compare two wide-character strings"
1590 #: build/C/man3/wcscmp.3:24
1592 msgid "B<int wcscmp(const wchar_t *>I<s1>B<, const wchar_t *>I<s2>B<);>\n"
1596 #: build/C/man3/wcscmp.3:37
1598 "The B<wcscmp>() function is the wide-character equivalent of the "
1599 "B<strcmp>(3) function. It compares the wide-character string pointed to by "
1600 "I<s1> and the wide-character string pointed to by I<s2>."
1604 #: build/C/man3/wcscmp.3:59
1606 "The B<wcscmp>() function returns zero if the wide-character strings at "
1607 "I<s1> and I<s2> are equal. It returns an integer greater than zero if at "
1608 "the first differing position I<i>, the corresponding wide-character I<s1[i]> "
1609 "is greater than I<s2[i]>. It returns an integer less than zero if at the "
1610 "first differing position I<i>, the corresponding wide-character I<s1[i]> is "
1611 "less than I<s2[i]>."
1615 #: build/C/man3/wcscmp.3:64
1616 msgid "The B<wcscmp>() function is thread-safe."
1620 #: build/C/man3/wcscmp.3:70
1621 msgid "B<strcmp>(3), B<wcscasecmp>(3), B<wmemcmp>(3)"
1625 #: build/C/man3/wcscpy.3:16
1631 #: build/C/man3/wcscpy.3:19
1632 msgid "wcscpy - copy a wide-character string"
1636 #: build/C/man3/wcscpy.3:24
1638 msgid "B<wchar_t *wcscpy(wchar_t *>I<dest>B<, const wchar_t *>I<src>B<);>\n"
1642 #: build/C/man3/wcscpy.3:37
1644 "The B<wcscpy>() function is the wide-character equivalent of the "
1645 "B<strcpy>(3) function. It copies the wide-character string pointed to by "
1646 "I<src>, including the terminating null wide character (L\\(aq\\e0\\(aq), to "
1647 "the array pointed to by I<dest>."
1651 #: build/C/man3/wcscpy.3:49
1652 msgid "B<wcscpy>() returns I<dest>."
1656 #: build/C/man3/wcscpy.3:54
1657 msgid "The B<wcscpy>() function is thread-safe."
1661 #: build/C/man3/wcscpy.3:62
1662 msgid "B<strcpy>(3), B<wcpcpy>(3), B<wcscat>(3), B<wcsdup>(3), B<wmemcpy>(3)"
1666 #: build/C/man3/wcscspn.3:16
1672 #: build/C/man3/wcscspn.3:19
1673 msgid "wcscspn - search a wide-character string for any of a set of wide characters"
1677 #: build/C/man3/wcscspn.3:24
1679 msgid "B<size_t wcscspn(const wchar_t *>I<wcs>B<, const wchar_t *>I<reject>B<);>\n"
1683 #: build/C/man3/wcscspn.3:42
1685 "The B<wcscspn>() function is the wide-character equivalent of the "
1686 "B<strcspn>(3) function. It determines the length of the longest initial "
1687 "segment of I<wcs> which consists entirely of wide-characters not listed in "
1688 "I<reject>. In other words, it searches for the first occurrence in the "
1689 "wide-character string I<wcs> of any of the characters in the wide-character "
1694 #: build/C/man3/wcscspn.3:61
1696 "The B<wcscspn>() function returns the number of wide characters in the "
1697 "longest initial segment of I<wcs> which consists entirely of wide-characters "
1698 "not listed in I<reject>. In other words, it returns the position of the "
1699 "first occurrence in the wide-character string I<wcs> of any of the "
1700 "characters in the wide-character string I<reject>, or I<wcslen(wcs)> if "
1705 #: build/C/man3/wcscspn.3:66
1706 msgid "The B<wcscspn>() function is thread-safe."
1710 #: build/C/man3/wcscspn.3:72
1711 msgid "B<strcspn>(3), B<wcspbrk>(3), B<wcsspn>(3)"
1715 #: build/C/man3/wcsdup.3:15
1721 #: build/C/man3/wcsdup.3:15
1727 #: build/C/man3/wcsdup.3:18
1728 msgid "wcsdup - duplicate a wide-character string"
1732 #: build/C/man3/wcsdup.3:23
1734 msgid "B<wchar_t *wcsdup(const wchar_t *>I<s>B<);>\n"
1738 #: build/C/man3/wcsdup.3:31
1739 msgid "B<wcsdup>():"
1743 #: build/C/man3/wcsdup.3:53
1745 "The B<wcsdup>() function is the wide-character equivalent of the "
1746 "B<strdup>(3) function. It allocates and returns a new wide-character "
1747 "string whose initial contents is a duplicate of the wide-character string "
1748 "pointed to by I<s>."
1752 #: build/C/man3/wcsdup.3:59
1754 "Memory for the new wide-character string is obtained with B<malloc>(3), and "
1755 "should be freed with B<free>(3)."
1759 #: build/C/man3/wcsdup.3:66
1761 "On success, B<wcsdup>() returns a pointer to the new wide-character "
1762 "string. On error, it returns -1, with I<errno> set to indicate the cause of "
1767 #: build/C/man3/wcsdup.3:66
1773 #: build/C/man3/wcsdup.3:67
1779 #: build/C/man3/wcsdup.3:70
1780 msgid "Insufficient memory available to allocate duplicate string."
1784 #: build/C/man3/wcsdup.3:78
1785 msgid "B<strdup>(3), B<wcscpy>(3)"
1789 #: build/C/man3/wcslen.3:16
1795 #: build/C/man3/wcslen.3:16
1801 #: build/C/man3/wcslen.3:19
1802 msgid "wcslen - determine the length of a wide-character string"
1806 #: build/C/man3/wcslen.3:24
1808 msgid "B<size_t wcslen(const wchar_t *>I<s>B<);>\n"
1812 #: build/C/man3/wcslen.3:36
1814 "The B<wcslen>() function is the wide-character equivalent of the "
1815 "B<strlen>(3) function. It determines the length of the wide-character "
1816 "string pointed to by I<s>, excluding the terminating null wide character "
1817 "(L\\(aq\\e0\\(aq)."
1821 #: build/C/man3/wcslen.3:42
1822 msgid "The B<wcslen>() function returns the number of wide characters in I<s>."
1826 #: build/C/man3/wcslen.3:47
1827 msgid "The B<wcslen>() function is thread-safe."
1831 #: build/C/man3/wcslen.3:51
1832 msgid "B<strlen>(3)"
1836 #: build/C/man3/wcsncasecmp.3:15
1842 #: build/C/man3/wcsncasecmp.3:18
1843 msgid "wcsncasecmp - compare two fixed-size wide-character strings, ignoring case"
1847 #: build/C/man3/wcsncasecmp.3:23
1850 "B<int wcsncasecmp(const wchar_t *>I<s1>B<, const wchar_t *>I<s2>B<, size_t "
1855 #: build/C/man3/wcsncasecmp.3:31
1856 msgid "B<wcsncasecmp>():"
1860 #: build/C/man3/wcsncasecmp.3:60
1862 "The B<wcsncasecmp>() function is the wide-character equivalent of the "
1863 "B<strncasecmp>(3) function. It compares the wide-character string pointed "
1864 "to by I<s1> and the wide-character string pointed to by I<s2>, but at most "
1865 "I<n> wide characters from each string, ignoring case differences "
1866 "(B<towupper>(3), B<towlower>(3))."
1870 #: build/C/man3/wcsncasecmp.3:84
1872 "The B<wcsncasecmp>() function returns zero if the wide-character strings at "
1873 "I<s1> and I<s2>, truncated to at most length I<n>, are equal except for case "
1874 "distinctions. It returns a positive integer if truncated I<s1> is greater "
1875 "than truncated I<s2>, ignoring case. It returns a negative integer if "
1876 "truncated I<s1> is smaller than truncated I<s2>, ignoring case."
1880 #: build/C/man3/wcsncasecmp.3:88
1881 msgid "The B<wcsncasecmp>() function is provided in glibc since version 2.1."
1885 #: build/C/man3/wcsncasecmp.3:96
1887 "The B<wcsncasecmp>() function is thread-safe with exceptions. It can be "
1888 "safely used in multithreaded applications, as long as B<setlocale>(3) is "
1889 "not called to change the locale during its execution."
1893 #: build/C/man3/wcsncasecmp.3:107
1895 "The behavior of B<wcsncasecmp>() depends on the B<LC_CTYPE> category of the "
1900 #: build/C/man3/wcsncasecmp.3:110
1901 msgid "B<strncasecmp>(3), B<wcsncmp>(3)"
1905 #: build/C/man3/wcsncat.3:16
1911 #: build/C/man3/wcsncat.3:16 build/C/man3/wcsncmp.3:16 build/C/man3/wcsncpy.3:16 build/C/man3/wcsnlen.3:15
1917 #: build/C/man3/wcsncat.3:19
1918 msgid "wcsncat - concatenate two wide-character strings"
1922 #: build/C/man3/wcsncat.3:24
1925 "B<wchar_t *wcsncat(wchar_t *>I<dest>B<, const wchar_t *>I<src>B<, size_t "
1930 #: build/C/man3/wcsncat.3:40
1932 "The B<wcsncat>() function is the wide-character equivalent of the "
1933 "B<strncat>(3) function. It copies at most I<n> wide characters from the "
1934 "wide-character string pointed to by I<src> to the end of the wide-character "
1935 "string pointed to by I<dest>, and adds a terminating null wide character "
1936 "(L\\(aq\\e0\\(aq)."
1940 #: build/C/man3/wcsncat.3:47
1942 "The programmer must ensure that there is room for at least "
1943 "I<wcslen(dest)>+I<n>+1 wide characters at I<dest>."
1947 #: build/C/man3/wcsncat.3:51
1948 msgid "B<wcsncat>() returns I<dest>."
1952 #: build/C/man3/wcsncat.3:56
1953 msgid "The B<wcsncat>() function is thread-safe."
1957 #: build/C/man3/wcsncat.3:61
1958 msgid "B<strncat>(3), B<wcscat>(3)"
1962 #: build/C/man3/wcsncmp.3:16
1968 #: build/C/man3/wcsncmp.3:19
1969 msgid "wcsncmp - compare two fixed-size wide-character strings"
1973 #: build/C/man3/wcsncmp.3:24
1976 "B<int wcsncmp(const wchar_t *>I<s1>B<, const wchar_t *>I<s2>B<, size_t "
1981 #: build/C/man3/wcsncmp.3:42
1983 "The B<wcsncmp>() function is the wide-character equivalent of the "
1984 "B<strncmp>(3) function. It compares the wide-character string pointed to "
1985 "by I<s1> and the wide-character string pointed to by I<s2>, but at most I<n> "
1986 "wide characters from each string. In each string, the comparison extends "
1987 "only up to the first occurrence of a null wide character (L\\(aq\\e0\\(aq), "
1992 #: build/C/man3/wcsncmp.3:73
1994 "The B<wcsncmp>() function returns zero if the wide-character strings at "
1995 "I<s1> and I<s2>, truncated to at most length I<n>, are equal. It returns an "
1996 "integer greater than zero if at the first differing position I<i> (I<i> "
1997 "E<lt> I<n>), the corresponding wide-character I<s1[i]> is greater than "
1998 "I<s2[i]>. It returns an integer less than zero if at the first differing "
1999 "position I<i> (i E<lt> I<n>), the corresponding wide-character I<s1[i]> is "
2000 "less than I<s2[i]>."
2004 #: build/C/man3/wcsncmp.3:78
2005 msgid "The B<wcsncmp>() function is thread-safe."
2009 #: build/C/man3/wcsncmp.3:83
2010 msgid "B<strncmp>(3), B<wcsncasecmp>(3)"
2014 #: build/C/man3/wcsncpy.3:16
2020 #: build/C/man3/wcsncpy.3:19
2021 msgid "wcsncpy - copy a fixed-size string of wide characters"
2025 #: build/C/man3/wcsncpy.3:24
2028 "B<wchar_t *wcsncpy(wchar_t *>I<dest>B<, const wchar_t *>I<src>B<, size_t "
2033 #: build/C/man3/wcsncpy.3:57
2035 "The B<wcsncpy>() function is the wide-character equivalent of the "
2036 "B<strncpy>(3) function. It copies at most I<n> wide characters from the "
2037 "wide-character string pointed to by I<src>, including the terminating null "
2038 "wide character (L\\(aq\\e0\\(aq), to the array pointed to by I<dest>. "
2039 "Exactly I<n> wide characters are written at I<dest>. If the length "
2040 "I<wcslen(src)> is smaller than I<n>, the remaining wide characters in the "
2041 "array pointed to by I<dest> are filled with null wide characters. If the "
2042 "length I<wcslen(src)> is greater than or equal to I<n>, the string pointed "
2043 "to by I<dest> will not be terminated by a null wide character."
2047 #: build/C/man3/wcsncpy.3:69
2048 msgid "B<wcsncpy>() returns I<dest>."
2052 #: build/C/man3/wcsncpy.3:74
2053 msgid "The B<wcsncpy>() function is thread-safe."
2057 #: build/C/man3/wcsncpy.3:78
2058 msgid "B<strncpy>(3)"
2062 #: build/C/man3/wcsnlen.3:15
2068 #: build/C/man3/wcsnlen.3:18
2069 msgid "wcsnlen - determine the length of a fixed-size wide-character string"
2073 #: build/C/man3/wcsnlen.3:23
2075 msgid "B<size_t wcsnlen(const wchar_t *>I<s>B<, size_t >I<maxlen>B<);>\n"
2079 #: build/C/man3/wcsnlen.3:31
2080 msgid "B<wcsnlen>():"
2084 #: build/C/man3/wcsnlen.3:64
2086 "The B<wcsnlen>() function is the wide-character equivalent of the "
2087 "B<strnlen>(3) function. It returns the number of wide-characters in the "
2088 "string pointed to by I<s>, not including the terminating null wide character "
2089 "(L\\(aq\\e0\\(aq), but at most I<maxlen> wide characters (note: this "
2090 "parameter is not a byte count). In doing this, B<wcsnlen>() looks at only "
2091 "the first I<maxlen> wide characters at I<s> and never beyond I<s+maxlen>."
2095 #: build/C/man3/wcsnlen.3:78
2097 "The B<wcsnlen>() function returns I<wcslen(s)>, if that is less than "
2098 "I<maxlen>, or I<maxlen> if there is no null wide character among the first "
2099 "I<maxlen> wide characters pointed to by I<s>."
2103 #: build/C/man3/wcsnlen.3:82
2104 msgid "The B<wcsnlen>() function is provided in glibc since version 2.1."
2108 #: build/C/man3/wcsnlen.3:87
2109 msgid "The B<wcsnlen>() function is thread-safe."
2113 #: build/C/man3/wcsnlen.3:92
2114 msgid "B<strnlen>(3), B<wcslen>(3)"
2118 #: build/C/man3/wcsnrtombs.3:15
2124 #: build/C/man3/wcsnrtombs.3:18
2125 msgid "wcsnrtombs - convert a wide-character string to a multibyte string"
2129 #: build/C/man3/wcsnrtombs.3:24
2132 "B<size_t wcsnrtombs(char *>I<dest>B<, const wchar_t **>I<src>B<, size_t "
2134 "B< size_t >I<len>B<, mbstate_t *>I<ps>B<);>\n"
2138 #: build/C/man3/wcsnrtombs.3:32
2139 msgid "B<wcsnrtombs>():"
2143 #: build/C/man3/wcsnrtombs.3:55
2145 "The B<wcsnrtombs>() function is like the B<wcsrtombs>(3) function, except "
2146 "that the number of wide characters to be converted, starting at I<*src>, is "
2147 "limited to I<nwc>."
2151 #: build/C/man3/wcsnrtombs.3:87
2153 "If I<dest> is not NULL, the B<wcsnrtombs>() function converts at most "
2154 "I<nwc> wide characters from the wide-character string I<*src> to a multibyte "
2155 "string starting at I<dest>. At most I<len> bytes are written to I<dest>. "
2156 "The shift state I<*ps> is updated. The conversion is effectively performed "
2157 "by repeatedly calling I<wcrtomb(dest, *src, ps)>, as long as this call "
2158 "succeeds, and then incrementing I<dest> by the number of bytes written and "
2159 "I<*src> by one. The conversion can stop for three reasons:"
2163 #: build/C/man3/wcsnrtombs.3:99
2165 "A wide character has been encountered that can not be represented as a "
2166 "multibyte sequence (according to the current locale). In this case, I<*src> "
2167 "is left pointing to the invalid wide character, I<(size_t)\\ -1> is "
2168 "returned, and I<errno> is set to B<EILSEQ>."
2172 #: build/C/man3/wcsnrtombs.3:111
2174 "I<nwc> wide characters have been converted without encountering a null wide "
2175 "character (L\\(aq\\e0\\(aq), or the length limit forces a stop. In this "
2176 "case, I<*src> is left pointing to the next wide character to be converted, "
2177 "and the number of bytes written to I<dest> is returned."
2181 #: build/C/man3/wcsnrtombs.3:123
2183 "The wide-character string has been completely converted, including the "
2184 "terminating null wide character (which has the side effect of bringing back "
2185 "I<*ps> to the initial state). In this case, I<*src> is set to NULL, and the "
2186 "number of bytes written to I<dest>, excluding the terminating null byte "
2187 "(\\(aq\\e0\\(aq), is returned."
2191 #: build/C/man3/wcsnrtombs.3:132
2193 "If I<dest> is NULL, I<len> is ignored, and the conversion proceeds as above, "
2194 "except that the converted bytes are not written out to memory, and that no "
2195 "destination length limit exists."
2199 #: build/C/man3/wcsnrtombs.3:140
2201 "In both of the above cases, if I<ps> is NULL, a static anonymous state known "
2202 "only to the B<wcsnrtombs>() function is used instead."
2206 #: build/C/man3/wcsnrtombs.3:146 build/C/man3/wcsrtombs.3:112
2208 "The programmer must ensure that there is room for at least I<len> bytes at "
2213 #: build/C/man3/wcsnrtombs.3:160
2215 "The B<wcsnrtombs>() function returns the number of bytes that make up the "
2216 "converted part of multibyte sequence, not including the terminating null "
2217 "byte. If a wide character was encountered which could not be converted, "
2218 "I<(size_t)\\ -1> is returned, and I<errno> set to B<EILSEQ>."
2222 #: build/C/man3/wcsnrtombs.3:169
2224 "The behavior of B<wcsnrtombs>() depends on the B<LC_CTYPE> category of the "
2229 #: build/C/man3/wcsnrtombs.3:177
2230 msgid "B<iconv>(3), B<mbsinit>(3), B<wcsrtombs>(3)"
2234 #: build/C/man3/wcspbrk.3:16
2240 #: build/C/man3/wcspbrk.3:16 build/C/man3/wcstok.3:16
2246 #: build/C/man3/wcspbrk.3:19
2247 msgid "wcspbrk - search a wide-character string for any of a set of wide characters"
2251 #: build/C/man3/wcspbrk.3:24
2254 "B<wchar_t *wcspbrk(const wchar_t *>I<wcs>B<, const wchar_t "
2255 "*>I<accept>B<);>\n"
2259 #: build/C/man3/wcspbrk.3:39
2261 "The B<wcspbrk>() function is the wide-character equivalent of the "
2262 "B<strpbrk>(3) function. It searches for the first occurrence in the "
2263 "wide-character string pointed to by I<wcs> of any of the characters in the "
2264 "wide-character string pointed to by I<accept>."
2268 #: build/C/man3/wcspbrk.3:49
2270 "The B<wcspbrk>() function returns a pointer to the first occurrence in "
2271 "I<wcs> of any of the characters listed in I<accept>. If I<wcs> contains "
2272 "none of these characters, NULL is returned."
2276 #: build/C/man3/wcspbrk.3:54
2277 msgid "The B<wcspbrk>() function is thread-safe."
2281 #: build/C/man3/wcspbrk.3:60
2282 msgid "B<strpbrk>(3), B<wcschr>(3), B<wcscspn>(3)"
2286 #: build/C/man3/wcsrchr.3:16
2292 #: build/C/man3/wcsrchr.3:16
2298 #: build/C/man3/wcsrchr.3:19
2299 msgid "wcsrchr - search a wide character in a wide-character string"
2303 #: build/C/man3/wcsrchr.3:24
2305 msgid "B<wchar_t *wcsrchr(const wchar_t *>I<wcs>B<, wchar_t >I<wc>B<);>\n"
2309 #: build/C/man3/wcsrchr.3:37
2311 "The B<wcsrchr>() function is the wide-character equivalent of the "
2312 "B<strrchr>(3) function. It searches the last occurrence of I<wc> in the "
2313 "wide-character string pointed to by I<wcs>."
2317 #: build/C/man3/wcsrchr.3:47
2319 "The B<wcsrchr>() function returns a pointer to the last occurrence of I<wc> "
2320 "in the wide-character string pointed to by I<wcs>, or NULL if I<wc> does not "
2321 "occur in the string."
2325 #: build/C/man3/wcsrchr.3:52
2326 msgid "The B<wcsrchr>() function is thread-safe."
2330 #: build/C/man3/wcsrchr.3:57
2331 msgid "B<strrchr>(3), B<wcschr>(3)"
2335 #: build/C/man3/wcsrtombs.3:16
2341 #: build/C/man3/wcsrtombs.3:19
2342 msgid "wcsrtombs - convert a wide-character string to a multibyte string"
2346 #: build/C/man3/wcsrtombs.3:25
2349 "B<size_t wcsrtombs(char *>I<dest>B<, const wchar_t **>I<src>B<,>\n"
2350 "B< size_t >I<len>B<, mbstate_t *>I<ps>B<);>\n"
2354 #: build/C/man3/wcsrtombs.3:55
2356 "If I<dest> is not NULL, the B<wcsrtombs>() function converts the "
2357 "wide-character string I<*src> to a multibyte string starting at I<dest>. At "
2358 "most I<len> bytes are written to I<dest>. The shift state I<*ps> is "
2359 "updated. The conversion is effectively performed by repeatedly calling "
2360 "I<wcrtomb(dest, *src, ps)>, as long as this call succeeds, and then "
2361 "incrementing I<dest> by the number of bytes written and I<*src> by one. The "
2362 "conversion can stop for three reasons:"
2366 #: build/C/man3/wcsrtombs.3:67
2368 "1. A wide character has been encountered that can not be represented as a "
2369 "multibyte sequence (according to the current locale). In this case, I<*src> "
2370 "is left pointing to the invalid wide character, I<(size_t)\\ -1> is "
2371 "returned, and I<errno> is set to B<EILSEQ>."
2375 #: build/C/man3/wcsrtombs.3:76
2377 "2. The length limit forces a stop. In this case, I<*src> is left pointing "
2378 "to the next wide character to be converted, and the number of bytes written "
2379 "to I<dest> is returned."
2383 #: build/C/man3/wcsrtombs.3:89
2385 "3. The wide-character string has been completely converted, including the "
2386 "terminating null wide character (L\\(aq\\e0\\(aq), which has the side effect "
2387 "of bringing back I<*ps> to the initial state. In this case, I<*src> is set "
2388 "to NULL, and the number of bytes written to I<dest>, excluding the "
2389 "terminating null byte (\\(aq\\e0\\(aq), is returned."
2393 #: build/C/man3/wcsrtombs.3:98
2395 "If I<dest> is NULL, I<len> is ignored, and the conversion proceeds as above, "
2396 "except that the converted bytes are not written out to memory, and that no "
2397 "length limit exists."
2401 #: build/C/man3/wcsrtombs.3:106
2403 "In both of the above cases, if I<ps> is NULL, a static anonymous state known "
2404 "only to the B<wcsrtombs>() function is used instead."
2408 #: build/C/man3/wcsrtombs.3:126
2410 "The B<wcsrtombs>() function returns the number of bytes that make up the "
2411 "converted part of multibyte sequence, not including the terminating null "
2412 "byte. If a wide character was encountered which could not be converted, "
2413 "I<(size_t)\\ -1> is returned, and I<errno> set to B<EILSEQ>."
2417 #: build/C/man3/wcsrtombs.3:135
2419 "The behavior of B<wcsrtombs>() depends on the B<LC_CTYPE> category of the "
2424 #: build/C/man3/wcsrtombs.3:145
2425 msgid "B<iconv>(3), B<mbsinit>(3), B<wcrtomb>(3), B<wcsnrtombs>(3), B<wcstombs>(3)"
2429 #: build/C/man3/wcsspn.3:16
2435 #: build/C/man3/wcsspn.3:16 build/C/man3/wmemcpy.3:16 build/C/man3/wmemmove.3:16 build/C/man3/wmemset.3:16
2441 #: build/C/man3/wcsspn.3:20
2443 "wcsspn - advance in a wide-character string, skipping any of a set of wide "
2448 #: build/C/man3/wcsspn.3:25
2450 msgid "B<size_t wcsspn(const wchar_t *>I<wcs>B<, const wchar_t *>I<accept>B<);>\n"
2454 #: build/C/man3/wcsspn.3:41
2456 "The B<wcsspn>() function is the wide-character equivalent of the "
2457 "B<strspn>(3) function. It determines the length of the longest initial "
2458 "segment of I<wcs> which consists entirely of wide-characters listed in "
2459 "I<accept>. In other words, it searches for the first occurrence in the "
2460 "wide-character string I<wcs> of a wide-character not contained in the "
2461 "wide-character string I<accept>."
2465 #: build/C/man3/wcsspn.3:60
2467 "The B<wcsspn>() function returns the number of wide characters in the "
2468 "longest initial segment of I<wcs> which consists entirely of wide-characters "
2469 "listed in I<accept>. In other words, it returns the position of the first "
2470 "occurrence in the wide-character string I<wcs> of a wide-character not "
2471 "contained in the wide-character string I<accept>, or I<wcslen(wcs)> if there "
2476 #: build/C/man3/wcsspn.3:65
2477 msgid "The B<wcsspn>() function is thread-safe."
2481 #: build/C/man3/wcsspn.3:70
2482 msgid "B<strspn>(3), B<wcscspn>(3)"
2486 #: build/C/man3/wcsstr.3:16
2492 #: build/C/man3/wcsstr.3:16
2498 #: build/C/man3/wcsstr.3:19
2499 msgid "wcsstr - locate a substring in a wide-character string"
2503 #: build/C/man3/wcsstr.3:24
2506 "B<wchar_t *wcsstr(const wchar_t *>I<haystack>B<, const wchar_t "
2507 "*>I<needle>B<);>\n"
2511 #: build/C/man3/wcsstr.3:36
2513 "The B<wcsstr>() function is the wide-character equivalent of the "
2514 "B<strstr>(3) function. It searches for the first occurrence of the "
2515 "wide-character string I<needle> (without its terminating null wide character "
2516 "(L\\(aq\\e0\\(aq)) as a substring in the wide-character string I<haystack>."
2520 #: build/C/man3/wcsstr.3:48
2522 "The B<wcsstr>() function returns a pointer to the first occurrence of "
2523 "I<needle> in I<haystack>. It returns NULL if I<needle> does not occur as a "
2524 "substring in I<haystack>."
2528 #: build/C/man3/wcsstr.3:56
2530 "Note the special case: If I<needle> is the empty wide-character string, the "
2531 "return value is always I<haystack> itself."
2535 #: build/C/man3/wcsstr.3:61
2536 msgid "The B<wcsstr>() function is thread-safe."
2540 #: build/C/man3/wcsstr.3:66
2541 msgid "B<strstr>(3), B<wcschr>(3)"
2545 #: build/C/man3/wcstoimax.3:24
2551 #: build/C/man3/wcstoimax.3:27
2552 msgid "wcstoimax, wcstoumax - convert wide-character string to integer"
2556 #: build/C/man3/wcstoimax.3:30
2558 msgid "B<#include E<lt>stddef.hE<gt>>\n"
2562 #: build/C/man3/wcstoimax.3:32
2564 msgid "B<#include E<lt>inttypes.hE<gt>>\n"
2568 #: build/C/man3/wcstoimax.3:35
2571 "B<intmax_t wcstoimax(const wchar_t *>I<nptr>B<, wchar_t **>I<endptr>B<, int "
2576 #: build/C/man3/wcstoimax.3:38
2579 "B<uintmax_t wcstoumax(const wchar_t *>I<nptr>B<, wchar_t **>I<endptr>B<, int "
2584 #: build/C/man3/wcstoimax.3:49
2586 "These functions are just like B<wcstol>(3) and B<wcstoul>(3), except that "
2587 "they return a value of type I<intmax_t> and I<uintmax_t>, respectively."
2591 #: build/C/man3/wcstoimax.3:60
2593 "The B<wcstoimax>() and B<wcstoumax>() functions are thread-safe with "
2594 "exceptions. These functions can be safely used in multithreaded "
2595 "applications, as long as B<setlocale>(3) is not called to change the locale "
2596 "during their execution."
2599 #. FIXME . the pages referred to by the following xrefs are not yet written
2601 #: build/C/man3/wcstoimax.3:70
2603 "B<imaxabs>(3), B<imaxdiv>(3), B<strtoimax>(3), B<strtoumax>(3), "
2604 "B<wcstol>(3), B<wcstoul>(3)"
2608 #: build/C/man3/wcstok.3:16
2614 #: build/C/man3/wcstok.3:19
2615 msgid "wcstok - split wide-character string into tokens"
2619 #: build/C/man3/wcstok.3:25
2622 "B<wchar_t *wcstok(wchar_t *>I<wcs>B<, const wchar_t *>I<delim>B<, wchar_t "
2627 #: build/C/man3/wcstok.3:39
2629 "The B<wcstok>() function is the wide-character equivalent of the "
2630 "B<strtok>(3) function, with an added argument to make it multithread-safe. "
2631 "It can be used to split a wide-character string I<wcs> into tokens, where a "
2632 "token is defined as a substring not containing any wide-characters from "
2637 #: build/C/man3/wcstok.3:74
2639 "The search starts at I<wcs>, if I<wcs> is not NULL, or at I<*ptr>, if I<wcs> "
2640 "is NULL. First, any delimiter wide-characters are skipped, that is, the "
2641 "pointer is advanced beyond any wide-characters which occur in I<delim>. If "
2642 "the end of the wide-character string is now reached, B<wcstok>() returns "
2643 "NULL, to indicate that no tokens were found, and stores an appropriate value "
2644 "in I<*ptr>, so that subsequent calls to B<wcstok>() will continue to return "
2645 "NULL. Otherwise, the B<wcstok>() function recognizes the beginning of a "
2646 "token and returns a pointer to it, but before doing that, it zero-terminates "
2647 "the token by replacing the next wide-character which occurs in I<delim> with "
2648 "a null wide character (L\\(aq\\e0\\(aq), and it updates I<*ptr> so that "
2649 "subsequent calls will continue searching after the end of recognized token."
2653 #: build/C/man3/wcstok.3:79
2655 "The B<wcstok>() function returns a pointer to the next token, or NULL if no "
2656 "further token was found."
2660 #: build/C/man3/wcstok.3:84
2661 msgid "The B<wcstok>() function is thread-safe."
2665 #: build/C/man3/wcstok.3:91
2667 "The original I<wcs> wide-character string is destructively modified during "
2672 #: build/C/man3/wcstok.3:91
2678 #: build/C/man3/wcstok.3:93
2680 "The following code loops over the tokens contained in a wide-character "
2685 #: build/C/man3/wcstok.3:103
2688 "wchar_t *wcs = ...;\n"
2691 "for (token = wcstok(wcs, \" \\et\\en\", &state);\n"
2693 " token = wcstok(NULL, \" \\et\\en\", &state)) {\n"
2699 #: build/C/man3/wcstok.3:107
2700 msgid "B<strtok>(3), B<wcschr>(3)"
2704 #: build/C/man3/wcswidth.3:15
2710 #: build/C/man3/wcswidth.3:18
2711 msgid "wcswidth - determine columns needed for a fixed-size wide-character string"
2715 #: build/C/man3/wcswidth.3:22
2718 "B<#define _XOPEN_SOURCE> /* See feature_test_macros(7) */\n"
2719 "B<#include E<lt>wchar.hE<gt>>\n"
2723 #: build/C/man3/wcswidth.3:24
2725 msgid "B<int wcswidth(const wchar_t *>I<s>B<, size_t >I<n>B<);>\n"
2729 #: build/C/man3/wcswidth.3:38
2731 "The B<wcswidth>() function returns the number of columns needed to "
2732 "represent the wide-character string pointed to by I<s>, but at most I<n> "
2733 "wide characters. If a nonprintable wide character occurs among these "
2734 "characters, -1 is returned."
2738 #: build/C/man3/wcswidth.3:47
2740 "The B<wcswidth>() function returns the number of column positions for the "
2741 "wide-character string I<s>, truncated to at most length I<n>."
2745 #: build/C/man3/wcswidth.3:55
2747 "The B<wcswidth>() function is thread-safe with exceptions. It can be "
2748 "safely used in multithreaded applications, as long as B<setlocale>(3) is "
2749 "not called to change the locale during its execution."
2753 #: build/C/man3/wcswidth.3:57 build/C/man3/wcwidth.3:55
2754 msgid "POSIX.1-2001."
2758 #: build/C/man3/wcswidth.3:64
2760 "The behavior of B<wcswidth>() depends on the B<LC_CTYPE> category of the "
2765 #: build/C/man3/wcswidth.3:67
2766 msgid "B<iswprint>(3), B<wcwidth>(3)"
2770 #: build/C/man3/wctob.3:16
2776 #: build/C/man3/wctob.3:19
2777 msgid "wctob - try to represent a wide character as a single byte"
2781 #: build/C/man3/wctob.3:24
2783 msgid "B<int wctob(wint_t >I<c>B<);>\n"
2787 #: build/C/man3/wctob.3:36
2789 "The B<wctob>() function tests whether the multibyte representation of the "
2790 "wide character I<c>, starting in the initial state, consists of a single "
2791 "byte. If so, it is returned as an I<unsigned char>."
2795 #: build/C/man3/wctob.3:42
2797 "Never use this function. It cannot help you in writing internationalized "
2798 "programs. Internationalized programs must never distinguish single-byte and "
2799 "multibyte characters."
2803 #: build/C/man3/wctob.3:50
2805 "The B<wctob>() function returns the single-byte representation of I<c>, if "
2806 "it exists, of B<EOF> otherwise."
2810 #: build/C/man3/wctob.3:59
2812 "The behavior of B<wctob>() depends on the B<LC_CTYPE> category of the "
2817 #: build/C/man3/wctob.3:68
2819 "This function should never be used. Internationalized programs must never "
2820 "distinguish single-byte and multibyte characters. Use either B<wctomb>(3) "
2821 "or the thread-safe B<wcrtomb>(3) instead."
2825 #: build/C/man3/wctob.3:72
2826 msgid "B<btowc>(3), B<wcrtomb>(3), B<wctomb>(3)"
2830 #: build/C/man3/wcwidth.3:15
2836 #: build/C/man3/wcwidth.3:18
2837 msgid "wcwidth - determine columns needed for a wide character"
2841 #: build/C/man3/wcwidth.3:22
2844 "B<#define _XOPEN_SOURCE> /* See feature_test_macros(7) */\n"
2845 "B<#include E<lt>wchar.hE<gt>>\n"
2849 #: build/C/man3/wcwidth.3:24
2851 msgid "B<int wcwidth(wchar_t >I<c>B<);>\n"
2855 #: build/C/man3/wcwidth.3:39
2857 "The B<wcwidth>() function returns the number of columns needed to represent "
2858 "the wide character I<c>. If I<c> is a printable wide character, the value "
2859 "is at least 0. If I<c> is null wide character (L\\(aq\\e0\\(aq), the value "
2860 "is 0. Otherwise, -1 is returned."
2864 #: build/C/man3/wcwidth.3:45
2865 msgid "The B<wcwidth>() function returns the number of column positions for I<c>."
2869 #: build/C/man3/wcwidth.3:53
2871 "The B<wcwidth>() function is thread-safe with exceptions. It can be safely "
2872 "used in multithreaded applications, as long as B<setlocale>(3) is not "
2873 "called to change the locale during its execution."
2877 #: build/C/man3/wcwidth.3:57
2878 msgid "Note that glibc before 2.2.5 used the prototype"
2882 #: build/C/man3/wcwidth.3:60
2884 msgid "B<int wcwidth(wint_t >I<c>B<);>\n"
2888 #: build/C/man3/wcwidth.3:68
2890 "The behavior of B<wcwidth>() depends on the B<LC_CTYPE> category of the "
2895 #: build/C/man3/wcwidth.3:71
2896 msgid "B<iswprint>(3), B<wcswidth>(3)"
2900 #: build/C/man3/wmemchr.3:16
2906 #: build/C/man3/wmemchr.3:16 build/C/man3/wmemcmp.3:15
2912 #: build/C/man3/wmemchr.3:19
2913 msgid "wmemchr - search a wide character in a wide-character array"
2917 #: build/C/man3/wmemchr.3:24
2920 "B<wchar_t *wmemchr(const wchar_t *>I<s>B<, wchar_t >I<c>B<, size_t "
2925 #: build/C/man3/wmemchr.3:38
2927 "The B<wmemchr>() function is the wide-character equivalent of the "
2928 "B<memchr>(3) function. It searches the I<n> wide characters starting at "
2929 "I<s> for the first occurrence of the wide character I<c>."
2933 #: build/C/man3/wmemchr.3:51
2935 "The B<wmemchr>() function returns a pointer to the first occurrence of I<c> "
2936 "among the I<n> wide characters starting at I<s>, or NULL if I<c> does not "
2937 "occur among these."
2941 #: build/C/man3/wmemchr.3:56
2942 msgid "The B<wmemchr>() function is thread-safe."
2946 #: build/C/man3/wmemchr.3:61
2947 msgid "B<memchr>(3), B<wcschr>(3)"
2951 #: build/C/man3/wmemcmp.3:15
2957 #: build/C/man3/wmemcmp.3:18
2958 msgid "wmemcmp - compare two arrays of wide-characters"
2962 #: build/C/man3/wmemcmp.3:23
2965 "B<int wmemcmp(const wchar_t *>I<s1>B<, const wchar_t *>I<s2>B<, size_t "
2970 #: build/C/man3/wmemcmp.3:38
2972 "The B<wmemcmp>() function is the wide-character equivalent of the "
2973 "B<memcmp>(3) function. It compares the I<n> wide-characters starting at "
2974 "I<s1> and the I<n> wide-characters starting at I<s2>."
2978 #: build/C/man3/wmemcmp.3:70
2980 "The B<wmemcmp>() function returns zero if the wide-character arrays of size "
2981 "I<n> at I<s1> and I<s2> are equal. It returns an integer greater than zero "
2982 "if at the first differing position I<i> (I<i> E<lt> I<n>), the corresponding "
2983 "wide-character I<s1[i]> is greater than I<s2[i]>. It returns an integer "
2984 "less than zero if at the first differing position I<i> (I<i> E<lt> I<n>), "
2985 "the corresponding wide-character I<s1[i]> is less than I<s2[i]>."
2989 #: build/C/man3/wmemcmp.3:75
2990 msgid "The B<wmemcmp>() function is thread-safe."
2994 #: build/C/man3/wmemcmp.3:80
2995 msgid "B<memcmp>(3), B<wcscmp>(3)"
2999 #: build/C/man3/wmemcpy.3:16
3005 #: build/C/man3/wmemcpy.3:19
3006 msgid "wmemcpy - copy an array of wide-characters"
3010 #: build/C/man3/wmemcpy.3:24
3013 "B<wchar_t *wmemcpy(wchar_t *>I<dest>B<, const wchar_t *>I<src>B<, size_t "
3018 #: build/C/man3/wmemcpy.3:37
3020 "The B<wmemcpy>() function is the wide-character equivalent of the "
3021 "B<memcpy>(3) function. It copies I<n> wide characters from the array "
3022 "starting at I<src> to the array starting at I<dest>."
3026 #: build/C/man3/wmemcpy.3:42
3028 "The arrays may not overlap; use B<wmemmove>(3) to copy between overlapping "
3033 #: build/C/man3/wmemcpy.3:52
3034 msgid "B<wmemcpy>() returns I<dest>."
3038 #: build/C/man3/wmemcpy.3:57
3039 msgid "The B<wmemcpy>() function is thread-safe."
3043 #: build/C/man3/wmemcpy.3:64
3044 msgid "B<memcpy>(3), B<wcscpy>(3), B<wmemmove>(3), B<wmempcpy>(3)"
3048 #: build/C/man3/wmemmove.3:16
3054 #: build/C/man3/wmemmove.3:19
3055 msgid "wmemmove - copy an array of wide-characters"
3059 #: build/C/man3/wmemmove.3:24
3062 "B<wchar_t *wmemmove(wchar_t *>I<dest>B<, const wchar_t *>I<src>B<, size_t "
3067 #: build/C/man3/wmemmove.3:40
3069 "The B<wmemmove>() function is the wide-character equivalent of the "
3070 "B<memmove>(3) function. It copies I<n> wide characters from the array "
3071 "starting at I<src> to the array starting at I<dest>. The arrays may "
3076 #: build/C/man3/wmemmove.3:50
3077 msgid "B<wmemmove>() returns I<dest>."
3081 #: build/C/man3/wmemmove.3:55
3082 msgid "The B<wmemmove>() function is thread-safe."
3086 #: build/C/man3/wmemmove.3:60
3087 msgid "B<memmove>(3), B<wmemcpy>(3)"
3091 #: build/C/man3/wmemset.3:16
3097 #: build/C/man3/wmemset.3:19
3098 msgid "wmemset - fill an array of wide-characters with a constant wide character"
3102 #: build/C/man3/wmemset.3:24
3104 msgid "B<wchar_t *wmemset(wchar_t *>I<wcs>B<, wchar_t >I<wc>B<, size_t >I<n>B<);>\n"
3108 #: build/C/man3/wmemset.3:39
3110 "The B<wmemset>() function is the wide-character equivalent of the "
3111 "B<memset>(3) function. It fills the array of I<n> wide-characters starting "
3112 "at I<wcs> with I<n> copies of the wide character I<wc>."
3116 #: build/C/man3/wmemset.3:43
3117 msgid "B<wmemset>() returns I<wcs>."
3121 #: build/C/man3/wmemset.3:48
3122 msgid "The B<wmemset>() function is thread-safe."
3126 #: build/C/man3/wmemset.3:52
3127 msgid "B<memset>(3)"