PatternMatcherInput (anyline-oro 8.7.2-20240607 API)

java.lang.Object
- org.apache.oro.text.regex.PatternMatcherInput

public final class PatternMatcherInput
extends Object

The PatternMatcherInput class is used to preserve state across calls to the contains() methods of PatternMatcher instances. It is also used to specify that only a subregion of a string should be used as input when looking for a pattern match. All that is meant by preserving state is that the end offset of the last match is remembered, so that the next match is performed from that point where the last match left off. This offset can be accessed from the getCurrentOffset() method and can be set with the setCurrentOffset(int) method.

You would use a PatternMatcherInput object when you want to search for more than just the first occurrence of a pattern in a string, or when you only want to search a subregion of the string for a match. An example of its most common use is:

 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.toString());
   return;
 }

 input   = new PatternMatcherInput(someStringInput);

 while(matcher.contains(input, pattern)) {
   result = matcher.getMatch();  
   // Perform whatever processing on the result you want.
 }
 // Suppose we want to start searching from the beginning again with
 // a different pattern.
 // Just set the current offset to the begin offset.
 input.setCurrentOffset(input.getBeginOffset());

 // Second search omitted

 // Suppose we're done with this input, but want to search another string.
 // There's no need to create another PatternMatcherInput instance.
 // We can just use the setInput() method.
 input.setInput(aNewInputString);

从以下版本开始:: 1.0
版本:: @version@
另请参阅:: PatternMatcher

构造器概要

构造器
构造器和说明
`PatternMatcherInput(char[] input)` Like calling: PatternMatcherInput(input, 0, input.length);
`PatternMatcherInput(char[] input, int begin, int length)` Creates a PatternMatcherInput object, associating a region of a string (represented as a char[]) as input to be used for pattern matching by PatternMatcher objects.
`PatternMatcherInput(String input)` Like calling PatternMatcherInput(input, 0, input.length());
`PatternMatcherInput(String input, int begin, int length)` Creates a PatternMatcherInput object, associating a region of a String as input to be used for pattern matching by PatternMatcher objects.

方法概要

All Methods Instance Methods Concrete Methods
限定符和类型	方法和说明
`char`	`charAt(int offset)` Returns the character at a particular offset relative to the begin offset of the input.
`boolean`	`endOfInput()` Returns whether or not the end of the input has been reached.
`int`	`getBeginOffset()`
`char[]`	`getBuffer()` Retrieves the char[] buffer to be used used as input by PatternMatcher implementations to look for matches.
`int`	`getCurrentOffset()`
`int`	`getEndOffset()`
`Object`	`getInput()` Retrieves the original input used to initialize the PatternMatcherInput instance.
`int`	`getMatchBeginOffset()` Returns the offset marking the beginning of the match found by contains().
`int`	`getMatchEndOffset()` Returns the offset marking the end of the match found by contains().
`int`	`length()`
`String`	`match()` A convenience method returning the part of the input corresponding to the last match found by a call to a Perl5Matcher `contains` method.
`String`	`postMatch()` A convenience method returning the part of the input occurring after the last match found by a call to a Perl5Matcher `contains` method.
`String`	`preMatch()` A convenience method returning the part of the input occurring before the last match found by a call to a Perl5Matcher `contains` method.
`void`	`setBeginOffset(int offset)` Sets the offset of the input that should be considered the start of the region to be considered as input by PatternMatcher methods.
`void`	`setCurrentOffset(int offset)` Sets the offset of the input that should be considered the current offset where PatternMatcher methods should start looking for matches.
`void`	`setEndOffset(int offset)` Sets the offset of the input that should be considered the end of the region to be considered as input by PatternMatcher methods.
`void`	`setInput(char[] input)` This method is identical to calling: setInput(input, 0, input.length);
`void`	`setInput(char[] input, int begin, int length)` Associates a region of a string (represented as a char[]) as input to be used for pattern matching by PatternMatcher objects.
`void`	`setInput(String input)` This method is identical to calling: setInput(input, 0, input.length());
`void`	`setInput(String input, int begin, int length)` Associates a region of a String as input to be used for pattern matching by PatternMatcher objects.
`void`	`setMatchOffsets(int matchBeginOffset, int matchEndOffset)` This method is intended for use by PatternMatcher implementations.
`String`	`substring(int beginOffset)` Returns a new string that is a substring of the PatternMatcherInput instance.
`String`	`substring(int beginOffset, int endOffset)` Returns a new string that is a substring of the PatternMatcherInput instance.
`String`	`toString()` Returns the string representation of the input, where the input is considered to start from the begin offset and end at the end offset.

从类继承的方法 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- 构造器详细资料
  - PatternMatcherInput
