Idioma

Transliterator Classe

Definição

Transliterator é uma classe abstrata que translitera o texto de um formato para outro.

[Android.Runtime.Register("android/icu/text/Transliterator", ApiSince=29, DoNotGenerateAcw=true)]
public abstract class Transliterator : Java.Lang.Object
[<Android.Runtime.Register("android/icu/text/Transliterator", ApiSince=29, DoNotGenerateAcw=true)>]
type Transliterator = class
    inherit Object
Herança
Transliterator
Atributos

Comentários

Transliterator é uma classe abstrata que translitera o texto de um formato para outro. O tipo mais comum de transliterador é um script, ou alfabeto, transliterador. Por exemplo, um transliterador russo para latino altera o texto russo escrito em caracteres cirílicos para caracteres latinos fonéticos equivalentes. Não em <>tradução</em> russo para o inglês! A transliteração, ao contrário da tradução, opera em caracteres, sem referência aos significados de palavras e frases.

Embora a conversão de script seja seu uso mais comum, um transliterador pode realmente executar uma classe mais geral de tarefas. Na verdade, Transliterator define uma API muito geral que especifica apenas que um segmento do texto de entrada é substituído pelo novo texto. As particularidades dessa conversão são determinadas inteiramente por subclasses de Transliterator.

<b>Transliteradores são sem< estado/b>

Transliterator os objetos são <em>sem< estado/em>; eles não retêm nenhuma informação entre chamadas para transliterate(). Como resultado, os threads podem compartilhar transliteradores sem sincronizá-los. Isso pode parecer limitar a complexidade da operação de transliteração. Na prática, as subclasses executam transliterações complexas atrasando a substituição do texto até que se saiba que nenhuma outra substituição é possível. Em outras palavras, embora os Transliterator objetos sejam sem estado, o texto de origem em si incorpora todas as informações necessárias e a operação atrasada permite complexidade arbitrária.

<b>Transliteração do< Lote/b>

A maneira mais simples de executar a transliteração é tudo de uma vez, em uma cadeia de caracteres de texto existente. Isso é chamado <de transliteração em>lote</em> . Por exemplo, dada uma cadeia de caracteres input e um transliterador t, a chamada

<blockquote>String result = t.transliterate(input); </blockquote>

o transliterará e retornará o resultado. Outros métodos permitem que o cliente especifique uma subcadeia de caracteres a ser transliterada e use Replaceable objetos em vez de cadeias de caracteres, a fim de preservar informações fora da banda (como estilos de texto).

<b>Transliteração de< teclado/b>

Um pouco mais envolvido é <em>teclado</em> ou transliteração incremental. Essa é a transliteração de texto que está chegando de alguma origem (normalmente o teclado do usuário) um caractere de cada vez ou de alguma outra forma.

Na transliteração do teclado, um Replaceable buffer armazena o texto. À medida que o texto é inserido, o máximo possível é transliterado em tempo real. Isso significa que uma GUI que exibe o conteúdo do buffer pode mostrar o texto sendo modificado à medida que cada novo caractere chega.

Considere o Transliterador baseado em regra simples:

<blockquote> th&gt;{theta}<br> t&gt;{tau} </blockquote>

Quando o usuário digita 't', nada acontecerá, pois o transliterador está aguardando para ver se o próximo caractere é 'h'. Para corrigir isso, apresentamos a noção de um cursor, marcado por um '|' na cadeia de caracteres de saída:

<blockquote> t&gt;|{tau}<br> {tau}h&gt;{theta} </blockquote>

Agora, quando o usuário digita 't', tau aparece e, se o próximo caractere for 'h', o tau muda para um theta. Isso é feito mantendo uma posição de cursor (independente do ponto de inserção e invisível na GUI) entre chamadas para transliterate(). Normalmente, o cursor será coincidente com o ponto de inserção, mas em um caso como o acima, ele precederá o ponto de inserção.

Os métodos de transliteração de teclado mantêm um conjunto de três índices que são atualizados com cada chamada para transliterate(), incluindo o cursor, a inicialização e o limite. Esses índices são alterados pelo método e são passados por meio de um objeto Position. O start índice marca o início da subcadeia de caracteres que o transliterador examinará. Ele é avançado à medida que o texto se torna confirmado (mas não é o índice confirmado; esse é o cursor). O cursor índice, descrito acima, marca o ponto em que o transliterador parou pela última vez, porque chegou ao final ou porque exigia mais caracteres para desambiguar entre as entradas possíveis. O cursor também pode ser definido explicitamente por regras. Quaisquer caracteres antes que o cursor índice seja congelado; futuras chamadas de transliteração de teclado dentro dessa sequência de entrada não os alterarão. O novo texto é inserido no limit índice, que marca o final da subcadeia de caracteres que o transliterador examina.

