std::unordered_map::begin, std::unordered_map::cbegin

 

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::unordered_map

Типы элементы

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

unordered_map::unordered_map

unordered_map::~unordered_map

unordered_map::operator=

unordered_map::get_allocator

Итераторы

unordered_map::beginunordered_map::cbegin

unordered_map::endunordered_map::cend

Ёмкость

unordered_map::empty

unordered_map::size

unordered_map::max_size

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

unordered_map::clear

unordered_map::insert

unordered_map::insert_range (C++23)

unordered_map::insert_or_assign (C++17)

unordered_map::emplace

unordered_map::emplace_hint

unordered_map::try_emplace (C++17)

unordered_map::erase

unordered_map::swap

unordered_map::extract (C++17)

unordered_map::merge (C++17)

Просмотр

unordered_map::at

unordered_map::operator[]

unordered_map::count

unordered_map::find

unordered_map::contains (C++20)

unordered_map::equal_range

Интерфейс сегментов

unordered_map::begin(size_type)unordered_map::cbegin(size_type)

unordered_map::end(size_type)unordered_map::cend(size_type)

unordered_map::bucket_count

unordered_map::max_bucket_count

unordered_map::bucket_size

unordered_map::bucket

Политика хэширования

unordered_map::load_factor

unordered_map::max_load_factor

unordered_map::rehash

unordered_map::reserve

Наблюдатели

unordered_map::hash_function

unordered_map::key_eq

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

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

std::swap

erase_if (C++20)

Принципы вывода (C++17)

 

iterator begin() noexcept;		(начиная с C++11)
const_iterator begin() const noexcept;		(начиная с C++11)
const_iterator cbegin() const noexcept;		(начиная с C++11)

Возвращает итератор на первый элемент unordered_map.

Если unordered_map - пуст, возвращаемый итератор будет равен end()

Параметры

(нет)

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

Итератор на первый элемент.

Сложность

Константная.

Example

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

#include <cmath>
#include <iostream>
#include <unordered_map>
 
struct Node { double x, y; };
 
int main() {
    Node nodes[3] = { {1, 0}, {2, 0}, {3, 0} };
 
    // mag - map, сопоставляющий адрес Node к длине вектора на плоскости
    std::unordered_map<Node *, double> mag = {
        { nodes,     1 },
        { nodes + 1, 2 },
        { nodes + 2, 3 }
    };
 
    // Поменяем каждую y координату с 0 до длины вектора
    for(auto iter = mag.begin(); iter != mag.end(); ++iter){
        auto cur = iter->first; // Указатель на Node
        cur->y = mag[cur]; // Также можно использовать cur->y = iter->second;
    }
 
    // Пересчитаем длину и напечатаем
    for(auto iter = mag.begin(); iter != mag.end(); ++iter){
        auto cur = iter->first;
        mag[cur] = std::hypot(cur->x, cur->y);
        std::cout << "Длина (" << cur->x << ", " << cur->y << ") - ";
        std::cout << iter->second << '\n';
    }
 
    // Повторим всё, что выше с циклом по коллекции
    for(auto i : mag) {
        auto cur = i.first;
        cur->y = i.second;
        mag[cur] = std::hypot(cur->x, cur->y);
        std::cout << "Длина (" << cur->x << ", " << cur->y << ") - ";
        std::cout << mag[cur] << '\n';
        // Заметим, что в отличие от std::cout << iter->second << '\n'; выше, 
        // std::cout << i.second << '\n'; не напечатает обновленную длину
    }
}

Возможный вывод:

Длина (3, 3) - 4.24264
Длина (1, 1) - 1.41421
Длина (2, 2) - 2.82843
Длина (3, 4.24264) - 5.19615
Длина (1, 1.41421) - 1.73205
Длина (2, 2.82843) - 3.4641

See also

end cend (C++11)

возвращает итератор на конец (public функция-элемент)