Implements: Serializable

正則表示式的編譯表示形式。

指定為字串的正則表示式必須首先被編譯為此類的例項。然後，可將得到的模式用於建立 Matcher 物件，依照正則表示式，該物件可以與任意字元序列匹配。執行匹配所涉及的所有狀態都駐留在匹配器中，所以多個匹配器可以共享同一模式。

因此，典型的呼叫順序是

  Pattern p = Pattern.compile("a*b"); Matcher m = p.matcher("aaaaab"); boolean b = m.matches();

在僅使用一次正則表示式時，可以方便地通過此類定義 matches

  boolean b = Pattern.matches("a*b", "aaaaab");

等效於上面的三個語句，儘管對於重複的匹配而言它效率不高，因為它不允許重用已編譯的模式。

此類的例項是不可變的，可供多個併發執行緒安全使用。Matcher 類的例項用於此目的則不安全。

正則表示式的構造摘要

的非捕獲組

反斜線、轉義和引用

反斜線字元 ('/') 用於引用轉義構造，如上表所定義的，同時還用於引用其他將被解釋為非轉義構造的字元。因此，表示式 // 與單個反斜線匹配，而 /{與左括號匹配。

在不表示轉義構造的任何字母字元前使用反斜線都是錯誤的；它們是為將來擴充套件正則表示式語言保留的。可以在非字母字元前使用反斜線，不管該字元是否非轉義構造的一部分。

根據 Java Language Specification 的要求，Java 原始碼的字串中的反斜線被解釋為 Unicode 轉義或其他字元轉義。因此必須在字串字面值中使用兩個反斜線，表示正則表示式受到保護，不被 Java 位元組碼編譯器解釋。例如，當解釋為正則表示式時，字串字面值 "/b" 與單個退格字元匹配，而 "//b" 與單詞邊界匹配。字串字面值 "/(hello/)" 是非法的，將導致編譯時錯誤；要與字串 (hello) 匹配，必須使用字串字面值 "//(hello//)"。

字元類

字元類可以出現在其他字元類中，並且可以包含並集運算子（隱式）和交集運算子 (&&)。並集運算子表示至少包含其某個運算元類中所有字元的類。交集運算子表示包含同時位於其兩個運算元類中所有字元的類。

字元類運算子的優先順序如下所示，按從最高到最低的順序排列：

1	字面值轉義	/x
2	分組	[...]
3	範圍	a-z
4	並集	[a-e][i-u]
5	交集	[a-z&&[aeiou]]

注意，元字元的不同集合實際上位於字元類的內部，而非字元類的外部。例如，正則表示式 . 在字元類內部就失去了其特殊意義，而表示式 - 變成了形成元字元的範圍。

行結束符

行結束符是一個或兩個字元的序列，標記輸入字元序列的行結尾。以下程式碼被識別為行結束符：

