home *** CD-ROM | disk | FTP | other *** search
/ ProfitPress Mega CDROM2 …eeware (MSDOS)(1992)(Eng) / ProfitPress-MegaCDROM2.B6I / MISC / GNU / PL4019AS.ZIP / REGCOMP.H < prev    next >
Encoding:
C/C++ Source or Header  |  1991-11-28  |  7.2 KB  |  217 lines
  1. /* $RCSfile: regcomp.h,v $$Revision: 4.0.1.1 $$Date: 91/06/07 11:49:40 $
  2.  *
  3.  * $Log:    regcomp.h,v $
  4.  * Revision 4.0.1.1  91/06/07  11:49:40  lwall
  5.  * patch4: no change
  6.  *
  7.  * Revision 4.0  91/03/20  01:39:09  lwall
  8.  * 4.0 baseline.
  9.  *
  10.  */
  11.  
  12.  
  13. /*
  14.  * The "internal use only" fields in regexp.h are present to pass info from
  15.  * compile to execute that permits the execute phase to run lots faster on
  16.  * simple cases.  They are:
  17.  *
  18.  * regstart    str that must begin a match; Nullch if none obvious
  19.  * reganch    is the match anchored (at beginning-of-line only)?
  20.  * regmust    string (pointer into program) that match must include, or NULL
  21.  *  [regmust changed to STR* for bminstr()--law]
  22.  * regmlen    length of regmust string
  23.  *  [regmlen not used currently]
  24.  *
  25.  * Regstart and reganch permit very fast decisions on suitable starting points
  26.  * for a match, cutting down the work a lot.  Regmust permits fast rejection
  27.  * of lines that cannot possibly match.  The regmust tests are costly enough
  28.  * that regcomp() supplies a regmust only if the r.e. contains something
  29.  * potentially expensive (at present, the only such thing detected is * or +
  30.  * at the start of the r.e., which can involve a lot of backup).  Regmlen is
  31.  * supplied because the test in regexec() needs it and regcomp() is computing
  32.  * it anyway.
  33.  * [regmust is now supplied always.  The tests that use regmust have a
  34.  * heuristic that disables the test if it usually matches.]
  35.  *
  36.  * [In fact, we now use regmust in many cases to locate where the search
  37.  * starts in the string, so if regback is >= 0, the regmust search is never
  38.  * wasted effort.  The regback variable says how many characters back from
  39.  * where regmust matched is the earliest possible start of the match.
  40.  * For instance, /[a-z].foo/ has a regmust of 'foo' and a regback of 2.]
  41.  */
  42.  
  43.  
  44. /*
  45.  * Structure for regexp "program".  This is essentially a linear encoding
  46.  * of a nondeterministic finite-state machine (aka syntax charts or
  47.  * "railroad normal form" in parsing technology).  Each node is an opcode
  48.  * plus a "next" pointer, possibly plus an operand.  "Next" pointers of
  49.  * all nodes except BRANCH implement concatenation; a "next" pointer with
  50.  * a BRANCH on both ends of it is connecting two alternatives.  (Here we
  51.  * have one of the subtle syntax dependencies:  an individual BRANCH (as
  52.  * opposed to a collection of them) is never concatenated with anything
  53.  * because of operator precedence.)  The operand of some types of node is
  54.  * a literal string; for others, it is a node leading into a sub-FSM.  In
  55.  * particular, the operand of a BRANCH node is the first node of the branch.
  56.  * (NB this is *not* a tree structure:  the tail of the branch connects
  57.  * to the thing following the set of BRANCHes.)  The opcodes are:
  58.  */
  59.  
  60.  
  61. /* definition    number    opnd?    meaning */
  62. #define    END    0    /* no    End of program. */
  63. #define    BOL    1    /* no    Match "" at beginning of line. */
  64. #define    EOL    2    /* no    Match "" at end of line. */
  65. #define    ANY    3    /* no    Match any one character. */
  66. #define    ANYOF    4    /* str    Match character in (or not in) this class. */
  67. #define    CURLY    5    /* str    Match this simple thing {n,m} times. */
  68. #define    BRANCH    6    /* node    Match this alternative, or the next... */
  69. #define    BACK    7    /* no    Match "", "next" ptr points backward. */
  70. #define    EXACTLY    8    /* str    Match this string (preceded by length). */
  71. #define    NOTHING    9    /* no    Match empty string. */
  72. #define    STAR    10    /* node    Match this (simple) thing 0 or more times. */
  73. #define    PLUS    11    /* node    Match this (simple) thing 1 or more times. */
  74. #define ALNUM    12    /* no    Match any alphanumeric character */
  75. #define NALNUM    13    /* no    Match any non-alphanumeric character */
  76. #define BOUND    14    /* no    Match "" at any word boundary */
  77. #define NBOUND    15    /* no    Match "" at any word non-boundary */
  78. #define SPACE    16    /* no    Match any whitespace character */
  79. #define NSPACE    17    /* no    Match any non-whitespace character */
  80. #define DIGIT    18    /* no    Match any numeric character */
  81. #define NDIGIT    19    /* no    Match any non-numeric character */
  82. #define REF    20    /* num    Match some already matched string */
  83. #define    OPEN    21    /* num    Mark this point in input as start of #n. */
  84. #define    CLOSE    22    /* num    Analogous to OPEN. */
  85.  
  86.  
  87. /*
  88.  * Opcode notes:
  89.  *
  90.  * BRANCH    The set of branches constituting a single choice are hooked
  91.  *        together with their "next" pointers, since precedence prevents
  92.  *        anything being concatenated to any individual branch.  The
  93.  *        "next" pointer of the last BRANCH in a choice points to the
  94.  *        thing following the whole choice.  This is also where the
  95.  *        final "next" pointer of each individual branch points; each
  96.  *        branch starts with the operand node of a BRANCH node.
  97.  *
  98.  * BACK        Normal "next" pointers all implicitly point forward; BACK
  99.  *        exists to make loop structures possible.
  100.  *
  101.  * STAR,PLUS    '?', and complex '*' and '+', are implemented as circular
  102.  *        BRANCH structures using BACK.  Simple cases (one character
  103.  *        per match) are implemented with STAR and PLUS for speed
  104.  *        and to minimize recursive plunges.
  105.  *
  106.  * OPEN,CLOSE    ...are numbered at compile time.
  107.  */
  108.  
  109.  
  110. #ifndef DOINIT
  111. extern char regarglen[];
  112. #else
  113. char regarglen[] = {0,0,0,0,0,4,0,0,0,0,0,0,0,0,0,0,0,0,0,0,2,2,2};
  114. #endif
  115.  
  116.  
  117. /* The following have no fixed length. */
  118. #ifndef DOINIT
  119. extern char varies[];
  120. #else
  121. char varies[] = {BRANCH,BACK,STAR,PLUS,CURLY,REF,0};
  122. #endif
  123.  
  124.  
  125. /* The following always have a length of 1. */
  126. #ifndef DOINIT
  127. extern char simple[];
  128. #else
  129. char simple[] = {ANY,ANYOF,ALNUM,NALNUM,SPACE,NSPACE,DIGIT,NDIGIT,0};
  130. #endif
  131.  
  132.  
  133. EXT char regdummy;
  134.  
  135.  
  136. /*
  137.  * A node is one char of opcode followed by two chars of "next" pointer.
  138.  * "Next" pointers are stored as two 8-bit pieces, high order first.  The
  139.  * value is a positive offset from the opcode of the node containing it.
  140.  * An operand, if any, simply follows the node.  (Note that much of the
  141.  * code generation knows about this implicit relationship.)
  142.  *
  143.  * Using two bytes for the "next" pointer is vast overkill for most things,
  144.  * but allows patterns to get big without disasters.
  145.  *
  146.  * [If REGALIGN is defined, the "next" pointer is always aligned on an even
  147.  * boundary, and reads the offset directly as a short.  Also, there is no
  148.  * special test to reverse the sign of BACK pointers since the offset is
  149.  * stored negative.]
  150.  */
  151.  
  152.  
  153. #ifndef gould
  154. #ifndef cray
  155. #ifndef eta10
  156. #define REGALIGN
  157. #endif
  158. #endif
  159. #endif
  160.  
  161.  
  162. #define    OP(p)    (*(p))
  163.  
  164.  
  165. #ifndef lint
  166. #ifdef REGALIGN
  167. #define NEXT(p) (*(short*)(p+1))
  168. #define ARG1(p) (*(unsigned short*)(p+3))
  169. #define ARG2(p) (*(unsigned short*)(p+5))
  170. #else
  171. #define    NEXT(p)    (((*((p)+1)&0377)<<8) + (*((p)+2)&0377))
  172. #define    ARG1(p)    (((*((p)+3)&0377)<<8) + (*((p)+4)&0377))
  173. #define    ARG2(p)    (((*((p)+5)&0377)<<8) + (*((p)+6)&0377))
  174. #endif
  175. #else /* lint */
  176. #define NEXT(p) 0
  177. #endif /* lint */
  178.  
  179.  
  180. #define    OPERAND(p)    ((p) + 3)
  181.  
  182.  
  183. #ifdef REGALIGN
  184. #define    NEXTOPER(p)    ((p) + 4)
  185. #else
  186. #define    NEXTOPER(p)    ((p) + 3)
  187. #endif
  188.  
  189.  
  190. #define MAGIC 0234
  191.  
  192.  
  193. /*
  194.  * Utility definitions.
  195.  */
  196. #ifndef lint
  197. #ifndef CHARBITS
  198. #define    UCHARAT(p)    ((int)*(unsigned char *)(p))
  199. #else
  200. #define    UCHARAT(p)    ((int)*(p)&CHARBITS)
  201. #endif
  202. #else /* lint */
  203. #define UCHARAT(p)    regdummy
  204. #endif /* lint */
  205.  
  206.  
  207. #define    FAIL(m)    fatal("/%s/: %s",regprecomp,m)
  208.  
  209.  
  210. char *regnext();
  211. #ifdef DEBUGGING
  212. void regdump();
  213. char *regprop();
  214. #endif
  215.  
  216.  
  217.