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