Matcher Klasse

Definition

Namespace:

Java.Util.Regex

Assembly:

Mono.Android.dll

Eine Engine, die Übereinstimmungsvorgänge für eine 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

Eine Engine, die Übereinstimmungsvorgänge für eine java.lang.CharSequence-Zeichensequenz ausführt, indem ein Patterninterpretiert wird.

Ein Matcher wird aus einem Muster erstellt, indem die Methode des Musters Pattern#matcher matcher aufgerufen wird. Nach der Erstellung kann ein Abgleichsvorgang 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 Anfang mit dem Muster abzugleichen.

</Li>

<Li>

Die #find find -Methode scannt die Eingabesequenz auf der Suche nach der nächsten Teilsequenz, die dem Muster entspricht.

</Li>

</ul>

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

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

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

Der explizite Status eines Abgleichs umfasst die Start- und Endindizes der letzten erfolgreichen Übereinstimmung. Es enthält auch die Start- und Endindizes der Eingabeunterteilung, die von jeder Erfassungsgruppe im Muster erfasst wird, sowie eine Gesamtanzahl solcher Untersequencen. Zur Vereinfachung werden auch Methoden für die Rückgabe dieser erfassten Untersequizen in Zeichenfolgenform bereitgestellt.

Der explizite Zustand eines Abgleichs ist zunächst nicht definiert; Der Versuch, einen Beliebigen Teil davon abzufragen, bevor eine erfolgreiche Übereinstimmung durchgeführt wird, führt dazu, dass ein IllegalStateException ausgelöst wird. Der explizite Zustand eines Übereinstimmungsvorgangs wird durch jeden Abgleichsvorgang neu berechnet.

Der implizite Zustand eines Abgleichs umfasst die Eingabezeichensequenz sowie die Anfügeposition, die zunächst 0 ist und von der #appendReplacement appendReplacement -Methode aktualisiert wird.

Ein Abgleicher kann explizit zurückgesetzt werden, indem seine #reset() Methode oder, wenn eine neue Eingabesequenz gewünscht wird, seine #reset(java.lang.CharSequence) reset(CharSequence) Methode aufgerufen wird. Beim Zurücksetzen eines Abgleichs werden die expliziten Zustandsinformationen verworfen und die Anfügeposition auf 0 festgelegt.

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

In Version 1.4 hinzugefügt.

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

Teile dieser Seite sind Änderungen, die auf Arbeiten basieren, die vom Android Open Source Project erstellt und freigegeben wurden und gemäß den In der Attribution License beschriebenen Begriffen verwendet werden.

Eigenschaften

