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>character クラス</em> を表します。 文字は、Unicode コード ポイントのサブセットを指定します。 有効なコード ポイントは、U+0000 から U+10FFFF までです。

注: メソッド freeze() はセットを不変にするだけでなく、重要なメソッドのパフォーマンスを大幅に向上させます。contains(c)、containsNone(...)、span(...)、spanBack(...) などです。オブジェクトが固定されると、オブジェクトを変更する後続の呼び出しでは、UnsupportedOperationException がスローされます。

UnicodeSet クラスはサブクラス化するようには設計されていません。

UnicodeSet では、2 つの API がサポートされています。 1 つ目は、呼び出し元が < オブジェクトの値を変更できるようにする >em<operand>/emUnicodeSet API です。 Java 2 のjava.util.Set インターフェイスに準拠していますが、UnicodeSetは実際にそのインターフェイスを実装していません。 Setのすべてのメソッドは、Objectの代わりに文字範囲または 1 文字を受け取り、UnicodeSetではなくCollectionを受け取る変更でサポートされています。 オペランド API はブールロジックの観点から考えられます。ブール値 OR は addによって実装され、ブール値 AND は retainによって実装され、ブール型 XOR は引数を取る complement によって実装され、ブール値 NOT は引数なしで complement によって実装されます。 従来の集合理論関数名の観点では、 add は和集合であり、 retain は交差であり、 remove は非対称の違いであり、引数のない complement はスーパーセット範囲に関して設定された補数です MIN_VALUE-MAX_VALUE

2 つ目の API は、applyPattern()派生クラスの/toPattern()java.text.Format API です。 文字の追加、カテゴリの追加、セットのロジックの制御を行うメソッドとは異なり、メソッド applyPattern() 文字列パターンに基づいて、 UnicodeSet のすべての属性を一度に設定します。

<b>Pattern 構文</b>

パターンはコンストラクターと applyPattern() メソッドによって受け入れられ、 toPattern() メソッドによって返されます。 これらのパターンは、バージョン 8 の正規表現文字クラスで使用される構文に似た構文に従います。 いくつかの簡単な例を次に示します。

<blockquote><table><tr style="vertical-align: top"><td style="white-space: nowrap; vertical-align: top; horizontal-align: left;">[]</td><td style="vertical-align: top;">文字なし</td></tr><tr style="vertical-align: top"><td style="white-space: nowrap; vertical-align: top; horizontal-align: left;">[a]</td><td style="vertical-align: top;">文字 'a'</td></tr><tr style="vertical-align: top"><td style="white-space: nowrap; vertical-align: top; horizontal-align: left;">[ae]</td><td style="vertical-align: top;">文字 'a' と 'e'</td></tr><tr><td style="white-space: nowrap; vertical-align: top; horizontal-align: left;">[a-e]</td><td style="vertical-align: top;">文字 'a' から 'e' を含む Unicode コード ポイント順</td></tr><tr><td style="white-space: nowrap; vertical-align: top; horizontal-align: left;">[\\u4E01]</td><td style="vertical-align: top;">文字 U+4E01</td></tr><tr><td style="white-space: nowrap; vertical-align: top; horizontal-align: left;">[a{ab}{ac}]</td><td style="vertical-align: top;">文字 'a' とマルチ文字文字列 >ab>および >ac></td></tr><tr><td style="white-space: nowrap; vertical-align: top; horizontal-align: left;">[\p{Lu}]</td><td style="vertical-align: top;">一般カテゴリの大文字</td></tr></table></blockquote のすべての文字>

特別な意味を削除するために、任意の文字の前に円記号を付ける場合があります。 Unicode Pattern_White_Space プロパティで定義されている空白文字は、エスケープされない限り無視されます。

プロパティ パターンは、Unicode 標準で定義されている特定のプロパティを持つ文字のセットを指定します。 POSIX に似た "[:Lu:]" と Perl に似た構文 "\p{Lu}" の両方が認識されます。 サポートされているプロパティ パターンの完全な一覧については、 https://unicode-org.github.io/icu/userguide/strings/unicodesetの UnicodeSet のユーザー ガイドを参照してください。 プロパティ データの実際の決定は、UCharacter によって実装される基になる Unicode データベースによって定義されます。

パターンは、個々の文字、文字の範囲、および Unicode プロパティ セットを指定します。 要素を連結する場合は、それらの共用体を指定します。 セットを補完するには、開始 '[' の直後に '^' を配置します。 プロパティ パターンは、区切り記号を変更することによって反転されます。"[:^foo]" と "\P{foo}"。 その他の場所では、'^' には特別な意味はありません。

