std::forward_list<T,Allocator>::splice_after

 

C++

语言

标准库头文件

自立与有宿主实现

具名要求

语言支持库

概念库 (C++20)

诊断库

工具库

字符串库

容器库

迭代器库

范围库 (C++20)

算法库

数值库

输入/输出库

本地化库

正则表达式库 (C++11)

原子操作库 (C++11)

线程支持库 (C++11)

文件系统库 (C++17)

技术规范

 

容器库

array (C++11)

vector

deque

forward_list (C++11)

list

set

multiset

map

multimap

unordered_set (C++11)

unordered_multiset (C++11)

unordered_map (C++11)

unordered_multimap (C++11)

stack

queue

priority_queue

span (C++20)

 

std::forward_list

成员函数

forward_list::forward_list

forward_list::~forward_list

forward_list::operator=

forward_list::assign

forward_list::get_allocator

元素访问

forward_list::front

迭代器

forward_list::before_beginforward_list::cbefore_begin

forward_list::beginforward_list::cbegin

forward_list::endforward_list::cend

容量

forward_list::empty

forward_list::max_size

修改器

forward_list::clear

forward_list::insert_after

forward_list::emplace_after

forward_list::erase_after

forward_list::push_front

forward_list::emplace_front

forward_list::pop_front

forward_list::resize

forward_list::swap

操作

forward_list::merge

forward_list::splice_after

forward_list::removeforward_list::remove_if

forward_list::reverse

forward_list::unique

forward_list::sort

推导指引(C++17)

 

void splice_after( const_iterator pos, forward_list& other );	(1)	(C++11 起)
void splice_after( const_iterator pos, forward_list&& other );	(1)	(C++11 起)
void splice_after( const_iterator pos, forward_list& other,                    const_iterator it );	(2)	(C++11 起)
void splice_after( const_iterator pos, forward_list&& other,                    const_iterator it );	(2)	(C++11 起)
void splice_after( const_iterator pos, forward_list& other,                    const_iterator first, const_iterator last );	(3)	(C++11 起)
void splice_after( const_iterator pos, forward_list&& other,                    const_iterator first, const_iterator last );	(3)	(C++11 起)

从另一 forward_list 移动元素到 *this 。

不复制元素。 pos 必须是指向 *this 中的可解引用迭代器或 before_begin() 迭代器（特别是 end() 不是 pos 的合法参数值）。若 get_allocator() != other.get_allocator() 则行为未定义。没有迭代器或引用被非法化，指向被移动的元素的迭代器现在指代到 *this 中，而非 other 中。

1) 从 other 移动所有元素到 *this 。元素被插入到 pos 所指向的元素后。操作后 other 变为空。若 other 与 *this 指代同一对象则行为未定义。

2) 从 other 移动后随 it 的迭代器所指向的元素到 *this 。元素被插入到 pos 所指向的元素后，若 pos == it 或若 pos == ++it 则无效果。

3) 从 other 移动范围 (first, last) 中的元素到 *this 。元素被插入到 pos 所指向的元素后。不移动 first 所指向的元素。若 pos 是范围 (first,last) 中的元素则行为未定义。

参数

pos	-	指向将插入内容到其后的元素的迭代器
other	-	移动内容来源的另一容器
it	-	指向从 other 移动到 *this 的元素的迭代器的前趋迭代器
first, last	-	从 other 移动到 *this 的元素范围

返回值

（无）

异常

不抛出。

复杂度

1) 与 other 的大小成线性

2) 常数

3) 与 std::distance(first, last) 成线性

示例

演示 splice_after() 第三种形式中开区间 (first, last) 的含义：不移动 l1 的首元素。

运行此代码

#include <iostream>
#include <forward_list>
 
int main()
{
    std::forward_list<int> l1 = {1, 2, 3, 4, 5};
    std::forward_list<int> l2 = {10, 11, 12};
 
    l2.splice_after(l2.cbegin(), l1, l1.cbegin(), l1.cend());
    // 不等价于 l2.splice_after(l2.cbegin(), l1);
 
    for (int n : l1)
        std::cout << n << ' ';
    std::cout << '\n';
 
    for (int n : l2)
        std::cout << n << ' ';
    std::cout << '\n';
}

输出：

1
10 2 3 4 5 11 12

参阅

merge	合并二个已排序列表 (公开成员函数)
removeremove_if	移除满足特定标准的元素 (公开成员函数)