Matcher Classe

Definizione

Spazio dei nomi:

Java.Util.Regex

Assembly:

Mono.Android.dll

Motore che esegue operazioni di corrispondenza su 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

Ereditarietà

Object

Object

Matcher

Attributi

RegisterAttribute

Implementazioni

IJavaObject IJavaPeerable IMatchResult IDisposable

Commenti

Motore che esegue operazioni di corrispondenza su una sequenza di caratteri java.lang.CharSequence interpretando un oggetto Pattern.

Un matcher viene creato da un criterio richiamando il metodo del Pattern#matcher matcher modello. Una volta creato, è possibile usare un matcher per eseguire tre diversi tipi di operazioni di corrispondenza:

<ul>

<li>

Il #matches matches metodo tenta di trovare la corrispondenza con l'intera sequenza di input rispetto al modello.

</li>

<li>

Il #lookingAt lookingAt metodo tenta di trovare la corrispondenza con la sequenza di input, a partire dall'inizio, rispetto al modello.

</li>

<li>

Il #find find metodo analizza la sequenza di input cercando la sottosequenza successiva che corrisponde al modello.

</li>

</ul>

Ognuno di questi metodi restituisce un valore booleano che indica l'esito positivo o negativo. Per ottenere altre informazioni su una corrispondenza riuscita, è possibile eseguire una query sullo stato del matcher.

Un matcher trova corrispondenze in un subset del relativo input denominato area. Per impostazione predefinita, l'area contiene tutti gli input del matcher. L'area può essere modificata tramite il #region(int, int) region metodo ed eseguita una query tramite i #regionStart() regionStart metodi e #regionEnd() regionEnd . È possibile modificare il modo in cui i limiti dell'area interagiscono con alcuni costrutti di criteri. Per altre informazioni, vedere #useAnchoringBounds(boolean) useAnchoringBounds e #useTransparentBounds(boolean) useTransparentBounds .

Questa classe definisce anche i metodi per sostituire sottosequenze corrispondenti con nuove stringhe il cui contenuto, se lo si desidera, può essere calcolato dal risultato della corrispondenza. I #appendReplacement appendReplacement metodi e #appendTail appendTail possono essere usati in parallelo per raccogliere il risultato in un buffer di stringhe o in un generatore di stringhe esistente. In alternativa, è possibile usare il metodo più pratico #replaceAll replaceAll per creare una stringa in cui ogni sottosequenza corrispondente nella sequenza di input viene sostituita.

Lo stato esplicito di un matcher include gli indici iniziale e finale della corrispondenza con esito positivo più recente. Include anche gli indici iniziale e finale della sottosequenza di input acquisita da ogni gruppo di acquisizione nel modello, nonché un conteggio totale di tali sottosequenze. Per praticità, vengono forniti anche metodi per restituire queste sottosequenze acquisite in formato stringa.

Lo stato esplicito di un matcher è inizialmente non definito; il tentativo di eseguire una query su qualsiasi parte di esso prima che una corrispondenza con esito positivo generi un'eccezione IllegalStateException . Lo stato esplicito di un matcher viene ricalcolate da ogni operazione di corrispondenza.

Lo stato implicito di un matcher include la sequenza di caratteri di input e la posizione di accodamento, che inizialmente è zero e viene aggiornata dal #appendReplacement appendReplacement metodo .

Un matcher può essere reimpostato in modo esplicito richiamando il #reset() relativo metodo o, se si desidera una nuova sequenza di input, il relativo #reset(java.lang.CharSequence) reset(CharSequence) metodo. La reimpostazione di un matcher elimina le informazioni sullo stato esplicite e imposta la posizione di accodamento su zero.

Le istanze di questa classe non sono sicure per l'uso da parte di più thread simultanei.

Aggiunta nella versione 1.4.

Documentazione java per java.util.regex.Matcher.

Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dal progetto Open Source Android e usato in base ai termini descritti nella licenza Creative Commons 2.5 Attribuzione.

Proprietà

