std::uninitialized_copy

From cppreference.com

Defined in header `<memory>`

template< class InputIt, class Size, class ForwardIt > ForwardIt uninitialized_copy_n( InputIt first, Size count, ForwardIt d_first);		(since C++11)

Copies count elements from a range beginning at first to an uninitialized memory area beginning at d_first. The elements in the uninitialized area are constructed using copy constructor.

If an exception is thrown during the initialization, the function has no effects.

template<class InputIt, class Size, class ForwardIt>
ForwardIt uninitialized_copy_n(InputIt first, Size count, ForwardIt d_first)
{
    typedef typename std::iterator_traits<ForwardIt>::value_type Value;
    for (; count > 0; ++first, ++d_first, --count) {
        ::new (static_cast<void*>(&*d_first)) Value(*first);
    }
    return d_first;
}

[edit] Example

[edit] See also


uninitialized_copy	copies a range of objects to an uninitialized area of memory (function template)

Language
Concepts
Utilities library
Strings library
Containers library
Algorithms library
Iterators library
Numerics library
Input/output library
Localizations library
Regular expressions library (C++11)
Atomic operations library (C++11)
Thread support library (C++11)

first	-	the beginning of the range of the elements to copy
d_first	-	the beginning of the destination range
Type requirements
- `InputIt` must meet the requirements of `InputIterator`.
- `ForwardIt` must meet the requirements of `ForwardIterator`.

std::uninitialized_copy

Contents

[edit] Parameters

[edit] Return value

[edit] Complexity

[edit] Possible implementation

[edit] Example

[edit] See also