```
public PatternMatcherInput(String input,
                           int begin,
                           int length)
```
    Creates a PatternMatcherInput object, associating a region of a String as input to be used for pattern matching by PatternMatcher objects. A copy of the string is not made, therefore you should not modify the string unless you know what you are doing. The current offset of the PatternMatcherInput is set to the begin offset of the region.
    
    参数:
    
    input - The input to associate with the PatternMatcherInput.
    
    begin - The offset into the char[] to use as the beginning of the input.
    
    length - The length of the reegion starting from the begin offset to use as the input for pattern matching purposes.
  - PatternMatcherInput
```
public PatternMatcherInput(String input)
```
    Like calling
    PatternMatcherInput(input, 0, input.length());
    参数:
    
    input - The input to associate with the PatternMatcherInput.
  - PatternMatcherInput
```
public PatternMatcherInput(char[] input,
                           int begin,
                           int length)
```
    Creates a PatternMatcherInput object, associating a region of a string (represented as a char[]) as input to be used for pattern matching by PatternMatcher objects. A copy of the string is not made, therefore you should not modify the string unless you know what you are doing. The current offset of the PatternMatcherInput is set to the begin offset of the region.
    
    参数:
    
    input - The input to associate with the PatternMatcherInput.
    
    begin - The offset into the char[] to use as the beginning of the input.
    
    length - The length of the reegion starting from the begin offset to use as the input for pattern matching purposes.
  - PatternMatcherInput
```
public PatternMatcherInput(char[] input)
```
    Like calling:
    PatternMatcherInput(input, 0, input.length);
    参数:
    
    input - The input to associate with the PatternMatcherInput.
- 方法详细资料
  - length
```
public int length()
```
    返回:
    
    The length of the region to be considered input for pattern matching purposes. Essentially this is then end offset minus the begin offset.
  - setInput
```
public void setInput(String input,
                     int begin,
                     int length)
```
    Associates a region of a String as input to be used for pattern matching by PatternMatcher objects. The current offset of the PatternMatcherInput is set to the begin offset of the region.
    
    参数:
    
    input - The input to associate with the PatternMatcherInput.
    
    begin - The offset into the String to use as the beginning of the input.
    
    length - The length of the reegion starting from the begin offset to use as the input for pattern matching purposes.
  - setInput
```
public void setInput(String input)
```
    This method is identical to calling:
    setInput(input, 0, input.length());
    参数:
    
    input - The input to associate with the PatternMatcherInput.
  - setInput
```
public void setInput(char[] input,
                     int begin,
                     int length)
```
    Associates a region of a string (represented as a char[]) as input to be used for pattern matching by PatternMatcher objects. A copy of the string is not made, therefore you should not modify the string unless you know what you are doing. The current offset of the PatternMatcherInput is set to the begin offset of the region.
    
    参数:
    
    input - The input to associate with the PatternMatcherInput.
    
    begin - The offset into the char[] to use as the beginning of the input.
    
    length - The length of the reegion starting from the begin offset to use as the input for pattern matching purposes.
  - setInput
```
public void setInput(char[] input)
```
    This method is identical to calling:
    setInput(input, 0, input.length);
    参数:
    
    input - The input to associate with the PatternMatcherInput.
  - charAt
