UnicodeSet 類別

定義

[Android.Runtime.Register("android/icu/text/UnicodeSet", ApiSince=24, DoNotGenerateAcw=true)]
public class UnicodeSet : Android.Icu.Text.UnicodeFilter, Android.Icu.Util.IFreezable, IDisposable, Java.Lang.IComparable, Java.Lang.IIterable

[<Android.Runtime.Register("android/icu/text/UnicodeSet", ApiSince=24, DoNotGenerateAcw=true)>]
type UnicodeSet = class
    inherit UnicodeFilter
    interface IFreezable
    interface ICloneable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable
    interface IComparable
    interface IIterable

繼承

Object

JavaObject

Object

UnicodeFilter

UnicodeSet

屬性

RegisterAttribute

實作

IFreezable IJavaObject IJavaPeerable ICloneable IComparable IIterable IDisposable

備註

一組可變的 Unicode 字元與多字元字串。 此類別的物件代表 <em>字元類別</em> ，用於正規表達式。 一個字元指定 Unicode 碼點的子集。 法律代碼點數為U+0000至U+10FFFF，包含。

注意：方法凍結（）不僅使集合不可變，還能大幅提升重要方法的效能：包含（c）、包含無人（...）、span（...）、spanBack（...）等。物件凍結後，任何後續想要更改物件的呼叫都會拋出 UnsupportedOperationException。

UnicodeSet 類別並非設計用來子類別化。

UnicodeSet 支援兩個 API。 第一個是 <em 運算元>/em< API，允許呼叫者修改物件的>UnicodeSet值。 它符合 Java 2 java.util.Set 的介面，雖然UnicodeSet實際上並未實作該介面。 所有 的方法 Set 都被支援，但修改後它們會取一個字元範圍或單一字元，而非 Object，且使用 a UnicodeSet 代替 Collection。 操作數 API 可以用布林邏輯來思考：布林 OR 由 實作 add，布林 AND 由 實作 retain，布林異或透過 complement 取參數實作，布林 NOT 則由無參數實作 complement 。 以傳統集合論函數名稱而言，是 add 聯集， retain 是交集， remove 是非對稱差， complement 且無參數時，是相對於超集合範圍的集合補集 MIN_VALUE-MAX_VALUE

第二個 API 是 applyPattern()/toPattern() -衍生類別中的 java.text.FormatAPI。 與新增字元、新增類別及控制集合邏輯的方法不同，該方法 applyPattern() 會根據字串模式一次性設定 的所有 UnicodeSet 屬性。

<b>模式語法</b>

模式被建構子和 applyPattern() 方法接受，方法則回傳 toPattern() 。 這些模式遵循類似版本 8 正則表達式字元類別所採用的語法。 以下是一些簡單的例子：

<Blockquote><表格><TR style=“vertical-align： top”td>< style=“white-space： nowrap;vertical-align： top;horizontal-align： left;”>[]</td><td 風格=“垂直對齊：頂部;”>無字元</td></tr><tr 風格=“垂直對齊：top”><td style=“空白：無摺疊;垂直對齊：頂部;水平對齊：左側;”>[a]</td><td 風格=“垂直對齊：頂部;”>字元 'a'/<td></tr><tr style=“vertical-align： top”><td style=“white-space： nowrap;vertical-align： top;horizontal-align： left;”>[ae]</td><td 風格=“垂直對齊：頂部;”>字元 'a' 和 'e'/td<>/<tr><tr td><style=“空白：無摺疊;垂直對齊：上;水平對齊：左;”>[a-e]</td><td 風格=“垂直對齊：頂部;”>包含 'a' 到 'e' 字元，Unicode 代碼中點排序</td></tr><tr td><style=“空白：無摺疊;垂直對齊：上;水平對齊：左側;”>[\\u4E01]</td><td 風格=“垂直對齊：頂部;”>字元 U+4E01</td></tr><tr td><style=“空白：nowrap;vertical-align：top;horizontal-align：left;”>[a{ab}{ac}]</td><td 風格=“垂直對齊：頂部;”>字元 'a' 與多字元字串 ”AB”以及 &ac”</td/tr><TR><TD 風格=「空白：無摺疊;垂直對齊：上;水平對齊：左;」><>[\p{Lu}]</td><td 風格=“垂直對齊：頂部;”>所有屬於一般類別的字元：大寫字母</td></tr></表格></引用>

