Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C++

std::vector::clear — remover todos os elementos sem reduzir a capacidade

`std::vector::clear` destrói todos os elementos e deixa o tamanho do vetor a zero, mas mantém a capacidade para futuras inserções.

Versão: ISO C++23; implementation support may vary

Sintaxe

#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 é uma função membro de <vector>: chama v.clear() num vetor que não seja const. Não recebe argumentos nem devolve um valor (void). A chamada termina o tempo de vida de todos os elementos. Depois, v.size() == 0 e v.empty() é verdadeiro, mesmo que o vetor já estivesse vazio. A complexidade é linear em relação ao número de elementos antes da chamada. A função é noexcept desde C++11 e constexpr desde C++20.

A capacidade (v.capacity()) mantém-se. Isso não mantém os elementos antigos vivos: os ponteiros, as referências e os iteradores que os designam ficam inválidos. Também não reutilizes um iterador end() guardado antes da chamada; obtém novos iteradores com begin() e end() quando precisares.

Usa clear() para substituir os resultados anteriores em vez de acrescentar novos ao fim. Se copiares os primeiros elementos de uma sequência, garante que a origem continua disponível depois de esvaziares o destino. clear() não apaga de forma segura o conteúdo da memória; shrink_to_fit() é um pedido separado e não vinculativo para reduzir a capacidade.

Exemplos

#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

O programa limita `k` ao tamanho do vetor de origem separado, esvazia `names` e acrescenta os primeiros elementos selecionados. Compara a capacidade antes e depois do esvaziamento sem pressupor um valor numérico específico.

Lições relacionadas

  • C++ · Lição 23 · Avançado · Versão: 3

Fontes