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

CKTIS / C++

std::vector::size — número de elementos de um vetor

`size()` devolve o número atual de elementos em tempo constante. É esse número, e não `capacity()`, que determina os índices válidos.

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

Sintaxe

// Header: <vector>
// Member declaration inside std::vector<T, Allocator> (ISO C++23)
constexpr size_type size() const noexcept;

// Call on a vector v:
auto count = v.size();

std::vector::size é uma função membro sem argumentos declarada em <vector>. Devolve por valor o número de elementos em [v.begin(), v.end()) (zero se o vetor estiver vazio). Corre em tempo constante, O(1), e pode ser chamada num vetor const. É noexcept desde C++11 e constexpr desde C++20, pelo que pode ser usada numa expressão constante se a avaliação completa o permitir. Esta entrada descreve ISO C++23; o suporte pode variar consoante a implementação.

capacity() indica quantos elementos o vetor pode conter sem realocar memória. Uma chamada bem-sucedida a reserve(n) garante capacidade para pelo menos n elementos, mas não cria nenhum. resize(n) fixa o número de elementos em n, e uma chamada bem-sucedida a push_back aumenta-o em um. Se só quiseres verificar se o vetor está vazio, usa v.empty().

O tipo devolvido, size_type, é um tipo inteiro sem sinal, não necessariamente std::size_t. Preserva-o com auto em vez de o converter para int sem verificar. Os índices válidos satisfazem 0 <= i < v.size() em notação matemática; isto não é uma condição em C++. Antes de converteres um índice para size_type, rejeita os valores negativos e os que excedam o máximo desse tipo. Caso contrário, até um valor não negativo de um tipo inteiro mais largo pode dar, após a conversão, um índice diferente que fique dentro dos limites. v[i] exige um índice válido; v.at(i) verifica o índice após a conversão para size_type e lança std::out_of_range se o índice convertido for maior ou igual a v.size(). Não calcules v.size() - 1 num vetor vazio. Se precisares de uma contagem com sinal, usa std::ssize(v) de <iterator> (desde C++20).

Se o tipo de elemento não for bool, o intervalo [v.data(), v.data() + v.size()) abrange os elementos existentes; não desreferencies o ponteiro final. std::vector<bool> também conta elementos, mas não expõe um buffer bool* desse tipo. Uma contagem guardada não é atualizada quando o vetor muda. A realocação invalida os ponteiros, as referências e os iteradores para os elementos, bem como o antigo end(). Acrescentar um elemento no fim invalida o antigo end() mesmo sem realocação.

Exemplos

#include <iostream>
#include <vector>

int main() {
    std::vector<int> v;
    const auto before = v.size();

    v.reserve(8);
    std::cout << "after reserve: " << v.size() << '\n';

    v.push_back(10);
    v.push_back(20);
    std::cout << "after append: " << v.size() << '\n';
    std::cout << "saved size: " << before << '\n';

    v.resize(1);
    std::cout << "after resize: " << v.size() << '\n';
}

Resultado

after reserve: 0
after append: 2
saved size: 0
after resize: 1

Depois de `reserve(8)`, o vetor continua vazio. Duas chamadas a `push_back` aumentam o tamanho para 2, mas `before` continua a valer 0. `resize(1)` remove o último elemento. O programa não pressupõe uma capacidade exata.

Lições relacionadas

  • C++ · Lição 11 · Avançado · Versão: 3
  • C++ · Lição 14 · Avançado · Versão: 3
  • C++ · Lição 15 · Avançado · Versão: 3
  • C++ · Lição 18 · Avançado · Versão: 3
  • C++ · Lição 23 · Avançado · Versão: 3
  • C++ · Lição 24 · Avançado · Versão: 3
  • C++ · Lição 27 · Avançado · Versão: 3
  • C++ · Lição 29 · Avançado · Versão: 3
  • C++ · Lição 30 · Avançado · Versão: 3
  • C++ · Lição 32 · Avançado · Versão: 3
  • C++ · Lição 34 · Avançado · Versão: 3
  • C++ · Lição 51 · Avançado · Versão: 3
  • C++ · Lição 54 · Avançado · Versão: 3
  • C++ · Lição 57 · Avançado · Versão: 3
  • C++ · Lição 58 · Avançado · Versão: 3
  • C++ · Lição 59 · Avançado · Versão: 3

Fontes