]> git.saurik.com Git - apple/libc.git/blame - include/regex.h
Libc-825.40.1.tar.gz
[apple/libc.git] / include / regex.h
CommitLineData
e9ce8d39 1/*
ad3c9f2a 2 * Copyright (c) 2000, 2011 Apple Inc. All rights reserved.
e9ce8d39
A
3 *
4 * @APPLE_LICENSE_HEADER_START@
5 *
734aad71
A
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
e9ce8d39
A
15 * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
16 * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
734aad71
A
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.
e9ce8d39
A
20 *
21 * @APPLE_LICENSE_HEADER_END@
22 */
ad3c9f2a
A
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 */
5b2abdfb
A
50/*-
51 * Copyright (c) 1992 Henry Spencer.
52 * Copyright (c) 1992, 1993
e9ce8d39
A
53 * The Regents of the University of California. All rights reserved.
54 *
55 * This code is derived from software contributed to Berkeley by
5b2abdfb 56 * Henry Spencer of the University of Toronto.
e9ce8d39
A
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.
5b2abdfb
A
85 *
86 * @(#)regex.h 8.2 (Berkeley) 1/3/94
e9ce8d39
A
87 */
88
5b2abdfb
A
89#ifndef _REGEX_H_
90#define _REGEX_H_
e9ce8d39 91
3d9156a7 92#include <_types.h>
ad3c9f2a 93#include <Availability.h>
e9ce8d39 94
ad3c9f2a 95/*********/
5b2abdfb 96/* types */
ad3c9f2a
A
97/*********/
98#if __DARWIN_C_LEVEL >= __DARWIN_C_FULL
99#ifndef __cplusplus
100#ifndef _WCHAR_T
101#define _WCHAR_T
102typedef __darwin_wchar_t wchar_t;
103#endif /* _WCHAR_T */
104#endif /* __cplusplus */
105#endif /* __DARWIN_C_LEVEL >= __DARWIN_C_FULL */
106
3d9156a7 107typedef __darwin_off_t regoff_t;
59e0d9fe 108
3d9156a7
A
109#ifndef _SIZE_T
110#define _SIZE_T
111typedef __darwin_size_t size_t;
59e0d9fe 112#endif
e9ce8d39 113
5b2abdfb
A
114typedef struct {
115 int re_magic;
116 size_t re_nsub; /* number of parenthesized subexpressions */
59e0d9fe 117 const char *re_endp; /* end pointer for REG_PEND */
5b2abdfb
A
118 struct re_guts *re_g; /* none of your business :-) */
119} regex_t;
e9ce8d39 120
5b2abdfb
A
121typedef struct {
122 regoff_t rm_so; /* start of match */
123 regoff_t rm_eo; /* end of match */
124} regmatch_t;
e9ce8d39 125
ad3c9f2a 126/*******************/
5b2abdfb 127/* regcomp() flags */
ad3c9f2a
A
128/*******************/
129#if __DARWIN_C_LEVEL >= __DARWIN_C_FULL
130#define REG_BASIC 0000 /* Basic regular expressions (synonym for 0) */
131#endif /* __DARWIN_C_LEVEL >= __DARWIN_C_FULL */
132
133#define REG_EXTENDED 0001 /* Extended regular expressions */
134#define REG_ICASE 0002 /* Compile ignoring upper/lower case */
135#define REG_NOSUB 0004 /* Compile only reporting success/failure */
136#define REG_NEWLINE 0010 /* Compile for newline-sensitive matching */
137
138#if __DARWIN_C_LEVEL >= __DARWIN_C_FULL
139#define REG_NOSPEC 0020 /* Compile turning off all special characters */
140
141#if __MAC_OS_X_VERSION_MIN_REQUIRED >= __MAC_10_8 \
142 || __IPHONE_OS_VERSION_MIN_REQUIRED >= __IPHONE_6_0
143#define REG_LITERAL REG_NOSPEC
144#endif
145
146#define REG_PEND 0040 /* Use re_endp as end pointer */
5b2abdfb 147
ad3c9f2a
A
148#if __MAC_OS_X_VERSION_MIN_REQUIRED >= __MAC_10_8 \
149 || __IPHONE_OS_VERSION_MIN_REQUIRED >= __IPHONE_6_0
150#define REG_MINIMAL 0100 /* Compile using minimal repetition */
151#define REG_UNGREEDY REG_MINIMAL
152#endif
153
154#define REG_DUMP 0200 /* Unused */
155
156#if __MAC_OS_X_VERSION_MIN_REQUIRED >= __MAC_10_8 \
157 || __IPHONE_OS_VERSION_MIN_REQUIRED >= __IPHONE_6_0
158#define REG_ENHANCED 0400 /* Additional (non-POSIX) features */
159#endif
160#endif /* __DARWIN_C_LEVEL >= __DARWIN_C_FULL */
161
162/********************/
5b2abdfb 163/* regerror() flags */
ad3c9f2a 164/********************/
59e0d9fe 165#define REG_ENOSYS (-1) /* Reserved */
ad3c9f2a
A
166#define REG_NOMATCH 1 /* regexec() function failed to match */
167#define REG_BADPAT 2 /* invalid regular expression */
168#define REG_ECOLLATE 3 /* invalid collating element */
169#define REG_ECTYPE 4 /* invalid character class */
170#define REG_EESCAPE 5 /* trailing backslash (\) */
171#define REG_ESUBREG 6 /* invalid backreference number */
172#define REG_EBRACK 7 /* brackets ([ ]) not balanced */
173#define REG_EPAREN 8 /* parentheses not balanced */
174#define REG_EBRACE 9 /* braces not balanced */
175#define REG_BADBR 10 /* invalid repetition count(s) */
176#define REG_ERANGE 11 /* invalid character range */
177#define REG_ESPACE 12 /* out of memory */
178#define REG_BADRPT 13 /* repetition-operator operand invalid */
179
180#if __DARWIN_C_LEVEL >= __DARWIN_C_FULL
181#define REG_EMPTY 14 /* Unused */
182#define REG_ASSERT 15 /* Unused */
183#define REG_INVARG 16 /* invalid argument to regex routine */
184#define REG_ILLSEQ 17 /* illegal byte sequence */
185
5b2abdfb
A
186#define REG_ATOI 255 /* convert name to number (!) */
187#define REG_ITOA 0400 /* convert number to name (!) */
ad3c9f2a 188#endif /* __DARWIN_C_LEVEL >= __DARWIN_C_FULL */
5b2abdfb 189
ad3c9f2a 190/*******************/
5b2abdfb 191/* regexec() flags */
ad3c9f2a
A
192/*******************/
193#define REG_NOTBOL 00001 /* First character not at beginning of line */
194#define REG_NOTEOL 00002 /* Last character not at end of line */
195
196#if __DARWIN_C_LEVEL >= __DARWIN_C_FULL
197#define REG_STARTEND 00004 /* String start/end in pmatch[0] */
198#define REG_TRACE 00400 /* Unused */
199#define REG_LARGE 01000 /* Unused */
5b2abdfb 200#define REG_BACKR 02000 /* force use of backref code */
ad3c9f2a
A
201
202#if __MAC_OS_X_VERSION_MIN_REQUIRED >= __MAC_10_8 \
203 || __IPHONE_OS_VERSION_MIN_REQUIRED >= __IPHONE_6_0
204#define REG_BACKTRACKING_MATCHER REG_BACKR
205#endif
206#endif /* __DARWIN_C_LEVEL >= __DARWIN_C_FULL */
5b2abdfb
A
207
208__BEGIN_DECLS
224c7076
A
209//Begin-Libc
210#ifndef LIBC_ALIAS_REGCOMP
211//End-Libc
3d9156a7 212int regcomp(regex_t * __restrict, const char * __restrict, int) __DARWIN_ALIAS(regcomp);
224c7076
A
213//Begin-Libc
214#else /* LIBC_ALIAS_REGCOMP */
215int regcomp(regex_t * __restrict, const char * __restrict, int) LIBC_ALIAS(regcomp);
216#endif /* !LIBC_ALIAS_REGCOMP */
217//End-Libc
59e0d9fe 218size_t regerror(int, const regex_t * __restrict, char * __restrict, size_t);
224c7076
A
219/*
220 * gcc under c99 mode won't compile "[ __restrict]" by itself. As a workaround,
221 * a dummy argument name is added.
222 */
223int regexec(const regex_t * __restrict, const char * __restrict, size_t,
224 regmatch_t __pmatch[ __restrict], int);
9385eb3d 225void regfree(regex_t *);
ad3c9f2a
A
226
227#if __DARWIN_C_LEVEL >= __DARWIN_C_FULL
228
229/* Darwin extensions */
230int regncomp(regex_t * __restrict, const char * __restrict, size_t, int)
231 __OSX_AVAILABLE_STARTING(__MAC_10_8, __IPHONE_6_0);
232int regnexec(const regex_t * __restrict, const char * __restrict, size_t,
233 size_t, regmatch_t __pmatch[ __restrict], int)
234 __OSX_AVAILABLE_STARTING(__MAC_10_8, __IPHONE_6_0);
235int regwcomp(regex_t * __restrict, const wchar_t * __restrict, int)
236 __OSX_AVAILABLE_STARTING(__MAC_10_8, __IPHONE_6_0);
237int regwexec(const regex_t * __restrict, const wchar_t * __restrict, size_t,
238 regmatch_t __pmatch[ __restrict], int)
239 __OSX_AVAILABLE_STARTING(__MAC_10_8, __IPHONE_6_0);
240int regwncomp(regex_t * __restrict, const wchar_t * __restrict, size_t, int)
241 __OSX_AVAILABLE_STARTING(__MAC_10_8, __IPHONE_6_0);
242int regwnexec(const regex_t * __restrict, const wchar_t * __restrict,
243 size_t, size_t, regmatch_t __pmatch[ __restrict], int)
244 __OSX_AVAILABLE_STARTING(__MAC_10_8, __IPHONE_6_0);
245
246#endif /* __DARWIN_C_LEVEL >= __DARWIN_C_FULL */
5b2abdfb 247__END_DECLS
e9ce8d39 248
ad3c9f2a
A
249#ifdef _USE_EXTENDED_LOCALES_
250#include <xlocale/_regex.h>
251#endif /* _USE_EXTENDED_LOCALES_ */
252
5b2abdfb 253#endif /* !_REGEX_H_ */