Class	Restituisce la classe di runtime di questo Objectoggetto . (Ereditato da Object)
Handle	Handle per l'istanza di Android sottostante. (Ereditato da Object)
HasAnchoringBounds	Esegue una query sull'ancoraggio dei limiti di area per questo matcher.
HasTransparentBounds	Esegue una query sulla trasparenza dei limiti dell'area per questo matcher.
JniIdentityHashCode	Motore che esegue operazioni di corrispondenza su un java. (Ereditato da Object)
JniPeerMembers	Motore che esegue operazioni di corrispondenza su un java.
PeerReference	Motore che esegue operazioni di corrispondenza su un java. (Ereditato da Object)
ThresholdClass	Questa API supporta l'infrastruttura Mono per Android e non deve essere usata direttamente dal codice. (Ereditato da Object)
ThresholdType	Questa API supporta l'infrastruttura Mono per Android e non deve essere usata direttamente dal codice. (Ereditato da Object)

Metodi

AppendReplacement(StringBuffer, String)	Implementa un passaggio di accodamento e sostituzione non terminale.
AppendReplacement(StringBuilder, String)	Implementa un passaggio di accodamento e sostituzione non terminale.
AppendTail(StringBuffer)	Implementa un passaggio di aggiunta e sostituzione del terminale.
AppendTail(StringBuilder)	Implementa un passaggio di aggiunta e sostituzione del terminale.
Clone()	Crea e restituisce una copia di questo oggetto. (Ereditato da Object)
Dispose()	Motore che esegue operazioni di corrispondenza su un java. (Ereditato da Object)
Dispose(Boolean)	Motore che esegue operazioni di corrispondenza su un java. (Ereditato da Object)
End()	Restituisce l'offset dopo l'ultimo carattere corrispondente.
End(Int32)	Restituisce l'offset dopo l'ultimo carattere della sottosequenza acquisita dal gruppo specificato durante l'operazione di corrispondenza precedente.
End(String)	Restituisce l'offset dopo l'ultimo carattere della sottosequenza acquisita dal gruppo di acquisizione denominato specificato durante l'operazione di corrispondenza precedente.
Equals(Object)	Indica se un altro oggetto è "uguale a" questo. (Ereditato da Object)
Find()	Tenta di trovare la sottosequenza successiva della sequenza di input che corrisponde al modello.
Find(Int32)	Reimposta questo matcher e quindi tenta di trovare la sottosequenza successiva della sequenza di input corrispondente al criterio, a partire dall'indice specificato.
GetHashCode()	Restituisce un valore del codice hash per l'oggetto. (Ereditato da Object)
Group()	Restituisce la sottosequenza di input corrispondente alla corrispondenza precedente.
Group(Int32)	Restituisce la sottosequenza di input acquisita dal gruppo specificato durante l'operazione di corrispondenza precedente.
Group(String)	Restituisce la sottosequenza di input acquisita dal gruppo di acquisizione denominato specificato durante l'operazione di corrispondenza precedente.
GroupCount()	Restituisce il numero di gruppi di acquisizione nel modello del matcher.
HitEnd()	Restituisce true se la fine dell'input è stata raggiunta dal motore di ricerca nell'ultima operazione di corrispondenza eseguita da questo matcher.
JavaFinalize()	Chiamato dal Garbage Collector su un oggetto quando Garbage Collection determina che non sono presenti altri riferimenti all'oggetto . (Ereditato da Object)
LookingAt()	Tenta di trovare la corrispondenza con la sequenza di input, a partire dall'inizio dell'area, rispetto al modello.
Matches()	Tenta di trovare una corrispondenza con l'intera area rispetto al modello.
Notify()	Riattiva un singolo thread in attesa del monitor dell'oggetto. (Ereditato da Object)
NotifyAll()	Riattiva tutti i thread in attesa del monitor dell'oggetto. (Ereditato da Object)
Pattern()	Restituisce il modello interpretato da questo matcher.
QuoteReplacement(String)	Restituisce una sostituzione letterale String per l'oggetto specificato String.
Region(Int32, Int32)	Imposta i limiti dell'area del matcher.
RegionEnd()	Segnala l'indice finale (esclusivo) dell'area del matcher.
RegionStart()	Segnala l'indice iniziale dell'area del matcher.
ReplaceAll(IFunction)	Sostituisce ogni sottosequenza della sequenza di input che corrisponde al criterio con il risultato dell'applicazione della funzione replacer specificata al risultato della corrispondenza di questo matcher corrispondente a tale sottosequenza.
ReplaceAll(String)	Sostituisce ogni sottosequenza della sequenza di input che corrisponde al criterio con la stringa di sostituzione specificata.
ReplaceFirst(IFunction)	Sostituisce la prima sottosequenza della sequenza di input che corrisponde al criterio con il risultato dell'applicazione della funzione replacer specificata al risultato della corrispondenza di questo matcher corrispondente a tale sottosequenza.
ReplaceFirst(String)	Sostituisce la prima sottosequenza della sequenza di input che corrisponde al criterio con la stringa di sostituzione specificata.
RequireEnd()	Restituisce true se più input potrebbero modificare una corrispondenza positiva in una corrispondenza negativa.
Reset()	Reimposta questo matcher.
Reset(ICharSequence)	Reimposta questo matcher con una nuova sequenza di input.
Reset(String)	Reimposta questo matcher con una nuova sequenza di input.
SetHandle(IntPtr, JniHandleOwnership)	Imposta la proprietà Handle. (Ereditato da Object)
Start()	Restituisce l'indice iniziale della corrispondenza precedente.
Start(Int32)	Restituisce l'indice iniziale della sottosequenza acquisita dal gruppo specificato durante l'operazione di corrispondenza precedente.
Start(String)	Restituisce l'indice iniziale della sottosequenza acquisita dal gruppo di acquisizione denominato specificato durante l'operazione di corrispondenza precedente.
ToArray<T>()	Motore che esegue operazioni di corrispondenza su un java. (Ereditato da Object)
ToMatchResult()	Restituisce lo stato di corrispondenza di questo matcher come .MatchResult
ToString()	Restituisce una rappresentazione di stringa dell'oggetto. (Ereditato da Object)
UnregisterFromRuntime()	Motore che esegue operazioni di corrispondenza su un java. (Ereditato da Object)
UseAnchoringBounds(Boolean)	Imposta l'ancoraggio dei limiti di area per questo matcher.
UsePattern(Pattern)	Modifica l'oggetto Pattern Matcher utilizzato da per trovare corrispondenze con .
UseTransparentBounds(Boolean)	Imposta la trasparenza dei limiti di area per questo matcher.
Wait()	Fa sì che il thread corrente attenda finché non viene risvegliato, in genere ricevendo <>una notifica</em> o <em>interrotto</em>. (Ereditato da Object)
Wait(Int64, Int32)	Fa sì che il thread corrente attenda finché non viene risvegliato, in genere ricevendo>< una notifica</em> o <em>interrotto</em> o fino a quando non è trascorsa una determinata quantità di tempo reale. (Ereditato da Object)
Wait(Int64)	Fa sì che il thread corrente attenda finché non viene risvegliato, in genere ricevendo>< una notifica</em> o <em>interrotto</em> o fino a quando non è trascorsa una determinata quantità di tempo reale. (Ereditato da Object)

