Просмотр кода страницы cpp/container/map

У вас нет прав на выполнение действия «редактирование этой страницы» по следующей причине:
Запрошенное действие могут выполнять участники одной из следующих групп: Участники, Администраторы.
Вы можете просмотреть и скопировать исходный код этой страницы.
{{cpp/title|map}}
{{cpp/container/map/navbar}}
{{dcl begin}}
{{dcl header|map}}
{{dcl|num=1|1=
template<
    class Key,
    class T,
    class Compare = std::less<Key>,
    class Allocator = std::allocator<std::pair<const Key, T>>
> class map;
}}
{{dcl|num=2|since=c++17|1=
namespace pmr {
template<
    class Key,
    class T,
    class Compare = std::less<Key>
> using map = std::map<Key, T, Compare,
                       std::pmr::polymorphic_allocator<std::pair<const Key, T>>>;
}
}}
{{dcl end}}

{{tt|std::map}} это сортируемый ассоциативный контейнер, который содержит пары ключ-значение с уникальными ключами. Ключи сортируются с помощью функции сравнения {{tt|Compare}}. Операции поиска, удаления и вставки имеют логарифмическую сложность. Карты обычно реализуются как {{enwikiru|Красно-чёрное дерево|красно-чёрные деревья}}.

Везде, где стандартная библиотека использует требования {{named req|Compare}}, уникальность определяется с помощью отношения эквивалентности. Грубо говоря, два объекта {{tt|a}} и {{tt|b}} считаются эквивалентными (не уникальными), если ни один из них при сравнении не меньше, чем другой: {{c|!comp(a, b) && !comp(b, a)}}.

{{tt|std::map}} соответствует требованиям {{concept|Container}}, {{concept|AllocatorAwareContainer}}, {{concept|AssociativeContainer}} и {{concept|ReversibleContainer}}.

===Параметры шаблона===
{{todo|Добавить описания параметров шаблона.}}

===Типы элементы===
{{dsc begin}}
{{dsc hitem | Тип элемент | Определение}}
{{dsc inc | cpp/container/dsc key_type | map}}
{{dsc inc | cpp/container/dsc mapped_type | map}}
{{dsc inc | cpp/container/dsc value_type | map}}
{{dsc inc | cpp/container/dsc size_type | map}}
{{dsc inc | cpp/container/dsc difference_type | map}}
{{dsc inc | cpp/container/dsc key_compare | map}}
{{dsc inc | cpp/container/dsc allocator_type | map}}
{{dsc inc | cpp/container/dsc reference | map}}
{{dsc inc | cpp/container/dsc const_reference | map}}
{{dsc inc | cpp/container/dsc pointer | map}}
{{dsc inc | cpp/container/dsc const_pointer | map}}
{{dsc inc | cpp/container/dsc iterator | map}}
{{dsc inc | cpp/container/dsc const_iterator | map}}
{{dsc inc | cpp/container/dsc reverse_iterator | map}}
{{dsc inc | cpp/container/dsc const_reverse_iterator | map}}
{{dsc inc | cpp/container/dsc node_type | map}}
{{dsc inc | cpp/container/dsc insert_return_type | map}}
{{dsc end}}

===Классы элементы===
{{dsc begin}}
{{dsc inc | cpp/container/dsc value_compare | map}}
{{dsc end}}

===Функции элементы===
{{dsc begin}}
{{dsc inc | cpp/container/dsc constructor | map}}
{{dsc inc | cpp/container/dsc destructor | map}}
{{dsc inc | cpp/container/dsc operator{{=}} | map}}
{{dsc inc | cpp/container/dsc get_allocator | map}}

{{dsc h2 | Доступ к элементам}}
{{dsc inc | cpp/container/dsc at | map}}
{{dsc inc | cpp/container/dsc operator_at | map}}

{{dsc h2 | Итераторы}}
{{dsc inc | cpp/container/dsc begin | map}}
{{dsc inc | cpp/container/dsc end | map}}
{{dsc inc | cpp/container/dsc rbegin | map}}
{{dsc inc | cpp/container/dsc rend | map}}

{{dsc h2 | Ёмкость}}
{{dsc inc | cpp/container/dsc empty | map}}
{{dsc inc | cpp/container/dsc size | map}}
{{dsc inc | cpp/container/dsc max_size | map}}

