CKTIS / C++
std::basic_string::size — počet prvků řetězce
`size()` počítá uložené prvky, nikoli znaky vnímané uživatelem. Hodí se k určení rozsahu kopírování, kontrole indexů a zkracování polí.
Verze: 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 je členská funkce const bez parametrů, deklarovaná v <string>. Vrací počet prvků CharT v typu size_type bez znaménka. Pracuje v konstantním čase O(1), řetězec nemění, je noexcept a od C++20 je constexpr. length() vrací stejnou hodnotu; capacity() udává kapacitu úložiště, nikoli délku obsahu.
Nuly uvnitř řetězce se započítávají, koncový nulový znak nikoli. U std::string se počítají prvky char, tedy bajty ve smyslu C++; u std::u8string s textem v UTF-8 se počítají kódové jednotky char8_t. Výsledek neudává počet kódových bodů Unicode ani znaků vnímaných uživatelem. Zkrácení podle počtu prvků může rozdělit sekvenci UTF-8.
Chceš-li přesnou kopii, předej s.data() a s.size() rozhraní, které přijímá počet prvků; rozhraní hledající koncový znak se zastaví u první nuly. Pokud je velikost cílového bufferu uvedena v bajtech, ověř ji v bajtech: obsah zabírá s.size() * sizeof(CharT) bajtů bez koncového znaku. Ukazatel získaný z data() nepoužívej po zániku řetězce ani po operaci, která ukazatel zneplatní.
Před čtením prvku pomocí s[i] ověř i < s.size(); na pozici s.size() je koncový nulový znak, ne prvek obsahu. at(i) při i >= s.size() vyvolá výjimku std::out_of_range. Chceš-li ponechat nejvýše poslední čtyři prvky, použij s.substr(n - 4) jen tehdy, když je n = s.size() větší než 4; jinak ponech celý řetězec. Tím zabráníš podtečení při odečítání bez znaménka. Je-li oddělovač povinný, porovnej výsledek find() s npos, než vypočteš začátek dalšího pole.
Příklady
#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';
}Výsledek
10 1 3456 2
`10` zahrnuje vnitřní nulu a `1` potvrzuje, že zůstala v kopii. `3456` jsou poslední čtyři prvky pole a `2` je počet kódových jednotek UTF-8 pro U+00E9.
Související lekce
- C++ · Lekce 49 · Pokročilá · Verze: 3
- C++ · Lekce 53 · Pokročilá · Verze: 3
- C++ · Lekce 58 · Pokročilá · Verze: 3
Zdroje
- 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