1  /* A substitute <strings.h>.
       2  
       3     Copyright (C) 2007-2023 Free Software Foundation, Inc.
       4  
       5     This file is free software: you can redistribute it and/or modify
       6     it under the terms of the GNU Lesser General Public License as
       7     published by the Free Software Foundation; either version 2.1 of the
       8     License, or (at your option) any later version.
       9  
      10     This file 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 Lesser General Public License for more details.
      14  
      15     You should have received a copy of the GNU Lesser General Public License
      16     along with this program.  If not, see <https://www.gnu.org/licenses/>.  */
      17  
      18  #ifndef _@GUARD_PREFIX@_STRINGS_H
      19  
      20  #if __GNUC__ >= 3
      21  @PRAGMA_SYSTEM_HEADER@
      22  #endif
      23  @PRAGMA_COLUMNS@
      24  
      25  /* Minix 3.1.8 has a bug: <sys/types.h> must be included before <strings.h>.
      26     But avoid namespace pollution on glibc systems.  */
      27  #if defined __minix && !defined __GLIBC__
      28  # include <sys/types.h>
      29  #endif
      30  
      31  /* The include_next requires a split double-inclusion guard.  */
      32  #if @HAVE_STRINGS_H@
      33  # @INCLUDE_NEXT@ @NEXT_STRINGS_H@
      34  #endif
      35  
      36  #ifndef _@GUARD_PREFIX@_STRINGS_H
      37  #define _@GUARD_PREFIX@_STRINGS_H
      38  
      39  /* This file uses GNULIB_POSIXCHECK, HAVE_RAW_DECL_*.  */
      40  #if !_GL_CONFIG_H_INCLUDED
      41   #error "Please include config.h first."
      42  #endif
      43  
      44  #if ! @HAVE_DECL_STRNCASECMP@
      45  /* Get size_t.  */
      46  # include <stddef.h>
      47  #endif
      48  
      49  
      50  /* The definitions of _GL_FUNCDECL_RPL etc. are copied here.  */
      51  
      52  /* The definition of _GL_ARG_NONNULL is copied here.  */
      53  
      54  /* The definition of _GL_WARN_ON_USE is copied here.  */
      55  
      56  #ifdef __cplusplus
      57  extern "C" {
      58  #endif
      59  
      60  
      61    /* Find the index of the least-significant set bit.  */
      62  #if @GNULIB_FFS@
      63  # if !@HAVE_FFS@
      64  _GL_FUNCDECL_SYS (ffs, int, (int i));
      65  # endif
      66  _GL_CXXALIAS_SYS (ffs, int, (int i));
      67  _GL_CXXALIASWARN (ffs);
      68  #elif defined GNULIB_POSIXCHECK
      69  # undef ffs
      70  # if HAVE_RAW_DECL_FFS
      71  _GL_WARN_ON_USE (ffs, "ffs is not portable - use the ffs module");
      72  # endif
      73  #endif
      74  
      75  /* Compare strings S1 and S2, ignoring case, returning less than, equal to or
      76     greater than zero if S1 is lexicographically less than, equal to or greater
      77     than S2.
      78     Note: This function does not work in multibyte locales.  */
      79  #if ! @HAVE_STRCASECMP@
      80  extern int strcasecmp (char const *s1, char const *s2)
      81       _GL_ARG_NONNULL ((1, 2));
      82  #endif
      83  #if defined GNULIB_POSIXCHECK
      84  /* strcasecmp() does not work with multibyte strings:
      85     POSIX says that it operates on "strings", and "string" in POSIX is defined
      86     as a sequence of bytes, not of characters.   */
      87  # undef strcasecmp
      88  # if HAVE_RAW_DECL_STRCASECMP
      89  _GL_WARN_ON_USE (strcasecmp, "strcasecmp cannot work correctly on character "
      90                   "strings in multibyte locales - "
      91                   "use mbscasecmp if you care about "
      92                   "internationalization, or use c_strcasecmp , "
      93                   "gnulib module c-strcase) if you want a locale "
      94                   "independent function");
      95  # endif
      96  #endif
      97  
      98  /* Compare no more than N bytes of strings S1 and S2, ignoring case,
      99     returning less than, equal to or greater than zero if S1 is
     100     lexicographically less than, equal to or greater than S2.
     101     Note: This function cannot work correctly in multibyte locales.  */
     102  #if ! @HAVE_DECL_STRNCASECMP@
     103  extern int strncasecmp (char const *s1, char const *s2, size_t n)
     104       _GL_ARG_NONNULL ((1, 2));
     105  #endif
     106  #if defined GNULIB_POSIXCHECK
     107  /* strncasecmp() does not work with multibyte strings:
     108     POSIX says that it operates on "strings", and "string" in POSIX is defined
     109     as a sequence of bytes, not of characters.  */
     110  # undef strncasecmp
     111  # if HAVE_RAW_DECL_STRNCASECMP
     112  _GL_WARN_ON_USE (strncasecmp, "strncasecmp cannot work correctly on character "
     113                   "strings in multibyte locales - "
     114                   "use mbsncasecmp or mbspcasecmp if you care about "
     115                   "internationalization, or use c_strncasecmp , "
     116                   "gnulib module c-strcase) if you want a locale "
     117                   "independent function");
     118  # endif
     119  #endif
     120  
     121  
     122  #ifdef __cplusplus
     123  }
     124  #endif
     125  
     126  #endif /* _@GUARD_PREFIX@_STRING_H */
     127  #endif /* _@GUARD_PREFIX@_STRING_H */