#include <mqueue.h> ssize_t mq_receive(mqd_t mqdes, char *msg_ptr, size_t msg_len, unsigned *msg_prio); #define _XOPEN_SOURCE 600 #include <time.h> #include <mqueue.h> ssize_t mq_timedreceive(mqd_t mqdes, char *msg_ptr, size_t msg_len, unsigned *msg_prio, const struct timespec *abs_timeout);
Utilisez -lrt à l'édition de liens.
Si la file est vide, alors, par défaut, mq_receive() bloquera jusqu'à ce qu'un message soit disponible ou que l'appel soit interrompu par un gestionnaire de signaux. Si l'attribut O_NONBLOCK est activé pour la description de la file de messages, l'appel échouera immédiatement avec l'erreur EAGAIN.
mq_timedreceive() se comporte comme mq_receive(), excepté que si la file est vide et si l'attribut O_NONBLOCK n'est pas activé pour la description de la file de messages, abs_timeout pointe vers une structure qui spécifie un plafond sur le temps pendant lequel l'appel bloquera. Le plafond est un délai absolu en secondes et nanosecondes depuis l'Époque (00H00 le 1er janvier 1970) spécifié dans la structure suivante :
struct timespec { time_t tv_sec; /* secondes */ long tv_nsec; /* nanosecondes */ };Si aucun message n'est disponible et si le délai d'attente a déjà expiré pendant la durée de l'appel, mq_timedreceive() revient immédiatement.
Ce document est une traduction réalisée par Alain Portal <aportal AT univ-montp2 DOT fr> le 23 juillet 2006 et révisée le 17 juillet 2008.
L'équipe de traduction a fait le maximum pour réaliser une adaptation française de qualité. La version anglaise la plus à jour de ce document est toujours consultable via la commande : « LANG=C man 3 mq_receive ». N'hésitez pas à signaler à l'auteur ou au traducteur, selon le cas, toute erreur dans cette page de manuel.
Dernière mise à jour : 17 juillet 2008