unchecked_uninitialized_copy

  • Article

 

Same as uninitialized_copy but allows the use of an unchecked iterator as output iterator when _SECURE_SCL=1 is defined. This function is defined in the stdext Namespace namespace.

Note

This algorithm is a Microsoft extension to the Standard C++ Library. Code implemented using this algorithm will not be portable.

Syntax

template<class InputIterator, class ForwardIterator>
   ForwardIterator unchecked_uninitialized_copy(
      InputIterator _First,
      InputIterator _Last,
      ForwardIterator _Dest
   );

template<class InputIterator, class ForwardIterator, class Allocator>
   ForwardIterator unchecked_uninitialized_copy(
      InputIterator _First,
      InputIterator _Last,
      ForwardIterator _Dest,
      Allocator& _Al
   );

Parameters

  • _First
    An input iterator addressing the first element in the source range to be copied.

  • _Last
    An input iterator addressing the last element in the source range to be copied.

  • _Dest
    A forward iterator addressing the first element in the destination range to be copied.

  • _Al
    The allocator class to use with this object. vector::get_allocator returns the allocator class for the object.

Return Value

A forward iterator addressing the position one past the final element in the destination range that is receiving the copy.

Remarks

See uninitialized_copy for a code sample.

For more information on checked iterators, see Checked Iterators.

Requirements

Header: <memory>

Namespace: stdext