OSDN Git Service

e336702d303b5d86a957813e904ad0755b801ab4
[linuxjm/LDP_man-pages.git] / po4a / string / po / string.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-04-25 05:37+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=UTF-8\n"
17 "Content-Transfer-Encoding: 8bit\n"
18
19 #. type: TH
20 #: build/C/man3/bcmp.3:29
21 #, no-wrap
22 msgid "BCMP"
23 msgstr ""
24
25 #. type: TH
26 #: build/C/man3/bcmp.3:29 build/C/man3/bzero.3:29
27 #, no-wrap
28 msgid "2008-08-06"
29 msgstr ""
30
31 #. type: TH
32 #: build/C/man3/bcmp.3:29 build/C/man3/bcopy.3:31 build/C/man3/bzero.3:29
33 #, no-wrap
34 msgid "Linux"
35 msgstr ""
36
37 #. type: TH
38 #: build/C/man3/bcmp.3:29 build/C/man3/bcopy.3:31 build/C/man3/bstring.3:30 build/C/man3/bzero.3:29 build/C/man3/ffs.3:31 build/C/man3/index.3:29 build/C/man3/memccpy.3:28 build/C/man3/memchr.3:30 build/C/man3/memcmp.3:28 build/C/man3/memcpy.3:28 build/C/man3/memfrob.3:28 build/C/man3/memmem.3:28 build/C/man3/memmove.3:28 build/C/man3/mempcpy.3:6 build/C/man3/memset.3:28 build/C/man3/stpcpy.3:25 build/C/man3/stpncpy.3:12 build/C/man3/strcasecmp.3:28 build/C/man3/strcat.3:30 build/C/man3/strchr.3:31 build/C/man3/strcmp.3:30 build/C/man3/strcoll.3:28 build/C/man3/strcpy.3:33 build/C/man3/strdup.3:29 build/C/man3/strerror.3:37 build/C/man3/strfry.3:28 build/C/man3/string.3:28 build/C/man3/strlen.3:28 build/C/man3/strnlen.3:11 build/C/man3/strpbrk.3:28 build/C/man3/strsep.3:31 build/C/man3/strsignal.3:28 build/C/man3/strspn.3:28 build/C/man3/strstr.3:31 build/C/man3/strtok.3:28 build/C/man3/strverscmp.3:23 build/C/man3/strxfrm.3:28
39 #, no-wrap
40 msgid "Linux Programmer's Manual"
41 msgstr ""
42
43 #. type: SH
44 #: build/C/man3/bcmp.3:30 build/C/man3/bcopy.3:32 build/C/man3/bstring.3:31 build/C/man3/bzero.3:30 build/C/man3/ffs.3:32 build/C/man3/index.3:30 build/C/man3/memccpy.3:29 build/C/man3/memchr.3:31 build/C/man3/memcmp.3:29 build/C/man3/memcpy.3:29 build/C/man3/memfrob.3:29 build/C/man3/memmem.3:29 build/C/man3/memmove.3:29 build/C/man3/mempcpy.3:7 build/C/man3/memset.3:29 build/C/man3/stpcpy.3:26 build/C/man3/stpncpy.3:13 build/C/man3/strcasecmp.3:29 build/C/man3/strcat.3:31 build/C/man3/strchr.3:32 build/C/man3/strcmp.3:31 build/C/man3/strcoll.3:29 build/C/man3/strcpy.3:34 build/C/man3/strdup.3:30 build/C/man3/strerror.3:38 build/C/man3/strfry.3:29 build/C/man3/string.3:29 build/C/man3/strlen.3:29 build/C/man3/strnlen.3:12 build/C/man3/strpbrk.3:29 build/C/man3/strsep.3:32 build/C/man3/strsignal.3:29 build/C/man3/strspn.3:29 build/C/man3/strstr.3:32 build/C/man3/strtok.3:29 build/C/man3/strverscmp.3:24 build/C/man3/strxfrm.3:29
45 #, no-wrap
46 msgid "NAME"
47 msgstr ""
48
49 #. type: Plain text
50 #: build/C/man3/bcmp.3:32
51 msgid "bcmp - compare byte sequences"
52 msgstr ""
53
54 #. type: SH
55 #: build/C/man3/bcmp.3:32 build/C/man3/bcopy.3:34 build/C/man3/bstring.3:34 build/C/man3/bzero.3:32 build/C/man3/ffs.3:34 build/C/man3/index.3:32 build/C/man3/memccpy.3:31 build/C/man3/memchr.3:33 build/C/man3/memcmp.3:31 build/C/man3/memcpy.3:31 build/C/man3/memfrob.3:31 build/C/man3/memmem.3:31 build/C/man3/memmove.3:31 build/C/man3/mempcpy.3:9 build/C/man3/memset.3:31 build/C/man3/stpcpy.3:28 build/C/man3/stpncpy.3:15 build/C/man3/strcasecmp.3:31 build/C/man3/strcat.3:33 build/C/man3/strchr.3:34 build/C/man3/strcmp.3:33 build/C/man3/strcoll.3:31 build/C/man3/strcpy.3:36 build/C/man3/strdup.3:32 build/C/man3/strerror.3:40 build/C/man3/strfry.3:31 build/C/man3/string.3:34 build/C/man3/strlen.3:31 build/C/man3/strnlen.3:14 build/C/man3/strpbrk.3:31 build/C/man3/strsep.3:34 build/C/man3/strsignal.3:31 build/C/man3/strspn.3:31 build/C/man3/strstr.3:34 build/C/man3/strtok.3:31 build/C/man3/strverscmp.3:26 build/C/man3/strxfrm.3:31
56 #, no-wrap
57 msgid "SYNOPSIS"
58 msgstr ""
59
60 #. type: Plain text
61 #: build/C/man3/bcmp.3:35 build/C/man3/bcopy.3:37 build/C/man3/bzero.3:35 build/C/man3/ffs.3:37 build/C/man3/index.3:35 build/C/man3/strcasecmp.3:34 build/C/man3/string.3:37
62 #, no-wrap
63 msgid "B<#include E<lt>strings.hE<gt>>\n"
64 msgstr ""
65
66 #. type: Plain text
67 #: build/C/man3/bcmp.3:37
68 #, no-wrap
69 msgid "B<int bcmp(const void *>I<s1>B<, const void *>I<s2>B<, size_t >I<n>B<);>\n"
70 msgstr ""
71
72 #. type: SH
73 #: build/C/man3/bcmp.3:38 build/C/man3/bcopy.3:40 build/C/man3/bstring.3:61 build/C/man3/bzero.3:38 build/C/man3/ffs.3:72 build/C/man3/index.3:40 build/C/man3/memccpy.3:37 build/C/man3/memchr.3:52 build/C/man3/memcmp.3:37 build/C/man3/memcpy.3:37 build/C/man3/memfrob.3:38 build/C/man3/memmem.3:39 build/C/man3/memmove.3:37 build/C/man3/mempcpy.3:23 build/C/man3/memset.3:37 build/C/man3/stpcpy.3:53 build/C/man3/stpncpy.3:40 build/C/man3/strcasecmp.3:39 build/C/man3/strcat.3:41 build/C/man3/strchr.3:47 build/C/man3/strcmp.3:41 build/C/man3/strcoll.3:37 build/C/man3/strcpy.3:44 build/C/man3/strdup.3:75 build/C/man3/strerror.3:65 build/C/man3/strfry.3:39 build/C/man3/string.3:88 build/C/man3/strlen.3:37 build/C/man3/strnlen.3:39 build/C/man3/strpbrk.3:37 build/C/man3/strsep.3:48 build/C/man3/strsignal.3:58 build/C/man3/strspn.3:39 build/C/man3/strstr.3:46 build/C/man3/strtok.3:50 build/C/man3/strverscmp.3:34 build/C/man3/strxfrm.3:37
74 #, no-wrap
75 msgid "DESCRIPTION"
76 msgstr ""
77
78 #. type: Plain text
79 #: build/C/man3/bcmp.3:54
80 msgid ""
81 "The B<bcmp>()  function compares the two byte sequences I<s1> and I<s2> of "
82 "length I<n> each.  If they are equal, and in particular if I<n> is zero, "
83 "B<bcmp>()  returns 0.  Otherwise it returns a nonzero result."
84 msgstr ""
85
86 #. type: SH
87 #: build/C/man3/bcmp.3:54 build/C/man3/bcopy.3:50 build/C/man3/bzero.3:46 build/C/man3/ffs.3:85 build/C/man3/index.3:53 build/C/man3/memccpy.3:45 build/C/man3/memchr.3:97 build/C/man3/memcmp.3:46 build/C/man3/memcpy.3:46 build/C/man3/memfrob.3:51 build/C/man3/memmem.3:45 build/C/man3/memmove.3:51 build/C/man3/mempcpy.3:49 build/C/man3/memset.3:42 build/C/man3/stpcpy.3:61 build/C/man3/stpncpy.3:59 build/C/man3/strcasecmp.3:52 build/C/man3/strcat.3:91 build/C/man3/strchr.3:68 build/C/man3/strcmp.3:54 build/C/man3/strcoll.3:49 build/C/man3/strcpy.3:91 build/C/man3/strdup.3:102 build/C/man3/strerror.3:124 build/C/man3/strfry.3:47 build/C/man3/strlen.3:42 build/C/man3/strnlen.3:49 build/C/man3/strpbrk.3:42 build/C/man3/strsep.3:61 build/C/man3/strsignal.3:73 build/C/man3/strspn.3:51 build/C/man3/strstr.3:58 build/C/man3/strtok.3:104 build/C/man3/strverscmp.3:79 build/C/man3/strxfrm.3:54
88 #, no-wrap
89 msgid "RETURN VALUE"
90 msgstr ""
91
92 #. type: Plain text
93 #: build/C/man3/bcmp.3:59
94 msgid ""
95 "The B<bcmp>()  function returns 0 if the byte sequences are equal, otherwise "
96 "a nonzero result is returned."
97 msgstr ""
98
99 #. type: SH
100 #: build/C/man3/bcmp.3:59 build/C/man3/bcopy.3:52 build/C/man3/bzero.3:48 build/C/man3/ffs.3:89 build/C/man3/index.3:60 build/C/man3/memccpy.3:51 build/C/man3/memchr.3:116 build/C/man3/memcmp.3:53 build/C/man3/memcpy.3:50 build/C/man3/memfrob.3:56 build/C/man3/memmem.3:50 build/C/man3/memmove.3:55 build/C/man3/mempcpy.3:54 build/C/man3/memset.3:47 build/C/man3/stpcpy.3:66 build/C/man3/stpncpy.3:64 build/C/man3/strcasecmp.3:61 build/C/man3/strcat.3:97 build/C/man3/strchr.3:86 build/C/man3/strcmp.3:63 build/C/man3/strcoll.3:56 build/C/man3/strcpy.3:98 build/C/man3/strdup.3:111 build/C/man3/strerror.3:148 build/C/man3/strfry.3:52 build/C/man3/strlen.3:46 build/C/man3/strnlen.3:56 build/C/man3/strpbrk.3:48 build/C/man3/strsep.3:66 build/C/man3/strsignal.3:80 build/C/man3/strspn.3:63 build/C/man3/strstr.3:61 build/C/man3/strtok.3:111 build/C/man3/strverscmp.3:86 build/C/man3/strxfrm.3:62
101 #, no-wrap
102 msgid "CONFORMING TO"
103 msgstr ""
104
105 #. type: Plain text
106 #: build/C/man3/bcmp.3:66
107 msgid ""
108 "4.3BSD.  This function is deprecated (marked as LEGACY in POSIX.1-2001): use "
109 "B<memcmp>(3)  in new programs.  POSIX.1-2008 removes the specification of "
110 "B<bcmp>()."
111 msgstr ""
112
113 #. type: SH
114 #: build/C/man3/bcmp.3:66 build/C/man3/bcopy.3:66 build/C/man3/bstring.3:80 build/C/man3/bzero.3:55 build/C/man3/ffs.3:101 build/C/man3/index.3:71 build/C/man3/memccpy.3:53 build/C/man3/memchr.3:128 build/C/man3/memcmp.3:55 build/C/man3/memcpy.3:52 build/C/man3/memfrob.3:61 build/C/man3/memmem.3:63 build/C/man3/memmove.3:57 build/C/man3/mempcpy.3:67 build/C/man3/memset.3:49 build/C/man3/stpcpy.3:98 build/C/man3/stpncpy.3:66 build/C/man3/strcasecmp.3:63 build/C/man3/strcat.3:99 build/C/man3/strchr.3:93 build/C/man3/strcmp.3:65 build/C/man3/strcoll.3:63 build/C/man3/strcpy.3:135 build/C/man3/strdup.3:121 build/C/man3/strerror.3:176 build/C/man3/strfry.3:57 build/C/man3/string.3:92 build/C/man3/strlen.3:48 build/C/man3/strnlen.3:58 build/C/man3/strpbrk.3:50 build/C/man3/strsep.3:86 build/C/man3/strsignal.3:83 build/C/man3/strspn.3:65 build/C/man3/strstr.3:74 build/C/man3/strtok.3:201 build/C/man3/strverscmp.3:88 build/C/man3/strxfrm.3:70
115 #, no-wrap
116 msgid "SEE ALSO"
117 msgstr ""
118
119 #. type: Plain text
120 #: build/C/man3/bcmp.3:72
121 msgid ""
122 "B<memcmp>(3), B<strcasecmp>(3), B<strcmp>(3), B<strcoll>(3), "
123 "B<strncasecmp>(3), B<strncmp>(3)"
124 msgstr ""
125
126 #. type: TH
127 #: build/C/man3/bcopy.3:31
128 #, no-wrap
129 msgid "BCOPY"
130 msgstr ""
131
132 #. type: TH
133 #: build/C/man3/bcopy.3:31
134 #, no-wrap
135 msgid "2009-03-15"
136 msgstr ""
137
138 #. type: Plain text
139 #: build/C/man3/bcopy.3:34
140 msgid "bcopy - copy byte sequence"
141 msgstr ""
142
143 #. type: Plain text
144 #: build/C/man3/bcopy.3:39
145 #, no-wrap
146 msgid "B<void bcopy(const void *>I<src>B<, void *>I<dest>B<, size_t >I<n>B<);>\n"
147 msgstr ""
148
149 #. type: Plain text
150 #: build/C/man3/bcopy.3:50
151 msgid ""
152 "The B<bcopy>()  function copies I<n> bytes from I<src> to I<dest>.  The "
153 "result is correct, even when both areas overlap."
154 msgstr ""
155
156 #. type: Plain text
157 #: build/C/man3/bcopy.3:52 build/C/man3/bzero.3:48
158 msgid "None."
159 msgstr ""
160
161 #. type: Plain text
162 #: build/C/man3/bcopy.3:66
163 msgid ""
164 "4.3BSD.  This function is deprecated (marked as LEGACY in POSIX.1-2001): use "
165 "B<memcpy>(3)  or B<memmove>(3)  in new programs.  Note that the first two "
166 "arguments are interchanged for B<memcpy>(3)  and B<memmove>(3).  "
167 "POSIX.1-2008 removes the specification of B<bcopy>()."
168 msgstr ""
169
170 #. type: Plain text
171 #: build/C/man3/bcopy.3:71
172 msgid "B<memccpy>(3), B<memcpy>(3), B<memmove>(3), B<strcpy>(3), B<strncpy>(3)"
173 msgstr ""
174
175 #. type: TH
176 #: build/C/man3/bstring.3:30
177 #, no-wrap
178 msgid "BSTRING"
179 msgstr ""
180
181 #. type: TH
182 #: build/C/man3/bstring.3:30
183 #, no-wrap
184 msgid "2002-01-20"
185 msgstr ""
186
187 #. type: Plain text
188 #: build/C/man3/bstring.3:34
189 msgid ""
190 "bcmp, bcopy, bzero, memccpy, memchr, memcmp, memcpy, memfrob, memmem, "
191 "memmove, memset - byte string operations"
192 msgstr ""
193
194 #. type: Plain text
195 #: build/C/man3/bstring.3:37 build/C/man3/ffs.3:41 build/C/man3/memccpy.3:34 build/C/man3/memchr.3:36 build/C/man3/memcmp.3:34 build/C/man3/memcpy.3:34 build/C/man3/memmove.3:34 build/C/man3/mempcpy.3:14 build/C/man3/memset.3:34 build/C/man3/stpcpy.3:31 build/C/man3/stpncpy.3:18 build/C/man3/strcat.3:36 build/C/man3/strchr.3:37 build/C/man3/strcmp.3:36 build/C/man3/strcoll.3:34 build/C/man3/strcpy.3:39 build/C/man3/strdup.3:35 build/C/man3/strerror.3:43 build/C/man3/strfry.3:36 build/C/man3/string.3:47 build/C/man3/strlen.3:34 build/C/man3/strnlen.3:17 build/C/man3/strpbrk.3:34 build/C/man3/strsep.3:37 build/C/man3/strsignal.3:34 build/C/man3/strspn.3:34 build/C/man3/strstr.3:37 build/C/man3/strstr.3:43 build/C/man3/strtok.3:34 build/C/man3/strverscmp.3:31 build/C/man3/strxfrm.3:34
196 #, no-wrap
197 msgid "B<#include E<lt>string.hE<gt>>\n"
198 msgstr ""
199
200 #. type: Plain text
201 #: build/C/man3/bstring.3:39
202 #, no-wrap
203 msgid "B<int bcmp(const void *>I<s1>B<, const void *>I<s2>B<, int >I<n>B<);>\n"
204 msgstr ""
205
206 #. type: Plain text
207 #: build/C/man3/bstring.3:41
208 #, no-wrap
209 msgid "B<void bcopy(const void *>I<src>B<, void *>I<dest>B<, int >I<n>B<);>\n"
210 msgstr ""
211
212 #. type: Plain text
213 #: build/C/man3/bstring.3:43
214 #, no-wrap
215 msgid "B<void bzero(void *>I<s>B<, int >I<n>B<);>\n"
216 msgstr ""
217
218 #. type: Plain text
219 #: build/C/man3/bstring.3:45 build/C/man3/memccpy.3:36
220 #, no-wrap
221 msgid ""
222 "B<void *memccpy(void *>I<dest>B<, const void *>I<src>B<, int >I<c>B<, size_t "
223 ">I<n>B<);>\n"
224 msgstr ""
225
226 #. type: Plain text
227 #: build/C/man3/bstring.3:47 build/C/man3/memchr.3:38
228 #, no-wrap
229 msgid "B<void *memchr(const void *>I<s>B<, int >I<c>B<, size_t >I<n>B<);>\n"
230 msgstr ""
231
232 #. type: Plain text
233 #: build/C/man3/bstring.3:49 build/C/man3/memcmp.3:36
234 #, no-wrap
235 msgid "B<int memcmp(const void *>I<s1>B<, const void *>I<s2>B<, size_t >I<n>B<);>\n"
236 msgstr ""
237
238 #. type: Plain text
239 #: build/C/man3/bstring.3:51 build/C/man3/memcpy.3:36
240 #, no-wrap
241 msgid "B<void *memcpy(void *>I<dest>B<, const void *>I<src>B<, size_t >I<n>B<);>\n"
242 msgstr ""
243
244 #. type: Plain text
245 #: build/C/man3/bstring.3:53 build/C/man3/memfrob.3:37
246 #, no-wrap
247 msgid "B<void *memfrob(void *>I<s>B<, size_t >I<n>B<);>\n"
248 msgstr ""
249
250 #. type: Plain text
251 #: build/C/man3/bstring.3:56
252 #, no-wrap
253 msgid ""
254 "B<void *memmem(const void *>I<needle>B<, size_t >I<needlelen>B<,>\n"
255 "B<             const void *>I<haystack>B<, size_t >I<haystacklen>B<);>\n"
256 msgstr ""
257
258 #. type: Plain text
259 #: build/C/man3/bstring.3:58 build/C/man3/memmove.3:36
260 #, no-wrap
261 msgid "B<void *memmove(void *>I<dest>B<, const void *>I<src>B<, size_t >I<n>B<);>\n"
262 msgstr ""
263
264 #. type: Plain text
265 #: build/C/man3/bstring.3:60 build/C/man3/memset.3:36
266 #, no-wrap
267 msgid "B<void *memset(void *>I<s>B<, int >I<c>B<, size_t >I<n>B<);>\n"
268 msgstr ""
269
270 #. type: Plain text
271 #: build/C/man3/bstring.3:66
272 msgid ""
273 "The byte string functions perform operations on strings (byte arrays)  that "
274 "are not necessarily null-terminated.  See the individual man pages for "
275 "descriptions of each function."
276 msgstr ""
277
278 #. type: SH
279 #: build/C/man3/bstring.3:66 build/C/man3/ffs.3:98 build/C/man3/strcoll.3:58 build/C/man3/strcpy.3:100 build/C/man3/strsep.3:68 build/C/man3/strxfrm.3:64
280 #, no-wrap
281 msgid "NOTES"
282 msgstr ""
283
284 #.  The old functions are not even available on some non-GNU/Linux systems.
285 #. type: Plain text
286 #: build/C/man3/bstring.3:80
287 msgid ""
288 "The functions B<bcmp>(), B<bcopy>()  and B<bzero>()  are obsolete.  Use "
289 "B<memcmp>(), B<memcpy>()  and B<memset>()  instead."
290 msgstr ""
291
292 #. type: Plain text
293 #: build/C/man3/bstring.3:91
294 msgid ""
295 "B<bcmp>(3), B<bcopy>(3), B<bzero>(3), B<memccpy>(3), B<memchr>(3), "
296 "B<memcmp>(3), B<memcpy>(3), B<memfrob>(3), B<memmem>(3), B<memmove>(3), "
297 "B<memset>(3)"
298 msgstr ""
299
300 #. type: TH
301 #: build/C/man3/bzero.3:29
302 #, no-wrap
303 msgid "BZERO"
304 msgstr ""
305
306 #. type: Plain text
307 #: build/C/man3/bzero.3:32
308 msgid "bzero - write zero-valued bytes"
309 msgstr ""
310
311 #. type: Plain text
312 #: build/C/man3/bzero.3:37
313 #, no-wrap
314 msgid "B<void bzero(void *>I<s>B<, size_t >I<n>B<);>\n"
315 msgstr ""
316
317 #. type: Plain text
318 #: build/C/man3/bzero.3:46
319 msgid ""
320 "The B<bzero>()  function sets the first I<n> bytes of the area starting at "
321 "I<s> to zero (bytes containing \\(aq\\e0\\(aq)."
322 msgstr ""
323
324 #. type: Plain text
325 #: build/C/man3/bzero.3:55
326 msgid ""
327 "4.3BSD.  This function is deprecated (marked as LEGACY in POSIX.1-2001): use "
328 "B<memset>(3)  in new programs.  POSIX.1-2008 removes the specification of "
329 "B<bzero>()."
330 msgstr ""
331
332 #. type: Plain text
333 #: build/C/man3/bzero.3:57
334 msgid "B<memset>(3), B<swab>(3)"
335 msgstr ""
336
337 #. type: TH
338 #: build/C/man3/ffs.3:31
339 #, no-wrap
340 msgid "FFS"
341 msgstr ""
342
343 #. type: TH
344 #: build/C/man3/ffs.3:31 build/C/man3/strcasecmp.3:28 build/C/man3/strchr.3:31 build/C/man3/strcmp.3:30 build/C/man3/strcoll.3:28 build/C/man3/strcpy.3:33 build/C/man3/strfry.3:28 build/C/man3/strpbrk.3:28 build/C/man3/strspn.3:28
345 #, no-wrap
346 msgid "2010-09-20"
347 msgstr ""
348
349 #. type: TH
350 #: build/C/man3/ffs.3:31 build/C/man3/index.3:29 build/C/man3/memccpy.3:28 build/C/man3/memfrob.3:28 build/C/man3/memmem.3:28 build/C/man3/memmove.3:28 build/C/man3/mempcpy.3:6 build/C/man3/memset.3:28 build/C/man3/stpcpy.3:25 build/C/man3/stpncpy.3:12 build/C/man3/strcat.3:30 build/C/man3/strchr.3:31 build/C/man3/strcoll.3:28 build/C/man3/strcpy.3:33 build/C/man3/strdup.3:29 build/C/man3/strfry.3:28 build/C/man3/strlen.3:28 build/C/man3/strnlen.3:11 build/C/man3/strsep.3:31 build/C/man3/strsignal.3:28 build/C/man3/strstr.3:31 build/C/man3/strtok.3:28 build/C/man3/strverscmp.3:23 build/C/man3/strxfrm.3:28
351 #, no-wrap
352 msgid "GNU"
353 msgstr ""
354
355 #. type: Plain text
356 #: build/C/man3/ffs.3:34
357 msgid "ffs, ffsl, ffsll - find first bit set in a word"
358 msgstr ""
359
360 #. type: Plain text
361 #: build/C/man3/ffs.3:39
362 #, no-wrap
363 msgid "B<int ffs(int >I<i>B<);>\n"
364 msgstr ""
365
366 #. type: Plain text
367 #: build/C/man3/ffs.3:43
368 #, no-wrap
369 msgid "B<int ffsl(long int >I<i>B<);>\n"
370 msgstr ""
371
372 #. type: Plain text
373 #: build/C/man3/ffs.3:45
374 #, no-wrap
375 msgid "B<int ffsll(long long int >I<i>B<);>\n"
376 msgstr ""
377
378 #. type: Plain text
379 #: build/C/man3/ffs.3:50 build/C/man3/memchr.3:47 build/C/man3/stpcpy.3:38 build/C/man3/stpncpy.3:25 build/C/man3/strdup.3:48 build/C/man3/strerror.3:56 build/C/man3/strnlen.3:24 build/C/man3/strsep.3:44 build/C/man3/strsignal.3:43 build/C/man3/strtok.3:43
380 msgid "Feature Test Macro Requirements for glibc (see B<feature_test_macros>(7)):"
381 msgstr ""
382
383 #. type: Plain text
384 #: build/C/man3/ffs.3:55
385 msgid "B<ffs>():"
386 msgstr ""
387
388 #. type: TP
389 #: build/C/man3/ffs.3:56
390 #, no-wrap
391 msgid "Since glibc 2.12:"
392 msgstr ""
393
394 #. type: Plain text
395 #: build/C/man3/ffs.3:60
396 msgid ""
397 "_SVID_SOURCE || _BSD_SOURCE || _POSIX_C_SOURCE\\ E<gt>=\\ 200809L || "
398 "_XOPEN_SOURCE\\ E<gt>=\\ 700 ||"
399 msgstr ""
400
401 #. type: TP
402 #: build/C/man3/ffs.3:60
403 #, no-wrap
404 msgid "Before glibc 2.12:"
405 msgstr ""
406
407 #. type: Plain text
408 #: build/C/man3/ffs.3:63
409 msgid "none"
410 msgstr ""
411
412 #. type: Plain text
413 #: build/C/man3/ffs.3:67
414 msgid "B<ffsl>(), B<ffsll>():"
415 msgstr ""
416
417 #. type: Plain text
418 #: build/C/man3/ffs.3:69 build/C/man3/stpcpy.3:50 build/C/man3/stpncpy.3:37 build/C/man3/strdup.3:68 build/C/man3/strnlen.3:36 build/C/man3/strsignal.3:55
419 msgid "_GNU_SOURCE"
420 msgstr ""
421
422 #. type: Plain text
423 #: build/C/man3/ffs.3:85
424 msgid ""
425 "The B<ffs>()  function returns the position of the first (least significant) "
426 "bit set in the word I<i>.  The least significant bit is position 1 and the "
427 "most significant position is, for example, 32 or 64.  The functions "
428 "B<ffsll>()  and B<ffsl>()  do the same but take arguments of possibly "
429 "different size."
430 msgstr ""
431
432 #. type: Plain text
433 #: build/C/man3/ffs.3:89
434 msgid ""
435 "These functions return the position of the first bit set, or 0 if no bits "
436 "are set in I<i>."
437 msgstr ""
438
439 #. type: Plain text
440 #: build/C/man3/ffs.3:92
441 msgid "B<ffs>(): 4.3BSD, POSIX.1-2001."
442 msgstr ""
443
444 #. type: Plain text
445 #: build/C/man3/ffs.3:98
446 msgid "The B<ffsl>()  and B<ffsll>()  functions are glibc extensions."
447 msgstr ""
448
449 #. type: Plain text
450 #: build/C/man3/ffs.3:101
451 msgid "BSD systems have a prototype in I<E<lt>string.hE<gt>>."
452 msgstr ""
453
454 #. type: Plain text
455 #: build/C/man3/ffs.3:102
456 msgid "B<memchr>(3)"
457 msgstr ""
458
459 #. type: TH
460 #: build/C/man3/index.3:29
461 #, no-wrap
462 msgid "INDEX"
463 msgstr ""
464
465 #. type: TH
466 #: build/C/man3/index.3:29
467 #, no-wrap
468 msgid "2011-09-21"
469 msgstr ""
470
471 #. type: Plain text
472 #: build/C/man3/index.3:32
473 msgid "index, rindex - locate character in string"
474 msgstr ""
475
476 #. type: Plain text
477 #: build/C/man3/index.3:37 build/C/man3/string.3:43
478 #, no-wrap
479 msgid "B<char *index(const char *>I<s>B<, int >I<c>B<);>\n"
480 msgstr ""
481
482 #. type: Plain text
483 #: build/C/man3/index.3:39 build/C/man3/string.3:45
484 #, no-wrap
485 msgid "B<char *rindex(const char *>I<s>B<, int >I<c>B<);>\n"
486 msgstr ""
487
488 #. type: Plain text
489 #: build/C/man3/index.3:45
490 msgid ""
491 "The B<index>()  function returns a pointer to the first occurrence of the "
492 "character I<c> in the string I<s>."
493 msgstr ""
494
495 #. type: Plain text
496 #: build/C/man3/index.3:50
497 msgid ""
498 "The B<rindex>()  function returns a pointer to the last occurrence of the "
499 "character I<c> in the string I<s>."
500 msgstr ""
501
502 #. type: Plain text
503 #: build/C/man3/index.3:53
504 msgid ""
505 "The terminating null byte (\\(aq\\e0\\(aq) is considered to be a part of the "
506 "strings."
507 msgstr ""
508
509 #. type: Plain text
510 #: build/C/man3/index.3:60
511 msgid ""
512 "The B<index>()  and B<rindex>()  functions return a pointer to the matched "
513 "character or NULL if the character is not found."
514 msgstr ""
515
516 #. type: Plain text
517 #: build/C/man3/index.3:71
518 msgid ""
519 "4.3BSD; marked as LEGACY in POSIX.1-2001.  POSIX.1-2008 removes the "
520 "specifications of B<index>()  and B<rindex>(), recommending B<strchr>(3)  "
521 "and B<strrchr>(3)  instead."
522 msgstr ""
523
524 #. type: Plain text
525 #: build/C/man3/index.3:80
526 msgid ""
527 "B<memchr>(3), B<strchr>(3), B<string>(3), B<strpbrk>(3), B<strrchr>(3), "
528 "B<strsep>(3), B<strspn>(3), B<strstr>(3), B<strtok>(3)"
529 msgstr ""
530
531 #. type: TH
532 #: build/C/man3/memccpy.3:28
533 #, no-wrap
534 msgid "MEMCCPY"
535 msgstr ""
536
537 #. type: TH
538 #: build/C/man3/memccpy.3:28
539 #, no-wrap
540 msgid "2009-01-13"
541 msgstr ""
542
543 #. type: Plain text
544 #: build/C/man3/memccpy.3:31
545 msgid "memccpy - copy memory area"
546 msgstr ""
547
548 #. type: Plain text
549 #: build/C/man3/memccpy.3:43
550 msgid ""
551 "The B<memccpy>()  function copies no more than I<n> bytes from memory area "
552 "I<src> to memory area I<dest>, stopping when the character I<c> is found."
553 msgstr ""
554
555 #. type: Plain text
556 #: build/C/man3/memccpy.3:45
557 msgid "If the memory areas overlap, the results are undefined."
558 msgstr ""
559
560 #. type: Plain text
561 #: build/C/man3/memccpy.3:51
562 msgid ""
563 "The B<memccpy>()  function returns a pointer to the next character in "
564 "I<dest> after I<c>, or NULL if I<c> was not found in the first I<n> "
565 "characters of I<src>."
566 msgstr ""
567
568 #. type: Plain text
569 #: build/C/man3/memccpy.3:53
570 msgid "SVr4, 4.3BSD, POSIX.1-2001."
571 msgstr ""
572
573 #. type: Plain text
574 #: build/C/man3/memccpy.3:58
575 msgid "B<bcopy>(3), B<memcpy>(3), B<memmove>(3), B<strcpy>(3), B<strncpy>(3)"
576 msgstr ""
577
578 #. type: TH
579 #: build/C/man3/memchr.3:30
580 #, no-wrap
581 msgid "MEMCHR"
582 msgstr ""
583
584 #. type: TH
585 #: build/C/man3/memchr.3:30
586 #, no-wrap
587 msgid "2012-04-16"
588 msgstr ""
589
590 #. type: Plain text
591 #: build/C/man3/memchr.3:33
592 msgid "memchr, memrchr, rawmemchr - scan memory for a character"
593 msgstr ""
594
595 #. type: Plain text
596 #: build/C/man3/memchr.3:40
597 #, no-wrap
598 msgid "B<void *memrchr(const void *>I<s>B<, int >I<c>B<, size_t >I<n>B<);>\n"
599 msgstr ""
600
601 #. type: Plain text
602 #: build/C/man3/memchr.3:42
603 #, no-wrap
604 msgid "B<void *rawmemchr(const void *>I<s>B<, int >I<c>B<);>\n"
605 msgstr ""
606
607 #. type: Plain text
608 #: build/C/man3/memchr.3:52
609 msgid "B<memrchr>(), B<rawmemchr>(): _GNU_SOURCE"
610 msgstr ""
611
612 #. type: Plain text
613 #: build/C/man3/memchr.3:59
614 msgid ""
615 "The B<memchr>()  function scans the first I<n> bytes of the memory area "
616 "pointed to by I<s> for the character I<c>.  The first byte to match I<c> "
617 "(interpreted as an unsigned character) stops the operation."
618 msgstr ""
619
620 #. type: Plain text
621 #: build/C/man3/memchr.3:67
622 msgid ""
623 "The B<memrchr>()  function is like the B<memchr>()  function, except that it "
624 "searches backward from the end of the I<n> bytes pointed to by I<s> instead "
625 "of forward from the beginning."
626 msgstr ""
627
628 #. type: Plain text
629 #: build/C/man3/memchr.3:91
630 msgid ""
631 "The B<rawmemchr>()  function is similar to B<memchr>(): it assumes (i.e., "
632 "the programmer knows for certain)  that the character I<c> lies somewhere in "
633 "the string I<s>, and so performs an optimized search for the character I<c> "
634 "(i.e., no use of a count argument argument to limit the range of the "
635 "search).  If the character I<c> is not in the string I<s>, then "
636 "B<rawmemchr>()  may proceed to search beyond the end of the string, and the "
637 "result is unspecified.  The following call is a fast means of locating a "
638 "string's terminating null byte:"
639 msgstr ""
640
641 #. type: Plain text
642 #: build/C/man3/memchr.3:95
643 #, no-wrap
644 msgid "char *p = rawmemchr(s,\\ \\(aq\\e0\\(aq);\n"
645 msgstr ""
646
647 #. type: Plain text
648 #: build/C/man3/memchr.3:105
649 msgid ""
650 "The B<memchr>()  and B<memrchr>()  functions return a pointer to the "
651 "matching byte or NULL if the character does not occur in the given memory "
652 "area."
653 msgstr ""
654
655 #. type: Plain text
656 #: build/C/man3/memchr.3:110
657 msgid ""
658 "The B<rawmemchr>()  function returns a pointer to the matching byte, if one "
659 "is found.  If no matching byte is found, the result is unspecified."
660 msgstr ""
661
662 #. type: SH
663 #: build/C/man3/memchr.3:110 build/C/man3/mempcpy.3:51 build/C/man3/strchr.3:83
664 #, no-wrap
665 msgid "VERSIONS"
666 msgstr ""
667
668 #. type: Plain text
669 #: build/C/man3/memchr.3:113
670 msgid "B<rawmemchr>()  first appeared in glibc in version 2.1."
671 msgstr ""
672
673 #. type: Plain text
674 #: build/C/man3/memchr.3:116
675 msgid "B<memrchr>()  first appeared in glibc in version 2.2."
676 msgstr ""
677
678 #. type: Plain text
679 #: build/C/man3/memchr.3:120
680 msgid "The B<memchr>()  function conforms to SVr4, 4.3BSD, C89, C99, POSIX.1-2001."
681 msgstr ""
682
683 #. type: Plain text
684 #: build/C/man3/memchr.3:124
685 msgid "The B<memrchr>()  function is a GNU extension, available since glibc 2.1.91."
686 msgstr ""
687
688 #. type: Plain text
689 #: build/C/man3/memchr.3:128
690 msgid "The B<rawmemchr>()  function is a GNU extension, available since glibc 2.1."
691 msgstr ""
692
693 #. type: Plain text
694 #: build/C/man3/memchr.3:138
695 msgid ""
696 "B<ffs>(3), B<index>(3), B<rindex>(3), B<strchr>(3), B<strpbrk>(3), "
697 "B<strrchr>(3), B<strsep>(3), B<strspn>(3), B<strstr>(3), B<wmemchr>(3)"
698 msgstr ""
699
700 #. type: TH
701 #: build/C/man3/memcmp.3:28
702 #, no-wrap
703 msgid "MEMCMP"
704 msgstr ""
705
706 #. type: TH
707 #: build/C/man3/memcmp.3:28
708 #, no-wrap
709 msgid "2011-09-14"
710 msgstr ""
711
712 #. type: Plain text
713 #: build/C/man3/memcmp.3:31
714 msgid "memcmp - compare memory areas"
715 msgstr ""
716
717 #. type: Plain text
718 #: build/C/man3/memcmp.3:46
719 msgid ""
720 "The B<memcmp>()  function compares the first I<n> bytes (each interpreted as "
721 "I<unsigned char>)  of the memory areas I<s1> and I<s2>.  It returns an "
722 "integer less than, equal to, or greater than zero if I<s1> is found, "
723 "respectively, to be less than, to match, or be greater than I<s2>."
724 msgstr ""
725
726 #. type: Plain text
727 #: build/C/man3/memcmp.3:53
728 msgid ""
729 "The B<memcmp>()  function returns an integer less than, equal to, or greater "
730 "than zero if the first I<n> bytes of I<s1> is found, respectively, to be "
731 "less than, to match, or be greater than the first I<n> bytes of I<s2>."
732 msgstr ""
733
734 #. type: Plain text
735 #: build/C/man3/memcmp.3:55 build/C/man3/memcpy.3:52 build/C/man3/memmove.3:57 build/C/man3/memset.3:49
736 msgid "SVr4, 4.3BSD, C89, C99, POSIX.1-2001."
737 msgstr ""
738
739 #. type: Plain text
740 #: build/C/man3/memcmp.3:62
741 msgid ""
742 "B<bcmp>(3), B<strcasecmp>(3), B<strcmp>(3), B<strcoll>(3), "
743 "B<strncasecmp>(3), B<strncmp>(3), B<wmemcmp>(3)"
744 msgstr ""
745
746 #. type: TH
747 #: build/C/man3/memcpy.3:28
748 #, no-wrap
749 msgid "MEMCPY"
750 msgstr ""
751
752 #. type: TH
753 #: build/C/man3/memcpy.3:28
754 #, no-wrap
755 msgid "2010-11-15"
756 msgstr ""
757
758 #. type: Plain text
759 #: build/C/man3/memcpy.3:31
760 msgid "memcpy - copy memory area"
761 msgstr ""
762
763 #. type: Plain text
764 #: build/C/man3/memcpy.3:46
765 msgid ""
766 "The B<memcpy>()  function copies I<n> bytes from memory area I<src> to "
767 "memory area I<dest>.  The memory areas must not overlap.  Use B<memmove>(3)  "
768 "if the memory areas do overlap."
769 msgstr ""
770
771 #. type: Plain text
772 #: build/C/man3/memcpy.3:50
773 msgid "The B<memcpy>()  function returns a pointer to I<dest>."
774 msgstr ""
775
776 #. type: Plain text
777 #: build/C/man3/memcpy.3:59
778 msgid ""
779 "B<bcopy>(3), B<memccpy>(3), B<memmove>(3), B<mempcpy>(3), B<strcpy>(3), "
780 "B<strncpy>(3), B<wmemcpy>(3)"
781 msgstr ""
782
783 #. type: TH
784 #: build/C/man3/memfrob.3:28
785 #, no-wrap
786 msgid "MEMFROB"
787 msgstr ""
788
789 #. type: TH
790 #: build/C/man3/memfrob.3:28
791 #, no-wrap
792 msgid "2010-09-10"
793 msgstr ""
794
795 #. type: Plain text
796 #: build/C/man3/memfrob.3:31
797 msgid "memfrob - frobnicate (encrypt) a memory area"
798 msgstr ""
799
800 #. type: Plain text
801 #: build/C/man3/memfrob.3:35
802 #, no-wrap
803 msgid ""
804 "B<#define _GNU_SOURCE>             /* See feature_test_macros(7) */\n"
805 "B<#include E<lt>string.hE<gt>>\n"
806 msgstr ""
807
808 #. type: Plain text
809 #: build/C/man3/memfrob.3:48
810 msgid ""
811 "The B<memfrob>()  function encrypts the first I<n> bytes of the memory area "
812 "I<s> by exclusive-ORing each character with the number 42.  The effect can "
813 "be reversed by using B<memfrob>()  on the encrypted memory area."
814 msgstr ""
815
816 #. type: Plain text
817 #: build/C/man3/memfrob.3:51
818 msgid ""
819 "Note that this function is not a proper encryption routine as the XOR "
820 "constant is fixed, and is only suitable for hiding strings."
821 msgstr ""
822
823 #. type: Plain text
824 #: build/C/man3/memfrob.3:56
825 msgid "The B<memfrob>()  function returns a pointer to the encrypted memory area."
826 msgstr ""
827
828 #. type: Plain text
829 #: build/C/man3/memfrob.3:61
830 msgid "The B<memfrob>()  function is unique to the GNU C Library."
831 msgstr ""
832
833 #. type: Plain text
834 #: build/C/man3/memfrob.3:62
835 msgid "B<strfry>(3)"
836 msgstr ""
837
838 #. type: TH
839 #: build/C/man3/memmem.3:28
840 #, no-wrap
841 msgid "MEMMEM"
842 msgstr ""
843
844 #. type: TH
845 #: build/C/man3/memmem.3:28
846 #, no-wrap
847 msgid "2008-12-05"
848 msgstr ""
849
850 #. type: Plain text
851 #: build/C/man3/memmem.3:31
852 msgid "memmem - locate a substring"
853 msgstr ""
854
855 #. type: Plain text
856 #: build/C/man3/memmem.3:35 build/C/man3/strchr.3:44
857 #, no-wrap
858 msgid ""
859 "B<#define _GNU_SOURCE>         /* See feature_test_macros(7) */\n"
860 "B<#include E<lt>string.hE<gt>>\n"
861 msgstr ""
862
863 #. type: Plain text
864 #: build/C/man3/memmem.3:38
865 #, no-wrap
866 msgid ""
867 "B<void *memmem(const void *>I<haystack>B<, size_t >I<haystacklen>B<,>\n"
868 "B<             const void *>I<needle>B<, size_t >I<needlelen>B<);>\n"
869 msgstr ""
870
871 #. type: Plain text
872 #: build/C/man3/memmem.3:45
873 msgid ""
874 "The B<memmem>()  function finds the start of the first occurrence of the "
875 "substring I<needle> of length I<needlelen> in the memory area I<haystack> of "
876 "length I<haystacklen>."
877 msgstr ""
878
879 #. type: Plain text
880 #: build/C/man3/memmem.3:50
881 msgid ""
882 "The B<memmem>()  function returns a pointer to the beginning of the "
883 "substring, or NULL if the substring is not found."
884 msgstr ""
885
886 #. type: Plain text
887 #: build/C/man3/memmem.3:52 build/C/man3/mempcpy.3:56 build/C/man3/strverscmp.3:88
888 msgid "This function is a GNU extension."
889 msgstr ""
890
891 #. type: SH
892 #: build/C/man3/memmem.3:52 build/C/man3/stpcpy.3:71 build/C/man3/strcpy.3:124 build/C/man3/strsep.3:77 build/C/man3/strstr.3:68 build/C/man3/strtok.3:118
893 #, no-wrap
894 msgid "BUGS"
895 msgstr ""
896
897 #. type: Plain text
898 #: build/C/man3/memmem.3:57
899 msgid ""
900 "This function was broken in Linux libraries up to and including libc 5.0.9; "
901 "there the I<needle> and I<haystack> arguments were interchanged, and a "
902 "pointer to the end of the first occurrence of I<needle> was returned."
903 msgstr ""
904
905 #. type: Plain text
906 #: build/C/man3/memmem.3:63
907 msgid ""
908 "Both old and new libc's have the bug that if I<needle> is empty, "
909 "I<haystack-1> (instead of I<haystack>) is returned.  And glibc 2.0 makes it "
910 "worse, returning a pointer to the last byte of I<haystack>.  This is fixed "
911 "in glibc 2.1."
912 msgstr ""
913
914 #. type: Plain text
915 #: build/C/man3/memmem.3:64
916 msgid "B<strstr>(3)"
917 msgstr ""
918
919 #. type: TH
920 #: build/C/man3/memmove.3:28
921 #, no-wrap
922 msgid "MEMMOVE"
923 msgstr ""
924
925 #. type: TH
926 #: build/C/man3/memmove.3:28
927 #, no-wrap
928 msgid "1993-04-10"
929 msgstr ""
930
931 #. type: Plain text
932 #: build/C/man3/memmove.3:31
933 msgid "memmove - copy memory area"
934 msgstr ""
935
936 #. type: Plain text
937 #: build/C/man3/memmove.3:51
938 msgid ""
939 "The B<memmove>()  function copies I<n> bytes from memory area I<src> to "
940 "memory area I<dest>.  The memory areas may overlap: copying takes place as "
941 "though the bytes in I<src> are first copied into a temporary array that does "
942 "not overlap I<src> or I<dest>, and the bytes are then copied from the "
943 "temporary array to I<dest>."
944 msgstr ""
945
946 #. type: Plain text
947 #: build/C/man3/memmove.3:55
948 msgid "The B<memmove>()  function returns a pointer to I<dest>."
949 msgstr ""
950
951 #. type: Plain text
952 #: build/C/man3/memmove.3:63
953 msgid ""
954 "B<bcopy>(3), B<memccpy>(3), B<memcpy>(3), B<strcpy>(3), B<strncpy>(3), "
955 "B<wmemmove>(3)"
956 msgstr ""
957
958 #. type: TH
959 #: build/C/man3/mempcpy.3:6
960 #, no-wrap
961 msgid "MEMPCPY"
962 msgstr ""
963
964 #. type: TH
965 #: build/C/man3/mempcpy.3:6
966 #, no-wrap
967 msgid "2008-08-12"
968 msgstr ""
969
970 #. type: Plain text
971 #: build/C/man3/mempcpy.3:9
972 msgid "mempcpy, wmempcpy - copy memory area"
973 msgstr ""
974
975 #. type: Plain text
976 #: build/C/man3/mempcpy.3:12 build/C/man3/mempcpy.3:18 build/C/man3/strfry.3:34 build/C/man3/strstr.3:41 build/C/man3/strverscmp.3:29
977 #, no-wrap
978 msgid "B<#define _GNU_SOURCE>         /* See feature_test_macros(7) */\n"
979 msgstr ""
980
981 #. type: Plain text
982 #: build/C/man3/mempcpy.3:16
983 #, no-wrap
984 msgid "B<void *mempcpy(void *>I<dest>B<, const void *>I<src>B<, size_t >I<n>B<);>\n"
985 msgstr ""
986
987 #. type: Plain text
988 #: build/C/man3/mempcpy.3:20
989 #, no-wrap
990 msgid "B<#include E<lt>wchar.hE<gt>>\n"
991 msgstr ""
992
993 #. type: Plain text
994 #: build/C/man3/mempcpy.3:22
995 #, no-wrap
996 msgid ""
997 "B<wchar_t *wmempcpy(wchar_t *>I<dest>B<, const wchar_t *>I<src>B<, size_t "
998 ">I<n>B<);>\n"
999 msgstr ""
1000
1001 #. type: Plain text
1002 #: build/C/man3/mempcpy.3:38
1003 msgid ""
1004 "The B<mempcpy>()  function is nearly identical to the B<memcpy>(3)  "
1005 "function.  It copies I<n> bytes from the object beginning at I<src> into the "
1006 "object pointed to by I<dest>.  But instead of returning the value of I<dest> "
1007 "it returns a pointer to the byte following the last written byte."
1008 msgstr ""
1009
1010 #. type: Plain text
1011 #: build/C/man3/mempcpy.3:41
1012 msgid ""
1013 "This function is useful in situations where a number of objects shall be "
1014 "copied to consecutive memory positions."
1015 msgstr ""
1016
1017 #. type: Plain text
1018 #: build/C/man3/mempcpy.3:49
1019 msgid ""
1020 "The B<wmempcpy>()  function is identical but takes I<wchar_t> type arguments "
1021 "and copies I<n> wide characters."
1022 msgstr ""
1023
1024 #. type: Plain text
1025 #: build/C/man3/mempcpy.3:51
1026 msgid "I<dest> + I<n>."
1027 msgstr ""
1028
1029 #. type: Plain text
1030 #: build/C/man3/mempcpy.3:54
1031 msgid "B<mempcpy>()  first appeared in glibc in version 2.1."
1032 msgstr ""
1033
1034 #. type: SH
1035 #: build/C/man3/mempcpy.3:56 build/C/man3/stpcpy.3:74 build/C/man3/strtok.3:134
1036 #, no-wrap
1037 msgid "EXAMPLE"
1038 msgstr ""
1039
1040 #. type: Plain text
1041 #: build/C/man3/mempcpy.3:66
1042 #, no-wrap
1043 msgid ""
1044 "void *\n"
1045 "combine(void *o1, size_t s1, void *o2, size_t s2)\n"
1046 "{\n"
1047 "    void *result = malloc(s1 + s2);\n"
1048 "    if (result != NULL)\n"
1049 "        mempcpy(mempcpy(result, o1, s1), o2, s2);\n"
1050 "    return result;\n"
1051 "}\n"
1052 msgstr ""
1053
1054 #. type: Plain text
1055 #: build/C/man3/mempcpy.3:71
1056 msgid "B<memccpy>(3), B<memcpy>(3), B<memmove>(3), B<wmemcpy>(3)"
1057 msgstr ""
1058
1059 #. type: TH
1060 #: build/C/man3/memset.3:28
1061 #, no-wrap
1062 msgid "MEMSET"
1063 msgstr ""
1064
1065 #. type: TH
1066 #: build/C/man3/memset.3:28
1067 #, no-wrap
1068 msgid "1993-04-11"
1069 msgstr ""
1070
1071 #. type: Plain text
1072 #: build/C/man3/memset.3:31
1073 msgid "memset - fill memory with a constant byte"
1074 msgstr ""
1075
1076 #. type: Plain text
1077 #: build/C/man3/memset.3:42
1078 msgid ""
1079 "The B<memset>()  function fills the first I<n> bytes of the memory area "
1080 "pointed to by I<s> with the constant byte I<c>."
1081 msgstr ""
1082
1083 #. type: Plain text
1084 #: build/C/man3/memset.3:47
1085 msgid "The B<memset>()  function returns a pointer to the memory area I<s>."
1086 msgstr ""
1087
1088 #. type: Plain text
1089 #: build/C/man3/memset.3:52
1090 msgid "B<bzero>(3), B<swab>(3), B<wmemset>(3)"
1091 msgstr ""
1092
1093 #. type: TH
1094 #: build/C/man3/stpcpy.3:25
1095 #, no-wrap
1096 msgid "STPCPY"
1097 msgstr ""
1098
1099 #. type: TH
1100 #: build/C/man3/stpcpy.3:25
1101 #, no-wrap
1102 msgid "2012-03-15"
1103 msgstr ""
1104
1105 #. type: Plain text
1106 #: build/C/man3/stpcpy.3:28
1107 msgid "stpcpy - copy a string returning a pointer to its end"
1108 msgstr ""
1109
1110 #. type: Plain text
1111 #: build/C/man3/stpcpy.3:33 build/C/man3/string.3:49
1112 #, no-wrap
1113 msgid "B<char *stpcpy(char *>I<dest>B<, const char *>I<src>B<);>\n"
1114 msgstr ""
1115
1116 #. type: Plain text
1117 #: build/C/man3/stpcpy.3:41
1118 msgid "B<stpcpy>():"
1119 msgstr ""
1120
1121 #. type: TP
1122 #: build/C/man3/stpcpy.3:44 build/C/man3/stpncpy.3:31 build/C/man3/strdup.3:62 build/C/man3/strnlen.3:30 build/C/man3/strsignal.3:49
1123 #, no-wrap
1124 msgid "Since glibc 2.10:"
1125 msgstr ""
1126
1127 #. type: Plain text
1128 #: build/C/man3/stpcpy.3:47 build/C/man3/stpncpy.3:34 build/C/man3/strnlen.3:33 build/C/man3/strsignal.3:52
1129 msgid "_XOPEN_SOURCE\\ E<gt>=\\ 700 || _POSIX_C_SOURCE\\ E<gt>=\\ 200809L"
1130 msgstr ""
1131
1132 #. type: TP
1133 #: build/C/man3/stpcpy.3:47 build/C/man3/stpncpy.3:34 build/C/man3/strdup.3:65 build/C/man3/strnlen.3:33 build/C/man3/strsignal.3:52
1134 #, no-wrap
1135 msgid "Before glibc 2.10:"
1136 msgstr ""
1137
1138 #. type: Plain text
1139 #: build/C/man3/stpcpy.3:61
1140 msgid ""
1141 "The B<stpcpy>()  function copies the string pointed to by I<src> (including "
1142 "the terminating null byte (\\(aq\\e0\\(aq)) to the array pointed to by "
1143 "I<dest>.  The strings may not overlap, and the destination string I<dest> "
1144 "must be large enough to receive the copy."
1145 msgstr ""
1146
1147 #. type: Plain text
1148 #: build/C/man3/stpcpy.3:66
1149 msgid ""
1150 "B<stpcpy>()  returns a pointer to the B<end> of the string I<dest> (that is, "
1151 "the address of the terminating null byte)  rather than the beginning."
1152 msgstr ""
1153
1154 #. type: Plain text
1155 #: build/C/man3/stpcpy.3:71
1156 msgid ""
1157 "This function was added to POSIX.1-2008. Before that, it was not part of the "
1158 "C or POSIX.1 standards, nor customary on UNIX systems, but was not a GNU "
1159 "invention either. Perhaps it came from MS-DOS. It is also present on the "
1160 "BSDs."
1161 msgstr ""
1162
1163 #. type: Plain text
1164 #: build/C/man3/stpcpy.3:74
1165 msgid "This function may overrun the buffer I<dest>."
1166 msgstr ""
1167
1168 #. type: Plain text
1169 #: build/C/man3/stpcpy.3:79
1170 msgid ""
1171 "For example, this program uses B<stpcpy>()  to concatenate B<foo> and B<bar> "
1172 "to produce B<foobar>, which it then prints."
1173 msgstr ""
1174
1175 #. type: Plain text
1176 #: build/C/man3/stpcpy.3:85
1177 #, no-wrap
1178 msgid ""
1179 "#define _GNU_SOURCE\n"
1180 "#include E<lt>string.hE<gt>\n"
1181 "#include E<lt>stdio.hE<gt>\n"
1182 msgstr ""
1183
1184 #. type: Plain text
1185 #: build/C/man3/stpcpy.3:91
1186 #, no-wrap
1187 msgid ""
1188 "int\n"
1189 "main(void)\n"
1190 "{\n"
1191 "    char buffer[20];\n"
1192 "    char *to = buffer;\n"
1193 msgstr ""
1194
1195 #. type: Plain text
1196 #: build/C/man3/stpcpy.3:96
1197 #, no-wrap
1198 msgid ""
1199 "    to = stpcpy(to, \"foo\");\n"
1200 "    to = stpcpy(to, \"bar\");\n"
1201 "    printf(\"%s\\en\", buffer);\n"
1202 "}\n"
1203 msgstr ""
1204
1205 #. type: Plain text
1206 #: build/C/man3/stpcpy.3:106
1207 msgid ""
1208 "B<bcopy>(3), B<memccpy>(3), B<memcpy>(3), B<memmove>(3), B<stpncpy>(3), "
1209 "B<strcpy>(3), B<string>(3), B<wcpcpy>(3)"
1210 msgstr ""
1211
1212 #. type: TH
1213 #: build/C/man3/stpncpy.3:12
1214 #, no-wrap
1215 msgid "STPNCPY"
1216 msgstr ""
1217
1218 #. type: TH
1219 #: build/C/man3/stpncpy.3:12 build/C/man3/strcat.3:30 build/C/man3/strlen.3:28 build/C/man3/strnlen.3:11 build/C/man3/strsep.3:31 build/C/man3/strstr.3:31 build/C/man3/strxfrm.3:28
1220 #, no-wrap
1221 msgid "2011-09-28"
1222 msgstr ""
1223
1224 #. type: Plain text
1225 #: build/C/man3/stpncpy.3:15
1226 msgid "stpncpy - copy a fixed-size string, returning a pointer to its end"
1227 msgstr ""
1228
1229 #. type: Plain text
1230 #: build/C/man3/stpncpy.3:20
1231 #, no-wrap
1232 msgid "B<char *stpncpy(char *>I<dest>B<, const char *>I<src>B<, size_t >I<n>B<);>\n"
1233 msgstr ""
1234
1235 #. type: Plain text
1236 #: build/C/man3/stpncpy.3:28
1237 msgid "B<stpncpy>():"
1238 msgstr ""
1239
1240 #. type: Plain text
1241 #: build/C/man3/stpncpy.3:54
1242 msgid ""
1243 "The B<stpncpy>()  function copies at most I<n> characters from the string "
1244 "pointed to by I<src>, including the terminating null byte (\\(aq\\e0\\(aq), "
1245 "to the array pointed to by I<dest>.  Exactly I<n> characters are written at "
1246 "I<dest>.  If the length I<strlen(src)> is smaller than I<n>, the remaining "
1247 "characters in the array pointed to by I<dest> are filled with null bytes "
1248 "(\\(aq\\e0\\(aq), If the length I<strlen(src)> is greater or equal to I<n>, "
1249 "the string pointed to by I<dest> will not be null-terminated."
1250 msgstr ""
1251
1252 #. type: Plain text
1253 #: build/C/man3/stpncpy.3:56
1254 msgid "The strings may not overlap."
1255 msgstr ""
1256
1257 #. type: Plain text
1258 #: build/C/man3/stpncpy.3:59
1259 msgid ""
1260 "The programmer must ensure that there is room for at least I<n> characters "
1261 "at I<dest>."
1262 msgstr ""
1263
1264 #. type: Plain text
1265 #: build/C/man3/stpncpy.3:64
1266 msgid ""
1267 "B<stpncpy>()  returns a pointer to the terminating null byte in I<dest>, or, "
1268 "if I<dest> is not null-terminated, I<dest + n>."
1269 msgstr ""
1270
1271 #. type: Plain text
1272 #: build/C/man3/stpncpy.3:66
1273 msgid ""
1274 "This function was added to POSIX.1-2008. Before that, it was a GNU "
1275 "extension."
1276 msgstr ""
1277
1278 #. type: Plain text
1279 #: build/C/man3/stpncpy.3:68
1280 msgid "B<strncpy>(3), B<wcpncpy>(3)"
1281 msgstr ""
1282
1283 #. type: TH
1284 #: build/C/man3/strcasecmp.3:28
1285 #, no-wrap
1286 msgid "STRCASECMP"
1287 msgstr ""
1288
1289 #. type: Plain text
1290 #: build/C/man3/strcasecmp.3:31
1291 msgid "strcasecmp, strncasecmp - compare two strings ignoring case"
1292 msgstr ""
1293
1294 #. type: Plain text
1295 #: build/C/man3/strcasecmp.3:36 build/C/man3/string.3:39
1296 #, no-wrap
1297 msgid "B<int strcasecmp(const char *>I<s1>B<, const char *>I<s2>B<);>\n"
1298 msgstr ""
1299
1300 #. type: Plain text
1301 #: build/C/man3/strcasecmp.3:38 build/C/man3/string.3:41
1302 #, no-wrap
1303 msgid ""
1304 "B<int strncasecmp(const char *>I<s1>B<, const char *>I<s2>B<, size_t "
1305 ">I<n>B<);>\n"
1306 msgstr ""
1307
1308 #. type: Plain text
1309 #: build/C/man3/strcasecmp.3:47
1310 msgid ""
1311 "The B<strcasecmp>()  function compares the two strings I<s1> and I<s2>, "
1312 "ignoring the case of the characters.  It returns an integer less than, equal "
1313 "to, or greater than zero if I<s1> is found, respectively, to be less than, "
1314 "to match, or be greater than I<s2>."
1315 msgstr ""
1316
1317 #. type: Plain text
1318 #: build/C/man3/strcasecmp.3:52
1319 msgid ""
1320 "The B<strncasecmp>()  function is similar, except it only compares the first "
1321 "I<n> characters of I<s1>."
1322 msgstr ""
1323
1324 #. type: Plain text
1325 #: build/C/man3/strcasecmp.3:61
1326 msgid ""
1327 "The B<strcasecmp>()  and B<strncasecmp>()  functions return an integer less "
1328 "than, equal to, or greater than zero if I<s1> (or the first I<n> bytes "
1329 "thereof) is found, respectively, to be less than, to match, or be greater "
1330 "than I<s2>."
1331 msgstr ""
1332
1333 #. type: Plain text
1334 #: build/C/man3/strcasecmp.3:63
1335 msgid "4.4BSD, POSIX.1-2001."
1336 msgstr ""
1337
1338 #. type: Plain text
1339 #: build/C/man3/strcasecmp.3:71
1340 msgid ""
1341 "B<bcmp>(3), B<memcmp>(3), B<strcmp>(3), B<strcoll>(3), B<string>(3), "
1342 "B<strncmp>(3), B<wcscasecmp>(3), B<wcsncasecmp>(3)"
1343 msgstr ""
1344
1345 #. type: TH
1346 #: build/C/man3/strcat.3:30
1347 #, no-wrap
1348 msgid "STRCAT"
1349 msgstr ""
1350
1351 #. type: Plain text
1352 #: build/C/man3/strcat.3:33
1353 msgid "strcat, strncat - concatenate two strings"
1354 msgstr ""
1355
1356 #. type: Plain text
1357 #: build/C/man3/strcat.3:38 build/C/man3/string.3:51
1358 #, no-wrap
1359 msgid "B<char *strcat(char *>I<dest>B<, const char *>I<src>B<);>\n"
1360 msgstr ""
1361
1362 #. type: Plain text
1363 #: build/C/man3/strcat.3:40 build/C/man3/string.3:69
1364 #, no-wrap
1365 msgid "B<char *strncat(char *>I<dest>B<, const char *>I<src>B<, size_t >I<n>B<);>\n"
1366 msgstr ""
1367
1368 #. type: Plain text
1369 #: build/C/man3/strcat.3:50
1370 msgid ""
1371 "The B<strcat>()  function appends the I<src> string to the I<dest> string, "
1372 "overwriting the terminating null byte (\\(aq\\e0\\(aq) at the end of "
1373 "I<dest>, and then adds a terminating null byte.  The strings may not "
1374 "overlap, and the I<dest> string must have enough space for the result."
1375 msgstr ""
1376
1377 #. type: Plain text
1378 #: build/C/man3/strcat.3:54
1379 msgid "The B<strncat>()  function is similar, except that"
1380 msgstr ""
1381
1382 #. type: IP
1383 #: build/C/man3/strcat.3:54 build/C/man3/strcat.3:56 build/C/man3/strsep.3:80 build/C/man3/strsep.3:82 build/C/man3/strsep.3:84 build/C/man3/strtok.3:121 build/C/man3/strtok.3:123 build/C/man3/strtok.3:125 build/C/man3/strtok.3:127
1384 #, no-wrap
1385 msgid "*"
1386 msgstr ""
1387
1388 #. type: Plain text
1389 #: build/C/man3/strcat.3:56
1390 msgid "it will use at most I<n> characters from I<src>; and"
1391 msgstr ""
1392
1393 #. type: Plain text
1394 #: build/C/man3/strcat.3:59
1395 msgid ""
1396 "I<src> does not need to be null-terminated if it contains I<n> or more "
1397 "characters."
1398 msgstr ""
1399
1400 #. type: Plain text
1401 #: build/C/man3/strcat.3:63
1402 msgid ""
1403 "As with B<strcat>(), the resulting string in I<dest> is always "
1404 "null-terminated."
1405 msgstr ""
1406
1407 #. type: Plain text
1408 #: build/C/man3/strcat.3:70
1409 msgid ""
1410 "If I<src> contains I<n> or more characters, B<strncat>()  writes I<n+1> "
1411 "characters to I<dest> (I<n> from I<src> plus the terminating null byte).  "
1412 "Therefore, the size of I<dest> must be at least I<strlen(dest)+n+1>."
1413 msgstr ""
1414
1415 #. type: Plain text
1416 #: build/C/man3/strcat.3:74
1417 msgid "A simple implementation of B<strncat>()  might be:"
1418 msgstr ""
1419
1420 #. type: Plain text
1421 #: build/C/man3/strcat.3:82
1422 #, no-wrap
1423 msgid ""
1424 "char*\n"
1425 "strncat(char *dest, const char *src, size_t n)\n"
1426 "{\n"
1427 "    size_t dest_len = strlen(dest);\n"
1428 "    size_t i;\n"
1429 msgstr ""
1430
1431 #. type: Plain text
1432 #: build/C/man3/strcat.3:86
1433 #, no-wrap
1434 msgid ""
1435 "    for (i = 0 ; i E<lt> n && src[i] != \\(aq\\e0\\(aq ; i++)\n"
1436 "        dest[dest_len + i] = src[i];\n"
1437 "    dest[dest_len + i] = \\(aq\\e0\\(aq;\n"
1438 msgstr ""
1439
1440 #. type: Plain text
1441 #: build/C/man3/strcat.3:89 build/C/man3/strcpy.3:89
1442 #, no-wrap
1443 msgid ""
1444 "    return dest;\n"
1445 "}\n"
1446 msgstr ""
1447
1448 #. type: Plain text
1449 #: build/C/man3/strcat.3:97
1450 msgid ""
1451 "The B<strcat>()  and B<strncat>()  functions return a pointer to the "
1452 "resulting string I<dest>."
1453 msgstr ""
1454
1455 #. type: Plain text
1456 #: build/C/man3/strcat.3:99 build/C/man3/strcmp.3:65 build/C/man3/strcoll.3:58 build/C/man3/strcpy.3:100 build/C/man3/strlen.3:48 build/C/man3/strpbrk.3:50 build/C/man3/strspn.3:65 build/C/man3/strxfrm.3:64
1457 msgid "SVr4, 4.3BSD, C89, C99."
1458 msgstr ""
1459
1460 #. type: Plain text
1461 #: build/C/man3/strcat.3:107
1462 msgid ""
1463 "B<bcopy>(3), B<memccpy>(3), B<memcpy>(3), B<strcpy>(3), B<string>(3), "
1464 "B<strncpy>(3), B<wcscat>(3), B<wcsncat>(3)"
1465 msgstr ""
1466
1467 #. type: TH
1468 #: build/C/man3/strchr.3:31
1469 #, no-wrap
1470 msgid "STRCHR"
1471 msgstr ""
1472
1473 #. type: Plain text
1474 #: build/C/man3/strchr.3:34
1475 msgid "strchr, strrchr, strchrnul - locate character in string"
1476 msgstr ""
1477
1478 #. type: Plain text
1479 #: build/C/man3/strchr.3:39 build/C/man3/string.3:53
1480 #, no-wrap
1481 msgid "B<char *strchr(const char *>I<s>B<, int >I<c>B<);>\n"
1482 msgstr ""
1483
1484 #. type: Plain text
1485 #: build/C/man3/strchr.3:41 build/C/man3/string.3:77
1486 #, no-wrap
1487 msgid "B<char *strrchr(const char *>I<s>B<, int >I<c>B<);>\n"
1488 msgstr ""
1489
1490 #. type: Plain text
1491 #: build/C/man3/strchr.3:46
1492 #, no-wrap
1493 msgid "B<char *strchrnul(const char *>I<s>B<, int >I<c>B<);>\n"
1494 msgstr ""
1495
1496 #. type: Plain text
1497 #: build/C/man3/strchr.3:52
1498 msgid ""
1499 "The B<strchr>()  function returns a pointer to the first occurrence of the "
1500 "character I<c> in the string I<s>."
1501 msgstr ""
1502
1503 #. type: Plain text
1504 #: build/C/man3/strchr.3:57
1505 msgid ""
1506 "The B<strrchr>()  function returns a pointer to the last occurrence of the "
1507 "character I<c> in the string I<s>."
1508 msgstr ""
1509
1510 #. type: Plain text
1511 #: build/C/man3/strchr.3:65
1512 msgid ""
1513 "The B<strchrnul>()  function is like B<strchr>()  except that if I<c> is not "
1514 "found in I<s>, then it returns a pointer to the null byte at the end of "
1515 "I<s>, rather than NULL."
1516 msgstr ""
1517
1518 #. type: Plain text
1519 #: build/C/man3/strchr.3:68
1520 msgid ""
1521 "Here \"character\" means \"byte\"; these functions do not work with wide or "
1522 "multibyte characters."
1523 msgstr ""
1524
1525 #. type: Plain text
1526 #: build/C/man3/strchr.3:75
1527 msgid ""
1528 "The B<strchr>()  and B<strrchr>()  functions return a pointer to the matched "
1529 "character or NULL if the character is not found."
1530 msgstr ""
1531
1532 #. type: Plain text
1533 #: build/C/man3/strchr.3:83
1534 msgid ""
1535 "The B<strchrnul>()  function returns a pointer to the matched character, or "
1536 "a pointer to the null byte at the end of I<s> (i.e., I<s+strlen(s)>)  if the "
1537 "character is not found."
1538 msgstr ""
1539
1540 #. type: Plain text
1541 #: build/C/man3/strchr.3:86
1542 msgid "B<strchrnul>()  first appeared in glibc in version 2.1.1."
1543 msgstr ""
1544
1545 #. type: Plain text
1546 #: build/C/man3/strchr.3:93
1547 msgid ""
1548 "B<strchr>()  and B<strrchr>()  are in SVr4, 4.3BSD, C89, C99.  "
1549 "B<strchrnul>()  is a GNU extension."
1550 msgstr ""
1551
1552 #. type: Plain text
1553 #: build/C/man3/strchr.3:105
1554 msgid ""
1555 "B<index>(3), B<memchr>(3), B<rindex>(3), B<string>(3), B<strlen>(3), "
1556 "B<strpbrk>(3), B<strsep>(3), B<strspn>(3), B<strstr>(3), B<strtok>(3), "
1557 "B<wcschr>(3), B<wcsrchr>(3)"
1558 msgstr ""
1559
1560 #. type: TH
1561 #: build/C/man3/strcmp.3:30
1562 #, no-wrap
1563 msgid "STRCMP"
1564 msgstr ""
1565
1566 #. type: Plain text
1567 #: build/C/man3/strcmp.3:33
1568 msgid "strcmp, strncmp - compare two strings"
1569 msgstr ""
1570
1571 #. type: Plain text
1572 #: build/C/man3/strcmp.3:38 build/C/man3/string.3:55
1573 #, no-wrap
1574 msgid "B<int strcmp(const char *>I<s1>B<, const char *>I<s2>B<);>\n"
1575 msgstr ""
1576
1577 #. type: Plain text
1578 #: build/C/man3/strcmp.3:40 build/C/man3/string.3:71
1579 #, no-wrap
1580 msgid ""
1581 "B<int strncmp(const char *>I<s1>B<, const char *>I<s2>B<, size_t "
1582 ">I<n>B<);>\n"
1583 msgstr ""
1584
1585 #. type: Plain text
1586 #: build/C/man3/strcmp.3:49
1587 msgid ""
1588 "The B<strcmp>()  function compares the two strings I<s1> and I<s2>.  It "
1589 "returns an integer less than, equal to, or greater than zero if I<s1> is "
1590 "found, respectively, to be less than, to match, or be greater than I<s2>."
1591 msgstr ""
1592
1593 #. type: Plain text
1594 #: build/C/man3/strcmp.3:54
1595 msgid ""
1596 "The B<strncmp>()  function is similar, except it only compares the first (at "
1597 "most) I<n> characters of I<s1> and I<s2>."
1598 msgstr ""
1599
1600 #. type: Plain text
1601 #: build/C/man3/strcmp.3:63
1602 msgid ""
1603 "The B<strcmp>()  and B<strncmp>()  functions return an integer less than, "
1604 "equal to, or greater than zero if I<s1> (or the first I<n> bytes thereof) is "
1605 "found, respectively, to be less than, to match, or be greater than I<s2>."
1606 msgstr ""
1607
1608 #. type: Plain text
1609 #: build/C/man3/strcmp.3:74
1610 msgid ""
1611 "B<bcmp>(3), B<memcmp>(3), B<strcasecmp>(3), B<strcoll>(3), B<string>(3), "
1612 "B<strncasecmp>(3), B<strverscmp>(3), B<wcscmp>(3), B<wcsncmp>(3)"
1613 msgstr ""
1614
1615 #. type: TH
1616 #: build/C/man3/strcoll.3:28
1617 #, no-wrap
1618 msgid "STRCOLL"
1619 msgstr ""
1620
1621 #. type: Plain text
1622 #: build/C/man3/strcoll.3:31
1623 msgid "strcoll - compare two strings using the current locale"
1624 msgstr ""
1625
1626 #. type: Plain text
1627 #: build/C/man3/strcoll.3:36 build/C/man3/string.3:57
1628 #, no-wrap
1629 msgid "B<int strcoll(const char *>I<s1>B<, const char *>I<s2>B<);>\n"
1630 msgstr ""
1631
1632 #. type: Plain text
1633 #: build/C/man3/strcoll.3:49
1634 msgid ""
1635 "The B<strcoll>()  function compares the two strings I<s1> and I<s2>.  It "
1636 "returns an integer less than, equal to, or greater than zero if I<s1> is "
1637 "found, respectively, to be less than, to match, or be greater than I<s2>.  "
1638 "The comparison is based on strings interpreted as appropriate for the "
1639 "program's current locale for category B<LC_COLLATE>.  (See B<setlocale>(3).)"
1640 msgstr ""
1641
1642 #. type: Plain text
1643 #: build/C/man3/strcoll.3:56
1644 msgid ""
1645 "The B<strcoll>()  function returns an integer less than, equal to, or "
1646 "greater than zero if I<s1> is found, respectively, to be less than, to "
1647 "match, or be greater than I<s2>, when both are interpreted as appropriate "
1648 "for the current locale."
1649 msgstr ""
1650
1651 #. type: Plain text
1652 #: build/C/man3/strcoll.3:63
1653 msgid ""
1654 "In the I<\"POSIX\"> or I<\"C\"> locales B<strcoll>()  is equivalent to "
1655 "B<strcmp>(3)."
1656 msgstr ""
1657
1658 #. type: Plain text
1659 #: build/C/man3/strcoll.3:70
1660 msgid ""
1661 "B<bcmp>(3), B<memcmp>(3), B<setlocale>(3), B<strcasecmp>(3), B<strcmp>(3), "
1662 "B<string>(3), B<strxfrm>(3)"
1663 msgstr ""
1664
1665 #. type: TH
1666 #: build/C/man3/strcpy.3:33
1667 #, no-wrap
1668 msgid "STRCPY"
1669 msgstr ""
1670
1671 #. type: Plain text
1672 #: build/C/man3/strcpy.3:36
1673 msgid "strcpy, strncpy - copy a string"
1674 msgstr ""
1675
1676 #. type: Plain text
1677 #: build/C/man3/strcpy.3:41 build/C/man3/string.3:59
1678 #, no-wrap
1679 msgid "B<char *strcpy(char *>I<dest>B<, const char *>I<src>B<);>\n"
1680 msgstr ""
1681
1682 #. type: Plain text
1683 #: build/C/man3/strcpy.3:43 build/C/man3/string.3:73
1684 #, no-wrap
1685 msgid "B<char *strncpy(char *>I<dest>B<, const char *>I<src>B<, size_t >I<n>B<);>\n"
1686 msgstr ""
1687
1688 #. type: Plain text
1689 #: build/C/man3/strcpy.3:52
1690 msgid ""
1691 "The B<strcpy>()  function copies the string pointed to by I<src>, including "
1692 "the terminating null byte (\\(aq\\e0\\(aq), to the buffer pointed to by "
1693 "I<dest>.  The strings may not overlap, and the destination string I<dest> "
1694 "must be large enough to receive the copy."
1695 msgstr ""
1696
1697 #. type: Plain text
1698 #: build/C/man3/strcpy.3:61
1699 msgid ""
1700 "The B<strncpy>()  function is similar, except that at most I<n> bytes of "
1701 "I<src> are copied.  B<Warning>: If there is no null byte among the first "
1702 "I<n> bytes of I<src>, the string placed in I<dest> will not be "
1703 "null-terminated."
1704 msgstr ""
1705
1706 #. type: Plain text
1707 #: build/C/man3/strcpy.3:70
1708 msgid ""
1709 "If the length of I<src> is less than I<n>, B<strncpy>()  pads the remainder "
1710 "of I<dest> with null bytes."
1711 msgstr ""
1712
1713 #. type: Plain text
1714 #: build/C/man3/strcpy.3:74
1715 msgid "A simple implementation of B<strncpy>()  might be:"
1716 msgstr ""
1717
1718 #. type: Plain text
1719 #: build/C/man3/strcpy.3:81
1720 #, no-wrap
1721 msgid ""
1722 "char *\n"
1723 "strncpy(char *dest, const char *src, size_t n)\n"
1724 "{\n"
1725 "    size_t i;\n"
1726 msgstr ""
1727
1728 #. type: Plain text
1729 #: build/C/man3/strcpy.3:86
1730 #, no-wrap
1731 msgid ""
1732 "    for (i = 0; i E<lt> n && src[i] != \\(aq\\e0\\(aq; i++)\n"
1733 "        dest[i] = src[i];\n"
1734 "    for ( ; i E<lt> n; i++)\n"
1735 "        dest[i] = \\(aq\\e0\\(aq;\n"
1736 msgstr ""
1737
1738 #. type: Plain text
1739 #: build/C/man3/strcpy.3:98
1740 msgid ""
1741 "The B<strcpy>()  and B<strncpy>()  functions return a pointer to the "
1742 "destination string I<dest>."
1743 msgstr ""
1744
1745 #. type: Plain text
1746 #: build/C/man3/strcpy.3:109
1747 msgid ""
1748 "Some programmers consider B<strncpy>()  to be inefficient and error prone.  "
1749 "If the programmer knows (i.e., includes code to test!)  that the size of "
1750 "I<dest> is greater than the length of I<src>, then B<strcpy>()  can be used."
1751 msgstr ""
1752
1753 #. type: Plain text
1754 #: build/C/man3/strcpy.3:116
1755 msgid ""
1756 "If there is no terminating null byte in the first I<n> characters of I<src>, "
1757 "B<strncpy>()  produces an unterminated string in I<dest>.  Programmers often "
1758 "prevent this mistake by forcing termination as follows:"
1759 msgstr ""
1760
1761 #. type: Plain text
1762 #: build/C/man3/strcpy.3:122
1763 #, no-wrap
1764 msgid ""
1765 "strncpy(buf, str, n);\n"
1766 "if (n E<gt> 0)\n"
1767 "    buf[n - 1]= \\(aq\\e0\\(aq;\n"
1768 msgstr ""
1769
1770 #. type: Plain text
1771 #: build/C/man3/strcpy.3:135
1772 msgid ""
1773 "If the destination string of a B<strcpy>()  is not large enough, then "
1774 "anything might happen.  Overflowing fixed-length string buffers is a "
1775 "favorite cracker technique for taking complete control of the machine.  Any "
1776 "time a program reads or copies data into a buffer, the program first needs "
1777 "to check that there's enough space.  This may be unnecessary if you can show "
1778 "that overflow is impossible, but be careful: programs can get changed over "
1779 "time, in ways that may make the impossible possible."
1780 msgstr ""
1781
1782 #. type: Plain text
1783 #: build/C/man3/strcpy.3:145
1784 msgid ""
1785 "B<bcopy>(3), B<memccpy>(3), B<memcpy>(3), B<memmove>(3), B<stpcpy>(3), "
1786 "B<stpncpy>(3), B<strdup>(3), B<string>(3), B<wcscpy>(3), B<wcsncpy>(3)"
1787 msgstr ""
1788
1789 #. type: TH
1790 #: build/C/man3/strdup.3:29
1791 #, no-wrap
1792 msgid "STRDUP"
1793 msgstr ""
1794
1795 #. type: TH
1796 #: build/C/man3/strdup.3:29
1797 #, no-wrap
1798 msgid "2011-10-01"
1799 msgstr ""
1800
1801 #. type: Plain text
1802 #: build/C/man3/strdup.3:32
1803 msgid "strdup, strndup, strdupa, strndupa - duplicate a string"
1804 msgstr ""
1805
1806 #. type: Plain text
1807 #: build/C/man3/strdup.3:37 build/C/man3/string.3:63
1808 #, no-wrap
1809 msgid "B<char *strdup(const char *>I<s>B<);>\n"
1810 msgstr ""
1811
1812 #. type: Plain text
1813 #: build/C/man3/strdup.3:39
1814 #, no-wrap
1815 msgid "B<char *strndup(const char *>I<s>B<, size_t >I<n>B<);>\n"
1816 msgstr ""
1817
1818 #. type: Plain text
1819 #: build/C/man3/strdup.3:41
1820 #, no-wrap
1821 msgid "B<char *strdupa(const char *>I<s>B<);>\n"
1822 msgstr ""
1823
1824 #. type: Plain text
1825 #: build/C/man3/strdup.3:43
1826 #, no-wrap
1827 msgid "B<char *strndupa(const char *>I<s>B<, size_t >I<n>B<);>\n"
1828 msgstr ""
1829
1830 #. type: Plain text
1831 #: build/C/man3/strdup.3:53
1832 msgid "B<strdup>():"
1833 msgstr ""
1834
1835 #. type: Plain text
1836 #: build/C/man3/strdup.3:56
1837 msgid ""
1838 "_SVID_SOURCE || _BSD_SOURCE || _XOPEN_SOURCE\\ E<gt>=\\ 500 || "
1839 "_XOPEN_SOURCE\\ &&\\ _XOPEN_SOURCE_EXTENDED"
1840 msgstr ""
1841
1842 #. type: Plain text
1843 #: build/C/man3/strdup.3:58
1844 msgid "|| /* Since glibc 2.12: */ _POSIX_C_SOURCE\\ E<gt>=\\ 200809L"
1845 msgstr ""
1846
1847 #. type: Plain text
1848 #: build/C/man3/strdup.3:61
1849 msgid "B<strndup>():"
1850 msgstr ""
1851
1852 #. type: Plain text
1853 #: build/C/man3/strdup.3:65
1854 msgid "POSIX_C_SOURCE\\ E<gt>=\\ 200809L || _XOPEN_SOURCE\\ E<gt>=\\ 700"
1855 msgstr ""
1856
1857 #. type: Plain text
1858 #: build/C/man3/strdup.3:73
1859 msgid "B<strdupa>(), B<strndupa>(): _GNU_SOURCE"
1860 msgstr ""
1861
1862 #. type: Plain text
1863 #: build/C/man3/strdup.3:85
1864 msgid ""
1865 "The B<strdup>()  function returns a pointer to a new string which is a "
1866 "duplicate of the string I<s>.  Memory for the new string is obtained with "
1867 "B<malloc>(3), and can be freed with B<free>(3)."
1868 msgstr ""
1869
1870 #. type: Plain text
1871 #: build/C/man3/strdup.3:92
1872 msgid ""
1873 "The B<strndup>()  function is similar, but only copies at most I<n> "
1874 "characters.  If I<s> is longer than I<n>, only I<n> characters are copied, "
1875 "and a terminating null byte (\\(aq\\e0\\(aq) is added."
1876 msgstr ""
1877
1878 #. type: Plain text
1879 #: build/C/man3/strdup.3:102
1880 msgid ""
1881 "B<strdupa>()  and B<strndupa>()  are similar, but use B<alloca>(3)  to "
1882 "allocate the buffer.  They are only available when using the GNU GCC suite, "
1883 "and suffer from the same limitations described in B<alloca>(3)."
1884 msgstr ""
1885
1886 #. type: Plain text
1887 #: build/C/man3/strdup.3:107
1888 msgid ""
1889 "The B<strdup>()  function returns a pointer to the duplicated string, or "
1890 "NULL if insufficient memory was available."
1891 msgstr ""
1892
1893 #. type: SH
1894 #: build/C/man3/strdup.3:107 build/C/man3/strerror.3:139
1895 #, no-wrap
1896 msgid "ERRORS"
1897 msgstr ""
1898
1899 #. type: TP
1900 #: build/C/man3/strdup.3:108
1901 #, no-wrap
1902 msgid "B<ENOMEM>"
1903 msgstr ""
1904
1905 #. type: Plain text
1906 #: build/C/man3/strdup.3:111
1907 msgid "Insufficient memory available to allocate duplicate string."
1908 msgstr ""
1909
1910 #.  4.3BSD-Reno, not (first) 4.3BSD.
1911 #. type: Plain text
1912 #: build/C/man3/strdup.3:121
1913 msgid ""
1914 "B<strdup>()  conforms to SVr4, 4.3BSD, POSIX.1-2001.  B<strndup>()  conforms "
1915 "to POSIX.1-2008.  B<strdupa>()  and B<strndupa>()  are GNU extensions."
1916 msgstr ""
1917
1918 #. type: Plain text
1919 #: build/C/man3/strdup.3:128
1920 msgid ""
1921 "B<alloca>(3), B<calloc>(3), B<free>(3), B<malloc>(3), B<realloc>(3), "
1922 "B<string>(3), B<wcsdup>(3)"
1923 msgstr ""
1924
1925 #. type: TH
1926 #: build/C/man3/strerror.3:37
1927 #, no-wrap
1928 msgid "STRERROR"
1929 msgstr ""
1930
1931 #. type: TH
1932 #: build/C/man3/strerror.3:37
1933 #, no-wrap
1934 msgid "2009-03-30"
1935 msgstr ""
1936
1937 #. type: Plain text
1938 #: build/C/man3/strerror.3:40
1939 msgid "strerror, strerror_r - return string describing error number"
1940 msgstr ""
1941
1942 #. type: Plain text
1943 #: build/C/man3/strerror.3:45
1944 #, no-wrap
1945 msgid "B<char *strerror(int >I<errnum>B<);>\n"
1946 msgstr ""
1947
1948 #. type: Plain text
1949 #: build/C/man3/strerror.3:48
1950 #, no-wrap
1951 msgid ""
1952 "B<int strerror_r(int >I<errnum>B<, char *>I<buf>B<, size_t >I<buflen>B<);>\n"
1953 "            /* XSI-compliant */\n"
1954 msgstr ""
1955
1956 #. type: Plain text
1957 #: build/C/man3/strerror.3:51
1958 #, no-wrap
1959 msgid ""
1960 "B<char *strerror_r(int >I<errnum>B<, char *>I<buf>B<, size_t "
1961 ">I<buflen>B<);>\n"
1962 "            /* GNU-specific */\n"
1963 msgstr ""
1964
1965 #. type: Plain text
1966 #: build/C/man3/strerror.3:61
1967 msgid "The XSI-compliant version of B<strerror_r>()  is provided if:"
1968 msgstr ""
1969
1970 #. type: Plain text
1971 #: build/C/man3/strerror.3:63
1972 msgid ""
1973 "(_POSIX_C_SOURCE\\ E<gt>=\\ 200112L || _XOPEN_SOURCE\\ E<gt>=\\ 600) && !\\ "
1974 "_GNU_SOURCE"
1975 msgstr ""
1976
1977 #. type: Plain text
1978 #: build/C/man3/strerror.3:65
1979 msgid "Otherwise, the GNU-specific version is provided."
1980 msgstr ""
1981
1982 #. type: Plain text
1983 #: build/C/man3/strerror.3:78
1984 msgid ""
1985 "The B<strerror>()  function returns a pointer to a string that describes the "
1986 "error code passed in the argument I<errnum>, possibly using the "
1987 "B<LC_MESSAGES> part of the current locale to select the appropriate "
1988 "language.  This string must not be modified by the application, but may be "
1989 "modified by a subsequent call to B<perror>(3)  or B<strerror>().  No library "
1990 "function will modify this string."
1991 msgstr ""
1992
1993 #. type: Plain text
1994 #: build/C/man3/strerror.3:99
1995 msgid ""
1996 "The B<strerror_r>()  function is similar to B<strerror>(), but is thread "
1997 "safe.  This function is available in two versions: an XSI-compliant version "
1998 "specified in POSIX.1-2001 (available since glibc 2.3.4), and a GNU-specific "
1999 "version (available since glibc 2.0).  The XSI-compliant version is provided "
2000 "with the feature test macros settings shown in the SYNOPSIS; otherwise the "
2001 "GNU-specific version is provided.  If no feature test macros are explicitly "
2002 "defined, then (since glibc 2.4)  B<_POSIX_SOURCE> is defined by default with "
2003 "the value 200112L, so that the XSI-compliant version of B<strerror_r>()  is "
2004 "provided by default."
2005 msgstr ""
2006
2007 #. type: Plain text
2008 #: build/C/man3/strerror.3:107
2009 msgid ""
2010 "The XSI-compliant B<strerror_r>()  is preferred for portable applications.  "
2011 "It returns the error string in the user-supplied buffer I<buf> of length "
2012 "I<buflen>."
2013 msgstr ""
2014
2015 #. type: Plain text
2016 #: build/C/man3/strerror.3:124
2017 msgid ""
2018 "The GNU-specific B<strerror_r>()  returns a pointer to a string containing "
2019 "the error message.  This may be either a pointer to a string that the "
2020 "function stores in I<buf>, or a pointer to some (immutable) static string "
2021 "(in which case I<buf> is unused).  If the function stores a string in "
2022 "I<buf>, then at most I<buflen> bytes are stored (the string may be truncated "
2023 "if I<buflen> is too small) and the string always includes a terminating null "
2024 "byte."
2025 msgstr ""
2026
2027 #. type: Plain text
2028 #: build/C/man3/strerror.3:132
2029 msgid ""
2030 "The B<strerror>()  and the GNU-specific B<strerror_r>()  functions return "
2031 "the appropriate error description string, or an \"Unknown error nnn\" "
2032 "message if the error number is unknown."
2033 msgstr ""
2034
2035 #. type: Plain text
2036 #: build/C/man3/strerror.3:139
2037 msgid ""
2038 "The XSI-compliant B<strerror_r>()  function returns 0 on success; on error, "
2039 "-1 is returned and I<errno> is set to indicate the error."
2040 msgstr ""
2041
2042 #. type: TP
2043 #: build/C/man3/strerror.3:140
2044 #, no-wrap
2045 msgid "B<EINVAL>"
2046 msgstr ""
2047
2048 #. type: Plain text
2049 #: build/C/man3/strerror.3:145
2050 msgid "The value of I<errnum> is not a valid error number."
2051 msgstr ""
2052
2053 #. type: TP
2054 #: build/C/man3/strerror.3:145
2055 #, no-wrap
2056 msgid "B<ERANGE>"
2057 msgstr ""
2058
2059 #. type: Plain text
2060 #: build/C/man3/strerror.3:148
2061 msgid "Insufficient storage was supplied to contain the error description string."
2062 msgstr ""
2063
2064 #. type: Plain text
2065 #: build/C/man3/strerror.3:153
2066 msgid ""
2067 "B<strerror>()  is specified by POSIX.1-2001, C89, C99.  B<strerror_r>()  is "
2068 "specified by POSIX.1-2001."
2069 msgstr ""
2070
2071 #. type: Plain text
2072 #: build/C/man3/strerror.3:157
2073 msgid "The GNU-specific B<strerror_r>()  function is a nonstandard extension."
2074 msgstr ""
2075
2076 #.  e.g., Solaris 8, HP-UX 11
2077 #.  e.g., FreeBSD 5.4, Tru64 5.1B
2078 #. type: Plain text
2079 #: build/C/man3/strerror.3:176
2080 msgid ""
2081 "POSIX.1-2001 permits B<strerror>()  to set I<errno> if the call encounters "
2082 "an error, but does not specify what value should be returned as the function "
2083 "result in the event of an error.  On some systems, B<strerror>()  returns "
2084 "NULL if the error number is unknown.  On other systems, B<strerror>()  "
2085 "returns a string something like \"Error nnn occurred\" and sets I<errno> to "
2086 "B<EINVAL> if the error number is unknown."
2087 msgstr ""
2088
2089 #. type: Plain text
2090 #: build/C/man3/strerror.3:181
2091 msgid "B<err>(3), B<errno>(3), B<error>(3), B<perror>(3), B<strsignal>(3)"
2092 msgstr ""
2093
2094 #. type: TH
2095 #: build/C/man3/strfry.3:28
2096 #, no-wrap
2097 msgid "STRFRY"
2098 msgstr ""
2099
2100 #. type: Plain text
2101 #: build/C/man3/strfry.3:31
2102 msgid "strfry - randomize a string"
2103 msgstr ""
2104
2105 #. type: Plain text
2106 #: build/C/man3/strfry.3:38 build/C/man3/string.3:65
2107 #, no-wrap
2108 msgid "B<char *strfry(char *>I<string>B<);>\n"
2109 msgstr ""
2110
2111 #. type: Plain text
2112 #: build/C/man3/strfry.3:47
2113 msgid ""
2114 "The B<strfry>()  function randomizes the contents of I<string> by using "
2115 "B<rand>(3)  to randomly swap characters in the string.  The result is an "
2116 "anagram of I<string>."
2117 msgstr ""
2118
2119 #. type: Plain text
2120 #: build/C/man3/strfry.3:52
2121 msgid "The B<strfry>()  functions returns a pointer to the randomized string."
2122 msgstr ""
2123
2124 #. type: Plain text
2125 #: build/C/man3/strfry.3:57
2126 msgid "The B<strfry>()  function is unique to the GNU C Library."
2127 msgstr ""
2128
2129 #. type: Plain text
2130 #: build/C/man3/strfry.3:59
2131 msgid "B<memfrob>(3), B<string>(3)"
2132 msgstr ""
2133
2134 #. type: TH
2135 #: build/C/man3/string.3:28
2136 #, no-wrap
2137 msgid "STRING"
2138 msgstr ""
2139
2140 #. type: TH
2141 #: build/C/man3/string.3:28
2142 #, no-wrap
2143 msgid "2010-02-25"
2144 msgstr ""
2145
2146 #. type: Plain text
2147 #: build/C/man3/string.3:34
2148 msgid ""
2149 "stpcpy, strcasecmp, strcat, strchr, strcmp, strcoll, strcpy, strcspn, "
2150 "strdup, strfry, strlen, strncat, strncmp, strncpy, strncasecmp, strpbrk, "
2151 "strrchr, strsep, strspn, strstr, strtok, strxfrm, index, rindex - string "
2152 "operations"
2153 msgstr ""
2154
2155 #. type: Plain text
2156 #: build/C/man3/string.3:61 build/C/man3/strspn.3:38
2157 #, no-wrap
2158 msgid "B<size_t strcspn(const char *>I<s>B<, const char *>I<reject>B<);>\n"
2159 msgstr ""
2160
2161 #. type: Plain text
2162 #: build/C/man3/string.3:67 build/C/man3/strlen.3:36
2163 #, no-wrap
2164 msgid "B<size_t strlen(const char *>I<s>B<);>\n"
2165 msgstr ""
2166
2167 #. type: Plain text
2168 #: build/C/man3/string.3:75 build/C/man3/strpbrk.3:36
2169 #, no-wrap
2170 msgid "B<char *strpbrk(const char *>I<s>B<, const char *>I<accept>B<);>\n"
2171 msgstr ""
2172
2173 #. type: Plain text
2174 #: build/C/man3/string.3:79 build/C/man3/strsep.3:39
2175 #, no-wrap
2176 msgid "B<char *strsep(char **>I<stringp>B<, const char *>I<delim>B<);>\n"
2177 msgstr ""
2178
2179 #. type: Plain text
2180 #: build/C/man3/string.3:81 build/C/man3/strspn.3:36
2181 #, no-wrap
2182 msgid "B<size_t strspn(const char *>I<s>B<, const char *>I<accept>B<);>\n"
2183 msgstr ""
2184
2185 #. type: Plain text
2186 #: build/C/man3/string.3:83 build/C/man3/strstr.3:39
2187 #, no-wrap
2188 msgid "B<char *strstr(const char *>I<haystack>B<, const char *>I<needle>B<);>\n"
2189 msgstr ""
2190
2191 #. type: Plain text
2192 #: build/C/man3/string.3:85
2193 #, no-wrap
2194 msgid "B<char *strtok(char *>I<s>B<, const char *>I<delim>B<);>\n"
2195 msgstr ""
2196
2197 #. type: Plain text
2198 #: build/C/man3/string.3:87 build/C/man3/strxfrm.3:36
2199 #, no-wrap
2200 msgid ""
2201 "B<size_t strxfrm(char *>I<dest>B<, const char *>I<src>B<, size_t "
2202 ">I<n>B<);>\n"
2203 msgstr ""
2204
2205 #. type: Plain text
2206 #: build/C/man3/string.3:92
2207 msgid ""
2208 "The string functions perform string operations on null-terminated strings.  "
2209 "See the individual man pages for descriptions of each function."
2210 msgstr ""
2211
2212 #. type: Plain text
2213 #: build/C/man3/string.3:116
2214 msgid ""
2215 "B<index>(3), B<rindex>(3), B<stpcpy>(3), B<strcasecmp>(3), B<strcat>(3), "
2216 "B<strchr>(3), B<strcmp>(3), B<strcoll>(3), B<strcpy>(3), B<strcspn>(3), "
2217 "B<strdup>(3), B<strfry>(3), B<strlen>(3), B<strncasecmp>(3), B<strncat>(3), "
2218 "B<strncmp>(3), B<strncpy>(3), B<strpbrk>(3), B<strrchr>(3), B<strsep>(3), "
2219 "B<strspn>(3), B<strstr>(3), B<strtok>(3), B<strxfrm>(3)"
2220 msgstr ""
2221
2222 #. type: TH
2223 #: build/C/man3/strlen.3:28
2224 #, no-wrap
2225 msgid "STRLEN"
2226 msgstr ""
2227
2228 #. type: Plain text
2229 #: build/C/man3/strlen.3:31
2230 msgid "strlen - calculate the length of a string"
2231 msgstr ""
2232
2233 #. type: Plain text
2234 #: build/C/man3/strlen.3:42
2235 msgid ""
2236 "The B<strlen>()  function calculates the length of the string I<s>, "
2237 "excluding the terminating null byte (\\(aq\\e0\\(aq)."
2238 msgstr ""
2239
2240 #. type: Plain text
2241 #: build/C/man3/strlen.3:46
2242 msgid "The B<strlen>()  function returns the number of characters in I<s>."
2243 msgstr ""
2244
2245 #. type: Plain text
2246 #: build/C/man3/strlen.3:52
2247 msgid "B<string>(3), B<strnlen>(3), B<wcslen>(3), B<wcsnlen>(3)"
2248 msgstr ""
2249
2250 #. type: TH
2251 #: build/C/man3/strnlen.3:11
2252 #, no-wrap
2253 msgid "STRNLEN"
2254 msgstr ""
2255
2256 #. type: Plain text
2257 #: build/C/man3/strnlen.3:14
2258 msgid "strnlen - determine the length of a fixed-size string"
2259 msgstr ""
2260
2261 #. type: Plain text
2262 #: build/C/man3/strnlen.3:19
2263 #, no-wrap
2264 msgid "B<size_t strnlen(const char *>I<s>B<, size_t >I<maxlen>B<);>\n"
2265 msgstr ""
2266
2267 #. type: Plain text
2268 #: build/C/man3/strnlen.3:27
2269 msgid "B<strnlen>():"
2270 msgstr ""
2271
2272 #. type: Plain text
2273 #: build/C/man3/strnlen.3:49
2274 msgid ""
2275 "The B<strnlen>()  function returns the number of characters in the string "
2276 "pointed to by I<s>, excluding the terminating null bye (\\(aq\\e0\\(aq), but "
2277 "at most I<maxlen>.  In doing this, B<strnlen>()  looks only at the first "
2278 "I<maxlen> characters at I<s> and never beyond I<s+maxlen>."
2279 msgstr ""
2280
2281 #. type: Plain text
2282 #: build/C/man3/strnlen.3:56
2283 msgid ""
2284 "The B<strnlen>()  function returns I<strlen(s)>, if that is less than "
2285 "I<maxlen>, or I<maxlen> if there is no null byte (\\(aq\\e0\\(aq) among the "
2286 "first I<maxlen> characters pointed to by I<s>."
2287 msgstr ""
2288
2289 #. type: Plain text
2290 #: build/C/man3/strnlen.3:58
2291 msgid "POSIX.1-2008."
2292 msgstr ""
2293
2294 #. type: Plain text
2295 #: build/C/man3/strnlen.3:59
2296 msgid "B<strlen>(3)"
2297 msgstr ""
2298
2299 #. type: TH
2300 #: build/C/man3/strpbrk.3:28
2301 #, no-wrap
2302 msgid "STRPBRK"
2303 msgstr ""
2304
2305 #. type: Plain text
2306 #: build/C/man3/strpbrk.3:31
2307 msgid "strpbrk - search a string for any of a set of characters"
2308 msgstr ""
2309
2310 #. type: Plain text
2311 #: build/C/man3/strpbrk.3:42
2312 msgid ""
2313 "The B<strpbrk>()  function locates the first occurrence in the string I<s> "
2314 "of any of the characters in the string I<accept>."
2315 msgstr ""
2316
2317 #. type: Plain text
2318 #: build/C/man3/strpbrk.3:48
2319 msgid ""
2320 "The B<strpbrk>()  function returns a pointer to the character in I<s> that "
2321 "matches one of the characters in I<accept>, or NULL if no such character is "
2322 "found."
2323 msgstr ""
2324
2325 #. type: Plain text
2326 #: build/C/man3/strpbrk.3:60
2327 msgid ""
2328 "B<index>(3), B<memchr>(3), B<rindex>(3), B<strchr>(3), B<string>(3), "
2329 "B<strsep>(3), B<strspn>(3), B<strstr>(3), B<strtok>(3), B<wcspbrk>(3)"
2330 msgstr ""
2331
2332 #. type: TH
2333 #: build/C/man3/strsep.3:31
2334 #, no-wrap
2335 msgid "STRSEP"
2336 msgstr ""
2337
2338 #. type: Plain text
2339 #: build/C/man3/strsep.3:34
2340 msgid "strsep - extract token from string"
2341 msgstr ""
2342
2343 #. type: Plain text
2344 #: build/C/man3/strsep.3:48
2345 msgid "B<strsep>(): _BSD_SOURCE"
2346 msgstr ""
2347
2348 #. type: Plain text
2349 #: build/C/man3/strsep.3:61
2350 msgid ""
2351 "If I<*stringp> is NULL, the B<strsep>()  function returns NULL and does "
2352 "nothing else.  Otherwise, this function finds the first token in the string "
2353 "I<*stringp>, where tokens are delimited by symbols in the string I<delim>.  "
2354 "This token is terminated by overwriting the delimiter with a null byte "
2355 "(\\(aq\\e0\\(aq)  and I<*stringp> is updated to point past the token.  In "
2356 "case no delimiter was found, the token is taken to be the entire string "
2357 "I<*stringp>, and I<*stringp> is made NULL."
2358 msgstr ""
2359
2360 #. type: Plain text
2361 #: build/C/man3/strsep.3:66
2362 msgid ""
2363 "The B<strsep>()  function returns a pointer to the token, that is, it "
2364 "returns the original value of I<*stringp>."
2365 msgstr ""
2366
2367 #. type: Plain text
2368 #: build/C/man3/strsep.3:68
2369 msgid "4.4BSD."
2370 msgstr ""
2371
2372 #. type: Plain text
2373 #: build/C/man3/strsep.3:77
2374 msgid ""
2375 "The B<strsep>()  function was introduced as a replacement for B<strtok>(3), "
2376 "since the latter cannot handle empty fields.  However, B<strtok>(3)  "
2377 "conforms to C89/C99 and hence is more portable."
2378 msgstr ""
2379
2380 #. type: Plain text
2381 #: build/C/man3/strsep.3:80
2382 msgid "Be cautious when using this function.  If you do use it, note that:"
2383 msgstr ""
2384
2385 #. type: Plain text
2386 #: build/C/man3/strsep.3:82
2387 msgid "This function modifies its first argument."
2388 msgstr ""
2389
2390 #. type: Plain text
2391 #: build/C/man3/strsep.3:84
2392 msgid "This function cannot be used on constant strings."
2393 msgstr ""
2394
2395 #. type: Plain text
2396 #: build/C/man3/strsep.3:86 build/C/man3/strtok.3:127
2397 msgid "The identity of the delimiting character is lost."
2398 msgstr ""
2399
2400 #. type: Plain text
2401 #: build/C/man3/strsep.3:95
2402 msgid ""
2403 "B<index>(3), B<memchr>(3), B<rindex>(3), B<strchr>(3), B<string>(3), "
2404 "B<strpbrk>(3), B<strspn>(3), B<strstr>(3), B<strtok>(3)"
2405 msgstr ""
2406
2407 #. type: TH
2408 #: build/C/man3/strsignal.3:28
2409 #, no-wrap
2410 msgid "STRSIGNAL"
2411 msgstr ""
2412
2413 #. type: TH
2414 #: build/C/man3/strsignal.3:28
2415 #, no-wrap
2416 msgid "2010-09-15"
2417 msgstr ""
2418
2419 #. type: Plain text
2420 #: build/C/man3/strsignal.3:31
2421 msgid "strsignal - return string describing signal"
2422 msgstr ""
2423
2424 #. type: Plain text
2425 #: build/C/man3/strsignal.3:36
2426 #, no-wrap
2427 msgid "B<char *strsignal(int >I<sig>B<);>\n"
2428 msgstr ""
2429
2430 #. type: Plain text
2431 #: build/C/man3/strsignal.3:38
2432 #, no-wrap
2433 msgid "B<extern const char * const >I<sys_siglist>B<[];>\n"
2434 msgstr ""
2435
2436 #. type: Plain text
2437 #: build/C/man3/strsignal.3:46
2438 msgid "B<strsignal>():"
2439 msgstr ""
2440
2441 #. type: Plain text
2442 #: build/C/man3/strsignal.3:66
2443 msgid ""
2444 "The B<strsignal>()  function returns a string describing the signal number "
2445 "passed in the argument I<sig>.  The string can only be used until the next "
2446 "call to B<strsignal>()."
2447 msgstr ""
2448
2449 #. type: Plain text
2450 #: build/C/man3/strsignal.3:73
2451 msgid ""
2452 "The array I<sys_siglist> holds the signal description strings indexed by "
2453 "signal number.  The B<strsignal>()  function should be used if possible "
2454 "instead of this array."
2455 msgstr ""
2456
2457 #. type: Plain text
2458 #: build/C/man3/strsignal.3:80
2459 msgid ""
2460 "The B<strsignal>()  function returns the appropriate description string, or "
2461 "an unknown signal message if the signal number is invalid.  On some systems "
2462 "(but not on Linux), a NULL pointer may be returned instead for an invalid "
2463 "signal number."
2464 msgstr ""
2465
2466 #. type: Plain text
2467 #: build/C/man3/strsignal.3:83
2468 msgid "POSIX.1-2008.  Present on Solaris and the BSDs."
2469 msgstr ""
2470
2471 #. type: Plain text
2472 #: build/C/man3/strsignal.3:85
2473 msgid "B<psignal>(3), B<strerror>(3)"
2474 msgstr ""
2475
2476 #. type: TH
2477 #: build/C/man3/strspn.3:28
2478 #, no-wrap
2479 msgid "STRSPN"
2480 msgstr ""
2481
2482 #. type: Plain text
2483 #: build/C/man3/strspn.3:31
2484 msgid "strspn, strcspn - search a string for a set of characters"
2485 msgstr ""
2486
2487 #. type: Plain text
2488 #: build/C/man3/strspn.3:45
2489 msgid ""
2490 "The B<strspn>()  function calculates the length of the initial segment of "
2491 "I<s> which consists entirely of characters in I<accept>."
2492 msgstr ""
2493
2494 #. type: Plain text
2495 #: build/C/man3/strspn.3:51
2496 msgid ""
2497 "The B<strcspn>()  function calculates the length of the initial segment of "
2498 "I<s> which consists entirely of characters not in I<reject>."
2499 msgstr ""
2500
2501 #. type: Plain text
2502 #: build/C/man3/strspn.3:57
2503 msgid ""
2504 "The B<strspn>()  function returns the number of characters in the initial "
2505 "segment of I<s> which consist only of characters from I<accept>."
2506 msgstr ""
2507
2508 #. type: Plain text
2509 #: build/C/man3/strspn.3:63
2510 msgid ""
2511 "The B<strcspn>()  function returns the number of characters in the initial "
2512 "segment of I<s> which are not in the string I<reject>."
2513 msgstr ""
2514
2515 #. type: Plain text
2516 #: build/C/man3/strspn.3:76
2517 msgid ""
2518 "B<index>(3), B<memchr>(3), B<rindex>(3), B<strchr>(3), B<string>(3), "
2519 "B<strpbrk>(3), B<strsep>(3), B<strstr>(3), B<strtok>(3), B<wcscspn>(3), "
2520 "B<wcsspn>(3)"
2521 msgstr ""
2522
2523 #. type: TH
2524 #: build/C/man3/strstr.3:31
2525 #, no-wrap
2526 msgid "STRSTR"
2527 msgstr ""
2528
2529 #. type: Plain text
2530 #: build/C/man3/strstr.3:34
2531 msgid "strstr, strcasestr - locate a substring"
2532 msgstr ""
2533
2534 #. type: Plain text
2535 #: build/C/man3/strstr.3:45
2536 #, no-wrap
2537 msgid "B<char *strcasestr(const char *>I<haystack>B<, const char *>I<needle>B<);>\n"
2538 msgstr ""
2539
2540 #. type: Plain text
2541 #: build/C/man3/strstr.3:52
2542 msgid ""
2543 "The B<strstr>()  function finds the first occurrence of the substring "
2544 "I<needle> in the string I<haystack>.  The terminating null bytes "
2545 "(\\(aq\\e0\\(aq) are not compared."
2546 msgstr ""
2547
2548 #. type: Plain text
2549 #: build/C/man3/strstr.3:58
2550 msgid ""
2551 "The B<strcasestr>()  function is like B<strstr>(), but ignores the case of "
2552 "both arguments."
2553 msgstr ""
2554
2555 #. type: Plain text
2556 #: build/C/man3/strstr.3:61
2557 msgid ""
2558 "These functions return a pointer to the beginning of the substring, or NULL "
2559 "if the substring is not found."
2560 msgstr ""
2561
2562 #. type: Plain text
2563 #: build/C/man3/strstr.3:68
2564 msgid ""
2565 "The B<strstr>()  function conforms to C89 and C99.  The B<strcasestr>()  "
2566 "function is a nonstandard extension."
2567 msgstr ""
2568
2569 #. type: Plain text
2570 #: build/C/man3/strstr.3:74
2571 msgid ""
2572 "Early versions of Linux libc (like 4.5.26) would not allow an empty "
2573 "I<needle> argument for B<strstr>().  Later versions (like 4.6.27) work "
2574 "correctly, and return I<haystack> when I<needle> is empty."
2575 msgstr ""
2576
2577 #. type: Plain text
2578 #: build/C/man3/strstr.3:85
2579 msgid ""
2580 "B<index>(3), B<memchr>(3), B<rindex>(3), B<strcasecmp>(3), B<strchr>(3), "
2581 "B<string>(3), B<strpbrk>(3), B<strsep>(3), B<strspn>(3), B<strtok>(3), "
2582 "B<wcsstr>(3)"
2583 msgstr ""
2584
2585 #. type: TH
2586 #: build/C/man3/strtok.3:28
2587 #, no-wrap
2588 msgid "STRTOK"
2589 msgstr ""
2590
2591 #. type: TH
2592 #: build/C/man3/strtok.3:28
2593 #, no-wrap
2594 msgid "2010-09-27"
2595 msgstr ""
2596
2597 #. type: Plain text
2598 #: build/C/man3/strtok.3:31
2599 msgid "strtok, strtok_r - extract tokens from strings"
2600 msgstr ""
2601
2602 #. type: Plain text
2603 #: build/C/man3/strtok.3:36
2604 #, no-wrap
2605 msgid "B<char *strtok(char *>I<str>B<, const char *>I<delim>B<);>\n"
2606 msgstr ""
2607
2608 #. type: Plain text
2609 #: build/C/man3/strtok.3:38
2610 #, no-wrap
2611 msgid ""
2612 "B<char *strtok_r(char *>I<str>B<, const char *>I<delim>B<, char "
2613 "**>I<saveptr>B<);>\n"
2614 msgstr ""
2615
2616 #. type: Plain text
2617 #: build/C/man3/strtok.3:49
2618 msgid ""
2619 "B<strtok_r>(): _SVID_SOURCE || _BSD_SOURCE || _POSIX_C_SOURCE\\ E<gt>=\\ 1 "
2620 "|| _XOPEN_SOURCE || _POSIX_SOURCE"
2621 msgstr ""
2622
2623 #. type: Plain text
2624 #: build/C/man3/strtok.3:60
2625 msgid ""
2626 "The B<strtok>()  function parses a string into a sequence of tokens.  On the "
2627 "first call to B<strtok>()  the string to be parsed should be specified in "
2628 "I<str>.  In each subsequent call that should parse the same string, I<str> "
2629 "should be NULL."
2630 msgstr ""
2631
2632 #. type: Plain text
2633 #: build/C/man3/strtok.3:65
2634 msgid ""
2635 "The I<delim> argument specifies a set of characters that delimit the tokens "
2636 "in the parsed string.  The caller may specify different strings in I<delim> "
2637 "in successive calls that parse the same string."
2638 msgstr ""
2639
2640 #. type: Plain text
2641 #: build/C/man3/strtok.3:74
2642 msgid ""
2643 "Each call to B<strtok>()  returns a pointer to a null-terminated string "
2644 "containing the next token.  This string does not include the delimiting "
2645 "character.  If no more tokens are found, B<strtok>()  returns NULL."
2646 msgstr ""
2647
2648 #. type: Plain text
2649 #: build/C/man3/strtok.3:81
2650 msgid ""
2651 "A sequence of two or more contiguous delimiter characters in the parsed "
2652 "string is considered to be a single delimiter.  Delimiter characters at the "
2653 "start or end of the string are ignored.  Put another way: the tokens "
2654 "returned by B<strtok>()  are always nonempty strings."
2655 msgstr ""
2656
2657 #. type: Plain text
2658 #: build/C/man3/strtok.3:91
2659 msgid ""
2660 "The B<strtok_r>()  function is a reentrant version B<strtok>().  The "
2661 "I<saveptr> argument is a pointer to a I<char *> variable that is used "
2662 "internally by B<strtok_r>()  in order to maintain context between successive "
2663 "calls that parse the same string."
2664 msgstr ""
2665
2666 #. type: Plain text
2667 #: build/C/man3/strtok.3:100
2668 msgid ""
2669 "On the first call to B<strtok_r>(), I<str> should point to the string to be "
2670 "parsed, and the value of I<saveptr> is ignored.  In subsequent calls, I<str> "
2671 "should be NULL, and I<saveptr> should be unchanged since the previous call."
2672 msgstr ""
2673
2674 #. type: Plain text
2675 #: build/C/man3/strtok.3:104
2676 msgid ""
2677 "Different strings may be parsed concurrently using sequences of calls to "
2678 "B<strtok_r>()  that specify different I<saveptr> arguments."
2679 msgstr ""
2680
2681 #. type: Plain text
2682 #: build/C/man3/strtok.3:111
2683 msgid ""
2684 "The B<strtok>()  and B<strtok_r>()  functions return a pointer to the next "
2685 "token, or NULL if there are no more tokens."
2686 msgstr ""
2687
2688 #. type: TP
2689 #: build/C/man3/strtok.3:112
2690 #, no-wrap
2691 msgid "B<strtok>()"
2692 msgstr ""
2693
2694 #. type: Plain text
2695 #: build/C/man3/strtok.3:115
2696 msgid "SVr4, POSIX.1-2001, 4.3BSD, C89, C99."
2697 msgstr ""
2698
2699 #. type: TP
2700 #: build/C/man3/strtok.3:115
2701 #, no-wrap
2702 msgid "B<strtok_r>()"
2703 msgstr ""
2704
2705 #. type: Plain text
2706 #: build/C/man3/strtok.3:118
2707 msgid "POSIX.1-2001."
2708 msgstr ""
2709
2710 #. type: Plain text
2711 #: build/C/man3/strtok.3:121
2712 msgid "Be cautious when using these functions.  If you do use them, note that:"
2713 msgstr ""
2714
2715 #. type: Plain text
2716 #: build/C/man3/strtok.3:123
2717 msgid "These functions modify their first argument."
2718 msgstr ""
2719
2720 #. type: Plain text
2721 #: build/C/man3/strtok.3:125
2722 msgid "These functions cannot be used on constant strings."
2723 msgstr ""
2724
2725 #. type: Plain text
2726 #: build/C/man3/strtok.3:134
2727 msgid ""
2728 "The B<strtok>()  function uses a static buffer while parsing, so it's not "
2729 "thread safe.  Use B<strtok_r>()  if this matters to you."
2730 msgstr ""
2731
2732 #. type: Plain text
2733 #: build/C/man3/strtok.3:143
2734 msgid ""
2735 "The program below uses nested loops that employ B<strtok_r>()  to break a "
2736 "string into a two-level hierarchy of tokens.  The first command-line "
2737 "argument specifies the string to be parsed.  The second argument specifies "
2738 "the delimiter character(s)  to be used to separate that string into "
2739 "\"major\" tokens.  The third argument specifies the delimiter character(s)  "
2740 "to be used to separate the \"major\" tokens into subtokens."
2741 msgstr ""
2742
2743 #. type: Plain text
2744 #: build/C/man3/strtok.3:145
2745 msgid "An example of the output produced by this program is the following:"
2746 msgstr ""
2747
2748 #. type: Plain text
2749 #: build/C/man3/strtok.3:157
2750 #, no-wrap
2751 msgid ""
2752 "$B< ./a.out \\(aqa/bbb///cc;xxx:yyy:\\(aq \\(aq:;\\(aq \\(aq/\\(aq>\n"
2753 "1: a/bbb///cc\n"
2754 "         --E<gt> a\n"
2755 "         --E<gt> bbb\n"
2756 "         --E<gt> cc\n"
2757 "2: xxx\n"
2758 "         --E<gt> xxx\n"
2759 "3: yyy\n"
2760 "         --E<gt> yyy\n"
2761 msgstr ""
2762
2763 #. type: SS
2764 #: build/C/man3/strtok.3:159
2765 #, no-wrap
2766 msgid "Program source"
2767 msgstr ""
2768
2769 #. type: Plain text
2770 #: build/C/man3/strtok.3:165
2771 #, no-wrap
2772 msgid ""
2773 "#include E<lt>stdio.hE<gt>\n"
2774 "#include E<lt>stdlib.hE<gt>\n"
2775 "#include E<lt>string.hE<gt>\n"
2776 msgstr ""
2777
2778 #. type: Plain text
2779 #: build/C/man3/strtok.3:172
2780 #, no-wrap
2781 msgid ""
2782 "int\n"
2783 "main(int argc, char *argv[])\n"
2784 "{\n"
2785 "    char *str1, *str2, *token, *subtoken;\n"
2786 "    char *saveptr1, *saveptr2;\n"
2787 "    int j;\n"
2788 msgstr ""
2789
2790 #. type: Plain text
2791 #: build/C/man3/strtok.3:178
2792 #, no-wrap
2793 msgid ""
2794 "    if (argc != 4) {\n"
2795 "        fprintf(stderr, \"Usage: %s string delim subdelim\\en\",\n"
2796 "                argv[0]);\n"
2797 "        exit(EXIT_FAILURE);\n"
2798 "    }\n"
2799 msgstr ""
2800
2801 #. type: Plain text
2802 #: build/C/man3/strtok.3:184
2803 #, no-wrap
2804 msgid ""
2805 "    for (j = 1, str1 = argv[1]; ; j++, str1 = NULL) {\n"
2806 "        token = strtok_r(str1, argv[2], &saveptr1);\n"
2807 "        if (token == NULL)\n"
2808 "            break;\n"
2809 "        printf(\"%d: %s\\en\", j, token);\n"
2810 msgstr ""
2811
2812 #. type: Plain text
2813 #: build/C/man3/strtok.3:192
2814 #, no-wrap
2815 msgid ""
2816 "        for (str2 = token; ; str2 = NULL) {\n"
2817 "            subtoken = strtok_r(str2, argv[3], &saveptr2);\n"
2818 "            if (subtoken == NULL)\n"
2819 "                break;\n"
2820 "            printf(\"\\t --E<gt> %s\\en\", subtoken);\n"
2821 "        }\n"
2822 "    }\n"
2823 msgstr ""
2824
2825 #. type: Plain text
2826 #: build/C/man3/strtok.3:195
2827 #, no-wrap
2828 msgid ""
2829 "    exit(EXIT_SUCCESS);\n"
2830 "}\n"
2831 msgstr ""
2832
2833 #. type: Plain text
2834 #: build/C/man3/strtok.3:201
2835 msgid ""
2836 "Another example program using B<strtok>()  can be found in "
2837 "B<getaddrinfo_a>(3)."
2838 msgstr ""
2839
2840 #. type: Plain text
2841 #: build/C/man3/strtok.3:211
2842 msgid ""
2843 "B<index>(3), B<memchr>(3), B<rindex>(3), B<strchr>(3), B<string>(3), "
2844 "B<strpbrk>(3), B<strsep>(3), B<strspn>(3), B<strstr>(3), B<wcstok>(3)"
2845 msgstr ""
2846
2847 #. type: TH
2848 #: build/C/man3/strverscmp.3:23
2849 #, no-wrap
2850 msgid "STRVERSCMP"
2851 msgstr ""
2852
2853 #. type: TH
2854 #: build/C/man3/strverscmp.3:23
2855 #, no-wrap
2856 msgid "2001-12-19"
2857 msgstr ""
2858
2859 #. type: Plain text
2860 #: build/C/man3/strverscmp.3:26
2861 msgid "strverscmp - compare two version strings"
2862 msgstr ""
2863
2864 #. type: Plain text
2865 #: build/C/man3/strverscmp.3:33
2866 #, no-wrap
2867 msgid "B<int strverscmp(const char *>I<s1>B<, const char *>I<s2>B<);>\n"
2868 msgstr ""
2869
2870 #.  classical solution: "rename jan jan0 jan?"
2871 #. type: Plain text
2872 #: build/C/man3/strverscmp.3:50
2873 msgid ""
2874 "Often one has files I<jan1>, I<jan2>, ..., I<jan9>, I<jan10>, ...  and it "
2875 "feels wrong when B<ls>(1)  orders them I<jan1>, I<jan10>, ..., I<jan2>, ..., "
2876 "I<jan9>.  In order to rectify this, GNU introduced the I<-v> option to "
2877 "B<ls>(1), which is implemented using B<versionsort>(3), which again uses "
2878 "B<strverscmp>()."
2879 msgstr ""
2880
2881 #. type: Plain text
2882 #: build/C/man3/strverscmp.3:61
2883 msgid ""
2884 "Thus, the task of B<strverscmp>()  is to compare two strings and find the "
2885 "\"right\" order, while B<strcmp>(3)  only finds the lexicographic order.  "
2886 "This function does not use the locale category B<LC_COLLATE>, so is meant "
2887 "mostly for situations where the strings are expected to be in ASCII."
2888 msgstr ""
2889
2890 #. type: Plain text
2891 #: build/C/man3/strverscmp.3:79
2892 msgid ""
2893 "What this function does is the following.  If both strings are equal, return "
2894 "0.  Otherwise find the position between two bytes with the property that "
2895 "before it both strings are equal, while directly after it there is a "
2896 "difference.  Find the largest consecutive digit strings containing (or "
2897 "starting at, or ending at) this position.  If one or both of these is empty, "
2898 "then return what B<strcmp>(3)  would have returned (numerical ordering of "
2899 "byte values).  Otherwise, compare both digit strings numerically, where "
2900 "digit strings with one or more leading zeros are interpreted as if they have "
2901 "a decimal point in front (so that in particular digit strings with more "
2902 "leading zeros come before digit strings with fewer leading zeros).  Thus, "
2903 "the ordering is I<000>, I<00>, I<01>, I<010>, I<09>, I<0>, I<1>, I<9>, "
2904 "I<10>."
2905 msgstr ""
2906
2907 #. type: Plain text
2908 #: build/C/man3/strverscmp.3:86
2909 msgid ""
2910 "The B<strverscmp>()  function returns an integer less than, equal to, or "
2911 "greater than zero if I<s1> is found, respectively, to be earlier than, equal "
2912 "to, or later than I<s2>."
2913 msgstr ""
2914
2915 #. type: Plain text
2916 #: build/C/man3/strverscmp.3:92
2917 msgid "B<rename>(1), B<strcasecmp>(3), B<strcmp>(3), B<strcoll>(3)"
2918 msgstr ""
2919
2920 #. type: TH
2921 #: build/C/man3/strxfrm.3:28
2922 #, no-wrap
2923 msgid "STRXFRM"
2924 msgstr ""
2925
2926 #. type: Plain text
2927 #: build/C/man3/strxfrm.3:31
2928 msgid "strxfrm - string transformation"
2929 msgstr ""
2930
2931 #. type: Plain text
2932 #: build/C/man3/strxfrm.3:54
2933 msgid ""
2934 "The B<strxfrm>()  function transforms the I<src> string into a form such "
2935 "that the result of B<strcmp>(3)  on two strings that have been transformed "
2936 "with B<strxfrm>()  is the same as the result of B<strcoll>(3)  on the two "
2937 "strings before their transformation.  The first I<n> characters of the "
2938 "transformed string are placed in I<dest>.  The transformation is based on "
2939 "the program's current locale for category B<LC_COLLATE>.  (See "
2940 "B<setlocale>(3))."
2941 msgstr ""
2942
2943 #. type: Plain text
2944 #: build/C/man3/strxfrm.3:62
2945 msgid ""
2946 "The B<strxfrm>()  function returns the number of bytes required to store the "
2947 "transformed string in I<dest> excluding the terminating null byte "
2948 "(\\(aq\\e0\\(aq).  If the value returned is I<n> or more, the contents of "
2949 "I<dest> are indeterminate."
2950 msgstr ""
2951
2952 #. type: Plain text
2953 #: build/C/man3/strxfrm.3:70
2954 msgid ""
2955 "In the I<\"POSIX\"> or I<\"C\"> locales B<strxfrm>()  is equivalent to "
2956 "copying the string with B<strncpy>(3)."
2957 msgstr ""
2958
2959 #. type: Plain text
2960 #: build/C/man3/strxfrm.3:77
2961 msgid ""
2962 "B<bcmp>(3), B<memcmp>(3), B<setlocale>(3), B<strcasecmp>(3), B<strcmp>(3), "
2963 "B<strcoll>(3), B<string>(3)"
2964 msgstr ""