std::map<Key,T,Compare,Allocator>::begin, std::map<Key,T,Compare,Allocator>::cbegin

 

C++

Apoyo de compiladores

Implementaciones independientes y albergadas

Lenguaje

Biblioteca estándar

Encabezados de la biblioteca estándar

Requisitos denominados

Macros de prueba de característica (C++20)

Biblioteca de apoyo del lenguaje

Biblioteca de conceptos(C++20)

Biblioteca de diagnósticos

Biblioteca de gestión de memoria

Biblioteca de metaprogramación(C++11)

Biblioteca de servicios generales

Biblioteca de contenedores

Biblioteca de iteradores

Biblioteca de rangos(C++20)

Biblioteca de algoritmos

Biblioteca de cadenas

Biblioteca de procesamiento de texto

Biblioteca numérica

Biblioteca de fecha y hora

Biblioteca de entrada/salida

Biblioteca del sistema de archivos(C++17)

Biblioteca de apoyo de concurrencia(C++11)

Biblioteca de apoyo de ejecución(C++26)

Especificaciones técnicas

Índice de símbolos

Bibliotecas externas

 

Biblioteca de contenedores

De secuencias

array (C++11)

vector

vector<bool>

inplace_vector (C++26)

deque

forward_list (C++11)

list

Asociativos

set

multiset

map

multimap

Asociativos no ordenados

unordered_set (C++11)

unordered_multiset (C++11)

unordered_map (C++11)

unordered_multimap (C++11)

Adaptadores

stack

queue

priority_queue

flat_set (C++23)

flat_multiset (C++23)

flat_map (C++23)

flat_multimap (C++23)

Vistas

span (C++20)

mdspan (C++23)

Tablas

Invalidación de iteradores

Tabla de funciones miembro

Tabla de funciones no miembro

 

std::map

Funciones miembro

map::map map::~map               map::operator= map::get_allocator

Acceso a elementos map::at map::operator[] Iteradores map::beginmap::cbegin (C++11) map::endmap::cend (C++11) map::rbeginmap::crbegin (C++11)      map::rendmap::crend (C++11) Capacidad map::size map::max_size map::empty Observadores map::key_comp map::value_comp Modificadores map::clear map::insert map::erase map::swap map::extract (C++17) map::merge (C++17) map::insert_range (C++23) map::insert_or_assign (C++17) map::emplace (C++11) map::emplace_hint (C++11) map::try_emplace (C++17) Búsqueda map::count map::find map::contains (C++20) map::equal_range map::lower_bound map::upper_bound

Funciones no miembro

operator==operator<=> (C++20) std::swap(std::map) erase_if(std::map) (C++20)   operator!=operator<operator>operator<=operator>= (hasta C++20)(hasta C++20)(hasta C++20)(hasta C++20)(hasta C++20)

Guías de deducción(C++17)

 

iterator begin();		(hasta C++11)
iterator begin()noexcept;		(desde C++11)
const_iterator begin()const;		(hasta C++11)
const_iterator begin()constnoexcept;		(desde C++11)
const_iterator cbegin()constnoexcept;		(desde C++11)

Devuelve un iterador al primer elemento del map.

Si el map está vacío, el iterador devuelto será igual a end().

Parámetros

(Ninguno)

Valor de retorno

Iterador al primer elemento.

Complejidad

Constante.

Ejemplo

Ejecuta este código

#include <iostream>#include <map>   int main(){std::map<int, float> map_num;// mapa de números map_num[4]=4.13; map_num[9]=9.24; map_num[1]=1.09;// llama a map.begin() y a map.end()for(auto it = map_num.begin(); it != map_num.end();++it){std::cout<< it->first <<", "<< it->second <<'\n';}}

Salida:

1, 1.09 4, 4.13 9, 9.24

Ejemplo usando una función de comparación personalizada

Ejecuta este código

#include <cmath>#include <iostream>#include <map>   struct Punto {double x, y;};   // Compara las coordenadas x de dos punteros a Puntostruct CompDePuntos {bool operator()(const Punto *lhs, const Punto *rhs)const{return lhs->x < rhs->x;}};   int main(){// Observa que aunque las coordenadas x no están en orden,// el map se iterará a través de coordenadas x que se incrementan Punto puntos[3]={{2, 0}, {1, 0}, {3, 0}};   // mag es un map que manda la dirección de un nodo a su magnitud en el plano x-y// Aunque las claves son punteros a Punto, queremos ordenar el map por las// coordenadas x de los puntos y NO por las direcciones de los Puntos. Esto// se hace usando la función miembro de comparación de la clase CompDePuntos.std::map<Punto*, double, CompDePuntos> mag({{ puntos, 2}, { puntos +1, 1}, { puntos +2, 3}});   // Cambiar cada coordenada y de 0 a la magnitudfor(auto iter = mag.begin(); iter != mag.end();++iter){auto actual = iter->first;// puntero a Node actual->y = mag[actual];// could also have used actual->y = iter->second;}   // Actualizar e imprimir la magnitud de cada nodofor(auto iter = mag.begin(); iter != mag.end();++iter){auto actual = iter->first; mag[actual]=std::hypot(actual->x, actual->y);std::cout<<"La magnitud de ("<< actual->x <<", "<< actual->y <<") es ";std::cout<< iter->second <<'\n';}   // Repetir lo de arriba con el bucle for basado en rangofor(auto i : mag){auto actual = i.first; actual->y = i.second; mag[actual]=std::hypot(actual->x, actual->y);std::cout<<"La magnitud de ("<< actual->x <<", "<< actual->y <<") es ";std::cout<< mag[actual]<<'\n';// Observa que a diferencia de std::cout << iter->second << '\n'; arriba, // std::cout << i.second << '\n'; NO imprimirá la magnitud actualizada.// Si se usara auto &i: mag, imprimiría la magnitud actualizada}}

Salida:

La magnitud de (1, 1) es 1.41421 La magnitud de (2, 2) es 2.82843 La magnitud de (3, 3) es 4.24264 La magnitud de (1, 1.41421) es 1.73205 La magnitud de (2, 2.82843) es 3.4641 La magnitud de (3, 4.24264) es 5.19615

Véase también

end cend (C++11)

Devuelve un iterador al final. (función miembro pública)