lib/mbmemcasecmp.h

   1 /* Compare two memory areas with possibly different lengths, case-insensitive.
   2    Copyright (C) 2009-2024 Free Software Foundation, Inc.
   3
   4    This program is free software: you can redistribute it and/or modify it
   5    under the terms of the GNU Lesser General Public License as published
   6    by the Free Software Foundation, either version 3 of the License, or
   7    (at your option) 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 GNU
  12    Lesser General Public License for more details.
  13
  14    You should have received a copy of the GNU Lesser General Public License
  15    along with this program.  If not, see <https://www.gnu.org/licenses/>.  */
  16
  17 #ifndef MBMEMCASECMP_H
  18 #define MBMEMCASECMP_H
  19
  20 #include <stddef.h>
  21
  22 #ifdef __cplusplus
  23 extern "C" {
  24 #endif
  25
  26
  27 /* Compare the memory regions S1 = [s1..s1+N1-1], S2 = [s2..s2+n2-1], that
  28    contain character sequences, lexicographically, ignoring case.
  29    This function's result is locale dependent.  Unlike memcasecmp(), it works
  30    correctly in multibyte locales and also handles Turkish i / dotless i.
  31    Unlike ulc_casecmp(), it does not handle the German sharp s and the Greek
  32    final sigma.  Unlike memcoll() and ulc_casecoll(), it ignores collation
  33    order.
  34    Return a negative number if S1 < S2, a positive number if S1 > S2, or
  35    0 if S1 and S2 have the same contents.
  36    Note: This function may, in multibyte locales, return 0 for strings of
  37    different lengths!  */
  38 extern int mbmemcasecmp (const char *s1, size_t n1, const char *s2, size_t n2);
  39
  40
  41 #ifdef __cplusplus
  42 }
  43 #endif
  44
  45 #endif /* MBMEMCASECMP_H */