OSDN Git Service

(split) LDP: Update POT and ja.po to LDP v3.53.
[linuxjm/LDP_man-pages.git] / po4a / wchar / po / wchar.pot
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.
5 #
6 #, fuzzy
7 msgid ""
8 msgstr ""
9 "Project-Id-Version: PACKAGE VERSION\n"
10 "POT-Creation-Date: 2013-08-15 19:33+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"
14 "Language: \n"
15 "MIME-Version: 1.0\n"
16 "Content-Type: text/plain; charset=CHARSET\n"
17 "Content-Transfer-Encoding: 8bit\n"
18
19 #. type: TH
20 #: build/C/man3/btowc.3:16
21 #, no-wrap
22 msgid "BTOWC"
23 msgstr ""
24
25 #. type: TH
26 #: build/C/man3/btowc.3:16 build/C/man3/wctob.3:16
27 #, no-wrap
28 msgid "2011-09-22"
29 msgstr ""
30
31 #. type: TH
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
33 #, no-wrap
34 msgid "GNU"
35 msgstr ""
36
37 #. type: TH
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
39 #, no-wrap
40 msgid "Linux Programmer's Manual"
41 msgstr ""
42
43 #. type: SH
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
45 #, no-wrap
46 msgid "NAME"
47 msgstr ""
48
49 #. type: Plain text
50 #: build/C/man3/btowc.3:19
51 msgid "btowc - convert single byte to wide character"
52 msgstr ""
53
54 #. type: SH
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
56 #, no-wrap
57 msgid "SYNOPSIS"
58 msgstr ""
59
60 #. type: Plain text
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
62 #, no-wrap
63 msgid "B<#include E<lt>wchar.hE<gt>>\n"
64 msgstr ""
65
66 #. type: Plain text
67 #: build/C/man3/btowc.3:24
68 #, no-wrap
69 msgid "B<wint_t btowc(int >I<c>B<);>\n"
70 msgstr ""
71
72 #. type: SH
73 #: build/C/man3/btowc.3:25 build/C/man3/fgetws.3:27 build/C/man3/fputws.3:25 build/C/man3/fwide.3:44 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
74 #, no-wrap
75 msgid "DESCRIPTION"
76 msgstr ""
77
78 #. type: Plain text
79 #: build/C/man3/btowc.3:39
80 msgid ""
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>."
85 msgstr ""
86
87 #. type: SH
88 #: build/C/man3/btowc.3:39 build/C/man3/fgetws.3:46 build/C/man3/fputws.3:37 build/C/man3/fwide.3:71 build/C/man3/getwchar.3:49 build/C/man3/mbrlen.3:81 build/C/man3/mbrtowc.3:151 build/C/man3/mbsinit.3:76 build/C/man3/mbsnrtowcs.3:150 build/C/man3/mbsrtowcs.3:114 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:94 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
89 #, no-wrap
90 msgid "RETURN VALUE"
91 msgstr ""
92
93 #. type: Plain text
94 #: build/C/man3/btowc.3:49
95 msgid ""
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>."
99 msgstr ""
100
101 #. type: SH
102 #: 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:55 build/C/man3/mbrlen.3:110 build/C/man3/mbrtowc.3:180 build/C/man3/mbsinit.3:84 build/C/man3/mbsnrtowcs.3:163 build/C/man3/mbsrtowcs.3:127 build/C/man3/putwchar.3:60 build/C/man3/ungetwc.3:77 build/C/man3/wcpcpy.3:67 build/C/man3/wcpncpy.3:93 build/C/man3/wcrtomb.3:110 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/wcsdup.3:70 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/wcsnrtombs.3:160 build/C/man3/wcspbrk.3:49 build/C/man3/wcsrchr.3:47 build/C/man3/wcsrtombs.3:126 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/wctob.3:50 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
103 #, no-wrap
104 msgid "CONFORMING TO"
105 msgstr ""
106
107 #. type: Plain text
108 #: build/C/man3/btowc.3:51 build/C/man3/fgetws.3:54 build/C/man3/fputws.3:45 build/C/man3/fwide.3:81
109 msgid "C99, POSIX.1-2001."
110 msgstr ""
111
112 #. type: SH
113 #: build/C/man3/btowc.3:51 build/C/man3/fgetws.3:54 build/C/man3/fputws.3:45 build/C/man3/fwide.3:81 build/C/man3/getwchar.3:57 build/C/man3/mbrlen.3:112 build/C/man3/mbrtowc.3:182 build/C/man3/mbsinit.3:86 build/C/man3/mbsnrtowcs.3:165 build/C/man3/mbsrtowcs.3:129 build/C/man3/putwchar.3:62 build/C/man3/ungetwc.3:79 build/C/man3/wcrtomb.3:112 build/C/man3/wcscasecmp.3:87 build/C/man3/wcsncasecmp.3:92 build/C/man3/wcsnrtombs.3:162 build/C/man3/wcsrtombs.3:128 build/C/man3/wcstok.3:81 build/C/man3/wcswidth.3:49 build/C/man3/wctob.3:52 build/C/man3/wcwidth.3:53
114 #, no-wrap
115 msgid "NOTES"
116 msgstr ""
117
118 #. type: Plain text
119 #: build/C/man3/btowc.3:58
120 msgid ""
121 "The behavior of B<btowc>()  depends on the B<LC_CTYPE> category of the "
122 "current locale."
123 msgstr ""
124
125 #. type: Plain text
126 #: build/C/man3/btowc.3:68
127 msgid ""
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)  "
131 "instead."
132 msgstr ""
133
134 #. type: SH
135 #: build/C/man3/btowc.3:68 build/C/man3/fgetws.3:73 build/C/man3/fputws.3:60 build/C/man3/fwide.3:98 build/C/man3/getwchar.3:70 build/C/man3/mbrlen.3:119 build/C/man3/mbrtowc.3:189 build/C/man3/mbsinit.3:93 build/C/man3/mbsnrtowcs.3:176 build/C/man3/mbsrtowcs.3:140 build/C/man3/putwchar.3:75 build/C/man3/ungetwc.3:86 build/C/man3/wcpcpy.3:69 build/C/man3/wcpncpy.3:95 build/C/man3/wcrtomb.3:123 build/C/man3/wcscasecmp.3:94 build/C/man3/wcscat.3:50 build/C/man3/wcschr.3:49 build/C/man3/wcscmp.3:61 build/C/man3/wcscpy.3:51 build/C/man3/wcscspn.3:63 build/C/man3/wcsdup.3:75 build/C/man3/wcslen.3:44 build/C/man3/wcsncasecmp.3:99 build/C/man3/wcsncat.3:53 build/C/man3/wcsncmp.3:75 build/C/man3/wcsncpy.3:71 build/C/man3/wcsnlen.3:84 build/C/man3/wcsnrtombs.3:173 build/C/man3/wcspbrk.3:51 build/C/man3/wcsrchr.3:49 build/C/man3/wcsrtombs.3:139 build/C/man3/wcsspn.3:62 build/C/man3/wcsstr.3:58 build/C/man3/wcstoimax.3:51 build/C/man3/wcstok.3:99 build/C/man3/wcswidth.3:56 build/C/man3/wctob.3:68 build/C/man3/wcwidth.3:60 build/C/man3/wmemchr.3:53 build/C/man3/wmemcmp.3:72 build/C/man3/wmemcpy.3:54 build/C/man3/wmemmove.3:52 build/C/man3/wmemset.3:45
136 #, no-wrap
137 msgid "SEE ALSO"
138 msgstr ""
139
140 #. type: Plain text
141 #: build/C/man3/btowc.3:72
142 msgid "B<mbrtowc>(3), B<mbtowc>(3), B<wctob>(3)"
143 msgstr ""
144
145 #. type: SH
146 #: build/C/man3/btowc.3:72 build/C/man3/fgetws.3:76 build/C/man3/fputws.3:63 build/C/man3/fwide.3:101 build/C/man3/getwchar.3:73 build/C/man3/mbrlen.3:121 build/C/man3/mbrtowc.3:191 build/C/man3/mbsinit.3:96 build/C/man3/mbsnrtowcs.3:179 build/C/man3/mbsrtowcs.3:144 build/C/man3/putwchar.3:78 build/C/man3/ungetwc.3:88 build/C/man3/wcpcpy.3:72 build/C/man3/wcpncpy.3:98 build/C/man3/wcrtomb.3:125 build/C/man3/wcscasecmp.3:97 build/C/man3/wcscat.3:55 build/C/man3/wcschr.3:55 build/C/man3/wcscmp.3:65 build/C/man3/wcscpy.3:57 build/C/man3/wcscspn.3:67 build/C/man3/wcsdup.3:78 build/C/man3/wcslen.3:46 build/C/man3/wcsncasecmp.3:102 build/C/man3/wcsncat.3:56 build/C/man3/wcsncmp.3:78 build/C/man3/wcsncpy.3:73 build/C/man3/wcsnlen.3:87 build/C/man3/wcsnrtombs.3:176 build/C/man3/wcspbrk.3:55 build/C/man3/wcsrchr.3:52 build/C/man3/wcsrtombs.3:143 build/C/man3/wcsspn.3:65 build/C/man3/wcsstr.3:61 build/C/man3/wcstoimax.3:59 build/C/man3/wcstok.3:102 build/C/man3/wcswidth.3:59 build/C/man3/wctob.3:72 build/C/man3/wcwidth.3:63 build/C/man3/wmemchr.3:56 build/C/man3/wmemcmp.3:75 build/C/man3/wmemcpy.3:59 build/C/man3/wmemmove.3:55 build/C/man3/wmemset.3:47
147 #, no-wrap
148 msgid "COLOPHON"
149 msgstr ""
150
151 #. type: Plain text
152 #: build/C/man3/btowc.3:79 build/C/man3/fgetws.3:83 build/C/man3/fputws.3:70 build/C/man3/fwide.3:108 build/C/man3/getwchar.3:80 build/C/man3/mbrlen.3:128 build/C/man3/mbrtowc.3:198 build/C/man3/mbsinit.3:103 build/C/man3/mbsnrtowcs.3:186 build/C/man3/mbsrtowcs.3:151 build/C/man3/putwchar.3:85 build/C/man3/ungetwc.3:95 build/C/man3/wcpcpy.3:79 build/C/man3/wcpncpy.3:105 build/C/man3/wcrtomb.3:132 build/C/man3/wcscasecmp.3:104 build/C/man3/wcscat.3:62 build/C/man3/wcschr.3:62 build/C/man3/wcscmp.3:72 build/C/man3/wcscpy.3:64 build/C/man3/wcscspn.3:74 build/C/man3/wcsdup.3:85 build/C/man3/wcslen.3:53 build/C/man3/wcsncasecmp.3:109 build/C/man3/wcsncat.3:63 build/C/man3/wcsncmp.3:85 build/C/man3/wcsncpy.3:80 build/C/man3/wcsnlen.3:94 build/C/man3/wcsnrtombs.3:183 build/C/man3/wcspbrk.3:62 build/C/man3/wcsrchr.3:59 build/C/man3/wcsrtombs.3:150 build/C/man3/wcsspn.3:72 build/C/man3/wcsstr.3:68 build/C/man3/wcstoimax.3:66 build/C/man3/wcstok.3:109 build/C/man3/wcswidth.3:66 build/C/man3/wctob.3:79 build/C/man3/wcwidth.3:70 build/C/man3/wmemchr.3:63 build/C/man3/wmemcmp.3:82 build/C/man3/wmemcpy.3:66 build/C/man3/wmemmove.3:62 build/C/man3/wmemset.3:54
153 msgid ""
154 "This page is part of release 3.53 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/."
157 msgstr ""
158
159 #. type: TH
160 #: build/C/man3/fgetws.3:18
161 #, no-wrap
162 msgid "FGETWS"
163 msgstr ""
164
165 #. type: TH
166 #: build/C/man3/fgetws.3:18 build/C/man3/fputws.3:16 build/C/man3/mbsrtowcs.3:16 build/C/man3/wcrtomb.3:16 build/C/man3/wcscat.3:16 build/C/man3/wcscpy.3:16 build/C/man3/wcslen.3:16 build/C/man3/wcsncat.3:16 build/C/man3/wcsncmp.3:16 build/C/man3/wcsncpy.3:16 build/C/man3/wcsstr.3:16 build/C/man3/wcstok.3:16 build/C/man3/wcwidth.3:15
167 #, no-wrap
168 msgid "2011-09-28"
169 msgstr ""
170
171 #. type: Plain text
172 #: build/C/man3/fgetws.3:21
173 msgid "fgetws - read a wide-character string from a FILE stream"
174 msgstr ""
175
176 #. type: Plain text
177 #: build/C/man3/fgetws.3:26
178 #, no-wrap
179 msgid "B<wchar_t *fgetws(wchar_t *>I<ws>B<, int >I<n>B<, FILE *>I<stream>B<);>\n"
180 msgstr ""
181
182 #. type: Plain text
183 #: build/C/man3/fgetws.3:40
184 msgid ""
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."
191 msgstr ""
192
193 #. type: Plain text
194 #: build/C/man3/fgetws.3:43
195 msgid ""
196 "The programmer must ensure that there is room for at least I<n> wide "
197 "characters at I<ws>."
198 msgstr ""
199
200 #. type: Plain text
201 #: build/C/man3/fgetws.3:46 build/C/man3/fputws.3:37 build/C/man3/getwchar.3:49 build/C/man3/putwchar.3:52
202 msgid "For a nonlocking counterpart, see B<unlocked_stdio>(3)."
203 msgstr ""
204
205 #. type: Plain text
206 #: build/C/man3/fgetws.3:52
207 msgid ""
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."
210 msgstr ""
211
212 #. type: Plain text
213 #: build/C/man3/fgetws.3:61
214 msgid ""
215 "The behavior of B<fgetws>()  depends on the B<LC_CTYPE> category of the "
216 "current locale."
217 msgstr ""
218
219 #. type: Plain text
220 #: build/C/man3/fgetws.3:69
221 msgid ""
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."
225 msgstr ""
226
227 #. type: Plain text
228 #: build/C/man3/fgetws.3:73
229 msgid ""
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."
232 msgstr ""
233
234 #. type: Plain text
235 #: build/C/man3/fgetws.3:76 build/C/man3/getwchar.3:73
236 msgid "B<fgetwc>(3), B<unlocked_stdio>(3)"
237 msgstr ""
238
239 #. type: TH
240 #: build/C/man3/fputws.3:16
241 #, no-wrap
242 msgid "FPUTWS"
243 msgstr ""
244
245 #. type: Plain text
246 #: build/C/man3/fputws.3:19
247 msgid "fputws - write a wide-character string to a FILE stream"
248 msgstr ""
249
250 #. type: Plain text
251 #: build/C/man3/fputws.3:24
252 #, no-wrap
253 msgid "B<int fputws(const wchar_t *>I<ws>B<, FILE *>I<stream>B<);>\n"
254 msgstr ""
255
256 #. type: Plain text
257 #: build/C/man3/fputws.3:34
258 msgid ""
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>."
263 msgstr ""
264
265 #. type: Plain text
266 #: build/C/man3/fputws.3:43
267 msgid ""
268 "The B<fputws>()  function returns a nonnegative integer if the operation was "
269 "successful, or -1 to indicate an error."
270 msgstr ""
271
272 #. type: Plain text
273 #: build/C/man3/fputws.3:52
274 msgid ""
275 "The behavior of B<fputws>()  depends on the B<LC_CTYPE> category of the "
276 "current locale."
277 msgstr ""
278
279 #. type: Plain text
280 #: build/C/man3/fputws.3:60
281 msgid ""
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>."
285 msgstr ""
286
287 #. type: Plain text
288 #: build/C/man3/fputws.3:63 build/C/man3/putwchar.3:78
289 msgid "B<fputwc>(3), B<unlocked_stdio>(3)"
290 msgstr ""
291
292 #. type: TH
293 #: build/C/man3/fwide.3:16
294 #, no-wrap
295 msgid "FWIDE"
296 msgstr ""
297
298 #. type: TH
299 #: build/C/man3/fwide.3:16
300 #, no-wrap
301 msgid "2011-09-17"
302 msgstr ""
303
304 #. type: Plain text
305 #: build/C/man3/fwide.3:19
306 msgid "fwide - set and determine the orientation of a FILE stream"
307 msgstr ""
308
309 #. type: Plain text
310 #: build/C/man3/fwide.3:24
311 #, no-wrap
312 msgid "B<int fwide(FILE *>I<stream>B<, int >I<mode>B<);>\n"
313 msgstr ""
314
315 #. type: Plain text
316 #: 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
317 msgid "Feature Test Macro Requirements for glibc (see B<feature_test_macros>(7)):"
318 msgstr ""
319
320 #. type: Plain text
321 #: build/C/man3/fwide.3:33
322 msgid "B<fwide>():"
323 msgstr ""
324
325 #. type: Plain text
326 #: build/C/man3/fwide.3:35
327 msgid "_XOPEN_SOURCE\\ E<gt>=\\ 500 || _ISOC99_SOURCE ||"
328 msgstr ""
329
330 #. type: Plain text
331 #: build/C/man3/fwide.3:37
332 msgid "_ISOC95_SOURCE /* Since glibc 2.12 */ ||"
333 msgstr ""
334
335 #. type: Plain text
336 #: build/C/man3/fwide.3:39
337 msgid "_POSIX_C_SOURCE\\ E<gt>=\\ 200112L;"
338 msgstr ""
339
340 #. type: Plain text
341 #: build/C/man3/fwide.3:42
342 msgid "or I<cc\\ -std=c99>"
343 msgstr ""
344
345 #. type: Plain text
346 #: build/C/man3/fwide.3:59
347 msgid ""
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)."
357 msgstr ""
358
359 #. type: Plain text
360 #: build/C/man3/fwide.3:62
361 msgid ""
362 "Once a stream has an orientation, it cannot be changed and persists until "
363 "the stream is closed."
364 msgstr ""
365
366 #. type: Plain text
367 #: build/C/man3/fwide.3:71
368 msgid ""
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."
373 msgstr ""
374
375 #. type: Plain text
376 #: build/C/man3/fwide.3:79
377 msgid ""
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 "
381 "undecided."
382 msgstr ""
383
384 #. type: Plain text
385 #: build/C/man3/fwide.3:89
386 msgid ""
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."
389 msgstr ""
390
391 #. type: Plain text
392 #: build/C/man3/fwide.3:98
393 msgid ""
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."
396 msgstr ""
397
398 #. type: Plain text
399 #: build/C/man3/fwide.3:101
400 msgid "B<fprintf>(3), B<fwprintf>(3)"
401 msgstr ""
402
403 #. type: TH
404 #: build/C/man3/getwchar.3:17
405 #, no-wrap
406 msgid "GETWCHAR"
407 msgstr ""
408
409 #. type: TH
410 #: build/C/man3/getwchar.3:17 build/C/man3/putwchar.3:17 build/C/man3/wcschr.3:16 build/C/man3/wcscmp.3:16 build/C/man3/wcscspn.3:16 build/C/man3/wcspbrk.3:16 build/C/man3/wcsrchr.3:16 build/C/man3/wcsspn.3:16 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
411 #, no-wrap
412 msgid "1999-07-25"
413 msgstr ""
414
415 #. type: Plain text
416 #: build/C/man3/getwchar.3:20
417 msgid "getwchar - read a wide character from standard input"
418 msgstr ""
419
420 #. type: Plain text
421 #: build/C/man3/getwchar.3:25
422 #, no-wrap
423 msgid "B<wint_t getwchar(void);>\n"
424 msgstr ""
425
426 #. type: Plain text
427 #: build/C/man3/getwchar.3:46
428 msgid ""
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>."
434 msgstr ""
435
436 #. type: Plain text
437 #: build/C/man3/getwchar.3:55
438 msgid ""
439 "The B<getwchar>()  function returns the next wide-character from standard "
440 "input, or B<WEOF>."
441 msgstr ""
442
443 #. type: Plain text
444 #: build/C/man3/getwchar.3:57 build/C/man3/mbrlen.3:112 build/C/man3/mbrtowc.3:182 build/C/man3/mbsinit.3:86 build/C/man3/mbsrtowcs.3:129 build/C/man3/putwchar.3:62 build/C/man3/ungetwc.3:79 build/C/man3/wcrtomb.3:112 build/C/man3/wcscat.3:50 build/C/man3/wcschr.3:49 build/C/man3/wcscmp.3:61 build/C/man3/wcscpy.3:51 build/C/man3/wcscspn.3:63 build/C/man3/wcslen.3:44 build/C/man3/wcsncat.3:53 build/C/man3/wcsncmp.3:75 build/C/man3/wcsncpy.3:71 build/C/man3/wcspbrk.3:51 build/C/man3/wcsrchr.3:49 build/C/man3/wcsrtombs.3:128 build/C/man3/wcsspn.3:62 build/C/man3/wcsstr.3:58 build/C/man3/wcstoimax.3:51 build/C/man3/wcstok.3:81 build/C/man3/wctob.3:52 build/C/man3/wmemchr.3:53 build/C/man3/wmemcmp.3:72 build/C/man3/wmemcpy.3:54 build/C/man3/wmemmove.3:52 build/C/man3/wmemset.3:45
445 msgid "C99."
446 msgstr ""
447
448 #. type: Plain text
449 #: build/C/man3/getwchar.3:64
450 msgid ""
451 "The behavior of B<getwchar>()  depends on the B<LC_CTYPE> category of the "
452 "current locale."
453 msgstr ""
454
455 #. type: Plain text
456 #: build/C/man3/getwchar.3:70
457 msgid ""
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 "
460 "character."
461 msgstr ""
462
463 #. type: TH
464 #: build/C/man3/mbrlen.3:16
465 #, no-wrap
466 msgid "MBRLEN"
467 msgstr ""
468
469 #. type: TH
470 #: build/C/man3/mbrlen.3:16 build/C/man3/mbrtowc.3:17
471 #, no-wrap
472 msgid "2013-06-21"
473 msgstr ""
474
475 #. type: Plain text
476 #: build/C/man3/mbrlen.3:19
477 msgid "mbrlen - determine number of bytes in next multibyte character"
478 msgstr ""
479
480 #. type: Plain text
481 #: build/C/man3/mbrlen.3:24
482 #, no-wrap
483 msgid ""
484 "B<size_t mbrlen(const char *>I<s>B<, size_t >I<n>B<, mbstate_t "
485 "*>I<ps>B<);>\n"
486 msgstr ""
487
488 #. type: Plain text
489 #: build/C/man3/mbrlen.3:43
490 msgid ""
491 "The B<mbrlen>()  function inspects at most I<n> bytes of the multibyte "
492 "string starting at I<s> and extracts the next complete multibyte character.  "
493 "It updates the shift state I<*ps>.  If the multibyte character is not the "
494 "null wide character, it returns the number of bytes that were consumed from "
495 "I<s>.  If the multibyte character is the null wide character, it resets the "
496 "shift state I<*ps> to the initial state and returns 0."
497 msgstr ""
498
499 #. type: Plain text
500 #: build/C/man3/mbrlen.3:59
501 msgid ""
502 "If the I<n> bytes starting at I<s> do not contain a complete multibyte "
503 "character, B<mbrlen>()  returns I<(size_t)\\ -2>.  This can happen even if "
504 "I<n> E<gt>= I<MB_CUR_MAX>, if the multibyte string contains redundant shift "
505 "sequences."
506 msgstr ""
507
508 #. type: Plain text
509 #: build/C/man3/mbrlen.3:75
510 msgid ""
511 "If the multibyte string starting at I<s> contains an invalid multibyte "
512 "sequence before the next complete character, B<mbrlen>()  returns "
513 "I<(size_t)\\ -1> and sets I<errno> to B<EILSEQ>.  In this case, the effects "
514 "on I<*ps> are undefined."
515 msgstr ""
516
517 #. type: Plain text
518 #: build/C/man3/mbrlen.3:81
519 msgid ""
520 "If I<ps> is a NULL pointer, a static anonymous state known only to the "
521 "B<mbrlen>()  function is used instead."
522 msgstr ""
523
524 #. type: Plain text
525 #: build/C/man3/mbrlen.3:104
526 msgid ""
527 "The B<mbrlen>()  function returns the number of bytes parsed from the "
528 "multibyte sequence starting at I<s>, if a non-null wide character was "
529 "recognized.  It returns 0, if a null wide character was recognized.  It "
530 "returns I<(size_t)\\ -1> and sets I<errno> to B<EILSEQ>, if an invalid "
531 "multibyte sequence was encountered.  It returns I<(size_t)\\ -2> if it "
532 "couldn't parse a complete multibyte character, meaning that I<n> should be "
533 "increased."
534 msgstr ""
535
536 #. type: SH
537 #: build/C/man3/mbrlen.3:104 build/C/man3/mbrtowc.3:174
538 #, no-wrap
539 msgid "ATTRIBUTES"
540 msgstr ""
541
542 #. type: SS
543 #: build/C/man3/mbrlen.3:105 build/C/man3/mbrtowc.3:175
544 #, no-wrap
545 msgid "Multithreading (see pthreads(7))"
546 msgstr ""
547
548 #. type: Plain text
549 #: build/C/man3/mbrlen.3:110
550 msgid ""
551 "The B<mbrlen>()  function is thread-safe with exceptions.  It is not "
552 "thread-safe if called with a NULL I<ps> parameter."
553 msgstr ""
554
555 #. type: Plain text
556 #: build/C/man3/mbrlen.3:119
557 msgid ""
558 "The behavior of B<mbrlen>()  depends on the B<LC_CTYPE> category of the "
559 "current locale."
560 msgstr ""
561
562 #. type: Plain text
563 #: build/C/man3/mbrlen.3:121
564 msgid "B<mbrtowc>(3)"
565 msgstr ""
566
567 #. type: TH
568 #: build/C/man3/mbrtowc.3:17
569 #, no-wrap
570 msgid "MBRTOWC"
571 msgstr ""
572
573 #. type: Plain text
574 #: build/C/man3/mbrtowc.3:20
575 msgid "mbrtowc - convert a multibyte sequence to a wide character"
576 msgstr ""
577
578 #. type: Plain text
579 #: build/C/man3/mbrtowc.3:26
580 #, no-wrap
581 msgid ""
582 "B<size_t mbrtowc(wchar_t *>I<pwc>B<, const char *>I<s>B<, size_t >I<n>B<, "
583 "mbstate_t *>I<ps>B<);>\n"
584 msgstr ""
585
586 #. type: Plain text
587 #: build/C/man3/mbrtowc.3:54
588 msgid ""
589 "The main case for this function is when I<s> is not NULL and I<pwc> is not "
590 "NULL.  In this case, the B<mbrtowc>()  function inspects at most I<n> bytes "
591 "of the multibyte string starting at I<s>, extracts the next complete "
592 "multibyte character, converts it to a wide character and stores it at "
593 "I<*pwc>.  It updates the shift state I<*ps>.  If the converted wide "
594 "character is not L\\(aq\\e0\\(aq (the null wide character), it returns the "
595 "number of bytes that were consumed from I<s>.  If the converted wide "
596 "character is L\\(aq\\e0\\(aq, it resets the shift state I<*ps> to the "
597 "initial state and returns 0."
598 msgstr ""
599
600 #. type: Plain text
601 #: build/C/man3/mbrtowc.3:70
602 msgid ""
603 "If the I<n> bytes starting at I<s> do not contain a complete multibyte "
604 "character, B<mbrtowc>()  returns I<(size_t)\\ -2>.  This can happen even if "
605 "I<n> E<gt>= I<MB_CUR_MAX>, if the multibyte string contains redundant shift "
606 "sequences."
607 msgstr ""
608
609 #. type: Plain text
610 #: build/C/man3/mbrtowc.3:86
611 msgid ""
612 "If the multibyte string starting at I<s> contains an invalid multibyte "
613 "sequence before the next complete character, B<mbrtowc>()  returns "
614 "I<(size_t)\\ -1> and sets I<errno> to B<EILSEQ>.  In this case, the effects "
615 "on I<*ps> are undefined."
616 msgstr ""
617
618 #. type: Plain text
619 #: build/C/man3/mbrtowc.3:97
620 msgid ""
621 "A different case is when I<s> is not NULL but I<pwc> is NULL.  In this case "
622 "the B<mbrtowc>()  function behaves as above, except that it does not store "
623 "the converted wide character in memory."
624 msgstr ""
625
626 #. type: Plain text
627 #: build/C/man3/mbrtowc.3:129
628 msgid ""
629 "A third case is when I<s> is NULL.  In this case, I<pwc> and I<n> are "
630 "ignored.  If the conversion state represented by I<*ps> denotes an "
631 "incomplete multibyte character conversion, the B<mbrtowc>()  function "
632 "returns I<(size_t)\\ -1>, sets I<errno> to B<EILSEQ>, and leaves I<*ps> in "
633 "an undefined state.  Otherwise, the B<mbrtowc>()  function puts I<*ps> in "
634 "the initial state and returns 0."
635 msgstr ""
636
637 #. type: Plain text
638 #: build/C/man3/mbrtowc.3:147
639 msgid ""
640 "In all of the above cases, if I<ps> is a NULL pointer, a static anonymous "
641 "state known only to the B<mbrtowc>()  function is used instead.  Otherwise, "
642 "I<*ps> must be a valid I<mbstate_t> object.  An I<mbstate_t> object I<a> can "
643 "be initialized to the initial state by zeroing it, for example using"
644 msgstr ""
645
646 #. type: Plain text
647 #: build/C/man3/mbrtowc.3:150
648 msgid "memset(&a, 0, sizeof(a));"
649 msgstr ""
650
651 #. type: Plain text
652 #: build/C/man3/mbrtowc.3:174
653 msgid ""
654 "The B<mbrtowc>()  function returns the number of bytes parsed from the "
655 "multibyte sequence starting at I<s>, if a non-L\\(aq\\e0\\(aq wide character "
656 "was recognized.  It returns 0, if a L\\(aq\\e0\\(aq wide character was "
657 "recognized.  It returns I<(size_t)\\ -1> and sets I<errno> to B<EILSEQ>, if "
658 "an invalid multibyte sequence was encountered.  It returns I<(size_t)\\ -2> "
659 "if it couldn't parse a complete multibyte character, meaning that I<n> "
660 "should be increased."
661 msgstr ""
662
663 #. type: Plain text
664 #: build/C/man3/mbrtowc.3:180
665 msgid ""
666 "The B<mbrtowc>()  function is thread-safe with exceptions.  It is not "
667 "thread-safe if called with a NULL I<ps> parameter."
668 msgstr ""
669
670 #. type: Plain text
671 #: build/C/man3/mbrtowc.3:189
672 msgid ""
673 "The behavior of B<mbrtowc>()  depends on the B<LC_CTYPE> category of the "
674 "current locale."
675 msgstr ""
676
677 #. type: Plain text
678 #: build/C/man3/mbrtowc.3:191
679 msgid "B<mbsrtowcs>(3)"
680 msgstr ""
681
682 #. type: TH
683 #: build/C/man3/mbsinit.3:16
684 #, no-wrap
685 msgid "MBSINIT"
686 msgstr ""
687
688 #. type: TH
689 #: build/C/man3/mbsinit.3:16
690 #, no-wrap
691 msgid "2000-11-20"
692 msgstr ""
693
694 #. type: Plain text
695 #: build/C/man3/mbsinit.3:19
696 msgid "mbsinit - test for initial shift state"
697 msgstr ""
698
699 #. type: Plain text
700 #: build/C/man3/mbsinit.3:24
701 #, no-wrap
702 msgid "B<int mbsinit(const mbstate_t *>I<ps>B<);>\n"
703 msgstr ""
704
705 #. type: Plain text
706 #: build/C/man3/mbsinit.3:34
707 msgid ""
708 "Character conversion between the multibyte representation and the wide "
709 "character representation uses conversion state, of type I<mbstate_t>.  "
710 "Conversion of a string uses a finite-state machine; when it is interrupted "
711 "after the complete conversion of a number of characters, it may need to save "
712 "a state for processing the remaining characters.  Such a conversion state is "
713 "needed for the sake of encodings such as ISO-2022 and UTF-7."
714 msgstr ""
715
716 #. type: Plain text
717 #: build/C/man3/mbsinit.3:46
718 msgid ""
719 "The initial state is the state at the beginning of conversion of a string.  "
720 "There are two kinds of state: The one used by multibyte to wide character "
721 "conversion functions, such as B<mbsrtowcs>(3), and the one used by wide "
722 "character to multibyte conversion functions, such as B<wcsrtombs>(3), but "
723 "they both fit in a I<mbstate_t>, and they both have the same representation "
724 "for an initial state."
725 msgstr ""
726
727 #. type: Plain text
728 #: build/C/man3/mbsinit.3:54
729 msgid ""
730 "For 8-bit encodings, all states are equivalent to the initial state.  For "
731 "multibyte encodings like UTF-8, EUC-*, BIG5 or SJIS, the wide character to "
732 "multibyte conversion functions never produce non-initial states, but the "
733 "multibyte to wide-character conversion functions like B<mbrtowc>(3)  do "
734 "produce non-initial states when interrupted in the middle of a character."
735 msgstr ""
736
737 #. type: Plain text
738 #: build/C/man3/mbsinit.3:58
739 msgid ""
740 "One possible way to create an I<mbstate_t> in initial state is to set it to "
741 "zero:"
742 msgstr ""
743
744 #. type: Plain text
745 #: build/C/man3/mbsinit.3:62
746 #, no-wrap
747 msgid ""
748 "    mbstate_t state;\n"
749 "    memset(&state,0,sizeof(mbstate_t));\n"
750 msgstr ""
751
752 #. type: Plain text
753 #: build/C/man3/mbsinit.3:65
754 msgid "On Linux, the following works as well, but might generate compiler warnings:"
755 msgstr ""
756
757 #. type: Plain text
758 #: build/C/man3/mbsinit.3:68
759 #, no-wrap
760 msgid "    mbstate_t state = { 0 };\n"
761 msgstr ""
762
763 #. type: Plain text
764 #: build/C/man3/mbsinit.3:76
765 msgid ""
766 "The function B<mbsinit>()  tests whether I<*ps> corresponds to an initial "
767 "state."
768 msgstr ""
769
770 #. type: Plain text
771 #: build/C/man3/mbsinit.3:84
772 msgid ""
773 "B<mbsinit>()  returns nonzero if I<*ps> is an initial state, or if I<ps> is "
774 "a NULL pointer.  Otherwise it returns 0."
775 msgstr ""
776
777 #. type: Plain text
778 #: build/C/man3/mbsinit.3:93
779 msgid ""
780 "The behavior of B<mbsinit>()  depends on the B<LC_CTYPE> category of the "
781 "current locale."
782 msgstr ""
783
784 #. type: Plain text
785 #: build/C/man3/mbsinit.3:96
786 msgid "B<mbsrtowcs>(3), B<wcsrtombs>(3)"
787 msgstr ""
788
789 #. type: TH
790 #: build/C/man3/mbsnrtowcs.3:15
791 #, no-wrap
792 msgid "MBSNRTOWCS"
793 msgstr ""
794
795 #. type: TH
796 #: build/C/man3/mbsnrtowcs.3:15 build/C/man3/wcpcpy.3:15 build/C/man3/wcpncpy.3:15 build/C/man3/wcsnlen.3:15
797 #, no-wrap
798 msgid "2011-10-01"
799 msgstr ""
800
801 #. type: Plain text
802 #: build/C/man3/mbsnrtowcs.3:18
803 msgid "mbsnrtowcs - convert a multibyte string to a wide-character string"
804 msgstr ""
805
806 #. type: Plain text
807 #: build/C/man3/mbsnrtowcs.3:24
808 #, no-wrap
809 msgid ""
810 "B<size_t mbsnrtowcs(wchar_t *>I<dest>B<, const char **>I<src>B<,>\n"
811 "B<                  size_t >I<nms>B<, size_t >I<len>B<, mbstate_t "
812 "*>I<ps>B<);>\n"
813 msgstr ""
814
815 #. type: Plain text
816 #: build/C/man3/mbsnrtowcs.3:32
817 msgid "B<mbsnrtowcs>():"
818 msgstr ""
819
820 #. type: TP
821 #: 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
822 #, no-wrap
823 msgid "Since glibc 2.10:"
824 msgstr ""
825
826 #. type: Plain text
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
828 msgid "_XOPEN_SOURCE\\ E<gt>=\\ 700 || _POSIX_C_SOURCE\\ E<gt>=\\ 200809L"
829 msgstr ""
830
831 #. type: TP
832 #: 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
833 #, no-wrap
834 msgid "Before glibc 2.10:"
835 msgstr ""
836
837 #. type: Plain text
838 #: 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
839 msgid "_GNU_SOURCE"
840 msgstr ""
841
842 #. type: Plain text
843 #: build/C/man3/mbsnrtowcs.3:54
844 msgid ""
845 "The B<mbsnrtowcs>()  function is like the B<mbsrtowcs>(3)  function, except "
846 "that the number of bytes to be converted, starting at I<*src>, is limited to "
847 "I<nms>."
848 msgstr ""
849
850 #. type: Plain text
851 #: build/C/man3/mbsnrtowcs.3:87
852 msgid ""
853 "If I<dest> is not a NULL pointer, the B<mbsnrtowcs>()  function converts at "
854 "most I<nms> bytes from the multibyte string I<*src> to a wide-character "
855 "string starting at I<dest>.  At most I<len> wide characters are written to "
856 "I<dest>.  The shift state I<*ps> is updated.  The conversion is effectively "
857 "performed by repeatedly calling I<mbrtowc(dest, *src, n, ps)> where I<n> is "
858 "some positive number, as long as this call succeeds, and then incrementing "
859 "I<dest> by one and I<*src> by the number of bytes consumed.  The conversion "
860 "can stop for three reasons:"
861 msgstr ""
862
863 #. type: IP
864 #: build/C/man3/mbsnrtowcs.3:87 build/C/man3/mbsrtowcs.3:55 build/C/man3/wcsnrtombs.3:87
865 #, no-wrap
866 msgid "1."
867 msgstr ""
868
869 #. type: Plain text
870 #: build/C/man3/mbsnrtowcs.3:98 build/C/man3/mbsrtowcs.3:66
871 msgid ""
872 "An invalid multibyte sequence has been encountered.  In this case I<*src> is "
873 "left pointing to the invalid multibyte sequence, I<(size_t)\\ -1> is "
874 "returned, and I<errno> is set to B<EILSEQ>."
875 msgstr ""
876
877 #. type: IP
878 #: build/C/man3/mbsnrtowcs.3:98 build/C/man3/mbsrtowcs.3:66 build/C/man3/wcsnrtombs.3:99
879 #, no-wrap
880 msgid "2."
881 msgstr ""
882
883 #. type: Plain text
884 #: build/C/man3/mbsnrtowcs.3:114
885 msgid ""
886 "The I<nms> limit forces a stop, or I<len> non-L\\(aq\\e0\\(aq wide "
887 "characters have been stored at I<dest>.  In this case I<*src> is left "
888 "pointing to the next multibyte sequence to be converted, and the number of "
889 "wide characters written to I<dest> is returned."
890 msgstr ""
891
892 #. type: IP
893 #: build/C/man3/mbsnrtowcs.3:114 build/C/man3/mbsrtowcs.3:78 build/C/man3/wcsnrtombs.3:111
894 #, no-wrap
895 msgid "3."
896 msgstr ""
897
898 #. type: Plain text
899 #: build/C/man3/mbsnrtowcs.3:128
900 msgid ""
901 "The multibyte string has been completely converted, including the "
902 "terminating null wide character (\\(aq\\e0\\(aq)  (which has the side effect "
903 "of bringing back I<*ps> to the initial state).  In this case I<*src> is set "
904 "to NULL, and the number of wide characters written to I<dest>, excluding the "
905 "terminating null wide character, is returned."
906 msgstr ""
907
908 #. type: Plain text
909 #: build/C/man3/mbsnrtowcs.3:137
910 msgid ""
911 "If I<dest> is NULL, I<len> is ignored, and the conversion proceeds as above, "
912 "except that the converted wide characters are not written out to memory, and "
913 "that no destination length limit exists."
914 msgstr ""
915
916 #. type: Plain text
917 #: build/C/man3/mbsnrtowcs.3:144
918 msgid ""
919 "In both of the above cases, if I<ps> is a NULL pointer, a static anonymous "
920 "state known only to the B<mbsnrtowcs>()  function is used instead."
921 msgstr ""
922
923 #. type: Plain text
924 #: build/C/man3/mbsnrtowcs.3:150 build/C/man3/mbsrtowcs.3:114
925 msgid ""
926 "The programmer must ensure that there is room for at least I<len> wide "
927 "characters at I<dest>."
928 msgstr ""
929
930 #. type: Plain text
931 #: build/C/man3/mbsnrtowcs.3:163
932 msgid ""
933 "The B<mbsnrtowcs>()  function returns the number of wide characters that "
934 "make up the converted part of the wide-character string, not including the "
935 "terminating null wide character.  If an invalid multibyte sequence was "
936 "encountered, I<(size_t)\\ -1> is returned, and I<errno> set to B<EILSEQ>."
937 msgstr ""
938
939 #. type: Plain text
940 #: build/C/man3/mbsnrtowcs.3:165 build/C/man3/wcpcpy.3:69 build/C/man3/wcpncpy.3:95 build/C/man3/wcsnlen.3:84 build/C/man3/wcsnrtombs.3:162
941 msgid "POSIX.1-2008."
942 msgstr ""
943
944 #. type: Plain text
945 #: build/C/man3/mbsnrtowcs.3:172
946 msgid ""
947 "The behavior of B<mbsnrtowcs>()  depends on the B<LC_CTYPE> category of the "
948 "current locale."
949 msgstr ""
950
951 #. type: Plain text
952 #: build/C/man3/mbsnrtowcs.3:176 build/C/man3/mbsrtowcs.3:140 build/C/man3/wcrtomb.3:123 build/C/man3/wcsnrtombs.3:173 build/C/man3/wcsrtombs.3:139
953 msgid "Passing NULL as I<ps> is not multithread safe."
954 msgstr ""
955
956 #. type: Plain text
957 #: build/C/man3/mbsnrtowcs.3:179
958 msgid "B<iconv>(3), B<mbsrtowcs>(3)"
959 msgstr ""
960
961 #. type: TH
962 #: build/C/man3/mbsrtowcs.3:16
963 #, no-wrap
964 msgid "MBSRTOWCS"
965 msgstr ""
966
967 #. type: Plain text
968 #: build/C/man3/mbsrtowcs.3:19
969 msgid "mbsrtowcs - convert a multibyte string to a wide-character string"
970 msgstr ""
971
972 #. type: Plain text
973 #: build/C/man3/mbsrtowcs.3:25
974 #, no-wrap
975 msgid ""
976 "B<size_t mbsrtowcs(wchar_t *>I<dest>B<, const char **>I<src>B<,>\n"
977 "B<                  size_t >I<len>B<, mbstate_t *>I<ps>B<);>\n"
978 msgstr ""
979
980 #. type: Plain text
981 #: build/C/man3/mbsrtowcs.3:55
982 msgid ""
983 "If I<dest> is not a NULL pointer, the B<mbsrtowcs>()  function converts the "
984 "multibyte string I<*src> to a wide-character string starting at I<dest>.  At "
985 "most I<len> wide characters are written to I<dest>.  The shift state I<*ps> "
986 "is updated.  The conversion is effectively performed by repeatedly calling "
987 "I<mbrtowc(dest, *src, n, ps)> where I<n> is some positive number, as long as "
988 "this call succeeds, and then incrementing I<dest> by one and I<*src> by the "
989 "number of bytes consumed.  The conversion can stop for three reasons:"
990 msgstr ""
991
992 #. type: Plain text
993 #: build/C/man3/mbsrtowcs.3:78
994 msgid ""
995 "I<len> non-L\\(aq\\e0\\(aq wide characters have been stored at I<dest>.  In "
996 "this case I<*src> is left pointing to the next multibyte sequence to be "
997 "converted, and the number of wide characters written to I<dest> is returned."
998 msgstr ""
999
1000 #. type: Plain text
1001 #: build/C/man3/mbsrtowcs.3:91
1002 msgid ""
1003 "The multibyte string has been completely converted, including the "
1004 "terminating null wide character (\\(aq\\e0\\(aq), which has the side effect "
1005 "of bringing back I<*ps> to the initial state.  In this case I<*src> is set "
1006 "to NULL, and the number of wide characters written to I<dest>, excluding the "
1007 "terminating null wide character, is returned."
1008 msgstr ""
1009
1010 #. type: Plain text
1011 #: build/C/man3/mbsrtowcs.3:100
1012 msgid ""
1013 "If I<dest> is NULL, I<len> is ignored, and the conversion proceeds as above, "
1014 "except that the converted wide characters are not written out to memory, and "
1015 "that no length limit exists."
1016 msgstr ""
1017
1018 #. type: Plain text
1019 #: build/C/man3/mbsrtowcs.3:108
1020 msgid ""
1021 "In both of the above cases, if I<ps> is a NULL pointer, a static anonymous "
1022 "state known only to the B<mbsrtowcs>()  function is used instead."
1023 msgstr ""
1024
1025 #. type: Plain text
1026 #: build/C/man3/mbsrtowcs.3:127
1027 msgid ""
1028 "The B<mbsrtowcs>()  function returns the number of wide characters that make "
1029 "up the converted part of the wide-character string, not including the "
1030 "terminating null wide character.  If an invalid multibyte sequence was "
1031 "encountered, I<(size_t)\\ -1> is returned, and I<errno> set to B<EILSEQ>."
1032 msgstr ""
1033
1034 #. type: Plain text
1035 #: build/C/man3/mbsrtowcs.3:136
1036 msgid ""
1037 "The behavior of B<mbsrtowcs>()  depends on the B<LC_CTYPE> category of the "
1038 "current locale."
1039 msgstr ""
1040
1041 #. type: Plain text
1042 #: build/C/man3/mbsrtowcs.3:144
1043 msgid "B<iconv>(3), B<mbsnrtowcs>(3), B<mbstowcs>(3)"
1044 msgstr ""
1045
1046 #. type: TH
1047 #: build/C/man3/putwchar.3:17
1048 #, no-wrap
1049 msgid "PUTWCHAR"
1050 msgstr ""
1051
1052 #. type: Plain text
1053 #: build/C/man3/putwchar.3:20
1054 msgid "putwchar - write a wide character to standard output"
1055 msgstr ""
1056
1057 #. type: Plain text
1058 #: build/C/man3/putwchar.3:25
1059 #, no-wrap
1060 msgid "B<wint_t putwchar(wchar_t >I<wc>B<);>\n"
1061 msgstr ""
1062
1063 #. type: Plain text
1064 #: build/C/man3/putwchar.3:49
1065 msgid ""
1066 "The B<putwchar>()  function is the wide-character equivalent of the "
1067 "B<putchar>(3)  function.  It writes the wide character I<wc> to I<stdout>.  "
1068 "If I<ferror(stdout)> becomes true, it returns B<WEOF>.  If a wide character "
1069 "conversion error occurs, it sets I<errno> to B<EILSEQ> and returns B<WEOF>.  "
1070 "Otherwise it returns I<wc>."
1071 msgstr ""
1072
1073 #. type: Plain text
1074 #: build/C/man3/putwchar.3:60
1075 msgid ""
1076 "The B<putwchar>()  function returns I<wc> if no error occurred, or B<WEOF> "
1077 "to indicate an error."
1078 msgstr ""
1079
1080 #. type: Plain text
1081 #: build/C/man3/putwchar.3:69
1082 msgid ""
1083 "The behavior of B<putwchar>()  depends on the B<LC_CTYPE> category of the "
1084 "current locale."
1085 msgstr ""
1086
1087 #. type: Plain text
1088 #: build/C/man3/putwchar.3:75
1089 msgid ""
1090 "It is reasonable to expect that B<putwchar>()  will actually write the "
1091 "multibyte sequence corresponding to the wide character I<wc>."
1092 msgstr ""
1093
1094 #. type: TH
1095 #: build/C/man3/ungetwc.3:16
1096 #, no-wrap
1097 msgid "UNGETWC"
1098 msgstr ""
1099
1100 #. type: TH
1101 #: build/C/man3/ungetwc.3:16
1102 #, no-wrap
1103 msgid "1999-09-19"
1104 msgstr ""
1105
1106 #. type: Plain text
1107 #: build/C/man3/ungetwc.3:19
1108 msgid "ungetwc - push back a wide character onto a FILE stream"
1109 msgstr ""
1110
1111 #. type: Plain text
1112 #: build/C/man3/ungetwc.3:24
1113 #, no-wrap
1114 msgid "B<wint_t ungetwc(wint_t >I<wc>B<, FILE *>I<stream>B<);>\n"
1115 msgstr ""
1116
1117 #. type: Plain text
1118 #: build/C/man3/ungetwc.3:34
1119 msgid ""
1120 "The B<ungetwc>()  function is the wide-character equivalent of the "
1121 "B<ungetc>(3)  function.  It pushes back a wide character onto I<stream> and "
1122 "returns it."
1123 msgstr ""
1124
1125 #. type: Plain text
1126 #: build/C/man3/ungetwc.3:50
1127 msgid ""
1128 "If I<wc> is B<WEOF>, it returns B<WEOF>.  If I<wc> is an invalid wide "
1129 "character, it sets I<errno> to B<EILSEQ> and returns B<WEOF>."
1130 msgstr ""
1131
1132 #. type: Plain text
1133 #: build/C/man3/ungetwc.3:59
1134 msgid ""
1135 "If I<wc> is a valid wide character, it is pushed back onto the stream and "
1136 "thus becomes available for future wide-character read operations.  The "
1137 "file-position indicator is decremented by one or more.  The end-of-file "
1138 "indicator is cleared.  The backing storage of the file is not affected."
1139 msgstr ""
1140
1141 #. type: Plain text
1142 #: build/C/man3/ungetwc.3:64
1143 msgid ""
1144 "Note: I<wc> need not be the last wide-character read from the stream; it can "
1145 "be any other valid wide character."
1146 msgstr ""
1147
1148 #. type: Plain text
1149 #: build/C/man3/ungetwc.3:68
1150 msgid ""
1151 "If the implementation supports multiple push-back operations in a row, the "
1152 "pushed-back wide characters will be read in reverse order; however, only one "
1153 "level of push-back is guaranteed."
1154 msgstr ""
1155
1156 #. type: Plain text
1157 #: build/C/man3/ungetwc.3:77
1158 msgid ""
1159 "The B<ungetwc>()  function returns I<wc> when successful, or B<WEOF> upon "
1160 "failure."
1161 msgstr ""
1162
1163 #. type: Plain text
1164 #: build/C/man3/ungetwc.3:86
1165 msgid ""
1166 "The behavior of B<ungetwc>()  depends on the B<LC_CTYPE> category of the "
1167 "current locale."
1168 msgstr ""
1169
1170 #. type: Plain text
1171 #: build/C/man3/ungetwc.3:88
1172 msgid "B<fgetwc>(3)"
1173 msgstr ""
1174
1175 #. type: TH
1176 #: build/C/man3/wcpcpy.3:15
1177 #, no-wrap
1178 msgid "WCPCPY"
1179 msgstr ""
1180
1181 #. type: Plain text
1182 #: build/C/man3/wcpcpy.3:18
1183 msgid "wcpcpy - copy a wide-character string, returning a pointer to its end"
1184 msgstr ""
1185
1186 #. type: Plain text
1187 #: build/C/man3/wcpcpy.3:23
1188 #, no-wrap
1189 msgid "B<wchar_t *wcpcpy(wchar_t *>I<dest>B<, const wchar_t *>I<src>B<);>\n"
1190 msgstr ""
1191
1192 #. type: Plain text
1193 #: build/C/man3/wcpcpy.3:31
1194 msgid "B<wcpcpy>():"
1195 msgstr ""
1196
1197 #. type: Plain text
1198 #: build/C/man3/wcpcpy.3:54
1199 msgid ""
1200 "The B<wcpcpy>()  function is the wide-character equivalent of the "
1201 "B<stpcpy>(3)  function.  It copies the wide-character string pointed to by "
1202 "I<src>, including the terminating null wide character (L\\(aq\\e0\\(aq), to "
1203 "the array pointed to by I<dest>."
1204 msgstr ""
1205
1206 #. type: Plain text
1207 #: 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
1208 msgid "The strings may not overlap."
1209 msgstr ""
1210
1211 #. type: Plain text
1212 #: build/C/man3/wcpcpy.3:62 build/C/man3/wcscpy.3:45
1213 msgid ""
1214 "The programmer must ensure that there is room for at least I<wcslen(src)+1> "
1215 "wide characters at I<dest>."
1216 msgstr ""
1217
1218 #. type: Plain text
1219 #: build/C/man3/wcpcpy.3:67
1220 msgid ""
1221 "B<wcpcpy>()  returns a pointer to the end of the wide-character string "
1222 "I<dest>, that is, a pointer to the terminating null wide character."
1223 msgstr ""
1224
1225 #. type: Plain text
1226 #: build/C/man3/wcpcpy.3:72
1227 msgid "B<strcpy>(3), B<wcscpy>(3)"
1228 msgstr ""
1229
1230 #. type: TH
1231 #: build/C/man3/wcpncpy.3:15
1232 #, no-wrap
1233 msgid "WCPNCPY"
1234 msgstr ""
1235
1236 #. type: Plain text
1237 #: build/C/man3/wcpncpy.3:19
1238 msgid ""
1239 "wcpncpy - copy a fixed-size string of wide characters, returning a pointer "
1240 "to its end"
1241 msgstr ""
1242
1243 #. type: Plain text
1244 #: build/C/man3/wcpncpy.3:24
1245 #, no-wrap
1246 msgid ""
1247 "B<wchar_t *wcpncpy(wchar_t *>I<dest>B<, const wchar_t *>I<src>B<, size_t "
1248 ">I<n>B<);>\n"
1249 msgstr ""
1250
1251 #. type: Plain text
1252 #: build/C/man3/wcpncpy.3:32
1253 msgid "B<wcpncpy>():"
1254 msgstr ""
1255
1256 #. type: Plain text
1257 #: build/C/man3/wcpncpy.3:81
1258 msgid ""
1259 "The B<wcpncpy>()  function is the wide-character equivalent of the "
1260 "B<stpncpy>(3)  function.  It copies at most I<n> wide characters from the "
1261 "wide-character string pointed to by I<src>, including the terminating null "
1262 "wide (L\\(aq\\e0\\(aq), to the array pointed to by I<dest>.  Exactly I<n> "
1263 "wide characters are written at I<dest>.  If the length I<wcslen(src)> is "
1264 "smaller than I<n>, the remaining wide characters in the array pointed to by "
1265 "I<dest> are filled with L\\(aq\\e0\\(aq characters.  If the length "
1266 "I<wcslen(src)> is greater or equal to I<n>, the string pointed to by I<dest> "
1267 "will not be L\\(aq\\e0\\(aq terminated."
1268 msgstr ""
1269
1270 #. type: Plain text
1271 #: build/C/man3/wcpncpy.3:89 build/C/man3/wcsncpy.3:65 build/C/man3/wmemcpy.3:48 build/C/man3/wmemmove.3:46
1272 msgid ""
1273 "The programmer must ensure that there is room for at least I<n> wide "
1274 "characters at I<dest>."
1275 msgstr ""
1276
1277 #. type: Plain text
1278 #: build/C/man3/wcpncpy.3:93
1279 msgid ""
1280 "B<wcpncpy>()  returns a pointer to the last wide character written, that is, "
1281 "I<dest>+I<n>-I<1\">."
1282 msgstr ""
1283
1284 #. type: Plain text
1285 #: build/C/man3/wcpncpy.3:98
1286 msgid "B<stpncpy>(3), B<wcsncpy>(3)"
1287 msgstr ""
1288
1289 #. type: TH
1290 #: build/C/man3/wcrtomb.3:16
1291 #, no-wrap
1292 msgid "WCRTOMB"
1293 msgstr ""
1294
1295 #. type: Plain text
1296 #: build/C/man3/wcrtomb.3:19
1297 msgid "wcrtomb - convert a wide character to a multibyte sequence"
1298 msgstr ""
1299
1300 #. type: Plain text
1301 #: build/C/man3/wcrtomb.3:24
1302 #, no-wrap
1303 msgid "B<size_t wcrtomb(char *>I<s>B<, wchar_t >I<wc>B<, mbstate_t *>I<ps>B<);>\n"
1304 msgstr ""
1305
1306 #. type: Plain text
1307 #: build/C/man3/wcrtomb.3:48
1308 msgid ""
1309 "The main case for this function is when I<s> is not NULL and I<wc> is not a "
1310 "null wide character (L\\(aq\\e0\\(aq).  In this case, the B<wcrtomb>()  "
1311 "function converts the wide character I<wc> to its multibyte representation "
1312 "and stores it at the beginning of the character array pointed to by I<s>.  "
1313 "It updates the shift state I<*ps>, and returns the length of said multibyte "
1314 "representation, that is, the number of bytes written at I<s>."
1315 msgstr ""
1316
1317 #. type: Plain text
1318 #: build/C/man3/wcrtomb.3:73
1319 msgid ""
1320 "A different case is when I<s> is not NULL, but I<wc> is a null wide "
1321 "character (L\\(aq\\e0\\(aq).  In this case the B<wcrtomb>()  function stores "
1322 "at the character array pointed to by I<s> the shift sequence needed to bring "
1323 "I<*ps> back to the initial state, followed by a \\(aq\\e0\\(aq byte.  It "
1324 "updates the shift state I<*ps> (i.e., brings it into the initial state), and "
1325 "returns the length of the shift sequence plus one, that is, the number of "
1326 "bytes written at I<s>."
1327 msgstr ""
1328
1329 #. type: Plain text
1330 #: build/C/man3/wcrtomb.3:81
1331 msgid ""
1332 "A third case is when I<s> is NULL.  In this case I<wc> is ignored, and the "
1333 "function effectively returns"
1334 msgstr ""
1335
1336 #. type: Plain text
1337 #: build/C/man3/wcrtomb.3:83
1338 #, no-wrap
1339 msgid "    wcrtomb(buf, L\\(aq\\e0\\(aq, ps)\n"
1340 msgstr ""
1341
1342 #. type: Plain text
1343 #: build/C/man3/wcrtomb.3:87
1344 msgid "where I<buf> is an internal anonymous buffer."
1345 msgstr ""
1346
1347 #. type: Plain text
1348 #: build/C/man3/wcrtomb.3:94
1349 msgid ""
1350 "In all of the above cases, if I<ps> is a NULL pointer, a static anonymous "
1351 "state known only to the B<wcrtomb>()  function is used instead."
1352 msgstr ""
1353
1354 #. type: Plain text
1355 #: build/C/man3/wcrtomb.3:110
1356 msgid ""
1357 "The B<wcrtomb>()  function returns the number of bytes that have been or "
1358 "would have been written to the byte array at I<s>.  If I<wc> can not be "
1359 "represented as a multibyte sequence (according to the current locale), "
1360 "I<(size_t)\\ -1> is returned, and I<errno> set to B<EILSEQ>."
1361 msgstr ""
1362
1363 #. type: Plain text
1364 #: build/C/man3/wcrtomb.3:119
1365 msgid ""
1366 "The behavior of B<wcrtomb>()  depends on the B<LC_CTYPE> category of the "
1367 "current locale."
1368 msgstr ""
1369
1370 #. type: Plain text
1371 #: build/C/man3/wcrtomb.3:125
1372 msgid "B<wcsrtombs>(3)"
1373 msgstr ""
1374
1375 #. type: TH
1376 #: build/C/man3/wcscasecmp.3:15
1377 #, no-wrap
1378 msgid "WCSCASECMP"
1379 msgstr ""
1380
1381 #. type: TH
1382 #: build/C/man3/wcscasecmp.3:15 build/C/man3/wcsncasecmp.3:15
1383 #, no-wrap
1384 msgid "2010-09-15"
1385 msgstr ""
1386
1387 #. type: Plain text
1388 #: build/C/man3/wcscasecmp.3:18
1389 msgid "wcscasecmp - compare two wide-character strings, ignoring case"
1390 msgstr ""
1391
1392 #. type: Plain text
1393 #: build/C/man3/wcscasecmp.3:23
1394 #, no-wrap
1395 msgid "B<int wcscasecmp(const wchar_t *>I<s1>B<, const wchar_t *>I<s2>B<);>\n"
1396 msgstr ""
1397
1398 #. type: Plain text
1399 #: build/C/man3/wcscasecmp.3:31
1400 msgid "B<wcscasecmp>():"
1401 msgstr ""
1402
1403 #. type: Plain text
1404 #: build/C/man3/wcscasecmp.3:58
1405 msgid ""
1406 "The B<wcscasecmp>()  function is the wide-character equivalent of the "
1407 "B<strcasecmp>(3)  function.  It compares the wide-character string pointed "
1408 "to by I<s1> and the wide-character string pointed to by I<s2>, ignoring case "
1409 "differences (B<towupper>(3), B<towlower>(3))."
1410 msgstr ""
1411
1412 #. type: Plain text
1413 #: build/C/man3/wcscasecmp.3:79
1414 msgid ""
1415 "The B<wcscasecmp>()  function returns zero if the wide-character strings at "
1416 "I<s1> and I<s2> are equal except for case distinctions.  It returns a "
1417 "positive integer if I<s1> is greater than I<s2>, ignoring case.  It returns "
1418 "a negative integer if I<s1> is smaller than I<s2>, ignoring case."
1419 msgstr ""
1420
1421 #. type: SH
1422 #: build/C/man3/wcscasecmp.3:79 build/C/man3/wcsncasecmp.3:84 build/C/man3/wcsnlen.3:78
1423 #, no-wrap
1424 msgid "VERSIONS"
1425 msgstr ""
1426
1427 #. type: Plain text
1428 #: build/C/man3/wcscasecmp.3:83
1429 msgid "The B<wcscasecmp>()  function is provided in glibc since version 2.1."
1430 msgstr ""
1431
1432 #. type: Plain text
1433 #: build/C/man3/wcscasecmp.3:87 build/C/man3/wcsdup.3:75 build/C/man3/wcsncasecmp.3:92
1434 msgid ""
1435 "POSIX.1-2008.  This function is not specified in POSIX.1-2001, and is not "
1436 "widely available on other systems."
1437 msgstr ""
1438
1439 #. type: Plain text
1440 #: build/C/man3/wcscasecmp.3:94
1441 msgid ""
1442 "The behavior of B<wcscasecmp>()  depends on the B<LC_CTYPE> category of the "
1443 "current locale."
1444 msgstr ""
1445
1446 #. type: Plain text
1447 #: build/C/man3/wcscasecmp.3:97
1448 msgid "B<strcasecmp>(3), B<wcscmp>(3)"
1449 msgstr ""
1450
1451 #. type: TH
1452 #: build/C/man3/wcscat.3:16
1453 #, no-wrap
1454 msgid "WCSCAT"
1455 msgstr ""
1456
1457 #. type: Plain text
1458 #: build/C/man3/wcscat.3:19
1459 msgid "wcscat - concatenate two wide-character strings"
1460 msgstr ""
1461
1462 #. type: Plain text
1463 #: build/C/man3/wcscat.3:24
1464 #, no-wrap
1465 msgid "B<wchar_t *wcscat(wchar_t *>I<dest>B<, const wchar_t *>I<src>B<);>\n"
1466 msgstr ""
1467
1468 #. type: Plain text
1469 #: build/C/man3/wcscat.3:37
1470 msgid ""
1471 "The B<wcscat>()  function is the wide-character equivalent of the "
1472 "B<strcat>(3)  function.  It copies the wide-character string pointed to by "
1473 "I<src>, including the terminating null wide character (L\\(aq\\e0\\(aq), to "
1474 "the end of the wide-character string pointed to by I<dest>."
1475 msgstr ""
1476
1477 #. type: Plain text
1478 #: build/C/man3/wcscat.3:44
1479 msgid ""
1480 "The programmer must ensure that there is room for at least I<wcslen(dest) + "
1481 "wcslen(src) + 1> wide characters at I<dest>."
1482 msgstr ""
1483
1484 #. type: Plain text
1485 #: build/C/man3/wcscat.3:48
1486 msgid "B<wcscat>()  returns I<dest>."
1487 msgstr ""
1488
1489 #. type: Plain text
1490 #: build/C/man3/wcscat.3:55
1491 msgid "B<strcat>(3), B<wcpcpy>(3), B<wcscpy>(3), B<wcsncat>(3)"
1492 msgstr ""
1493
1494 #. type: TH
1495 #: build/C/man3/wcschr.3:16
1496 #, no-wrap
1497 msgid "WCSCHR"
1498 msgstr ""
1499
1500 #. type: Plain text
1501 #: build/C/man3/wcschr.3:19
1502 msgid "wcschr - search a wide character in a wide-character string"
1503 msgstr ""
1504
1505 #. type: Plain text
1506 #: build/C/man3/wcschr.3:24
1507 #, no-wrap
1508 msgid "B<wchar_t *wcschr(const wchar_t *>I<wcs>B<, wchar_t >I<wc>B<);>\n"
1509 msgstr ""
1510
1511 #. type: Plain text
1512 #: build/C/man3/wcschr.3:37
1513 msgid ""
1514 "The B<wcschr>()  function is the wide-character equivalent of the "
1515 "B<strchr>(3)  function.  It searches the first occurrence of I<wc> in the "
1516 "wide-character string pointed to by I<wcs>."
1517 msgstr ""
1518
1519 #. type: Plain text
1520 #: build/C/man3/wcschr.3:47
1521 msgid ""
1522 "The B<wcschr>()  function returns a pointer to the first occurrence of I<wc> "
1523 "in the wide-character string pointed to by I<wcs>, or NULL if I<wc> does not "
1524 "occur in the string."
1525 msgstr ""
1526
1527 #. type: Plain text
1528 #: build/C/man3/wcschr.3:55
1529 msgid "B<strchr>(3), B<wcspbrk>(3), B<wcsrchr>(3), B<wcsstr>(3), B<wmemchr>(3)"
1530 msgstr ""
1531
1532 #. type: TH
1533 #: build/C/man3/wcscmp.3:16
1534 #, no-wrap
1535 msgid "WCSCMP"
1536 msgstr ""
1537
1538 #. type: Plain text
1539 #: build/C/man3/wcscmp.3:19
1540 msgid "wcscmp - compare two wide-character strings"
1541 msgstr ""
1542
1543 #. type: Plain text
1544 #: build/C/man3/wcscmp.3:24
1545 #, no-wrap
1546 msgid "B<int wcscmp(const wchar_t *>I<s1>B<, const wchar_t *>I<s2>B<);>\n"
1547 msgstr ""
1548
1549 #. type: Plain text
1550 #: build/C/man3/wcscmp.3:37
1551 msgid ""
1552 "The B<wcscmp>()  function is the wide-character equivalent of the "
1553 "B<strcmp>(3)  function.  It compares the wide-character string pointed to by "
1554 "I<s1> and the wide-character string pointed to by I<s2>."
1555 msgstr ""
1556
1557 #. type: Plain text
1558 #: build/C/man3/wcscmp.3:59
1559 msgid ""
1560 "The B<wcscmp>()  function returns zero if the wide-character strings at "
1561 "I<s1> and I<s2> are equal.  It returns an integer greater than zero if at "
1562 "the first differing position I<i>, the corresponding wide-character I<s1[i]> "
1563 "is greater than I<s2[i]>.  It returns an integer less than zero if at the "
1564 "first differing position I<i>, the corresponding wide-character I<s1[i]> is "
1565 "less than I<s2[i]>."
1566 msgstr ""
1567
1568 #. type: Plain text
1569 #: build/C/man3/wcscmp.3:65
1570 msgid "B<strcmp>(3), B<wcscasecmp>(3), B<wmemcmp>(3)"
1571 msgstr ""
1572
1573 #. type: TH
1574 #: build/C/man3/wcscpy.3:16
1575 #, no-wrap
1576 msgid "WCSCPY"
1577 msgstr ""
1578
1579 #. type: Plain text
1580 #: build/C/man3/wcscpy.3:19
1581 msgid "wcscpy - copy a wide-character string"
1582 msgstr ""
1583
1584 #. type: Plain text
1585 #: build/C/man3/wcscpy.3:24
1586 #, no-wrap
1587 msgid "B<wchar_t *wcscpy(wchar_t *>I<dest>B<, const wchar_t *>I<src>B<);>\n"
1588 msgstr ""
1589
1590 #. type: Plain text
1591 #: build/C/man3/wcscpy.3:37
1592 msgid ""
1593 "The B<wcscpy>()  function is the wide-character equivalent of the "
1594 "B<strcpy>(3)  function.  It copies the wide-character string pointed to by "
1595 "I<src>, including the terminating null wide character (L\\(aq\\e0\\(aq), to "
1596 "the array pointed to by I<dest>."
1597 msgstr ""
1598
1599 #. type: Plain text
1600 #: build/C/man3/wcscpy.3:49
1601 msgid "B<wcscpy>()  returns I<dest>."
1602 msgstr ""
1603
1604 #. type: Plain text
1605 #: build/C/man3/wcscpy.3:57
1606 msgid "B<strcpy>(3), B<wcpcpy>(3), B<wcscat>(3), B<wcsdup>(3), B<wmemcpy>(3)"
1607 msgstr ""
1608
1609 #. type: TH
1610 #: build/C/man3/wcscspn.3:16
1611 #, no-wrap
1612 msgid "WCSCSPN"
1613 msgstr ""
1614
1615 #. type: Plain text
1616 #: build/C/man3/wcscspn.3:19
1617 msgid "wcscspn - search a wide-character string for any of a set of wide characters"
1618 msgstr ""
1619
1620 #. type: Plain text
1621 #: build/C/man3/wcscspn.3:24
1622 #, no-wrap
1623 msgid "B<size_t wcscspn(const wchar_t *>I<wcs>B<, const wchar_t *>I<reject>B<);>\n"
1624 msgstr ""
1625
1626 #. type: Plain text
1627 #: build/C/man3/wcscspn.3:42
1628 msgid ""
1629 "The B<wcscspn>()  function is the wide-character equivalent of the "
1630 "B<strcspn>(3)  function.  It determines the length of the longest initial "
1631 "segment of I<wcs> which consists entirely of wide-characters not listed in "
1632 "I<reject>.  In other words, it searches for the first occurrence in the "
1633 "wide-character string I<wcs> of any of the characters in the wide-character "
1634 "string I<reject>."
1635 msgstr ""
1636
1637 #. type: Plain text
1638 #: build/C/man3/wcscspn.3:61
1639 msgid ""
1640 "The B<wcscspn>()  function returns the number of wide characters in the "
1641 "longest initial segment of I<wcs> which consists entirely of wide-characters "
1642 "not listed in I<reject>.  In other words, it returns the position of the "
1643 "first occurrence in the wide-character string I<wcs> of any of the "
1644 "characters in the wide-character string I<reject>, or I<wcslen(wcs)> if "
1645 "there is none."
1646 msgstr ""
1647
1648 #. type: Plain text
1649 #: build/C/man3/wcscspn.3:67
1650 msgid "B<strcspn>(3), B<wcspbrk>(3), B<wcsspn>(3)"
1651 msgstr ""
1652
1653 #. type: TH
1654 #: build/C/man3/wcsdup.3:15
1655 #, no-wrap
1656 msgid "WCSDUP"
1657 msgstr ""
1658
1659 #. type: TH
1660 #: build/C/man3/wcsdup.3:15
1661 #, no-wrap
1662 msgid "2013-04-19"
1663 msgstr ""
1664
1665 #. type: Plain text
1666 #: build/C/man3/wcsdup.3:18
1667 msgid "wcsdup - duplicate a wide-character string"
1668 msgstr ""
1669
1670 #. type: Plain text
1671 #: build/C/man3/wcsdup.3:23
1672 #, no-wrap
1673 msgid "B<wchar_t *wcsdup(const wchar_t *>I<s>B<);>\n"
1674 msgstr ""
1675
1676 #. type: Plain text
1677 #: build/C/man3/wcsdup.3:31
1678 msgid "B<wcsdup>():"
1679 msgstr ""
1680
1681 #. type: Plain text
1682 #: build/C/man3/wcsdup.3:53
1683 msgid ""
1684 "The B<wcsdup>()  function is the wide-character equivalent of the "
1685 "B<strdup>(3)  function.  It allocates and returns a new wide-character "
1686 "string whose initial contents is a duplicate of the wide-character string "
1687 "pointed to by I<s>."
1688 msgstr ""
1689
1690 #. type: Plain text
1691 #: build/C/man3/wcsdup.3:59
1692 msgid ""
1693 "Memory for the new wide-character string is obtained with B<malloc>(3), and "
1694 "should be freed with B<free>(3)."
1695 msgstr ""
1696
1697 #. type: Plain text
1698 #: build/C/man3/wcsdup.3:66
1699 msgid ""
1700 "On success, B<wcsdup>()  returns a pointer to the new wide-character "
1701 "string.  On error, it returns -1, with I<errno> set to indicate the cause of "
1702 "the error."
1703 msgstr ""
1704
1705 #. type: SH
1706 #: build/C/man3/wcsdup.3:66
1707 #, no-wrap
1708 msgid "ERRORS"
1709 msgstr ""
1710
1711 #. type: TP
1712 #: build/C/man3/wcsdup.3:67
1713 #, no-wrap
1714 msgid "B<ENOMEM>"
1715 msgstr ""
1716
1717 #. type: Plain text
1718 #: build/C/man3/wcsdup.3:70
1719 msgid "Insufficient memory available to allocate duplicate string."
1720 msgstr ""
1721
1722 #. type: Plain text
1723 #: build/C/man3/wcsdup.3:78
1724 msgid "B<strdup>(3), B<wcscpy>(3)"
1725 msgstr ""
1726
1727 #. type: TH
1728 #: build/C/man3/wcslen.3:16
1729 #, no-wrap
1730 msgid "WCSLEN"
1731 msgstr ""
1732
1733 #. type: Plain text
1734 #: build/C/man3/wcslen.3:19
1735 msgid "wcslen - determine the length of a wide-character string"
1736 msgstr ""
1737
1738 #. type: Plain text
1739 #: build/C/man3/wcslen.3:24
1740 #, no-wrap
1741 msgid "B<size_t wcslen(const wchar_t *>I<s>B<);>\n"
1742 msgstr ""
1743
1744 #. type: Plain text
1745 #: build/C/man3/wcslen.3:36
1746 msgid ""
1747 "The B<wcslen>()  function is the wide-character equivalent of the "
1748 "B<strlen>(3)  function.  It determines the length of the wide-character "
1749 "string pointed to by I<s>, excluding the terminating null wide character "
1750 "(L\\(aq\\e0\\(aq)."
1751 msgstr ""
1752
1753 #. type: Plain text
1754 #: build/C/man3/wcslen.3:42
1755 msgid "The B<wcslen>()  function returns the number of wide characters in I<s>."
1756 msgstr ""
1757
1758 #. type: Plain text
1759 #: build/C/man3/wcslen.3:46
1760 msgid "B<strlen>(3)"
1761 msgstr ""
1762
1763 #. type: TH
1764 #: build/C/man3/wcsncasecmp.3:15
1765 #, no-wrap
1766 msgid "WCSNCASECMP"
1767 msgstr ""
1768
1769 #. type: Plain text
1770 #: build/C/man3/wcsncasecmp.3:18
1771 msgid "wcsncasecmp - compare two fixed-size wide-character strings, ignoring case"
1772 msgstr ""
1773
1774 #. type: Plain text
1775 #: build/C/man3/wcsncasecmp.3:23
1776 #, no-wrap
1777 msgid ""
1778 "B<int wcsncasecmp(const wchar_t *>I<s1>B<, const wchar_t *>I<s2>B<, size_t "
1779 ">I<n>B<);>\n"
1780 msgstr ""
1781
1782 #. type: Plain text
1783 #: build/C/man3/wcsncasecmp.3:31
1784 msgid "B<wcsncasecmp>():"
1785 msgstr ""
1786
1787 #. type: Plain text
1788 #: build/C/man3/wcsncasecmp.3:60
1789 msgid ""
1790 "The B<wcsncasecmp>()  function is the wide-character equivalent of the "
1791 "B<strncasecmp>(3)  function.  It compares the wide-character string pointed "
1792 "to by I<s1> and the wide-character string pointed to by I<s2>, but at most "
1793 "I<n> wide characters from each string, ignoring case differences "
1794 "(B<towupper>(3), B<towlower>(3))."
1795 msgstr ""
1796
1797 #. type: Plain text
1798 #: build/C/man3/wcsncasecmp.3:84
1799 msgid ""
1800 "The B<wcsncasecmp>()  function returns zero if the wide-character strings at "
1801 "I<s1> and I<s2>, truncated to at most length I<n>, are equal except for case "
1802 "distinctions.  It returns a positive integer if truncated I<s1> is greater "
1803 "than truncated I<s2>, ignoring case.  It returns a negative integer if "
1804 "truncated I<s1> is smaller than truncated I<s2>, ignoring case."
1805 msgstr ""
1806
1807 #. type: Plain text
1808 #: build/C/man3/wcsncasecmp.3:88
1809 msgid "The B<wcsncasecmp>()  function is provided in glibc since version 2.1."
1810 msgstr ""
1811
1812 #. type: Plain text
1813 #: build/C/man3/wcsncasecmp.3:99
1814 msgid ""
1815 "The behavior of B<wcsncasecmp>()  depends on the B<LC_CTYPE> category of the "
1816 "current locale."
1817 msgstr ""
1818
1819 #. type: Plain text
1820 #: build/C/man3/wcsncasecmp.3:102
1821 msgid "B<strncasecmp>(3), B<wcsncmp>(3)"
1822 msgstr ""
1823
1824 #. type: TH
1825 #: build/C/man3/wcsncat.3:16
1826 #, no-wrap
1827 msgid "WCSNCAT"
1828 msgstr ""
1829
1830 #. type: Plain text
1831 #: build/C/man3/wcsncat.3:19
1832 msgid "wcsncat - concatenate two wide-character strings"
1833 msgstr ""
1834
1835 #. type: Plain text
1836 #: build/C/man3/wcsncat.3:24
1837 #, no-wrap
1838 msgid ""
1839 "B<wchar_t *wcsncat(wchar_t *>I<dest>B<, const wchar_t *>I<src>B<, size_t "
1840 ">I<n>B<);>\n"
1841 msgstr ""
1842
1843 #. type: Plain text
1844 #: build/C/man3/wcsncat.3:40
1845 msgid ""
1846 "The B<wcsncat>()  function is the wide-character equivalent of the "
1847 "B<strncat>(3)  function.  It copies at most I<n> wide characters from the "
1848 "wide-character string pointed to by I<src> to the end of the wide-character "
1849 "string pointed to by I<dest>, and adds a terminating null wide character "
1850 "(L\\(aq\\e0\\(aq)."
1851 msgstr ""
1852
1853 #. type: Plain text
1854 #: build/C/man3/wcsncat.3:47
1855 msgid ""
1856 "The programmer must ensure that there is room for at least I<wcslen(dest) + "
1857 "n + 1> wide characters at I<dest>."
1858 msgstr ""
1859
1860 #. type: Plain text
1861 #: build/C/man3/wcsncat.3:51
1862 msgid "B<wcsncat>()  returns I<dest>."
1863 msgstr ""
1864
1865 #. type: Plain text
1866 #: build/C/man3/wcsncat.3:56
1867 msgid "B<strncat>(3), B<wcscat>(3)"
1868 msgstr ""
1869
1870 #. type: TH
1871 #: build/C/man3/wcsncmp.3:16
1872 #, no-wrap
1873 msgid "WCSNCMP"
1874 msgstr ""
1875
1876 #. type: Plain text
1877 #: build/C/man3/wcsncmp.3:19
1878 msgid "wcsncmp - compare two fixed-size wide-character strings"
1879 msgstr ""
1880
1881 #. type: Plain text
1882 #: build/C/man3/wcsncmp.3:24
1883 #, no-wrap
1884 msgid ""
1885 "B<int wcsncmp(const wchar_t *>I<s1>B<, const wchar_t *>I<s2>B<, size_t "
1886 ">I<n>B<);>\n"
1887 msgstr ""
1888
1889 #. type: Plain text
1890 #: build/C/man3/wcsncmp.3:42
1891 msgid ""
1892 "The B<wcsncmp>()  function is the wide-character equivalent of the "
1893 "B<strncmp>(3)  function.  It compares the wide-character string pointed to "
1894 "by I<s1> and the wide-character string pointed to by I<s2>, but at most I<n> "
1895 "wide characters from each string.  In each string, the comparison extends "
1896 "only up to the first occurrence of a null wide character (L\\(aq\\e0\\(aq), "
1897 "if any."
1898 msgstr ""
1899
1900 #. type: Plain text
1901 #: build/C/man3/wcsncmp.3:73
1902 msgid ""
1903 "The B<wcsncmp>()  function returns zero if the wide-character strings at "
1904 "I<s1> and I<s2>, truncated to at most length I<n>, are equal.  It returns an "
1905 "integer greater than zero if at the first differing position I<i> (I<i> "
1906 "E<lt> I<n>), the corresponding wide-character I<s1[i]> is greater than "
1907 "I<s2[i]>.  It returns an integer less than zero if at the first differing "
1908 "position I<i> (i E<lt> I<n>), the corresponding wide-character I<s1[i]> is "
1909 "less than I<s2[i]>."
1910 msgstr ""
1911
1912 #. type: Plain text
1913 #: build/C/man3/wcsncmp.3:78
1914 msgid "B<strncmp>(3), B<wcsncasecmp>(3)"
1915 msgstr ""
1916
1917 #. type: TH
1918 #: build/C/man3/wcsncpy.3:16
1919 #, no-wrap
1920 msgid "WCSNCPY"
1921 msgstr ""
1922
1923 #. type: Plain text
1924 #: build/C/man3/wcsncpy.3:19
1925 msgid "wcsncpy - copy a fixed-size string of wide characters"
1926 msgstr ""
1927
1928 #. type: Plain text
1929 #: build/C/man3/wcsncpy.3:24
1930 #, no-wrap
1931 msgid ""
1932 "B<wchar_t *wcsncpy(wchar_t *>I<dest>B<, const wchar_t *>I<src>B<, size_t "
1933 ">I<n>B<);>\n"
1934 msgstr ""
1935
1936 #. type: Plain text
1937 #: build/C/man3/wcsncpy.3:57
1938 msgid ""
1939 "The B<wcsncpy>()  function is the wide-character equivalent of the "
1940 "B<strncpy>(3)  function.  It copies at most I<n> wide characters from the "
1941 "wide-character string pointed to by I<src>, including the terminating null "
1942 "wide character (L\\(aq\\e0\\(aq), to the array pointed to by I<dest>.  "
1943 "Exactly I<n> wide characters are written at I<dest>.  If the length "
1944 "I<wcslen(src)> is smaller than I<n>, the remaining wide characters in the "
1945 "array pointed to by I<dest> are filled with null wide characters.  If the "
1946 "length I<wcslen(src)> is greater or equal to I<n>, the string pointed to by "
1947 "I<dest> will not be terminated by a null wide character."
1948 msgstr ""
1949
1950 #. type: Plain text
1951 #: build/C/man3/wcsncpy.3:69
1952 msgid "B<wcsncpy>()  returns I<dest>."
1953 msgstr ""
1954
1955 #. type: Plain text
1956 #: build/C/man3/wcsncpy.3:73
1957 msgid "B<strncpy>(3)"
1958 msgstr ""
1959
1960 #. type: TH
1961 #: build/C/man3/wcsnlen.3:15
1962 #, no-wrap
1963 msgid "WCSNLEN"
1964 msgstr ""
1965
1966 #. type: Plain text
1967 #: build/C/man3/wcsnlen.3:18
1968 msgid "wcsnlen - determine the length of a fixed-size wide-character string"
1969 msgstr ""
1970
1971 #. type: Plain text
1972 #: build/C/man3/wcsnlen.3:23
1973 #, no-wrap
1974 msgid "B<size_t wcsnlen(const wchar_t *>I<s>B<, size_t >I<maxlen>B<);>\n"
1975 msgstr ""
1976
1977 #. type: Plain text
1978 #: build/C/man3/wcsnlen.3:31
1979 msgid "B<wcsnlen>():"
1980 msgstr ""
1981
1982 #. type: Plain text
1983 #: build/C/man3/wcsnlen.3:64
1984 msgid ""
1985 "The B<wcsnlen>()  function is the wide-character equivalent of the "
1986 "B<strnlen>(3)  function.  It returns the number of wide-characters in the "
1987 "string pointed to by I<s>, not including the terminating null wide character "
1988 "(L\\(aq\\e0\\(aq), but at most I<maxlen> wide characters (note: this "
1989 "parameter is not a byte count).  In doing this, B<wcsnlen>()  looks at only "
1990 "the first I<maxlen> wide characters at I<s> and never beyond I<s+maxlen>."
1991 msgstr ""
1992
1993 #. type: Plain text
1994 #: build/C/man3/wcsnlen.3:78
1995 msgid ""
1996 "The B<wcsnlen>()  function returns I<wcslen(s)>, if that is less than "
1997 "I<maxlen>, or I<maxlen> if there is no null wide character among the first "
1998 "I<maxlen> wide characters pointed to by I<s>."
1999 msgstr ""
2000
2001 #. type: Plain text
2002 #: build/C/man3/wcsnlen.3:82
2003 msgid "The B<wcsnlen>()  function is provided in glibc since version 2.1."
2004 msgstr ""
2005
2006 #. type: Plain text
2007 #: build/C/man3/wcsnlen.3:87
2008 msgid "B<strnlen>(3), B<wcslen>(3)"
2009 msgstr ""
2010
2011 #. type: TH
2012 #: build/C/man3/wcsnrtombs.3:15
2013 #, no-wrap
2014 msgid "WCSNRTOMBS"
2015 msgstr ""
2016
2017 #. type: TH
2018 #: build/C/man3/wcsnrtombs.3:15 build/C/man3/wcsrtombs.3:16
2019 #, no-wrap
2020 msgid "2011-10-16"
2021 msgstr ""
2022
2023 #. type: Plain text
2024 #: build/C/man3/wcsnrtombs.3:18
2025 msgid "wcsnrtombs - convert a wide-character string to a multibyte string"
2026 msgstr ""
2027
2028 #. type: Plain text
2029 #: build/C/man3/wcsnrtombs.3:24
2030 #, no-wrap
2031 msgid ""
2032 "B<size_t wcsnrtombs(char *>I<dest>B<, const wchar_t **>I<src>B<, size_t "
2033 ">I<nwc>B<,>\n"
2034 "B<                  size_t >I<len>B<, mbstate_t *>I<ps>B<);>\n"
2035 msgstr ""
2036
2037 #. type: Plain text
2038 #: build/C/man3/wcsnrtombs.3:32
2039 msgid "B<wcsnrtombs>():"
2040 msgstr ""
2041
2042 #. type: Plain text
2043 #: build/C/man3/wcsnrtombs.3:55
2044 msgid ""
2045 "The B<wcsnrtombs>()  function is like the B<wcsrtombs>(3)  function, except "
2046 "that the number of wide characters to be converted, starting at I<*src>, is "
2047 "limited to I<nwc>."
2048 msgstr ""
2049
2050 #. type: Plain text
2051 #: build/C/man3/wcsnrtombs.3:87
2052 msgid ""
2053 "If I<dest> is not a NULL pointer, the B<wcsnrtombs>()  function converts at "
2054 "most I<nwc> wide characters from the wide-character string I<*src> to a "
2055 "multibyte string starting at I<dest>.  At most I<len> bytes are written to "
2056 "I<dest>.  The shift state I<*ps> is updated.  The conversion is effectively "
2057 "performed by repeatedly calling I<wcrtomb(dest, *src, ps)>, as long as this "
2058 "call succeeds, and then incrementing I<dest> by the number of bytes written "
2059 "and I<*src> by one.  The conversion can stop for three reasons:"
2060 msgstr ""
2061
2062 #. type: Plain text
2063 #: build/C/man3/wcsnrtombs.3:99
2064 msgid ""
2065 "A wide character has been encountered that can not be represented as a "
2066 "multibyte sequence (according to the current locale).  In this case I<*src> "
2067 "is left pointing to the invalid wide character, I<(size_t)\\ -1> is "
2068 "returned, and I<errno> is set to B<EILSEQ>."
2069 msgstr ""
2070
2071 #. type: Plain text
2072 #: build/C/man3/wcsnrtombs.3:111
2073 msgid ""
2074 "I<nwc> wide characters have been converted without encountering a null wide "
2075 "character (L\\(aq\\e0\\(aq), or the length limit forces a stop.  In this "
2076 "case I<*src> is left pointing to the next wide character to be converted, "
2077 "and the number of bytes written to I<dest> is returned."
2078 msgstr ""
2079
2080 #. type: Plain text
2081 #: build/C/man3/wcsnrtombs.3:123
2082 msgid ""
2083 "The wide-character string has been completely converted, including the "
2084 "terminating null wide character (which has the side effect of bringing back "
2085 "I<*ps> to the initial state).  In this case I<*src> is set to NULL, and the "
2086 "number of bytes written to I<dest>, excluding the terminating null byte "
2087 "(\\(aq\\e0\\(aq), is returned."
2088 msgstr ""
2089
2090 #. type: Plain text
2091 #: build/C/man3/wcsnrtombs.3:132
2092 msgid ""
2093 "If I<dest> is NULL, I<len> is ignored, and the conversion proceeds as above, "
2094 "except that the converted bytes are not written out to memory, and that no "
2095 "destination length limit exists."
2096 msgstr ""
2097
2098 #. type: Plain text
2099 #: build/C/man3/wcsnrtombs.3:140
2100 msgid ""
2101 "In both of the above cases, if I<ps> is a NULL pointer, a static anonymous "
2102 "state known only to the B<wcsnrtombs>()  function is used instead."
2103 msgstr ""
2104
2105 #. type: Plain text
2106 #: build/C/man3/wcsnrtombs.3:146 build/C/man3/wcsrtombs.3:112
2107 msgid ""
2108 "The programmer must ensure that there is room for at least I<len> bytes at "
2109 "I<dest>."
2110 msgstr ""
2111
2112 #. type: Plain text
2113 #: build/C/man3/wcsnrtombs.3:160
2114 msgid ""
2115 "The B<wcsnrtombs>()  function returns the number of bytes that make up the "
2116 "converted part of multibyte sequence, not including the terminating null "
2117 "byte.  If a wide character was encountered which could not be converted, "
2118 "I<(size_t)\\ -1> is returned, and I<errno> set to B<EILSEQ>."
2119 msgstr ""
2120
2121 #. type: Plain text
2122 #: build/C/man3/wcsnrtombs.3:169
2123 msgid ""
2124 "The behavior of B<wcsnrtombs>()  depends on the B<LC_CTYPE> category of the "
2125 "current locale."
2126 msgstr ""
2127
2128 #. type: Plain text
2129 #: build/C/man3/wcsnrtombs.3:176
2130 msgid "B<iconv>(3), B<wcsrtombs>(3)"
2131 msgstr ""
2132
2133 #. type: TH
2134 #: build/C/man3/wcspbrk.3:16
2135 #, no-wrap
2136 msgid "WCSPBRK"
2137 msgstr ""
2138
2139 #. type: Plain text
2140 #: build/C/man3/wcspbrk.3:19
2141 msgid "wcspbrk - search a wide-character string for any of a set of wide characters"
2142 msgstr ""
2143
2144 #. type: Plain text
2145 #: build/C/man3/wcspbrk.3:24
2146 #, no-wrap
2147 msgid ""
2148 "B<wchar_t *wcspbrk(const wchar_t *>I<wcs>B<, const wchar_t "
2149 "*>I<accept>B<);>\n"
2150 msgstr ""
2151
2152 #. type: Plain text
2153 #: build/C/man3/wcspbrk.3:39
2154 msgid ""
2155 "The B<wcspbrk>()  function is the wide-character equivalent of the "
2156 "B<strpbrk>(3)  function.  It searches for the first occurrence in the "
2157 "wide-character string pointed to by I<wcs> of any of the characters in the "
2158 "wide-character string pointed to by I<accept>."
2159 msgstr ""
2160
2161 #. type: Plain text
2162 #: build/C/man3/wcspbrk.3:49
2163 msgid ""
2164 "The B<wcspbrk>()  function returns a pointer to the first occurrence in "
2165 "I<wcs> of any of the characters listed in I<accept>.  If I<wcs> contains "
2166 "none of these characters, NULL is returned."
2167 msgstr ""
2168
2169 #. type: Plain text
2170 #: build/C/man3/wcspbrk.3:55
2171 msgid "B<strpbrk>(3), B<wcschr>(3), B<wcscspn>(3)"
2172 msgstr ""
2173
2174 #. type: TH
2175 #: build/C/man3/wcsrchr.3:16
2176 #, no-wrap
2177 msgid "WCSRCHR"
2178 msgstr ""
2179
2180 #. type: Plain text
2181 #: build/C/man3/wcsrchr.3:19
2182 msgid "wcsrchr - search a wide character in a wide-character string"
2183 msgstr ""
2184
2185 #. type: Plain text
2186 #: build/C/man3/wcsrchr.3:24
2187 #, no-wrap
2188 msgid "B<wchar_t *wcsrchr(const wchar_t *>I<wcs>B<, wchar_t >I<wc>B<);>\n"
2189 msgstr ""
2190
2191 #. type: Plain text
2192 #: build/C/man3/wcsrchr.3:37
2193 msgid ""
2194 "The B<wcsrchr>()  function is the wide-character equivalent of the "
2195 "B<strrchr>(3)  function.  It searches the last occurrence of I<wc> in the "
2196 "wide-character string pointed to by I<wcs>."
2197 msgstr ""
2198
2199 #. type: Plain text
2200 #: build/C/man3/wcsrchr.3:47
2201 msgid ""
2202 "The B<wcsrchr>()  function returns a pointer to the last occurrence of I<wc> "
2203 "in the wide-character string pointed to by I<wcs>, or NULL if I<wc> does not "
2204 "occur in the string."
2205 msgstr ""
2206
2207 #. type: Plain text
2208 #: build/C/man3/wcsrchr.3:52
2209 msgid "B<strrchr>(3), B<wcschr>(3)"
2210 msgstr ""
2211
2212 #. type: TH
2213 #: build/C/man3/wcsrtombs.3:16
2214 #, no-wrap
2215 msgid "WCSRTOMBS"
2216 msgstr ""
2217
2218 #. type: Plain text
2219 #: build/C/man3/wcsrtombs.3:19
2220 msgid "wcsrtombs - convert a wide-character string to a multibyte string"
2221 msgstr ""
2222
2223 #. type: Plain text
2224 #: build/C/man3/wcsrtombs.3:25
2225 #, no-wrap
2226 msgid ""
2227 "B<size_t wcsrtombs(char *>I<dest>B<, const wchar_t **>I<src>B<,>\n"
2228 "B<                 size_t >I<len>B<, mbstate_t *>I<ps>B<);>\n"
2229 msgstr ""
2230
2231 #. type: Plain text
2232 #: build/C/man3/wcsrtombs.3:55
2233 msgid ""
2234 "If I<dest> is not a NULL pointer, the B<wcsrtombs>()  function converts the "
2235 "wide-character string I<*src> to a multibyte string starting at I<dest>.  At "
2236 "most I<len> bytes are written to I<dest>.  The shift state I<*ps> is "
2237 "updated.  The conversion is effectively performed by repeatedly calling "
2238 "I<wcrtomb(dest, *src, ps)>, as long as this call succeeds, and then "
2239 "incrementing I<dest> by the number of bytes written and I<*src> by one.  The "
2240 "conversion can stop for three reasons:"
2241 msgstr ""
2242
2243 #. type: Plain text
2244 #: build/C/man3/wcsrtombs.3:67
2245 msgid ""
2246 "1. A wide character has been encountered that can not be represented as a "
2247 "multibyte sequence (according to the current locale).  In this case I<*src> "
2248 "is left pointing to the invalid wide character, I<(size_t)\\ -1> is "
2249 "returned, and I<errno> is set to B<EILSEQ>."
2250 msgstr ""
2251
2252 #. type: Plain text
2253 #: build/C/man3/wcsrtombs.3:76
2254 msgid ""
2255 "2. The length limit forces a stop.  In this case I<*src> is left pointing to "
2256 "the next wide character to be converted, and the number of bytes written to "
2257 "I<dest> is returned."
2258 msgstr ""
2259
2260 #. type: Plain text
2261 #: build/C/man3/wcsrtombs.3:89
2262 msgid ""
2263 "3. The wide-character string has been completely converted, including the "
2264 "terminating null wide character (L\\(aq\\e0\\(aq), which has the side effect "
2265 "of bringing back I<*ps> to the initial state.  In this case I<*src> is set "
2266 "to NULL, and the number of bytes written to I<dest>, excluding the "
2267 "terminating null byte (\\(aq\\e0\\(aq), is returned."
2268 msgstr ""
2269
2270 #. type: Plain text
2271 #: build/C/man3/wcsrtombs.3:98
2272 msgid ""
2273 "If I<dest> is NULL, I<len> is ignored, and the conversion proceeds as above, "
2274 "except that the converted bytes are not written out to memory, and that no "
2275 "length limit exists."
2276 msgstr ""
2277
2278 #. type: Plain text
2279 #: build/C/man3/wcsrtombs.3:106
2280 msgid ""
2281 "In both of the above cases, if I<ps> is a NULL pointer, a static anonymous "
2282 "state known only to the B<wcsrtombs>()  function is used instead."
2283 msgstr ""
2284
2285 #. type: Plain text
2286 #: build/C/man3/wcsrtombs.3:126
2287 msgid ""
2288 "The B<wcsrtombs>()  function returns the number of bytes that make up the "
2289 "converted part of multibyte sequence, not including the terminating null "
2290 "byte.  If a wide character was encountered which could not be converted, "
2291 "I<(size_t)\\ -1> is returned, and I<errno> set to B<EILSEQ>."
2292 msgstr ""
2293
2294 #. type: Plain text
2295 #: build/C/man3/wcsrtombs.3:135
2296 msgid ""
2297 "The behavior of B<wcsrtombs>()  depends on the B<LC_CTYPE> category of the "
2298 "current locale."
2299 msgstr ""
2300
2301 #. type: Plain text
2302 #: build/C/man3/wcsrtombs.3:143
2303 msgid "B<iconv>(3), B<wcsnrtombs>(3), B<wcstombs>(3)"
2304 msgstr ""
2305
2306 #. type: TH
2307 #: build/C/man3/wcsspn.3:16
2308 #, no-wrap
2309 msgid "WCSSPN"
2310 msgstr ""
2311
2312 #. type: Plain text
2313 #: build/C/man3/wcsspn.3:20
2314 msgid ""
2315 "wcsspn - advance in a wide-character string, skipping any of a set of wide "
2316 "characters"
2317 msgstr ""
2318
2319 #. type: Plain text
2320 #: build/C/man3/wcsspn.3:25
2321 #, no-wrap
2322 msgid "B<size_t wcsspn(const wchar_t *>I<wcs>B<, const wchar_t *>I<accept>B<);>\n"
2323 msgstr ""
2324
2325 #. type: Plain text
2326 #: build/C/man3/wcsspn.3:41
2327 msgid ""
2328 "The B<wcsspn>()  function is the wide-character equivalent of the "
2329 "B<strspn>(3)  function.  It determines the length of the longest initial "
2330 "segment of I<wcs> which consists entirely of wide-characters listed in "
2331 "I<accept>.  In other words, it searches for the first occurrence in the "
2332 "wide-character string I<wcs> of a wide-character not contained in the "
2333 "wide-character string I<accept>."
2334 msgstr ""
2335
2336 #. type: Plain text
2337 #: build/C/man3/wcsspn.3:60
2338 msgid ""
2339 "The B<wcsspn>()  function returns the number of wide characters in the "
2340 "longest initial segment of I<wcs> which consists entirely of wide-characters "
2341 "listed in I<accept>.  In other words, it returns the position of the first "
2342 "occurrence in the wide-character string I<wcs> of a wide-character not "
2343 "contained in the wide-character string I<accept>, or I<wcslen(wcs)> if there "
2344 "is none."
2345 msgstr ""
2346
2347 #. type: Plain text
2348 #: build/C/man3/wcsspn.3:65
2349 msgid "B<strspn>(3), B<wcscspn>(3)"
2350 msgstr ""
2351
2352 #. type: TH
2353 #: build/C/man3/wcsstr.3:16
2354 #, no-wrap
2355 msgid "WCSSTR"
2356 msgstr ""
2357
2358 #. type: Plain text
2359 #: build/C/man3/wcsstr.3:19
2360 msgid "wcsstr - locate a substring in a wide-character string"
2361 msgstr ""
2362
2363 #. type: Plain text
2364 #: build/C/man3/wcsstr.3:24
2365 #, no-wrap
2366 msgid ""
2367 "B<wchar_t *wcsstr(const wchar_t *>I<haystack>B<, const wchar_t "
2368 "*>I<needle>B<);>\n"
2369 msgstr ""
2370
2371 #. type: Plain text
2372 #: build/C/man3/wcsstr.3:36
2373 msgid ""
2374 "The B<wcsstr>()  function is the wide-character equivalent of the "
2375 "B<strstr>(3)  function.  It searches for the first occurrence of the "
2376 "wide-character string I<needle> (without its terminating null wide character "
2377 "(L\\(aq\\e0\\(aq))  as a substring in the wide-character string I<haystack>."
2378 msgstr ""
2379
2380 #. type: Plain text
2381 #: build/C/man3/wcsstr.3:48
2382 msgid ""
2383 "The B<wcsstr>()  function returns a pointer to the first occurrence of "
2384 "I<needle> in I<haystack>.  It returns NULL if I<needle> does not occur as a "
2385 "substring in I<haystack>."
2386 msgstr ""
2387
2388 #. type: Plain text
2389 #: build/C/man3/wcsstr.3:56
2390 msgid ""
2391 "Note the special case: If I<needle> is the empty wide-character string, the "
2392 "return value is always I<haystack> itself."
2393 msgstr ""
2394
2395 #. type: Plain text
2396 #: build/C/man3/wcsstr.3:61
2397 msgid "B<strstr>(3), B<wcschr>(3)"
2398 msgstr ""
2399
2400 #. type: TH
2401 #: build/C/man3/wcstoimax.3:24
2402 #, no-wrap
2403 msgid "WCSTOIMAX"
2404 msgstr ""
2405
2406 #. type: TH
2407 #: build/C/man3/wcstoimax.3:24
2408 #, no-wrap
2409 msgid "2003-11-01"
2410 msgstr ""
2411
2412 #. type: Plain text
2413 #: build/C/man3/wcstoimax.3:27
2414 msgid "wcstoimax, wcstoumax - convert wide-character string to integer"
2415 msgstr ""
2416
2417 #. type: Plain text
2418 #: build/C/man3/wcstoimax.3:30
2419 #, no-wrap
2420 msgid "B<#include E<lt>stddef.hE<gt>>\n"
2421 msgstr ""
2422
2423 #. type: Plain text
2424 #: build/C/man3/wcstoimax.3:32
2425 #, no-wrap
2426 msgid "B<#include E<lt>inttypes.hE<gt>>\n"
2427 msgstr ""
2428
2429 #. type: Plain text
2430 #: build/C/man3/wcstoimax.3:35
2431 #, no-wrap
2432 msgid ""
2433 "B<intmax_t wcstoimax(const wchar_t *>I<nptr>B<, wchar_t **>I<endptr>B<, int "
2434 ">I<base>B<);>\n"
2435 msgstr ""
2436
2437 #. type: Plain text
2438 #: build/C/man3/wcstoimax.3:38
2439 #, no-wrap
2440 msgid ""
2441 "B<uintmax_t wcstoumax(const wchar_t *>I<nptr>B<, wchar_t **>I<endptr>B<, int "
2442 ">I<base>B<);>\n"
2443 msgstr ""
2444
2445 #. type: Plain text
2446 #: build/C/man3/wcstoimax.3:49
2447 msgid ""
2448 "These functions are just like B<wcstol>(3)  and B<wcstoul>(3), except that "
2449 "they return a value of type I<intmax_t> and I<uintmax_t>, respectively."
2450 msgstr ""
2451
2452 #.  FIXME . the pages referred to by the following xrefs are not yet written
2453 #. type: Plain text
2454 #: build/C/man3/wcstoimax.3:59
2455 msgid ""
2456 "B<imaxabs>(3), B<imaxdiv>(3), B<strtoimax>(3), B<strtoumax>(3), "
2457 "B<wcstol>(3), B<wcstoul>(3)"
2458 msgstr ""
2459
2460 #. type: TH
2461 #: build/C/man3/wcstok.3:16
2462 #, no-wrap
2463 msgid "WCSTOK"
2464 msgstr ""
2465
2466 #. type: Plain text
2467 #: build/C/man3/wcstok.3:19
2468 msgid "wcstok - split wide-character string into tokens"
2469 msgstr ""
2470
2471 #. type: Plain text
2472 #: build/C/man3/wcstok.3:25
2473 #, no-wrap
2474 msgid ""
2475 "B<wchar_t *wcstok(wchar_t *>I<wcs>B<, const wchar_t *>I<delim>B<, wchar_t "
2476 "**>I<ptr>B<);>\n"
2477 msgstr ""
2478
2479 #. type: Plain text
2480 #: build/C/man3/wcstok.3:39
2481 msgid ""
2482 "The B<wcstok>()  function is the wide-character equivalent of the "
2483 "B<strtok>(3)  function, with an added argument to make it multithread-safe.  "
2484 "It can be used to split a wide-character string I<wcs> into tokens, where a "
2485 "token is defined as a substring not containing any wide-characters from "
2486 "I<delim>."
2487 msgstr ""
2488
2489 #. type: Plain text
2490 #: build/C/man3/wcstok.3:74
2491 msgid ""
2492 "The search starts at I<wcs>, if I<wcs> is not NULL, or at I<*ptr>, if I<wcs> "
2493 "is NULL.  First, any delimiter wide-characters are skipped, that is, the "
2494 "pointer is advanced beyond any wide-characters which occur in I<delim>.  If "
2495 "the end of the wide-character string is now reached, B<wcstok>()  returns "
2496 "NULL, to indicate that no tokens were found, and stores an appropriate value "
2497 "in I<*ptr>, so that subsequent calls to B<wcstok>()  will continue to return "
2498 "NULL.  Otherwise, the B<wcstok>()  function recognizes the beginning of a "
2499 "token and returns a pointer to it, but before doing that, it zero-terminates "
2500 "the token by replacing the next wide-character which occurs in I<delim> with "
2501 "a null wide character (L\\(aq\\e0\\(aq), and it updates I<*ptr> so that "
2502 "subsequent calls will continue searching after the end of recognized token."
2503 msgstr ""
2504
2505 #. type: Plain text
2506 #: build/C/man3/wcstok.3:79
2507 msgid ""
2508 "The B<wcstok>()  function returns a pointer to the next token, or NULL if no "
2509 "further token was found."
2510 msgstr ""
2511
2512 #. type: Plain text
2513 #: build/C/man3/wcstok.3:86
2514 msgid ""
2515 "The original I<wcs> wide-character string is destructively modified during "
2516 "the operation."
2517 msgstr ""
2518
2519 #. type: SH
2520 #: build/C/man3/wcstok.3:86
2521 #, no-wrap
2522 msgid "EXAMPLE"
2523 msgstr ""
2524
2525 #. type: Plain text
2526 #: build/C/man3/wcstok.3:88
2527 msgid ""
2528 "The following code loops over the tokens contained in a wide-character "
2529 "string."
2530 msgstr ""
2531
2532 #. type: Plain text
2533 #: build/C/man3/wcstok.3:98
2534 #, no-wrap
2535 msgid ""
2536 "wchar_t *wcs = ...;\n"
2537 "wchar_t *token;\n"
2538 "wchar_t *state;\n"
2539 "for (token = wcstok(wcs, \" \\et\\en\", &state);\n"
2540 "    token != NULL;\n"
2541 "    token = wcstok(NULL, \" \\et\\en\", &state)) {\n"
2542 "    ...\n"
2543 "}\n"
2544 msgstr ""
2545
2546 #. type: Plain text
2547 #: build/C/man3/wcstok.3:102
2548 msgid "B<strtok>(3), B<wcschr>(3)"
2549 msgstr ""
2550
2551 #. type: TH
2552 #: build/C/man3/wcswidth.3:15
2553 #, no-wrap
2554 msgid "WCSWIDTH"
2555 msgstr ""
2556
2557 #. type: TH
2558 #: build/C/man3/wcswidth.3:15
2559 #, no-wrap
2560 msgid "2010-09-10"
2561 msgstr ""
2562
2563 #. type: Plain text
2564 #: build/C/man3/wcswidth.3:18
2565 msgid "wcswidth - determine columns needed for a fixed-size wide-character string"
2566 msgstr ""
2567
2568 #. type: Plain text
2569 #: build/C/man3/wcswidth.3:22
2570 #, no-wrap
2571 msgid ""
2572 "B<#define _XOPEN_SOURCE>             /* See feature_test_macros(7) */\n"
2573 "B<#include E<lt>wchar.hE<gt>>\n"
2574 msgstr ""
2575
2576 #. type: Plain text
2577 #: build/C/man3/wcswidth.3:24
2578 #, no-wrap
2579 msgid "B<int wcswidth(const wchar_t *>I<s>B<, size_t >I<n>B<);>\n"
2580 msgstr ""
2581
2582 #. type: Plain text
2583 #: build/C/man3/wcswidth.3:38
2584 msgid ""
2585 "The B<wcswidth>()  function returns the number of columns needed to "
2586 "represent the wide-character string pointed to by I<s>, but at most I<n> "
2587 "wide characters.  If a nonprintable wide character occurs among these "
2588 "characters, -1 is returned."
2589 msgstr ""
2590
2591 #. type: Plain text
2592 #: build/C/man3/wcswidth.3:47
2593 msgid ""
2594 "The B<wcswidth>()  function returns the number of column positions for the "
2595 "wide-character string I<s>, truncated to at most length I<n>."
2596 msgstr ""
2597
2598 #. type: Plain text
2599 #: build/C/man3/wcswidth.3:49 build/C/man3/wcwidth.3:47
2600 msgid "POSIX.1-2001."
2601 msgstr ""
2602
2603 #. type: Plain text
2604 #: build/C/man3/wcswidth.3:56
2605 msgid ""
2606 "The behavior of B<wcswidth>()  depends on the B<LC_CTYPE> category of the "
2607 "current locale."
2608 msgstr ""
2609
2610 #. type: Plain text
2611 #: build/C/man3/wcswidth.3:59
2612 msgid "B<iswprint>(3), B<wcwidth>(3)"
2613 msgstr ""
2614
2615 #. type: TH
2616 #: build/C/man3/wctob.3:16
2617 #, no-wrap
2618 msgid "WCTOB"
2619 msgstr ""
2620
2621 #. type: Plain text
2622 #: build/C/man3/wctob.3:19
2623 msgid "wctob - try to represent a wide character as a single byte"
2624 msgstr ""
2625
2626 #. type: Plain text
2627 #: build/C/man3/wctob.3:24
2628 #, no-wrap
2629 msgid "B<int wctob(wint_t >I<c>B<);>\n"
2630 msgstr ""
2631
2632 #. type: Plain text
2633 #: build/C/man3/wctob.3:36
2634 msgid ""
2635 "The B<wctob>()  function tests whether the multibyte representation of the "
2636 "wide character I<c>, starting in the initial state, consists of a single "
2637 "byte.  If so, it is returned as an I<unsigned char>."
2638 msgstr ""
2639
2640 #. type: Plain text
2641 #: build/C/man3/wctob.3:42
2642 msgid ""
2643 "Never use this function.  It cannot help you in writing internationalized "
2644 "programs.  Internationalized programs must never distinguish single-byte and "
2645 "multibyte characters."
2646 msgstr ""
2647
2648 #. type: Plain text
2649 #: build/C/man3/wctob.3:50
2650 msgid ""
2651 "The B<wctob>()  function returns the single-byte representation of I<c>, if "
2652 "it exists, of B<EOF> otherwise."
2653 msgstr ""
2654
2655 #. type: Plain text
2656 #: build/C/man3/wctob.3:59
2657 msgid ""
2658 "The behavior of B<wctob>()  depends on the B<LC_CTYPE> category of the "
2659 "current locale."
2660 msgstr ""
2661
2662 #. type: Plain text
2663 #: build/C/man3/wctob.3:68
2664 msgid ""
2665 "This function should never be used.  Internationalized programs must never "
2666 "distinguish single-byte and multibyte characters.  Use either B<wctomb>(3)  "
2667 "or the thread-safe B<wcrtomb>(3)  instead."
2668 msgstr ""
2669
2670 #. type: Plain text
2671 #: build/C/man3/wctob.3:72
2672 msgid "B<btowc>(3), B<wcrtomb>(3), B<wctomb>(3)"
2673 msgstr ""
2674
2675 #. type: TH
2676 #: build/C/man3/wcwidth.3:15
2677 #, no-wrap
2678 msgid "WCWIDTH"
2679 msgstr ""
2680
2681 #. type: Plain text
2682 #: build/C/man3/wcwidth.3:18
2683 msgid "wcwidth - determine columns needed for a wide character"
2684 msgstr ""
2685
2686 #. type: Plain text
2687 #: build/C/man3/wcwidth.3:22
2688 #, no-wrap
2689 msgid ""
2690 "B<#define _XOPEN_SOURCE>       /* See feature_test_macros(7) */\n"
2691 "B<#include E<lt>wchar.hE<gt>>\n"
2692 msgstr ""
2693
2694 #. type: Plain text
2695 #: build/C/man3/wcwidth.3:24
2696 #, no-wrap
2697 msgid "B<int wcwidth(wchar_t >I<c>B<);>\n"
2698 msgstr ""
2699
2700 #. type: Plain text
2701 #: build/C/man3/wcwidth.3:39
2702 msgid ""
2703 "The B<wcwidth>()  function returns the number of columns needed to represent "
2704 "the wide character I<c>.  If I<c> is a printable wide character, the value "
2705 "is at least 0.  If I<c> is null wide character (L\\(aq\\e0\\(aq), the value "
2706 "is 0.  Otherwise -1 is returned."
2707 msgstr ""
2708
2709 #. type: Plain text
2710 #: build/C/man3/wcwidth.3:45
2711 msgid "The B<wcwidth>()  function returns the number of column positions for I<c>."
2712 msgstr ""
2713
2714 #. type: Plain text
2715 #: build/C/man3/wcwidth.3:49
2716 msgid "Note that glibc before 2.2.5 used the prototype"
2717 msgstr ""
2718
2719 #. type: Plain text
2720 #: build/C/man3/wcwidth.3:52
2721 #, no-wrap
2722 msgid "B<int wcwidth(wint_t >I<c>B<);>\n"
2723 msgstr ""
2724
2725 #. type: Plain text
2726 #: build/C/man3/wcwidth.3:60
2727 msgid ""
2728 "The behavior of B<wcwidth>()  depends on the B<LC_CTYPE> category of the "
2729 "current locale."
2730 msgstr ""
2731
2732 #. type: Plain text
2733 #: build/C/man3/wcwidth.3:63
2734 msgid "B<iswprint>(3), B<wcswidth>(3)"
2735 msgstr ""
2736
2737 #. type: TH
2738 #: build/C/man3/wmemchr.3:16
2739 #, no-wrap
2740 msgid "WMEMCHR"
2741 msgstr ""
2742
2743 #. type: Plain text
2744 #: build/C/man3/wmemchr.3:19
2745 msgid "wmemchr - search a wide character in a wide-character array"
2746 msgstr ""
2747
2748 #. type: Plain text
2749 #: build/C/man3/wmemchr.3:24
2750 #, no-wrap
2751 msgid ""
2752 "B<wchar_t *wmemchr(const wchar_t *>I<s>B<, wchar_t >I<c>B<, size_t "
2753 ">I<n>B<);>\n"
2754 msgstr ""
2755
2756 #. type: Plain text
2757 #: build/C/man3/wmemchr.3:38
2758 msgid ""
2759 "The B<wmemchr>()  function is the wide-character equivalent of the "
2760 "B<memchr>(3)  function.  It searches the I<n> wide characters starting at "
2761 "I<s> for the first occurrence of the wide character I<c>."
2762 msgstr ""
2763
2764 #. type: Plain text
2765 #: build/C/man3/wmemchr.3:51
2766 msgid ""
2767 "The B<wmemchr>()  function returns a pointer to the first occurrence of I<c> "
2768 "among the I<n> wide characters starting at I<s>, or NULL if I<c> does not "
2769 "occur among these."
2770 msgstr ""
2771
2772 #. type: Plain text
2773 #: build/C/man3/wmemchr.3:56
2774 msgid "B<memchr>(3), B<wcschr>(3)"
2775 msgstr ""
2776
2777 #. type: TH
2778 #: build/C/man3/wmemcmp.3:15
2779 #, no-wrap
2780 msgid "WMEMCMP"
2781 msgstr ""
2782
2783 #. type: Plain text
2784 #: build/C/man3/wmemcmp.3:18
2785 msgid "wmemcmp - compare two arrays of wide-characters"
2786 msgstr ""
2787
2788 #. type: Plain text
2789 #: build/C/man3/wmemcmp.3:23
2790 #, no-wrap
2791 msgid ""
2792 "B<int wmemcmp(const wchar_t *>I<s1>B<, const wchar_t *>I<s2>B<, size_t "
2793 ">I<n>B<);>\n"
2794 msgstr ""
2795
2796 #. type: Plain text
2797 #: build/C/man3/wmemcmp.3:38
2798 msgid ""
2799 "The B<wmemcmp>()  function is the wide-character equivalent of the "
2800 "B<memcmp>(3)  function.  It compares the I<n> wide-characters starting at "
2801 "I<s1> and the I<n> wide-characters starting at I<s2>."
2802 msgstr ""
2803
2804 #. type: Plain text
2805 #: build/C/man3/wmemcmp.3:70
2806 msgid ""
2807 "The B<wmemcmp>()  function returns zero if the wide-character arrays of size "
2808 "I<n> at I<s1> and I<s2> are equal.  It returns an integer greater than zero "
2809 "if at the first differing position I<i> (I<i> E<lt> I<n>), the corresponding "
2810 "wide-character I<s1[i]> is greater than I<s2[i]>.  It returns an integer "
2811 "less than zero if at the first differing position I<i> (I<i> E<lt> I<n>), "
2812 "the corresponding wide-character I<s1[i]> is less than I<s2[i]>."
2813 msgstr ""
2814
2815 #. type: Plain text
2816 #: build/C/man3/wmemcmp.3:75
2817 msgid "B<memcmp>(3), B<wcscmp>(3)"
2818 msgstr ""
2819
2820 #. type: TH
2821 #: build/C/man3/wmemcpy.3:16
2822 #, no-wrap
2823 msgid "WMEMCPY"
2824 msgstr ""
2825
2826 #. type: Plain text
2827 #: build/C/man3/wmemcpy.3:19
2828 msgid "wmemcpy - copy an array of wide-characters"
2829 msgstr ""
2830
2831 #. type: Plain text
2832 #: build/C/man3/wmemcpy.3:24
2833 #, no-wrap
2834 msgid ""
2835 "B<wchar_t *wmemcpy(wchar_t *>I<dest>B<, const wchar_t *>I<src>B<, size_t "
2836 ">I<n>B<);>\n"
2837 msgstr ""
2838
2839 #. type: Plain text
2840 #: build/C/man3/wmemcpy.3:37
2841 msgid ""
2842 "The B<wmemcpy>()  function is the wide-character equivalent of the "
2843 "B<memcpy>(3)  function.  It copies I<n> wide characters from the array "
2844 "starting at I<src> to the array starting at I<dest>."
2845 msgstr ""
2846
2847 #. type: Plain text
2848 #: build/C/man3/wmemcpy.3:42
2849 msgid ""
2850 "The arrays may not overlap; use B<wmemmove>(3)  to copy between overlapping "
2851 "arrays."
2852 msgstr ""
2853
2854 #. type: Plain text
2855 #: build/C/man3/wmemcpy.3:52
2856 msgid "B<wmemcpy>()  returns I<dest>."
2857 msgstr ""
2858
2859 #. type: Plain text
2860 #: build/C/man3/wmemcpy.3:59
2861 msgid "B<memcpy>(3), B<wcscpy>(3), B<wmemmove>(3), B<wmempcpy>(3)"
2862 msgstr ""
2863
2864 #. type: TH
2865 #: build/C/man3/wmemmove.3:16
2866 #, no-wrap
2867 msgid "WMEMMOVE"
2868 msgstr ""
2869
2870 #. type: Plain text
2871 #: build/C/man3/wmemmove.3:19
2872 msgid "wmemmove - copy an array of wide-characters"
2873 msgstr ""
2874
2875 #. type: Plain text
2876 #: build/C/man3/wmemmove.3:24
2877 #, no-wrap
2878 msgid ""
2879 "B<wchar_t *wmemmove(wchar_t *>I<dest>B<, const wchar_t *>I<src>B<, size_t "
2880 ">I<n>B<);>\n"
2881 msgstr ""
2882
2883 #. type: Plain text
2884 #: build/C/man3/wmemmove.3:40
2885 msgid ""
2886 "The B<wmemmove>()  function is the wide-character equivalent of the "
2887 "B<memmove>(3)  function.  It copies I<n> wide characters from the array "
2888 "starting at I<src> to the array starting at I<dest>.  The arrays may "
2889 "overlap."
2890 msgstr ""
2891
2892 #. type: Plain text
2893 #: build/C/man3/wmemmove.3:50
2894 msgid "B<wmemmove>()  returns I<dest>."
2895 msgstr ""
2896
2897 #. type: Plain text
2898 #: build/C/man3/wmemmove.3:55
2899 msgid "B<memmove>(3), B<wmemcpy>(3)"
2900 msgstr ""
2901
2902 #. type: TH
2903 #: build/C/man3/wmemset.3:16
2904 #, no-wrap
2905 msgid "WMEMSET"
2906 msgstr ""
2907
2908 #. type: Plain text
2909 #: build/C/man3/wmemset.3:19
2910 msgid "wmemset - fill an array of wide-characters with a constant wide character"
2911 msgstr ""
2912
2913 #. type: Plain text
2914 #: build/C/man3/wmemset.3:24
2915 #, no-wrap
2916 msgid "B<wchar_t *wmemset(wchar_t *>I<wcs>B<, wchar_t >I<wc>B<, size_t >I<n>B<);>\n"
2917 msgstr ""
2918
2919 #. type: Plain text
2920 #: build/C/man3/wmemset.3:39
2921 msgid ""
2922 "The B<wmemset>()  function is the wide-character equivalent of the "
2923 "B<memset>(3)  function.  It fills the array of I<n> wide-characters starting "
2924 "at I<wcs> with I<n> copies of the wide character I<wc>."
2925 msgstr ""
2926
2927 #. type: Plain text
2928 #: build/C/man3/wmemset.3:43
2929 msgid "B<wmemset>()  returns I<wcs>."
2930 msgstr ""
2931
2932 #. type: Plain text
2933 #: build/C/man3/wmemset.3:47
2934 msgid "B<memset>(3)"
2935 msgstr ""