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

CKTIS / C++

std::vector::clear — eliminar todos los elementos sin reducir la capacidad

`std::vector::clear` destruye todos los elementos y deja el tamaño del vector en cero, pero conserva la capacidad para futuras inserciones.

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

Sintaxis

#include <vector>

// Member declaration in std::vector<T, Allocator> (C++23):
constexpr void clear() noexcept;

// Call on a non-const vector v:
v.clear();

std::vector::clear es una función miembro de <vector>: llama a v.clear() sobre un vector que no sea const. No recibe argumentos ni devuelve ningún valor (void). La llamada termina la vida de todos los elementos. Después, v.size() == 0 y v.empty() es verdadero, aunque el vector ya estuviera vacío. La complejidad es lineal respecto al número de elementos antes de la llamada. La función es noexcept desde C++11 y constexpr desde C++20.

La capacidad (v.capacity()) no cambia. Eso no mantiene vivos los elementos anteriores: sus punteros, referencias e iteradores quedan invalidados. Tampoco reutilices un iterador end() guardado antes de la llamada; vuelve a obtener begin() y end() cuando los necesites.

Usa clear() para sustituir los resultados anteriores en vez de añadir otros al final. Si copias los primeros elementos de una secuencia, asegúrate de que el origen siga disponible tras vaciar el destino. clear() no realiza un borrado seguro de la memoria; shrink_to_fit() es una petición independiente y no vinculante para reducir la capacidad.

Ejemplos

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

int main() {
    const std::vector<std::string> ranked{"Ada", "Lin", "Mina"};
    std::vector<std::string> names{"Old A", "Old B", "Old C"};
    constexpr std::vector<std::string>::size_type k = 2;
    const auto count = std::min(k, ranked.size());
    const auto old_capacity = names.capacity();

    names.clear();
    std::cout << "size after clear: " << names.size() << '\n';
    std::cout << "capacity unchanged: " << std::boolalpha
              << (names.capacity() == old_capacity) << '\n';

    for (decltype(names)::size_type i = 0; i < count; ++i) {
        names.push_back(ranked[i]);
    }

    std::cout << "replacement names:\n";
    for (const auto& name : names) {
        std::cout << name << '\n';
    }
}

Resultado

size after clear: 0
capacity unchanged: true
replacement names:
Ada
Lin

El programa limita `k` al tamaño del vector de origen independiente, vacía `names` y añade los primeros elementos seleccionados. Compara la capacidad antes y después del vaciado sin suponer un valor numérico concreto.

Lecciones relacionadas

  • C++ · Lección 23 · Avanzado · Versión: 3

Fuentes