doc/c-strcaseeq.texi

   1 @c Documentation of gnulib module 'c-strcaseeq'.
   2
   3 @c Copyright (C) 2008--2024 Free Software Foundation, Inc.
   4
   5 @c Permission is granted to copy, distribute and/or modify this document
   6 @c under the terms of the GNU Free Documentation License, Version 1.3 or
   7 @c any later version published by the Free Software Foundation; with no
   8 @c Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.  A
   9 @c copy of the license is at <https://www.gnu.org/licenses/fdl-1.3.en.html>.
  10
  11 The @code{c-strcaseeq} module contains an optimized case-insensitive
  12 string comparison function operating on single-byte character strings, that
  13 operate as if the locale encoding was ASCII.
  14 (The "C" locale on many systems has the locale encoding "ASCII".)
  15
  16 The functions is actually implemented as a macro:
  17 @smallexample
  18 extern int STRCASEEQ (const char *s1, const char *s2,
  19                       int s20, int s21, int s22, int s23, int s24, int s25,
  20                       int s26, int s27, int s28);
  21 @end smallexample
  22
  23 @var{s2} should be a short literal ASCII string, and @var{s20}, @var{s21}, ...
  24 the individual characters of @var{s2}.
  25
  26 For case conversion here, only ASCII characters are considered to be
  27 upper case or lower case.