Matcher Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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
- Atributos
- Implementações
Comentários
Um mecanismo que executa operações de correspondência em uma sequência de caracteres java.lang.CharSequence interpretando um Pattern
arquivo .
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 |
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 |
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 |
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 |
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, 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) |
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) |
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. |