...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_buffers_1 & target, const mutable_buffers_1 & source);
A modifiable buffer representing the memory region to which the bytes will be copied.
A modifiable buffer representing the memory region from which the bytes will be copied. The contents of the source buffer will not be modified.
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.