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()constnoexcept;		(начиная с C++11)
const_iterator cbegin()constnoexcept;		(начиная с 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 функция-элемент)