Matcher Classe

Definição

Namespace:

Java.Util.Regex

Assembly:

Mono.Android.dll

Um mecanismo que executa operações de correspondência em um 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

Herança

Object

Object

Matcher

Atributos

RegisterAttribute

Implementações

IJavaObject IJavaPeerable IMatchResult IDisposable

Comentários

Um mecanismo que executa operações de correspondência em uma sequência de caracteres java.lang.CharSequence interpretando um Patternarquivo .

Um correspondente é criado a partir de um padrão invocando o método do Pattern#matcher matcher padrão. Uma vez criado, um matcher pode ser usado para executar três tipos diferentes de operações de correspondência:

<ul>

<li>

O #matches matches método tenta corresponder toda a sequência de entrada contra o padrão.

</li>

<li>

O #lookingAt lookingAt método tenta corresponder a sequência de entrada, começando no início, com o padrão.

</li>

<li>

O #find find método verifica a sequência de entrada procurando a próxima subsequência que corresponde ao padrão.

</li>

</ul>

Cada um desses métodos retorna um booleano indicando sucesso ou falha. Mais informações sobre uma correspondência bem-sucedida podem ser obtidas consultando o estado do matcher.

Um correspondente localiza correspondências em um subconjunto de sua entrada chamado região. Por padrão, a região contém toda a entrada do correspondente. A região pode ser modificada através do #region(int, int) region método e consultada através dos #regionStart() regionStart métodos e #regionEnd() regionEnd . A maneira como os limites da região interagem com algumas construções de padrão pode ser alterada. Consulte #useAnchoringBounds(boolean) useAnchoringBounds e #useTransparentBounds(boolean) useTransparentBounds para obter mais detalhes.

Essa classe também define métodos para substituir subsequências correspondentes por novas cadeias de caracteres cujo conteúdo pode, se desejado, ser computado a partir do resultado da correspondência. Os #appendReplacement appendReplacement métodos e #appendTail appendTail podem ser usados em conjunto para coletar o resultado em um buffer de cadeia de caracteres existente ou construtor de cadeias de caracteres. Como alternativa, o método mais conveniente #replaceAll replaceAll pode ser usado para criar uma cadeia de caracteres na qual cada subsequência correspondente na sequência de entrada é substituída.

O estado explícito de um matcher inclui os índices de início e fim da partida bem-sucedida mais recente. Ele também inclui os índices de início e fim da subsequência de entrada capturada por cada grupo de captura no padrão, bem como uma contagem total de tais subsequências. Como conveniência, métodos também são fornecidos para retornar essas subsequências capturadas em forma de cadeia de caracteres.

O estado explícito de um matcher é inicialmente indefinido; tentar consultar qualquer parte dele antes de uma partida bem-sucedida fará com que um IllegalStateException seja lançado. O estado explícito de um matcher é recalculado por cada operação de correspondência.

O estado implícito de um correspondente inclui a sequência de caracteres de entrada, bem como a posição de acréscimo, que é inicialmente zero e é atualizada pelo #appendReplacement appendReplacement método.

Um correspondente pode ser redefinido explicitamente invocando seu #reset() método ou, se uma nova sequência de entrada for desejada, seu #reset(java.lang.CharSequence) reset(CharSequence) método. A redefinição de um correspondente descarta suas informações de estado explícito e define a posição de acréscimo como zero.

As instâncias dessa classe não são seguras para uso por vários threads simultâneos.

Adicionado em 1.4.

Documentação Java para java.util.regex.Matcher.

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Android Open Source Project e usado de acordo com os termos descritos na Creative Commons 2.5 Attribution License.

Propriedades

Class	Retorna a classe de tempo de execução deste Object. (Herdado de Object)
Handle	O identificador para a instância subjacente do Android. (Herdado de Object)
HasAnchoringBounds	Consulta a ancoragem dos limites de região para este matcher.
HasTransparentBounds	Consulta a transparência dos limites de região para este matcher.
JniIdentityHashCode	Um mecanismo que executa operações de correspondência em um java. (Herdado de Object)
JniPeerMembers	Um mecanismo que executa operações de correspondência em um java.
PeerReference	Um mecanismo que executa operações de correspondência em um java. (Herdado de Object)
ThresholdClass	Esta API suporta a infraestrutura Mono para Android e não se destina a ser usada diretamente do seu código. (Herdado de Object)
ThresholdType	Esta API suporta a infraestrutura Mono para Android e não se destina a ser usada diretamente do seu código. (Herdado de Object)

Métodos

