L'interface List représente une collection ordonnée, également connue sous le terme de séquence.
L'utilisateur de cette interface a un contrôe précis sur la position sur laquelle chaque élément sera inséré.
L'interface List étend l'interface racine Collection. Elle est implémentée par les classes AbstractList, ArrayList, LinkedList, et Vector.
A l'image des tableaux, il est possible d'accéder aux éléments d'une liste par l'intermédiaire d'un index. La recherche s'effectue de la même façon.
Les listes peuvent contenir des éléments dupliqués, ainsi que des valeurs null. Bien qu'il soit possible d'implémenter une liste n'acceptant pas les doublons, cela est fortement déconseillé.
Les implémentations de l'inteface Set peuvent ajouter des restrictions supplémentaires surr les éléments qu'ils peuvent contenir, telles qu'interdire les éléments null ou de certains types. Dans le cas ou des tentatives d'ajouter des éléments inéligibles seraient pratiquées, des exceptions contrôlées pourraient être levées, à l'image d'un NullPointerException ou d'un ClassCastException. En outre, les opérations sur un élément inéligible, telles qu'une vérification de présence, peuvent provoquer un comportement différent selon les implémentations comme la levée d'une exception ou un échec normal de l'opération (retour d'un booléen false).
| Les méthodes |
|---|
| void add(int index, Object element) |
| insère un objet à l'index spécifié, au sein de la liste courante. |
| boolean add(Object o) |
| ajoute l'élément spécifié à la fin de la liste en cours. |
| boolean addAll(Collection c) |
| ajoute tous les éléments de la collection spécifiée à la fin de la liste, selon l'ordre imposé par l'itérateur de la liste en cours. |
| boolean addAll(int index, Collection c) |
| insère tous les éléments de la collection spécifiée, à l'index donné au sein de la liste. |
| void clear() |
| supprime tous les éléments de la liste courante. |
| boolean contains(Object o) |
| retourne true si la liste contient l'élément spécifié. |
| boolean containsAll(Collection c) |
| retourne true si la liste contient tous les éléments de la collection spécifiée. |
| boolean equals(Object o) |
| teste l'égalité entre la liste et l'objet spécifié. |
| Object get(int index) |
| retourne l'élément à la position spécifiée dans la liste. |
| int hashCode() |
| retourne le code de hachage de la liste. |
| int indexOf(Object o) |
| retourne la position de la première occurrence de l'objet au sein de la liste courante, ou -1 s'il n'a pu être trouvé. |
| boolean isEmpty() |
| retourne true si la liste ne contient aucun élément. |
| Iterator iterator() |
| retourne un itérateur sur les éléments de la liste en cours. |
| int lastIndexOf(Object o) |
| retourne la position de la dernière occurrence de l'objet spécifié au sein de la liste, ou -1 s'il n'a pu être trouvé. |
| ListIterator listIterator() |
| retourne un itérateur de liste sur les éléments de l'objet List. |
| ListIterator listIterator(int index) |
| retourne un itérateur de liste sur les éléments de l'objet List à partir de la position spécifiée. |
| Object remove(int index) |
| supprime l'élément positionné à l'index spécifié au sein de la liste. |
| boolean remove(Object o) |
| supprime la première occurrence de l'élément spécifié au sein de la liste. |
| boolean removeAll(Collection c) |
| supprime tous les éléments de la collection spécifiée, au sein de la liste, s'ils sont présents. |
| boolean retainAll(Collection c) |
| retient seulement les éléments de la liste qui ne sont pas contenus dans la collection spécifiée. |
| Object set(int index, Object element) |
| remplace l'élément à la position spécifiée dans la liste, par l'objet passé en argument. |
| int size() |
| retourne le nombre d'éléments contenus dans la liste. |
| List subList(int fromIndex, int toIndex) |
| retourne une partie de la liste, délimitée par les index fromIndex inclus et toIndex exclus. |
| Object[] toArray() |
| retourne un tableau contenant tous les éléments de la liste courante. |
| Object[] toArray(Object[] a) |
| retourne un tableau contenant tous les éléments de la liste courante. Le type d'exécution du tableau retourné est celui du tableau spécifié. |