Matcher Klasse

Definition

Namespace:

Java.Util.Regex

Assembly:

Mono.Android.dll

Ein Modul, das Übereinstimmungsvorgänge in einem Java ausführt.

[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

Vererbung

Object

Object

Matcher

Attribute

RegisterAttribute

Implementiert

IJavaObject IJavaPeerable IMatchResult IDisposable

Hinweise

Ein Modul, das Übereinstimmungsvorgänge für eine Java.lang.CharSequence-Zeichensequenz ausführt, indem eine Patterninterpretiert wird.

Ein Matcher wird aus einem Muster erstellt, indem die Methode des Musters Pattern#matcher matcher abgerufen wird. Nach der Erstellung kann ein Matcher verwendet werden, um drei verschiedene Arten von Übereinstimmungsvorgängen auszuführen:

<ul>

<Li>

Die #matches matches Methode versucht, die gesamte Eingabesequenz mit dem Muster abzugleichen.

</Li>

<Li>

Die #lookingAt lookingAt Methode versucht, die Eingabesequenz ab dem Anfang mit dem Muster abzugleichen.

</Li>

<Li>

Die #find find Methode überprüft die Eingabesequenz, die nach der nächsten Untersequence sucht, die dem Muster entspricht.

</Li>

</ul>

Jede dieser Methoden gibt einen booleschen Wert zurück, der den Erfolg oder Fehler angibt. Weitere Informationen zu einer erfolgreichen Übereinstimmung können durch Abfragen des Status des Übereinstimmungers abgerufen werden.

Ein Abgleich findet Übereinstimmungen in einer Teilmenge seiner Eingabe, die als Region bezeichnet wird. Standardmäßig enthält der Bereich alle Eingaben des Abgleichs. Die Region kann über die #region(int, int) region Methode geändert und über die #regionStart() regionStart Methoden #regionEnd() regionEnd abgefragt werden. Die Art und Weise, wie die Regionsgrenzen mit einigen Musterkonstrukten interagieren, können geändert werden. Ausführliche Informationen finden Sie unter #useAnchoringBounds(boolean) useAnchoringBounds und #useTransparentBounds(boolean) useTransparentBounds .

Diese Klasse definiert auch Methoden zum Ersetzen übereinstimmender Untersequences durch neue Zeichenfolgen, deren Inhalt bei Bedarf aus dem Übereinstimmungsergebnis berechnet werden kann. Die #appendReplacement appendReplacement Methoden #appendTail appendTail können zusammen verwendet werden, um das Ergebnis in einem vorhandenen Zeichenfolgenpuffer oder Zeichenfolgen-Generator zu sammeln. Alternativ kann die komfortablere #replaceAll replaceAll Methode verwendet werden, um eine Zeichenfolge zu erstellen, in der jede übereinstimmende Untermenge in der Eingabesequenz ersetzt wird.

Der explizite Zustand eines Matchers enthält die Anfangs- und Endindizes der letzten erfolgreichen Übereinstimmung. Sie enthält auch die Anfangs- und Endindizes der Eingabeuntermenge, die von jeder Erfassungsgruppe im Muster erfasst wird, sowie eine Gesamtanzahl solcher Unterquencen. Zur Vereinfachung werden auch Methoden zum Zurückgeben dieser erfassten Untersequences in Zeichenfolgenform bereitgestellt.

Der explizite Zustand eines Matchers ist zunächst nicht definiert; Der Versuch, einen teil davon abzufragen, bevor eine erfolgreiche Übereinstimmung durchgeführt wird, führt dazu, dass ein IllegalStateException Fehler ausgelöst wird. Der explizite Zustand eines Abgleichs wird von jedem Übereinstimmungsvorgang neu komputiert.

Der implizite Zustand eines Abgleichs enthält die Eingabezeichensequenz sowie die Anfügeposition, die anfangs null ist und von der #appendReplacement appendReplacement Methode aktualisiert wird.

Ein Matcher kann explizit zurückgesetzt werden, indem er seine #reset() Methode aufruft oder, wenn eine neue Eingabesequenz gewünscht wird, seine #reset(java.lang.CharSequence) reset(CharSequence) Methode. Durch das Zurücksetzen eines Vergleichers werden die expliziten Zustandsinformationen verworfen und die Anfügeposition auf Null festgelegt.

Instanzen dieser Klasse sind nicht sicher für die Verwendung durch mehrere gleichzeitige Threads.

In 1.4 hinzugefügt.

Java-Dokumentation für java.util.regex.Matcher.

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die vom Android Open Source-Projekt erstellt und freigegeben werden und gemäß den in der Creative Commons 2.5 Attribution License beschriebenen Begriffen verwendet werden.

Eigenschaften

Class	Gibt die Laufzeitklasse dieses Werts Objectzurück. (Geerbt von Object)
Handle	Das Handle für die zugrunde liegende Android-Instanz. (Geerbt von Object)
HasAnchoringBounds	Fragt die Verankerung der Regionsgrenzen für diesen Abgleich ab.
HasTransparentBounds	Fragt die Transparenz der Regionsgrenzen für diesen Abgleich ab.
JniIdentityHashCode	Ein Modul, das Übereinstimmungsvorgänge in einem Java ausführt. (Geerbt von Object)
JniPeerMembers	Ein Modul, das Übereinstimmungsvorgänge in einem Java ausführt.
PeerReference	Ein Modul, das Übereinstimmungsvorgänge in einem Java ausführt. (Geerbt von Object)
ThresholdClass	Diese API unterstützt die Mono für Android-Infrastruktur und ist nicht für die direkte Verwendung aus Ihrem Code vorgesehen. (Geerbt von Object)
ThresholdType	Diese API unterstützt die Mono für Android-Infrastruktur und ist nicht für die direkte Verwendung aus Ihrem Code vorgesehen. (Geerbt von Object)

Methoden

AppendReplacement(StringBuffer, String)	Implementiert einen Nicht-Terminal-Anfüge- und -ersetzungsschritt.
AppendReplacement(StringBuilder, String)	Implementiert einen Nicht-Terminal-Anfüge- und -ersetzungsschritt.
AppendTail(StringBuffer)	Implementiert einen Anfüge- und -ersetzungsschritt für Terminal.
AppendTail(StringBuilder)	Implementiert einen Anfüge- und -ersetzungsschritt für Terminal.
Clone()	Erstellt und gibt eine Kopie dieses Objekts zurück. (Geerbt von Object)
Dispose()	Ein Modul, das Übereinstimmungsvorgänge in einem Java ausführt. (Geerbt von Object)
Dispose(Boolean)	Ein Modul, das Übereinstimmungsvorgänge in einem Java ausführt. (Geerbt von Object)
End()	Gibt den Offset zurück, nachdem das letzte Zeichen abgeglichen wurde.
End(Int32)	Gibt den Offset nach dem letzten Zeichen der Teilmenge zurück, die während des vorherigen Übereinstimmungsvorgangs von der angegebenen Gruppe erfasst wurde.
End(String)	Gibt den Offset nach dem letzten Zeichen der Teilmenge zurück, die während des vorherigen Abgleichsvorgangs von der angegebenen benannten Erfassungsgruppe erfasst wurde.
Equals(Object)	Gibt an, ob ein anderes Objekt "gleich" diesem Objekt ist. (Geerbt von Object)
Find()	Versucht, die nächste Untermenge der Eingabesequenz zu finden, die dem Muster entspricht.
Find(Int32)	Setzt diesen Abgleich zurück und versucht dann, die nächste Untermenge der Eingabesequenz zu finden, die dem Muster entspricht, beginnend mit dem angegebenen Index.
GetHashCode()	Gibt einen Hashcodewert für das Objekt zurück. (Geerbt von Object)
Group()	Gibt die Eingabeuntermenge zurück, die mit der vorherigen Übereinstimmung übereinstimmt.
Group(Int32)	Gibt die von der angegebenen Gruppe erfasste Eingabeuntermenge während des vorherigen Abgleichsvorgangs zurück.
Group(String)	Gibt die Eingabeuntermenge zurück, die während des vorherigen Abgleichsvorgangs von der angegebenen benannten Erfassungsgruppe erfasst wird.
GroupCount()	Gibt die Anzahl der Erfassungsgruppen im Muster dieses Übereinstimmungsmusters zurück.
HitEnd()	Gibt true zurück, wenn das Ende der Eingabe von der Suchmaschine im letzten Übereinstimmungsvorgang, der von diesem Matcher ausgeführt wurde, erreicht wurde.
JavaFinalize()	Wird vom Garbage Collector für ein Objekt aufgerufen, wenn die Garbage Collection bestimmt, dass keine weiteren Verweise auf das Objekt vorhanden sind. (Geerbt von Object)
LookingAt()	Versucht, die Eingabesequenz ab dem Anfang des Bereichs mit dem Muster abzugleichen.
Matches()	Versucht, den gesamten Bereich mit dem Muster abzugleichen.
Notify()	Aktiviert einen einzelnen Thread, der auf dem Monitor dieses Objekts wartet. (Geerbt von Object)
NotifyAll()	Aktiviert alle Threads, die auf dem Monitor dieses Objekts warten. (Geerbt von Object)
Pattern()	Gibt das Muster zurück, das von diesem Matcher interpretiert wird.
QuoteReplacement(String)	Gibt einen Literalersatz für die angegebene StringZurücksetzung String zurück.
Region(Int32, Int32)	Legt die Grenzwerte für die Region dieses Übereinstimmungsgebers fest.
RegionEnd()	Meldet den Endindex (exklusiv) der Region dieses Matchers.
RegionStart()	Meldet den Startindex der Region dieses Abgleichs.
ReplaceAll(IFunction)	Ersetzt jede Untermenge der Eingabesequenz, die dem Muster entspricht, mit dem Ergebnis, dass die angegebene Ersetzungsfunktion auf das Übereinstimmungsergebnis dieses Matchers angewendet wird, das dieser Untermenge entspricht.
ReplaceAll(String)	Ersetzt jede Untermenge der Eingabesequenz, die mit dem Muster mit der angegebenen Ersetzungszeichenfolge übereinstimmt.
ReplaceFirst(IFunction)	Ersetzt die erste Untermenge der Eingabesequenz, die dem Muster entspricht, mit dem Ergebnis, dass die angegebene Ersetzungsfunktion auf das Übereinstimmungsergebnis dieses Matchers angewendet wird, das dieser Untermenge entspricht.
ReplaceFirst(String)	Ersetzt die erste Untermenge der Eingabesequenz, die dem Muster mit der angegebenen Ersetzungszeichenfolge entspricht.
RequireEnd()	Gibt true zurück, wenn mehr Eingaben eine positive Übereinstimmung in ein negatives ändern könnten.
Reset()	Setzt diesen Matcher zurück.
Reset(ICharSequence)	Setzt diesen Matcher mit einer neuen Eingabesequenz zurück.
Reset(String)	Setzt diesen Matcher mit einer neuen Eingabesequenz zurück.
SetHandle(IntPtr, JniHandleOwnership)	Legt die Handle-Eigenschaft fest. (Geerbt von Object)
Start()	Gibt den Startindex der vorherigen Übereinstimmung zurück.
Start(Int32)	Gibt den Startindex der Teilmenge zurück, die während des vorherigen Abgleichsvorgangs von der angegebenen Gruppe erfasst wird.
Start(String)	Gibt den Startindex der Teilmenge zurück, die während des vorherigen Abgleichsvorgangs von der angegebenen benannten Erfassungsgruppe erfasst wird.
ToArray<T>()	Ein Modul, das Übereinstimmungsvorgänge in einem Java ausführt. (Geerbt von Object)
ToMatchResult()	Gibt den Übereinstimmungszustand dieses Matchers als ein MatchResult.
ToString()	Gibt eine Zeichenfolgendarstellung des Objekts zurück. (Geerbt von Object)
UnregisterFromRuntime()	Ein Modul, das Übereinstimmungsvorgänge in einem Java ausführt. (Geerbt von Object)
UseAnchoringBounds(Boolean)	Legt die Verankerung der Bereichsgrenzen für diesen Matcher fest.
UsePattern(Pattern)	Ändert die Übereinstimmungen, Matcher mit denen Pattern gesucht wird.
UseTransparentBounds(Boolean)	Legt die Transparenz der Regionsgrenzen für diesen Abgleich fest.
Wait()	Bewirkt, dass der aktuelle Thread wartet, bis er wach ist, in der Regel durch em benachrichtigt/em> oder <em>unterbrochen</em>.<>< (Geerbt von Object)
Wait(Int64, Int32)	Bewirkt, dass der aktuelle Thread wartet, bis er wach ist, in der Regel durch <em>benachrichtigt</em> oder <em>unterbrochen</em> oder bis eine bestimmte Menge an Echtzeit verstrichen ist. (Geerbt von Object)
Wait(Int64)	Bewirkt, dass der aktuelle Thread wartet, bis er wach ist, in der Regel durch <em>benachrichtigt</em> oder <em>unterbrochen</em> oder bis eine bestimmte Menge an Echtzeit verstrichen ist. (Geerbt von Object)

Explizite Schnittstellenimplementierungen

IJavaPeerable.Disposed()	Ein Modul, das Übereinstimmungsvorgänge in einem Java ausführt. (Geerbt von Object)
IJavaPeerable.DisposeUnlessReferenced()	Ein Modul, das Übereinstimmungsvorgänge in einem Java ausführt. (Geerbt von Object)
IJavaPeerable.Finalized()	Ein Modul, das Übereinstimmungsvorgänge in einem Java ausführt. (Geerbt von Object)
IJavaPeerable.JniManagedPeerState	Ein Modul, das Übereinstimmungsvorgänge in einem Java ausführt. (Geerbt von Object)
IJavaPeerable.SetJniIdentityHashCode(Int32)	Ein Modul, das Übereinstimmungsvorgänge in einem Java ausführt. (Geerbt von Object)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	Ein Modul, das Übereinstimmungsvorgänge in einem Java ausführt. (Geerbt von Object)
IJavaPeerable.SetPeerReference(JniObjectReference)	Ein Modul, das Übereinstimmungsvorgänge in einem Java ausführt. (Geerbt von Object)

Erweiterungsmethoden

JavaCast<TResult>(IJavaObject)	Führt eine android-laufzeitgecheckte Typkonvertierung aus.
JavaCast<TResult>(IJavaObject)	Ein Modul, das Übereinstimmungsvorgänge in einem Java ausführt.
GetJniTypeName(IJavaPeerable)	Ein Modul, das Übereinstimmungsvorgänge in einem Java ausführt.