mcs/class/System/System.Text.RegularExpressions/Match.cs

   1 //
   2 // assembly:    System
   3 // namespace:   System.Text.RegularExpressions
   4 // file:        Match.cs
   5 //
   6 // author:      Dan Lewis (dlewis@gmx.co.uk)
   7 //              (c) 2002
   8
   9 //
  10 // Permission is hereby granted, free of charge, to any person obtaining
  11 // a copy of this software and associated documentation files (the
  12 // "Software"), to deal in the Software without restriction, including
  13 // without limitation the rights to use, copy, modify, merge, publish,
  14 // distribute, sublicense, and/or sell copies of the Software, and to
  15 // permit persons to whom the Software is furnished to do so, subject to
  16 // the following conditions:
  17 //
  18 // The above copyright notice and this permission notice shall be
  19 // included in all copies or substantial portions of the Software.
  20 //
  21 // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
  22 // EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
  23 // MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
  24 // NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
  25 // LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
  26 // OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
  27 // WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
  28 //
  29
  30 using System;
  31
  32 namespace System.Text.RegularExpressions {
  33
  34         [Serializable]
  35         public class Match : Group {
  36                 public static Match Empty {
  37                         get { return empty; }
  38                 }
  39
  40                 public static Match Synchronized (Match inner)
  41                 {
  42                         return inner;   // FIXME need to sync on machine access
  43                 }
  44
  45                 public virtual GroupCollection Groups {
  46                         get { return groups; }
  47                 }
  48
  49                 public Match NextMatch ()
  50                 {
  51                         if (this == Empty)
  52                                 return Empty;
  53
  54                         int scan_ptr = regex.RightToLeft ? Index : Index + Length;
  55
  56                         // next match after an empty match: make sure scan ptr makes progress
  57
  58                         if (Length == 0)
  59                                 scan_ptr += regex.RightToLeft ? -1 : +1;
  60
  61                         return machine.Scan (regex, Text, scan_ptr, text_length);
  62                 }
  63
  64                 public virtual string Result (string replacement)
  65                 {
  66                         return ReplacementEvaluator.Evaluate (replacement, this);
  67                 }
  68
  69                 // internal
  70
  71                 private Match () : base ()
  72                 {
  73                         this.regex = null;
  74                         this.machine = null;
  75                         this.text_length = 0;
  76
  77                         this.groups = new GroupCollection (1);
  78                         groups.SetValue (this, 0);
  79                 }
  80
  81                 internal Match (Regex regex, IMachine machine, string text, int text_length, int n_groups,
  82                                 int index, int length, int n_caps) :
  83                         base (text, index, length, n_caps)
  84                 {
  85                         this.regex = regex;
  86                         this.machine = machine;
  87                         this.text_length = text_length;
  88
  89                         this.groups = new GroupCollection (n_groups);
  90                         groups.SetValue (this, 0);
  91                 }
  92
  93                 internal Regex Regex {
  94                         get { return regex; }
  95                 }
  96
  97                 // private
  98
  99                 private Regex regex;
 100                 private IMachine machine;
 101                 private int text_length;
 102                 private GroupCollection groups;
 103
 104                 private static Match empty = new Match ();
 105         }
 106 }