Matcher Classe

Définition

Espace de noms:

Java.Util.Regex

Assembly:

Mono.Android.dll

Moteur qui effectue des opérations de correspondance sur un 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

Héritage

Object

Object

Matcher

Attributs

RegisterAttribute

Implémente

IJavaObject IJavaPeerable IMatchResult IDisposable

Remarques

Moteur qui effectue des opérations de correspondance sur une séquence de caractères java.lang.CharSequence en interprétant un Pattern.

Un matcheur est créé à partir d’un modèle en appelant la méthode du Pattern#matcher matcher modèle. Une fois créé, un matcheur peut être utilisé pour effectuer trois types d’opérations de correspondance différents :

<ul>

<Li>

La #matches matches méthode tente de faire correspondre l’intégralité de la séquence d’entrée au modèle.

</Li>

<Li>

La #lookingAt lookingAt méthode tente de faire correspondre la séquence d’entrée, en commençant au début, par rapport au modèle.

</Li>

<Li>

La #find find méthode analyse la séquence d’entrée à la recherche de la sous-séquence suivante qui correspond au modèle.

</Li>

</ul>

Chacune de ces méthodes retourne une valeur booléenne indiquant la réussite ou l’échec. Vous pouvez obtenir plus d’informations sur une correspondance réussie en interrogeant l’état du matcheur.

Un matcheur recherche des correspondances dans un sous-ensemble de son entrée appelée région. Par défaut, la région contient toutes les entrées du matcheur. La région peut être modifiée par le biais de la #region(int, int) region méthode et interrogée par le biais des #regionStart() regionStart méthodes et #regionEnd() regionEnd des méthodes. La façon dont les limites de la région interagissent avec certaines constructions de modèle peut être modifiée. Pour plus d’informations, consultez #useAnchoringBounds(boolean) useAnchoringBounds et #useTransparentBounds(boolean) useTransparentBounds .

Cette classe définit également des méthodes pour remplacer les sous-séquences mises en correspondance par de nouvelles chaînes dont le contenu peut, si vous le souhaitez, être calculé à partir du résultat de la correspondance. Les #appendReplacement appendReplacement méthodes et #appendTail appendTail les méthodes peuvent être utilisées en tandem pour collecter le résultat dans une mémoire tampon de chaîne ou un générateur de chaînes existant. Vous pouvez également utiliser la méthode la plus pratique #replaceAll replaceAll pour créer une chaîne dans laquelle chaque sous-séquence correspondante dans la séquence d’entrée est remplacée.

L’état explicite d’un matcheur inclut les index de début et de fin de la correspondance réussie la plus récente. Il inclut également les index de début et de fin de la sous-séquence d’entrée capturée par chaque groupe de capture dans le modèle, ainsi qu’un nombre total de sous-séquences de ces sous-séquences. En guise de commodité, les méthodes sont également fournies pour retourner ces sous-séquences capturées sous forme de chaîne.

L’état explicite d’un matcheur est initialement non défini ; la tentative d’interrogation d’une partie de celle-ci avant qu’une correspondance réussie entraîne la levée d’une IllegalStateException requête. L’état explicite d’un matcheur est recomputé par chaque opération de correspondance.

L’état implicite d’un matcher inclut la séquence de caractères d’entrée ainsi que la position d’ajout, initialement zéro et mise à jour par la #appendReplacement appendReplacement méthode.

Un matcheur peut être réinitialisé explicitement en appelant sa #reset() méthode ou, si une nouvelle séquence d’entrée est souhaitée, sa #reset(java.lang.CharSequence) reset(CharSequence) méthode. La réinitialisation d’un matcher ignore ses informations d’état explicites et définit la position d’ajout sur zéro.

Les instances de cette classe ne sont pas sécurisées pour une utilisation par plusieurs threads simultanés.

Ajouté dans la version 1.4.

Documentation Java pour java.util.regex.Matcher.

Les parties de cette page sont des modifications basées sur le travail créé et partagé par le projet Android Open Source et utilisés en fonction des termes décrits dans la licence d’attribution Creative Commons 2.5.

Propriétés

