...one of the most highly
regarded and expertly designed C++ library projects in the
world.
— Herb Sutter and Andrei
Alexandrescu, C++
Coding Standards
This tutorial program shows how to use asio to implement a client application with TCP.
We start by including the necessary header files.
#include <iostream> #include <boost/array.hpp> #include <boost/asio.hpp>
The purpose of this application is to access a daytime service, so we need the user to specify the server.
using boost::asio::ip::tcp; int main(int argc, char* argv[]) { try { if (argc != 2) { std::cerr << "Usage: client <host>" << std::endl; return 1; }
All programs that use asio need to have at least one io_context object.
boost::asio::io_context io_context;
We need to turn the server name that was specified as a parameter to the application, into a TCP endpoint. To do this we use an ip::tcp::resolver object.
tcp::resolver resolver(io_context);
A resolver takes a query object and turns it into a list of endpoints. We
construct a query using the name of the server, specified in argv[1]
,
and the name of the service, in this case "daytime"
.
The list of endpoints is returned using an iterator of type ip::tcp::resolver::iterator. (Note that a default constructed ip::tcp::resolver::iterator object can be used as an end iterator.)
Now we create and connect the socket. The list of endpoints obtained above may contain both IPv4 and IPv6 endpoints, so we need to try each of them until we find one that works. This keeps the client program independent of a specific IP version. The boost::asio::connect() function does this for us automatically.
The connection is open. All we need to do now is read the response from the daytime service.
We use a boost::array
to hold the received data. The boost::asio::buffer()
function automatically determines the size of the array to help prevent buffer
overruns. Instead of a boost::array
, we could have used a char
[]
or std::vector
.
When the server closes the connection, the ip::tcp::socket::read_some() function will exit with the boost::asio::error::eof error, which is how we know to exit the loop.
Finally, handle any exceptions that may have been thrown.
See the full source listing
Return to the tutorial index