| @c Documentation of gnulib module 'c-strncasecmp'. | |
| @c Copyright (C) 2008--2026 Free Software Foundation, Inc. | |
| @c Permission is granted to copy, distribute and/or modify this document | |
| @c under the terms of the GNU Free Documentation License, Version 1.3 or | |
| @c any later version published by the Free Software Foundation; with no | |
| @c Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A | |
| @c copy of the license is at <https://www.gnu.org/licenses/fdl-1.3.en.html>. | |
| @mindex c-strncasecmp | |
| The @code{c-strncasecmp} module contains a case-insensitive string comparison | |
| function operating on single-byte character strings, like the functions in | |
| @code{<strings.h>}, that operate as if the locale encoding was ASCII. | |
| (The "C" locale on many systems has the locale encoding "ASCII".) | |
| The function is: | |
| @smallexample | |
| extern int c_strncasecmp (const char *s1, const char *s2, size_t n); | |
| @end smallexample | |
| For case conversion here, only ASCII characters are considered to be | |
| upper case or lower case. | |
| Note: The function @code{strncasecmp} from @code{<strings.h>} | |
| supports only unibyte locales; | |
| @mindex mbsncasecmp | |
| @mindex mbspcasecmp | |
| for multibyte locales, | |
| you need the function @code{mbsncasecmp} or @code{mbspcasecmp}. |