Référence du fichier real_queue.h

File (FIFO) contenant des valeurs de type double Plus de détails...

#include <stdlib.h>
#include "real_list.h"

Aller au code source de ce fichier.

Définitions de type
typedef real_list_t	real_queue_t
	Type de données pour représenter une file contenant des valeurs de type double

Fonctions
void	real_queue_init (real_queue_t *queue)
	Initialisation d'une nouvelle file contenant des valeurs de type double
void	real_queue_destroy (real_queue_t *queue)
	Destruction d'une file.
int	real_queue_size (real_queue_t *queue)
	Accesseur sur la taille d'une file.
int	real_queue_enqueue (real_queue_t *queue, double data)
	Ajouter un élément de type double dans la file.
int	real_queue_dequeue (real_queue_t *queue, double *data)
	Supprime un élément de type double dans la file.
double	real_queue_peek (real_queue_t *queue)
	Récupère la valeur de type double le plus ancien de la file.

Description détaillée

File (FIFO) contenant des valeurs de type double

Documentation des définitions de type

real_queue_t

typedef real_list_t real_queue_t

Type de données pour représenter une file contenant des valeurs de type double

Une file est une liste chaînée gérée de manière adéquate: insertion en tête et suppression en queue.

Documentation des fonctions

real_queue_dequeue()

int real_queue_dequeue	(	real_queue_t *	queue,
		double *	data )

Supprime un élément de type double dans la file.

Etant donné un pointeur vers une file (représentée par une liste chaînée), supprime l'élément le plus ancien de la file.

Paramètres

queue

est un pointeur vers la structure de données real_queue_t @pram data un pointeur sur type double qui permet de récupérer la valeur de l'élément supprimer de la file

Renvoie

un entier indiquant si tout s'est bien passé (0 pour OK, et -1 en cas de problème mémoire)

real_queue_destroy()

void real_queue_destroy

(

real_queue_t *

queue

)

Destruction d'une file.

Utilise la fonction de destruction des listes chaînées pour parcourir la liste et détruire tous les éléments de la file.

Paramètres

queue

est un pointeur vers la structure de données des piles real_queue_t

real_queue_enqueue()

int real_queue_enqueue	(	real_queue_t *	queue,
		double	data )

Ajouter un élément de type double dans la file.

Etant donné un pointeur vers une file (représentée par une liste chaînée) et une valeur de type double, ajoute un nouvel élément à la file avec cette valeur.

Paramètres

queue

est un pointeur vers la structure de données real_queue_t @pram data une valeur de type double à ajouter à la file

Renvoie

un entier indiquant si tout s'est bien passé (0 pour OK, et -1 en cas de problème mémoire)

real_queue_init()

void real_queue_init

(

real_queue_t *

queue

)

Initialisation d'une nouvelle file contenant des valeurs de type double

Utilise la fonction d'initalisation des listes chaînée pour mettre à zéro la taille et à NULL les pointeurs vers le premier et le dernier élément de la liste, i.e., de la file.

Paramètres

queue

est un pointeur vers la structure de données des files real_queue_t

real_queue_peek()

double real_queue_peek

(

real_queue_t *

queue

)

Récupère la valeur de type double le plus ancien de la file.

Etant donné un pointeur vers une file (représentée par une liste chaînée), récupère la valeur de l'élément le plus ancien de la file sans le supprimer.

Paramètres

queue

est un pointeur vers la structure de données real_queue_t

Renvoie

une valeur de double de l'élément le plus ancien de la file

real_queue_size()

int real_queue_size

(

real_queue_t *

queue

)

Accesseur sur la taille d'une file.

Etant donné un pointeur vers une file (représentée par une liste chaînée), retourne la valeur du champ size

Paramètres

queue

est un pointeur vers la structure de données real_queue_t

Renvoie

un entier indiquant la taille de la file