java.util.regex

Class Pattern

java.lang.Object

java.util.regex.Pattern

public final class Pattern
extends Object

Field Summary

Fields

Modifier and Type	Field and Description
static int	CASE_INSENSITIVE Flag for comparisons independent of case.
protected int	machine Handle

Method Summary

Modifier and Type	Method and Description
static Pattern	compile(String regex) Creates a regex machine for the specified pattern.
static Pattern	compile(String regex, int flgs) Creates a regex machine for the specified pattern and flag settings.
protected void	finalize() Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.
Matcher	matcher(String string) Creates a matcher on a given string for this regex machine.
static boolean	matches(String regex, String str) Compiles the regular expression and attempts to match the string against it.
String	pattern() Returns the Regular Expression use to create this regex machine.
String[]	split(String str) Splits the provided string around matches with this regex machine.
String[]	split(String str, int limit) Splits the provided string around matches with this regex machine.
String	toString() Returns a string representation of the object.

Methods inherited from class java.lang.Object

clone, equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

machine

protected int machine

Handle

CASE_INSENSITIVE

public static final int CASE_INSENSITIVE

Flag for comparisons independent of case.

See Also:

Constant Field Values

Method Detail

compile

public static Pattern compile(String regex)

Creates a regex machine for the specified pattern.

Parameters:

regex - pattern

Returns:

instance of the compiled pattern

compile

public static Pattern compile(String regex,
                              int flgs)

Creates a regex machine for the specified pattern and flag settings.

Parameters:

regex - pattern to use

flgs - settings

Returns:

instance of the compiled pattern

pattern

public String pattern()

Returns the Regular Expression use to create this regex machine.

Returns:

the pattern associated with this machine

toString

public String toString()

Description copied from class: Object

Returns a string representation of the object. In general, the toString method returns a string that "textually represents" this object. The result should be a concise but informative representation that is easy for a person to read. It is recommended that all subclasses override this method.

The toString method for class Object returns a string consisting of the name of the class of which the object is an instance, the at-sign character `@', and the unsigned hexadecimal representation of the hash code of the object.

Overrides:

toString in class Object

Returns:

a string representation of the object.

matcher

public Matcher matcher(String string)

Creates a matcher on a given string for this regex machine.

Parameters:

string - pattern to use

Returns:

instance of the requested Matcher

matches

public static boolean matches(String regex,
                              String str)

Compiles the regular expression and attempts to match the string against it.

Parameters:

regex - regex pattern

str - string to be evaluated

Returns:

true is the string is matched by the pattern

split

public String[] split(String str)

Splits the provided string around matches with this regex machine. Returns all tokens.

Parameters:

str - string to be split into tokens

Returns:

String array of tokens

split

public String[] split(String str,
                      int limit)

Splits the provided string around matches with this regex machine.

Parameters:

str - string to be split into tokens

limit - maximum number of tokens

Returns:

array of tokens

finalize

protected void finalize()
                 throws Throwable

Description copied from class: Object

Called by the garbage collector on an object when garbage collection determines that there are no more references to the object. A subclass overrides the finalize method to dispose of system resources or to perform other cleanup.

Any exception thrown by the finalize method causes the finalization of this object to be halted, but is otherwise ignored.

The finalize method in Object does nothing.

Overrides:

finalize in class Object

Throws:

Throwable - [Need description!]