IQueue Interface
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.
Uma coleção projetada para armazenar elementos antes do processamento.
[Android.Runtime.Register("java/util/Queue", "", "Java.Util.IQueueInvoker")]
[Java.Interop.JavaTypeParameters(new System.String[] { "E" })]
public interface IQueue : IDisposable, Java.Interop.IJavaPeerable, Java.Util.ICollection[<Android.Runtime.Register("java/util/Queue", "", "Java.Util.IQueueInvoker")>]
[<Java.Interop.JavaTypeParameters(new System.String[] { "E" })>]
type IQueue = interface
interface ICollection
interface IIterable
interface IJavaObject
interface IDisposable
interface IJavaPeerable- Derivado
- Atributos
- Implementações
Comentários
Uma coleção projetada para armazenar elementos antes do processamento. Além das operações básicas Collection , as filas fornecem operações adicionais de inserção, extração e inspeção. Cada um desses métodos existe em duas formas: um lança uma exceção se a operação falhar, o outro retorna um valor especial (ou nullfalse, dependendo da operação). A última forma da operação de inserção é projetada especificamente para uso com implementações de capacidade restrita Queue , na maioria das implementações, as operações de inserção não podem falhar.
<table class="striped">caption Resumo dos métodos< de fila/caption<>thead><tr<>td></td<>th scope="col" style="font-weight:normal; font-style:italic">Lança exception</th<>th scope="col" style="font-weight:normal; font-style:italic">Retorna valor< especial/th<>/tr></thead tbody<>><tr<>th scope="row">Insert</th<>><td>#add(Object) add(e)</td><td>#offer(Object) offer(e)</td></tr><tr th><scope="row">Remove</th<>td<>#remove() remove()/td<>td#poll() poll()<>/td<>/tr><tr><th scope="row">Examine</th><td><#element() element()/td><td<#peek() peek()>/td<>/tr/tbody><></table>
As filas normalmente, mas não necessariamente, ordenam elementos de maneira FIFO (first-in-first-out). Entre as exceções estão as filas de prioridade, que ordenam os elementos de acordo com um comparador fornecido, ou a ordenação natural dos elementos, e as filas LIFO (ou pilhas) que ordenam os elementos LIFO (last-in-first-out). Seja qual for a ordem usada, o em head/em> da fila é aquele elemento que seria removido por uma chamada para #remove() ou #poll().<>< Em uma fila FIFO, todos os novos elementos são inseridos <no emtail></em> da fila. Outros tipos de filas podem usar regras de posicionamento diferentes. Cada Queue implementação deve especificar suas propriedades de ordenação.
O #offer offer método insere um elemento se possível, caso contrário, retornando false. Isso difere do java.util.Collection#add Collection.add método, que pode falhar ao adicionar um elemento somente lançando uma exceção não verificada. O offer método é projetado para uso quando a falha é uma ocorrência normal, em vez de excepcional, por exemplo, em capacidade fixa (ou " limitado") Filas.
Os #remove() métodos e #poll() removem e retornam o cabeçalho da fila. Exatamente qual elemento é removido da fila é uma função da política de ordenação da fila, que difere de implementação para implementação. Os remove() métodos e poll() diferem apenas em seu comportamento quando a fila está vazia: o remove() método lança uma exceção, enquanto o poll() método retorna null.
Os #element() métodos e #peek() retornam, mas não removem, o chefe da fila.
A Queue interface não define os métodos de fila de bloqueio, que são comuns na programação simultânea. Esses métodos, que aguardam que os elementos apareçam ou que o espaço fique disponível, são definidos na java.util.concurrent.BlockingQueue interface, o que estende essa interface.
Queue implementações geralmente não permitem a inserção de null elementos, embora algumas implementações, como LinkedList, não proíbam a inserção de null. Mesmo nas implementações que permitem isso, null não deve ser inserido em um Queue, como null também é usado como um valor de retorno especial pelo poll método para indicar que a fila não contém elementos.
Queue As implementações geralmente não definem versões baseadas em elementos de métodos equals e hashCode , em vez disso, herdam as versões baseadas em identidade da classe Object, porque a igualdade baseada em elemento nem sempre é bem definida para filas com os mesmos elementos, mas propriedades de ordenação diferentes.
Adicionado em 1.5.
Documentação Java para java.util.Queue.
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
| Handle |
Obtém o valor JNI do objeto Android subjacente. (Herdado de IJavaObject) |
| IsEmpty |
Retorna se isso |
| JniIdentityHashCode |
Retorna o valor de |
| JniManagedPeerState |
Estado do par gerenciado. (Herdado de IJavaPeerable) |
| JniPeerMembers |
Acesso de membros e suporte à invocação. (Herdado de IJavaPeerable) |
| PeerReference |
Retorna uma JniObjectReference das instâncias do objeto Java encapsulado. (Herdado de IJavaPeerable) |
Métodos
| Add(Object) |
Insere o elemento especificado nessa fila se for possível fazê-lo imediatamente sem violar as restrições de capacidade, retornando |
| AddAll(ICollection) |
Adiciona todos os elementos na coleção especificada a essa coleção (operação opcional). (Herdado de ICollection) |
| Clear() |
Remove todos os elementos desta coleção (operação opcional). (Herdado de ICollection) |
| Contains(Object) |
Retorna |
| ContainsAll(ICollection) |
Retorna |
| Disposed() |
Chamado quando a instância tiver sido descartada. (Herdado de IJavaPeerable) |
| DisposeUnlessReferenced() |
Se não houver referências pendentes a este caso, então chame |
| Element() |
Recupera, mas não remove, o cabeçalho dessa fila. |
| Equals(Object) |
Compara o objeto especificado com esta coleção para igualdade. (Herdado de ICollection) |
| Finalized() |
Chamado quando a instância tiver sido finalizada. (Herdado de IJavaPeerable) |
| ForEach(IConsumer) |
Executa a ação fornecida para cada elemento do |
| GetHashCode() |
Retorna o valor do código hash para esta coleção. (Herdado de ICollection) |
| Iterator() |
Retorna um iterador sobre os elementos nesta coleção. (Herdado de ICollection) |
| Offer(Object) |
Insere o elemento especificado nessa fila se for possível fazê-lo imediatamente sem violar as restrições de capacidade. |
| Peek() |
Recupera, mas não remove, o cabeçalho dessa fila ou retorna |
| Poll() |
Recupera e remove o cabeçalho dessa fila ou retorna |
| Remove() |
Recupera e remove o cabeçalho dessa fila. |
| Remove(Object) |
Remove uma única instância do elemento especificado dessa coleção, se ela estiver presente (operação opcional). (Herdado de ICollection) |
| RemoveAll(ICollection) |
Remove todos os elementos desta coleção que também estão contidos na coleção especificada (operação opcional). (Herdado de ICollection) |
| RemoveIf(IPredicate) |
Remove todos os elementos desta coleção que satisfazem o predicado fornecido. (Herdado de ICollection) |
| RetainAll(ICollection) |
Retém apenas os elementos nesta coleção que estão contidos na coleção especificada (operação opcional). (Herdado de ICollection) |
| SetJniIdentityHashCode(Int32) |
Defina o valor retornado por |
| SetJniManagedPeerState(JniManagedPeerStates) |
Uma coleção projetada para armazenar elementos antes do processamento. (Herdado de IJavaPeerable) |
| SetPeerReference(JniObjectReference) |
Defina o valor retornado por |
| Size() |
Retorna o número de elementos nesta coleção. (Herdado de ICollection) |
| Spliterator() |
Cria um |
| ToArray() |
Retorna uma matriz que contém todos os elementos desta coleção. (Herdado de ICollection) |
| ToArray(IIntFunction) |
Retorna uma matriz que contém todos os elementos nesta coleção, usando a função fornecida |
| ToArray(Object[]) |
Retorna uma matriz contendo todos os elementos nesta coleção; O tipo de tempo de execução da matriz retornada é o da matriz especificada. (Herdado de ICollection) |
| UnregisterFromRuntime() |
Cancele o registro dessa instância para que o tempo de execução não a retorne de chamadas futuras Java.Interop.JniRuntime+JniValueManager.PeekValue . (Herdado de IJavaPeerable) |
Implantações explícitas de interface
| IIterable.Spliterator() |
Cria um |
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) |
Uma coleção projetada para armazenar elementos antes do processamento. |
| GetJniTypeName(IJavaPeerable) |
Uma coleção projetada para armazenar elementos antes do processamento. |
| ToEnumerable(IIterable) |
Uma coleção projetada para armazenar elementos antes do processamento. |
| ToEnumerable<T>(IIterable) |
Uma coleção projetada para armazenar elementos antes do processamento. |