Como a transliteração de teclado pressupõe que mais caracteres devem chegar, ela é conservadora em sua operação. Ele só translitera quando pode fazê-lo de forma inequívoca. Caso contrário, ele aguarda a chegada de mais caracteres. Quando o código do cliente souber que não há mais caracteres próximos, talvez porque o usuário tenha executado alguma operação de encerramento de entrada, ele deverá chamar finishTransliteration() para concluir todas as transliterações pendentes.

<b>Inversos</b>

Pares de transliteradores podem ser inversos uns dos outros. Por exemplo, se o transliterador <b>A</b> translitera caracteres incrementando seu valor Unicode (assim "abc" -> "def" e transliterador <b>B</b> decrements valores de caractere, em seguida <, b>A</b> é um inverso de <b>B</b> e vice-versa. Se compormos <b>A</b> com <b>B</b> em um transliterador composto, o resultado será o transliterador de identidade, ou seja, um transliterador que não altera seu texto de entrada.

O Transliterator método getInverse() retorna o inverso de um transliterador, se existir ou null não. No entanto, o resultado de getInverse() geralmente não< será></em> um verdadeiro inverso matemático. Isso ocorre porque translitadores inversos verdadeiros são difíceis de formular. Por exemplo, considere dois transliteradores: <b>AB</b>, que translitera o caractere 'A' para 'B' e <b>BA</b>, que translitera 'B' para 'A'. Pode parecer que estes são inversos exatos, uma vez que

<blockquote>"A" x <b>AB</b> -> "B"<br> "B" x <b>BA</b> -> "A"</blockquote>

em que 'x' representa a transliteração. No entanto,

<blockquote>"ABCD" x <b>AB</b> -> "BBCD"<br> "BBCD" x <b>BA</b> -> "AACD"</blockquote>

portanto <, b>AB</b> composto com <b>BA</b> não é a identidade. No entanto, b BA/b< pode ser útilmente considerado >inverso do b<AB>/b<, e é nessa base que >b<AB>/b<> poderia legitimamente retornar <b>BA.getInverse()/b<.><>

<b>Filtragem</b>

Cada transliterador tem um filtro, que restringe as alterações aos caracteres selecionados pelo filtro. O filtro afeta apenas os caracteres que são alterados. Os caracteres fora do filtro ainda fazem parte do contexto do filtro. Por exemplo, no seguinte, mesmo que 'x' seja filtrado e não seja convertido em y, isso afeta a conversão de 'a'.

String rules = &quot;x &gt; y; x{a} &gt; b; &quot;;
            Transliterator tempTrans = Transliterator.createFromRules(&quot;temp&quot;, rules, Transliterator.FORWARD);
            tempTrans.setFilter(new UnicodeSet(&quot;[a]&quot;));
            String tempResult = tempTrans.transform(&quot;xa&quot;);
            // results in &quot;xb&quot;

<b>IDs e nomes< de exibição/b>

Um transliterador é designado por uma cadeia de caracteres de identificador curto ou <em ID>/em<>. As IDs seguem o formato <em source-destination>/em<, em >que em<source>/em< descreve a entidade que está sendo substituída e >em<destination>/em< descreve a entidade substituindo >em<source>/em<.> As entidades podem ser os nomes de scripts, sequências específicas de caracteres ou qualquer outra coisa que seja que o transliterador converte de ou para. Por exemplo, um transliterador de russo para latino pode ser chamado de "russo-latino". Um transliterador de sequências de escape de teclado para caracteres Latino-1 pode ser chamado de "KeyboardEscape-Latin1". Por convenção, os nomes de entidade do sistema estão em inglês, com as letras iniciais de palavras maiúsculas; os nomes de entidade de usuário podem seguir qualquer formato, desde que não contenham traços.

Além das IDs programáticas, os objetos transliteradores têm nomes de exibição para apresentação em interfaces de usuário, retornados por #getDisplayName.

<b>Transliteradores compostos</b>

Além de translitadores internos do sistema, como "latino-grego", também há translitadores integrados em <>compostos</em>. Eles são implementados compondo dois ou mais translitadores de componente. Por exemplo, se tivermos scripts "A", "B", "C" e "D" e quisermos transliterar entre todos os pares deles, precisaremos escrever 12 translitadores: "A-B", "A-C", "A-D", "B-A" ,..., "D-A", "D-B", "D-C". Se for possível converter todos os scripts em um script intermediário "M", em vez de escrever 12 conjuntos de regras, só precisaremos escrever 8: "A~M", "B~M", "C~M", "D~M", "M~A", "M~B", "M~C", "M~D". (Isso pode não parecer uma grande vitória, mas é realmente 2 em n/em< vs. >em<n>/em<>sup<2>/sup< - >em<n>/em<, de modo >que em<n>/em< fica maior o ganho torna-se significativo.><> Com 9 scripts, são 18 contra 72 conjuntos de regras, uma grande diferença.) Observe o uso de "~" em vez de "-" para o separador de script aqui; isso indica que o transliterador fornecido destina-se a ser composto com outras pessoas, em vez de ser usado como está.

Translitadores compostos podem ser instanciados como de costume. Por exemplo, o transliterador do sistema "Devanagari-Gujarati" é um transliterador composto criado internamente como "Devanagari~InterIndic; InterIndic~Gujarati". Quando esse transliterador é instanciado, ele aparece externamente como um transliterador padrão (por exemplo, getID() retorna "Devanagari-Gujarati").

<sintaxe< de regra b>/b>

Um conjunto de regras determina como executar traduções. As regras dentro de um conjunto de regras são separadas por ponto-e-vírgula (';'). Para incluir um ponto e vírgula literal, prefixe-o com uma barra invertida ('\'). O Pattern_White_Space Unicode é ignorado. Se o primeiro caractere não em branco em uma linha for '#', toda a linha será ignorada como um comentário.

Cada conjunto de regras consiste em dois grupos, um para frente e outro inverso. Esta é uma convenção que não é imposta; as regras de uma direção podem ser omitidas, com o resultado de que as traduções nessa direção não modificarão o texto de origem. Além disso, as regras bidirecionais inversas podem ser especificadas para transformações simétricas.

Observação: outra descrição da sintaxe da regra Transliterator está disponível na seção Transformar Sintaxe de Regras de UTS #35: Unicode LDML. As regras são mostradas lá usando símbolos de seta ← e → e ↔ . A UTI dá suporte a esses símbolos ASCII e equivalentes; e > e > >.

As instruções de regra tomam um dos seguintes formulários:

<dl><dt><$alefmadda=\\u0622;/dt><dd><definição de variável forte>.</strong> O nome à esquerda recebe o texto à direita. Neste exemplo, após essa instrução, instâncias do nome à esquerda, "$alefmadda", será substituído pelo caractere Unicode U+0622. Os nomes das variáveis devem começar com uma letra e consistir apenas em letras, dígitos e sublinhados. O caso é significativo. Nomes duplicados fazem com que uma exceção seja gerada, ou seja, as variáveis não podem ser redefinidas. O lado direito pode conter texto bem formado de qualquer comprimento, incluindo nenhum texto (>$empty=;>). O lado direito pode conter padrões inseridosUnicodeSet, por exemplo, "$softvowel=[eiyEIY]>.</dd><dt>ai&gt;$alefmadda;</dt><dd><strong>Forward translation rule.</strong> Essa regra indica que a cadeia de caracteres à esquerda será alterada para a cadeia de caracteres à direita ao executar a transliteração para frente.</dd><dt>ai&lt;$alefmadda;</dt><dd><regra de conversão reversa forte>.</strong> Essa regra indica que a cadeia de caracteres à direita será alterada para a cadeia de caracteres à esquerda ao executar a transliteração inversa.</dd></dl>

<dl><dt><ai&lt;&gt;$alefmadda;/dt><dd><regra de tradução bidirecional forte>.</strong> Essa regra afirma que a cadeia de caracteres à direita será alterada para a cadeia de caracteres à esquerda ao executar a transliteração para frente e vice-versa ao executar a transliteração inversa.</dd></dl>

As regras de tradução consistem em um padrão</em> correspondência e uma<> cadeia de caracteres/em< saída>< em.> O padrão de correspondência consiste em caracteres literais, opcionalmente precedidos pelo contexto e, opcionalmente, seguidos pelo contexto. Caracteres de contexto, como caracteres de padrão literal, devem ser correspondidos no texto que está sendo transliterado. No entanto, ao contrário dos caracteres de padrão literal, eles não são substituídos pelo texto de saída. Por exemplo, o padrão >abc{def}> indica os caracteres e aspas;def> deve ser precedido por "abc> para uma correspondência bem-sucedida. Se houver uma correspondência bem-sucedida, &aspa;def> será substituído, mas não &aspa;abc>. O '}' final é opcional, portanto, &aspa;abc{def> é equivalente a >abc{def}>. Outro exemplo é >{123}456> (ou >123}456") em que o padrão literal &aspa;123> deve ser seguido por "456>.

A cadeia de caracteres de saída de uma regra para frente ou inversa consiste em caracteres para substituir os caracteres de padrão literal. Se a cadeia de caracteres de saída contiver o caractere '|', isso será usado para indicar o local do cursor< em/em> após a <>substituição. O cursor é o ponto no texto no qual a próxima substituição, se houver, será aplicada. O cursor geralmente é colocado dentro do texto de substituição; no entanto, ele pode realmente ser colocado no contexto precending ou a seguir usando o caractere especial '

Java documentação para android.icu.text.Transliterator.

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

Construtores

Nome Descrição
Transliterator(IntPtr, JniHandleOwnership)

Cria uma instância gerenciada que representa um objeto Java existente.

Campos

Nome Descrição
Forward
Obsoleto.

Constante de direção que indica a direção para a frente em um transliterador, e.

Reverse
Obsoleto.

Constante de direção que indica a direção inversa em um transliterador, e.

Propriedades

Nome Descrição
AvailableIDs

Retorna uma enumeração sobre os nomes programáticos de objetos registrados Transliterator .

AvailableSources

Retorna uma enumeração sobre os nomes de origem de transliteradores registrados.

Class

Retorna a classe de runtime deste Object.

(Herdado de Object)
Filter

Retorna o filtro usado por esse transliterador ou null se esse transliterador não usa nenhum filtro. -ou- Altera o filtro usado por esse transliterador.

Handle

O identificador para a instância subjacente do Android.

(Herdado de Object)
ID

Retorna um identificador programático para esse transliterador.

Inverse

Retorna o inverso desse transliterador.

JniIdentityHashCode

Obtém o código de hash de identidade atribuído a esse par Java pelo runtime de interoperabilidade.

(Herdado de Object)
JniManagedPeerState

Obtém os sinalizadores de estado atribuídos pela última vez pelo runtime.

(Herdado de JavaObject)
JniPeerMembers

Obtém os metadados JNI usados para acessar membros dessa associação Java.

MaximumContextLength

Retorna o comprimento do contexto mais longo exigido por esse transliterador.

PeerReference

Obtém a referência de objeto JNI para este par Java.

(Herdado de Object)
SourceSet

Retorna o conjunto de todos os caracteres que podem ser modificados no texto de entrada por esse Transliterador.

TargetSet

Retorna o conjunto de todos os caracteres que podem ser gerados como texto de substituição por esse transliterador.

ThresholdClass

Obtém a classe Java usada para expedição de método virtual.

ThresholdType

Obtém o tipo gerenciado que declara essa associação de Java.

Métodos

Nome Descrição
Clone()

Cria e retorna uma cópia desse objeto.

(Herdado de Object)
Construct(JniObjectReference, JniObjectReferenceOptions)

Delega a construção desse par ao gerenciador de valores do runtime.

(Herdado de JavaObject)
CreateFromRules(String, String, DirectionOptions)

Retorna um Transliterator objeto construído a partir da cadeia de caracteres de regra fornecida.

Dispose()

Libera os recursos mantidos por esse par Java.

(Herdado de Object)
Dispose(Boolean)

Libera os recursos mantidos por esse par Java.

(Herdado de Object)
DisposeUnlessReferenced()

Pede ao gerenciador de valores para descartar esse par, a menos que seu mapeamento mantenha essa mesma instância gerenciada.

(Herdado de JavaObject)
Equals(Object)

Testa se outro par gerenciado se refere ao mesmo objeto Java.

(Herdado de JavaObject)
Equals(Object)

Indica se algum outro objeto é "igual a" este.

(Herdado de Object)
FilteredTransliterate(IReplaceable, Transliterator+Position, Boolean)

Translitera uma subcadeia de caracteres de texto, conforme especificado pelo índice, levando em conta os filtros.

FinishTransliteration(IReplaceable, Transliterator+Position)

Conclui todas as transliterações pendentes que estavam esperando por mais caracteres.

GetAvailableTargets(String)

Retorna uma enumeração sobre os nomes de destino de translitadores registrados que têm um determinado nome de origem.

GetAvailableVariants(String, String)

Retorna uma enumeração sobre os nomes variantes de transliteradores registrados que têm um nome de origem e um nome de destino específicos.

GetDisplayName(String, Locale)

Retorna um nome para esse transliterador apropriado para exibição ao usuário na localidade fornecida.

GetDisplayName(String, ULocale)

Retorna um nome para esse transliterador apropriado para exibição ao usuário na localidade fornecida.

GetDisplayName(String)

Retorna um nome para esse transliterador apropriado para exibição para o usuário na localidade padrão DISPLAY .

GetElements()

Retorne os elementos que compõem esse transliterador.

GetHashCode()

Retorna um valor de código hash para o objeto.

(Herdado de Object)
GetInstance(String, Int32)

Retorna um Transliterator objeto dado seu ID.

GetInstance(String)

Retorna um Transliterator objeto dado seu ID.

JavaFinalize()
Obsoleto.

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)
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)
SetHandle(IntPtr, JniHandleOwnership)

