CKTIS / C++
std::vector::size — nombre d’éléments d’un vecteur
`size()` renvoie le nombre actuel d’éléments en temps constant. C’est ce nombre, et non `capacity()`, qui détermine les indices valides.
Version : ISO C++23; implementation support may vary
Syntaxe
// 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 est une fonction membre sans argument déclarée dans <vector>. Elle renvoie par valeur le nombre d’éléments dans [v.begin(), v.end()) (zéro si le vecteur est vide). Elle s’exécute en temps constant, O(1), et peut être appelée sur un vecteur const. Elle est noexcept depuis C++11 et constexpr depuis C++20 : elle peut donc être utilisée dans une expression constante si l’évaluation complète le permet. Cette fiche décrit ISO C++23 ; la prise en charge peut varier selon l’implémentation.
capacity() indique combien d’éléments le vecteur peut contenir sans réallocation. Un appel réussi à reserve(n) garantit une capacité d’au moins n éléments, mais n’en crée aucun. resize(n) fixe le nombre d’éléments à n, et un appel réussi à push_back l’augmente de un. Pour savoir uniquement si le vecteur est vide, utilisez v.empty().
Le type de retour, size_type, est un type entier non signé, pas nécessairement std::size_t. Conservez-le avec auto plutôt que de convertir sans vérification en int. Les indices valides vérifient 0 <= i < v.size() en notation mathématique ; ce n’est pas une condition C++. Avant de convertir un indice en size_type, rejetez les valeurs négatives et celles qui dépassent la valeur maximale de ce type. Sinon, même une valeur non négative d’un type entier plus large peut donner après conversion un indice différent qui se trouve dans les limites. v[i] exige un indice valide ; v.at(i) vérifie l’indice après sa conversion en size_type et lève std::out_of_range si l’indice converti est supérieur ou égal à v.size(). Ne calculez pas v.size() - 1 pour un vecteur vide. Pour un nombre d’éléments de type signé, utilisez std::ssize(v) de <iterator> (depuis C++20).
Si le type des éléments n’est pas bool, l’intervalle [v.data(), v.data() + v.size()) couvre les éléments existants ; ne déréférencez pas le pointeur de fin. std::vector<bool> compte aussi ses éléments, mais n’expose pas un tel tampon bool*. Un nombre mémorisé ne se met pas à jour lorsque le vecteur change. Une réallocation invalide les pointeurs, références et itérateurs vers les éléments, ainsi que l’ancien end(). Un ajout en fin invalide l’ancien end() même sans réallocation.
Exemples
#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';
}
Résultat
after reserve: 0 after append: 2 saved size: 0 after resize: 1
Après `reserve(8)`, le vecteur est toujours vide. Deux appels à `push_back` portent sa taille à 2, mais `before` reste à 0. `resize(1)` retire le dernier élément. Le programme ne suppose aucune capacité exacte.
Leçons associées
- C++ · Leçon 11 · Avancé · Version : 3
- C++ · Leçon 14 · Avancé · Version : 3
- C++ · Leçon 15 · Avancé · Version : 3
- C++ · Leçon 18 · Avancé · Version : 3
- C++ · Leçon 23 · Avancé · Version : 3
- C++ · Leçon 24 · Avancé · Version : 3
- C++ · Leçon 27 · Avancé · Version : 3
- C++ · Leçon 29 · Avancé · Version : 3
- C++ · Leçon 30 · Avancé · Version : 3
- C++ · Leçon 32 · Avancé · Version : 3
- C++ · Leçon 34 · Avancé · Version : 3
- C++ · Leçon 51 · Avancé · Version : 3
- C++ · Leçon 54 · Avancé · Version : 3
- C++ · Leçon 57 · Avancé · Version : 3
- C++ · Leçon 58 · Avancé · Version : 3
- C++ · Leçon 59 · Avancé · Version : 3
Sources
- 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]