{{dsc h2 | Модификаторы}}
{{dsc inc | cpp/container/dsc clear | map}}
{{dsc inc | cpp/container/dsc insert | map}}
{{dsc inc|cpp/container/dsc insert_range|map}}
{{dsc inc | cpp/container/dsc insert_or_assign | map}}
{{dsc inc | cpp/container/dsc emplace | map}}
{{dsc inc | cpp/container/dsc emplace_hint | map}}
{{dsc inc | cpp/container/dsc try_emplace | map}}
{{dsc inc | cpp/container/dsc erase | map}}
{{dsc inc | cpp/container/dsc swap | map}}
{{dsc inc | cpp/container/dsc extract | map}}
{{dsc inc | cpp/container/dsc merge | map}}

{{dsc h2 | Просмотр}}
{{dsc inc | cpp/container/dsc count | map}}
{{dsc inc | cpp/container/dsc find | map}}
{{dsc inc | cpp/container/dsc contains | map}}
{{dsc inc | cpp/container/dsc equal_range | map}}
{{dsc inc | cpp/container/dsc lower_bound | map}}
{{dsc inc | cpp/container/dsc upper_bound | map}}

{{dsc h2 | Наблюдатели}}
{{dsc inc | cpp/container/dsc key_comp | map}}
{{dsc inc | cpp/container/dsc value_comp | map}}
{{dsc end}}

===Функции, не являющиеся элементами===
{{dsc begin}}
{{dsc inc | cpp/container/dsc operator_cmp | map}}
{{dsc inc | cpp/container/dsc swap2 | map}}
{{dsc inc | cpp/container/dsc erase_if | map}}
{{dsc end}}

{{rrev|noborder=true|since=c++17|{{=}}{{=}}{{=}}{{rl|deduction guides|Принципы вывода}}{{=}}{{=}}{{=}}}}

===Примечание===
{{ftm begin|std=1|comment=1}}
{{ftm|__cpp_lib_containers_ranges|value=202202L|std=C++23|Создание и вставка диапазонов для контейнеров}}
{{ftm end}}

===Пример===
{{example|code=
#include <iostream>
#include <map>
#include <string>
#include <string_view>

void print_map(std::string_view comment, const std::map<std::string, int>& m)
{
    std::cout << comment;
    // итерация с использованием средств C++17
    for (const auto& [key, value] : m) {
        std::cout << '[' << key << "] = " << value << "; ";
    }
// альтернатива C++11:
//  for (const auto& n : m) {
//      std::cout << '[' << n.first << "] = " << n.second << "; ";
//  }
// альтернатива C++98:
//  for (std::map<std::string, int>::const_iterator it = m.begin(); it != m.end(); it++) {
//      std::cout << '[' << it->first << "] = " << it->second << "; ";
//  }
    std::cout << "\n";
}

int main()
{
    // Создаём карту из трёх строк (которые отображаются на целые числа)
    std::map<std::string, int> m { {"CPU", 10}, {"GPU", 15}, {"RAM", 20}, };

    print_map("1) Начальная карта: ", m);

    m["CPU"] = 25;  // модифицируем существующее значение
    m["SSD"] = 30;  // вставляем новое значение

    print_map("2) Модифицированная карта: ", m);

    // использование operator[] с несуществующим ключом всегда выполняет вставку
    std::cout << "3) m[UPS] = " << m["UPS"] << '\n';
    print_map("4) Модифицированная карта: ", m);

    m.erase("GPU");
    print_map("5) После стирания: ", m);

    std::erase_if(m, [](const auto& pair){ return pair.second > 25; });
    print_map("6) После стирания: ", m);
    std::cout << "7) m.size() = " << m.size() << '\n';

    m.clear();
    std::cout << std::boolalpha << "8) Карта пуста: " << m.empty() << '\n';
}
| output=
1) Начальная карта: [CPU] = 10; [GPU] = 15; [RAM] = 20; 
2) Модифицированная карта: [CPU] = 25; [GPU] = 15; [RAM] = 20; [SSD] = 30;
3) m[UPS] = 0
4) Модифицированная карта: [CPU] = 25; [GPU] = 15; [RAM] = 20; [SSD] = 30; [UPS] = 0; 
5) После стирания: [CPU] = 25; [RAM] = 20; [SSD] = 30; [UPS] = 0; 
6) После стирания: [CPU] = 25; [RAM] = 20; [UPS] = 0; 
7) m.size() = 3
8) Карта пуста: true
}}

===Отчёты о дефектах===
{{dr list begin}}
{{dr list item|wg=lwg|dr=464|std=C++98|before=доступ к const {{tt|map}} по ключу был неудобным|after=предоставлена функция {{tt|at}}}}
{{dr list end}}

{{langlinks|de|en|es|fr|it|ja|pl|pt|zh}}
Шаблоны, используемые на этой странице:
Возврат к странице cpp/container/map.
cppreference.com

Поиск

Пространства имён

Варианты

Просмотры

Действия

Просмотр кода страницы cpp/container/map

Навигация

Инструменты
