Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / C++

std::vector::begin — inicio del rango de un vector

`begin()` devuelve el iterador inicial del vector. La cualificación `const` selecciona la sobrecarga y `end()` marca la posición que no debe desreferenciarse.

Versión: ISO C++23; implementation support may vary

Sintaxis

// Public member declarations of std::vector<T, Allocator> in <vector> (ISO C++23)
constexpr iterator begin() noexcept;
constexpr const_iterator begin() const noexcept;

std::vector::begin es una función miembro disponible en <vector>. Tarda un tiempo constante, O(1), y devuelve un iterador al primer elemento si el vector no está vacío. Ambas sobrecargas son noexcept desde C++11 y constexpr desde C++20; en C++23, la evaluación constante sigue dependiendo del contexto y del soporte de la implementación.

Para un vector no const, v.begin() devuelve un iterator que permite modificar los elementos. Si se accede al vector mediante const, devuelve un const_iterator que no permite modificarlos a través de él. Usa v.cbegin() (desde C++11) para obtener un const_iterator incluso si el vector es modificable. No supongas que un iterador es un puntero sin procesar ni que *it produce un T& para cualquier T: un iterador de escritura de std::vector<bool> usa un objeto proxy.

El rango semiabierto [v.begin(), v.end()) abarca los elementos de un mismo vector y excluye la posición posterior al último. Si el vector está vacío, v.begin() == v.end() y desreferenciar cualquiera de los dos iteradores provoca comportamiento indefinido. Si no hay coincidencias, std::find_if devuelve el límite final que se le pasó; comprueba el resultado antes de usar *it.

Una reasignación de almacenamiento invalida los iteradores, punteros y referencias a los elementos, además de un end() guardado. reserve() no añade elementos, pero puede reasignar el almacenamiento. Sin reasignación, push_back() conserva los iteradores a los elementos existentes, pero invalida el end() anterior. Insertar al principio o borrar el primer elemento puede invalidar un begin() guardado incluso sin reasignación. Obtén nuevos iteradores tras la invalidación. No uses un iterador de un vector temporal después de la expresión completa que creó el vector.

Ejemplos

#include <algorithm>
#include <iostream>
#include <vector>

int main() {
    std::vector<int> values{2, 7, 4};
    if (!values.empty()) {
        *values.begin() = 3;
    }

    const auto& read = values;
    const int threshold = 5;
    const auto last = read.end();
    const auto match = std::find_if(read.begin(), last, [threshold](int value) {
        return value >= threshold;
    });

    if (read.cbegin() != read.cend()) {
        std::cout << *read.cbegin() << '\n';
    }
    if (match != last) {
        std::cout << *match << '\n';
    }

    const std::vector<int> empty;
    if (empty.begin() == empty.end()) {
        std::cout << "empty\n";
    }
}

Resultado

3
7
empty

`*values.begin() = 3` cambia el primer elemento. La búsqueda mediante una referencia `const` usa un umbral capturado por valor y lee la coincidencia `7` solo después de comprobar el límite final. Los iteradores del vector vacío se comparan sin desreferenciarlos.

Lecciones relacionadas

  • C++ · Lección 10 · Avanzado · Versión: 3
  • C++ · Lección 11 · Avanzado · Versión: 3
  • C++ · Lección 14 · Avanzado · Versión: 3
  • C++ · Lección 15 · Avanzado · Versión: 3
  • C++ · Lección 23 · Avanzado · Versión: 3
  • C++ · Lección 29 · Avanzado · Versión: 3
  • C++ · Lección 30 · Avanzado · Versión: 3
  • C++ · Lección 32 · Avanzado · Versión: 3
  • C++ · Lección 34 · Avanzado · Versión: 3
  • C++ · Lección 35 · Avanzado · Versión: 3
  • C++ · Lección 40 · Avanzado · Versión: 3
  • C++ · Lección 45 · Avanzado · Versión: 3
  • C++ · Lección 57 · Avanzado · Versión: 3

Fuentes