CollationElementIterator 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.
CollationElementIterator é um iterador criado por um RuleBasedCollator para percorrer uma cadeia de caracteres.
[Android.Runtime.Register("android/icu/text/CollationElementIterator", ApiSince=24, DoNotGenerateAcw=true)]
public sealed class CollationElementIterator : Java.Lang.Object[<Android.Runtime.Register("android/icu/text/CollationElementIterator", ApiSince=24, DoNotGenerateAcw=true)>]
type CollationElementIterator = class
inherit Object- Herança
- Atributos
Comentários
CollationElementIterator é um iterador criado por um RuleBasedCollator para percorrer uma cadeia de caracteres. O resultado de retorno de cada iteração é um CE (elemento de ordenação) de 32 bits que define a prioridade de ordenação do próximo caractere ou sequência de caracteres na cadeia de caracteres de origem.
Para ilustração, considere o seguinte na Eslovaca e na ordenação tradicional espanhola: <blockquote>
"ca" -> the first collation element is CE('c') and the second
collation element is CE('a').
"cha" -> the first collation element is CE('ch') and the second
collation element is CE('a').
</blockquote> And in german phonebook collation, <blockquote>
Since the character 'æ' is a composed character of 'a' and 'e', the
iterator returns two collation elements for the single character 'æ'
"æb" -> the first collation element is collation_element('a'), the
second collation element is collation_element('e'), and the
third collation element is collation_element('b').
</blockquote>
Para a comparação de ordenação de ordenação, os resultados do elemento de ordenação não podem ser comparados simplesmente usando operadores aritméticos básicos, por exemplo, <, == ou >, é preciso fazer um processamento adicional. Os detalhes podem ser encontrados no Guia do Usuário da UTI. Um exemplo de como usar o CollationElementIterator para a comparação de ordenação de ordenação é a classe android.icu.text.StringSearch.
Para construir um objeto CollationElementIterator, os usuários chamam o método getCollationElementIterator() em um RuleBasedCollator que define a ordem de classificação desejada.
Exemplo: <blockquote>
String testString = "This is a test";
RuleBasedCollator rbc = new RuleBasedCollator("&a<b");
CollationElementIterator iterator = rbc.getCollationElementIterator(testString);
int primaryOrder = iterator.IGNORABLE;
while (primaryOrder != iterator.NULLORDER) {
int order = iterator.next();
if (order != iterator.IGNORABLE &&
order != iterator.NULLORDER) {
// order is valid, not ignorable and we have not passed the end
// of the iteration, we do something
primaryOrder = CollationElementIterator.primaryOrder(order);
System.out.println("Next primary order 0x" +
Integer.toHexString(primaryOrder));
}
}
</blockquote>
O método next() retorna a ordem de ordenação do próximo caractere com base no nível de comparação do collator. O método previous() retorna a ordem de ordenação do caractere anterior com base no nível de comparação do collator. O Iterador de Elemento de Ordenação se move apenas em uma direção entre chamadas para reset(), setOffset() ou setText(). Ou seja, next() e previous() não podem ser interutilizes. Sempre que anterior() deve ser chamado após next() ou vice-versa, reset(), setOffset() ou setText() deve ser chamado primeiro para redefinir o status, mudando a posição atual para o final ou o início da cadeia de caracteres (reset() ou setText()) ou a posição especificada (setOffset()). Portanto, na próxima chamada de next() ou previous(), a primeira ou última ordem de ordenação ou ordem de ordenação na posição especificada será retornada. Se uma alteração de direção for feita sem uma dessas chamadas, o resultado será indefinido.
Essa classe não é subclassável.
Java documentação para android.icu.text.CollationElementIterator.
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.
Campos
| Nome | Description |
|---|---|
| Ignorable |
Essa constante é retornada pelo iterador nos métodos next() e previous() quando um resultado do elemento de ordenação deve ser ignorado. |
| Nullorder |
Essa constante é retornada pelo iterador nos métodos next() e previous() quando o final ou o início da cadeia de caracteres de origem foi atingido e não há mais elementos de ordenação válidos a serem retornados. |
Propriedades
| Nome | Description |
|---|---|
| Class |
Retorna a classe de runtime deste |
| Handle |
O identificador para a instância subjacente do Android. (Herdado de Object) |
| JniIdentityHashCode |
Obtém o código de hash de identidade atribuído a esse par Java pelo runtime de interoperabilidade. (Herdado de Object) |
| JniManagedPeerState |
|
| JniPeerMembers |
|
| Offset |
Retorna o deslocamento de caractere na cadeia de caracteres de origem correspondente ao próximo elemento de ordenação. -ou- Define o iterador para apontar para o elemento de ordenação correspondente ao caractere no deslocamento especificado. |
| PeerReference |
Obtém a referência de objeto JNI para este par Java. (Herdado de Object) |
| ThresholdClass |
Essa API dá suporte à infraestrutura do Mono para Android e não se destina a ser usada diretamente do seu código. (Herdado de Object) |
| ThresholdType |
Essa API dá suporte à infraestrutura do Mono para Android e não se destina a ser usada diretamente do seu código. (Herdado de Object) |
Métodos
| Nome | Description |
|---|---|
| Clone() |
Cria e retorna uma cópia desse objeto. (Herdado de Object) |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
|
| 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() |
|
| Equals(Object) |
|
| Equals(Object) |
Indica se algum outro objeto é "igual a" este. (Herdado de Object) |
| GetHashCode() |
Retorna um valor de código hash para o objeto. (Herdado de Object) |
| GetMaxExpansion(Int32) |
Retorna o comprimento máximo de qualquer sequência de expansão que termina com o elemento de ordenação especificado. |
| 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) |
| Next() |
Obtenha o próximo elemento de ordenação na cadeia de caracteres de origem. |
| 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) |
| Previous() |
Obtenha o elemento de ordenação anterior na cadeia de caracteres de origem. |
| PrimaryOrder(Int32) |
Retornar a ordem primária do elemento de ordenação especificado, i. |
| Reset() |
Redefine o cursor para o início da cadeia de caracteres. |
| SecondaryOrder(Int32) |
Retornar a ordem secundária do elemento de ordenação especificado, i. |
| SetHandle(IntPtr, JniHandleOwnership) |
Define a propriedade Handle (Herdado de Object) |
| SetPeerReference(JniObjectReference, JniObjectReferenceOptions) |
|
| SetText(ICharacterIterator) |
Defina um novo iterador de cadeia de caracteres de origem para iteração e redefina o deslocamento para o início do texto. |
| SetText(String) |
Defina uma nova cadeia de caracteres de origem para iteração e redefina o deslocamento para o início do texto. |
| SetText(UCharacterIterator) |
Defina um novo iterador de cadeia de caracteres de origem para iteração e redefina o deslocamento para o início do texto. |
| TertiaryOrder(Int32) |
Retornar a ordem terciária do elemento de ordenação especificado, i. |
| ToArray<T>() |
Cria uma matriz gerenciada com base nesse wrapper de matriz Java. (Herdado de Object) |
| ToString() |
Retorna uma representação de cadeia de caracteres do objeto. (Herdado de Object) |
| 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 | Description |
|---|---|
| IJavaPeerable.Disposed() |
|
| IJavaPeerable.Finalized() |
|
| IJavaPeerable.JniObjectReferenceControlBlock |
|
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
|
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
|
| IJavaPeerable.SetPeerReference(JniObjectReference) |
|
Métodos de Extensão
| Nome | Description |
|---|---|
| GetJniTypeName(IJavaPeerable) |
Obtém o nome JNI do tipo da instância |
| JavaAs<TResult>(IJavaPeerable) |
Tente coagir a digitar |
| JavaCast<TResult>(IJavaObject) |
Executa uma conversão de tipo marcada por runtime do Android. |
| JavaCast<TResult>(IJavaObject) |
|
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
Tente coagir a digitar |