buffer_copy (11 of 30 overloads)

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

template<
    typename MutableBufferSequence>
std::size_t buffer_copy(
    const MutableBufferSequence & target,
    const const_buffer & source,
    typename enable_if< is_mutable_buffer_sequence< MutableBufferSequence >::value >::type *  = 0);

Parameters

target: A modifiable buffer sequence representing the memory regions to which the bytes will be copied.
source: A non-modifiable buffer representing the memory region 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.