std::list::splice

<metanoindex/>

 

C++

Поддержка компилятором

Автономные и размещённые реализации

Язык

Стандартная библиотека

Заголовки стандартной библиотеки

Требования к именованию

Макросы тестирования функциональности (C++20)

Поддержка языка

Библиотека концептов (C++20)

Библиотека метапрограммирования (C++11)

Библиотека диагностики

Библиотека общих утилит

Библиотека строк

Библиотека контейнеров

Библиотека итераторов

Библиотека диапазонов (C++20)

Библиотека алгоритмов

Библиотека численных данных

Библиотека ввода/вывода

Библиотека локализаций

Регулярные выражения (C++11)

Атомарные операции (C++11)

Библиотека поддержки конкуренции (C++11)

Библиотека файловой системы (C++17)

Технические спецификации

Указатель символов

Внешние библиотеки

 

Библиотека контейнеров

Последовательные

array (C++11)

vector

vector<bool>

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

flat_set (C++23)

flat_multiset (C++23)

flat_map (C++23)

flat_multimap (C++23)

Представления

span (C++20)

mdspan (C++23)

Недействительные итераторы

Таблица функций-элементов

Таблица функций, не являющихся элементами

 

std::list

Функции-элементы

list::list

list::~list

list::operator=

list::assign

list::assign_range (C++23)

list::get_allocator

Доступ к элементам

list::front

list::back

Итераторы

list::beginlist::cbegin (C++11)

list::endlist::cend (C++11)

list::rbeginlist::crbegin (C++11)

list::rendlist::crend (C++11)

Ёмкость

list::empty

list::size

list::max_size

Модификаторы

list::clear

list::insert

list::insert_range (C++23)

list::emplace (C++11)

list::erase

list::push_front

list::emplace_front (C++11)

list::prepend_range (C++23)

list::pop_front

list::push_back

list::emplace_back (C++11)

list::append_range (C++23)

list::pop_back

list::resize

list::swap

Операции

list::merge

list::splice

list::removelist::remove_if

list::reverse

list::unique

list::sort

Функции, не являющиеся элементы

std::swap

eraseerase_if (C++20)(C++20)

operator==operator!=operator<operator>operator<=operator>=operator<=> (до C++20)(до C++20)(до C++20)(до C++20)(до C++20)(C++20)

Руководства по выводу(C++17)

 

<tbody> </tbody>

void splice(const_iterator pos, list& other);	(1)
void splice(const_iterator pos, list&& other);	(1)	(начиная с C++11)
void splice(const_iterator pos, list& other, const_iterator it);	(2)
void splice(const_iterator pos, list&& other, const_iterator it);	(2)	(начиная с C++11)
void splice(const_iterator pos, list& other, const_iterator first, const_iterator last);	(3)
void splice(const_iterator pos, list&& other, const_iterator first, const_iterator last);	(3)	(начиная с C++11)

Перемещение элементов из одного списка в другой.

Оригинал:

Moves elements from one list to another.

Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

Нет элементы копируются. Поведение неопределено, если: get_allocator() != other.get_allocator(). Нет итераторы или ссылки стали недействительны, итераторы переехал элементы теперь обратиться в *this, а не в other.

Оригинал:

No elements are copied. The behavior is undefined if: get_allocator() != other.get_allocator(). No iterators or references become invalidated, the iterators to moved elements now refer into *this, not into other.

Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

1)

Перемещение всех элементов из other в *this. Элементы вставляются перед элементом, на который указывает pos. Контейнер other становится пустым после операции. Поведение неопределено, если this == &other.

Оригинал:

Moves all elements from other into *this. The elements are inserted before the element pointed to by pos. The container other becomes empty after the operation. The behavior is undefined if this == &other.

Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

2)

Перемещает элемент, на который указывает it от other в *this. Элемент вставляется перед элементом, на который указывает pos.

Оригинал:

Moves the element pointed to by it from other into *this. The element is inserted before the element pointed to by pos.

Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

3)

Перемещение элементов в диапазоне от [first, last) other в *this. Элементы вставляются перед элементом, на который указывает pos. Поведение неопределено, если pos это итератор в диапазоне [first,last).

Оригинал:

Moves the elements in the range [first, last) from other into *this. The elements are inserted before the element pointed to by pos. The behavior is undefined if pos is an iterator in the range [first,last).

Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

Параметры

pos	—	Элемент, перед которым содержание будет вставлен Оригинал: element before which the content will be inserted Текст был переведён автоматически используя Переводчик Google. Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.
other	—	другой контейнер, чтобы переместить содержимое Оригинал: another container to move the content from Текст был переведён автоматически используя Переводчик Google. Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.
it	—	элемент, чтобы перейти от other в *this Оригинал: the element to move from other to *this Текст был переведён автоматически используя Переводчик Google. Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.
first, last	—	диапазон элементов, чтобы перейти от other в *this Оригинал: the range of elements to move from other to *this Текст был переведён автоматически используя Переводчик Google. Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

Возвращаемое значение

(Нет)

Сложность

1-2)

Постоянное.

Оригинал:

Constant.

Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

3)

Постоянные если this == &other, в противном случае линейного по std::distance(first, last).

Оригинал:

Constant if this == &other, otherwise linear in std::distance(first, last).

Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

Пример

Запустить этот код

#include <iostream>
#include <list>

std::ostream& operator<<(std::ostream& ostr, const std::list<int>& list)
{
    for (auto &i : list) {
        ostr << " " << i;
    }
    return ostr;
}

int main ()
{
    std::list<int> list1 = { 1, 2, 3, 4, 5 };
    std::list<int> list2 = { 10, 20, 30, 40, 50 };

    auto it = list1.begin();
    std::advance(it, 2);

    list1.splice(it, list2);

    std::cout << "list1: " << list1 << "\n";
    std::cout << "list2: " << list2 << "\n";

    list2.splice(list2.begin(), list1, it, list1.end());

    std::cout << "list1: " << list1 << "\n";
    std::cout << "list2: " << list2 << "\n";
}

Вывод:

list1:  1 2 10 20 30 40 50 3 4 5
list2:
list1:  1 2 10 20 30 40 50
list2:  3 4 5

См. также

merge	сливает два отсортированных списка (public функция-элемент)
removeremove_if	удаляет элементы, соответствующие определённым критериям (public функция-элемент)