ICU 70、"[^...]"、"[:^foo]"、"\P{foo}"、および "[:binaryProperty=No:]" は"コード ポイント補数" (すべてのコード ポイントから元のセットを引いた値) を実行するため、.#complement() に相当するすべてのマルチ文字文字列が削除されます。 #removeAllStrings()。 #complement() API 関数は、すべてのコード ポイントとの対称差を引き続き実行するため、すべてのマルチ文字文字列が保持されます。

範囲は、"a-z" のように、2 つの文字の間に 2 つの "-" を配置することによって示されます。 これは、左から右のすべての文字の範囲を Unicode 順に指定します。 左文字が右文字以上の場合は、構文エラーです。 '-' が開始 '[' または '[^' の後の最初の文字として発生した場合、または終了 ']' の前の最後の文字として発生した場合は、リテラルとして使用されます。 したがって、"[a\-b]"、"[-ab]"、"[ab-]" はすべて、同じ 3 文字のセット '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="white-space: nowrap;">[a]<td>'a' <tr style="vertical-align: top;"><td style="white-space: nowrap;">[a-z]<td> 'a' から 'z' までのすべての文字を Unicode 順に含むセット<tr style="vertical-align: top;"><td style="white-space: nowrap;">[^a-z]<td>'a' から 'z' までのすべての文字を含むセット。つまり、U+0000 から 'a'-1、'z'+1 から U+10FFFF <tr style="vertical-align: top;"><td style="white-space: nowrap;">[[<em>pat1</em>][<em>pat2</em>]]<td><em>pat1</em> および <em>pat2</em><tr style="vertical-align: top;"><td style="white-space: nowrap;">[[<em>pat1</em>]&amp;[<em>pat2</em>]]<td><em>pat1</em> および <em>pat2</em><tr style="vertical-align: top;"><td style="white-space: nowrap;">[[<em>pat1</em>]-[<em>pat2</em>]]<td><em>pat1</em> および <em>pat2</em><tr style="vertical-align: top;"><td style="white-space: nowrap;">[:Lu:] or \p{Lu}<td>指定した Unicode プロパティを持つ文字のセット。この場合、Unicode 大文字 <tr style="vertical-align: top;"><td style="white-space: nowrap;">[:^Lu:] or \P{Lu}<td>指定された Unicode < プロパティ>/table を持つ文字セットem<not>/em<>

<b>Formal 構文</b>

<blockquote><table><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">item :=  </td><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">pattern-expr :=  </td><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">op :=  </td><td style="vertical-align: top;">'&amp;' | '-'<br> </td></tr><tr style="vertical-align: top"><td style="white-space: nowrap; vertical-align: top;" align="right">special :=  </td><td style="vertical-align: top;">'[' | ']' | '-'<br> </td></tr><tr style="vertical-align: top"><td style="white-space: nowrap; vertical-align: top;" align="right">char :=  </td><td style="vertical-align: top;"><em>em</em> special<br> | ('\\' <em>any 文字</em>)<br> | ('&#92;u' hex hex hex hex)<br> </td></tr><tr style="vertical-align: top"><td style="white-space: nowrap; vertical-align: top;" align="right">hex :=  </td><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><trtr><td style="white-space: nowrap; vertical-align: top;" align="right">property :=  </td><td style="vertical-align: top;"><em>a Unicode プロパティ セット パターン</em></td></tr></table><br><table border="1"><tr><td>Legend: <table><tr><td style="white-space: nowrap; vertical-align: top;">a := b</td><td style="width: 20; vertical-align: top;"> </td><td style="vertical-align: top;">aは、b</td></tr><tr><td style="white-space: nowrap; vertical-align: top;">a?</td><td style="vertical-align: top;"></td><td style="vertical-align: top;">a<br></td></tr><tr><td style="white-space: nowrap; vertical-align: top;">a*</td><td style="vertical-align: top;"></td><td style="vertical-align: top;">a<br></td></tr><tr><td style="white-space: nowrap; vertical-align: top;">a | b</td><td style="vertical-align: top;"></td><td style="vertical-align: top;">a または b<br></td></tr><tr><td style="white-space: nowrap; vertical-align: top;">'a'</td><td style="vertical-align: top;"></td><td style="vertical-align: top;">引用符 </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 usage.< で想定どおりに動作します。br>UnicodeSetIteratorは<b>for</b>ループでは使用できません。古いため、Java慣用的ではありません。 ただし、特定のユース ケースでは高速になる場合があります。 パフォーマンスに影響を受けやすいコードで測定することをお勧めします。<br>

要素の置換、カウント、スパンの削除については、 android.icu.text.UnicodeSetSpanner UnicodeSetSpannerを参照してください。

Javaドキュメント。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。