Pattern (re2j 1.1 API)

java.lang.Object
- com.google.re2j.Pattern

All Implemented Interfaces:

Serializable
```
public final class Pattern
extends Object
implements Serializable
```
A compiled representation of an RE2 regular expression, mimicking the java.util.regex.Pattern API.
The matching functions take String arguments instead of the more general Java CharSequence since the latter doesn't provide UTF-16 decoding.
See the package-level documentation for an overview of how to use this API.

Author:

rsc@google.com (Russ Cox)

See Also:

Serialized Form

Field Summary

Fields
Modifier and Type	Field and Description
`static int`	`CASE_INSENSITIVE` Flag: case insensitive matching.
`static int`	`DISABLE_UNICODE_GROUPS` Flag: Unicode groups (e.g.
`static int`	`DOTALL` Flag: dot (`.`) matches all characters, including newline.
`static int`	`MULTILINE` Flag: multiline matching: `^` and `$` match at beginning and end of line, not just beginning and end of input.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`static Pattern`	`compile(String regex)` Creates and returns a new `Pattern` corresponding to compiling `regex` with the default flags (0).
`static Pattern`	`compile(String regex, int flags)` Creates and returns a new `Pattern` corresponding to compiling `regex` with the default flags (0).
`int`	`flags()` Returns the flags used in the constructor.
`int`	`groupCount()` Returns the number of capturing groups in this matcher's pattern.
`Matcher`	`matcher(CharSequence input)` Creates a new `Matcher` matching the pattern against the input.
`boolean`	`matches(String input)`
`static boolean`	`matches(String regex, CharSequence input)` Matches a string against a regular expression.
`String`	`pattern()` Returns the pattern used in the constructor.
`static String`	`quote(String s)` Returns a literal pattern string for the specified string.
`void`	`reset()` Releases memory used by internal caches associated with this pattern.
`String[]`	`split(String input)` Splits input around instances of the regular expression.
`String[]`	`split(String input, int limit)` Splits input around instances of the regular expression.
`String`	`toString()`

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- Field Detail
  - CASE_INSENSITIVE
```
public static final int CASE_INSENSITIVE
```
    Flag: case insensitive matching.
    
    See Also:
    
    Constant Field Values
  - DOTALL
```
public static final int DOTALL
```
    Flag: dot (.) matches all characters, including newline.
    
    See Also:
    
    Constant Field Values
  - MULTILINE
```
public static final int MULTILINE
```
    Flag: multiline matching: ^ and $ match at beginning and end of line, not just beginning and end of input.
    
    See Also:
    
    Constant Field Values
  - DISABLE_UNICODE_GROUPS
```
public static final int DISABLE_UNICODE_GROUPS
```
    Flag: Unicode groups (e.g. \p\{Greek\}) will be syntax errors.
    
    See Also:
    
    Constant Field Values
- Method Detail
  - reset
```
public void reset()
```
    Releases memory used by internal caches associated with this pattern. Does not change the observable behaviour. Useful for tests that detect memory leaks via allocation tracking.
  - flags
```
public int flags()
```
    Returns the flags used in the constructor.
  - pattern
```
public String pattern()
```
    Returns the pattern used in the constructor.
  - compile
```
public static Pattern compile(String regex)
```
    Creates and returns a new Pattern corresponding to compiling regex with the default flags (0).
    
    Parameters:
    
    regex - the regular expression
    
    Throws:
    
    PatternSyntaxException - if the pattern is malformed
  - compile
```
public static Pattern compile(String regex,
                              int flags)
```
    Creates and returns a new Pattern corresponding to compiling regex with the default flags (0).
    
    Parameters:
    
    regex - the regular expression
    
    flags - bitwise OR of the flag constants CASE_INSENSITIVE, DOTALL, and MULTILINE
    
    Throws:
    
    PatternSyntaxException - if the regular expression is malformed
    
    IllegalArgumentException - if an unknown flag is given
  - matches
```
public static boolean matches(String regex,
                              CharSequence input)
```
    Matches a string against a regular expression.
    
    Parameters:
    
    regex - the regular expression
    
    input - the input
    
    Returns:
    
    true if the regular expression matches the entire input
    
    Throws:
    
    PatternSyntaxException - if the regular expression is malformed
  - matches
```
public boolean matches(String input)
```
  - matcher
```
public Matcher matcher(CharSequence input)
```
    Creates a new Matcher matching the pattern against the input.
    
    Parameters:
    
    input - the input string
  - split
```
public String[] split(String input)
```
    Splits input around instances of the regular expression. It returns an array giving the strings that occur before, between, and after instances of the regular expression. Empty strings that would occur at the end of the array are omitted.
    
    Parameters:
    
    input - the input string to be split
    
    Returns:
    
    the split strings
  - split
```
public String[] split(String input,
                      int limit)
```
    Splits input around instances of the regular expression. It returns an array giving the strings that occur before, between, and after instances of the regular expression.
    If limit <= 0, there is no limit on the size of the returned array. If limit == 0, empty strings that would occur at the end of the array are omitted. If limit > 0, at most limit strings are returned. The final string contains the remainder of the input, possibly including additional matches of the pattern.
    
    Parameters:
    
    input - the input string to be split
    
    limit - the limit
    
    Returns:
    
    the split strings
  - quote
```
public static String quote(String s)
```
    Returns a literal pattern string for the specified string.
    This method produces a string that can be used to create a Pattern that would match the string s as if it were a literal pattern.
    Metacharacters or escape sequences in the input sequence will be given no special meaning.
    
    Parameters:
    
    s - The string to be literalized
    
    Returns:
    
    A literal string replacement
  - toString
```
public String toString()
```
    Overrides:
    
    toString in class Object
  - groupCount
```
public int groupCount()
```
    Returns the number of capturing groups in this matcher's pattern. Group zero denotes the enture pattern and is excluded from this count.
    
    Returns:
    
    the number of capturing groups in this pattern

Class Pattern

Field Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

CASE_INSENSITIVE

DOTALL

MULTILINE

DISABLE_UNICODE_GROUPS

Method Detail

reset

flags

pattern

compile

compile

matches

matches

matcher

split

split

quote

toString

groupCount