任何字元前都可以加上反斜線，以消除任何特殊意義。 根據 Unicode Pattern_White_Space 屬性定義的空白字元會被忽略，除非有逃逸。

屬性模式指定一組具有 Unicode 標準定義的特定屬性的字元。 同時辨識類似 POSIX 的「[：Lu：]」與類似 Perl 的語法「\p{Lu}」。 欲了解完整的支援屬性模式清單，請參閱 UnicodeSet 使用者指南。 https://unicode-org.github.io/icu/userguide/strings/unicodeset 屬性資料的實際判定由 UCharacter 實作的底層 Unicode 資料庫定義。

模式指定個別字元、字元範圍及 Unicode 屬性集。 當元素被串接時，它們指定了其聯集。 為了補足一個集合，請在開頭的 '[' 後面放置一個 '^'。 屬性模式透過修改分隔符來反轉;「[：^foo]」和「\P{foo}」。 在其他地點，「^」沒有特別意義。

自 ICU 70 起，「[^...]」、「[：^foo]」、「\P{foo}」和「[：binaryProperty=No：]」執行「碼點補集」（所有碼點減去原始集合），移除所有多字元字串，等同於 .#complement(). #removeAllStrings()。 #complement() API 函式持續對所有碼點執行對稱差分，因此保留所有多字元字串。

區間則以兩個「-」夾在兩個字元之間來表示，如「a-z」。 此指令指定所有字元從左到右的範圍，依 Unicode 順序排列。 如果左邊的字元大於或等於右邊的字元，則是語法錯誤。 如果「-」出現在開頭「['或「[^'之後的第一個字元，或是結尾「]」之前的最後一個字元，則視為字面值。 因此，「[a\\-b]」、「[-ab]」和「[ab-]」都表示同一組三個字元，分別是「a」、「b」和「-」。

集合可以用「&' 運算子相交，或用 '-' 運算子來計算非對稱集合差，例如，「[[：L：]&[\\u0000-\\u0FFF]]“ 表示所有值小於 4096 的 Unicode 字母集合。 運算子（'&' 與 '|'）具有相同的優先順序，並從左向右綁定。 因此「[[[：L：]-[a-z]-[\\u0100-\\u01FF]]」等同於「[[[：L：]-[a-z]]-[\\u0100-\\u01FF]]」。 這點主要影響差異;交集是交換的。

<table><tr style=“vertical-align： top;”><TD style=“空白空間：nowrap;”>[a]<td>包含 'a' <tr style=“vertical-align： top;”><TD style=“空白空間：nowrap;”>[a-z]<td>包含 'a' 到 'z' 及其中間所有字母的集合，依 Unicode 順序 <tr style=“vertical-align： top;”><TD style=“空白空間：nowrap;”>[^a-z]<td>包含除 'a' 到 'z' 以外的所有字元的集合，即 U+0000 到 'a'-1 以及 'z'+1 到 U+10FFFF <tr style=“vertical-align： top;”><TD style=“空白空間：nowrap;”>[[<em>pat1</em>][<em>pat2</em>]]<td>由 <em>pat1</em> 與 <em>pat2</em><tr 風格所指定的集合聯集=「垂直對齊：top;」><TD style=“空白空間：nowrap;”>[[<em>pat1</em>]&amp;[<em>pat2</em>]]<td>由 <em>pat1</em> 與 <em>pat2</em><tr 風格所指定的集合的交集=「垂直對齊：頂;」><TD style=“空白空間：nowrap;”>[[<em>pat1</em>]-[<em>pat2</em>]]<td>由 <em>pat1</em> 與 <em>pat2</em><tr 風格所指定的集合的非對稱差=「垂直對齊：頂部;」><TD style=“空白空間：nowrap;”>[:Lu:] or \p{Lu}<td>具有指定 Unicode 屬性的字元集合;在此例中，Unicode 大寫字母 <tr style=“vertical-align： top;”><TD style=“空白空間：nowrap;”>[:^Lu:] or \P{Lu}<td>具有特定 Unicode 屬性 </表格的字元 >em<not>/em< 集合>

<b>形式語法</b>

