CKTIS / C++
std::basic_string::size — compter les éléments d’une chaîne
`size()` compte les éléments stockés, et non les caractères perçus par l’utilisateur. Cette taille sert à borner les copies, à vérifier les indices et à tronquer des champs.
Version : ISO C++23; implementation support may vary
Syntaxe
#include <string>
// Member declaration inside std::basic_string<CharT, Traits, Allocator> (C++23):
constexpr size_type size() const noexcept;std::basic_string::size est une fonction membre const sans paramètre, déclarée dans <string>. Elle renvoie le nombre d’éléments CharT dans le type non signé size_type. Elle s’exécute en temps constant O(1), ne modifie pas la chaîne, est noexcept et est constexpr depuis C++20. length() renvoie la même valeur ; capacity() indique la capacité de stockage, pas la longueur du contenu.
Les zéros intégrés sont comptés, mais pas le zéro terminal. Pour std::string, le résultat compte les éléments char, c’est-à-dire les octets au sens de C++ ; pour un std::u8string contenant du texte UTF-8, il compte les unités de code char8_t. Il ne compte ni les points de code Unicode ni les caractères perçus par l’utilisateur. Une troncature par nombre d’éléments peut couper une séquence UTF-8.
Pour une copie exacte, passez s.data() et s.size() à une interface qui attend un nombre d’éléments ; une interface qui recherche un terminateur s’arrête au premier zéro. Si le tampon de destination est dimensionné en octets, vérifiez sa taille en octets : le contenu occupe s.size() * sizeof(CharT) octets, sans le terminateur. N’utilisez pas un pointeur obtenu par data() après la destruction de la chaîne ou après une opération qui invalide ce pointeur.
Avant de lire un élément avec s[i], vérifiez i < s.size() ; la position s.size() contient le terminateur, pas un élément du contenu. at(i) lève std::out_of_range si i >= s.size(). Pour conserver au plus les quatre derniers éléments, utilisez s.substr(n - 4) uniquement si n = s.size() est supérieur à 4 ; sinon, gardez la chaîne entière. Vous évitez ainsi le rebouclage de la soustraction non signée. Si un séparateur est obligatoire, comparez le résultat de find() à npos avant de calculer le début du champ suivant.
Exemples
#include <iostream>
#include <string>
int main() {
const std::string record("ID\0:123456", 10);
const std::string copy(record.data(), record.size());
const auto separator = copy.find(':');
if (separator == std::string::npos) {
return 1;
}
const auto field = copy.substr(separator + 1);
constexpr std::string::size_type width = 4;
const auto n = field.size();
const auto tail = n > width ? field.substr(n - width) : field;
const std::u8string utf8 = u8"\u00E9";
std::cout << static_cast<unsigned int>(record.size()) << '\n'
<< (copy[2] == '\0') << '\n'
<< tail << '\n'
<< static_cast<unsigned int>(utf8.size()) << '\n';
}Résultat
10 1 3456 2
`10` inclut le zéro intégré, et `1` confirme sa présence dans la copie. `3456` correspond aux quatre derniers éléments du champ, et `2` au nombre d’unités de code UTF-8 pour U+00E9.
Leçons associées
- C++ · Leçon 49 · Avancé · Version : 3
- C++ · Leçon 53 · Avancé · Version : 3
- C++ · Leçon 58 · Avancé · Version : 3
Sources
- C++ working draft — Capacity [string.capacity]
- C++ working draft — Class template basic_string, general [basic.string.general]
- C++ working draft — General requirements [string.require]
- C++ working draft — Constructors and assignment operators [string.cons]
- C++ working draft — Element access [string.access]
- C++ working draft — Accessors [string.accessors]
- C++ working draft — basic_string::substr [string.substr]
- C++ working draft — Searching [string.find]
- C++ working draft — String view searching [string.view.find]
- C++ working draft — String literals [lex.string]
- cppreference — std::basic_string::size and std::basic_string::length