doc/c-strcase.texi

   1 @c Documentation of gnulib module 'c-strcase'.
   2
   3 @c Copyright (C) 2008-2014 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, with no Front-Cover Texts, and with no Back-Cover
   9 @c Texts.  A copy of the license is included in the ``GNU Free
  10 @c Documentation License'' file as part of this distribution.
  11
  12 The @code{c-strcase} module contains case-insensitive string comparison
  13 functions operating on single-byte character strings, like the functions in
  14 @code{<strings.h>}, that operate as if the locale encoding was ASCII.
  15 (The "C" locale on many systems has the locale encoding "ASCII".)
  16
  17 The functions are:
  18 @smallexample
  19 extern int c_strcasecmp (const char *s1, const char *s2);
  20 extern int c_strncasecmp (const char *s1, const char *s2, size_t n);
  21 @end smallexample
  22
  23 For case conversion here, only ASCII characters are considered to be
  24 upper case or lower case.
  25
  26 Note: The functions @code{strcasecmp}, @code{strncasecmp} from
  27 @code{<strings.h>} support only unibyte locales; for multibyte locales,
  28 you need the functions @code{mbscasecmp}, @code{mbsncasecmp},
  29 @code{mbspcasecmp}.