include/regex.h

   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 <_types.h>
  93 #include <Availability.h>
  94
  95 /*********/
  96 /* types */
  97 /*********/
  98 #if __DARWIN_C_LEVEL >= __DARWIN_C_FULL
  99 #ifndef __cplusplus
 100 #ifndef _WCHAR_T
 101 #define _WCHAR_T
 102 typedef __darwin_wchar_t        wchar_t;
 103 #endif  /* _WCHAR_T */
 104 #endif  /* __cplusplus */
 105 #endif /* __DARWIN_C_LEVEL >= __DARWIN_C_FULL */
 106
 107 typedef __darwin_off_t regoff_t;
 108
 109 #ifndef _SIZE_T
 110 #define _SIZE_T
 111 typedef __darwin_size_t size_t;
 112 #endif
 113
 114 typedef struct {
 115         int re_magic;
 116         size_t re_nsub;         /* number of parenthesized subexpressions */
 117         const char *re_endp;    /* end pointer for REG_PEND */
 118         struct re_guts *re_g;   /* none of your business :-) */
 119 } regex_t;
 120
 121 typedef struct {
 122         regoff_t rm_so;         /* start of match */
 123         regoff_t rm_eo;         /* end of match */
 124 } regmatch_t;
 125
 126 /*******************/
 127 /* regcomp() flags */
 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 */
 147
 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 /********************/
 163 /* regerror() flags */
 164 /********************/
 165 #define REG_ENOSYS       (-1)   /* Reserved */
 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
 186 #define REG_ATOI        255     /* convert name to number (!) */
 187 #define REG_ITOA        0400    /* convert number to name (!) */
 188 #endif /* __DARWIN_C_LEVEL >= __DARWIN_C_FULL */
 189
 190 /*******************/
 191 /* regexec() flags */
 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 */
 200 #define REG_BACKR       02000   /* force use of backref code */
 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 */
 207
 208 __BEGIN_DECLS
 209 //Begin-Libc
 210 #ifndef LIBC_ALIAS_REGCOMP
 211 //End-Libc
 212 int     regcomp(regex_t * __restrict, const char * __restrict, int) __DARWIN_ALIAS(regcomp);
 213 //Begin-Libc
 214 #else /* LIBC_ALIAS_REGCOMP */
 215 int     regcomp(regex_t * __restrict, const char * __restrict, int) LIBC_ALIAS(regcomp);
 216 #endif /* !LIBC_ALIAS_REGCOMP */
 217 //End-Libc
 218 size_t  regerror(int, const regex_t * __restrict, char * __restrict, size_t);
 219 /*
 220  * gcc under c99 mode won't compile "[ __restrict]" by itself.  As a workaround,
 221  * a dummy argument name is added.
 222  */
 223 int     regexec(const regex_t * __restrict, const char * __restrict, size_t,
 224             regmatch_t __pmatch[ __restrict], int);
 225 void    regfree(regex_t *);
 226
 227 #if __DARWIN_C_LEVEL >= __DARWIN_C_FULL
 228
 229 /* Darwin extensions */
 230 int     regncomp(regex_t * __restrict, const char * __restrict, size_t, int)
 231             __OSX_AVAILABLE_STARTING(__MAC_10_8, __IPHONE_6_0);
 232 int     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);
 235 int     regwcomp(regex_t * __restrict, const wchar_t * __restrict, int)
 236             __OSX_AVAILABLE_STARTING(__MAC_10_8, __IPHONE_6_0);
 237 int     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);
 240 int     regwncomp(regex_t * __restrict, const wchar_t * __restrict, size_t, int)
 241             __OSX_AVAILABLE_STARTING(__MAC_10_8, __IPHONE_6_0);
 242 int     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 */
 247 __END_DECLS
 248
 249 #ifdef _USE_EXTENDED_LOCALES_
 250 #include <xlocale/_regex.h>
 251 #endif /* _USE_EXTENDED_LOCALES_ */
 252
 253 #endif /* !_REGEX_H_ */