po4a/string/po/string.pot

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