Colección de datos del mismo tipo ordenados por un índice para cada valor, con T pudiendo tomar cualquier tipo. Los índices válidos de una colección van desde 0 hasta ‘size()’ – 1. El intento de acceso a un índice incorrecto lanza una excepción.

METODOS PUBLICOS

Integer size()

Devuelve la cantidad total de elementos en la colección.

Retorna
Integer Cantidad de elementos.

T get(Integer índice)

Recorre la colección y retorna una referencia al elemento en el índice indicado. La colección y su tamaño no son modificados.

Argumentos
índice Integer: posición de elemento deseado.
Retorna
T Elemento.
Excepciones
IndexOutOfBound – Error trying to access an element in a out of bound index. Index value: índice, collection size: tamaño. Se intento retirar un objeto en una colección vacia.

void remove(Integer índice)

Recorre la colección y elimina el elemento en el índice indicado. Luego de remover el elemento el tamaño de la colección disminuye en uno.

Argumentos
índice Integer: índice que se desea remover.
Excepciones
IndexOutOfBound – Error trying to access an element in a out of bound index. Index value: índice, collection size: tamaño. Se intento retirar un objeto en una colección vacia.

T pop()

Remueve y devuelve el último elemento de la colección. El tamaño de la colección disminuye en uno y el elemento retirado de la misma es devuelto.

Retorna
T Elemento retirado de la colección.
Excepciones
IndexOutOfBound – Error trying to access an element in a out of bound index. Index value: índice, collection size: tamaño. Se intento retirar un objeto en una coleccion vacia.

Array<T> selected()

Devuelve un Array con los índices correspondientes a los elementos seleccionados de la colección. Pueden haber sido seleccionados programáticamente usando el método ‘setSelected’ o, en el caso que el Array pertenezca a un layout (como resultado de haber usado el modificador as List) a través de un tap del usuario en la lista. Si no se encuentra seleccionado ningún elemento la lista que se retorna estará vacía.

Retorna
Array<T> Elementos seleccionados de la colección.

void setSelected(Array<Integer> índices)

Marca como seleccionado uno o mas elementos de la coleccion.

Argumentos
índices Array<T> elementos seleccionados de la colección.

T shift()

Remueve y devuelve el primer elemento de la colección. El tamaño de la colección disminuye en uno.

Retorna
T Primer elemento de la colección.
Excepciones
IndexOutOfBound – Error trying to access an element in a out of bound index. Index value: índice, collection size: tamaño. Se intento retirar un objeto en una coleccion vacia.

void reverse()

Invierte el orden de los elementos de la lista.

void sort()

Compara todos los elementos de la lista y los ordena de menor a mayor. Los elementos con valor nulo de la lista se ordenan al final de la misma. Si T no es un tipo comparable se mantendrá el orden de la colección..

void removeAll()

Elimina todos los elementos de la lista, el tamaño de la lista queda en cero.

Array<T> clone()

Crea una nueva instancia de un array con misma cantidad de elementos, cada uno de sus elementos son nuevas referencias a copias fieles de los objetos del array original.

Retorna
Array<T> Nueva instancia con contenido idéntico al array original.

Integer indexOf(T elemento)

Recorre la lista y devuelve la posición de la primer ocurrencia del elemento parámetro. Si el elemento no se encuentra en la lista retorna el valor -1.

Argumentos
elemento T: elemento a buscar. Puede ser ‘null’
Retorna
Integer índice del elemento.
Excepciones
TypeMismatchInAddInCollection – Type mismatch adding an element value of different type in a collection. El elemento que se desea agregar no es del tipo T de la colección.

void add(T elemento)

Agrega el elemento parámetro al final de la colección. El tamaño de la colección aumenta en uno.

Argumentos
elemento T: elemento a agregar. Puede ser ‘null’
Excepciones
TypeMismatchInAddInCollection – Type mismatch adding an element value of different type in a collection. El elemento que se desea agregar no es del tipo T de la colección.

void set(Integer índice, T elemento)

Reemplaza el elemento de la colección que se encuentra en el índice parámetro por el elemento parámetro. Si el índice no existe lanzará una excepción.

Argumentos
índice Integer: índice de reemplazo.
elemento T: elemento de reemplazo.
Excepciones
TypeMismatchInAddInCollection – Type mismatch adding an element value of different type in a collection. El elemento que se desea agregar no es del tipo T de la colección.
IndexOutOfBound – Error trying to access an element in a out of bound index. Index value: índice, collection size: tamaño. Se intento retirar un objeto en una coleccion vacia.

Integer push(T elemento)

Inserta el elemento parámetro al final de la lista, el tamaño de la lista crece en uno.

Argumentos
elemento T: elemento a agregar.
Retorna
Integer Cantidad de elementos.
Excepciones
TypeMismatchInAddInCollection – Type mismatch adding an element value of different type in a collection. El elemento que se desea agregar no es del tipo T de la colección.

Integer unshift(T elemento)

Inserta el elemento parámetro en la primera posición de la colección, el tamaño de la misma crece en uno y se retorna el nuevo tamaño.

Argumentos
elemento T: elemento a agregar.
Retorna
Integer tamaño de la colección.
Excepciones
TypeMismatchInAddInCollection – Type mismatch adding an element value of different type in a collection. El elemento que se desea agregar no es del tipo T de la colección.

Array<T> concat(Array<T> coleccion)

Crea y retorna una nueva colección que tiene los elementos de la instancia, agregando al final los de la coleccion coleccion del argumento. Si la colección argumento no es de tipo compatible lanza excepción.

Argumentos
elemento T: elemento a agregar.
Retorna
Array<T> nueva la colección.
Excepciones
WrongTypeOfArgumentsInCall – Wrong 1st argument type. Required: ‘%@’ in call of method ‘concat’. El argumento con el que fue llamada la función no es del tipo esperado.