lib/c-strcase.h

   1 /* Case-insensitive string comparison functions in C locale.
   2    Copyright (C) 1995-1996, 2001, 2003, 2005, 2009-2010 Free Software
   3    Foundation, Inc.
   4
   5    This program is free software; you can redistribute it and/or modify
   6    it under the terms of the GNU Lesser General Public License as published by
   7    the Free Software Foundation; either version 2, 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 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, write to the Free Software Foundation,
  17    Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.  */
  18
  19 #ifndef C_STRCASE_H
  20 #define C_STRCASE_H
  21
  22 #include <stddef.h>
  23
  24
  25 /* The functions defined in this file assume the "C" locale and a character
  26    set without diacritics (ASCII-US or EBCDIC-US or something like that).
  27    Even if the "C" locale on a particular system is an extension of the ASCII
  28    character set (like on BeOS, where it is UTF-8, or on AmigaOS, where it
  29    is ISO-8859-1), the functions in this file recognize only the ASCII
  30    characters.  More precisely, one of the string arguments must be an ASCII
  31    string; the other one can also contain non-ASCII characters (but then
  32    the comparison result will be nonzero).  */
  33
  34
  35 #ifdef __cplusplus
  36 extern "C" {
  37 #endif
  38
  39
  40 /* Compare strings S1 and S2, ignoring case, returning less than, equal to or
  41    greater than zero if S1 is lexicographically less than, equal to or greater
  42    than S2.  */
  43 extern int c_strcasecmp (const char *s1, const char *s2);
  44
  45 /* Compare no more than N characters of strings S1 and S2, ignoring case,
  46    returning less than, equal to or greater than zero if S1 is
  47    lexicographically less than, equal to or greater than S2.  */
  48 extern int c_strncasecmp (const char *s1, const char *s2, size_t n);
  49
  50
  51 #ifdef __cplusplus
  52 }
  53 #endif
  54
  55
  56 #endif /* C_STRCASE_H */