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