Interface IListeNumTel


public interface IListeNumTel

Représente une liste de numéros de téléphone (objets NumTel). La liste contient au moins un numéro (pas de liste vide). Les numéros peuvent être accédés au travers de leur position (index) dans la liste. Les index allant de 0 à n - 1, où n est le nombre de numéros de téléphones présents dans la liste.

See Also:
NumTel

Method Summary
 boolean ajouter(int index, NumTel num)
          ajoute un numéro à une position donnée dans la liste, sans effet si le numéro est déjà présent dans la liste.
 boolean ajouterDebut(NumTel num)
          ajoute un numéro au début de la liste, sans effet si le numéro est déjà présent dans la liste.
 boolean ajouterFin(NumTel num)
          ajoute un numéro à la fin de la liste, sans effet si le numéro est déjà présent dans la liste.
 boolean contientNumero(int num)
          Teste la présence d'un numéro dans la liste.
 java.util.Iterator iterator()
          Renvoie un itérateur sur les numéros de téléphone contenus dans la liste.
 int nbNumeros()
          retourne le nombre de numéros de la liste (>=1).
 NumTel numero(int index)
          retourne le ième numéro de la liste.
 NumTel premierNumero()
          retourne le premier numéro de la liste (il existe forcément)
 boolean retirer(int num)
          Enlève un numéro de la liste, cette opération n'est possible que si la liste contient au moins deux numéros (nbNumero()>1).
 java.lang.String toString()
          Retourne dans une chaîne de caractères la séquence des numéros contenu dans cette liste.
 

Method Detail

ajouterFin

boolean ajouterFin(NumTel num)
ajoute un numéro à la fin de la liste, sans effet si le numéro est déjà présent dans la liste.

Parameters:
num - le numéro à ajouter
Returns:
true si le numéro a été ajouté, false si l'ajout n'a pas eu lieu car la liste contient déjà le numéro.

ajouterDebut

boolean ajouterDebut(NumTel num)
ajoute un numéro au début de la liste, sans effet si le numéro est déjà présent dans la liste.

Parameters:
num - le numéro à ajouter
Returns:
true si le numéro a été ajouté, false si l'ajout n'a pas eu lieu car la liste contient déjà le numéro.

ajouter

boolean ajouter(int index,
                NumTel num)
ajoute un numéro à une position donnée dans la liste, sans effet si le numéro est déjà présent dans la liste.

Parameters:
int - index la position d'insertion dans la liste
num - le numéro à ajouter
Returns:
true si le numéro a été ajouté, false si l'ajout n'a pas eu lieu car la liste contient déjà le numéro.
Throws:
java.lang.IndexOutOfBoundsException - - si l'index est en dehors des bornes (index < 0 || index >= nbNumeros()).

premierNumero

NumTel premierNumero()
retourne le premier numéro de la liste (il existe forcément)

Returns:
le premier numéro de la liste.

numero

NumTel numero(int index)
retourne le ième numéro de la liste.

Parameters:
index - la position du numéro à rechercher
Returns:
le numero de la liste à la position index.
Throws:
java.lang.IndexOutOfBoundsException - - si l'index est en dehors des bornes (index < 0 || index >= nbNumeros()).

contientNumero

boolean contientNumero(int num)
Teste la présence d'un numéro dans la liste.

Parameters:
num - le numéro à rechercher.
Returns:
true si la liste contient le objet Numtel dont le numéro est identique à num, false sinon

nbNumeros

int nbNumeros()
retourne le nombre de numéros de la liste (>=1).

Returns:
nombre de numéros présents dans la liste.

toString

java.lang.String toString()
Retourne dans une chaîne de caractères la séquence des numéros contenu dans cette liste. Dans la chaîne résultat les numéros sont séparés par des virgules.
exemple:
 0476088634 (D), 0654789045 (P), 0476615277 (T)
 

Overrides:
toString in class java.lang.Object
Returns:
la chaine contenant la séquence des numéros.

iterator

java.util.Iterator iterator()
Renvoie un itérateur sur les numéros de téléphone contenus dans la liste.

Returns:
un iterateur permettant le parcours des numéros de la liste

retirer

boolean retirer(int num)
Enlève un numéro de la liste, cette opération n'est possible que si la liste contient au moins deux numéros (nbNumero()>1). Si la liste ne contient contient qu'un seul numéro cette opération est sans effet. De même si le numéro spécifié n'est pas présent dans la liste.
Cette méthode retourne un booléen qui indique si cette liste de numéros de téléphone a été affectée par l'opération de retrait.

Parameters:
num - le numero à enlever.
Returns:
true si un NumTel dont le numéro est num a été retiré de la liste, false si la liste ne contient plus qu'un seul numéro ou si il n'y a pas dans la liste de NumTel de numéro num.