```
public char charAt(int offset)
```
    Returns the character at a particular offset relative to the begin offset of the input.
    
    参数:
    
    offset - The offset at which to fetch a character (relative to the beginning offset.
    
    返回:
    
    The character at a particular offset.
    
    抛出:
    
    ArrayIndexOutOfBoundsException - If the offset does not occur within the bounds of the input.
  - substring
```
public String substring(int beginOffset,
                        int endOffset)
```
    Returns a new string that is a substring of the PatternMatcherInput instance. The substring begins at the specified beginOffset relative to the begin offset and extends to the specified endOffset - 1 relative to the begin offset of the PatternMatcherInput instance.
    
    参数:
    
    beginOffset - The offset relative to the begin offset of the PatternMatcherInput at which to start the substring (inclusive).
    
    endOffset - The offset relative to the begin offset of the PatternMatcherInput at which to end the substring (exclusive).
    
    返回:
    
    The specified substring.
    
    抛出:
    
    ArrayIndexOutOfBoundsException - If one of the offsets does not occur within the bounds of the input.
  - substring
```
public String substring(int beginOffset)
```
    Returns a new string that is a substring of the PatternMatcherInput instance. The substring begins at the specified beginOffset relative to the begin offset and extends to the end offset of the PatternMatcherInput.
    
    参数:
    
    beginOffset - The offset relative to the begin offset of the PatternMatcherInput at which to start the substring.
    
    返回:
    
    The specified substring.
    
    抛出:
    
    ArrayIndexOutOfBoundsException - If the offset does not occur within the bounds of the input.
  - getInput
```
public Object getInput()
```
    Retrieves the original input used to initialize the PatternMatcherInput instance. If a String was used, the String instance will be returned. If a char[] was used, a char instance will be returned. This violates data encapsulation and hiding principles, but it is a great convenience for the programmer.
    
    返回:
    
    The String or char[] input used to initialize the PatternMatcherInput instance.
  - getBuffer
```
public char[] getBuffer()
```
    Retrieves the char[] buffer to be used used as input by PatternMatcher implementations to look for matches. This array should be treated as read only by the programmer.
    
    返回:
    
    The char[] buffer to be used as input by PatternMatcher implementations.
  - endOfInput
```
public boolean endOfInput()
```
    Returns whether or not the end of the input has been reached.
    
    返回:
    
    True if the current offset is greater than or equal to the end offset.
  - getBeginOffset
```
public int getBeginOffset()
```
    返回:
    
    The offset of the input that should be considered the start of the region to be considered as input by PatternMatcher methods.
  - getEndOffset
```
public int getEndOffset()
```
    返回:
    
    The offset of the input that should be considered the end of the region to be considered as input by PatternMatcher methods. This offset is actually 1 plus the last offset that is part of the input region.
  - getCurrentOffset
```
public int getCurrentOffset()
```
    返回:
    
    The offset of the input that should be considered the current offset where PatternMatcher methods should start looking for matches.
  - setBeginOffset
```
public void setBeginOffset(int offset)
```
    Sets the offset of the input that should be considered the start of the region to be considered as input by PatternMatcher methods. In other words, everything before this offset is ignored by a PatternMatcher.
    
    参数:
    
    offset - The offset to use as the beginning of the input.
  - setEndOffset
```
public void setEndOffset(int offset)
```
    Sets the offset of the input that should be considered the end of the region to be considered as input by PatternMatcher methods. This offset is actually 1 plus the last offset that is part of the input region.
    
    参数:
    
    offset - The offset to use as the end of the input.
  - setCurrentOffset
```
public void setCurrentOffset(int offset)
```
    Sets the offset of the input that should be considered the current offset where PatternMatcher methods should start looking for matches. Also resets all match offset information to -1. By calling this method, you invalidate all previous match information. Therefore a PatternMatcher implementation must call this method before setting match offset information.
    
    参数:
    
    offset - The offset to use as the current offset.
  - toString
```
public String toString()
```
    Returns the string representation of the input, where the input is considered to start from the begin offset and end at the end offset.
    
    覆盖:
    
    toString 在类中 Object
    
    返回:
    
    The string representation of the input.
  - preMatch
```
public String preMatch()
```
    A convenience method returning the part of the input occurring before the last match found by a call to a Perl5Matcher contains method.
    
    返回:
    
    The input preceeding a match.
  - postMatch
```
public String postMatch()
```
    A convenience method returning the part of the input occurring after the last match found by a call to a Perl5Matcher contains method.
    
    返回:
    
    The input succeeding a contains() match.
  - match
```
public String match()
```
    A convenience method returning the part of the input corresponding to the last match found by a call to a Perl5Matcher contains method. The method is not called getMatch() so as not to confuse it with Perl5Matcher's getMatch() which returns a MatchResult instance and also for consistency with preMatch() and postMatch().
    
    返回:
    
    The input consisting of the match found by contains().
  - setMatchOffsets
```
public void setMatchOffsets(int matchBeginOffset,
                            int matchEndOffset)
```
    This method is intended for use by PatternMatcher implementations. It is necessary to record the location of the previous match so that consecutive contains() matches involving null string matches are properly handled. If you are not implementing a PatternMatcher, forget this method exists. If you use it outside of its intended context, you will only disrupt the stored state.
    As a note, the preMatch(), postMatch(), and match() methods are provided as conveniences because PatternMatcherInput must store match offset information to completely preserve state for consecutive PatternMatcher contains() matches.
    
    参数:
    
    matchBeginOffset - The begin offset of a match found by contains().
    
    matchEndOffset - The end offset of a match found by contains().
  - getMatchBeginOffset
```
public int getMatchBeginOffset()
```
    Returns the offset marking the beginning of the match found by contains().
    
    返回:
    
    The begin offset of a contains() match.
  - getMatchEndOffset
```
public int getMatchEndOffset()
```
    Returns the offset marking the end of the match found by contains().
    
    返回:
    
    The end offset of a contains() match.

类 PatternMatcherInput

构造器概要

方法概要

从类继承的方法 java.lang.Object

构造器详细资料

PatternMatcherInput

PatternMatcherInput

PatternMatcherInput

PatternMatcherInput

方法详细资料

length

setInput

setInput

setInput

setInput

charAt

substring

substring

getInput

getBuffer

endOfInput

getBeginOffset

getEndOffset

getCurrentOffset

setBeginOffset

setEndOffset

setCurrentOffset

toString

preMatch

postMatch

match

setMatchOffsets

getMatchBeginOffset

getMatchEndOffset