include/regex.h

   1 /*-
   2  * SPDX-License-Identifier: BSD-3-Clause
   3  *
   4  * Copyright (c) 1992 Henry Spencer.
   5  * Copyright (c) 1992, 1993
   6  *      The Regents of the University of California.  All rights reserved.
   7  *
   8  * This code is derived from software contributed to Berkeley by
   9  * Henry Spencer of the University of Toronto.
  10  *
  11  * Redistribution and use in source and binary forms, with or without
  12  * modification, are permitted provided that the following conditions
  13  * are met:
  14  * 1. Redistributions of source code must retain the above copyright
  15  *    notice, this list of conditions and the following disclaimer.
  16  * 2. Redistributions in binary form must reproduce the above copyright
  17  *    notice, this list of conditions and the following disclaimer in the
  18  *    documentation and/or other materials provided with the distribution.
  19  * 3. Neither the name of the University nor the names of its contributors
  20  *    may be used to endorse or promote products derived from this software
  21  *    without specific prior written permission.
  22  *
  23  * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
  24  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  25  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  26  * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
  27  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  28  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  29  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  30  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  31  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  32  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  33  * SUCH DAMAGE.
  34  *
  35  *      @(#)regex.h     8.2 (Berkeley) 1/3/94
  36  * $FreeBSD$
  37  */
  38
  39 #ifndef _REGEX_H_
  40 #define _REGEX_H_
  41
  42 #include <sys/cdefs.h>
  43 #include <sys/_types.h>
  44
  45 /* types */
  46 typedef __off_t         regoff_t;
  47
  48 #ifndef _SIZE_T_DECLARED
  49 typedef __size_t        size_t;
  50 #define _SIZE_T_DECLARED
  51 #endif
  52
  53 typedef struct {
  54         int re_magic;
  55         size_t re_nsub;         /* number of parenthesized subexpressions */
  56         const char *re_endp;    /* end pointer for REG_PEND */
  57         struct re_guts *re_g;   /* none of your business :-) */
  58 } regex_t;
  59
  60 typedef struct {
  61         regoff_t rm_so;         /* start of match */
  62         regoff_t rm_eo;         /* end of match */
  63 } regmatch_t;
  64
  65 /* regcomp() flags */
  66 #define REG_BASIC       0000
  67 #define REG_EXTENDED    0001
  68 #define REG_ICASE       0002
  69 #define REG_NOSUB       0004
  70 #define REG_NEWLINE     0010
  71 #define REG_NOSPEC      0020
  72 #define REG_PEND        0040
  73 #define REG_DUMP        0200
  74
  75 /* regerror() flags */
  76 #define REG_ENOSYS      (-1)
  77 #define REG_NOMATCH      1
  78 #define REG_BADPAT       2
  79 #define REG_ECOLLATE     3
  80 #define REG_ECTYPE       4
  81 #define REG_EESCAPE      5
  82 #define REG_ESUBREG      6
  83 #define REG_EBRACK       7
  84 #define REG_EPAREN       8
  85 #define REG_EBRACE       9
  86 #define REG_BADBR       10
  87 #define REG_ERANGE      11
  88 #define REG_ESPACE      12
  89 #define REG_BADRPT      13
  90 #define REG_EMPTY       14
  91 #define REG_ASSERT      15
  92 #define REG_INVARG      16
  93 #define REG_ILLSEQ      17
  94 #define REG_ATOI        255     /* convert name to number (!) */
  95 #define REG_ITOA        0400    /* convert number to name (!) */
  96
  97 /* regexec() flags */
  98 #define REG_NOTBOL      00001
  99 #define REG_NOTEOL      00002
 100 #define REG_STARTEND    00004
 101 #define REG_TRACE       00400   /* tracing of execution */
 102 #define REG_LARGE       01000   /* force large representation */
 103 #define REG_BACKR       02000   /* force use of backref code */
 104
 105 __BEGIN_DECLS
 106 int     regcomp(regex_t * __restrict, const char * __restrict, int);
 107 size_t  regerror(int, const regex_t * __restrict, char * __restrict, size_t);
 108 /*
 109  * XXX forth parameter should be `regmatch_t [__restrict]', but isn't because
 110  * of a bug in GCC 3.2 (when -std=c99 is specified) which perceives this as a
 111  * syntax error.
 112  */
 113 int     regexec(const regex_t * __restrict, const char * __restrict, size_t,
 114             regmatch_t * __restrict, int);
 115 void    regfree(regex_t *);
 116 __END_DECLS
 117
 118 #endif /* !_REGEX_H_ */