Namespaces
Variants

    std::front_insert_iterator

    来自 zh.cppreference.net
     
    C++
     
    迭代器库
    迭代器概念
    迭代器原语
    算法概念与工具
    间接可调用概念
    通用算法要求
    (C++20)
    (C++20)
    (C++20)
    工具
    (C++20)
    迭代器适配器
    范围访问
    (C++11)(C++14)
    (C++14)(C++14)  
    (C++11)(C++14)
    (C++14)(C++14)  
    (C++17)(C++20)
    (C++17)
    (C++17)
     
    std::front_insert_iterator
     
    定义于头文件 <iterator> 
    template< class Container >
class front_insert_iterator
    : public std::iterator<std::output_iterator_tag, void, void, void, void>
    		(C++17 前) 
    template< class Container >
class front_insert_iterator;
    		(C++17 起)

    std::front_insert_iterator 是一个 LegacyOutputIterator，它会将元素前置到它所构造的容器前。每当迭代器（无论是否解引用）被赋值时，都会调用容器的 push_front() 成员函数。自增 std::front_insert_iterator 是空操作。

    成员类型

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

    void

    		(C++20 前)

    std::ptrdiff_t

    		(C++20 起)
    pointer void
    reference void
    container_type Container

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

    		(C++17 前)

    成员函数

    		构造新的 front_insert_iterator
    (公开成员函数)
    		向关联容器插入对象
    (公开成员函数)
    		空操作
    (公开成员函数)
    		空操作
    (公开成员函数)

    成员对象

    成员名称 定义
    container (protected) 一个类型为 Container * 的指针

    示例

    运行此代码 
    #include <algorithm>
#include <deque>
#include <iostream>
#include <iterator>
#include <vector>
namespace stb
{
    void println(auto, auto const& d)
    {
        std::ranges::copy(d, std::ostream_iterator<int>(std::cout, " "));
        std::cout << '\n';
    }
}
int main()
{
    std::vector<int> v{1, 2, 3, 4, 5};
    std::deque<int> d;
    std::copy(v.begin(), v.end(),
              std::front_insert_iterator<std::deque<int>>(d));
              // 或使用 std::front_inserter(d)
    stb::println("{}", d);
}

    输出： 

    5 4 3 2 1

    参见

    		创建从参数推断类型的 std::front_insert_iterator
    (函数模板)
    		用于容器末尾插入的迭代器适配器
    (类模板)
    		用于容器插入的迭代器适配器
    (类模板)