OSDN Git Service

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