Namespaces
Variants

    std::raw_storage_iterator

    来自 zh.cppreference.net
     
    C++
     
    内存管理库
    分配器
    (C++17)
    (C++20)
    内存资源
    未初始化存储 (直到 C++20*)
    垃圾回收器支持 (直到 C++23)
     
    std::raw_storage_iterator
     
    定义于头文件 <memory> 
    template< class OutputIt, class T >
class raw_storage_iterator
    : public std::iterator<std::output_iterator_tag, void, void, void, void>;
    		(直到 C++17) 
    template< class OutputIt, class T >
class raw_storage_iterator;
    		(自 C++17 起)
    (在 C++17 中弃用)
    (在 C++20 中移除)

    输出迭代器 std::raw_storage_iterator 使得标准算法可以将结果存储到未初始化的内存中。每当算法将类型为 T 的对象写入解引用的迭代器时，该对象会被复制构造到迭代器所指向的未初始化存储位置。模板参数 OutputIt 是任何满足 LegacyOutputIterator 要求的类型，并且拥有 operator* 被定义为返回一个对象，对于该对象 operator& 返回类型为 T* 的对象。通常，类型 T* 被用作 OutputIt。

    类型要求

    -
    OutputIt 必须满足 LegacyOutputIterator 的要求。

    成员函数

    		创建新的 raw_storage_iterator
    (公开成员函数)
    		在缓冲区指向位置构造对象
    (公开成员函数)
    		解引用迭代器
    (公开成员函数)
    		推进迭代器
    (公开成员函数)
    (since C++17)
    		提供对包装迭代器的访问
    (公开成员函数)

    成员类型

    成员类型 定义
    iterator_category std:: output_iterator_tag
    value_type void
    difference_type

    void

    		(C++20 前)

    std::ptrdiff_t

    		(C++20 起)
    pointer void
    reference void

    成员类型 iterator_category 、 value_type 、 difference_type 、 pointer 和 reference 需要通过继承自 std:: iterator < std:: output_iterator_tag , void , void , void , void > 来获得。

    		(C++17 前)

    注释

    std::raw_storage_iterator 被弃用主要是因为其异常不安全的行为。与 std::uninitialized_copy 不同，它在执行类似 std::copy 的操作时无法安全处理异常，由于缺乏对已成功构造对象数量的追踪以及在异常发生时无法正确销毁这些对象，可能导致资源泄漏。

    示例

    运行此代码 
    #include <algorithm>
#include <iostream>
#include <memory>
#include <string>
int main()
{
    const std::string s[] = {"This", "is", "a", "test", "."};
    std::string* p = std::allocator<std::string>().allocate(5);
    std::copy(std::begin(s), std::end(s),
              std::raw_storage_iterator<std::string*, std::string>(p));
    for (std::string* i = p; i != p + 5; ++i)
    {
        std::cout << *i << '\n';
        i->~basic_string<char>();
    }
    std::allocator<std::string>().deallocate(p, 5);
}

    输出： 

    This
is
a
test
.

    参见

    (C++11)
    		 提供关于分配器类型的信息
    (类模板)
    (C++11)
    		 实现多层容器的多层分配器
    (类模板)
    (C++11)
    		 检查指定类型是否支持使用分配器构造
    (类模板)
    		将一个对象范围复制到未初始化的内存区域
    (函数模板 & 算法函数对象)
    (C++20)