liste/ liste.h

Summary
Module permettant l’utilisation d’une liste généralisée à tous les types.
Initialisation d’une liste
Destruction de toute la liste à partir de son pointeur
Permet d’ajouter un pointeur vers un élément à une liste
Permet de retirer un élément d’une liste
Permet d’ajouter un élément à la fin d’un fichier
Permet de recuperer un élément d’une liste
Détermine la taille d’une liste Paramètre: liste - liste à déterminer la taille

Documentation du module Liste

Module permettant l’utilisation d’une liste généralisée à tous les types.

Une liste doit toujours être initialisée avant l’utilisation de celle-ci.  Lorsque l’utilisateur n’en a plus besoin, il faut la détruire par libérer l’espace alloué par celle-ci.

Functions

listeInitialiser

void listeInitialiser (Liste *liste)

Initialisation d’une liste

Paramètres

listeliste devant être initialisée

listeDetruire

void listeDetruire (Liste *liste)

Destruction de toute la liste à partir de son pointeur

Paramètres liste - liste devant être détruite

listeAjouter

void listeAjouter (Liste *liste,
int position,
ElementListe *element)

Permet d’ajouter un pointeur vers un élément à une liste

Paramètres liste - la liste ou doit être ajouté l’élément position - la position ou ajouter l’élément element - le pointeur vers l’élément à ajouter

Erreur

Dans le cas d’une limite mémoire, un message d’erreur sera affiché sur la sortie stderr Dans le cas d’une tentative d’ajout hors borne, un message d’erreur est affiché sur la sortie stderr

listeRetirer

void listeRetirer (Liste *liste,
int position)

Permet de retirer un élément d’une liste

Paramètres liste - la liste ou doit être retiré l’élément position - la position ou retirer l’élément

Erreur

Dans le cas d’une tentative d’ajout hors borne, un message d’erreur est affiché sur la sortie stderr

listeAjouterFin

void listeAjouterFin(Liste *liste,
ElementListe *element)

Permet d’ajouter un élément à la fin d’un fichier

Paramètres liste - la liste ou doit être ajoutél’élément element - l’élément à ajouter

Erreur

Dans le cas d’un problème mémoire, un message d’erreur est affiché sur la sortie stderr

listeLire

ElementListe* listeLire (Liste *liste,
int position)

Permet de recuperer un élément d’une liste

Paramètre

listela liste ou l’on doit lire l’élément
positionposition de l’élément

Retour

Un pointeur vers l’élément lu

Erreur

Dans le cas d’une tentative d’écriture hors borne, le pointeur NULL est retourné

listeTaille

int listeTaille (Liste *liste)

Détermine la taille d’une liste Paramètre: liste - liste à déterminer la taille

Retour

Le taille de la liste

void listeInitialiser (Liste *liste)
Initialisation d’une liste
void listeDetruire (Liste *liste)
Destruction de toute la liste à partir de son pointeur
void listeAjouter (Liste *liste,
int position,
ElementListe *element)
Permet d’ajouter un pointeur vers un élément à une liste
void listeRetirer (Liste *liste,
int position)
Permet de retirer un élément d’une liste
void listeAjouterFin(Liste *liste,
ElementListe *element)
Permet d’ajouter un élément à la fin d’un fichier
ElementListe* listeLire (Liste *liste,
int position)
Permet de recuperer un élément d’une liste
int listeTaille (Liste *liste)
Détermine la taille d’une liste Paramètre: liste - liste à déterminer la taille