fiji.util
Interface List

All Superinterfaces:
Collection
All Known Implementing Classes:
ArrayList, LinkedList

public interface List
extends Collection

Una List è una sequenza di elementi, a cui è consentito anche un accesso posizionale. Il primo elemento (ovvero, quello di indice 0) è chiamato testa della lista. L'ultimo elemento è chiamato coda della lista.


Method Summary
 void add(int index, java.lang.Object obj)
          Inserisce in questa lista l'elemento obj nella posizione index (opzionale).
 boolean add(java.lang.Object obj)
          Inserisce l'elemento obj come ultimo elemento di questa lista (opzionale).
 boolean addAll(Collection c)
          Inserisce nella coda di questa lista tutti gli elementi contenuti nella collezione c (opzionale).
 boolean addAll(int index, Collection c)
          Inserisce in questa lista tutti gli elementi contenuti nella collezione c, a partire dalla posizione index (opzionale).
 void clear()
          Rimuove da questa lista tutti gli elementi (opzionale).
 boolean contains(java.lang.Object obj)
          Verifica se questa lista contiene (almeno) un elemento uguale a obj.
 boolean containsAll(Collection c)
          Verifica se questa lista contiene tutti gli elementi contenuti nella collezione c.
 boolean equals(java.lang.Object obj)
          Verifica se questa lista è uguale all'oggetto obj.
 java.lang.Object get(int index)
          Restituisce l'elemento di questa lista di posizione index.
 int indexOf(java.lang.Object obj)
          Calcola l'indice del primo elemento di questa lista uguale a obj, oppure -1 se la lista non contiene nessun elemento uguale a obj.
 boolean isEmpty()
          Verifica se questa lista è vuota.
 java.util.Iterator iterator()
          Restituisce un iteratore sugli elementi di questa lista, dal primo elemento all'ultimo.
 int lastIndexOf(java.lang.Object obj)
          Calcola l'indice dell'ultimo elemento di questa lista uguale a obj, oppure -1 se la lista non contiene nessun elemento uguale a obj.
 java.lang.Object remove(int index)
          Rimuove da questa lista l'elemento di posizione index, restituendo tale elemento (opzionale).
 boolean remove(java.lang.Object obj)
          Rimuove da questa lista il primo elemento uguale a obj (ovvero, il più vicino alla testa della lista), se presente (opzionale).
 boolean removeAll(Collection c)
          Rimuove da questa lista tutti gli elementi contenuti nella collezione c (opzionale).
 boolean retainAll(Collection c)
          Rimuove da questa lista tutti gli elementi che non sono contenuti nella collezione c (opzionale).
 java.lang.Object set(int index, java.lang.Object obj)
          Sostituisce l'elemento di questa lista di posizione index con obj, e restituisce l'elemento che precedentemente occupava la posizione index (opzionale).
 int size()
          Calcola la lunghezza di questa lista.
 java.lang.Object[] toArray()
          Restituisce un array che contiene tutti gli elementi di questa lista, ciascuno nella posizione in cui compare nella lista.
 

Method Detail

size

public int size()
Calcola la lunghezza di questa lista.

Specified by:
size in interface Collection

isEmpty

public boolean isEmpty()
Verifica se questa lista è vuota.

Specified by:
isEmpty in interface Collection

contains

public boolean contains(java.lang.Object obj)
Verifica se questa lista contiene (almeno) un elemento uguale a obj. Più precisamente, se obj è null verifica se questa lista contiene un elemento null, altrimenti verifica se contiene un elemento uguale a obj.

Specified by:
contains in interface Collection

add

public boolean add(java.lang.Object obj)
Inserisce l'elemento obj come ultimo elemento di questa lista (opzionale). Restituisce true se l'elemento obj è stato effettivamente inserito nella lista.

Specified by:
add in interface Collection

remove

public boolean remove(java.lang.Object obj)
Rimuove da questa lista il primo elemento uguale a obj (ovvero, il più vicino alla testa della lista), se presente (opzionale). Restituisce true se un elemento uguale a obj è stato effettivamente rimosso dalla lista.

Specified by:
remove in interface Collection

iterator

public java.util.Iterator iterator()
Restituisce un iteratore sugli elementi di questa lista, dal primo elemento all'ultimo.

Specified by:
iterator in interface Collection

containsAll

public boolean containsAll(Collection c)
Verifica se questa lista contiene tutti gli elementi contenuti nella collezione c.

Specified by:
containsAll in interface Collection

addAll

public boolean addAll(Collection c)
Inserisce nella coda di questa lista tutti gli elementi contenuti nella collezione c (opzionale). L'inserimento avviene nell'ordine in cui gli elementi di c vengono visitati dal suo iteratore. Restituisce true questa lista è stata modificata dall'inserimento.

Specified by:
addAll in interface Collection

removeAll

public boolean removeAll(Collection c)
Rimuove da questa lista tutti gli elementi contenuti nella collezione c (opzionale). Restituisce true questa lista è stata modificata dall'operazione di rimozione.

Specified by:
removeAll in interface Collection

retainAll

public boolean retainAll(Collection c)
Rimuove da questa lista tutti gli elementi che non sono contenuti nella collezione c (opzionale). Restituisce true questa lista è stata modificata dall'operazione di rimozione.

Specified by:
retainAll in interface Collection

clear

public void clear()
Rimuove da questa lista tutti gli elementi (opzionale).

Specified by:
clear in interface Collection

toArray

public java.lang.Object[] toArray()
Restituisce un array che contiene tutti gli elementi di questa lista, ciascuno nella posizione in cui compare nella lista.

Specified by:
toArray in interface Collection

equals

public boolean equals(java.lang.Object obj)
Verifica se questa lista è uguale all'oggetto obj. Più precisamente, restituisce true se anche obj è una lista e le due liste sono uguali, ovvero hanno la stessa lunghezza e ogni elemento di questa lista è uguale a quello che occupa la stessa posizione in obj.

Specified by:
equals in interface Collection
Overrides:
equals in class java.lang.Object

get

public java.lang.Object get(int index)
Restituisce l'elemento di questa lista di posizione index.


set

public java.lang.Object set(int index,
                            java.lang.Object obj)
Sostituisce l'elemento di questa lista di posizione index con obj, e restituisce l'elemento che precedentemente occupava la posizione index (opzionale).


add

public void add(int index,
                java.lang.Object obj)
Inserisce in questa lista l'elemento obj nella posizione index (opzionale). Tutti gli elementi che precedentemente occupavano una posizione maggiore o uguale a index vengono spostati di una posizione verso destra.


remove

public java.lang.Object remove(int index)
Rimuove da questa lista l'elemento di posizione index, restituendo tale elemento (opzionale). Tutti gli elementi che precedentemente occupavano una posizione maggiore di index vengono spostati di una posizione verso sinistra.


addAll

public boolean addAll(int index,
                      Collection c)
Inserisce in questa lista tutti gli elementi contenuti nella collezione c, a partire dalla posizione index (opzionale). L'inserimento avviene nell'ordine in cui gli elementi di c vengono visitati dal suo iteratore. Restituisce true questa lista è stata modificata dall'inserimento.


indexOf

public int indexOf(java.lang.Object obj)
Calcola l'indice del primo elemento di questa lista uguale a obj, oppure -1 se la lista non contiene nessun elemento uguale a obj.


lastIndexOf

public int lastIndexOf(java.lang.Object obj)
Calcola l'indice dell'ultimo elemento di questa lista uguale a obj, oppure -1 se la lista non contiene nessun elemento uguale a obj.