1  /* Case-insensitive string comparison functions in C locale.
       2     Copyright (C) 1995-1996, 2001, 2003, 2005, 2009-2023 Free Software
       3     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 C_STRCASE_H
      19  #define C_STRCASE_H
      20  
      21  /* This file uses _GL_ATTRIBUTE_PURE.  */
      22  #if !_GL_CONFIG_H_INCLUDED
      23   #error "Please include config.h first."
      24  #endif
      25  
      26  #include <stddef.h>
      27  
      28  
      29  /* The functions defined in this file assume the "C" locale and a character
      30     set without diacritics (ASCII-US or EBCDIC-US or something like that).
      31     Even if the "C" locale on a particular system is an extension of the ASCII
      32     character set (like on BeOS, where it is UTF-8, or on AmigaOS, where it
      33     is ISO-8859-1), the functions in this file recognize only the ASCII
      34     characters.  More precisely, one of the string arguments must be an ASCII
      35     string; the other one can also contain non-ASCII characters (but then
      36     the comparison result will be nonzero).  */
      37  
      38  
      39  #ifdef __cplusplus
      40  extern "C" {
      41  #endif
      42  
      43  
      44  /* Compare strings S1 and S2, ignoring case, returning less than, equal to or
      45     greater than zero if S1 is lexicographically less than, equal to or greater
      46     than S2.  */
      47  extern int c_strcasecmp (const char *s1, const char *s2) _GL_ATTRIBUTE_PURE;
      48  
      49  /* Compare no more than N characters of strings S1 and S2, ignoring case,
      50     returning less than, equal to or greater than zero if S1 is
      51     lexicographically less than, equal to or greater than S2.  */
      52  extern int c_strncasecmp (const char *s1, const char *s2, size_t n)
      53    _GL_ATTRIBUTE_PURE;
      54  
      55  
      56  #ifdef __cplusplus
      57  }
      58  #endif
      59  
      60  
      61  #endif /* C_STRCASE_H */