...one of the most highly
regarded and expertly designed C++ library projects in the
world.
— Herb Sutter and Andrei
Alexandrescu, C++
Coding Standards
Copies bytes from a source buffer to a target buffer.
std::size_t buffer_copy( const mutable_buffer & target, const const_buffers_1 & source);
A modifiable buffer representing the memory region to which the bytes will be copied.
A non-modifiable buffer representing the memory region from which the bytes will be copied.
The number of bytes copied.
The number of bytes copied is the lesser of:
buffer_size(target)
buffer_size(source)
This function is implemented in terms of memcpy
,
and consequently it cannot be used to copy between overlapping memory regions.