Interface ListeNumTel


public interface ListeNumTel

Représente une liste de numéros de téléphone. La liste contient au moins un numéro (pas de liste vide).
Created: Tue Dec 04 21:09:56 2001

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, null si la liste contient moins de i numéros.
 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

public 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

public 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

public 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:
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.

premierNumero

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

Returns:
le premier numéro de la liste.

numero

public NumTel numero(int index)
retourne le ième numéro de la liste, null si la liste contient moins de i numéros.

Parameters:
index - la position du numéro à rechercher
Returns:
le numero de la liste à la position index.

contientNumero

public 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

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

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

toString

public 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)
 

Returns:
la chaine contenant la séquence des numéros.

iterator

public 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

public 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.