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