/await (Activer la prise en charge de coroutine)

  • Article

Utilisez l’option du compilateur pour activer la /await prise en charge du compilateur pour les coroutines.

Syntaxe

/await
/await:strict

Notes

L’option /await du compilateur active la prise en charge du compilateur pour les coroutines C++ et les mot clé s co_await, co_yieldet co_return. Cette option est désactivée par défaut. Pour plus d’informations sur la prise en charge des coroutines dans Visual Studio, consultez le blog de l’équipe Visual Studio. Pour plus d’informations sur la proposition standard coroutines, consultez N4628 Working Draft, Technical Specification for C++ Extensions for Coroutines.

L’option /await est disponible à partir de Visual Studio 2015.

À compter de Visual Studio 2019 version 16.10, l’option /await:strict peut être utilisée à la place de /await. L’option fournit la prise en charge coroutine compatible C++20 dans les projets qui s’appuient sur C++14 ou C++17. En /await:strict mode, la prise en charge de la bibliothèque est fournie dans <coroutine> et dans l’espace std de noms.

L’option /await:strict désactive les extensions de langage présentes dans /await ce qui n’a pas été adopté dans la norme C++20. L’utilisation de ces fonctionnalités entraîne une erreur du compilateur. L’option implémente également des comportements coroutine tels que l’aperçu des paramètres de promesse. Ces comportements ne sont pas disponibles en /await raison de problèmes de compatibilité binaire dans les versions antérieures de Visual Studio.

Remarque

Les objets d’état Coroutine obtenus à partir coroutine_handle<T>::address() de ne sont pas compatibles entre les modes et /await:strict les /await modes. L’utilisation d’une coroutine_handle<T>::from_address() adresse obtenue à partir d’un handle coroutine créé par le code compilé en mode incompatible entraîne un comportement non défini.

Pour définir cette option du compilateur dans l'environnement de développement Visual Studio

  1. Ouvrez la boîte de dialogue Pages de propriétés de votre projet.

  2. Sélectionnez la page de propriétés Propriétés de configuration>C/C++>Ligne de commande.

  3. Entrez l’option ou l’option /await du compilateur dans la zone Options supplémentaires./await:strict Choisissez OK ou Appliquer pour enregistrer vos modifications.

Pour définir cette option du compilateur par programmation

Voir aussi

Options du compilateur MSVC
Syntaxe de la ligne de commande du compilateur MSVC