Boost C++ Libraries of the most highly regarded and expertly designed C++ library projects in the world. Herb Sutter and Andrei Alexandrescu, C++ Coding Standards

This is an the documentation for an old version of boost. Click here for the latest Boost documentation.

Socket Iostreams

Boost.Asio includes classes that implement iostreams on top of sockets. These hide away the complexities associated with endpoint resolution, protocol independence, etc. To create a connection one might simply write:

ip::tcp::iostream stream("", "http");
if (!stream)
  // Can't connect.

The iostream class can also be used in conjunction with an acceptor to create simple servers. For example:

io_service ios;

ip::tcp::endpoint endpoint(tcp::v4(), 80);
ip::tcp::acceptor acceptor(ios, endpoint);

for (;;)
  ip::tcp::iostream stream;

Timeouts may be set by calling expires_at() or expires_from_now() to establish a deadline. Any socket operations that occur past the deadline will put the iostream into a "bad" state.

For example, a simple client program like this:

ip::tcp::iostream stream;
stream.connect("", "http");
stream << "GET /LICENSE_1_0.txt HTTP/1.0\r\n";
stream << "Host:\r\n";
stream << "Accept: */*\r\n";
stream << "Connection: close\r\n\r\n";
std::cout << stream.rdbuf();

will fail if all the socket operations combined take longer than 60 seconds.

If an error does occur, the iostream's error() member function may be used to retrieve the error code from the most recent system call:

if (!stream)
  std::cout << "Error: " << stream.error().message() << "\n";
See Also

ip::tcp::iostream, basic_socket_iostream, iostreams examples.


These iostream templates only support char, not wchar_t, and do not perform any code conversion.