Matcher クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
Java に対して一致操作を実行するエンジン。
[Android.Runtime.Register("java/util/regex/Matcher", DoNotGenerateAcw=true)]
public sealed class Matcher : Java.Lang.Object, IDisposable, Java.Interop.IJavaPeerable, Java.Util.Regex.IMatchResult[<Android.Runtime.Register("java/util/regex/Matcher", DoNotGenerateAcw=true)>]
type Matcher = class
inherit Object
interface IMatchResult
interface IJavaObject
interface IDisposable
interface IJavaPeerable- 継承
- 属性
- 実装
注釈
java.lang.CharSequence 文字シーケンスに対して一致操作を実行する Patternエンジン。
マッチャーは、パターンのメソッドを呼び出すことによってパターン Pattern#matcher matcher から作成されます。 作成したマッチャーを使用して、次の 3 種類の一致操作を実行できます。
<ul>
<李>
このメソッドは #matches matches 、入力シーケンス全体をパターンと照合しようとします。
</李>
<李>
このメソッドは #lookingAt lookingAt 、最初からパターンに対して入力シーケンスの照合を試みます。
</李>
<李>
このメソッドは #find find 、入力シーケンスをスキャンして、パターンに一致する次のサブシーケンスを探します。
</李>
</ul>
これらの各メソッドは、成功または失敗を示すブール値を返します。 マッチ成功の詳細については、マッチャーの状態を照会することで取得できます。
マッチャーは、リージョンと呼ばれる入力のサブセットで一致を検索します。 既定では、リージョンにはマッチャーのすべての入力が含まれます。 リージョンは、メソッドを#region(int, int) region使用して変更し、メソッド#regionEnd() regionEndを使用してクエリを#regionStart() regionStart実行できます。 領域境界が一部のパターン コンストラクトと対話する方法を変更できます。 詳細については、「 #useAnchoringBounds(boolean) useAnchoringBounds 」と「 #useTransparentBounds(boolean) useTransparentBounds 」を参照してください。
このクラスでは、一致したサブシーケンスを、必要に応じて一致結果から計算できる内容を持つ新しい文字列に置き換えるメソッドも定義します。 #appendReplacement appendReplacementメソッドは#appendTail appendTail、既存の文字列バッファーまたは文字列ビルダーに結果を収集するために、並行して使用できます。 または、より便利な #replaceAll replaceAll メソッドを使用して、入力シーケンス内の一致するすべてのサブシーケンスが置き換えられる文字列を作成することもできます。
マッチャーの明示的な状態には、最新の成功した一致の開始インデックスと終了インデックスが含まれます。 また、パターン内の各キャプチャ グループによってキャプチャされた入力サブシーケンスの開始インデックスと終了インデックスと、そのようなサブシーケンスの合計数も含まれます。 便宜上、これらのキャプチャされたサブシーケンスを文字列形式で返すメソッドも用意されています。
マッチャーの明示的な状態は、最初は未定義です。一致が成功する前に、その一部に対してクエリを実行しようとすると、スロー IllegalStateException されます。 マッチャーの明示的な状態は、すべての一致操作によって再計算されます。
マッチャーの暗黙的な状態には、入力文字シーケンスと 追加位置が含まれます。これは最初は 0 で、メソッドによって #appendReplacement appendReplacement 更新されます。
マッチャーは、メソッド #reset() を呼び出すことによって明示的にリセットすることも、新しい入力シーケンスが必要な場合は、そのメソッドを #reset(java.lang.CharSequence) reset(CharSequence) リセットすることもできます。 マッチャーをリセットすると、明示的な状態情報が破棄され、追加位置が 0 に設定されます。
このクラスのインスタンスは、複数の同時実行スレッドで使用しても安全ではありません。
1.4 で追加されました。
の Java ドキュメントjava.util.regex.Matcher
このページの一部は、Android オープンソース プロジェクトによって作成および共有され、クリエイティブ コモンズ 2.5 属性ライセンスに記載されている条件に従って使用される作業に基づく変更です。
プロパティ
| Class |
この |
| Handle |
基になる Android インスタンスへのハンドル。 (継承元 Object) |
| HasAnchoringBounds |
このマッチャーの領域境界のアンカーを照会します。 |
| HasTransparentBounds |
このマッチャーの領域境界の透明度を照会します。 |
| JniIdentityHashCode |
Java に対して一致操作を実行するエンジン。 (継承元 Object) |
| JniPeerMembers |
Java に対して一致操作を実行するエンジン。 |
| PeerReference |
Java に対して一致操作を実行するエンジン。 (継承元 Object) |
| ThresholdClass |
この API は Android 用 Mono インフラストラクチャをサポートしており、コードから直接使用するためのものではありません。 (継承元 Object) |
| ThresholdType |
この API は Android 用 Mono インフラストラクチャをサポートしており、コードから直接使用するためのものではありません。 (継承元 Object) |
メソッド
| AppendReplacement(StringBuffer, String) |
非ターミナルの追加と置換のステップを実装します。 |
| AppendReplacement(StringBuilder, String) |
非ターミナルの追加と置換のステップを実装します。 |
| AppendTail(StringBuffer) |
ターミナルの追加と置換の手順を実装します。 |
| AppendTail(StringBuilder) |
ターミナルの追加と置換の手順を実装します。 |
| Clone() |
このオブジェクトのコピーを作成して返します。 (継承元 Object) |
| Dispose() |
Java に対して一致操作を実行するエンジン。 (継承元 Object) |
| Dispose(Boolean) |
Java に対して一致操作を実行するエンジン。 (継承元 Object) |
| End() |
最後に一致した文字の後のオフセットを返します。 |
| End(Int32) |
前の一致操作中に特定のグループによってキャプチャされたサブシーケンスの最後の文字の後のオフセットを返します。 |
| End(String) |
前の一致操作中に指定された名前付きキャプチャ グループによってキャプチャされたサブシーケンスの最後の文字の後のオフセットを返します。 |
| Equals(Object) |
他のオブジェクトがこのオブジェクトと "等しい" かどうかを示します。 (継承元 Object) |
| Find() |
パターンに一致する入力シーケンスの次のサブシーケンスの検索を試みます。 |
| Find(Int32) |
このマッチャーをリセットし、パターンに一致する入力シーケンスの次のサブシーケンスを、指定したインデックスから検索しようとします。 |
| GetHashCode() |
オブジェクトのハッシュ コード値を返します。 (継承元 Object) |
| Group() |
前の一致で一致した入力サブシーケンスを返します。 |
| Group(Int32) |
前の一致操作中に指定されたグループによってキャプチャされた入力サブシーケンスを返します。 |
| Group(String) |
前の一致操作中に指定された名前付きキャプチャ グループによってキャプチャされた入力サブシーケンスを返します。 |
| GroupCount() |
このマッチャーのパターン内のキャプチャ グループの数を返します。 |
| HitEnd() |
このマッチャーによって実行された最後の一致操作で、入力の末尾が検索エンジンによってヒットした場合は true を返します。 |
| JavaFinalize() |
オブジェクトへの参照がなくなったとガベージ コレクションによって判断されたときに、オブジェクトのガベージ コレクターによって呼び出されます。 (継承元 Object) |
| LookingAt() |
領域の先頭からパターンに対して入力シーケンスの照合を試みます。 |
| Matches() |
パターンに対してリージョン全体の照合を試みます。 |
| Notify() |
このオブジェクトのモニターで待機している 1 つのスレッドを起動します。 (継承元 Object) |
| NotifyAll() |
このオブジェクトのモニターで待機しているすべてのスレッドを起動します。 (継承元 Object) |
| Pattern() |
このマッチャーによって解釈されるパターンを返します。 |
| QuoteReplacement(String) |
指定した値のリテラル置換 |
| Region(Int32, Int32) |
このマッチャーの領域の制限を設定します。 |
| RegionEnd() |
このマッチャーのリージョンの終了インデックス (排他的) を報告します。 |
| RegionStart() |
このマッチャーのリージョンの開始インデックスを報告します。 |
| ReplaceAll(IFunction) |
パターンに一致する入力シーケンスのすべてのサブシーケンスを、そのサブシーケンスに対応するこのマッチャーの一致結果に指定された置換関数を適用した結果に置き換えます。 |
| ReplaceAll(String) |
パターンに一致する入力シーケンスのすべてのサブシーケンスを、指定された置換文字列に置き換えます。 |
| ReplaceFirst(IFunction) |
パターンに一致する入力シーケンスの最初のサブシーケンスを、そのサブシーケンスに対応するこのマッチャーの一致結果に指定された置換関数を適用した結果に置き換えます。 |
| ReplaceFirst(String) |
パターンと一致する入力シーケンスの最初のサブシーケンスを、指定された置換文字列に置き換えます。 |
| RequireEnd() |
より多くの入力が正の一致を負の一致に変更する可能性がある場合は true を返します。 |
| Reset() |
このマッチャーをリセットします。 |
| Reset(ICharSequence) |
このマッチャーを新しい入力シーケンスでリセットします。 |
| Reset(String) |
このマッチャーを新しい入力シーケンスでリセットします。 |
| SetHandle(IntPtr, JniHandleOwnership) |
Handle プロパティを設定します。 (継承元 Object) |
| Start() |
前の一致の開始インデックスを返します。 |
| Start(Int32) |
前の一致操作中に特定のグループによってキャプチャされたサブシーケンスの開始インデックスを返します。 |
| Start(String) |
前の一致操作中に指定された名前付きキャプチャ グループによってキャプチャされたサブシーケンスの開始インデックスを返します。 |
| ToArray<T>() |
Java に対して一致操作を実行するエンジン。 (継承元 Object) |
| ToMatchResult() |
このマッチャーの一致状態を返します |
| ToString() |
オブジェクトの文字列表現を返します。 (継承元 Object) |
| UnregisterFromRuntime() |
Java に対して一致操作を実行するエンジン。 (継承元 Object) |
| UseAnchoringBounds(Boolean) |
このマッチャーの領域境界のアンカーを設定します。 |
| UsePattern(Pattern) |
|
| UseTransparentBounds(Boolean) |
このマッチャーの領域境界の透明度を設定します。 |
| Wait() |
現在のスレッドが目覚めるまで待機させます。通常<は、通知<>/em> または <em>割り込み/em> を受け<取ります。 (継承元 Object) |
| Wait(Int64) |
現在のスレッドが目覚めるまで待機します。通常<><は、通知/em> または <em>中断</em> によって、または一定のリアルタイムが経過するまで待機します。 (継承元 Object) |
| Wait(Int64, Int32) |
現在のスレッドが目覚めるまで待機します。通常<><は、通知/em> または <em>中断</em> によって、または一定のリアルタイムが経過するまで待機します。 (継承元 Object) |
明示的なインターフェイスの実装
| IJavaPeerable.Disposed() |
Java に対して一致操作を実行するエンジン。 (継承元 Object) |
| IJavaPeerable.DisposeUnlessReferenced() |
Java に対して一致操作を実行するエンジン。 (継承元 Object) |
| IJavaPeerable.Finalized() |
Java に対して一致操作を実行するエンジン。 (継承元 Object) |
| IJavaPeerable.JniManagedPeerState |
Java に対して一致操作を実行するエンジン。 (継承元 Object) |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
Java に対して一致操作を実行するエンジン。 (継承元 Object) |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
Java に対して一致操作を実行するエンジン。 (継承元 Object) |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
Java に対して一致操作を実行するエンジン。 (継承元 Object) |
拡張メソッド
| JavaCast<TResult>(IJavaObject) |
Android ランタイムチェック型変換を実行します。 |
| JavaCast<TResult>(IJavaObject) |
Java に対して一致操作を実行するエンジン。 |
| GetJniTypeName(IJavaPeerable) |
Java に対して一致操作を実行するエンジン。 |