MatchResult

Overview

Package

Class

Use

Deprecated

Index

Home >> All >> org >> apache >> oro >> text >> [ regex overview ]

PREV CLASS NEXT CLASS

SUMMARY:

JAVADOC |

Sourc code of org.apache.oro.text.regex.MatchResult

SOURCE |

Download org.apache.oro.text.regex.MatchResult

DOWNLOAD | NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

org.apache.oro.text.regex
Interface MatchResult

All Known Implementing Classes:: Perl5MatchResult

public interface MatchResult

The MatchResult interface allows PatternMatcher implementors to return results storing match information in whatever format they like, while presenting a consistent way of accessing that information. However, MatchResult implementations should strictly follow the behavior described for the interface methods.

A MatchResult instance contains a pattern match and its saved groups. You can access the entire match directly using the group(int) 55 method with an argument of 0, or by the toString() 55 method which is defined to return the same thing. It is also possible to obtain the beginning and ending offsets of a match relative to the input producing the match by using the beginOffset(int) 55 and endOffset(int) 55 methods. The begin(int) 55 and end(int) 55 are useful in some circumstances and return the begin and end offsets of the subgroups of a match relative to the beginning of the match.

You might use a MatchResult as follows:

 int groups;
 PatternMatcher matcher;
 PatternCompiler compiler;
 Pattern pattern;
 PatternMatcherInput input;
 MatchResult result;

 compiler = new Perl5Compiler();
 matcher  = new Perl5Matcher();

 try {
   pattern = compiler.compile(somePatternString);
 } catch(MalformedPatternException e) {
   System.out.println("Bad pattern.");
   System.out.println(e.getMessage());
   return;
 }

 input   = new PatternMatcherInput(someStringInput);

 while(matcher.contains(input, pattern)) {
   result = matcher.getMatch();  
   // Perform whatever processing on the result you want.
   // Here we just print out all its elements to show how its
   // methods are used.
 
   System.out.println("Match: " + result.toString());
   System.out.println("Length: " + result.length());
   groups = result.groups();
   System.out.println("Groups: " + groups);
   System.out.println("Begin offset: " + result.beginOffset(0));
   System.out.println("End offset: " + result.endOffset(0));
   System.out.println("Saved Groups: ");

   // Start at 1 because we just printed out group 0
   for(int group = 1; group < groups; group++) {
	 System.out.println(group + ": " + result.group(group));
	 System.out.println("Begin: " + result.begin(group));
	 System.out.println("End: " + result.end(group));
   }
 }

Since:: 1.0
Version:: @version@

Method Summary

int begin(int group)


int beginOffset(int group)
          Returns an offset marking the beginning of the pattern match relative to the beginning of the input from which the match was extracted.

int end(int group)


int endOffset(int group)
          Returns an offset marking the end of the pattern match relative to the beginning of the input from which the match was extracted.

java.lang.String group(int group)
          Returns the contents of the parenthesized subgroups of a match, counting parentheses from left to right and starting from 1.

int groups()


int length()
          A convenience method returning the length of the entire match.

java.lang.String toString()
          Returns the same as group(0).

Method Detail

length

public int length()

A convenience method returning the length of the entire match. If you want to get the length of a particular subgroup you should use the group(int) 55 method to get the string and then access its length() method as follows:

 int length = -1; // Use -1 to indicate group doesn't exist
 MatchResult result;
 String subgroup;
 
 // Initialization of result omitted

 subgroup = result.group(1);
 if(subgroup != null)
   length = subgroup.length();

The length() method serves as a more a more efficient way to do:

 length = result.group(0).length();

groups

public int groups()

group

public java.lang.String group(int group)

Returns the contents of the parenthesized subgroups of a match, counting parentheses from left to right and starting from 1. Group 0 always refers to the entire match. For example, if the pattern foo(\d+) is used to extract a match from the input abfoo123 , then group(0) will return foo123 and group(1) will return 123 . group(2) will return null because there is only one subgroup in the original pattern.

begin

public int begin(int group)

end

public int end(int group)

beginOffset

public int beginOffset(int group)

Returns an offset marking the beginning of the pattern match relative to the beginning of the input from which the match was extracted.

endOffset

public int endOffset(int group)

Returns an offset marking the end of the pattern match relative to the beginning of the input from which the match was extracted.

toString

public java.lang.String toString()

Returns the same as group(0).