public interface List extends Collection
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.Modifier and Type | Method and Description |
---|---|
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.
|
int size()
size
in interface Collection
boolean isEmpty()
isEmpty
in interface Collection
boolean contains(java.lang.Object obj)
obj
.
Più precisamente, se obj
è null
verifica se questa lista contiene un elemento
null
, altrimenti verifica se contiene
un elemento uguale a obj
.contains
in interface Collection
boolean add(java.lang.Object obj)
obj
come ultimo elemento di questa lista (opzionale).
Restituisce true
se l'elemento obj
è stato effettivamente inserito nella lista.add
in interface Collection
boolean remove(java.lang.Object obj)
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.remove
in interface Collection
java.util.Iterator iterator()
iterator
in interface Collection
boolean containsAll(Collection c)
c
.containsAll
in interface Collection
boolean addAll(Collection c)
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.addAll
in interface Collection
boolean removeAll(Collection c)
c
(opzionale).
Restituisce true
questa lista
è stata modificata dall'operazione di rimozione.removeAll
in interface Collection
boolean retainAll(Collection c)
c
(opzionale).
Restituisce true
questa lista
è stata modificata dall'operazione di rimozione.retainAll
in interface Collection
void clear()
clear
in interface Collection
java.lang.Object[] toArray()
toArray
in interface Collection
boolean equals(java.lang.Object obj)
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
.equals
in interface Collection
equals
in class java.lang.Object
java.lang.Object get(int index)
index
.java.lang.Object set(int index, java.lang.Object obj)
index
con obj
,
e restituisce l'elemento che precedentemente
occupava la posizione index
(opzionale).void add(int index, java.lang.Object obj)
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.java.lang.Object remove(int index)
index
,
restituendo tale elemento (opzionale).
Tutti gli elementi che precedentemente occupavano
una posizione maggiore di index
vengono spostati di una posizione verso sinistra.boolean addAll(int index, Collection c)
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.int indexOf(java.lang.Object obj)
obj
,
oppure -1
se la lista non contiene
nessun elemento uguale a obj
.int lastIndexOf(java.lang.Object obj)
obj
,
oppure -1
se la lista non contiene
nessun elemento uguale a obj
.