Class	Retourne la classe runtime de ce Object. (Hérité de Object)
Handle	Handle de l’instance Android sous-jacente. (Hérité de Object)
HasAnchoringBounds	Interroge l’ancrage des limites de région pour ce matcheur.
HasTransparentBounds	Interroge la transparence des limites de région pour ce matcheur.
JniIdentityHashCode	Moteur qui effectue des opérations de correspondance sur un java. (Hérité de Object)
JniPeerMembers	Moteur qui effectue des opérations de correspondance sur un java.
PeerReference	Moteur qui effectue des opérations de correspondance sur un java. (Hérité de Object)
ThresholdClass	Cette API prend en charge l’infrastructure Mono pour Android et n’est pas destinée à être utilisée directement à partir de votre code. (Hérité de Object)
ThresholdType	Cette API prend en charge l’infrastructure Mono pour Android et n’est pas destinée à être utilisée directement à partir de votre code. (Hérité de Object)

Méthodes

AppendReplacement(StringBuffer, String)	Implémente une étape d’ajout et de remplacement non terminal.
AppendReplacement(StringBuilder, String)	Implémente une étape d’ajout et de remplacement non terminal.
AppendTail(StringBuffer)	Implémente une étape d’ajout et de remplacement de terminal.
AppendTail(StringBuilder)	Implémente une étape d’ajout et de remplacement de terminal.
Clone()	Crée et retourne une copie de cet objet. (Hérité de Object)
Dispose()	Moteur qui effectue des opérations de correspondance sur un java. (Hérité de Object)
Dispose(Boolean)	Moteur qui effectue des opérations de correspondance sur un java. (Hérité de Object)
End()	Retourne le décalage après le dernier caractère mis en correspondance.
End(Int32)	Retourne le décalage après le dernier caractère de la sous-séquence capturée par le groupe donné pendant l’opération de correspondance précédente.
End(String)	Retourne le décalage après le dernier caractère de la sous-séquence capturée par le groupe de capture nommé donné pendant l’opération de correspondance précédente.
Equals(Object)	Indique si un autre objet est « égal à » celui-ci. (Hérité de Object)
Find()	Tente de trouver la sous-séquence suivante de la séquence d’entrée qui correspond au modèle.
Find(Int32)	Réinitialise ce matcheur, puis tente de trouver la sous-séquence suivante de la séquence d’entrée qui correspond au modèle, en commençant à l’index spécifié.
GetHashCode()	Retourne une valeur de code de hachage pour l'objet. (Hérité de Object)
Group()	Retourne la sous-séquence d’entrée correspondant à la correspondance précédente.
Group(Int32)	Retourne la sous-séquence d’entrée capturée par le groupe donné pendant l’opération de correspondance précédente.
Group(String)	Retourne la sous-séquence d’entrée capturée par le groupe de capture nommé donné pendant l’opération de correspondance précédente.
GroupCount()	Retourne le nombre de groupes de capture dans le modèle de ce matcheur.
HitEnd()	Retourne true si la fin de l’entrée a été atteinte par le moteur de recherche dans la dernière opération de correspondance effectuée par ce matcheur.
JavaFinalize()	Appelé par le garbage collector sur un objet lorsque le garbage collection détermine qu’il n’y a plus de références à l’objet. (Hérité de Object)
LookingAt()	Tente de faire correspondre la séquence d’entrée, en commençant au début de la région, par rapport au modèle.
Matches()	Tente de faire correspondre l’ensemble de la région au modèle.
Notify()	Réveille un thread unique qui attend le moniteur de cet objet. (Hérité de Object)
NotifyAll()	Réveille tous les threads qui attendent le moniteur de cet objet. (Hérité de Object)
Pattern()	Retourne le modèle interprété par ce matcheur.
QuoteReplacement(String)	Retourne un remplacement String littéral pour le fichier spécifié String.
Region(Int32, Int32)	Définit les limites de la région de ce matcheur.
RegionEnd()	Signale l’index de fin (exclusif) de la région de ce matcheur.
RegionStart()	Signale l’index de début de la région de ce matcheur.
ReplaceAll(IFunction)	Remplace chaque sous-séquence de la séquence d’entrée qui correspond au modèle par le résultat de l’application de la fonction replacer donnée au résultat de correspondance de ce matcheur correspondant à cette sous-séquence.
ReplaceAll(String)	Remplace chaque sous-séquence de la séquence d’entrée qui correspond au modèle par la chaîne de remplacement donnée.
ReplaceFirst(IFunction)	Remplace la première sous-séquence de la séquence d’entrée qui correspond au modèle par le résultat de l’application de la fonction replacer donnée au résultat de correspondance de ce matcheur correspondant à cette sous-séquence.
ReplaceFirst(String)	Remplace la première sous-séquence de la séquence d’entrée qui correspond au modèle par la chaîne de remplacement donnée.
RequireEnd()	Retourne true si d’autres entrées peuvent modifier une correspondance positive en une correspondance négative.
Reset()	Réinitialise ce matcheur.
Reset(ICharSequence)	Réinitialise ce matcheur avec une nouvelle séquence d’entrée.
Reset(String)	Réinitialise ce matcheur avec une nouvelle séquence d’entrée.
SetHandle(IntPtr, JniHandleOwnership)	Définit la propriété Handle. (Hérité de Object)
Start()	Retourne l’index de début de la correspondance précédente.
Start(Int32)	Retourne l’index de début de la sous-file d’attente capturée par le groupe donné pendant l’opération de correspondance précédente.
Start(String)	Retourne l’index de début de la sous-séquence capturée par le groupe de capture nommé donné pendant l’opération de correspondance précédente.
ToArray<T>()	Moteur qui effectue des opérations de correspondance sur un java. (Hérité de Object)
ToMatchResult()	Retourne l’état de correspondance de ce matcheur en tant que MatchResult.
ToString()	Retourne une représentation de chaîne de l'objet. (Hérité de Object)
UnregisterFromRuntime()	Moteur qui effectue des opérations de correspondance sur un java. (Hérité de Object)
UseAnchoringBounds(Boolean)	Définit l’ancrage des limites de région pour ce matcheur.
UsePattern(Pattern)	Modifie l’utilisation Pattern utilisée Matcher pour rechercher les correspondances avec.
UseTransparentBounds(Boolean)	Définit la transparence des limites de région pour ce matcheur.
Wait()	Provoque l’attente du thread actuel jusqu’à ce qu’il soit réveillé, généralement en étant <averti par em ou><em>interrompu</em>.<> (Hérité de Object)
Wait(Int64)	Provoque l’attente du thread actuel jusqu’à ce qu’il soit réveillé, généralement en étant <averti< par> em>ou <em>interrompu/em>,< ou jusqu’à ce qu’une certaine quantité de temps réel s’est écoulée. (Hérité de Object)
Wait(Int64, Int32)	Provoque l’attente du thread actuel jusqu’à ce qu’il soit réveillé, généralement en étant <averti< par> em>ou <em>interrompu/em>,< ou jusqu’à ce qu’une certaine quantité de temps réel s’est écoulée. (Hérité de Object)

Implémentations d’interfaces explicites

IJavaPeerable.Disposed()	Moteur qui effectue des opérations de correspondance sur un java. (Hérité de Object)
IJavaPeerable.DisposeUnlessReferenced()	Moteur qui effectue des opérations de correspondance sur un java. (Hérité de Object)
IJavaPeerable.Finalized()	Moteur qui effectue des opérations de correspondance sur un java. (Hérité de Object)
IJavaPeerable.JniManagedPeerState	Moteur qui effectue des opérations de correspondance sur un java. (Hérité de Object)
IJavaPeerable.SetJniIdentityHashCode(Int32)	Moteur qui effectue des opérations de correspondance sur un java. (Hérité de Object)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	Moteur qui effectue des opérations de correspondance sur un java. (Hérité de Object)
IJavaPeerable.SetPeerReference(JniObjectReference)	Moteur qui effectue des opérations de correspondance sur un java. (Hérité de Object)

Méthodes d’extension

JavaCast<TResult>(IJavaObject)	Effectue une conversion de type vérifiée par le runtime Android.
JavaCast<TResult>(IJavaObject)	Moteur qui effectue des opérations de correspondance sur un java.
GetJniTypeName(IJavaPeerable)	Moteur qui effectue des opérations de correspondance sur un java.