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