Define a propriedade Handle

(Herdado de Object)
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)

Armazena um valor de referência no bloco de controle sem criar uma cópia de referência JNI.

(Herdado de JavaObject)
ToArray<T>()

Cria uma matriz gerenciada com base nesse wrapper de matriz Java.

(Herdado de Object)
ToRules(Boolean)

Retorna uma cadeia de caracteres de regra para esse transliterador.

ToString()

Retorna uma representação de cadeia de caracteres do objeto.

(Herdado de Object)
Transliterate(IReplaceable, Int32, Int32)

Translitera um segmento de uma cadeia de caracteres, com filtragem opcional.

Transliterate(IReplaceable, Transliterator+Position, Int32)

Translitera a parte do buffer de texto que pode ser transliterada de forma inequívoca após a inserção de um novo caractere, normalmente como resultado de um evento de teclado.

Transliterate(IReplaceable, Transliterator+Position, String)

Translitera a parte do buffer de texto que pode ser transliterada de forma inequívoca após a inserção do novo texto, normalmente como resultado de um evento de teclado.

Transliterate(IReplaceable, Transliterator+Position)

Translitera a parte do buffer de texto que pode ser transliterada de forma inequívoca.

Transliterate(IReplaceable)

Translitera uma cadeia de caracteres inteira no lugar.

