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

La fonction Concurrency::send envoie de façon synchrone un message à la cible spécifiée et la fonction Concurrency::asend envoie de façon asynchrone un message à la cible spécifiée. 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.

[retour en haut]

receive et try_receive

Les fonctions Concurrency::receive et Concurrency::try_receive lisent des données à partir 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.

[retour en haut]

Exemples

Pour obtenir des exemples qui utilisent les fonctions send, asend et receive, consultez les rubriques suivantes :

[retour en haut]

Voir aussi

Référence

send, fonction

asend, fonction

receive, fonction

try_receive, fonction

Concepts

Bibliothèque d'agents asynchrones

Blocs de messages asynchrones

Historique des modifications

Date

Historique

Motif

Mars 2011

Clarification de la différence entre les fonctions send et asend.

Commentaires client.

Août 2010

Ajout de liens vers des exemples.

Améliorations apportées aux informations.