AppendReplacement(StringBuffer, String)	Implementa uma etapa de acréscimo e substituição não terminal.
AppendReplacement(StringBuilder, String)	Implementa uma etapa de acréscimo e substituição não terminal.
AppendTail(StringBuffer)	Implementa uma etapa de anexação e substituição de terminal.
AppendTail(StringBuilder)	Implementa uma etapa de anexação e substituição de terminal.
Clone()	Cria e retorna uma cópia desse objeto. (Herdado de Object)
Dispose()	Um mecanismo que executa operações de correspondência em um java. (Herdado de Object)
Dispose(Boolean)	Um mecanismo que executa operações de correspondência em um java. (Herdado de Object)
End()	Retorna o deslocamento após a correspondência do último caractere.
End(Int32)	Retorna o deslocamento após o último caractere da subsequência capturado pelo determinado grupo durante a operação de correspondência anterior.
End(String)	Retorna o deslocamento após o último caractere da subsequência capturada pelo grupo de captura nomeado fornecido durante a operação de correspondência anterior.
Equals(Object)	Indica se algum outro objeto é "igual" a este. (Herdado de Object)
Find()	Tenta localizar a próxima subsequência da sequência de entrada que corresponde ao padrão.
Find(Int32)	Redefine essa correspondência e, em seguida, tenta localizar a próxima subsequência da sequência de entrada que corresponde ao padrão, começando no índice especificado.
GetHashCode()	Retorna um valor de código hash para o objeto. (Herdado de Object)
Group()	Retorna a subsequência de entrada correspondente à correspondência anterior.
Group(Int32)	Retorna a subsequência de entrada capturada pelo determinado grupo durante a operação de correspondência anterior.
Group(String)	Retorna a subsequência de entrada capturada pelo grupo de captura nomeado fornecido durante a operação de correspondência anterior.
GroupCount()	Retorna o número de grupos de captura no padrão desse correspondente.
HitEnd()	Retorna true se o final da entrada foi atingido pelo mecanismo de pesquisa na última operação de correspondência executada por esse correspondente.
JavaFinalize()	Chamado pelo coletor de lixo em um objeto quando a coleta de lixo determina que não há mais referências ao objeto. (Herdado de Object)
LookingAt()	Tenta corresponder a sequência de entrada, começando no início da região, com o padrão.
Matches()	Tenta fazer a correspondência de toda a região com o padrão.
Notify()	Ativa um único thread que está aguardando no monitor deste objeto. (Herdado de Object)
NotifyAll()	Ativa todos os threads que estão aguardando no monitor deste objeto. (Herdado de Object)
Pattern()	Retorna o padrão que é interpretado por esse correspondente.
QuoteReplacement(String)	Retorna uma substituição String literal para o Stringespecificado .
Region(Int32, Int32)	Define os limites da região deste matcher.
RegionEnd()	Informa o índice final (exclusivo) da região deste matcher.
RegionStart()	Informa o índice inicial da região deste matcher.
ReplaceAll(IFunction)	Substitui cada subsequência da sequência de entrada que corresponde ao padrão com o resultado da aplicação da função de substituição dada ao resultado da correspondência desse correspondente a essa subsequência.
ReplaceAll(String)	Substitui cada subsequência da sequência de entrada que corresponde ao padrão com a sequência de substituição fornecida.
ReplaceFirst(IFunction)	Substitui a primeira subsequência da sequência de entrada que corresponde ao padrão com o resultado da aplicação da função de substituição dada ao resultado da correspondência desse correspondente correspondente a essa subsequência.
ReplaceFirst(String)	Substitui a primeira subsequência da sequência de entrada que corresponde ao padrão com a sequência de substituição fornecida.
RequireEnd()	Retorna true se mais entradas puderem transformar uma correspondência positiva em negativa.
Reset()	Redefine esse matcher.
Reset(ICharSequence)	Redefine esse correspondente com uma nova sequência de entrada.
Reset(String)	Redefine esse correspondente com uma nova sequência de entrada.
SetHandle(IntPtr, JniHandleOwnership)	Define a propriedade Handle. (Herdado de Object)
Start()	Retorna o índice inicial da partida anterior.
Start(Int32)	Retorna o índice inicial da subsequência capturada pelo grupo fornecido durante a operação de correspondência anterior.
Start(String)	Retorna o índice inicial da subsequência capturada pelo grupo de captura nomeado fornecido durante a operação de correspondência anterior.
ToArray<T>()	Um mecanismo que executa operações de correspondência em um java. (Herdado de Object)
ToMatchResult()	Retorna o estado de correspondência desse correspondente como um MatchResultarquivo .
ToString()	Retorna uma representação de cadeia de caracteres do objeto. (Herdado de Object)
UnregisterFromRuntime()	Um mecanismo que executa operações de correspondência em um java. (Herdado de Object)
UseAnchoringBounds(Boolean)	Define a ancoragem dos limites de região para esse correspondente.
UsePattern(Pattern)	Altera o Pattern que isso Matcher usa para encontrar correspondências com.
UseTransparentBounds(Boolean)	Define a transparência dos limites de região para este correspondente.
Wait()	Faz com que o thread atual aguarde até que ele seja ativado, normalmente sendo <em notificado</em> ou <em>interrompido</em>>. (Herdado de Object)
Wait(Int64)	Faz com que o thread atual aguarde até que ele seja despertado, normalmente sendo <em>notificado</em> ou <em interrompido</em>, ou até que>uma certa quantidade de tempo real tenha decorrido. (Herdado de Object)
Wait(Int64, Int32)	Faz com que o thread atual aguarde até que ele seja despertado, normalmente sendo <em>notificado</em> ou <em interrompido</em>, ou até que>uma certa quantidade de tempo real tenha decorrido. (Herdado de Object)

Implantações explícitas de interface

IJavaPeerable.Disposed()	Um mecanismo que executa operações de correspondência em um java. (Herdado de Object)
IJavaPeerable.DisposeUnlessReferenced()	Um mecanismo que executa operações de correspondência em um java. (Herdado de Object)
IJavaPeerable.Finalized()	Um mecanismo que executa operações de correspondência em um java. (Herdado de Object)
IJavaPeerable.JniManagedPeerState	Um mecanismo que executa operações de correspondência em um java. (Herdado de Object)
IJavaPeerable.SetJniIdentityHashCode(Int32)	Um mecanismo que executa operações de correspondência em um java. (Herdado de Object)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	Um mecanismo que executa operações de correspondência em um java. (Herdado de Object)
IJavaPeerable.SetPeerReference(JniObjectReference)	Um mecanismo que executa operações de correspondência em um java. (Herdado de Object)

Métodos de Extensão

JavaCast<TResult>(IJavaObject)	Executa uma conversão de tipo verificada em tempo de execução do Android.
JavaCast<TResult>(IJavaObject)	Um mecanismo que executa operações de correspondência em um java.
GetJniTypeName(IJavaPeerable)	Um mecanismo que executa operações de correspondência em um java.