java.util.regex
類 Pattern
java.lang.Objectjava.util.regex.Pattern
- 所有已實現的接口:
- Serializable
- extends Object
- implements Serializable
public final class Pattern
正則表達式的編譯表示形式。
指定為字符串的正則表達式必須首先被編譯為此類的實例。然后,可將得到的模式用于創建 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
類的實例用于此目的則不安全。 正則表達式的構造摘要
構造 | 匹配 |
---|---|
? | |
字符 | |
x | 字符 x |
\\ | 反斜線字符 |
\0n | 帶有八進制值 0 的字符 n (0?<=?n?<=?7) |
\0nn | 帶有八進制值 0 的字符 nn (0?<=?n?<=?7) |
\0mnn | 帶有八進制值 0 的字符 mnn(0?<=?m?<=?3、0?<=?n?<=?7) |
\xhh | 帶有十六進制值?0x 的字符 hh |
\uhhhh | 帶有十六進制值?0x 的字符 hhhh |
\t | 制表符 ('\u0009') |
\n | 新行(換行)符 ('\u000A') |
\r | 回車符 ('\u000D') |
\f | 換頁符 ('\u000C') |
\a | 報警 (bell) 符 ('\u0007') |
\e | 轉義符 ('\u001B') |
\cx | 對應于 x 的控制符 |
? | |
字符類 | |
[abc] | a、b 或 c(簡單類) |
[^abc] | 任何字符,除了 a、b 或 c(否定) |
[a-zA-Z] | a 到 z 或 A 到 Z,兩頭的字母包括在內(范圍) |
[a-d[m-p]] | a 到 d 或 m 到 p:[a-dm-p](并集) |
[a-z&&[def]] | d、e 或 f(交集) |
[a-z&&[^bc]] | a 到 z,除了 b 和 c:[ad-z](減去) |
[a-z&&[^m-p]] | a 到 z,而非 m 到 p:[a-lq-z](減去) |
? | |
預定義字符類 | |
. | 任何字符(與行結束符可能匹配也可能不匹配) |
\d | 數字:[0-9] |
\D | 非數字: [^0-9] |
\s | 空白字符:[ \t\n\x0B\f\r] |
\S | 非空白字符:[^\s] |
\w | 單詞字符:[a-zA-Z_0-9] |
\W | 非單詞字符:[^\w] |
? | |
POSIX 字符類(僅 US-ASCII) | |
\p{Lower} | 小寫字母字符:[a-z] |
\p{Upper} | 大寫字母字符:[A-Z] |
\p{ASCII} | 所有 ASCII:[\x00-\x7F] |
\p{Alpha} | 字母字符:[\p{Lower}\p{Upper}] |
\p{Digit} | 十進制數字:[0-9] |
\p{Alnum} | 字母數字字符:[\p{Alpha}\p{Digit}] |
\p{Punct} | 標點符號:!"#$%&'()*+,-./:;<=>?@[\]^_`{|}~ |
\p{Graph} | 可見字符:[\p{Alnum}\p{Punct}] |
\p{Print} | 可打印字符:[\p{Graph}\x20] |
\p{Blank} | 空格或制表符:[ \t] |
\p{Cntrl} | 控制字符:[\x00-\x1F\x7F] |
\p{XDigit} | 十六進制數字:[0-9a-fA-F] |
\p{Space} | 空白字符:[ \t\n\x0B\f\r] |
? | |
java.lang.Character 類(簡單的 java 字符類型) | |
\p{javaLowerCase} | 等效于 java.lang.Character.isLowerCase() |
\p{javaUpperCase} | 等效于 java.lang.Character.isUpperCase() |
\p{javaWhitespace} | 等效于 java.lang.Character.isWhitespace() |
\p{javaMirrored} | 等效于 java.lang.Character.isMirrored() |
? | |
Unicode 塊和類別的類 | |
\p{InGreek} | Greek?塊(簡單塊)中的字符 |
\p{Lu} | 大寫字母(簡單類別) |
\p{Sc} | 貨幣符號 |
\P{InGreek} | 所有字符,Greek 塊中的除外(否定) |
[\p{L}&&[^\p{Lu}]]? | 所有字母,大寫字母除外(減去) |
? | |
邊界匹配器 | |
^ | 行的開頭 |
$ | 行的結尾 |
\b | 單詞邊界 |
\B | 非單詞邊界 |
\A | 輸入的開頭 |
\G | 上一個匹配的結尾 |
\Z | 輸入的結尾,僅用于最后的結束符(如果有的話) |
\z | 輸入的結尾 |
? | |
Greedy 數量詞 | |
X? | X,一次或一次也沒有 |
X* | X,零次或多次 |
X+ | X,一次或多次 |
X{n} | X,恰好 n 次 |
X{n,} | X,至少 n 次 |
X{n,m} | X,至少 n 次,但是不超過 m 次 |
? | |
Reluctant 數量詞 | |
X?? | X,一次或一次也沒有 |
X*? | X,零次或多次 |
X+? | X,一次或多次 |
X{n}? | X,恰好 n 次 |
X{n,}? | X,至少 n 次 |
X{n,m}? | X,至少 n 次,但是不超過 m 次 |
? | |
Possessive 數量詞 | |
X?+ | X,一次或一次也沒有 |
X*+ | X,零次或多次 |
X++ | X,一次或多次 |
X{n}+ | X,恰好 n 次 |
X{n,}+ | X,至少 n 次 |
X{n,m}+ | X,至少 n 次,但是不超過 m 次 |
? | |
Logical 運算符 | |
XY | X 后跟 Y |
X|Y | X 或 Y |
(X) | X,作為捕獲組 |
? | |
Back 引用 | |
\n | 任何匹配的 nth捕獲組 |
? | |
引用 | |
\ | Nothing,但是引用以下字符 |
\Q | Nothing,但是引用所有字符,直到 \E |
\E | Nothing,但是結束從 \Q 開始的引用 |
? | |
特殊構造(非捕獲) | |
(?:X) | X,作為非捕獲組 |
(?idmsux-idmsux)? | Nothing,但是將匹配標志由 on 轉為 off |
(?idmsux-idmsux:X)?? | X,作為帶有給定標志 on - off 的非捕獲組 |
(?=X) | X,通過零寬度的正 lookahead |
(?!X) | X,通過零寬度的負 lookahead |
(?<=X) | X,通過零寬度的正 lookbehind |
(?<!X) | X,通過零寬度的負 lookbehind |
(?>X) | X,作為獨立的非捕獲組 |
反斜線、轉義和引用
反斜線字符 ('\') 用于引用轉義構造,如上表所定義的,同時還用于引用其他將被解釋為非轉義構造的字符。因此,表達式 \\ 與單個反斜線匹配,而 \{ 與左括號匹配。
在不表示轉義構造的任何字母字符前使用反斜線都是錯誤的;它們是為將來擴展正則表達式語言保留的。可以在非字母字符前使用反斜線,不管該字符是否非轉義構造的一部分。
根據 Java Language Specification 的要求,Java 源代碼的字符串中的反斜線被解釋為 Unicode 轉義或其他字符轉義。因此必須在字符串字面值中使用兩個反斜線,表示正則表達式受到保護,不被 Java 字節碼編譯器解釋。例如,當解釋為正則表達式時,字符串字面值 "\b" 與單個退格字符匹配,而 "\\b" 與單詞邊界匹配。字符串字面值 "\(hello\)" 是非法的,將導致編譯時錯誤;要與字符串 (hello) 匹配,必須使用字符串字面值 "\\(hello\\)"。 字符類可以出現在其他字符類中,并且可以包含并集運算符(隱式)和交集運算符 (&&)。并集運算符表示至少包含其某個操作數類中所有字符的類。交集運算符表示包含同時位于其兩個操作數類中所有字符的類。 字符類運算符的優先級如下所示,按從最高到最低的順序排列: 注意,元字符的不同集合實際上位于字符類的內部,而非字符類的外部。例如,正則表達式 . 在字符類內部就失去了其特殊意義,而表達式 - 變成了形成元字符的范圍。 行結束符 是一個或兩個字符的序列,標記輸入字符序列的行結尾。以下代碼被識別為行結束符: 如果激活 如果未指定 默認情況下,正則表達式 ^ 和 $ 忽略行結束符,僅分別與整個輸入序列的開頭和結尾匹配。如果激活 捕獲組可以通過從左到右計算其開括號來編號。例如,在表達式 ((A)(B(C))) 中,存在四個這樣的組: 組零始終代表整個表達式。 之所以這樣命名捕獲組是因為在匹配中,保存了與這些組匹配的輸入序列的每個子序列。捕獲的子序列稍后可以通過 Back 引用在表達式中使用,也可以在匹配操作完成后從匹配器檢索。 與組關聯的捕獲輸入始終是與組最近匹配的子序列。如果由于量化的緣故再次計算了組,則在第二次計算失敗時將保留其以前捕獲的值(如果有的話)例如,將字符串 "aba" 與表達式 (a(b)?)+ 相匹配,會將第二組設置為 "b"。在每個匹配的開頭,所有捕獲的輸入都會被丟棄。 以 (?) 開頭的組是純的非捕獲 組,它不捕獲文本,也不針對組合計進行計數。 此類符合 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 中一樣??梢允褂每蛇x前綴 Is 指定類別:\p{L} 和 \p{IsL} 都表示 Unicode 字母的類別。塊和類別在字符類的內部和外部都可以使用。 受支持的類別是由 行為類似 java.lang.Character boolean 是 methodname 方法(廢棄的類別除外)的類別,可以通過相同的 \p{prop} 語法來提供,其中指定的屬性具有名稱 javamethodname。 此類不支持 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 標志請求恢復最后匹配丟失的匹配。此功能是由 在 Perl 中,位于表達式頂級的嵌入式標記對整個表達式都有影響。在此類中,嵌入式標志始終在它們出現的時候才起作用,不管它們位于頂級還是組中;在后一種情況下,與在 Perl 中類似,標志在組的結尾處還原。 Perl 允許錯誤匹配構造,如在表達式 *a 中,以及不匹配的括號,如在在表達式 abc] 中,并將其作為字面值對待。此類還接受不匹配的括號,但對 +、? 和 * 不匹配元字符有嚴格限制;如果遇到它們,則拋出 有關正則表達式構造行為更準確的描述,請參見《Mastering Regular Expressions, 2nd Edition》,該書由 Jeffrey E. F. Friedl、O'Reilly 和 Associates 合著,于 2002 年出版。 字符類
1???? 字面值轉義???? \x 2???? 分組 [...] 3???? 范圍 a-z 4???? 并集 [a-e][i-u] 5???? 交集 [a-z&&[aeiou]] 行結束符
UNIX_LINES
模式,則新行符是惟一識別的行結束符。 DOTALL
標志,則正則表達式 . 可以與任何字符(行結束符除外)匹配。 MULTILINE
模式,則 ^ 在輸入的開頭和行結束符之后(輸入的結尾)才發生匹配。處于 MULTILINE
模式中時,$ 僅在行結束符之前或輸入序列的結尾處匹配。 組和捕獲
1???? ((A)(B(C))) 2???? \A 3???? (B(C)) 4???? (C) Unicode 支持
Character
類指定版本中的 The Unicode Standard 的類別。類別名稱是在 Standard 中定義的,即標準又豐富。Pattern
所支持的塊名稱是 UnicodeBlock.forName
所接受和定義的有效塊名稱。 與 Perl 5 相比較
Pattern
引擎用有序替換項執行傳統上基于 NFA 的匹配,與 Perl 5 中進行的相同。 Matcher
類顯式提供的:重復執行 find
方法調用可以恢復丟失的最后匹配,除非匹配器被重置。 PatternSyntaxException
。 String.split(String, int)
, String.split(String)
, 序列化表格
字段摘要 | |
---|---|
static?int | CANON_EQ ??????????啟用規范等價。 |
static?int | CASE_INSENSITIVE ??????????啟用不區分大小寫的匹配。 |
static?int | COMMENTS ??????????模式中允許空白和注釋。 |
static?int | DOTALL ??????????啟用 dotall 模式。 |
static?int | LITERAL ??????????啟用模式的字面值分析。 |
static?int | MULTILINE ??????????啟用多行模式。 |
static?int | UNICODE_CASE ??????????啟用 Unicode 感知的大小寫折疊。 |
static?int | UNIX_LINES ??????????啟用 Unix 行模式。 |
方法摘要 | |
---|---|
static?Pattern | compile(String?regex) ??????????將給定的正則表達式編譯到模式中。 |
static?Pattern | compile(String?regex, int?flags) ??????????將給定的正則表達式編譯到具有給定標志的模式中。 |
?int | flags() ??????????返回此模式的匹配標志。 |
?Matcher | matcher(CharSequence?input) ??????????創建匹配給定輸入與此模式的匹配器。 |
static?boolean | matches(String?regex, CharSequence?input) ??????????編譯給定正則表達式并嘗試將給定輸入與其匹配。 |
?String | pattern() ??????????返回在其中編譯過此模式的正則表達式。 |
static?String | quote(String?s) ??????????返回指定 String 的字面值模式 String 。 |
?String[] | split(CharSequence?input) ??????????圍繞此模式的匹配拆分給定輸入序列。 |
?String[] | split(CharSequence?input, int?limit) ??????????圍繞此模式的匹配拆分給定輸入序列。 |
?String | toString() ??????????返回此模式的字符串表示形式。 |
從類 java.lang.Object 繼承的方法 |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
這樣下來檢驗email的代碼也是相當簡單呀....
???? boolean b = Pattern.matches("^\\w+@\\w+(\\.\\w+)+", email);