Partager via


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 :

[Premières]

Voir aussi

Référence

send, fonction

asend, fonction

receive, fonction

try_receive, fonction

Concepts

Bibliothèque d'agents asynchrones

Blocs de messages asynchrones