Spec-Zone.ru › C++

Руководства по выводу типов для std::multimap

Определено в заголовке <map>
template< class InputIt,
          class Comp = std::less<iter_key_t<InputIt>>,
          class Alloc = std::allocator<iter_to_alloc_t<InputIt>> >
multimap( InputIt, InputIt, Comp = Comp(), Alloc = Alloc() )
    -> multimap<iter_key_t<InputIt>, iter_val_t<InputIt>, Comp, Alloc>;
(1) (с C++17)
template< class Key,
          class T,
          class Comp = std::less<Key>,
          class Alloc = std::allocator<std::pair<const Key, T>> >
multimap( std::initializer_list<std::pair<Key, T>>, Comp = Comp(), Alloc = Alloc() )
    -> multimap<Key, T, Comp, Alloc>;
(2) (с C++17)
template< class InputIt, class Alloc >
multimap( InputIt, InputIt, Alloc )
    -> multimap<iter_key_t<InputIt>, iter_val_t<InputIt>,
                std::less<iter_key_t<InputIt>>, Alloc>;
(3) (с C++17)
template< class Key, class T, class Alloc >
multimap( std::initializer_list<std::pair<Key, T>>, Alloc )
    -> multimap<Key, T, std::less<Key>, Alloc>;
(4) (с C++17)
template< ranges::input_range R, class Compare = std::less<range_key_t<R>,
          class Alloc = std::allocator<range_to_alloc_t<R>> >
multimap( std::from_range_t, R&&, Compare = Compare(), Alloc = Alloc() )
    -> multimap<range_key_t<R>, range_mapped_t<R>, Compare, Alloc>;
(5) (с C++23)
template< ranges::input_range R, class Alloc >
multimap( std::from_range_t, R&&, Alloc )
    -> multimap<range_key_t<R>, range_mapped_t<R>, std::less<range_key_t<R>>, Alloc>;
(6) (с C++23)
Псевдонимы вспомогательных типов только для демонстрации
template< class InputIter >
using iter_val_t =
    typename std::iterator_traits<InputIter>::value_type;
(только для демонстрации*)
template< class InputIter >
using iter_key_t =
    std::remove_const_t< std::tuple_element_t<0, iter_val_t<InputIter>>>;
(только для демонстрации*)
template< class InputIter >
using iter_mapped_t =
    std::tuple_element_t<1, iter_val_t<InputIter>>;
(только для демонстрации*)
template< class InputIter >
using iter_to_alloc_t =
    std::pair<std::add_const_t<tuple_element_t<0, iter_val_t<InputIter>>>,
              std::tuple_element_t<1, iter_val_t<InputIter>>>;
(только для демонстрации*)
template< ranges::input_range Range >
using range_key_t =
    std::remove_const_t<typename ranges::range_value_t<Range>::first_type>;
(с C++23)
(только для демонстрации*)
template< ranges::input_range Range >
using range_mapped_t =
    typename ranges::range_value_t<Range>::second_type;
(с C++23)
(только для демонстрации*)
template< ranges::input_range Range >
using range_to_alloc_t =
    std::pair<std::add_const_t<typename ranges::range_value_t<Range>::first_type>,
              typename ranges::range_value_t<Range>::second_type>;
(с C++23)
(только для демонстрации*)
1-4) Эти руководства по выводу типов предоставляются для multimap для вывода из диапазона итераторов (перегрузки (1,3)) и std::initializer_list (перегрузки (2,4)).
5,6) Эти руководства по выводу типов предоставляются для multimap для вывода из тега std::from_range_t и input_range.

Эти перегрузки участвуют в разрешении перегрузки только в том случае, если InputIt удовлетворяет LegacyInputIterator, Alloc удовлетворяет Allocator, и Comp не удовлетворяет Allocator.

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

Примечания

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

Пример

#include <map>
 
int main()
{
    // std::multimap m1 = {{"foo", 1}, {"bar", 2}};
        // Error: braced-init-list has no type; cannot deduce
        // pair<Key, T> from {"foo", 1} or {"bar", 2}
 
    std::multimap m1 = {std::pair{"foo", 2}, {"bar", 3}}; // guide #2
    std::multimap m2(m1.begin(), m1.end()); // guide #1
}

Отчеты об ошибках

Следующие исправления ошибок, изменяющие поведение, были применены ретроактивно к ранее опубликованным стандартам C++.

DR Примененный к Поведение, как опубликовано Правильное поведение
LWG 3025 C++17 Руководства по инициализации списком принимают std::pair<const Key, T> используйте std::pair<Key, T>

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

Spec-Zone.ru

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