std::inplace_vector<T,N>::assign_range

来自cppreference.com
 
 
 
 
template< /*container-compatible-range*/<T> R >
constexpr void assign_range( R&& rg );
(C++26 起)

将容器中的元素替换成 rg 中每个元素的副本。

范围 rg 中每个迭代器均恰好被解引用一次。

rg 与容器重叠则行为未定义。

参数

rg - 引用类型可转换为容器元素类型的 input_range
类型要求
-
std::assignable_from<T&, ranges::range_reference_t<R>> 必须得到实现。否则程序非良构。
-
T 必须从 *ranges::begin(rg) 可就位构造 (EmplaceConstructible) 到容器中。否则行为未定义。

异常

  • std::ranges::distance(rg) > capacity() 时抛出 bad_alloc
  • 由所插入元素的初始化抛出的任何异常。

示例

#include <algorithm>
#include <cassert>
#include <initializer_list>
#include <inplace_vector>
#include <iostream>
#include <new>

int main()
{
    const auto source = {1, 2, 3};
    std::inplace_vector<int, 4> destination{4, 5};
    destination.assign_range(source);
    assert(std::ranges::equal(destination, source));

    try
    {
        const auto bad = {-1, -2, -3, -4, -5};
        destination.assign_range(bad); // 抛出: bad.size() > destination.capacity()
    }
    catch(const std::bad_alloc& ex)
    {
        std::cout << ex.what() << '\n';
    }
}

可能的输出:

std::bad_alloc

参阅

插入元素范围
(公开成员函数)
添加元素的范围到末尾
(公开成员函数)
将值赋给容器
(公开成员函数)
将值赋给容器
(公开成员函数)
Morty Proxy This is a proxified and sanitized view of the page, visit original site.