buffer_copy (10 of 30 overloads)

Copies bytes from a source buffer sequence to a target buffer.

template<
    typename ConstBufferSequence>
std::size_t buffer_copy(
    const mutable_buffers_1 & target,
    const ConstBufferSequence & source,
    typename enable_if< is_const_buffer_sequence< ConstBufferSequence >::value >::type *  = 0);

Parameters

target: A modifiable buffer representing the memory region to which the bytes will be copied.
source: A non-modifiable buffer sequence representing the memory regions from which the bytes will be copied.

Return Value

The number of bytes copied.

Remarks

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.