| 1 | 
         706 | 
         jeremybenn | 
         ------------------------------------------------------------------------------
  | 
      
      
         | 2 | 
          | 
          | 
         --                                                                          --
  | 
      
      
         | 3 | 
          | 
          | 
         --                         GNAT LIBRARY COMPONENTS                          --
  | 
      
      
         | 4 | 
          | 
          | 
         --                                                                          --
  | 
      
      
         | 5 | 
          | 
          | 
         --                          G N A T . R E G P A T                           --
  | 
      
      
         | 6 | 
          | 
          | 
         --                                                                          --
  | 
      
      
         | 7 | 
          | 
          | 
         --                                 S p e c                                  --
  | 
      
      
         | 8 | 
          | 
          | 
         --                                                                          --
  | 
      
      
         | 9 | 
          | 
          | 
         --               Copyright (C) 1986 by University of Toronto.               --
  | 
      
      
         | 10 | 
          | 
          | 
         --                     Copyright (C) 1996-2010, AdaCore                     --
  | 
      
      
         | 11 | 
          | 
          | 
         --                                                                          --
  | 
      
      
         | 12 | 
          | 
          | 
         -- GNAT is free software;  you can  redistribute it  and/or modify it under --
  | 
      
      
         | 13 | 
          | 
          | 
         -- terms of the  GNU General Public License as published  by the Free Soft- --
  | 
      
      
         | 14 | 
          | 
          | 
         -- ware  Foundation;  either version 3,  or (at your option) any later ver- --
  | 
      
      
         | 15 | 
          | 
          | 
         -- sion.  GNAT is distributed in the hope that it will be useful, but WITH- --
  | 
      
      
         | 16 | 
          | 
          | 
         -- OUT ANY WARRANTY;  without even the  implied warranty of MERCHANTABILITY --
  | 
      
      
         | 17 | 
          | 
          | 
         -- or FITNESS FOR A PARTICULAR PURPOSE.                                     --
  | 
      
      
         | 18 | 
          | 
          | 
         --                                                                          --
  | 
      
      
         | 19 | 
          | 
          | 
         -- As a special exception under Section 7 of GPL version 3, you are granted --
  | 
      
      
         | 20 | 
          | 
          | 
         -- additional permissions described in the GCC Runtime Library Exception,   --
  | 
      
      
         | 21 | 
          | 
          | 
         -- version 3.1, as published by the Free Software Foundation.               --
  | 
      
      
         | 22 | 
          | 
          | 
         --                                                                          --
  | 
      
      
         | 23 | 
          | 
          | 
         -- You should have received a copy of the GNU General Public License and    --
  | 
      
      
         | 24 | 
          | 
          | 
         -- a copy of the GCC Runtime Library Exception along with this program;     --
  | 
      
      
         | 25 | 
          | 
          | 
         -- see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see    --
  | 
      
      
         | 26 | 
          | 
          | 
         -- <http://www.gnu.org/licenses/>.                                          --
  | 
      
      
         | 27 | 
          | 
          | 
         --                                                                          --
  | 
      
      
         | 28 | 
          | 
          | 
         -- GNAT was originally developed  by the GNAT team at  New York University. --
  | 
      
      
         | 29 | 
          | 
          | 
         -- Extensive contributions were provided by Ada Core Technologies Inc.      --
  | 
      
      
         | 30 | 
          | 
          | 
         --                                                                          --
  | 
      
      
         | 31 | 
          | 
          | 
         ------------------------------------------------------------------------------
  | 
      
      
         | 32 | 
          | 
          | 
          
  | 
      
      
         | 33 | 
          | 
          | 
         --  This package implements roughly the same set of regular expressions as
  | 
      
      
         | 34 | 
          | 
          | 
         --  are available in the Perl or Python programming languages.
  | 
      
      
         | 35 | 
          | 
          | 
          
  | 
      
      
         | 36 | 
          | 
          | 
         --  This is an extension of the original V7 style regular expression library
  | 
      
      
         | 37 | 
          | 
          | 
         --  written in C by Henry Spencer. Apart from the translation to Ada, the
  | 
      
      
         | 38 | 
          | 
          | 
         --  interface has been considerably changed to use the Ada String type
  | 
      
      
         | 39 | 
          | 
          | 
         --  instead of C-style nul-terminated strings.
  | 
      
      
         | 40 | 
          | 
          | 
          
  | 
      
      
         | 41 | 
          | 
          | 
         --  See file s-regpat.ads for full documentation of the interface
  | 
      
      
         | 42 | 
          | 
          | 
          
  | 
      
      
         | 43 | 
          | 
          | 
         ------------------------------------------------------------
  | 
      
      
         | 44 | 
          | 
          | 
         -- Summary of Pattern Matching Packages in GNAT Hierarchy --
  | 
      
      
         | 45 | 
          | 
          | 
         ------------------------------------------------------------
  | 
      
      
         | 46 | 
          | 
          | 
          
  | 
      
      
         | 47 | 
          | 
          | 
         --  There are three related packages that perform pattern matching functions.
  | 
      
      
         | 48 | 
          | 
          | 
         --  the following is an outline of these packages, to help you determine
  | 
      
      
         | 49 | 
          | 
          | 
         --  which is best for your needs.
  | 
      
      
         | 50 | 
          | 
          | 
          
  | 
      
      
         | 51 | 
          | 
          | 
         --     GNAT.Regexp (files g-regexp.ads/s-regexp.ads/s-regexp.adb)
  | 
      
      
         | 52 | 
          | 
          | 
         --       This is a simple package providing Unix-style regular expression
  | 
      
      
         | 53 | 
          | 
          | 
         --       matching with the restriction that it matches entire strings. It
  | 
      
      
         | 54 | 
          | 
          | 
         --       is particularly useful for file name matching, and in particular
  | 
      
      
         | 55 | 
          | 
          | 
         --       it provides "globbing patterns" that are useful in implementing
  | 
      
      
         | 56 | 
          | 
          | 
         --       unix or DOS style wild card matching for file names.
  | 
      
      
         | 57 | 
          | 
          | 
          
  | 
      
      
         | 58 | 
          | 
          | 
         --     GNAT.Regpat (files g-regpat.ads/s-regpat.ads/s-regpat.adb)
  | 
      
      
         | 59 | 
          | 
          | 
         --       This is a more complete implementation of Unix-style regular
  | 
      
      
         | 60 | 
          | 
          | 
         --       expressions, copied from the Perl regular expression engine,
  | 
      
      
         | 61 | 
          | 
          | 
         --       written originally in C by Henry Spencer. It is functionally the
  | 
      
      
         | 62 | 
          | 
          | 
         --       same as that library.
  | 
      
      
         | 63 | 
          | 
          | 
          
  | 
      
      
         | 64 | 
          | 
          | 
         --     GNAT.Spitbol.Patterns (files g-spipat.ads/g-spipat.adb)
  | 
      
      
         | 65 | 
          | 
          | 
         --       This is a completely general pattern matching package based on the
  | 
      
      
         | 66 | 
          | 
          | 
         --       pattern language of SNOBOL4, as implemented in SPITBOL. The pattern
  | 
      
      
         | 67 | 
          | 
          | 
         --       language is modeled on context free grammars, with context sensitive
  | 
      
      
         | 68 | 
          | 
          | 
         --       extensions that provide full (type 0) computational capabilities.
  | 
      
      
         | 69 | 
          | 
          | 
          
  | 
      
      
         | 70 | 
          | 
          | 
         with System.Regpat;
  | 
      
      
         | 71 | 
          | 
          | 
          
  | 
      
      
         | 72 | 
          | 
          | 
         package GNAT.Regpat renames System.Regpat;
  |