ArrayList Clase
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í.
Implementación de matriz redimensionable de la List interfaz.
[Android.Runtime.Register("java/util/ArrayList", DoNotGenerateAcw=true)]
[Java.Interop.JavaTypeParameters(new System.String[] { "E" })]
public class ArrayList : Java.Util.AbstractList, IDisposable, Java.IO.ISerializable, Java.Lang.ICloneable, Java.Util.IRandomAccess
[<Android.Runtime.Register("java/util/ArrayList", DoNotGenerateAcw=true)>]
[<Java.Interop.JavaTypeParameters(new System.String[] { "E" })>]
type ArrayList = class
inherit AbstractList
interface ISerializable
interface IJavaObject
interface IDisposable
interface IJavaPeerable
interface ICloneable
interface IList
interface ICollection
interface IIterable
interface ISequencedCollection
interface IRandomAccess
- Herencia
- Atributos
- Implementaciones
Comentarios
Implementación de matriz redimensionable de la List interfaz. Implementa todas las operaciones de lista opcionales y permite todos los elementos, incluido null. Además de implementar la List interfaz, esta clase proporciona métodos para manipular el tamaño de la matriz que se usa internamente para almacenar la lista. (Esta clase es aproximadamente equivalente a Vector, excepto que no está sincronizada).
Las sizeoperaciones , isEmpty, get, set, iteratory listIterator se ejecutan en tiempo constante. La add operación se ejecuta en tiempo constante amortizado, es decir, agregar n elementos requiere tiempo de O(n). Todas las demás operaciones se ejecutan en tiempo lineal (aproximadamente hablando). El factor constante es bajo en comparación con el de la LinkedList implementación.
Cada ArrayList instancia tiene una capacidad. La capacidad es el tamaño de la matriz utilizada para almacenar los elementos de la lista. Siempre es tan grande como el tamaño de la lista. A medida que se agregan elementos a arrayList, su capacidad crece automáticamente. Los detalles de la directiva de crecimiento no se especifican más allá del hecho de que agregar un elemento tiene un costo de tiempo amortizado constante.
Una aplicación puede aumentar la capacidad de una ArrayList instancia antes de agregar un gran número de elementos mediante la ensureCapacity operación. Esto puede reducir la cantidad de reasignación incremental.
<fuerte>Tenga en cuenta que esta implementación no está sincronizada.</strong> Si varios subprocesos acceden a una ArrayList instancia simultáneamente y al menos uno de los subprocesos modifica la lista estructuralmente, debe sincronizarse externamente. (Una modificación estructural es cualquier operación que agrega o elimina uno o varios elementos, o cambia explícitamente el tamaño de la matriz de respaldo; simplemente establecer el valor de un elemento no es una modificación estructural). Esto se logra normalmente mediante la sincronización en algún objeto que encapsula naturalmente la lista.
Si no existe este objeto, la lista debe "encapsularse" mediante el Collections#synchronizedList Collections.synchronizedList método . Esto se hace mejor en el momento de la creación, para evitar el acceso no asincrónico accidental a la lista:
List list = Collections.synchronizedList(new ArrayList(...));
Los iteradores devueltos por los métodos y de #iterator() iterator esta clase son #listIterator(int) listIteratorem<fail-fast>/em<: si la lista se modifica estructuralmente en cualquier momento después de crear el iterador, excepto a través de los métodos o > propios ListIterator#remove() remove del iterador, el iterador producirá un ListIterator#add(Object) add.ConcurrentModificationException Por lo tanto, en el caso de la modificación simultánea, el iterador produce un error rápido y limpio, en lugar de arriesgarse a un comportamiento arbitrario y no determinista en un momento indeterminado en el futuro.
Tenga en cuenta que no se puede garantizar el comportamiento rápido de un iterador, ya que es, por lo general, imposible hacer ninguna garantía dura en presencia de modificaciones simultáneas no asincrónicas. Los iteradores rápidos de error inician ConcurrentModificationException el mejor esfuerzo. Por lo tanto, sería incorrecto escribir un programa que dependiera de esta excepción por su corrección: el comportamiento rápido del error de los iteradores solo se debe usar para detectar errores.
Esta clase es miembro del marco de colecciones de Java.
Agregado en la versión 1.2.
Java documentación para java.util.ArrayList.
Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el Android y se usan según los términos descritos en creative Creative Commons 2.5 Attribution License.
Constructores
| Nombre | Description |
|---|---|
| ArrayList() |
Construye una lista vacía con una capacidad inicial de diez. |
| ArrayList(ICollection) |
Construye una lista que contiene los elementos de la colección especificada, en el orden en que devuelve el iterador de la colección. |
| ArrayList(Int32) |
Construye una lista vacía con la capacidad inicial especificada. |
| ArrayList(IntPtr, JniHandleOwnership) |
Constructor utilizado al crear representaciones administradas de objetos JNI; llamado por el tiempo de ejecución. |
Propiedades
| Nombre | Description |
|---|---|
| Class |
Devuelve la clase en tiempo de ejecución de este |
| First |
Obtiene el primer elemento de esta colección. |
| Handle |
Identificador de la instancia de Android subyacente. (Heredado de Object) |
| IsEmpty |
Devuelve true si esta colección no contiene elementos. (Heredado de AbstractCollection) |
| JniIdentityHashCode |
Obtiene el código hash de identidad asignado a este Java del mismo nivel por el tiempo de ejecución de interoperabilidad. (Heredado de Object) |
| JniManagedPeerState |
Obtiene las marcas de estado asignadas por última vez por el tiempo de ejecución. (Heredado de JavaObject) |
| JniPeerMembers |
Obtiene los metadatos de JNI usados para acceder a los miembros de este enlace de Java. |
| Last |
Obtiene el último elemento de esta colección. |
| ModCount |
Número de veces que esta lista se ha modificado estructuralmente. (Heredado de AbstractList) |
| PeerReference |
Obtiene la referencia de objeto JNI para este Java del mismo nivel. (Heredado de Object) |
| ThresholdClass |
Esta API admite la infraestructura mono para Android y no está pensada para usarse directamente desde el código. |
| ThresholdType |
Esta API admite la infraestructura mono para Android y no está pensada para usarse directamente desde el código. |
Métodos
| Nombre | Description |
|---|---|
| Add(Int32, Object) |
Inserta el elemento especificado en la posición especificada de esta lista (operación opcional). (Heredado de AbstractList) |
| Add(Object) |
Garantiza que esta colección contiene el elemento especificado (operación opcional). (Heredado de AbstractCollection) |
| AddAll(ICollection) |
Agrega todos los elementos de la colección especificada a esta colección (operación opcional). (Heredado de AbstractCollection) |
| AddAll(Int32, ICollection) |
Inserta todos los elementos de la colección especificada en esta lista en la posición especificada (operación opcional). (Heredado de AbstractList) |
| AddFirst(Object) |
Agrega un elemento como primer elemento de esta colección (operación opcional). |
| AddLast(Object) |
Agrega un elemento como el último elemento de esta colección (operación opcional). |
| Clear() |
Quita todos los elementos de esta colección (operación opcional). (Heredado de AbstractCollection) |
| Clone() |
Devuelve una copia superficial de esta |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
Delega la construcción de este elemento del mismo nivel en el administrador de valores del entorno de ejecución. (Heredado de JavaObject) |
| Contains(Object) |
Devuelve true si esta colección contiene el elemento especificado. (Heredado de AbstractCollection) |
| ContainsAll(ICollection) |
Devuelve true si esta colección contiene todos los elementos de la colección especificada. (Heredado de AbstractCollection) |
| Dispose() |
Libera los recursos mantenidos por este Java del mismo nivel. (Heredado de Object) |
| Dispose(Boolean) |
Libera los recursos mantenidos por este Java del mismo nivel. (Heredado de Object) |
| DisposeUnlessReferenced() |
Pide al administrador de valores que elimine este elemento del mismo nivel a menos que su asignación conserve esta misma instancia administrada. (Heredado de JavaObject) |
| EnsureCapacity(Int32) |
Aumenta la capacidad de esta |
| Equals(Object) |
Comprueba si otro elemento del mismo nivel administrado hace referencia al mismo objeto Java. (Heredado de JavaObject) |
| Equals(Object) |
Indica si algún otro objeto es "igual a" este. (Heredado de Object) |
| ForEach(IConsumer) |
Realiza la acción dada para cada elemento de Iterable hasta que se hayan procesado todos los elementos o la acción produzca una excepción. |
| Get(Int32) |
Devuelve el elemento en la posición especificada de esta lista. |
| GetHashCode() |
Devuelve un valor de código hash para el objeto . (Heredado de Object) |
| IndexOf(Object) |
Devuelve el índice de la primera aparición del elemento especificado en esta lista, o -1 si esta lista no contiene el elemento . (Heredado de AbstractList) |
| Iterator() |
Devuelve un iterador sobre los elementos de esta lista en una secuencia adecuada. (Heredado de AbstractList) |
| JavaFinalize() |
Obsoletos.
Lo llama el recolector de elementos no utilizados en un objeto cuando la recolección de elementos no utilizados determina que no hay más referencias al objeto . (Heredado de Object) |
| LastIndexOf(Object) |
Devuelve el índice de la última aparición del elemento especificado en esta lista o -1 si esta lista no contiene el elemento . (Heredado de AbstractList) |
| ListIterator() |
Devuelve un iterador de lista sobre los elementos de esta lista (en secuencia adecuada). (Heredado de AbstractList) |
| ListIterator(Int32) |
Devuelve un iterador de lista sobre los elementos de esta lista (en secuencia adecuada), empezando por la posición especificada en la lista. (Heredado de AbstractList) |
| Notify() |
Activa un único subproceso que está esperando en el monitor de este objeto. (Heredado de Object) |
| NotifyAll() |
Activa todos los subprocesos que están esperando en el monitor de este objeto. (Heredado de Object) |
| Remove(Int32) |
Quita el elemento en la posición especificada de esta lista (operación opcional). (Heredado de AbstractList) |
| Remove(Object) |
Quita una sola instancia del elemento especificado de esta colección, si está presente (operación opcional). (Heredado de AbstractCollection) |
| 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 AbstractCollection) |
| RemoveFirst() |
Quita y devuelve el primer elemento de esta colección (operación opcional). |
| RemoveIf(IPredicate) |
Quita todos los elementos de esta colección que satisfacen el predicado especificado. |
| RemoveLast() |
Quita y devuelve el último elemento de esta colección (operación opcional). |
| RemoveRange(Int32, Int32) |
Quita de esta lista todos los elementos cuyo índice está entre |
| ReplaceAll(IUnaryOperator) |
Actualiza cada elemento con el resultado de aplicar la operación especificada a él. |
| RetainAll(ICollection) |
Conserva solo los elementos de esta colección que se encuentran en la colección especificada (operación opcional). (Heredado de AbstractCollection) |
| Set(Int32, Object) |
Reemplaza el elemento en la posición especificada de esta lista por el elemento especificado (operación opcional). (Heredado de AbstractList) |
| SetHandle(IntPtr, JniHandleOwnership) |
Establece la propiedad Handle. (Heredado de Object) |
| SetPeerReference(JniObjectReference, JniObjectReferenceOptions) |
Almacena un valor de referencia en el bloque de control sin crear una copia de referencia de JNI. (Heredado de JavaObject) |
| Size() |
Devuelve el número de elementos en esta lista. |
| Sort(IComparator) |
Ordena los elementos de esta lista con el comparador especificado. |
| Spliterator() |
Crea un <em>late-binding</em> y <em>fail-fast</em> |
| SubList(Int32, Int32) |
Devuelve una vista de la parte de esta lista entre el valor fromIndex, inclusivo y toIndex, exclusivo. (Heredado de AbstractList) |
| ToArray() |
Devuelve una matriz que contiene todos los elementos de esta colección. (Heredado de AbstractCollection) |
| 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 AbstractCollection) |
| ToArray<T>() |
Crea una matriz administrada a partir de este contenedor de matriz Java. (Heredado de Object) |
| ToString() |
Devuelve una representación de cadena del objeto . (Heredado de Object) |
| TrimToSize() |
Recorta la capacidad de esta |
| UnregisterFromRuntime() |
Anula el registro de este Java del mismo nivel del tiempo de ejecución de interoperabilidad. (Heredado de Object) |
| Wait() |
Hace que el subproceso actual espere hasta que se despierte, normalmente por ser em notificado/em< o >em<interrumpido>/em<.><> (Heredado de Object) |
| Wait(Int64, Int32) |
Hace que el subproceso actual espere hasta que se despierte, normalmente por ser <em>notificado</em> o <em>interrumpido</em>, o hasta que haya transcurrido una cierta cantidad de tiempo real. (Heredado de Object) |
| Wait(Int64) |
Hace que el subproceso actual espere hasta que se despierte, normalmente por ser <em>notificado</em> o <em>interrumpido</em>, o hasta que haya transcurrido una cierta cantidad de tiempo real. (Heredado de Object) |
Implementaciones de interfaz explícitas
| Nombre | Description |
|---|---|
| IJavaPeerable.Disposed() |
Marca este elemento del mismo nivel como eliminado y llama |
| IJavaPeerable.Finalized() |
Marca este elemento del mismo nivel como eliminado y llama |
| IJavaPeerable.JniObjectReferenceControlBlock |
Obtiene el puntero de bloque de control nativo usado por este elemento del mismo nivel. (Heredado de JavaObject) |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
Almacena el código hash de identidad proporcionado por el tiempo de ejecución. (Heredado de JavaObject) |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
Reemplaza las marcas de estado del mismo nivel administradas almacenadas. (Heredado de JavaObject) |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
Actualiza la referencia del mismo nivel y libera un bloque de control del mismo nivel eliminado cuando la referencia no es válida. (Heredado de JavaObject) |
| IJavaPeerable.UnregisterFromRuntime() |
Quita esta instancia de la búsqueda de objetos Java del entorno de ejecución. |
Métodos de extensión
| Nombre | Description |
|---|---|
| GetJniTypeName(IJavaPeerable) |
Obtiene el nombre JNI del tipo de la instancia |
| JavaAs<TResult>(IJavaPeerable) |
Intente coerción |
| JavaCast<TResult>(IJavaObject) |
Realiza una conversión de tipos comprobados en tiempo de ejecución de Android. |
| JavaCast<TResult>(IJavaObject) |
Reutiliza un par administrado compatible o obtiene un contenedor del tipo solicitado. |
| ToEnumerable(IIterable) |
Devuelve un IEnumerable objeto que recorre en iteración una Java IIterable, lo que permite |
| ToEnumerable<T>(IIterable) |
Devuelve un IEnumerable<T> objeto que recorre en iteración un Java IIterable, serializar cada elemento en |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
Intente coerción |