1*63eb84d1Schristos /* Searching in a string.
2*63eb84d1Schristos    Copyright (C) 2001-2003, 2006 Free Software Foundation, Inc.
3*63eb84d1Schristos 
4*63eb84d1Schristos    This program is free software; you can redistribute it and/or modify
5*63eb84d1Schristos    it under the terms of the GNU General Public License as published by
6*63eb84d1Schristos    the Free Software Foundation; either version 2, or (at your option)
7*63eb84d1Schristos    any later version.
8*63eb84d1Schristos 
9*63eb84d1Schristos    This program is distributed in the hope that it will be useful,
10*63eb84d1Schristos    but WITHOUT ANY WARRANTY; without even the implied warranty of
11*63eb84d1Schristos    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
12*63eb84d1Schristos    GNU General Public License for more details.
13*63eb84d1Schristos 
14*63eb84d1Schristos    You should have received a copy of the GNU General Public License
15*63eb84d1Schristos    along with this program; if not, write to the Free Software Foundation,
16*63eb84d1Schristos    Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.  */
17*63eb84d1Schristos 
18*63eb84d1Schristos 
19*63eb84d1Schristos /* The functions defined in this file assume a nearly ASCII compatible
20*63eb84d1Schristos    character set.  */
21*63eb84d1Schristos 
22*63eb84d1Schristos 
23*63eb84d1Schristos #ifdef __cplusplus
24*63eb84d1Schristos extern "C" {
25*63eb84d1Schristos #endif
26*63eb84d1Schristos 
27*63eb84d1Schristos /* Find the first occurrence of NEEDLE in HAYSTACK.
28*63eb84d1Schristos    This function is safe to be called, even in a multibyte locale, if NEEDLE
29*63eb84d1Schristos      1. consists solely of printable ASCII characters excluding '\\' and '~'
30*63eb84d1Schristos         [this restriction is needed because of Shift_JIS and JOHAB]
31*63eb84d1Schristos         or of the control ASCII characters '\a' '\b' '\f' '\n' '\r' '\t' '\v'
32*63eb84d1Schristos         [this restriction is needed because of VISCII], and
33*63eb84d1Schristos      2. has at least length 2
34*63eb84d1Schristos         [this restriction is needed because of BIG5, BIG5-HKSCS, GBK, GB18030,
35*63eb84d1Schristos          Shift_JIS, JOHAB], and
36*63eb84d1Schristos      3. does not consist entirely of decimal digits, or has at least length 4
37*63eb84d1Schristos         [this restricion is needed because of GB18030].
38*63eb84d1Schristos    This function is also safe to be called, even in a multibyte locale, if
39*63eb84d1Schristos    HAYSTACK and NEEDLE are known to both consist solely of printable ASCII
40*63eb84d1Schristos    characters excluding '\\' and '~'.  */
41*63eb84d1Schristos extern char *c_strstr (const char *haystack, const char *needle);
42*63eb84d1Schristos 
43*63eb84d1Schristos #ifdef __cplusplus
44*63eb84d1Schristos }
45*63eb84d1Schristos #endif
46