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
- C++ working draft — Class template vector [vector]
- C++ working draft — Container requirements [container.reqmts]
- C++ working draft — Sequence containers [sequence.reqmts]
- C++ working draft — Vector capacity [vector.capacity]
- C++ working draft — Vector data [vector.data]
- C++ working draft — Vector modifiers [vector.modifiers]
- C++ working draft — Specialization of vector for bool [vector.bool]
- C++ working draft — Range access [iterator.range]