gnu.regexp
Class REMatchEnumeration 
java.lang.Object
gnu.regexp.REMatchEnumeration
- All Implemented Interfaces:
- java.util.Enumeration, java.io.Serializable
- public class REMatchEnumeration
- extends java.lang.Object
- implements java.util.Enumeration, java.io.Serializable
An REMatchEnumeration enumerates regular expression matches over a
given input text. You obtain a reference to an enumeration using
the getMatchEnumeration() methods on an instance of
RE.
REMatchEnumeration does lazy computation; that is, it will not
search for a match until it needs to. If you'd rather just get all
the matches at once in a big array, use the
getAllMatches() methods on RE. However, using an
enumeration can help speed performance when the entire text does
not need to be searched immediately.
The enumerated type is especially useful when searching on a Reader
or InputStream, because the InputStream read position cannot be
guaranteed after calling getMatch() (see the
description of that method for an explanation of why). Enumeration
also saves a lot of overhead required when calling
getMatch() multiple times.
| Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
YES
private static final int YES
- See Also:
- Constant Field Values
MAYBE
private static final int MAYBE
- See Also:
- Constant Field Values
NO
private static final int NO
- See Also:
- Constant Field Values
more
private int more
match
private REMatch match
expr
private RE expr
input
private CharIndexed input
eflags
private int eflags
index
private int index
REMatchEnumeration
REMatchEnumeration(RE expr,
CharIndexed input,
int index,
int eflags)
hasMoreElements
public boolean hasMoreElements()
- Returns true if there are more matches in the input text.
- Specified by:
hasMoreElements in interface java.util.Enumeration
hasMoreMatches
public boolean hasMoreMatches()
- Returns true if there are more matches in the input text.
hasMoreMatches
public boolean hasMoreMatches(java.lang.StringBuffer buffer)
- Returns true if there are more matches in the input text.
Saves the text leading up to the match (or to the end of the input)
in the specified buffer.
nextElement
public java.lang.Object nextElement()
throws java.util.NoSuchElementException
- Returns the next match in the input text.
- Specified by:
nextElement in interface java.util.Enumeration
nextMatch
public REMatch nextMatch()
throws java.util.NoSuchElementException
- Returns the next match in the input text. This method is provided
for convenience to avoid having to explicitly cast the return value
to class REMatch.
JAVADOC |