CollationKey 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 CollationKey representa um String sob as regras de um objeto específico Collator .
[Android.Runtime.Register("android/icu/text/CollationKey", ApiSince=24, DoNotGenerateAcw=true)]
public sealed class CollationKey : Java.Lang.Object, IDisposable, Java.Lang.IComparable
[<Android.Runtime.Register("android/icu/text/CollationKey", ApiSince=24, DoNotGenerateAcw=true)>]
type CollationKey = class
inherit Object
interface IComparable
interface IJavaObject
interface IDisposable
interface IJavaPeerable
- Herança
- Atributos
- Implementações
Comentários
Um CollationKey representa um String sob as regras de um objeto específico Collator . Comparar dois CollationKeys retorna a ordem relativa dos Strings que eles representam.
Como o conjunto de regras de Collators pode diferir, as ordens de classificação da mesma cadeia de caracteres em dois s diferentes Collatorpodem ser diferentes. Portanto, comparar CollationKeys gerados de s diferentes Collatorpode fornecer resultados incorretos.
O método CollationKey.compareTo(CollationKey) e o método Collator.compare(String, String) comparam duas cadeias de caracteres e retornam sua ordem relativa. As características de desempenho dessas duas abordagens podem ser diferentes. Observe que as chaves de ordenação geralmente são menos eficientes do que simplesmente fazer comparação. Para obter mais detalhes, consulte o Guia do Usuário da UTI.
Durante a construção de um CollationKey, toda a cadeia de caracteres de origem é examinada e processada em uma série de bits encerrados por um nulo, que são armazenados no CollationKey. Quando CollationKey.compareTo(CollationKey) executado, ele executa uma comparação bit a bit nas sequências de bits. Isso pode gerar custo de inicialização ao criar a CollationKeychave, mas depois que a chave é criada, as comparações binárias são rápidas. Essa abordagem é recomendada quando as mesmas cadeias de caracteres devem ser comparadas repetidamente.
Por outro lado, as implementações podem Collator.compare(String, String) examinar e processar as cadeias de caracteres somente até que os primeiros caracteres sejam diferentes em ordem. Essa abordagem é recomendada se as cadeias de caracteres devem ser comparadas apenas uma vez.
Mais informações sobre a composição da sequência de bits podem ser encontradas no guia do usuário.
O exemplo a seguir mostra como CollationKeyé possível usar para classificar uma lista de Strings.
<blockquote>
// Create an array of CollationKeys for the Strings to be sorted.
Collator myCollator = Collator.getInstance();
CollationKey[] keys = new CollationKey[3];
keys[0] = myCollator.getCollationKey("Tom");
keys[1] = myCollator.getCollationKey("Dick");
keys[2] = myCollator.getCollationKey("Harry");
sort( keys );
<br>
//...
<br>
// Inside body of sort routine, compare keys this way
if( keys[i].compareTo( keys[j] ) > 0 )
// swap keys[i] and keys[j]
<br>
//...
<br>
// Finally, when we've returned from sort.
System.out.println( keys[0].getSourceString() );
System.out.println( keys[1].getSourceString() );
System.out.println( keys[2].getSourceString() );
</blockquote>
Essa classe não é subclassável
Java documentação para android.icu.text.CollationKey.
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 | Description |
|---|---|
| CollationKey(String, Byte[]) |
Construtor CollationKey. |
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 |
Um |
| JniPeerMembers |
Um |
| PeerReference |
Obtém a referência de objeto JNI para este par Java. (Herdado de Object) |
| SourceString |
Retorne a cadeia de caracteres de origem que essa CollationKey representa. |
| 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) |
| CompareTo(CollationKey) |
Compare essa CollationKey com outra CollationKey. |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
Um |
| 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() |
Um |
| Equals(CollationKey) |
Compare essa CollationKey e o argumento de destino CollationKey quanto à igualdade. |
| Equals(Object) |
Um |
| Equals(Object) |
Indica se algum outro objeto é "igual a" este. (Herdado de Object) |
| GetBound(Int32, Int32) |
Produz um limite para a ordem de classificação de uma determinada chave de ordenação e um nível de força. |
| GetHashCode() |
Retorna um valor de código hash para o objeto. (Herdado de Object) |
| 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) |
| Merge(CollationKey) |
Mescla essa CollationKey com outra. |
| 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) |
Um |
| ToArray<T>() |
Cria uma matriz gerenciada com base nesse wrapper de matriz Java. (Herdado de Object) |
| ToByteArray() |
Duplica e retorna o valor desse CollationKey como uma sequência de bytes big-endian encerrados por um nulo. |
| 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 |
|---|---|
| IComparable.CompareTo(Object) |
Um |
| IJavaPeerable.Disposed() |
Um |
| IJavaPeerable.Finalized() |
Um |
| IJavaPeerable.JniObjectReferenceControlBlock |
Um |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
Um |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
Um |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
Um |
| IJavaPeerable.UnregisterFromRuntime() |
Um |
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) |
Um |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
Tente coagir a digitar |