OSDN Git Service

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