lib/string.in.h

   1 /* A GNU-like <string.h>.
   2
   3    Copyright (C) 1995-1996, 2001-2013 Free Software Foundation, Inc.
   4
   5    This program is free software; you can redistribute it and/or modify
   6    it under the terms of the GNU General Public License as published by
   7    the Free Software Foundation; either version 3, or (at your option)
   8    any later version.
   9
  10    This program is distributed in the hope that it will be useful,
  11    but WITHOUT ANY WARRANTY; without even the implied warranty of
  12    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  13    GNU General Public License for more details.
  14
  15    You should have received a copy of the GNU General Public License
  16    along with this program; if not, see <http://www.gnu.org/licenses/>.  */
  17
  18 #ifndef _@GUARD_PREFIX@_STRING_H
  19
  20 #if __GNUC__ >= 3
  21 @PRAGMA_SYSTEM_HEADER@
  22 #endif
  23 @PRAGMA_COLUMNS@
  24
  25 /* The include_next requires a split double-inclusion guard.  */
  26 #@INCLUDE_NEXT@ @NEXT_STRING_H@
  27
  28 #ifndef _@GUARD_PREFIX@_STRING_H
  29 #define _@GUARD_PREFIX@_STRING_H
  30
  31 /* NetBSD 5.0 mis-defines NULL.  */
  32 #include <stddef.h>
  33
  34 /* MirBSD defines mbslen as a macro.  */
  35 #if @GNULIB_MBSLEN@ && defined __MirBSD__
  36 # include <wchar.h>
  37 #endif
  38
  39 /* The __attribute__ feature is available in gcc versions 2.5 and later.
  40    The attribute __pure__ was added in gcc 2.96.  */
  41 #if __GNUC__ > 2 || (__GNUC__ == 2 && __GNUC_MINOR__ >= 96)
  42 # define _GL_ATTRIBUTE_PURE __attribute__ ((__pure__))
  43 #else
  44 # define _GL_ATTRIBUTE_PURE /* empty */
  45 #endif
  46
  47 /* NetBSD 5.0 declares strsignal in <unistd.h>, not in <string.h>.  */
  48 /* But in any case avoid namespace pollution on glibc systems.  */
  49 #if (@GNULIB_STRSIGNAL@ || defined GNULIB_POSIXCHECK) && defined __NetBSD__ \
  50     && ! defined __GLIBC__
  51 # include <unistd.h>
  52 #endif
  53
  54 /* The definitions of _GL_FUNCDECL_RPL etc. are copied here.  */
  55
  56 /* The definition of _GL_ARG_NONNULL is copied here.  */
  57
  58 /* The definition of _GL_WARN_ON_USE is copied here.  */
  59
  60
  61 /* Find the index of the least-significant set bit.  */
  62 #if @GNULIB_FFSL@
  63 # if !@HAVE_FFSL@
  64 _GL_FUNCDECL_SYS (ffsl, int, (long int i));
  65 # endif
  66 _GL_CXXALIAS_SYS (ffsl, int, (long int i));
  67 _GL_CXXALIASWARN (ffsl);
  68 #elif defined GNULIB_POSIXCHECK
  69 # undef ffsl
  70 # if HAVE_RAW_DECL_FFSL
  71 _GL_WARN_ON_USE (ffsl, "ffsl is not portable - use the ffsl module");
  72 # endif
  73 #endif
  74
  75
  76 /* Find the index of the least-significant set bit.  */
  77 #if @GNULIB_FFSLL@
  78 # if !@HAVE_FFSLL@
  79 _GL_FUNCDECL_SYS (ffsll, int, (long long int i));
  80 # endif
  81 _GL_CXXALIAS_SYS (ffsll, int, (long long int i));
  82 _GL_CXXALIASWARN (ffsll);
  83 #elif defined GNULIB_POSIXCHECK
  84 # undef ffsll
  85 # if HAVE_RAW_DECL_FFSLL
  86 _GL_WARN_ON_USE (ffsll, "ffsll is not portable - use the ffsll module");
  87 # endif
  88 #endif
  89
  90
  91 /* Return the first instance of C within N bytes of S, or NULL.  */
  92 #if @GNULIB_MEMCHR@
  93 # if @REPLACE_MEMCHR@
  94 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
  95 #   define memchr rpl_memchr
  96 #  endif
  97 _GL_FUNCDECL_RPL (memchr, void *, (void const *__s, int __c, size_t __n)
  98                                   _GL_ATTRIBUTE_PURE
  99                                   _GL_ARG_NONNULL ((1)));
 100 _GL_CXXALIAS_RPL (memchr, void *, (void const *__s, int __c, size_t __n));
 101 # else
 102 #  if ! @HAVE_MEMCHR@
 103 _GL_FUNCDECL_SYS (memchr, void *, (void const *__s, int __c, size_t __n)
 104                                   _GL_ATTRIBUTE_PURE
 105                                   _GL_ARG_NONNULL ((1)));
 106 #  endif
 107   /* On some systems, this function is defined as an overloaded function:
 108        extern "C" { const void * std::memchr (const void *, int, size_t); }
 109        extern "C++" { void * std::memchr (void *, int, size_t); }  */
 110 _GL_CXXALIAS_SYS_CAST2 (memchr,
 111                         void *, (void const *__s, int __c, size_t __n),
 112                         void const *, (void const *__s, int __c, size_t __n));
 113 # endif
 114 # if ((__GLIBC__ == 2 && __GLIBC_MINOR__ >= 10) && !defined __UCLIBC__) \
 115      && (__GNUC__ > 4 || (__GNUC__ == 4 && __GNUC_MINOR__ >= 4))
 116 _GL_CXXALIASWARN1 (memchr, void *, (void *__s, int __c, size_t __n));
 117 _GL_CXXALIASWARN1 (memchr, void const *,
 118                    (void const *__s, int __c, size_t __n));
 119 # else
 120 _GL_CXXALIASWARN (memchr);
 121 # endif
 122 #elif defined GNULIB_POSIXCHECK
 123 # undef memchr
 124 /* Assume memchr is always declared.  */
 125 _GL_WARN_ON_USE (memchr, "memchr has platform-specific bugs - "
 126                  "use gnulib module memchr for portability" );
 127 #endif
 128
 129 /* Return the first occurrence of NEEDLE in HAYSTACK.  */
 130 #if @GNULIB_MEMMEM@
 131 # if @REPLACE_MEMMEM@
 132 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
 133 #   define memmem rpl_memmem
 134 #  endif
 135 _GL_FUNCDECL_RPL (memmem, void *,
 136                   (void const *__haystack, size_t __haystack_len,
 137                    void const *__needle, size_t __needle_len)
 138                   _GL_ATTRIBUTE_PURE
 139                   _GL_ARG_NONNULL ((1, 3)));
 140 _GL_CXXALIAS_RPL (memmem, void *,
 141                   (void const *__haystack, size_t __haystack_len,
 142                    void const *__needle, size_t __needle_len));
 143 # else
 144 #  if ! @HAVE_DECL_MEMMEM@
 145 _GL_FUNCDECL_SYS (memmem, void *,
 146                   (void const *__haystack, size_t __haystack_len,
 147                    void const *__needle, size_t __needle_len)
 148                   _GL_ATTRIBUTE_PURE
 149                   _GL_ARG_NONNULL ((1, 3)));
 150 #  endif
 151 _GL_CXXALIAS_SYS (memmem, void *,
 152                   (void const *__haystack, size_t __haystack_len,
 153                    void const *__needle, size_t __needle_len));
 154 # endif
 155 _GL_CXXALIASWARN (memmem);
 156 #elif defined GNULIB_POSIXCHECK
 157 # undef memmem
 158 # if HAVE_RAW_DECL_MEMMEM
 159 _GL_WARN_ON_USE (memmem, "memmem is unportable and often quadratic - "
 160                  "use gnulib module memmem-simple for portability, "
 161                  "and module memmem for speed" );
 162 # endif
 163 #endif
 164
 165 /* Copy N bytes of SRC to DEST, return pointer to bytes after the
 166    last written byte.  */
 167 #if @GNULIB_MEMPCPY@
 168 # if ! @HAVE_MEMPCPY@
 169 _GL_FUNCDECL_SYS (mempcpy, void *,
 170                   (void *restrict __dest, void const *restrict __src,
 171                    size_t __n)
 172                   _GL_ARG_NONNULL ((1, 2)));
 173 # endif
 174 _GL_CXXALIAS_SYS (mempcpy, void *,
 175                   (void *restrict __dest, void const *restrict __src,
 176                    size_t __n));
 177 _GL_CXXALIASWARN (mempcpy);
 178 #elif defined GNULIB_POSIXCHECK
 179 # undef mempcpy
 180 # if HAVE_RAW_DECL_MEMPCPY
 181 _GL_WARN_ON_USE (mempcpy, "mempcpy is unportable - "
 182                  "use gnulib module mempcpy for portability");
 183 # endif
 184 #endif
 185
 186 /* Search backwards through a block for a byte (specified as an int).  */
 187 #if @GNULIB_MEMRCHR@
 188 # if ! @HAVE_DECL_MEMRCHR@
 189 _GL_FUNCDECL_SYS (memrchr, void *, (void const *, int, size_t)
 190                                    _GL_ATTRIBUTE_PURE
 191                                    _GL_ARG_NONNULL ((1)));
 192 # endif
 193   /* On some systems, this function is defined as an overloaded function:
 194        extern "C++" { const void * std::memrchr (const void *, int, size_t); }
 195        extern "C++" { void * std::memrchr (void *, int, size_t); }  */
 196 _GL_CXXALIAS_SYS_CAST2 (memrchr,
 197                         void *, (void const *, int, size_t),
 198                         void const *, (void const *, int, size_t));
 199 # if ((__GLIBC__ == 2 && __GLIBC_MINOR__ >= 10) && !defined __UCLIBC__) \
 200      && (__GNUC__ > 4 || (__GNUC__ == 4 && __GNUC_MINOR__ >= 4))
 201 _GL_CXXALIASWARN1 (memrchr, void *, (void *, int, size_t));
 202 _GL_CXXALIASWARN1 (memrchr, void const *, (void const *, int, size_t));
 203 # else
 204 _GL_CXXALIASWARN (memrchr);
 205 # endif
 206 #elif defined GNULIB_POSIXCHECK
 207 # undef memrchr
 208 # if HAVE_RAW_DECL_MEMRCHR
 209 _GL_WARN_ON_USE (memrchr, "memrchr is unportable - "
 210                  "use gnulib module memrchr for portability");
 211 # endif
 212 #endif
 213
 214 /* Find the first occurrence of C in S.  More efficient than
 215    memchr(S,C,N), at the expense of undefined behavior if C does not
 216    occur within N bytes.  */
 217 #if @GNULIB_RAWMEMCHR@
 218 # if ! @HAVE_RAWMEMCHR@
 219 _GL_FUNCDECL_SYS (rawmemchr, void *, (void const *__s, int __c_in)
 220                                      _GL_ATTRIBUTE_PURE
 221                                      _GL_ARG_NONNULL ((1)));
 222 # endif
 223   /* On some systems, this function is defined as an overloaded function:
 224        extern "C++" { const void * std::rawmemchr (const void *, int); }
 225        extern "C++" { void * std::rawmemchr (void *, int); }  */
 226 _GL_CXXALIAS_SYS_CAST2 (rawmemchr,
 227                         void *, (void const *__s, int __c_in),
 228                         void const *, (void const *__s, int __c_in));
 229 # if ((__GLIBC__ == 2 && __GLIBC_MINOR__ >= 10) && !defined __UCLIBC__) \
 230      && (__GNUC__ > 4 || (__GNUC__ == 4 && __GNUC_MINOR__ >= 4))
 231 _GL_CXXALIASWARN1 (rawmemchr, void *, (void *__s, int __c_in));
 232 _GL_CXXALIASWARN1 (rawmemchr, void const *, (void const *__s, int __c_in));
 233 # else
 234 _GL_CXXALIASWARN (rawmemchr);
 235 # endif
 236 #elif defined GNULIB_POSIXCHECK
 237 # undef rawmemchr
 238 # if HAVE_RAW_DECL_RAWMEMCHR
 239 _GL_WARN_ON_USE (rawmemchr, "rawmemchr is unportable - "
 240                  "use gnulib module rawmemchr for portability");
 241 # endif
 242 #endif
 243
 244 /* Copy SRC to DST, returning the address of the terminating '\0' in DST.  */
 245 #if @GNULIB_STPCPY@
 246 # if ! @HAVE_STPCPY@
 247 _GL_FUNCDECL_SYS (stpcpy, char *,
 248                   (char *restrict __dst, char const *restrict __src)
 249                   _GL_ARG_NONNULL ((1, 2)));
 250 # endif
 251 _GL_CXXALIAS_SYS (stpcpy, char *,
 252                   (char *restrict __dst, char const *restrict __src));
 253 _GL_CXXALIASWARN (stpcpy);
 254 #elif defined GNULIB_POSIXCHECK
 255 # undef stpcpy
 256 # if HAVE_RAW_DECL_STPCPY
 257 _GL_WARN_ON_USE (stpcpy, "stpcpy is unportable - "
 258                  "use gnulib module stpcpy for portability");
 259 # endif
 260 #endif
 261
 262 /* Copy no more than N bytes of SRC to DST, returning a pointer past the
 263    last non-NUL byte written into DST.  */
 264 #if @GNULIB_STPNCPY@
 265 # if @REPLACE_STPNCPY@
 266 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
 267 #   undef stpncpy
 268 #   define stpncpy rpl_stpncpy
 269 #  endif
 270 _GL_FUNCDECL_RPL (stpncpy, char *,
 271                   (char *restrict __dst, char const *restrict __src,
 272                    size_t __n)
 273                   _GL_ARG_NONNULL ((1, 2)));
 274 _GL_CXXALIAS_RPL (stpncpy, char *,
 275                   (char *restrict __dst, char const *restrict __src,
 276                    size_t __n));
 277 # else
 278 #  if ! @HAVE_STPNCPY@
 279 _GL_FUNCDECL_SYS (stpncpy, char *,
 280                   (char *restrict __dst, char const *restrict __src,
 281                    size_t __n)
 282                   _GL_ARG_NONNULL ((1, 2)));
 283 #  endif
 284 _GL_CXXALIAS_SYS (stpncpy, char *,
 285                   (char *restrict __dst, char const *restrict __src,
 286                    size_t __n));
 287 # endif
 288 _GL_CXXALIASWARN (stpncpy);
 289 #elif defined GNULIB_POSIXCHECK
 290 # undef stpncpy
 291 # if HAVE_RAW_DECL_STPNCPY
 292 _GL_WARN_ON_USE (stpncpy, "stpncpy is unportable - "
 293                  "use gnulib module stpncpy for portability");
 294 # endif
 295 #endif
 296
 297 #if defined GNULIB_POSIXCHECK
 298 /* strchr() does not work with multibyte strings if the locale encoding is
 299    GB18030 and the character to be searched is a digit.  */
 300 # undef strchr
 301 /* Assume strchr is always declared.  */
 302 _GL_WARN_ON_USE (strchr, "strchr cannot work correctly on character strings "
 303                  "in some multibyte locales - "
 304                  "use mbschr if you care about internationalization");
 305 #endif
 306
 307 /* Find the first occurrence of C in S or the final NUL byte.  */
 308 #if @GNULIB_STRCHRNUL@
 309 # if @REPLACE_STRCHRNUL@
 310 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
 311 #   define strchrnul rpl_strchrnul
 312 #  endif
 313 _GL_FUNCDECL_RPL (strchrnul, char *, (const char *__s, int __c_in)
 314                                      _GL_ATTRIBUTE_PURE
 315                                      _GL_ARG_NONNULL ((1)));
 316 _GL_CXXALIAS_RPL (strchrnul, char *,
 317                   (const char *str, int ch));
 318 # else
 319 #  if ! @HAVE_STRCHRNUL@
 320 _GL_FUNCDECL_SYS (strchrnul, char *, (char const *__s, int __c_in)
 321                                      _GL_ATTRIBUTE_PURE
 322                                      _GL_ARG_NONNULL ((1)));
 323 #  endif
 324   /* On some systems, this function is defined as an overloaded function:
 325        extern "C++" { const char * std::strchrnul (const char *, int); }
 326        extern "C++" { char * std::strchrnul (char *, int); }  */
 327 _GL_CXXALIAS_SYS_CAST2 (strchrnul,
 328                         char *, (char const *__s, int __c_in),
 329                         char const *, (char const *__s, int __c_in));
 330 # endif
 331 # if ((__GLIBC__ == 2 && __GLIBC_MINOR__ >= 10) && !defined __UCLIBC__) \
 332      && (__GNUC__ > 4 || (__GNUC__ == 4 && __GNUC_MINOR__ >= 4))
 333 _GL_CXXALIASWARN1 (strchrnul, char *, (char *__s, int __c_in));
 334 _GL_CXXALIASWARN1 (strchrnul, char const *, (char const *__s, int __c_in));
 335 # else
 336 _GL_CXXALIASWARN (strchrnul);
 337 # endif
 338 #elif defined GNULIB_POSIXCHECK
 339 # undef strchrnul
 340 # if HAVE_RAW_DECL_STRCHRNUL
 341 _GL_WARN_ON_USE (strchrnul, "strchrnul is unportable - "
 342                  "use gnulib module strchrnul for portability");
 343 # endif
 344 #endif
 345
 346 /* Duplicate S, returning an identical malloc'd string.  */
 347 #if @GNULIB_STRDUP@
 348 # if @REPLACE_STRDUP@
 349 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
 350 #   undef strdup
 351 #   define strdup rpl_strdup
 352 #  endif
 353 _GL_FUNCDECL_RPL (strdup, char *, (char const *__s) _GL_ARG_NONNULL ((1)));
 354 _GL_CXXALIAS_RPL (strdup, char *, (char const *__s));
 355 # else
 356 #  if defined __cplusplus && defined GNULIB_NAMESPACE && defined strdup
 357     /* strdup exists as a function and as a macro.  Get rid of the macro.  */
 358 #   undef strdup
 359 #  endif
 360 #  if !(@HAVE_DECL_STRDUP@ || defined strdup)
 361 _GL_FUNCDECL_SYS (strdup, char *, (char const *__s) _GL_ARG_NONNULL ((1)));
 362 #  endif
 363 _GL_CXXALIAS_SYS (strdup, char *, (char const *__s));
 364 # endif
 365 _GL_CXXALIASWARN (strdup);
 366 #elif defined GNULIB_POSIXCHECK
 367 # undef strdup
 368 # if HAVE_RAW_DECL_STRDUP
 369 _GL_WARN_ON_USE (strdup, "strdup is unportable - "
 370                  "use gnulib module strdup for portability");
 371 # endif
 372 #endif
 373
 374 /* Append no more than N characters from SRC onto DEST.  */
 375 #if @GNULIB_STRNCAT@
 376 # if @REPLACE_STRNCAT@
 377 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
 378 #   undef strncat
 379 #   define strncat rpl_strncat
 380 #  endif
 381 _GL_FUNCDECL_RPL (strncat, char *, (char *dest, const char *src, size_t n)
 382                                    _GL_ARG_NONNULL ((1, 2)));
 383 _GL_CXXALIAS_RPL (strncat, char *, (char *dest, const char *src, size_t n));
 384 # else
 385 _GL_CXXALIAS_SYS (strncat, char *, (char *dest, const char *src, size_t n));
 386 # endif
 387 _GL_CXXALIASWARN (strncat);
 388 #elif defined GNULIB_POSIXCHECK
 389 # undef strncat
 390 # if HAVE_RAW_DECL_STRNCAT
 391 _GL_WARN_ON_USE (strncat, "strncat is unportable - "
 392                  "use gnulib module strncat for portability");
 393 # endif
 394 #endif
 395
 396 /* Return a newly allocated copy of at most N bytes of STRING.  */
 397 #if @GNULIB_STRNDUP@
 398 # if @REPLACE_STRNDUP@
 399 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
 400 #   undef strndup
 401 #   define strndup rpl_strndup
 402 #  endif
 403 _GL_FUNCDECL_RPL (strndup, char *, (char const *__string, size_t __n)
 404                                    _GL_ARG_NONNULL ((1)));
 405 _GL_CXXALIAS_RPL (strndup, char *, (char const *__string, size_t __n));
 406 # else
 407 #  if ! @HAVE_DECL_STRNDUP@
 408 _GL_FUNCDECL_SYS (strndup, char *, (char const *__string, size_t __n)
 409                                    _GL_ARG_NONNULL ((1)));
 410 #  endif
 411 _GL_CXXALIAS_SYS (strndup, char *, (char const *__string, size_t __n));
 412 # endif
 413 _GL_CXXALIASWARN (strndup);
 414 #elif defined GNULIB_POSIXCHECK
 415 # undef strndup
 416 # if HAVE_RAW_DECL_STRNDUP
 417 _GL_WARN_ON_USE (strndup, "strndup is unportable - "
 418                  "use gnulib module strndup for portability");
 419 # endif
 420 #endif
 421
 422 /* Find the length (number of bytes) of STRING, but scan at most
 423    MAXLEN bytes.  If no '\0' terminator is found in that many bytes,
 424    return MAXLEN.  */
 425 #if @GNULIB_STRNLEN@
 426 # if @REPLACE_STRNLEN@
 427 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
 428 #   undef strnlen
 429 #   define strnlen rpl_strnlen
 430 #  endif
 431 _GL_FUNCDECL_RPL (strnlen, size_t, (char const *__string, size_t __maxlen)
 432                                    _GL_ATTRIBUTE_PURE
 433                                    _GL_ARG_NONNULL ((1)));
 434 _GL_CXXALIAS_RPL (strnlen, size_t, (char const *__string, size_t __maxlen));
 435 # else
 436 #  if ! @HAVE_DECL_STRNLEN@
 437 _GL_FUNCDECL_SYS (strnlen, size_t, (char const *__string, size_t __maxlen)
 438                                    _GL_ATTRIBUTE_PURE
 439                                    _GL_ARG_NONNULL ((1)));
 440 #  endif
 441 _GL_CXXALIAS_SYS (strnlen, size_t, (char const *__string, size_t __maxlen));
 442 # endif
 443 _GL_CXXALIASWARN (strnlen);
 444 #elif defined GNULIB_POSIXCHECK
 445 # undef strnlen
 446 # if HAVE_RAW_DECL_STRNLEN
 447 _GL_WARN_ON_USE (strnlen, "strnlen is unportable - "
 448                  "use gnulib module strnlen for portability");
 449 # endif
 450 #endif
 451
 452 #if defined GNULIB_POSIXCHECK
 453 /* strcspn() assumes the second argument is a list of single-byte characters.
 454    Even in this simple case, it does not work with multibyte strings if the
 455    locale encoding is GB18030 and one of the characters to be searched is a
 456    digit.  */
 457 # undef strcspn
 458 /* Assume strcspn is always declared.  */
 459 _GL_WARN_ON_USE (strcspn, "strcspn cannot work correctly on character strings "
 460                  "in multibyte locales - "
 461                  "use mbscspn if you care about internationalization");
 462 #endif
 463
 464 /* Find the first occurrence in S of any character in ACCEPT.  */
 465 #if @GNULIB_STRPBRK@
 466 # if ! @HAVE_STRPBRK@
 467 _GL_FUNCDECL_SYS (strpbrk, char *, (char const *__s, char const *__accept)
 468                                    _GL_ATTRIBUTE_PURE
 469                                    _GL_ARG_NONNULL ((1, 2)));
 470 # endif
 471   /* On some systems, this function is defined as an overloaded function:
 472        extern "C" { const char * strpbrk (const char *, const char *); }
 473        extern "C++" { char * strpbrk (char *, const char *); }  */
 474 _GL_CXXALIAS_SYS_CAST2 (strpbrk,
 475                         char *, (char const *__s, char const *__accept),
 476                         const char *, (char const *__s, char const *__accept));
 477 # if ((__GLIBC__ == 2 && __GLIBC_MINOR__ >= 10) && !defined __UCLIBC__) \
 478      && (__GNUC__ > 4 || (__GNUC__ == 4 && __GNUC_MINOR__ >= 4))
 479 _GL_CXXALIASWARN1 (strpbrk, char *, (char *__s, char const *__accept));
 480 _GL_CXXALIASWARN1 (strpbrk, char const *,
 481                    (char const *__s, char const *__accept));
 482 # else
 483 _GL_CXXALIASWARN (strpbrk);
 484 # endif
 485 # if defined GNULIB_POSIXCHECK
 486 /* strpbrk() assumes the second argument is a list of single-byte characters.
 487    Even in this simple case, it does not work with multibyte strings if the
 488    locale encoding is GB18030 and one of the characters to be searched is a
 489    digit.  */
 490 #  undef strpbrk
 491 _GL_WARN_ON_USE (strpbrk, "strpbrk cannot work correctly on character strings "
 492                  "in multibyte locales - "
 493                  "use mbspbrk if you care about internationalization");
 494 # endif
 495 #elif defined GNULIB_POSIXCHECK
 496 # undef strpbrk
 497 # if HAVE_RAW_DECL_STRPBRK
 498 _GL_WARN_ON_USE (strpbrk, "strpbrk is unportable - "
 499                  "use gnulib module strpbrk for portability");
 500 # endif
 501 #endif
 502
 503 #if defined GNULIB_POSIXCHECK
 504 /* strspn() assumes the second argument is a list of single-byte characters.
 505    Even in this simple case, it cannot work with multibyte strings.  */
 506 # undef strspn
 507 /* Assume strspn is always declared.  */
 508 _GL_WARN_ON_USE (strspn, "strspn cannot work correctly on character strings "
 509                  "in multibyte locales - "
 510                  "use mbsspn if you care about internationalization");
 511 #endif
 512
 513 #if defined GNULIB_POSIXCHECK
 514 /* strrchr() does not work with multibyte strings if the locale encoding is
 515    GB18030 and the character to be searched is a digit.  */
 516 # undef strrchr
 517 /* Assume strrchr is always declared.  */
 518 _GL_WARN_ON_USE (strrchr, "strrchr cannot work correctly on character strings "
 519                  "in some multibyte locales - "
 520                  "use mbsrchr if you care about internationalization");
 521 #endif
 522
 523 /* Search the next delimiter (char listed in DELIM) starting at *STRINGP.
 524    If one is found, overwrite it with a NUL, and advance *STRINGP
 525    to point to the next char after it.  Otherwise, set *STRINGP to NULL.
 526    If *STRINGP was already NULL, nothing happens.
 527    Return the old value of *STRINGP.
 528
 529    This is a variant of strtok() that is multithread-safe and supports
 530    empty fields.
 531
 532    Caveat: It modifies the original string.
 533    Caveat: These functions cannot be used on constant strings.
 534    Caveat: The identity of the delimiting character is lost.
 535    Caveat: It doesn't work with multibyte strings unless all of the delimiter
 536            characters are ASCII characters < 0x30.
 537
 538    See also strtok_r().  */
 539 #if @GNULIB_STRSEP@
 540 # if ! @HAVE_STRSEP@
 541 _GL_FUNCDECL_SYS (strsep, char *,
 542                   (char **restrict __stringp, char const *restrict __delim)
 543                   _GL_ARG_NONNULL ((1, 2)));
 544 # endif
 545 _GL_CXXALIAS_SYS (strsep, char *,
 546                   (char **restrict __stringp, char const *restrict __delim));
 547 _GL_CXXALIASWARN (strsep);
 548 # if defined GNULIB_POSIXCHECK
 549 #  undef strsep
 550 _GL_WARN_ON_USE (strsep, "strsep cannot work correctly on character strings "
 551                  "in multibyte locales - "
 552                  "use mbssep if you care about internationalization");
 553 # endif
 554 #elif defined GNULIB_POSIXCHECK
 555 # undef strsep
 556 # if HAVE_RAW_DECL_STRSEP
 557 _GL_WARN_ON_USE (strsep, "strsep is unportable - "
 558                  "use gnulib module strsep for portability");
 559 # endif
 560 #endif
 561
 562 #if @GNULIB_STRSTR@
 563 # if @REPLACE_STRSTR@
 564 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
 565 #   define strstr rpl_strstr
 566 #  endif
 567 _GL_FUNCDECL_RPL (strstr, char *, (const char *haystack, const char *needle)
 568                                   _GL_ATTRIBUTE_PURE
 569                                   _GL_ARG_NONNULL ((1, 2)));
 570 _GL_CXXALIAS_RPL (strstr, char *, (const char *haystack, const char *needle));
 571 # else
 572   /* On some systems, this function is defined as an overloaded function:
 573        extern "C++" { const char * strstr (const char *, const char *); }
 574        extern "C++" { char * strstr (char *, const char *); }  */
 575 _GL_CXXALIAS_SYS_CAST2 (strstr,
 576                         char *, (const char *haystack, const char *needle),
 577                         const char *, (const char *haystack, const char *needle));
 578 # endif
 579 # if ((__GLIBC__ == 2 && __GLIBC_MINOR__ >= 10) && !defined __UCLIBC__) \
 580      && (__GNUC__ > 4 || (__GNUC__ == 4 && __GNUC_MINOR__ >= 4))
 581 _GL_CXXALIASWARN1 (strstr, char *, (char *haystack, const char *needle));
 582 _GL_CXXALIASWARN1 (strstr, const char *,
 583                    (const char *haystack, const char *needle));
 584 # else
 585 _GL_CXXALIASWARN (strstr);
 586 # endif
 587 #elif defined GNULIB_POSIXCHECK
 588 /* strstr() does not work with multibyte strings if the locale encoding is
 589    different from UTF-8:
 590    POSIX says that it operates on "strings", and "string" in POSIX is defined
 591    as a sequence of bytes, not of characters.  */
 592 # undef strstr
 593 /* Assume strstr is always declared.  */
 594 _GL_WARN_ON_USE (strstr, "strstr is quadratic on many systems, and cannot "
 595                  "work correctly on character strings in most "
 596                  "multibyte locales - "
 597                  "use mbsstr if you care about internationalization, "
 598                  "or use strstr if you care about speed");
 599 #endif
 600
 601 /* Find the first occurrence of NEEDLE in HAYSTACK, using case-insensitive
 602    comparison.  */
 603 #if @GNULIB_STRCASESTR@
 604 # if @REPLACE_STRCASESTR@
 605 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
 606 #   define strcasestr rpl_strcasestr
 607 #  endif
 608 _GL_FUNCDECL_RPL (strcasestr, char *,
 609                   (const char *haystack, const char *needle)
 610                   _GL_ATTRIBUTE_PURE
 611                   _GL_ARG_NONNULL ((1, 2)));
 612 _GL_CXXALIAS_RPL (strcasestr, char *,
 613                   (const char *haystack, const char *needle));
 614 # else
 615 #  if ! @HAVE_STRCASESTR@
 616 _GL_FUNCDECL_SYS (strcasestr, char *,
 617                   (const char *haystack, const char *needle)
 618                   _GL_ATTRIBUTE_PURE
 619                   _GL_ARG_NONNULL ((1, 2)));
 620 #  endif
 621   /* On some systems, this function is defined as an overloaded function:
 622        extern "C++" { const char * strcasestr (const char *, const char *); }
 623        extern "C++" { char * strcasestr (char *, const char *); }  */
 624 _GL_CXXALIAS_SYS_CAST2 (strcasestr,
 625                         char *, (const char *haystack, const char *needle),
 626                         const char *, (const char *haystack, const char *needle));
 627 # endif
 628 # if ((__GLIBC__ == 2 && __GLIBC_MINOR__ >= 10) && !defined __UCLIBC__) \
 629      && (__GNUC__ > 4 || (__GNUC__ == 4 && __GNUC_MINOR__ >= 4))
 630 _GL_CXXALIASWARN1 (strcasestr, char *, (char *haystack, const char *needle));
 631 _GL_CXXALIASWARN1 (strcasestr, const char *,
 632                    (const char *haystack, const char *needle));
 633 # else
 634 _GL_CXXALIASWARN (strcasestr);
 635 # endif
 636 #elif defined GNULIB_POSIXCHECK
 637 /* strcasestr() does not work with multibyte strings:
 638    It is a glibc extension, and glibc implements it only for unibyte
 639    locales.  */
 640 # undef strcasestr
 641 # if HAVE_RAW_DECL_STRCASESTR
 642 _GL_WARN_ON_USE (strcasestr, "strcasestr does work correctly on character "
 643                  "strings in multibyte locales - "
 644                  "use mbscasestr if you care about "
 645                  "internationalization, or use c-strcasestr if you want "
 646                  "a locale independent function");
 647 # endif
 648 #endif
 649
 650 /* Parse S into tokens separated by characters in DELIM.
 651    If S is NULL, the saved pointer in SAVE_PTR is used as
 652    the next starting point.  For example:
 653         char s[] = "-abc-=-def";
 654         char *sp;
 655         x = strtok_r(s, "-", &sp);      // x = "abc", sp = "=-def"
 656         x = strtok_r(NULL, "-=", &sp);  // x = "def", sp = NULL
 657         x = strtok_r(NULL, "=", &sp);   // x = NULL
 658                 // s = "abc\0-def\0"
 659
 660    This is a variant of strtok() that is multithread-safe.
 661
 662    For the POSIX documentation for this function, see:
 663    http://www.opengroup.org/susv3xsh/strtok.html
 664
 665    Caveat: It modifies the original string.
 666    Caveat: These functions cannot be used on constant strings.
 667    Caveat: The identity of the delimiting character is lost.
 668    Caveat: It doesn't work with multibyte strings unless all of the delimiter
 669            characters are ASCII characters < 0x30.
 670
 671    See also strsep().  */
 672 #if @GNULIB_STRTOK_R@
 673 # if @REPLACE_STRTOK_R@
 674 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
 675 #   undef strtok_r
 676 #   define strtok_r rpl_strtok_r
 677 #  endif
 678 _GL_FUNCDECL_RPL (strtok_r, char *,
 679                   (char *restrict s, char const *restrict delim,
 680                    char **restrict save_ptr)
 681                   _GL_ARG_NONNULL ((2, 3)));
 682 _GL_CXXALIAS_RPL (strtok_r, char *,
 683                   (char *restrict s, char const *restrict delim,
 684                    char **restrict save_ptr));
 685 # else
 686 #  if @UNDEFINE_STRTOK_R@ || defined GNULIB_POSIXCHECK
 687 #   undef strtok_r
 688 #  endif
 689 #  if ! @HAVE_DECL_STRTOK_R@
 690 _GL_FUNCDECL_SYS (strtok_r, char *,
 691                   (char *restrict s, char const *restrict delim,
 692                    char **restrict save_ptr)
 693                   _GL_ARG_NONNULL ((2, 3)));
 694 #  endif
 695 _GL_CXXALIAS_SYS (strtok_r, char *,
 696                   (char *restrict s, char const *restrict delim,
 697                    char **restrict save_ptr));
 698 # endif
 699 _GL_CXXALIASWARN (strtok_r);
 700 # if defined GNULIB_POSIXCHECK
 701 _GL_WARN_ON_USE (strtok_r, "strtok_r cannot work correctly on character "
 702                  "strings in multibyte locales - "
 703                  "use mbstok_r if you care about internationalization");
 704 # endif
 705 #elif defined GNULIB_POSIXCHECK
 706 # undef strtok_r
 707 # if HAVE_RAW_DECL_STRTOK_R
 708 _GL_WARN_ON_USE (strtok_r, "strtok_r is unportable - "
 709                  "use gnulib module strtok_r for portability");
 710 # endif
 711 #endif
 712
 713
 714 /* The following functions are not specified by POSIX.  They are gnulib
 715    extensions.  */
 716
 717 #if @GNULIB_MBSLEN@
 718 /* Return the number of multibyte characters in the character string STRING.
 719    This considers multibyte characters, unlike strlen, which counts bytes.  */
 720 # ifdef __MirBSD__  /* MirBSD defines mbslen as a macro.  Override it.  */
 721 #  undef mbslen
 722 # endif
 723 # if @HAVE_MBSLEN@  /* AIX, OSF/1, MirBSD define mbslen already in libc.  */
 724 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
 725 #   define mbslen rpl_mbslen
 726 #  endif
 727 _GL_FUNCDECL_RPL (mbslen, size_t, (const char *string)
 728                                   _GL_ATTRIBUTE_PURE
 729                                   _GL_ARG_NONNULL ((1)));
 730 _GL_CXXALIAS_RPL (mbslen, size_t, (const char *string));
 731 # else
 732 _GL_FUNCDECL_SYS (mbslen, size_t, (const char *string)
 733                                   _GL_ATTRIBUTE_PURE
 734                                   _GL_ARG_NONNULL ((1)));
 735 _GL_CXXALIAS_SYS (mbslen, size_t, (const char *string));
 736 # endif
 737 _GL_CXXALIASWARN (mbslen);
 738 #endif
 739
 740 #if @GNULIB_MBSNLEN@
 741 /* Return the number of multibyte characters in the character string starting
 742    at STRING and ending at STRING + LEN.  */
 743 _GL_EXTERN_C size_t mbsnlen (const char *string, size_t len)
 744      _GL_ATTRIBUTE_PURE
 745      _GL_ARG_NONNULL ((1));
 746 #endif
 747
 748 #if @GNULIB_MBSCHR@
 749 /* Locate the first single-byte character C in the character string STRING,
 750    and return a pointer to it.  Return NULL if C is not found in STRING.
 751    Unlike strchr(), this function works correctly in multibyte locales with
 752    encodings such as GB18030.  */
 753 # if defined __hpux
 754 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
 755 #   define mbschr rpl_mbschr /* avoid collision with HP-UX function */
 756 #  endif
 757 _GL_FUNCDECL_RPL (mbschr, char *, (const char *string, int c)
 758                                   _GL_ATTRIBUTE_PURE
 759                                   _GL_ARG_NONNULL ((1)));
 760 _GL_CXXALIAS_RPL (mbschr, char *, (const char *string, int c));
 761 # else
 762 _GL_FUNCDECL_SYS (mbschr, char *, (const char *string, int c)
 763                                   _GL_ATTRIBUTE_PURE
 764                                   _GL_ARG_NONNULL ((1)));
 765 _GL_CXXALIAS_SYS (mbschr, char *, (const char *string, int c));
 766 # endif
 767 _GL_CXXALIASWARN (mbschr);
 768 #endif
 769
 770 #if @GNULIB_MBSRCHR@
 771 /* Locate the last single-byte character C in the character string STRING,
 772    and return a pointer to it.  Return NULL if C is not found in STRING.
 773    Unlike strrchr(), this function works correctly in multibyte locales with
 774    encodings such as GB18030.  */
 775 # if defined __hpux || defined __INTERIX
 776 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
 777 #   define mbsrchr rpl_mbsrchr /* avoid collision with system function */
 778 #  endif
 779 _GL_FUNCDECL_RPL (mbsrchr, char *, (const char *string, int c)
 780                                    _GL_ATTRIBUTE_PURE
 781                                    _GL_ARG_NONNULL ((1)));
 782 _GL_CXXALIAS_RPL (mbsrchr, char *, (const char *string, int c));
 783 # else
 784 _GL_FUNCDECL_SYS (mbsrchr, char *, (const char *string, int c)
 785                                    _GL_ATTRIBUTE_PURE
 786                                    _GL_ARG_NONNULL ((1)));
 787 _GL_CXXALIAS_SYS (mbsrchr, char *, (const char *string, int c));
 788 # endif
 789 _GL_CXXALIASWARN (mbsrchr);
 790 #endif
 791
 792 #if @GNULIB_MBSSTR@
 793 /* Find the first occurrence of the character string NEEDLE in the character
 794    string HAYSTACK.  Return NULL if NEEDLE is not found in HAYSTACK.
 795    Unlike strstr(), this function works correctly in multibyte locales with
 796    encodings different from UTF-8.  */
 797 _GL_EXTERN_C char * mbsstr (const char *haystack, const char *needle)
 798      _GL_ATTRIBUTE_PURE
 799      _GL_ARG_NONNULL ((1, 2));
 800 #endif
 801
 802 #if @GNULIB_MBSCASECMP@
 803 /* Compare the character strings S1 and S2, ignoring case, returning less than,
 804    equal to or greater than zero if S1 is lexicographically less than, equal to
 805    or greater than S2.
 806    Note: This function may, in multibyte locales, return 0 for strings of
 807    different lengths!
 808    Unlike strcasecmp(), this function works correctly in multibyte locales.  */
 809 _GL_EXTERN_C int mbscasecmp (const char *s1, const char *s2)
 810      _GL_ATTRIBUTE_PURE
 811      _GL_ARG_NONNULL ((1, 2));
 812 #endif
 813
 814 #if @GNULIB_MBSNCASECMP@
 815 /* Compare the initial segment of the character string S1 consisting of at most
 816    N characters with the initial segment of the character string S2 consisting
 817    of at most N characters, ignoring case, returning less than, equal to or
 818    greater than zero if the initial segment of S1 is lexicographically less
 819    than, equal to or greater than the initial segment of S2.
 820    Note: This function may, in multibyte locales, return 0 for initial segments
 821    of different lengths!
 822    Unlike strncasecmp(), this function works correctly in multibyte locales.
 823    But beware that N is not a byte count but a character count!  */
 824 _GL_EXTERN_C int mbsncasecmp (const char *s1, const char *s2, size_t n)
 825      _GL_ATTRIBUTE_PURE
 826      _GL_ARG_NONNULL ((1, 2));
 827 #endif
 828
 829 #if @GNULIB_MBSPCASECMP@
 830 /* Compare the initial segment of the character string STRING consisting of
 831    at most mbslen (PREFIX) characters with the character string PREFIX,
 832    ignoring case.  If the two match, return a pointer to the first byte
 833    after this prefix in STRING.  Otherwise, return NULL.
 834    Note: This function may, in multibyte locales, return non-NULL if STRING
 835    is of smaller length than PREFIX!
 836    Unlike strncasecmp(), this function works correctly in multibyte
 837    locales.  */
 838 _GL_EXTERN_C char * mbspcasecmp (const char *string, const char *prefix)
 839      _GL_ATTRIBUTE_PURE
 840      _GL_ARG_NONNULL ((1, 2));
 841 #endif
 842
 843 #if @GNULIB_MBSCASESTR@
 844 /* Find the first occurrence of the character string NEEDLE in the character
 845    string HAYSTACK, using case-insensitive comparison.
 846    Note: This function may, in multibyte locales, return success even if
 847    strlen (haystack) < strlen (needle) !
 848    Unlike strcasestr(), this function works correctly in multibyte locales.  */
 849 _GL_EXTERN_C char * mbscasestr (const char *haystack, const char *needle)
 850      _GL_ATTRIBUTE_PURE
 851      _GL_ARG_NONNULL ((1, 2));
 852 #endif
 853
 854 #if @GNULIB_MBSCSPN@
 855 /* Find the first occurrence in the character string STRING of any character
 856    in the character string ACCEPT.  Return the number of bytes from the
 857    beginning of the string to this occurrence, or to the end of the string
 858    if none exists.
 859    Unlike strcspn(), this function works correctly in multibyte locales.  */
 860 _GL_EXTERN_C size_t mbscspn (const char *string, const char *accept)
 861      _GL_ATTRIBUTE_PURE
 862      _GL_ARG_NONNULL ((1, 2));
 863 #endif
 864
 865 #if @GNULIB_MBSPBRK@
 866 /* Find the first occurrence in the character string STRING of any character
 867    in the character string ACCEPT.  Return the pointer to it, or NULL if none
 868    exists.
 869    Unlike strpbrk(), this function works correctly in multibyte locales.  */
 870 # if defined __hpux
 871 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
 872 #   define mbspbrk rpl_mbspbrk /* avoid collision with HP-UX function */
 873 #  endif
 874 _GL_FUNCDECL_RPL (mbspbrk, char *, (const char *string, const char *accept)
 875                                    _GL_ATTRIBUTE_PURE
 876                                    _GL_ARG_NONNULL ((1, 2)));
 877 _GL_CXXALIAS_RPL (mbspbrk, char *, (const char *string, const char *accept));
 878 # else
 879 _GL_FUNCDECL_SYS (mbspbrk, char *, (const char *string, const char *accept)
 880                                    _GL_ATTRIBUTE_PURE
 881                                    _GL_ARG_NONNULL ((1, 2)));
 882 _GL_CXXALIAS_SYS (mbspbrk, char *, (const char *string, const char *accept));
 883 # endif
 884 _GL_CXXALIASWARN (mbspbrk);
 885 #endif
 886
 887 #if @GNULIB_MBSSPN@
 888 /* Find the first occurrence in the character string STRING of any character
 889    not in the character string REJECT.  Return the number of bytes from the
 890    beginning of the string to this occurrence, or to the end of the string
 891    if none exists.
 892    Unlike strspn(), this function works correctly in multibyte locales.  */
 893 _GL_EXTERN_C size_t mbsspn (const char *string, const char *reject)
 894      _GL_ATTRIBUTE_PURE
 895      _GL_ARG_NONNULL ((1, 2));
 896 #endif
 897
 898 #if @GNULIB_MBSSEP@
 899 /* Search the next delimiter (multibyte character listed in the character
 900    string DELIM) starting at the character string *STRINGP.
 901    If one is found, overwrite it with a NUL, and advance *STRINGP to point
 902    to the next multibyte character after it.  Otherwise, set *STRINGP to NULL.
 903    If *STRINGP was already NULL, nothing happens.
 904    Return the old value of *STRINGP.
 905
 906    This is a variant of mbstok_r() that supports empty fields.
 907
 908    Caveat: It modifies the original string.
 909    Caveat: These functions cannot be used on constant strings.
 910    Caveat: The identity of the delimiting character is lost.
 911
 912    See also mbstok_r().  */
 913 _GL_EXTERN_C char * mbssep (char **stringp, const char *delim)
 914      _GL_ARG_NONNULL ((1, 2));
 915 #endif
 916
 917 #if @GNULIB_MBSTOK_R@
 918 /* Parse the character string STRING into tokens separated by characters in
 919    the character string DELIM.
 920    If STRING is NULL, the saved pointer in SAVE_PTR is used as
 921    the next starting point.  For example:
 922         char s[] = "-abc-=-def";
 923         char *sp;
 924         x = mbstok_r(s, "-", &sp);      // x = "abc", sp = "=-def"
 925         x = mbstok_r(NULL, "-=", &sp);  // x = "def", sp = NULL
 926         x = mbstok_r(NULL, "=", &sp);   // x = NULL
 927                 // s = "abc\0-def\0"
 928
 929    Caveat: It modifies the original string.
 930    Caveat: These functions cannot be used on constant strings.
 931    Caveat: The identity of the delimiting character is lost.
 932
 933    See also mbssep().  */
 934 _GL_EXTERN_C char * mbstok_r (char *string, const char *delim, char **save_ptr)
 935      _GL_ARG_NONNULL ((2, 3));
 936 #endif
 937
 938 /* Map any int, typically from errno, into an error message.  */
 939 #if @GNULIB_STRERROR@
 940 # if @REPLACE_STRERROR@
 941 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
 942 #   undef strerror
 943 #   define strerror rpl_strerror
 944 #  endif
 945 _GL_FUNCDECL_RPL (strerror, char *, (int));
 946 _GL_CXXALIAS_RPL (strerror, char *, (int));
 947 # else
 948 _GL_CXXALIAS_SYS (strerror, char *, (int));
 949 # endif
 950 _GL_CXXALIASWARN (strerror);
 951 #elif defined GNULIB_POSIXCHECK
 952 # undef strerror
 953 /* Assume strerror is always declared.  */
 954 _GL_WARN_ON_USE (strerror, "strerror is unportable - "
 955                  "use gnulib module strerror to guarantee non-NULL result");
 956 #endif
 957
 958 /* Map any int, typically from errno, into an error message.  Multithread-safe.
 959    Uses the POSIX declaration, not the glibc declaration.  */
 960 #if @GNULIB_STRERROR_R@
 961 # if @REPLACE_STRERROR_R@
 962 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
 963 #   undef strerror_r
 964 #   define strerror_r rpl_strerror_r
 965 #  endif
 966 _GL_FUNCDECL_RPL (strerror_r, int, (int errnum, char *buf, size_t buflen)
 967                                    _GL_ARG_NONNULL ((2)));
 968 _GL_CXXALIAS_RPL (strerror_r, int, (int errnum, char *buf, size_t buflen));
 969 # else
 970 #  if !@HAVE_DECL_STRERROR_R@
 971 _GL_FUNCDECL_SYS (strerror_r, int, (int errnum, char *buf, size_t buflen)
 972                                    _GL_ARG_NONNULL ((2)));
 973 #  endif
 974 _GL_CXXALIAS_SYS (strerror_r, int, (int errnum, char *buf, size_t buflen));
 975 # endif
 976 # if @HAVE_DECL_STRERROR_R@
 977 _GL_CXXALIASWARN (strerror_r);
 978 # endif
 979 #elif defined GNULIB_POSIXCHECK
 980 # undef strerror_r
 981 # if HAVE_RAW_DECL_STRERROR_R
 982 _GL_WARN_ON_USE (strerror_r, "strerror_r is unportable - "
 983                  "use gnulib module strerror_r-posix for portability");
 984 # endif
 985 #endif
 986
 987 #if @GNULIB_STRSIGNAL@
 988 # if @REPLACE_STRSIGNAL@
 989 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
 990 #   define strsignal rpl_strsignal
 991 #  endif
 992 _GL_FUNCDECL_RPL (strsignal, char *, (int __sig));
 993 _GL_CXXALIAS_RPL (strsignal, char *, (int __sig));
 994 # else
 995 #  if ! @HAVE_DECL_STRSIGNAL@
 996 _GL_FUNCDECL_SYS (strsignal, char *, (int __sig));
 997 #  endif
 998 /* Need to cast, because on Cygwin 1.5.x systems, the return type is
 999    'const char *'.  */