• 新行（換行）符 ('/n')、
• 後面緊跟新行符的回車符 ("/r/n")、
• 單獨的回車符 ('/r')、
• 下一行字元 ('/u0085')、
• 行分隔符 ('/u2028') 或
• 段落分隔符 ('/u2029)。

如果啟用 #UNIX_LINES模式，則新行符是唯一識別的行結束符。

如果未指定 #DOTALL 標誌，則正則表示式 .可以與任何字元（行結束符除外）匹配。

預設情況下，正則表示式 ^ 和 $ 忽略行結束符，僅分別與整個輸入序列的開頭和結尾匹配。如果啟用 #MULTILINE 模式，則 ^ 在輸入的開頭和行結束符之後（輸入的結尾）才發生匹配。處於 #MULTILINE模式中時，$ 僅在行結束符之前或輸入序列的結尾處匹配。

組和捕獲

捕獲組可以通過從左到右計算其開括號來編號。例如，在表示式 ((A)(B(C))) 中，存在四個這樣的組：

1	((A)(B(C)))
2	/A
3	(B(C))
4	(C)

組零始終代表整個表示式。

之所以這樣命名捕獲組是因為在匹配中，儲存了與這些組匹配的輸入序列的每個子序列。捕獲的子序列稍後可以通過 Back 引用在表示式中使用，也可以在匹配操作完成後從匹配器獲取。

與組關聯的捕獲輸入始終是與組最近匹配的子序列。如果由於量化的緣故再次計算了組，則在第二次計算失敗時將保留其以前捕獲的值（如果有的話）例如，將字串 "aba" 與表示式 (a(b)?)+ 相匹配，會將第二組設定為 "b"。在每個匹配的開頭，所有捕獲的輸入都會被丟棄。

以 (?) 開頭的組是純的非捕獲組，它不捕獲文字，也不針對組合計進行計數。

Unicode 支援

此類符合 Unicode Technical Standard #18:Unicode Regular Expression Guidelines第 1 級和 RL2.1 Canonical Equivalents。

Java 原始碼中的 Unicode 轉義序列（如 /u2014）是按照 Java Language Specification 的 第 3.3 節中的描述處理的。這樣的轉義序列還可以由正則表示式解析器直接實現，以便在從檔案或鍵盤擊鍵讀取的表示式中使用 Unicode 轉義。因此，可以將不相等的字串 "/u2014" 和 "//u2014" 編譯為相同的模式，從而與帶有十六進位制值 0x2014 的字元匹配。

與 Perl 中一樣，Unicode 塊和類別是使用 /p 和 /P 構造編寫的。如果輸入具有屬性 prop，則與 /p{prop} 匹配，而輸入具有該屬性時與 /P{prop} 不匹配。塊使用字首 In 指定，與在 InMongolian 中一樣。可以使用可選字首 Is 指定類別：/p{L} 和 /p{IsL}都表示 Unicode 字母的類別。塊和類別在字元類的內部和外部都可以使用。

受支援的類別是由 Character 類指定版本中的 The Unicode Standard 的類別。類別名稱是在 Standard 中定義的，即標準又豐富。Pattern 所支援的塊名稱是 UnicodeBlock.forName 所接受和定義的有效塊名稱。

行為類似 java.lang.Character boolean 是 methodname 方法（廢棄的類別除外）的類別，可以通過相同的 /p{prop} 語法來提供，其中指定的屬性具有名稱 javamethodname。

與 Perl 5 相比較

Pattern引擎用有序替換項執行傳統上基於 NFA 的匹配，與 Perl 5 中進行的相同。

此類不支援 Perl 構造：

• 條件構造 (?{X}) 和 (?(condition)X|Y)、

• 嵌入式程式碼構造 (?{code}) 和 (??{code})、

• 嵌入式註釋語法 (?#comment) 和

• 預處理操作 /l /u、/L 和 /U。

此類支援但 Perl 不支援的構造：

• Possessive 數量詞，它可以儘可能多地進行匹配，即使這樣做導致所有匹配都成功時也如此。

• 字元類並集和交集，如上文所述。

與 Perl 的顯著不同點是：

• 在 Perl 中，/1 到 /9 始終被解釋為 Back 引用；如果至少存在多個子表示式，則大於 9 的反斜線轉義數按 Back 引用對待，否則在可能的情況下，它將被解釋為八進位制轉義。在此類中，八進位制轉義必須始終以零開頭。在此類中，/1 到 /9 始終被解釋為 Back 引用，較大的數被接受為 Back 引用，如果在正則表示式中至少存在多個子表示式的話；否則，解析器將刪除數字，直到該數小於等於組的現有數或者其為一個數字。

• Perl 使用 g 標誌請求恢復最後匹配丟失的匹配。此功能是由 Matcher 類顯式提供的：重複執行 find 方法呼叫可以恢復丟失的最後匹配，除非匹配器被重置。

• 在 Perl 中，位於表示式頂級的嵌入式標記對整個表示式都有影響。在此類中，嵌入式標誌始終在它們出現的時候才起作用，不管它們位於頂級還是組中；在後一種情況下，與在 Perl 中類似，標誌在組的結尾處還原。

• Perl 允許錯誤匹配構造，如在表示式 *a 中，以及不匹配的括號，如在在表示式 abc] 中，並將其作為字面值對待。此類還接受不匹配的括號，但對 +、? 和 * 不匹配元字元有嚴格限制；如果遇到它們，則丟擲 PatternSyntaxException。

有關正則表示式構造行為更準確的描述，請參見 Mastering Regular Expressions, 2nd Edition，該書由 Jeffrey E. F. Friedl、O'Reilly 和 Associates 合著，於 2002 年出版。