/await (habilitar suporte de corrotina)

  • Artigo

Use a opção do compilador /await para habilitar o suporte do compilador para corrotinas.

Sintaxe

/await
/await:strict

Comentários

A opção do compilador /await habilita o suporte do compilador para as corrotinas do C++ e as palavras-chave co_await, co_yield e co_return. Essa opção fica desativada por padrão. Para obter informações sobre o suporte para corrotinas no Visual Studio, confira o Blog da Equipe do Visual Studio. Para obter mais informações sobre a proposta padrão de corrotinas, confira Rascunho de trabalho N4628, Especificação técnica para extensões do C++ para corrotinas.

A opção /await está disponível a partir do Visual Studio 2015.

A partir do Visual Studio 2019 versão 16.10, a opção /await:strict pode ser usada em vez de /await. A opção fornece suporte a corrotina compatível com C++20 em projetos que são compilados no modo C++14 ou C++17. No modo /await:strict, o suporte à biblioteca é fornecido em <corrotina> e no namespace std.

A opção /await:strict desabilita as extensões de linguagem presentes no /await que não foram adotadas no padrão C++20. O uso desses recursos ocasiona um erro do compilador. A opção também implementa comportamentos de corrotina, como a versão prévia do parâmetro de promessa. Esses comportamentos não estão disponíveis no /await devido a problemas de compatibilidade de binário em versões mais antigas do Visual Studio.

Observação

Objetos de estado corrotina obtidos de coroutine_handle<T>::address() não são compatíveis entre os modos /await e /await:strict. O uso de coroutine_handle<T>::from_address() ou um endereço obtido de um identificador de corrotina criado por código compilado em um modo incompatível resultará em um comportamento indefinido.

Para definir esta opção do compilador no ambiente de desenvolvimento do Visual Studio

  1. Abra a caixa de diálogo Páginas de Propriedades do seu projeto.

  2. Selecione a página de propriedades Propriedades de Configuração>C/C++>Linha de Comando.

  3. Digite a opção do compilador /await ou /await:strict na caixa Opções Adicionais. Escolha OK ou Aplicar para salvar as alterações.

Para definir essa opção do compilador via programação

Confira também

Opções do compilador MSVC
Sintaxe da linha de comando do compilador MSVC