<Blockquote><表格><TR style=“vertical-align： top”><td style=“white-space： nowrap;vertical-align： top;” align=“right”>pattern :=  </td><td style=“vertical-align： top;”>('[' '^'? item* ']') | property</td/tr><tr style=“vertical-align： top”><td style=“white-space： nowrap;vertical-align： top;” align=“right”/><>tditem :=  <td style=“vertical-align： top;”><>char | (char '-' char) | pattern-expr<br> </td/tr><tr style=“vertical-align： top”><td style=“white-space： nowrap;vertical-align： top;” align=“right”/><>tdpattern-expr :=  <td style=“vertical-align： top;”><>pattern | pattern-expr pattern | pattern-expr op pattern<br> </td/tr><tr style=“vertical-align： top”><td style=“white-space： nowrap;vertical-align： top;” align=“right”/><>tdop :=  <td style=“vertical-align： top;”><>'&amp;' | '-'<br> </td/tr><tr style=“vertical-align： top”><td style=“white-space： nowrap;vertical-align： top;” align=“right”/><>tdspecial :=  <td style=“vertical-align： top;”><>'[' | ']' | '-'<br> </td/tr><tr style=“vertical-align： top”><td style=“white-space： nowrap;vertical-align： top;” align=“right”/><>tdchar :=  <td style=“vertical-align： top;”><><EM 任何非 /em><>字元 em 任意 special<br> | ('\\' 字元</em><>/td)<br> | ('&#92;u' hex hex hex hex)<br> </tr><TR style=“vertical-align： top”><td style=“white-space： nowrap;vertical-align： top;” align=“right”><>/tdhex :=  <TD style=“vertical-align： top;”><>'0' | '1' | '2' | '3' | '4' | '5' | '6' | '7' | '8' | '9' |<br> &nbsp;&nbsp;&nbsp;&nbsp;'A' | 'B' | 'C' | 'D' | 'E' | 'F' | 'a' | 'b' | 'c' | 'd' | 'e' | 'f'</td/tr><TR><TD 風格=“空白：無摺疊;垂直對齊：頂部;” align=“right”/><>tdproperty :=  <TD 風格=“垂直對齊：頂部;”><><em>a Unicode 屬性集合 pattern</em></td></tr></table><br table border><=“1”><tr><td>圖例：<table><tr><td style=“white-space： nowrap;vertical-align： top;”>a := b</td td><style=“寬度：20;垂直對齊：top;”> </結束><TD 風格=「垂直對齊：頂部;」>a可被 b/td<>/tr<><>TD 風格=「空白：無摺疊;垂直對齊：頂部;」<>a?</td><td 風格=“垂直對齊：頂部;”></td><td 風格=“垂直對齊：頂部;”>零或一個 bra/td<>/tr<>實例<> tr<>TD 風格=「空白：無摺疊;垂直對齊：頂部;」<>a*</td><td 風格=“垂直對齊：頂部;”></td><td 風格=“垂直對齊：頂部;”>一個或多個 a<BR></TD></TR><TR><TD 風格=「空白：無包;垂直對齊：頂部;」>a | b</td><td 風格=“垂直對齊：頂部;”></td><td 風格=“垂直對齊：頂部;”>或 ab<BR></td></tr><tr TD><風格=「空白：無摺疊;垂直對齊：頂部;」>'a'</td><td 風格=“垂直對齊：頂部;”></td><td 風格=“垂直對齊：頂部;”>引號 </td></tr></table></td></tr/table><></blockquote 之間的字串>

要遍歷 的內容UnicodeSet，可用以下方法：<ul><li>以遍歷範圍：#ranges()， #rangeStream()</li><li>遍歷字串： #strings()，#stringStream()< /li><li>遍歷代碼點： #codePoints()， /#codePointStream()<li><li>以在單一迴圈中遍歷整個內容：此類別本身為 Iterable， ， 或使用 。#stream()<br> 然而，這些方法效率並不特別高，因為它們會將每個編碼點轉換成 String。 </ul>

迭代器與串流方法在 Java 慣用語中運作正常。<br> 這個UnicodeSetIterator詞不能用於 <b>for</b> 迴圈，而且它不太符合 Java 慣用語，因為它很老舊。 但在某些使用情境下，可能會更快。 我們建議您以效能敏感的程式碼來衡量。<BR>

要替換、計數元素或刪除張距，請參見 android.icu.text.UnicodeSetSpanner UnicodeSetSpanner。

Java 文件 android.icu.text.UnicodeSet。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。