当streambuf 的所有数据(其输入序列)已写入WriteStream(套接字)时,正在使用的async_write() 重载被认为是完整的。相当于调用:
boost::asio::async_write(stream, streambuf,
boost::asio::transfer_all(), handler);
可以通过使用boost::asio::transfer_exactly 完成条件调用此async_write() 重载来限制从streambuf 对象写入和消耗的字节数:
boost::asio::async_write(stream, streambuf,
boost::asio::transfer_exactly(n), handler);
或者,可以直接从流缓冲区的输入序列中写入。但是,需要从 streambuf 中显式使用。
boost::asio::async_write(stream,
boost::asio::buffer(streambuf.data(), n), handler);
// Within the completion handler...
streambuf.consume(n);
请注意,当async_read_until() 操作完成时,完成处理程序的bytes_transferred 参数包含streambuf 输入序列中直到并包括分隔符的字节数,如果发生错误,则包含0。
这是一个使用这两种方法的完整示例demonstrating。该示例是使用同步操作编写的,旨在简化流程:
#include <iostream>
#include <boost/asio.hpp>
#include <boost/bind.hpp>
// This example is not interested in the handlers, so provide a noop function
// that will be passed to bind to meet the handler concept requirements.
void noop() {}
/// @brief Helper function that extracts a string from a streambuf.
std::string make_string(
boost::asio::streambuf& streambuf,
std::size_t n)
{
return std::string(
boost::asio::buffers_begin(streambuf.data()),
boost::asio::buffers_begin(streambuf.data()) + n);
}
int main()
{
using boost::asio::ip::tcp;
boost::asio::io_service io_service;
// Create all I/O objects.
tcp::acceptor acceptor(io_service, tcp::endpoint(tcp::v4(), 0));
tcp::socket server_socket(io_service);
tcp::socket client_socket(io_service);
// Connect client and server sockets.
acceptor.async_accept(server_socket, boost::bind(&noop));
client_socket.async_connect(acceptor.local_endpoint(), boost::bind(&noop));
io_service.run();
// Mockup write_buffer as if it read "xxxx@yyyy" with read_until()
// using '@' as a delimiter.
boost::asio::streambuf write_buffer;
std::ostream output(&write_buffer);
output << "xxxx@yyyy";
assert(write_buffer.size() == 9);
auto bytes_transferred = 5;
// Write to server.
boost::asio::write(server_socket, write_buffer,
boost::asio::transfer_exactly(bytes_transferred));
// Verify write operation consumed part of the input sequence.
assert(write_buffer.size() == 4);
// Read from client.
boost::asio::streambuf read_buffer;
bytes_transferred = boost::asio::read(
client_socket, read_buffer.prepare(bytes_transferred));
read_buffer.commit(bytes_transferred);
// Copy from the read buffers input sequence.
std::cout << "Read: " <<
make_string(read_buffer, bytes_transferred) << std::endl;
read_buffer.consume(bytes_transferred);
// Mockup write_buffer as if it read "zzzz@kkkk" with read_until()
// using '@' as a delimiter.
output << "zzzz@kkkk";
assert(write_buffer.size() == 13);
bytes_transferred = 9; // yyyyzzzz@
// Write to server.
boost::asio::write(server_socket, buffer(write_buffer.data(),
bytes_transferred));
// Verify write operation did not consume the input sequence.
assert(write_buffer.size() == 13);
write_buffer.consume(bytes_transferred);
// Read from client.
bytes_transferred = boost::asio::read(
client_socket, read_buffer.prepare(bytes_transferred));
read_buffer.commit(bytes_transferred);
// Copy from the read buffers input sequence.
std::cout << "Read: " <<
make_string(read_buffer, bytes_transferred) << std::endl;
read_buffer.consume(bytes_transferred);
}
输出:
Read: xxxx@
Read: yyyyzzzz@
其他几点说明:
-
streambuf 拥有内存,std::istream 和 std::ostream 使用内存。当需要提取格式化输入或插入格式化输出时,使用流可能是一个好主意。例如,当人们希望将字符串 "123" 读取为整数 123。
-
可以直接访问 streambuf 的输入序列并对其进行迭代。在上面的示例中,我使用 boost::asio::buffers_begin() 通过迭代流缓冲区的输入序列来帮助构造 std::string。
std::string(
boost::asio::buffers_begin(streambuf.data()),
boost::asio::buffers_begin(streambuf.data()) + n);
正在使用基于流的传输协议,因此将传入数据作为流处理。请注意,即使中间服务器重构消息并在一次写入操作中发送"xxxx@",在后续写入操作中发送"yyyyzzzz@",下游也可能在一次读取操作中读取"xxxx@yyyy"。