Home | History | Annotate | Download | only in re2
      1 // Copyright 2010 The RE2 Authors.  All Rights Reserved.
      2 // Use of this source code is governed by a BSD-style
      3 // license that can be found in the LICENSE file.
      4 
      5 #ifndef RE2_SET_H
      6 #define RE2_SET_H
      7 
      8 #include <utility>
      9 #include <vector>
     10 
     11 #include "re2/re2.h"
     12 
     13 namespace re2 {
     14 using std::vector;
     15 
     16 // An RE2::Set represents a collection of regexps that can
     17 // be searched for simultaneously.
     18 class RE2::Set {
     19  public:
     20   Set(const RE2::Options& options, RE2::Anchor anchor);
     21   ~Set();
     22 
     23   // Add adds regexp pattern to the set, interpreted using the RE2 options.
     24   // (The RE2 constructor's default options parameter is RE2::UTF8.)
     25   // Add returns the regexp index that will be used to identify
     26   // it in the result of Match, or -1 if the regexp cannot be parsed.
     27   // Indices are assigned in sequential order starting from 0.
     28   // Error returns do not increment the index.
     29   // If an error occurs and error != NULL, *error will hold an error message.
     30   int Add(const StringPiece& pattern, string* error);
     31 
     32   // Compile prepares the Set for matching.
     33   // Add must not be called again after Compile.
     34   // Compile must be called before FullMatch or PartialMatch.
     35   // Compile may return false if it runs out of memory.
     36   bool Compile();
     37 
     38   // Match returns true if text matches any of the regexps in the set.
     39   // If so, it fills v with the indices of the matching regexps.
     40   bool Match(const StringPiece& text, vector<int>* v) const;
     41 
     42  private:
     43   RE2::Options options_;
     44   RE2::Anchor anchor_;
     45   vector<re2::Regexp*> re_;
     46   re2::Prog* prog_;
     47   bool compiled_;
     48   //DISALLOW_EVIL_CONSTRUCTORS(Set);
     49   Set(const Set&);
     50   void operator=(const Set&);
     51 };
     52 
     53 }  // namespace re2
     54 
     55 #endif  // RE2_SET_H
     56