DESCRIPTION.

Retourne la valeur actuelle d'un compteur d'événements.

SYNTAXE.

Variable = os.eventfd_read ( descripteur )

Variable = ⇨ variable qui recevra la valeur [ optionnel ]

os.eventfd_read ( ) ⇨ appel de la méthode [ OBLIGATOIRE ]

descripteur ⇨ descripteur d'événements [ OBLIGATOIRE ]

REMARQUES.

descripteur doit être un int ( ) correspondant à un descripteur d'événements créer avec la méthode os.eventfd ( ).

La méthode os.eventfd_read ( ) n'est disponible que pour noyaux Linux 2.6.27+ avec glibc 2.8+ et supérieurr. Son utilisation sous d'autres OS, tel que Windows de Microsoft, lèvera une exception. 

L'appel de la méthode os.eventfd_read ( ) retourne un int ( ) positif, indiquant la valeur du compteur d'événements de descripteur.

Si  le compteur d'événements est différent de 0 et que l'option os.EFD_SEMAPHORE a été définie lors de l'appel de la méthode os.eventfd ( ), qui a créé le compteur d'événement associé à descripteur, l'appel de la méthode os.eventfd_read ( ) retournera 1 et décrémente le compteur d'événements de 1, sinon, si os.EFD_SEMAPHORE est absent, l'appel de la méthode os.eventfd_read ( ) replacera le compteur d'événement à 0 après avoir retournée sa valeur.

Si le compteur d'événements vaut 0, et que l'option os.EFD_NONBLOCK n"a été définie lors de l'appel de la méthode os.eventfd ( ), qui a créé le compteur d'événement associé à descripteur, la méthode os.eventfd_read ( ) se bloque.

La méthode os.eventfd_read ( ) ne controle pas si descripteur a été créé la méthode os.eventfd ( ).

Voir la méthode os.eventfd ( ) pour créer un compteur d'événements.

Voir la méthode os.eventfd_write ( ) qui modifie la valeur du compteur d'événements.

EXEMPLE.

import os

kcompteur = os.eventfd ( 1 , os.EFD_SEMAPHORE | os.EFD_NONBLOCK )

try : kevenement = os.eventfd_read ( kcompteur )

try : print ( "Sans erreur, c'est ok" )

except : print ( "Erreur détectée" )

finally : os.eventfd_write ( kcompteur , 5 )

except : pass

finally : os.close ( kcompteur )