Boost.Asio / Asio standalone

Visão Geral

Escreva código de rede C++ assíncrono que compile com o Boost do usuário, não o mais recente. A API do Asio mudou de forma três vezes (clássico io_service → io_context → corrotinas C++20) e a maior parte do código Asio na internet é da primeira era, então escolha o estilo da toolchain primeiro, depois siga o arquivo de referência desse estilo.

Referências: Boost.Asio · Asio standalone

A API do Asio mudou de forma três vezes, então a mesma tarefa tem três respostas corretas dependendo da versão do Boost que você tem. Essa habilidade faz com que o agente estabeleça essa versão primeiro, depois aplique as regras que são genuinamente fáceis de errar — strand versus serialização de escrita, tempo de vida de buffer e conexão, leituras compostas para framing — e finalmente verifique sua própria saída contra uma lista antes de considerar concluído.

Quando Usar Esta Habilidade

• Use ao escrever ou revisar código de rede C++ assíncrono com Boost.Asio ou Asio standalone: servidores e clientes TCP/UDP, streams SSL/TLS, timers, resolvedores.
• Use quando o código envolve io_context, io_service, co_spawn, awaitable, async_read, async_write, strand, asio::spawn, yield_context, ou callbacks de manipuladores de conclusão.
• Use quando a toolchain de destino é antiga: um Boost mais antigo ou um padrão pré-C++20, onde exemplos de corrotinas não compilarão.
• Use quando o código assíncrono compila, mas se comporta mal: escritas intercaladas, buffers pendentes, sockets fechando cedo, operation_aborted tratado como erro.

Passo 1: escolha o estilo (faça isso antes de escrever código)

Determine a versão do Boost (ou Asio) e o padrão C++ realmente em uso — saída find_package(Boost), dpkg -l libboost-dev, brew info boost, CMAKE_CXX_STANDARD, ou pergunte. Não assuma o mais recente.

SSL/TLS em qualquer estilo: references/ssl.md. CMake para qualquer estilo: references/build.md.

io_context, make_strand, bind_executor, steady_timer, signal_set, async_read/async_write/async_read_until, buffers e resolver são recursos da biblioteca — idênticos nos estilos de corrotina e callback. Apenas o mecanismo de suspensão difere.

Passo 2: pisos de versão (verificados por compilação, não por documentação)

Alcance um destes e a compilação falhará em distribuições mais antigas:

Pisos de distribuição que atrapalham: Debian bookworm envia Boost 1.74 (sem awaitable_operators.hpp — #include falha diretamente), Ubuntu 20.04 envia 1.71 (sem any_io_executor), Debian 9 envia 1.62.

Linguagem, não biblioteca: os literais chrono 250ms / 30s são C++14. Para uma compilação C++11 real, escreva std::chrono::milliseconds(250).

Passo 3: as regras que são realmente fáceis de errar

Uma strand não serializa escritas. Uma strand serializa a execução do manipulador, não operações compostas inteiras. Duas async_writes em voo na mesma strand ainda intercalam bytes na rede. Full-duplex (um loop de leitura mais pushes/respostas concorrentes) precisa de uma strand por conexão e uma fila de saída com um flag de em voo, para que no máximo uma async_write exista por vez. Esta é a resposta errada mais comum sobre Asio.

…