Class	Gibt die Laufzeitklasse dieses Objectzurück. (Geerbt von Object)
Handle	Das Handle zum zugrunde liegenden Android-instance. (Geerbt von Object)
HasAnchoringBounds	Fragt die Verankerung von Regionsgrenzen für diesen Abgleich ab.
HasTransparentBounds	Fragt die Transparenz der Regionsgrenzen für diesen Abgleich ab.
JniIdentityHashCode	Eine Engine, die Übereinstimmungsvorgänge für eine Java ausführt. (Geerbt von Object)
JniPeerMembers	Eine Engine, die Übereinstimmungsvorgänge für eine Java ausführt.
PeerReference	Eine Engine, die Übereinstimmungsvorgänge für eine 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-Schritt zum Anfüge-und-Ersetzen.
AppendReplacement(StringBuilder, String)	Implementiert einen Nicht-Terminal-Schritt zum Anfüge-und-Ersetzen.
AppendTail(StringBuffer)	Implementiert einen Terminalschritt zum Anfüge-und-Ersetzen.
AppendTail(StringBuilder)	Implementiert einen Terminalschritt zum Anfüge-und-Ersetzen.
Clone()	Erstellt und gibt eine Kopie dieses Objekts zurück. (Geerbt von Object)
Dispose()	Eine Engine, die Übereinstimmungsvorgänge für eine Java ausführt. (Geerbt von Object)
Dispose(Boolean)	Eine Engine, die Übereinstimmungsvorgänge für eine Java ausführt. (Geerbt von Object)
End()	Gibt den Offset nach dem letzten Übereinstimmungszeichen zurück.
End(Int32)	Gibt den Offset nach dem letzten Zeichen der Untersequence zurück, die von der angegebenen Gruppe während des vorherigen Abgleichsvorgangs erfasst wurde.
End(String)	Gibt den Offset nach dem letzten Zeichen der Untersequence zurück, die von der angegebenen Benannten Erfassungsgruppe während des vorherigen Abgleichsvorgangs erfasst wurde.
Equals(Object)	Gibt an, ob ein anderes Objekt diesem "gleich" ist. (Geerbt von Object)
Find()	Versucht, die nächste Teilsequenz der Eingabesequenz zu finden, die dem Muster entspricht.
Find(Int32)	Setzt diesen Abgleich zurück, und versucht dann, die nächste Teilsequenz 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 Eingabeteilmenge zurück, die mit der vorherigen Übereinstimmung übereinstimmt.
Group(Int32)	Gibt die Eingabeunterteilung zurück, die von der angegebenen Gruppe während des vorherigen Abgleichsvorgangs erfasst wurde.
Group(String)	Gibt die Eingabeteilmenge zurück, die während des vorherigen Abgleichsvorgangs von der angegebenen Benannten Erfassungsgruppe erfasst wurde.
GroupCount()	Gibt die Anzahl der Erfassungsgruppen im Muster dieses Abgleichs zurück.
HitEnd()	Gibt true zurück, wenn das Ende der Eingabe von der Suchmaschine beim letzten Abgleichsvorgang dieses Abgleichsvorgangs erreicht wurde.
JavaFinalize()	Wird vom Garbage Collector für ein Objekt aufgerufen, wenn die Garbage Collection feststellt, dass keine Verweise mehr auf das Objekt vorhanden sind. (Geerbt von Object)
LookingAt()	Versucht, die Eingabesequenz ab dem Anfang der Region mit dem Muster abzugleichen.
Matches()	Versucht, die gesamte Region 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 Abgleicher interpretiert wird.
QuoteReplacement(String)	Gibt eine Literalersetzung String für den angegebenen Stringzurück.
Region(Int32, Int32)	Legt die Grenzwerte für die Region dieses Abgleichs fest.
RegionEnd()	Meldet den Endindex (exklusiv) der Region dieses Abgleichs.
RegionStart()	Meldet den Startindex der Region dieses Abgleichs.
ReplaceAll(IFunction)	Ersetzt jede Teilsequenz der Eingabesequenz, die dem Muster entspricht, mit dem Ergebnis, dass die angegebene Ersetzungsfunktion auf das Übereinstimmungsergebnis dieses Übereinstimmungsergebnisses angewendet wird, das dieser Untersequence entspricht.
ReplaceAll(String)	Ersetzt jede Teilsequenz der Eingabesequenz, die dem Muster entspricht, durch die angegebene Ersatzzeichenfolge.
ReplaceFirst(IFunction)	Ersetzt die erste Teilsequenz der Eingabesequenz, die dem Muster entspricht, durch das Ergebnis, dass die angegebene Ersetzungsfunktion auf das Übereinstimmungsergebnis dieses Übereinstimmungsanbieters angewendet wird, das dieser Untersequence entspricht.
ReplaceFirst(String)	Ersetzt die erste Untersequenz der Eingabesequenz, die dem Muster entspricht, durch die angegebene Ersatzzeichenfolge.
RequireEnd()	Gibt true zurück, wenn mehr Eingaben eine positive Übereinstimmung in eine negative ändern könnten.
Reset()	Setzt diesen Matcher zurück.
Reset(ICharSequence)	Setzt diesen Abgleich mit einer neuen Eingabesequenz zurück.
Reset(String)	Setzt diesen Abgleich 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 von der angegebenen Gruppe während des vorherigen Abgleichsvorgangs erfasst wurde.
Start(String)	Gibt den Startindex der Teilsequence zurück, die von der angegebenen Gruppe mit benannter Erfassung während des vorherigen Abgleichsvorgangs erfasst wurde.
ToArray<T>()	Eine Engine, die Übereinstimmungsvorgänge für eine Java ausführt. (Geerbt von Object)
ToMatchResult()	Gibt den Übereinstimmungsstatus dieses Abgleichs als zurück MatchResult.
ToString()	Gibt eine Zeichenfolgendarstellung des Objekts zurück. (Geerbt von Object)
UnregisterFromRuntime()	Eine Engine, die Übereinstimmungsvorgänge für eine Java ausführt. (Geerbt von Object)
UseAnchoringBounds(Boolean)	Legt die Verankerung von Regionsgrenzen für diesen Abgleich fest.
UsePattern(Pattern)	Ändert den, der Pattern verwendet Matcher wird, um Übereinstimmungen mit zu finden.
UseTransparentBounds(Boolean)	Legt die Transparenz der Regionsgrenzen für diesen Abgleich fest.
Wait()	Bewirkt, dass der aktuelle Thread wartet, bis er aktiviert wird, in der Regel durch em benachrichtigen/em> oder <em>interrupted</em>.<>< (Geerbt von Object)
Wait(Int64)	Bewirkt, dass der aktuelle Thread wartet, bis er aktiviert wird, in der Regel, indem <er>benachrichtigt</em> oder <em>interrupted</em> oder bis eine bestimmte Menge an Echtzeit verstrichen ist. (Geerbt von Object)
Wait(Int64, Int32)	Bewirkt, dass der aktuelle Thread wartet, bis er aktiviert wird, in der Regel, indem <er>benachrichtigt</em> oder <em>interrupted</em> oder bis eine bestimmte Menge an Echtzeit verstrichen ist. (Geerbt von Object)

Explizite Schnittstellenimplementierungen

IJavaPeerable.Disposed()	Eine Engine, die Übereinstimmungsvorgänge für eine Java ausführt. (Geerbt von Object)
IJavaPeerable.DisposeUnlessReferenced()	Eine Engine, die Übereinstimmungsvorgänge für eine Java ausführt. (Geerbt von Object)
IJavaPeerable.Finalized()	Eine Engine, die Übereinstimmungsvorgänge für eine Java ausführt. (Geerbt von Object)
IJavaPeerable.JniManagedPeerState	Eine Engine, die Übereinstimmungsvorgänge für eine Java ausführt. (Geerbt von Object)
IJavaPeerable.SetJniIdentityHashCode(Int32)	Eine Engine, die Übereinstimmungsvorgänge für eine Java ausführt. (Geerbt von Object)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	Eine Engine, die Übereinstimmungsvorgänge für eine Java ausführt. (Geerbt von Object)
IJavaPeerable.SetPeerReference(JniObjectReference)	Eine Engine, die Übereinstimmungsvorgänge für eine Java ausführt. (Geerbt von Object)

Erweiterungsmethoden

JavaCast<TResult>(IJavaObject)	Führt eine Für Android-Runtime überprüfte Typkonvertierung aus.
JavaCast<TResult>(IJavaObject)	Eine Engine, die Übereinstimmungsvorgänge für eine Java ausführt.
GetJniTypeName(IJavaPeerable)	Eine Engine, die Übereinstimmungsvorgänge für eine Java ausführt.