IQueue Interfaz
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Colección diseñada para contener elementos antes del procesamiento.
[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
- Implementaciones
Comentarios
Colección diseñada para contener elementos antes del procesamiento. Además de las operaciones básicas Collection , las colas proporcionan operaciones de inserción, extracción e inspección adicionales. Cada uno de estos métodos existe en dos formas: una produce una excepción si se produce un error en la operación, la otra devuelve un valor especial (ya sea null o false, dependiendo de la operación). La última forma de la operación de inserción está diseñada específicamente para su uso con implementaciones restringidas a Queue la capacidad; en la mayoría de las implementaciones, las operaciones de inserción no pueden producir errores.
<table class="striped">caption Summary of Queue methods</caption><thead><tr><td/td>><< th scope="col" style="font-weight:normal; font-style:italic">Throws exception</th th><scope="col" style="font-weight:normal; font-style:italic">Returns special value</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<>>#poll() poll()</td/td<>/tr tr><><th scope="row">Examine</th<>td<#element() element()>/td><td/td>#peek() peek()<></tr/tbody><></table>
Normalmente, las colas, pero no necesariamente, ordena los elementos de una manera FIFO (primero en salir). Entre las excepciones se encuentran las colas de prioridad, que ordenen los elementos según un comparador proporcionado, o el orden natural de los elementos, y las colas LIFO (o pilas) que ordenen los elementos LIFO (último en salir). Sea cual sea el orden utilizado, el <em>head</em> de la cola es ese elemento que se quitaría mediante una llamada a #remove() o #poll(). En una cola FIFO, todos los elementos nuevos se insertan en la <cola< em>/em> de la cola. Otros tipos de colas pueden usar reglas de selección de ubicación diferentes. Cada Queue implementación debe especificar sus propiedades de ordenación.
El #offer offer método inserta un elemento si es posible; de lo contrario, devuelve false. Esto difiere del java.util.Collection#add Collection.add método , que puede no agregar un elemento solo iniciando una excepción desactivada. El offer método está diseñado para su uso cuando el error es normal, en lugar de una aparición excepcional, por ejemplo, en capacidad fija (o " delimitado") Colas.
Los #remove() métodos y quitan #poll() y devuelven el encabezado de la cola. Exactamente qué elemento se quita de la cola es una función de la directiva de ordenación de la cola, que difiere de la implementación a la implementación. Los remove() métodos y poll() solo difieren en su comportamiento cuando la cola está vacía: el remove() método produce una excepción, mientras que el poll() método devuelve null.
Los #element() métodos y #peek() devuelven, pero no quitan, el encabezado de la cola.
La Queue interfaz no define los métodos de cola de bloqueo, que son comunes en la programación simultánea. Estos métodos, que esperan a que aparezcan elementos o que el espacio esté disponible, se definen en la java.util.concurrent.BlockingQueue interfaz , que extiende esta interfaz.
Queue Por lo general, las implementaciones no permiten la inserción de null elementos, aunque algunas implementaciones, como LinkedList, no prohíben la inserción de null. Incluso en las implementaciones que lo permiten, null no se debe insertar en , Queueya null que también se usa como un valor devuelto especial por el poll método para indicar que la cola no contiene elementos.
Queue Por lo general, las implementaciones no definen versiones basadas en elementos de métodos equals y hashCode , en su lugar, heredan las versiones basadas en identidades de la clase Object, ya que la igualdad basada en elementos no siempre está bien definida para las colas con los mismos elementos, pero propiedades de ordenación diferentes.
Agregado en 1.5.
Documentación de Java para java.util.Queue.
Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el proyecto de código abierto de Android y se usan según los términos descritos en la licencia de atribución de Creative Commons 2.5.
Propiedades
| Handle |
Obtiene el valor JNI del objeto Android subyacente. (Heredado de IJavaObject) |
| IsEmpty |
Devuelve si no |
| JniIdentityHashCode |
Devuelve el valor de |
| JniManagedPeerState |
Estado del mismo nivel administrado. (Heredado de IJavaPeerable) |
| JniPeerMembers |
Compatibilidad con la invocación y el acceso de miembros. (Heredado de IJavaPeerable) |
| PeerReference |
Devuelve una JniObjectReference de la instancia de objeto Java ajustada. (Heredado de IJavaPeerable) |
Métodos
| Add(Object) |
Inserta el elemento especificado en esta cola si es posible hacerlo inmediatamente sin infringir las restricciones de capacidad, volviendo |
| AddAll(ICollection) |
Agrega todos los elementos de la colección especificada a esta colección (operación opcional). (Heredado de ICollection) |
| Clear() |
Quita todos los elementos de esta colección (operación opcional). (Heredado de ICollection) |
| Contains(Object) |
Devuelve |
| ContainsAll(ICollection) |
Devuelve |
| Disposed() |
Se llama cuando se ha eliminado la instancia. (Heredado de IJavaPeerable) |
| DisposeUnlessReferenced() |
Si no hay referencias pendientes a esta instancia, llama a |
| Element() |
Recupera, pero no quita, el encabezado de esta cola. |
| Equals(Object) |
Compara el objeto especificado con esta colección para obtener igualdad. (Heredado de ICollection) |
| Finalized() |
Se llama cuando se ha finalizado la instancia. (Heredado de IJavaPeerable) |
| ForEach(IConsumer) |
Realiza la acción dada para cada elemento de |
| GetHashCode() |
Devuelve el valor de código hash de esta colección. (Heredado de ICollection) |
| Iterator() |
Devuelve un iterador sobre los elementos de esta colección. (Heredado de ICollection) |
| Offer(Object) |
Inserta el elemento especificado en esta cola si es posible hacerlo inmediatamente sin infringir las restricciones de capacidad. |
| Peek() |
Recupera, pero no quita, el encabezado de esta cola o devuelve |
| Poll() |
Recupera y quita el encabezado de esta cola o devuelve |
| Remove() |
Recupera y quita el encabezado de esta cola. |
| Remove(Object) |
Quita una sola instancia del elemento especificado de esta colección, si está presente (operación opcional). (Heredado de ICollection) |
| RemoveAll(ICollection) |
Quita todos los elementos de esta colección que también están incluidos en la colección especificada (operación opcional). (Heredado de ICollection) |
| RemoveIf(IPredicate) |
Quita todos los elementos de esta colección que satisfacen el predicado especificado. (Heredado de ICollection) |
| RetainAll(ICollection) |
Conserva solo los elementos de esta colección que se encuentran en la colección especificada (operación opcional). (Heredado de ICollection) |
| SetJniIdentityHashCode(Int32) |
Establezca el valor devuelto por |
| SetJniManagedPeerState(JniManagedPeerStates) |
Colección diseñada para contener elementos antes del procesamiento. (Heredado de IJavaPeerable) |
| SetPeerReference(JniObjectReference) |
Establezca el valor devuelto por |
| Size() |
Devuelve el número de elementos de esta colección. (Heredado de ICollection) |
| Spliterator() |
Crea un |
| ToArray() |
Devuelve una matriz que contiene todos los elementos de esta colección. (Heredado de ICollection) |
| ToArray(IIntFunction) |
Devuelve una matriz que contiene todos los elementos de esta colección, utilizando la función proporcionada |
| ToArray(Object[]) |
Devuelve una matriz que contiene todos los elementos de esta colección; el tipo en tiempo de ejecución de la matriz devuelta es el de la matriz especificada. (Heredado de ICollection) |
| UnregisterFromRuntime() |
Anule el registro de esta instancia para que el entorno de ejecución no lo devuelva de invocaciones futuras Java.Interop.JniRuntime+JniValueManager.PeekValue . (Heredado de IJavaPeerable) |
Implementaciones de interfaz explícitas
| IIterable.Spliterator() |
Crea un elemento |
Métodos de extensión
| JavaCast<TResult>(IJavaObject) |
Realiza una conversión de tipos comprobados en tiempo de ejecución de Android. |
| JavaCast<TResult>(IJavaObject) |
Colección diseñada para contener elementos antes del procesamiento. |
| GetJniTypeName(IJavaPeerable) |
Colección diseñada para contener elementos antes del procesamiento. |
| ToEnumerable(IIterable) |
Colección diseñada para contener elementos antes del procesamiento. |
| ToEnumerable<T>(IIterable) |
Colección diseñada para contener elementos antes del procesamiento. |