diff options
Diffstat (limited to 'doc/c-strcasestr.texi')
| -rw-r--r-- | doc/c-strcasestr.texi | 27 |
1 files changed, 27 insertions, 0 deletions
diff --git a/doc/c-strcasestr.texi b/doc/c-strcasestr.texi new file mode 100644 index 0000000000..5ff1f88b95 --- /dev/null +++ b/doc/c-strcasestr.texi @@ -0,0 +1,27 @@ +@c Documentation of gnulib module 'c-strcasestr'. + +@c Copyright (C) 2008 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.2 or +@c any later version published by the Free Software Foundation; with no +@c Invariant Sections, with no Front-Cover Texts, and with no Back-Cover +@c Texts. A copy of the license is included in the ``GNU Free +@c Documentation License'' file as part of this distribution. + +The @code{c-strcasestr} module contains a case-insensitive string search +function operating on single-byte character strings, 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 char *c_strcasestr (const char *haystack, const char *needle); +@end smallexample + +For case conversion here, only ASCII characters are considered to be +upper case or lower case. + +Note: The function @code{strcasestr} from @code{<string.h>} supports only +unibyte locales; for multibyte locales, you need the function +@code{mbscasestr}. |