home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1993 #2 / Image.iso / os2 / gtak212b.zip / SOURCE.ZIP / 1.10 / regex.h < prev    next >
C/C++ Source or Header  |  1992-09-02  |  11KB  |  274 lines
  1. /*****************************************************************************
  2.  * $Id: regex.h,v 1.2 1992/09/02 20:08:42 ak Exp $
  3.  *****************************************************************************
  4.  * $Log: regex.h,v $
  5.  * Revision 1.2  1992/09/02  20:08:42  ak
  6.  * Version AK200
  7.  * - Tape access
  8.  * - Quick file access
  9.  * - OS/2 extended attributes
  10.  * - Some OS/2 fixes
  11.  * - Some fixes of Kai Uwe Rommel
  12.  *
  13.  * Revision 1.1.1.1  1992/09/02  19:22:33  ak
  14.  * Original GNU Tar 1.10 with some filenames changed for FAT compatibility.
  15.  *
  16.  * Revision 1.1  1992/09/02  19:22:31  ak
  17.  * Initial revision
  18.  *
  19.  *****************************************************************************/
  20.  
  21. /* Definitions for data structures callers pass the regex library.
  22.  
  23.    Copyright (C) 1985, 1989-90 Free Software Foundation, Inc.
  24.  
  25.    This program is free software; you can redistribute it and/or modify
  26.    it under the terms of the GNU General Public License as published by
  27.    the Free Software Foundation; either version 2, or (at your option)
  28.    any later version.
  29.  
  30.    This program is distributed in the hope that it will be useful,
  31.    but WITHOUT ANY WARRANTY; without even the implied warranty of
  32.    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  33.    GNU General Public License for more details.
  34.  
  35.    You should have received a copy of the GNU General Public License
  36.    along with this program; if not, write to the Free Software
  37.    Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.  */
  38.  
  39.  
  40. #ifndef __REGEXP_LIBRARY
  41. #define __REGEXP_LIBRARY
  42.  
  43. /* Define number of parens for which we record the beginnings and ends.
  44.    This affects how much space the `struct re_registers' type takes up.  */
  45. #ifndef RE_NREGS
  46. #define RE_NREGS 10
  47. #endif
  48.  
  49. #define BYTEWIDTH 8
  50.  
  51.  
  52. /* Maximum number of duplicates an interval can allow.  */
  53. #define RE_DUP_MAX  ((1 << 15) - 1) 
  54.  
  55.  
  56. /* This defines the various regexp syntaxes.  */
  57. extern int obscure_syntax;
  58.  
  59.  
  60. /* The following bits are used in the obscure_syntax variable to choose among
  61.    alternative regexp syntaxes.  */
  62.  
  63. /* If this bit is set, plain parentheses serve as grouping, and backslash
  64.      parentheses are needed for literal searching.
  65.    If not set, backslash-parentheses are grouping, and plain parentheses
  66.      are for literal searching.  */
  67. #define RE_NO_BK_PARENS    1
  68.  
  69. /* If this bit is set, plain | serves as the `or'-operator, and \| is a 
  70.      literal.
  71.    If not set, \| serves as the `or'-operator, and | is a literal.  */
  72. #define RE_NO_BK_VBAR (1 << 1)
  73.  
  74. /* If this bit is not set, plain + or ? serves as an operator, and \+, \? are 
  75.      literals.
  76.    If set, \+, \? are operators and plain +, ? are literals.  */
  77. #define RE_BK_PLUS_QM (1 << 2)
  78.  
  79. /* If this bit is set, | binds tighter than ^ or $.
  80.    If not set, the contrary.  */
  81. #define RE_TIGHT_VBAR (1 << 3)
  82.  
  83. /* If this bit is set, then treat newline as an OR operator.
  84.    If not set, treat it as a normal character.  */
  85. #define RE_NEWLINE_OR (1 << 4)
  86.  
  87. /* If this bit is set, then special characters may act as normal
  88.    characters in some contexts. Specifically, this applies to:
  89.     ^ -- only special at the beginning, or after ( or |;
  90.     $ -- only special at the end, or before ) or |;
  91.     *, +, ? -- only special when not after the beginning, (, or |.
  92.    If this bit is not set, special characters (such as *, ^, and $)
  93.    always have their special meaning regardless of the surrounding
  94.    context.  */
  95. #define RE_CONTEXT_INDEP_OPS (1 << 5)
  96.  
  97. /* If this bit is not set, then \ before anything inside [ and ] is taken as 
  98.      a real \.
  99.    If set, then such a \ escapes the following character.  This is a
  100.      special case for awk.  */
  101. #define RE_AWK_CLASS_HACK (1 << 6)
  102.  
  103. /* If this bit is set, then \{ and \} or { and } serve as interval operators.
  104.    If not set, then \{ and \} and { and } are treated as literals.  */
  105. #define RE_INTERVALS (1 << 7)
  106.  
  107. /* If this bit is not set, then \{ and \} serve as interval operators and 
  108.      { and } are literals.
  109.    If set, then { and } serve as interval operators and \{ and \} are 
  110.      literals.  */
  111. #define RE_NO_BK_CURLY_BRACES (1 << 8)
  112.  
  113. /* If this bit is set, then character classes are supported; they are:
  114.      [:alpha:],    [:upper:], [:lower:],  [:digit:], [:alnum:], [:xdigit:],
  115.      [:space:], [:print:], [:punct:], [:graph:], and [:cntrl:].
  116.    If not set, then character classes are not supported.  */
  117. #define RE_CHAR_CLASSES (1 << 9)
  118.  
  119. /* If this bit is set, then the dot re doesn't match a null byte.
  120.    If not set, it does.  */
  121. #define RE_DOT_NOT_NULL (1 << 10)
  122.  
  123. /* If this bit is set, then [^...] doesn't match a newline.
  124.    If not set, it does.  */
  125. #define RE_HAT_NOT_NEWLINE (1 << 11)
  126.  
  127. /* If this bit is set, back references are recognized.
  128.    If not set, they aren't.  */
  129. #define RE_NO_BK_REFS (1 << 12)
  130.  
  131. /* If this bit is set, back references must refer to a preceding
  132.    subexpression.  If not set, a back reference to a nonexistent
  133.    subexpression is treated as literal characters.  */
  134. #define RE_NO_EMPTY_BK_REF (1 << 13)
  135.  
  136. /* If this bit is set, bracket expressions can't be empty.  
  137.    If it is set, they can be empty.  */
  138. #define RE_NO_EMPTY_BRACKETS (1 << 14)
  139.  
  140. /* If this bit is set, then *, +, ? and { cannot be first in an re or
  141.    immediately after a |, or a (.  Furthermore, a | cannot be first or
  142.    last in an re, or immediately follow another | or a (.  Also, a ^
  143.    cannot appear in a nonleading position and a $ cannot appear in a
  144.    nontrailing position (outside of bracket expressions, that is).  */
  145. #define RE_CONTEXTUAL_INVALID_OPS (1 << 15)
  146.  
  147. /* If this bit is set, then +, ? and | aren't recognized as operators.
  148.    If it's not, they are.  */
  149. #define RE_LIMITED_OPS (1 << 16)
  150.  
  151. /* If this bit is set, then an ending range point has to collate higher
  152.      or equal to the starting range point.
  153.    If it's not set, then when the ending range point collates higher
  154.      than the starting range point, the range is just considered empty.  */
  155. #define RE_NO_EMPTY_RANGES (1 << 17)
  156.  
  157. /* If this bit is set, then a hyphen (-) can't be an ending range point.
  158.    If it isn't, then it can.  */
  159. #define RE_NO_HYPHEN_RANGE_END (1 << 18)
  160.  
  161.  
  162. /* Define combinations of bits for the standard possibilities.  */
  163. #define RE_SYNTAX_POSIX_AWK (RE_NO_BK_PARENS | RE_NO_BK_VBAR \
  164.             | RE_CONTEXT_INDEP_OPS)
  165. #define RE_SYNTAX_AWK (RE_NO_BK_PARENS | RE_NO_BK_VBAR \
  166.             | RE_CONTEXT_INDEP_OPS | RE_AWK_CLASS_HACK)
  167. #define RE_SYNTAX_EGREP (RE_NO_BK_PARENS | RE_NO_BK_VBAR \
  168.             | RE_CONTEXT_INDEP_OPS | RE_NEWLINE_OR)
  169. #define RE_SYNTAX_GREP (RE_BK_PLUS_QM | RE_NEWLINE_OR)
  170. #define RE_SYNTAX_EMACS 0
  171. #define RE_SYNTAX_POSIX_BASIC (RE_INTERVALS | RE_BK_PLUS_QM         \
  172.             | RE_CHAR_CLASSES | RE_DOT_NOT_NULL         \
  173.                         | RE_HAT_NOT_NEWLINE | RE_NO_EMPTY_BK_REF     \
  174.                         | RE_NO_EMPTY_BRACKETS | RE_LIMITED_OPS        \
  175.                         | RE_NO_EMPTY_RANGES | RE_NO_HYPHEN_RANGE_END)    
  176.                         
  177. #define RE_SYNTAX_POSIX_EXTENDED (RE_INTERVALS | RE_NO_BK_CURLY_BRACES       \
  178.             | RE_NO_BK_VBAR | RE_NO_BK_PARENS            \
  179.                         | RE_HAT_NOT_NEWLINE | RE_CHAR_CLASSES            \
  180.                         | RE_NO_EMPTY_BRACKETS | RE_CONTEXTUAL_INVALID_OPS \
  181.                         | RE_NO_BK_REFS | RE_NO_EMPTY_RANGES            \
  182.                         | RE_NO_HYPHEN_RANGE_END)
  183.  
  184.  
  185. /* This data structure is used to represent a compiled pattern.  */
  186.  
  187. struct re_pattern_buffer
  188.   {
  189.     char *buffer;    /* Space holding the compiled pattern commands.  */
  190.     long allocated;    /* Size of space that `buffer' points to. */
  191.     long used;        /* Length of portion of buffer actually occupied  */
  192.     char *fastmap;    /* Pointer to fastmap, if any, or zero if none.  */
  193.             /* re_search uses the fastmap, if there is one,
  194.                to skip over totally implausible characters.  */
  195.     char *translate;    /* Translate table to apply to all characters before 
  196.                    comparing, or zero for no translation.
  197.                The translation is applied to a pattern when it is 
  198.                            compiled and to data when it is matched.  */
  199.     char fastmap_accurate;
  200.             /* Set to zero when a new pattern is stored,
  201.                set to one when the fastmap is updated from it.  */
  202.     char can_be_null;   /* Set to one by compiling fastmap
  203.                if this pattern might match the null string.
  204.                It does not necessarily match the null string
  205.                in that case, but if this is zero, it cannot.
  206.                2 as value means can match null string
  207.                but at end of range or before a character
  208.                listed in the fastmap.  */
  209.   };
  210.  
  211.  
  212. /* search.c (search_buffer) needs this one value.  It is defined both in
  213.    regex.c and here.  */
  214. #define RE_EXACTN_VALUE 1
  215.  
  216.  
  217. /* Structure to store register contents data in.
  218.  
  219.    Pass the address of such a structure as an argument to re_match, etc.,
  220.    if you want this information back.
  221.  
  222.    For i from 1 to RE_NREGS - 1, start[i] records the starting index in
  223.    the string of where the ith subexpression matched, and end[i] records
  224.    one after the ending index.  start[0] and end[0] are analogous, for
  225.    the entire pattern.  */
  226.  
  227. struct re_registers
  228.   {
  229.     int start[RE_NREGS];
  230.     int end[RE_NREGS];
  231.   };
  232.  
  233.  
  234.  
  235. #ifdef __STDC__
  236.  
  237. extern char *re_compile_pattern (char *, int, struct re_pattern_buffer *);
  238. /* Is this really advertised?  */
  239. extern void re_compile_fastmap (struct re_pattern_buffer *);
  240. extern int re_search (struct re_pattern_buffer *, char*, int, int, int,
  241.               struct re_registers *);
  242. extern int re_search_2 (struct re_pattern_buffer *, char *, int,
  243.             char *, int, int, int,
  244.             struct re_registers *, int);
  245. extern int re_match (struct re_pattern_buffer *, char *, int, int,
  246.              struct re_registers *);
  247. extern int re_match_2 (struct re_pattern_buffer *, char *, int,
  248.                char *, int, int, struct re_registers *, int);
  249.  
  250. /* 4.2 bsd compatibility.  */
  251. extern char *re_comp (char *);
  252. extern int re_exec (char *);
  253.  
  254. #else /* !__STDC__ */
  255.  
  256. extern char *re_compile_pattern ();
  257. /* Is this really advertised? */
  258. extern void re_compile_fastmap ();
  259. extern int re_search (), re_search_2 ();
  260. extern int re_match (), re_match_2 ();
  261.  
  262. /* 4.2 bsd compatibility.  */
  263. extern char *re_comp ();
  264. extern int re_exec ();
  265.  
  266. #endif /* __STDC__ */
  267.  
  268.  
  269. #ifdef SYNTAX_TABLE
  270. extern char *re_syntax_table;
  271. #endif
  272.  
  273. #endif /* !__REGEXP_LIBRARY */
  274.