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/*
90 * Common header for regex.h and xlocale/_regex.h
91 */
92
93#ifndef _REGEX_H_
94#define _REGEX_H_
95#define __REGEX_H_
96
97#include <_bounds.h>
98#include <_types.h>
99#include <Availability.h>
100#include <sys/_types/_size_t.h>
101
102_LIBC_SINGLE_BY_DEFAULT()
103
104/*********/
105/* types */
106/*********/
107#if __DARWIN_C_LEVEL >= __DARWIN_C_FULL
108#include <sys/_types/_wchar_t.h>
109#endif /* __DARWIN_C_LEVEL >= __DARWIN_C_FULL */
110
111typedef __darwin_off_t regoff_t;
112
113typedef struct {
114 int re_magic;
115 size_t re_nsub; /* number of parenthesized subexpressions */
116 const char *_LIBC_UNSAFE_INDEXABLE re_endp; /* end pointer for REG_PEND */
117 struct re_guts *re_g; /* none of your business :-) */
118} regex_t;
119
120typedef struct {
121 regoff_t rm_so; /* start of match */
122 regoff_t rm_eo; /* end of match */
123} regmatch_t;
124
125/*******************/
126/* regcomp() flags */
127/*******************/
128#if __DARWIN_C_LEVEL >= __DARWIN_C_FULL
129#define REG_BASIC 0000 /* Basic regular expressions (synonym for 0) */
130#endif /* __DARWIN_C_LEVEL >= __DARWIN_C_FULL */
131
132#define REG_EXTENDED 0001 /* Extended regular expressions */
133#define REG_ICASE 0002 /* Compile ignoring upper/lower case */
134#define REG_NOSUB 0004 /* Compile only reporting success/failure */
135#define REG_NEWLINE 0010 /* Compile for newline-sensitive matching */
136
137#if __DARWIN_C_LEVEL >= __DARWIN_C_FULL
138#define REG_NOSPEC 0020 /* Compile turning off all special characters */
139
140#if __MAC_OS_X_VERSION_MIN_REQUIRED >= __MAC_10_8 \
141 || __IPHONE_OS_VERSION_MIN_REQUIRED >= __IPHONE_6_0 \
142 || defined(__DRIVERKIT_VERSION_MIN_REQUIRED)
143#define REG_LITERAL REG_NOSPEC
144#endif
145
146#define REG_PEND 0040 /* Use re_endp as end pointer */
147
148#if __MAC_OS_X_VERSION_MIN_REQUIRED >= __MAC_10_8 \
149 || __IPHONE_OS_VERSION_MIN_REQUIRED >= __IPHONE_6_0 \
150 || defined(__DRIVERKIT_VERSION_MIN_REQUIRED)
151#define REG_MINIMAL 0100 /* Compile using minimal repetition */
152#define REG_UNGREEDY REG_MINIMAL
153#endif
154#define REG_DUMP 0200 /* Unused */
155#if __MAC_OS_X_VERSION_MIN_REQUIRED >= __MAC_26_4 \
156 || __IPHONE_OS_VERSION_MIN_REQUIRED >= __IPHONE_26_4 \
157 || defined(__DRIVERKIT_VERSION_MIN_REQUIRED)
158#define REG_USEBYTES REG_DUMP /* Used internally by TRE */
159#endif
160#if __MAC_OS_X_VERSION_MIN_REQUIRED >= __MAC_10_8 \
161 || __IPHONE_OS_VERSION_MIN_REQUIRED >= __IPHONE_6_0 \
162 || defined(__DRIVERKIT_VERSION_MIN_REQUIRED)
163#define REG_ENHANCED 0400 /* Additional (non-POSIX) features */
164#endif
165#endif /* __DARWIN_C_LEVEL >= __DARWIN_C_FULL */
166
167/********************/
168/* regerror() flags */
169/********************/
170#define REG_ENOSYS (-1) /* Reserved */
171#define REG_NOMATCH 1 /* regexec() function failed to match */
172#define REG_BADPAT 2 /* invalid regular expression */
173#define REG_ECOLLATE 3 /* invalid collating element */
174#define REG_ECTYPE 4 /* invalid character class */
175#define REG_EESCAPE 5 /* trailing backslash (\) */
176#define REG_ESUBREG 6 /* invalid backreference number */
177#define REG_EBRACK 7 /* brackets ([ ]) not balanced */
178#define REG_EPAREN 8 /* parentheses not balanced */
179#define REG_EBRACE 9 /* braces not balanced */
180#define REG_BADBR 10 /* invalid repetition count(s) */
181#define REG_ERANGE 11 /* invalid character range */
182#define REG_ESPACE 12 /* out of memory */
183#define REG_BADRPT 13 /* repetition-operator operand invalid */
184
185#if __DARWIN_C_LEVEL >= __DARWIN_C_FULL
186#define REG_EMPTY 14 /* Unused */
187#define REG_ASSERT 15 /* Unused */
188#define REG_INVARG 16 /* invalid argument to regex routine */
189#define REG_ILLSEQ 17 /* illegal byte sequence */
190#define REG_BADMAX 18 /* maximum repetition exceeds RE_DUP_MAX */
191
192#define REG_ATOI 255 /* convert name to number (!) */
193#define REG_ITOA 0400 /* convert number to name (!) */
194#endif /* __DARWIN_C_LEVEL >= __DARWIN_C_FULL */
195
196/*******************/
197/* regexec() flags */
198/*******************/
199#define REG_NOTBOL 00001 /* First character not at beginning of line */
200#define REG_NOTEOL 00002 /* Last character not at end of line */
201
202#if __DARWIN_C_LEVEL >= __DARWIN_C_FULL
203#define REG_STARTEND 00004 /* String start/end in pmatch[0] */
204#define REG_TRACE 00400 /* Unused */
205#define REG_LARGE 01000 /* Unused */
206#if __MAC_OS_X_VERSION_MIN_REQUIRED >= __MAC_26_4 \
207 || __IPHONE_OS_VERSION_MIN_REQUIRED >= __IPHONE_26_4 \
208 || defined(__DRIVERKIT_VERSION_MIN_REQUIRED)
209#define REG_APPROX_MATCHER REG_LARGE /* Used internally by TRE */
210#endif
211#define REG_BACKR 02000 /* force use of backref code */
212#if __MAC_OS_X_VERSION_MIN_REQUIRED >= __MAC_10_8 \
213 || __IPHONE_OS_VERSION_MIN_REQUIRED >= __IPHONE_6_0 \
214 || defined(__DRIVERKIT_VERSION_MIN_REQUIRED)
215#define REG_BACKTRACKING_MATCHER REG_BACKR
216#endif
217#endif /* __DARWIN_C_LEVEL >= __DARWIN_C_FULL */
218
219__BEGIN_DECLS
220int regcomp(regex_t * __restrict, const char * __restrict, int) __DARWIN_ALIAS(regcomp);
221size_t regerror(int, const regex_t * __restrict, char *_LIBC_COUNT(__errbuf_size) __restrict, size_t __errbuf_size) __cold;
222/*
223 * gcc under c99 mode won't compile "[ __restrict]" by itself. As a workaround,
224 * a dummy argument name is added.
225 */
226int regexec(const regex_t * __restrict, const char * __restrict, size_t __nmatch,
227 regmatch_t __pmatch[ __restrict _LIBC_COUNT(__nmatch)], int);
228void regfree(regex_t *);
229
230#if __DARWIN_C_LEVEL >= __DARWIN_C_FULL
231
232/* Darwin extensions */
233int regncomp(regex_t * __restrict, const char *_LIBC_COUNT(__len) __restrict, size_t __len, int)
234 __OSX_AVAILABLE_STARTING(__MAC_10_8, __IPHONE_6_0);
235int regnexec(const regex_t * __restrict, const char *_LIBC_COUNT(__len) __restrict, size_t __len,
236 size_t __nmatch, regmatch_t __pmatch[ __restrict _LIBC_COUNT(__nmatch)], int)
237 __OSX_AVAILABLE_STARTING(__MAC_10_8, __IPHONE_6_0);
238int regwcomp(regex_t * __restrict, const wchar_t * __restrict, int)
239 __OSX_AVAILABLE_STARTING(__MAC_10_8, __IPHONE_6_0);
240int regwexec(const regex_t * __restrict, const wchar_t * __restrict, size_t __nmatch,
241 regmatch_t __pmatch[ __restrict _LIBC_COUNT(__nmatch)], int)
242 __OSX_AVAILABLE_STARTING(__MAC_10_8, __IPHONE_6_0);
243int regwncomp(regex_t * __restrict, const wchar_t * _LIBC_COUNT(__len) __restrict, size_t __len, int)
244 __OSX_AVAILABLE_STARTING(__MAC_10_8, __IPHONE_6_0);
245int regwnexec(const regex_t * __restrict, const wchar_t * _LIBC_COUNT(__len) __restrict,
246 size_t __len, size_t __nmatch, regmatch_t __pmatch[ __restrict _LIBC_COUNT(__nmatch)], int)
247 __OSX_AVAILABLE_STARTING(__MAC_10_8, __IPHONE_6_0);
248
249#endif /* __DARWIN_C_LEVEL >= __DARWIN_C_FULL */
250__END_DECLS
251
252#endif /* !_REGEX_H_ */