include/regex.h

   1 /*
   2  * CDDL HEADER START
   3  *
   4  * The contents of this file are subject to the terms of the
   5  * Common Development and Distribution License, Version 1.0 only
   6  * (the "License").  You may not use this file except in compliance
   7  * with the License.
   8  *
   9  * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
  10  * or http://www.opensolaris.org/os/licensing.
  11  * See the License for the specific language governing permissions
  12  * and limitations under the License.
  13  *
  14  * When distributing Covered Code, include this CDDL HEADER in each
  15  * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
  16  * If applicable, add the following below this CDDL HEADER, with the
  17  * fields enclosed by brackets "[]" replaced with your own identifying
  18  * information: Portions Copyright [yyyy] [name of copyright owner]
  19  *
  20  * CDDL HEADER END
  21  */
  22
  23 /*
  24  * Copyright 2014 Garrett D'Amore <garrett@damore.org>
  25  *
  26  * Copyright 2005 Sun Microsystems, Inc.  All rights reserved.
  27  * Use is subject to license terms.
  28  */
  29
  30 /*
  31  * Copyright 1989, 1994 by Mortice Kern Systems Inc.
  32  * All rights reserved.
  33  */
  34
  35 /*
  36  * Copyright 2017 Nexenta Systems, Inc.
  37  */
  38
  39 #ifndef _REGEX_H
  40 #define _REGEX_H
  41
  42 #include <sys/feature_tests.h>
  43 #include <sys/types.h>
  44
  45 #ifdef  __cplusplus
  46 extern "C" {
  47 #endif
  48
  49
  50 /*
  51  * wchar_t is a built-in type in standard C++ and as such is not
  52  * defined here when using standard C++. However, the GNU compiler
  53  * fixincludes utility nonetheless creates its own version of this
  54  * header for use by gcc and g++. In that version it adds a redundant
  55  * guard for __cplusplus. To avoid the creation of a gcc/g++ specific
  56  * header we need to include the following magic comment:
  57  *
  58  * we must use the C++ compiler's type
  59  *
  60  * The above comment should not be removed or changed until GNU
  61  * gcc/fixinc/inclhack.def is updated to bypass this header.
  62  */
  63 #if !defined(__cplusplus) || (__cplusplus < 199711L && !defined(__GNUG__))
  64 #ifndef _WCHAR_T
  65 #define _WCHAR_T
  66 #if defined(_LP64)
  67 typedef int     wchar_t;
  68 #else
  69 typedef long    wchar_t;
  70 #endif
  71 #endif  /* !_WCHAR_T */
  72 #endif  /* !defined(__cplusplus) ... */
  73
  74 typedef ssize_t regoff_t;
  75
  76 /* regcomp flags */
  77 #define REG_BASIC       0x00000
  78 #define REG_EXTENDED    0x00001         /* Use Extended Regular Expressions */
  79 #define REG_NOSUB       0x00002         /* Don't set subexpression */
  80 #define REG_ICASE       0x00004         /* Ignore case in match */
  81 #define REG_NEWLINE     0x00008         /* Treat \n as regular character */
  82 #define REG_DELIM       0x00010         /* legacy, no effect */
  83 #define REG_DEBUG       0x00020         /* legacy, no effect */
  84 #define REG_ANCHOR      0x00040         /* legacy, no effect */
  85 #define REG_WORDS       0x00080         /* legacy, no effect */
  86 #define REG_EGREP       0x01000         /* legacy, no effect */
  87 #define REG_DUMP        0x02000         /* internal */
  88 #define REG_PEND        0x04000         /* NULs are ordinary characters */
  89 #define REG_NOSPEC      0x08000         /* no special characters */
  90
  91 /* internal flags */
  92 #define REG_MUST        0x00100         /* legacy, no effect */
  93
  94 /* regexec flags */
  95 #define REG_NOTBOL      0x00200         /* string is not BOL */
  96 #define REG_NOTEOL      0x00400         /* string has no EOL */
  97 #define REG_NOOPT       0x00800         /* legacy, no effect */
  98 #define REG_STARTEND    0x10000         /* match whole pattern */
  99 #define REG_TRACE       0x20000         /* tracing of execution */
 100 #define REG_LARGE       0x40000         /* force large representation */
 101 #define REG_BACKR       0x80000         /* force use of backref code */
 102
 103 /* regcomp and regexec return codes */
 104 #define REG_OK          0               /* success (non-standard) */
 105 #define REG_NOMATCH     1               /* regexec failed to match */
 106 #define REG_ECOLLATE    2               /* invalid collation element ref. */
 107 #define REG_EESCAPE     3               /* trailing \ in pattern */
 108 #define REG_ENEWLINE    4               /* \n found before end of pattern */
 109 #define REG_ENSUB       5               /* more than 9 \( \) pairs (OBS) */
 110 #define REG_ESUBREG     6               /* number in \[0-9] invalid */
 111 #define REG_EBRACK      7               /* [ ] imbalance */
 112 #define REG_EPAREN      8               /* ( ) imbalance */
 113 #define REG_EBRACE      9               /* \{ \} imbalance */
 114 #define REG_ERANGE      10              /* invalid endpoint in range */
 115 #define REG_ESPACE      11              /* no memory for compiled pattern */
 116 #define REG_BADRPT      12              /* invalid repetition */
 117 #define REG_ECTYPE      13              /* invalid char-class type */
 118 #define REG_BADPAT      14              /* syntax error */
 119 #define REG_BADBR       15              /* \{ \} contents bad */
 120 #define REG_EFATAL      16              /* internal error, not POSIX.2 */
 121 #define REG_ECHAR       17              /* invalid multibyte character */
 122 #define REG_STACK       18              /* backtrack stack overflow */
 123 #define REG_ENOSYS      19              /* function not supported (XPG4) */
 124 #define REG__LAST       20              /* first unused code */
 125 #define REG_EBOL        21              /* ^ anchor and not BOL */
 126 #define REG_EEOL        22              /* $ anchor and not EOL */
 127 #define REG_ATOI        255             /* convert name to number (!) */
 128 #define REG_ITOA        256             /* convert number to name (!) */
 129
 130 #define _REG_BACKREF_MAX 9              /* Max # of subexp. backreference */
 131
 132 typedef struct {                /* regcomp() data saved for regexec() */
 133         size_t  re_nsub;        /* # of subexpressions in RE pattern */
 134
 135         /*
 136          * Internal use only.  Note that any changes to this structure
 137          * have to preserve sizing, as it is baked into applications.
 138          */
 139         struct re_guts *re_g;
 140         int re_magic;
 141         const char *re_endp;
 142
 143         /* here for compat */
 144         size_t  re_len;         /* # wchar_t chars in compiled pattern */
 145         struct _regex_ext_t *re_sc;     /* for binary compatibility */
 146 } regex_t;
 147
 148 /* subexpression positions */
 149 typedef struct {
 150         const char      *rm_sp, *rm_ep; /* Start pointer, end pointer */
 151         regoff_t        rm_so, rm_eo;   /* Start offset, end offset */
 152         int             rm_ss, rm_es;   /* Used internally */
 153 } regmatch_t;
 154
 155
 156 /*
 157  * IEEE Std 1003.2 ("POSIX.2") regular expressions API.
 158  */
 159
 160 extern int regcomp(regex_t *_RESTRICT_KYWD, const char *_RESTRICT_KYWD, int);
 161 extern int regexec(const regex_t *_RESTRICT_KYWD, const char *_RESTRICT_KYWD,
 162     size_t, regmatch_t *_RESTRICT_KYWD, int);
 163 extern size_t regerror(int, const regex_t *_RESTRICT_KYWD, char *_RESTRICT_KYWD,
 164     size_t);
 165 extern void regfree(regex_t *);
 166
 167 #ifdef  __cplusplus
 168 }
 169 #endif
 170
 171 #endif  /* _REGEX_H */