2007-01-08 Bruno Haible <bruno@clisp.org>
[gnulib.git] / lib / strcase.h
1 /* Case-insensitive string comparison functions.
2    Copyright (C) 1995-1996, 2001, 2003, 2005-2006 Free Software Foundation, Inc.
3
4    This program is free software; you can redistribute it and/or modify
5    it under the terms of the GNU General Public License as published by
6    the Free Software Foundation; either version 2, or (at your option)
7    any later version.
8
9    This program is distributed in the hope that it will be useful,
10    but WITHOUT ANY WARRANTY; without even the implied warranty of
11    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
12    GNU General Public License for more details.
13
14    You should have received a copy of the GNU General Public License
15    along with this program; if not, write to the Free Software Foundation,
16    Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.  */
17
18 #ifndef _STRCASE_H
19 #define _STRCASE_H
20
21 #include <stddef.h>
22 /* Include header files with a possibly conflicting declarations of strcasecmp
23    before we define it as a macro, so that they will be no-ops if included
24    after strcasecmp is defined as a macro.  */
25 #include <string.h>
26
27 #ifdef __cplusplus
28 extern "C" {
29 #endif
30
31
32 /* No known system has a strcasecmp() function that works correctly in
33    multibyte locales.  Therefore we use our version always.  */
34 #define strcasecmp rpl_strcasecmp
35 /* Compare strings S1 and S2, ignoring case, returning less than, equal to or
36    greater than zero if S1 is lexicographically less than, equal to or greater
37    than S2.
38    Note: This function may, in multibyte locales, return 0 for strings of
39    different lengths!  */
40 extern int strcasecmp (const char *s1, const char *s2);
41
42 /* Compare no more than N characters of strings S1 and S2, ignoring case,
43    returning less than, equal to or greater than zero if S1 is
44    lexicographically less than, equal to or greater than S2.
45    Note: This function can not work correctly in multibyte locales.  */
46 #if ! HAVE_DECL_STRNCASECMP
47 extern int strncasecmp (const char *s1, const char *s2, size_t n);
48 #endif
49
50
51 #ifdef __cplusplus
52 }
53 #endif
54
55
56 #endif /* _STRCASE_H */