Namespaces
Variants

deduction guides for std::list

From cppreference.net

C++
Containers library
std::list
Member functions
Non-member functions
(until C++20) (until C++20) (until C++20) (until C++20) (until C++20)
Deduction guides (C++17)
Определено в заголовочном файле <list>
template < class InputIt,

class Alloc = std:: allocator <
typename std:: iterator_traits < InputIt > :: value_type > >
list ( InputIt, InputIt, Alloc = Alloc ( ) )

- > list < typename std:: iterator_traits < InputIt > :: value_type , Alloc > ;
(1) (начиная с C++17)
template < ranges:: input_range R,

class Alloc = std:: allocator < ranges:: range_value_t < R >> >
list ( std:: from_range_t , R && , Alloc = Alloc ( ) )

- > list < ranges:: range_value_t < R > , Alloc > ;
(2) (начиная с C++23)
1) Данный deduction guide предоставляется для list, чтобы позволить выведение аргументов из диапазона итераторов. Эта перегрузка участвует в разрешении перегрузки только если InputIt удовлетворяет требованиям LegacyInputIterator и Alloc удовлетворяет требованиям Allocator .
2) Данный гид вывода предоставлен для list, чтобы позволить вывод из тега std::from_range_t и input_range .

Примечание: степень, в которой библиотека определяет, что тип не удовлетворяет требованиям LegacyInputIterator , не специфицирована, за исключением того, что как минимум целочисленные типы не квалифицируются как входные итераторы. Аналогично, степень, в которой она определяет, что тип не удовлетворяет требованиям Allocator , не специфицирована, за исключением того, что как минимум тип-член Alloc::value_type должен существовать, и выражение std:: declval < Alloc & > ( ) . allocate ( std:: size_t { } ) должно быть корректным при рассмотрении как невычисляемый операнд.

Примечания

Макрос тестирования возможностей Значение Стандарт Функция
__cpp_lib_containers_ranges 202202L (C++23) Ориентированное на диапазоны создание и вставка; перегрузка (2)

Пример

Запустить этот код 
#include <list>
#include <vector>
int main()
{
    std::vector<int> v = {1, 2, 3, 4};
    // использует явный направляющий вывод для вывода std::list<int>
    std::list x(v.begin(), v.end());
    // выводит std::list<std::vector<int>::iterator>
    // первая фаза разрешения перегрузки для list-инициализации выбирает кандидата,
    // синтезированного из конструктора initializer-list; вторая фаза не выполняется
    // и направляющий вывод не оказывает эффекта
    std::list y{v.begin(), v.end()};
}