RegexPattern Class

A class that holds regular expression patterns.

The Compile static method compiles the specified regular expression and creates a RegexPattern object. The generated RegexPattern object is used to generate an object of the RegexMatcher class, which is a regular expression engine for matching with any input string.

You can create multiple RegexMathcer objects from a single RegexPattern object. Each RegexMatcher object shares the same regular expression pattern.

Default properties and ValueType

The default property is Pattern. The ValueType specification is invalid.

A Unicode mode has been added that handles more Unicode strings. ->

About Unicode mode

If you specify RegexPattern.Unicode as an argument of Compile method and Matches method, you can generate a regular expression engine in Unicode mode.

In Unicode mode, regular expressions and input strings are treated as UString type, and Unicode characters can be used.

The index that represents the position of the character (Start of RegexMatcher class, result of End method, etc.) is in character units (byte units when not in Unicode mode).

<-Up to here

Typical usage

1. Compile the regular expression with the Compile static method to create a RegexPattern object.
2. Create a RegexMatcher object that matches the regular expression pattern and the input string by the Matcher method of the RegexPattern object generated in 1.
3. Match with the Matches method, Find method, etc. of the RegexMatcher object generated in 2.

/* Compile the regular expression */
var p = RegexPattern.Compile("Biz/([a-zA-Z]+)");
/* Set the input string and generate a regular expression engine */
var m = p.Matcher("Biz/Browser, Biz/Designer");
 
/* Perform a partial match search */
while (m.Find()) {
    /* Show the entire partially matched part */
    print(m.Group());
    /* Show first forward reference group */
    print(" [", m.Group(1) , "]", "\n");
}
/* Fully matched */
print("Matches:", m.Matches(), "\n");
 
/* Match from the beginning */
print("LookingAt:", m.LookingAt(), "\n");
 
----- Execution result -----
Biz/Browser [ Browser ]
Biz/Designer [ Designer ]
Matches: 0
LookingAt: 1

Regular expression syntax summary

You can use Perl-like syntax for regular expressions.

• PCRE (Perl Compatible Regular Expressions) is used in the regular expression class.

Metacharacters

Metacharacters that can be used in character classes

※ The regular expression of Biz / Browser uses UTF-8 as the character code of the internal data. When specifying the character range, the UTF-8 character code is used to determine the range. (It is always UTF-8 regardless of the Unicode mode specification.) Be careful when specifying characters such as “Kanji” in the range.

Binary character

General character

Position specifier

Character class[:class:]

Quantum specifier

Table of contents

• Properties
• Methods
• Events