Transliterate(String)

Translitera uma cadeia de caracteres inteira e retorna o resultado.

UnregisterFromRuntime()

Cancela o registro desse par Java do runtime de interoperabilidade.

(Herdado de Object)
Wait()

Faz com que o thread atual aguarde até ser despertado, normalmente por ser <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 por ser <>notificado</em> ou <em>interrompido</em>, ou até que uma determinada quantidade de tempo real tenha decorrido.

(Herdado de Object)
Wait(Int64)

Faz com que o thread atual aguarde até que ele seja despertado, normalmente por ser <>notificado</em> ou <em>interrompido</em>, ou até que uma determinada quantidade de tempo real tenha decorrido.

(Herdado de Object)

Implantações explícitas de interface

Nome Descrição
IJavaPeerable.Disposed()

Marca esse par como descartado e chama Dispose com disposing set to true.

(Herdado de JavaObject)
IJavaPeerable.Finalized()

Marca esse par como descartado e chama Dispose com disposing set to false.

(Herdado de JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock

Obtém o ponteiro de bloco de controle nativo usado por esse par.

(Herdado de JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)

Armazena o código de hash de identidade fornecido pelo runtime.

(Herdado de JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)

Substitui os sinalizadores de estado de par gerenciado armazenados.

(Herdado de JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)

Atualiza a referência de par e libera o bloco de controle de um par descartado quando a referência é inválida.

(Herdado de JavaObject)

Métodos de Extensão

Nome Descrição
GetJniTypeName(IJavaPeerable)

Obtém o nome JNI do tipo da instância self.

JavaAs<TResult>(IJavaPeerable)

Tente coagir a digitar selfTResult, verificando se a coerção é válida no lado Java.

JavaCast<TResult>(IJavaObject)

Executa uma conversão de tipo marcada por runtime do Android.

JavaCast<TResult>(IJavaObject)

Reutiliza um par gerenciado compatível ou obtém um wrapper do tipo solicitado.

TryJavaCast<TResult>(IJavaPeerable, TResult)

Tente coagir a digitar selfTResult, verificando se a coerção é válida no lado Java.

Aplica-se a