Implementazioni dell'interfaccia esplicita

IJavaPeerable.Disposed()	Motore che esegue operazioni di corrispondenza su un java. (Ereditato da Object)
IJavaPeerable.DisposeUnlessReferenced()	Motore che esegue operazioni di corrispondenza su un java. (Ereditato da Object)
IJavaPeerable.Finalized()	Motore che esegue operazioni di corrispondenza su un java. (Ereditato da Object)
IJavaPeerable.JniManagedPeerState	Motore che esegue operazioni di corrispondenza su un java. (Ereditato da Object)
IJavaPeerable.SetJniIdentityHashCode(Int32)	Motore che esegue operazioni di corrispondenza su un java. (Ereditato da Object)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	Motore che esegue operazioni di corrispondenza su un java. (Ereditato da Object)
IJavaPeerable.SetPeerReference(JniObjectReference)	Motore che esegue operazioni di corrispondenza su un java. (Ereditato da Object)

Metodi di estensione

JavaCast<TResult>(IJavaObject)	Esegue una conversione del tipo di tipo controllato dal runtime Android.
JavaCast<TResult>(IJavaObject)	Motore che esegue operazioni di corrispondenza su un java.
GetJniTypeName(IJavaPeerable)	Motore che esegue operazioni di corrispondenza su un java.