Matcher クラス

定義

名前空間:: Java.Util.Regex

アセンブリ:: Mono.Android.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 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

継承: Object

Object
Matcher

属性: RegisterAttribute

実装: IJavaObject IJavaPeerable IMatchResult IDisposable

注釈

Patternを解釈して java.lang.CharSequence 文字シーケンスに対して一致操作を実行するエンジン。

マッチャーは、パターンの Pattern#matcher matcher メソッドを呼び出すことによってパターンから作成されます。作成したマッチャーを使用して、次の 3 種類の一致操作を実行できます。

<ul>

<li>

#matches matches メソッドは、入力シーケンス全体をパターンと照合しようとします。

</li>

<li>

#lookingAt lookingAt メソッドは、最初からパターンに対して入力シーケンスの照合を試みます。

</li>

<li>

#find find メソッドは、入力シーケンスをスキャンして、パターンに一致する次のサブシーケンスを探します。

</li>

</ul>

これらの各メソッドは、成功または失敗を示すブール値を返します。マッチ成功の詳細については、マッチャーの状態を照会することで取得できます。

マッチャーは、 リージョンと呼ばれる入力のサブセットで一致を検索します。既定では、リージョンにはマッチャーのすべての入力が含まれます。リージョンは、 #region(int, int) region メソッドを使用して変更し、 #regionStart() regionStart メソッドと #regionEnd() regionEnd メソッドを使用してクエリを実行できます。領域境界が一部のパターンコンストラクトと対話する方法を変更できます。詳細については、 #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ドキュメント。

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

プロパティ

名前	説明
Class	この `Object`のランタイムクラスを返します。 (継承元 Object)
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)	指定した`String`のリテラル置換`String`を返します。
Region(Int32, Int32)	このマッチャーの領域の制限を設定します。
RegionEnd()	このマッチャーのリージョンの終了インデックス (排他的) を報告します。
RegionStart()	このマッチャーのリージョンの開始インデックスを報告します。
ReplaceAll(IFunction)	パターンに一致する入力シーケンスのすべてのサブシーケンスを、そのサブシーケンスに対応するこのマッチャーの一致結果に指定された replacer 関数を適用した結果に置き換えます。
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()	このマッチャーの一致状態を `MatchResult`として返します。
ToString()	オブジェクトの文字列表現を返します。 (継承元 Object)
UnregisterFromRuntime()	Java に対して一致操作を実行するエンジン。 (継承元 Object)
UseAnchoringBounds(Boolean)	このマッチャーの領域境界のアンカーを設定します。
UsePattern(Pattern)	この`Matcher`が一致を検索するために使用する`Pattern`を変更します。
UseTransparentBounds(Boolean)	このマッチャーの領域境界の透明度を設定します。
Wait()	現在のスレッドが起動するまで待機します。通常は、 <em>notified</em> または <em>interrupted</em>。 (継承元 Object)
Wait(Int64, Int32)	現在のスレッドは、通常、 <em>notified</em> または <em>interrupted</em>、または一定のリアルタイムが経過するまで、起動されるまで待機します。 (継承元 Object)
Wait(Int64)	現在のスレッドは、通常、 <em>notified</em> または <em>interrupted</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)

拡張メソッド

名前	説明
GetJniTypeName(IJavaPeerable)	インスタンス `self`の型の JNI 名を取得します。
JavaAs<TResult>(IJavaPeerable)	`self`を強制的に`TResult`入力し、強制型がJava側で有効であることを確認します。
JavaCast<TResult>(IJavaObject)	Android ランタイムチェック型変換を実行します。
JavaCast<TResult>(IJavaObject)	Java に対して一致操作を実行するエンジン。
TryJavaCast<TResult>(IJavaPeerable, TResult)	`self`を強制的に`TResult`入力し、強制型がJava側で有効であることを確認します。

適用対象