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
The concurrency::send function sends a message to the specified target synchronously and the concurrency::asend function sends a message to the specified target asynchronously. 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.
[Premières]
receive et try_receive
The concurrency::receive and concurrency::try_receive functions read data from a given source. 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.
[Premières]
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
[Premières]