Skip to content

Most visited

Recently visited

Added in API level 1


Classes for matching character sequences against patterns specified by regular expressions.

An instance of the Pattern class represents a regular expression that is specified in string form in a syntax similar to that used by Perl.

Instances of the Matcher class are used to match character sequences against a given pattern. Input is provided to matchers via the CharSequence interface in order to support matching against characters from a wide variety of input sources.

Unless otherwise noted, passing a null argument to a method in any class or interface in this package will cause a NullPointerException to be thrown.

Related Documentation

An excellent tutorial and overview of regular expressions is Mastering Regular Expressions, Jeffrey E. F. Friedl, O'Reilly and Associates, 1997.


MatchResult The result of a match operation. 


Matcher An engine that performs match operations on a character sequence by interpreting a Pattern
Pattern A compiled representation of a regular expression. 


PatternSyntaxException Unchecked exception thrown to indicate a syntax error in a regular-expression pattern. 
This site uses cookies to store your preferences for site-specific language and display options.


This class requires API level or higher

This doc is hidden because your selected API level for the documentation is . You can change the documentation API level with the selector above the left navigation.

For more information about specifying the API level your app requires, read Supporting Different Platform Versions.