Mercurial > hg > octave-nkf > gnulib-hg

annotate doc/c-strcase.texi @ 13536:063f254a90d3

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
remove spurious leading i
author Karl Berry <karl@freefriends.org>
date Sat, 07 Aug 2010 06:27:04 -0700
parents c2cbabec01dd
children 97fc9a21a8fb
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
9603
7f9da67a609a Add documentation for the c-* modules.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
1 @c Documentation of gnulib module 'c-strcase'.
7f9da67a609a Add documentation for the c-* modules.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
2
12559
c2cbabec01dd update nearly all FSF copyright year lists to include 2010
Jim Meyering <meyering@redhat.com>
parents: 12518
diff changeset
3 @c Copyright (C) 2008, 2009, 2010 Free Software Foundation, Inc.
9603
7f9da67a609a Add documentation for the c-* modules.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
4
7f9da67a609a Add documentation for the c-* modules.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
5 @c Permission is granted to copy, distribute and/or modify this document
10762
d67664a4e01c Change license to GFDLv1.3+.
Simon Josefsson <simon@josefsson.org>
parents: 9603
diff changeset
6 @c under the terms of the GNU Free Documentation License, Version 1.3 or
9603
7f9da67a609a Add documentation for the c-* modules.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
7 @c any later version published by the Free Software Foundation; with no
7f9da67a609a Add documentation for the c-* modules.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
8 @c Invariant Sections, with no Front-Cover Texts, and with no Back-Cover
7f9da67a609a Add documentation for the c-* modules.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
9 @c Texts. A copy of the license is included in the ``GNU Free
7f9da67a609a Add documentation for the c-* modules.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
10 @c Documentation License'' file as part of this distribution.
7f9da67a609a Add documentation for the c-* modules.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
11
7f9da67a609a Add documentation for the c-* modules.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
12 The @code{c-strcase} module contains case-insensitive string comparison
7f9da67a609a Add documentation for the c-* modules.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
13 functions operating on single-byte character strings, like the functions in
7f9da67a609a Add documentation for the c-* modules.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
14 @code{<strings.h>}, that operate as if the locale encoding was ASCII.
7f9da67a609a Add documentation for the c-* modules.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
15 (The "C" locale on many systems has the locale encoding "ASCII".)
7f9da67a609a Add documentation for the c-* modules.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
16
7f9da67a609a Add documentation for the c-* modules.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
17 The functions are:
7f9da67a609a Add documentation for the c-* modules.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
18 @smallexample
7f9da67a609a Add documentation for the c-* modules.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
19 extern int c_strcasecmp (const char *s1, const char *s2);
7f9da67a609a Add documentation for the c-* modules.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
20 extern int c_strncasecmp (const char *s1, const char *s2, size_t n);
7f9da67a609a Add documentation for the c-* modules.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
21 @end smallexample
7f9da67a609a Add documentation for the c-* modules.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
22
7f9da67a609a Add documentation for the c-* modules.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
23 For case conversion here, only ASCII characters are considered to be
7f9da67a609a Add documentation for the c-* modules.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
24 upper case or lower case.
7f9da67a609a Add documentation for the c-* modules.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
25
7f9da67a609a Add documentation for the c-* modules.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
26 Note: The functions @code{strcasecmp}, @code{strncasecmp} from
7f9da67a609a Add documentation for the c-* modules.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
27 @code{<strings.h>} support only unibyte locales; for multibyte locales,
7f9da67a609a Add documentation for the c-* modules.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
28 you need the functions @code{mbscasecmp}, @code{mbsncasecmp},
7f9da67a609a Add documentation for the c-* modules.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
29 @code{mbspcasecmp}.