annotate lib/c-strstr.h @ 9729:7ebb4a06fabd

Fix typo in comment.
author Atsushi SAKAI <sakaia@jp.fujitsu.com>
date Thu, 28 Feb 2008 15:26:44 +0100
parents bbbbbf4cd1c5
children b5e42ef33b49
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
7209
b528c3e6739e New module 'c-strstr'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
1 /* Searching in a string.
b528c3e6739e New module 'c-strstr'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
2 Copyright (C) 2001-2003, 2006 Free Software Foundation, Inc.
b528c3e6739e New module 'c-strstr'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
3
9309
bbbbbf4cd1c5 Change copyright notice from GPLv2+ to GPLv3+.
Bruno Haible <bruno@clisp.org>
parents: 7209
diff changeset
4 This program is free software: you can redistribute it and/or modify
7209
b528c3e6739e New module 'c-strstr'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
5 it under the terms of the GNU General Public License as published by
9309
bbbbbf4cd1c5 Change copyright notice from GPLv2+ to GPLv3+.
Bruno Haible <bruno@clisp.org>
parents: 7209
diff changeset
6 the Free Software Foundation; either version 3 of the License, or
bbbbbf4cd1c5 Change copyright notice from GPLv2+ to GPLv3+.
Bruno Haible <bruno@clisp.org>
parents: 7209
diff changeset
7 (at your option) any later version.
7209
b528c3e6739e New module 'c-strstr'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
8
b528c3e6739e New module 'c-strstr'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
9 This program is distributed in the hope that it will be useful,
b528c3e6739e New module 'c-strstr'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
10 but WITHOUT ANY WARRANTY; without even the implied warranty of
b528c3e6739e New module 'c-strstr'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
11 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
b528c3e6739e New module 'c-strstr'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
12 GNU General Public License for more details.
b528c3e6739e New module 'c-strstr'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
13
b528c3e6739e New module 'c-strstr'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
14 You should have received a copy of the GNU General Public License
9309
bbbbbf4cd1c5 Change copyright notice from GPLv2+ to GPLv3+.
Bruno Haible <bruno@clisp.org>
parents: 7209
diff changeset
15 along with this program. If not, see <http://www.gnu.org/licenses/>. */
7209
b528c3e6739e New module 'c-strstr'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
16
b528c3e6739e New module 'c-strstr'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
17
b528c3e6739e New module 'c-strstr'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
18 /* The functions defined in this file assume a nearly ASCII compatible
b528c3e6739e New module 'c-strstr'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
19 character set. */
b528c3e6739e New module 'c-strstr'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
20
b528c3e6739e New module 'c-strstr'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
21
b528c3e6739e New module 'c-strstr'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
22 #ifdef __cplusplus
b528c3e6739e New module 'c-strstr'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
23 extern "C" {
b528c3e6739e New module 'c-strstr'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
24 #endif
b528c3e6739e New module 'c-strstr'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
25
b528c3e6739e New module 'c-strstr'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
26 /* Find the first occurrence of NEEDLE in HAYSTACK.
b528c3e6739e New module 'c-strstr'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
27 This function is safe to be called, even in a multibyte locale, if NEEDLE
b528c3e6739e New module 'c-strstr'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
28 1. consists solely of printable ASCII characters excluding '\\' and '~'
b528c3e6739e New module 'c-strstr'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
29 [this restriction is needed because of Shift_JIS and JOHAB]
b528c3e6739e New module 'c-strstr'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
30 or of the control ASCII characters '\a' '\b' '\f' '\n' '\r' '\t' '\v'
b528c3e6739e New module 'c-strstr'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
31 [this restriction is needed because of VISCII], and
b528c3e6739e New module 'c-strstr'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
32 2. has at least length 2
b528c3e6739e New module 'c-strstr'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
33 [this restriction is needed because of BIG5, BIG5-HKSCS, GBK, GB18030,
b528c3e6739e New module 'c-strstr'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
34 Shift_JIS, JOHAB], and
b528c3e6739e New module 'c-strstr'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
35 3. does not consist entirely of decimal digits, or has at least length 4
b528c3e6739e New module 'c-strstr'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
36 [this restricion is needed because of GB18030].
b528c3e6739e New module 'c-strstr'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
37 This function is also safe to be called, even in a multibyte locale, if
b528c3e6739e New module 'c-strstr'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
38 HAYSTACK and NEEDLE are known to both consist solely of printable ASCII
b528c3e6739e New module 'c-strstr'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
39 characters excluding '\\' and '~'. */
b528c3e6739e New module 'c-strstr'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
40 extern char *c_strstr (const char *haystack, const char *needle);
b528c3e6739e New module 'c-strstr'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
41
b528c3e6739e New module 'c-strstr'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
42 #ifdef __cplusplus
b528c3e6739e New module 'c-strstr'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
43 }
b528c3e6739e New module 'c-strstr'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
44 #endif