1 /*
2  * Copyright (c) 2000, 2011 Apple Inc. All rights reserved.
3  *
4  * @APPLE_LICENSE_HEADER_START@
5  *
6  * This file contains Original Code and/or Modifications of Original Code
7  * as defined in and that are subject to the Apple Public Source License
8  * Version 2.0 (the 'License'). You may not use this file except in
9  * compliance with the License. Please obtain a copy of the License at
10  * http://www.opensource.apple.com/apsl/ and read it before using this
11  * file.
12  *
13  * The Original Code and all software distributed under the License are
14  * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
15  * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
16  * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
17  * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
18  * Please see the License for the specific language governing rights and
19  * limitations under the License.
20  *
21  * @APPLE_LICENSE_HEADER_END@
22  */
23 /*
24  * Copyright (c) 2001-2009 Ville Laurikari <vl@iki.fi>
25  * All rights reserved.
26  *
27  * Redistribution and use in source and binary forms, with or without
28  * modification, are permitted provided that the following conditions
29  * are met:
30  *
31  *   1. Redistributions of source code must retain the above copyright
32  *      notice, this list of conditions and the following disclaimer.
33  *
34  *   2. Redistributions in binary form must reproduce the above copyright
35  *      notice, this list of conditions and the following disclaimer in the
36  *      documentation and/or other materials provided with the distribution.
37  *
38  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDER AND CONTRIBUTORS
39  * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
40  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
41  * A PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE COPYRIGHT
42  * HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
43  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
44  * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
45  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
46  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
47  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
48  * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
49  */
50 /*-
51  * Copyright (c) 1992 Henry Spencer.
52  * Copyright (c) 1992, 1993
53  *	The Regents of the University of California.  All rights reserved.
54  *
55  * This code is derived from software contributed to Berkeley by
56  * Henry Spencer of the University of Toronto.
57  *
58  * Redistribution and use in source and binary forms, with or without
59  * modification, are permitted provided that the following conditions
60  * are met:
61  * 1. Redistributions of source code must retain the above copyright
62  *    notice, this list of conditions and the following disclaimer.
63  * 2. Redistributions in binary form must reproduce the above copyright
64  *    notice, this list of conditions and the following disclaimer in the
65  *    documentation and/or other materials provided with the distribution.
66  * 3. All advertising materials mentioning features or use of this software
67  *    must display the following acknowledgement:
68  *	This product includes software developed by the University of
69  *	California, Berkeley and its contributors.
70  * 4. Neither the name of the University nor the names of its contributors
71  *    may be used to endorse or promote products derived from this software
72  *    without specific prior written permission.
73  *
74  * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
75  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
76  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
77  * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
78  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
79  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
80  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
81  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
82  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
83  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
84  * SUCH DAMAGE.
85  *
86  *	@(#)regex.h	8.2 (Berkeley) 1/3/94
87  */
88 
89 #ifndef _REGEX_H_
90 #define	_REGEX_H_
91 
92 #include <_regex.h>
93 
94 /*******************/
95 /* regcomp() flags */
96 /*******************/
97 #if __DARWIN_C_LEVEL >= __DARWIN_C_FULL
98 #define	REG_BASIC	0000	/* Basic regular expressions (synonym for 0) */
99 #endif /* __DARWIN_C_LEVEL >= __DARWIN_C_FULL */
100 
101 #define	REG_EXTENDED	0001	/* Extended regular expressions */
102 #define	REG_ICASE	0002	/* Compile ignoring upper/lower case */
103 #define	REG_NOSUB	0004	/* Compile only reporting success/failure */
104 #define	REG_NEWLINE	0010	/* Compile for newline-sensitive matching */
105 
106 #if __DARWIN_C_LEVEL >= __DARWIN_C_FULL
107 #define	REG_NOSPEC	0020	/* Compile turning off all special characters */
108 
109 #if __MAC_OS_X_VERSION_MIN_REQUIRED  >= __MAC_10_8 \
110  || __IPHONE_OS_VERSION_MIN_REQUIRED >= __IPHONE_6_0 \
111  || defined(__DRIVERKIT_VERSION_MIN_REQUIRED)
112 #define	REG_LITERAL	REG_NOSPEC
113 #endif
114 
115 #define	REG_PEND	0040	/* Use re_endp as end pointer */
116 
117 #if __MAC_OS_X_VERSION_MIN_REQUIRED  >= __MAC_10_8 \
118  || __IPHONE_OS_VERSION_MIN_REQUIRED >= __IPHONE_6_0 \
119  || defined(__DRIVERKIT_VERSION_MIN_REQUIRED)
120 #define	REG_MINIMAL	0100	/* Compile using minimal repetition */
121 #define	REG_UNGREEDY	REG_MINIMAL
122 #endif
123 
124 #define	REG_DUMP	0200	/* Unused */
125 
126 #if __MAC_OS_X_VERSION_MIN_REQUIRED  >= __MAC_10_8 \
127  || __IPHONE_OS_VERSION_MIN_REQUIRED >= __IPHONE_6_0 \
128  || defined(__DRIVERKIT_VERSION_MIN_REQUIRED)
129 #define	REG_ENHANCED	0400	/* Additional (non-POSIX) features */
130 #endif
131 #endif /* __DARWIN_C_LEVEL >= __DARWIN_C_FULL */
132 
133 /********************/
134 /* regerror() flags */
135 /********************/
136 #define	REG_ENOSYS	 (-1)	/* Reserved */
137 #define	REG_NOMATCH	 1	/* regexec() function failed to match */
138 #define	REG_BADPAT	 2	/* invalid regular expression */
139 #define	REG_ECOLLATE	 3	/* invalid collating element */
140 #define	REG_ECTYPE	 4	/* invalid character class */
141 #define	REG_EESCAPE	 5	/* trailing backslash (\) */
142 #define	REG_ESUBREG	 6	/* invalid backreference number */
143 #define	REG_EBRACK	 7	/* brackets ([ ]) not balanced */
144 #define	REG_EPAREN	 8	/* parentheses not balanced */
145 #define	REG_EBRACE	 9	/* braces not balanced */
146 #define	REG_BADBR	10	/* invalid repetition count(s) */
147 #define	REG_ERANGE	11	/* invalid character range */
148 #define	REG_ESPACE	12	/* out of memory */
149 #define	REG_BADRPT	13	/* repetition-operator operand invalid */
150 
151 #if __DARWIN_C_LEVEL >= __DARWIN_C_FULL
152 #define	REG_EMPTY	14	/* Unused */
153 #define	REG_ASSERT	15	/* Unused */
154 #define	REG_INVARG	16	/* invalid argument to regex routine */
155 #define	REG_ILLSEQ	17	/* illegal byte sequence */
156 
157 #define	REG_ATOI	255	/* convert name to number (!) */
158 #define	REG_ITOA	0400	/* convert number to name (!) */
159 #endif /* __DARWIN_C_LEVEL >= __DARWIN_C_FULL */
160 
161 /*******************/
162 /* regexec() flags */
163 /*******************/
164 #define	REG_NOTBOL	00001	/* First character not at beginning of line */
165 #define	REG_NOTEOL	00002	/* Last character not at end of line */
166 
167 #if __DARWIN_C_LEVEL >= __DARWIN_C_FULL
168 #define	REG_STARTEND	00004	/* String start/end in pmatch[0] */
169 #define	REG_TRACE	00400	/* Unused */
170 #define	REG_LARGE	01000	/* Unused */
171 #define	REG_BACKR	02000	/* force use of backref code */
172 
173 #if __MAC_OS_X_VERSION_MIN_REQUIRED  >= __MAC_10_8 \
174  || __IPHONE_OS_VERSION_MIN_REQUIRED >= __IPHONE_6_0 \
175  || defined(__DRIVERKIT_VERSION_MIN_REQUIRED)
176 #define	REG_BACKTRACKING_MATCHER	REG_BACKR
177 #endif
178 #endif /* __DARWIN_C_LEVEL >= __DARWIN_C_FULL */
179 
180 __BEGIN_DECLS
181 int	regcomp(regex_t * __restrict, const char * __restrict, int) __DARWIN_ALIAS(regcomp);
182 size_t	regerror(int, const regex_t * __restrict, char * __restrict, size_t) __cold;
183 /*
184  * gcc under c99 mode won't compile "[ __restrict]" by itself.  As a workaround,
185  * a dummy argument name is added.
186  */
187 int	regexec(const regex_t * __restrict, const char * __restrict, size_t,
188 	    regmatch_t __pmatch[ __restrict], int);
189 void	regfree(regex_t *);
190 
191 #if __DARWIN_C_LEVEL >= __DARWIN_C_FULL
192 
193 /* Darwin extensions */
194 int	regncomp(regex_t * __restrict, const char * __restrict, size_t, int)
195 	    __OSX_AVAILABLE_STARTING(__MAC_10_8, __IPHONE_6_0);
196 int	regnexec(const regex_t * __restrict, const char * __restrict, size_t,
197 	    size_t, regmatch_t __pmatch[ __restrict], int)
198 	    __OSX_AVAILABLE_STARTING(__MAC_10_8, __IPHONE_6_0);
199 int	regwcomp(regex_t * __restrict, const wchar_t * __restrict, int)
200 	    __OSX_AVAILABLE_STARTING(__MAC_10_8, __IPHONE_6_0);
201 int	regwexec(const regex_t * __restrict, const wchar_t * __restrict, size_t,
202 	    regmatch_t __pmatch[ __restrict], int)
203 	    __OSX_AVAILABLE_STARTING(__MAC_10_8, __IPHONE_6_0);
204 int	regwncomp(regex_t * __restrict, const wchar_t * __restrict, size_t, int)
205 	    __OSX_AVAILABLE_STARTING(__MAC_10_8, __IPHONE_6_0);
206 int	regwnexec(const regex_t * __restrict, const wchar_t * __restrict,
207 	    size_t, size_t, regmatch_t __pmatch[ __restrict], int)
208 	    __OSX_AVAILABLE_STARTING(__MAC_10_8, __IPHONE_6_0);
209 
210 #endif /* __DARWIN_C_LEVEL >= __DARWIN_C_FULL */
211 __END_DECLS
212 
213 #ifdef _USE_EXTENDED_LOCALES_
214 #include <xlocale/_regex.h>
215 #endif /* _USE_EXTENDED_LOCALES_ */
216 
217 #endif /* !_REGEX_H_ */