1000 _GL_CXXALIAS_SYS_CAST (strsignal, char *, (int __sig));
1001 # endif
1002 _GL_CXXALIASWARN (strsignal);
1003 #elif defined GNULIB_POSIXCHECK
1004 # undef strsignal
1005 # if HAVE_RAW_DECL_STRSIGNAL
1006 _GL_WARN_ON_USE (strsignal, "strsignal is unportable - "
1007                  "use gnulib module strsignal for portability");
1008 # endif
1009 #endif
1010
1011 #if @GNULIB_STRVERSCMP@
1012 # if !@HAVE_STRVERSCMP@
1013 _GL_FUNCDECL_SYS (strverscmp, int, (const char *, const char *)
1014                                    _GL_ATTRIBUTE_PURE
1015                                    _GL_ARG_NONNULL ((1, 2)));
1016 # endif
1017 _GL_CXXALIAS_SYS (strverscmp, int, (const char *, const char *));
1018 _GL_CXXALIASWARN (strverscmp);
1019 #elif defined GNULIB_POSIXCHECK
1020 # undef strverscmp
1021 # if HAVE_RAW_DECL_STRVERSCMP
1022 _GL_WARN_ON_USE (strverscmp, "strverscmp is unportable - "
1023                  "use gnulib module strverscmp for portability");
1024 # endif
1025 #endif
1026
1027
1028 #endif /* _@GUARD_PREFIX@_STRING_H */
1029 #endif /* _@GUARD_PREFIX@_STRING_H */