Spec-Zone.ru › C++

руководства по выводу аргументов шаблона для std::forward_list

Определено в заголовке <forward_list>
template< class InputIt,
          class Alloc = std::allocator<
              typename std::iterator_traits<InputIt>::value_type> >
forward_list( InputIt, InputIt, Alloc = Alloc() )
    -> forward_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>> >
forward_list( std::from_range_t, R&&, Alloc = Alloc() )
    -> forward_list<ranges::range_value_t<R>, Alloc>;
(2) (начиная с C++23)
1) Это руководство по выводу аргументов предоставлено для forward_list, чтобы разрешить вывод аргументов по диапазону итераторов. Эта перегрузка участвует в разрешении перегрузки, только если InputIt удовлетворяет требованиям LegacyInputIterator, а Alloc удовлетворяет требованиям Allocator.
2) Это руководство по выводу аргументов предоставлено для forward_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 <forward_list>
#include <vector>

int main()
{
    std::vector<int> v = {1, 2, 3, 4};

    // uses explicit deduction guide to deduce std::forward_list<int>
    std::forward_list x(v.begin(), v.end());

    // deduces std::forward_list<std::vector<int>::iterator>
    // first phase of overload resolution for list-initialization selects the candidate
    // synthesized from the initializer-list constructor; second phase is not performed
    // and deduction guide has no effect
    std::forward_list y{v.begin(), v.end()};
}

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/cpp/container/forward_list/deduction_guides

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API