Fonctions de passage de messages
La Bibliothèque d'agents asynchrones fournit plusieurs fonctions qui vous permettent de passer des messages parmi des composants.
Ces fonctions de passage de messages sont utilisées avec les différents types de blocs de messages.Pour plus d'informations sur les types de blocs de messages définis par le runtime d'accès concurrentiel, consultez Blocs de messages asynchrones.
Sections
Cette rubrique décrit les fonctions de passage de messages suivantes :
send et asend
receive et try_receive
Exemples
send et asend
Le concurrency::send fonction envoie un message à la cible spécifiée de façon synchrone et la concurrency::asend fonction envoie un message à la cible spécifiée de manière asynchrone.Les fonctions send et asend attendent toutes deux que la cible indique qu'elle accepte ou refuse le message.
La fonction send attend que la cible accepte ou refuse le message avant de retourner.La fonction send retourne true si le message a été remis et false dans le cas contraire.Étant donné que la fonction send opère de façon synchrone, la fonction send attend que la cible reçoive le message avant de retourner.
En revanche, la fonction asend n'attend pas que la cible accepte ou refuse le message avant de retourner une valeur.Au lieu de cela, la fonction asend retourne la valeur true si la cible accepte le message et le prendra finalement.Sinon, asend retourne la valeur false pour indiquer que la cible a refusé le message ou différé la décision relative à la prise du message.
Top
receive et try_receive
Le concurrency::receive et concurrency::try_receive fonctions de lire les données d'une source donnée.La fonction receive attend que les données deviennent disponibles, tandis que la fonction try_receive retourne immédiatement.
Utilisez la fonction receive lorsque vous devez avoir les données pour continuer.Utilisez la fonction try_receive si vous ne devez pas bloquer le contexte actuel ou si vous n'êtes pas obligé d'avoir les données pour continuer.
Top
Exemples
Pour obtenir des exemples qui utilisent les fonctions send, asend et receive, consultez les rubriques suivantes :
Comment : implémenter divers modèles de producteur-consommateur
Comment : fournir des fonctions de travail aux classes call et transformer
Comment : utiliser la classe transformer dans un pipeline de données
Comment : effectuer une sélection parmi les tâches terminées
Top