CKTIS / C++
std::basic_string::size — počet prvkov reťazca
`size()` počíta uložené prvky, nie znaky vnímané používateľom. Pomáha určiť rozsah kopírovania, skontrolovať indexy a skrátiť polia.
Verzia: ISO C++23; implementation support may vary
Syntax
#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á funkcia const bez parametrov, deklarovaná v <string>. Vracia počet prvkov CharT v type size_type bez znamienka. Pracuje v konštantnom čase O(1), nemení reťazec, je noexcept a od C++20 je constexpr. length() vracia rovnakú hodnotu; capacity() udáva kapacitu úložiska, nie dĺžku obsahu.
Nuly vnútri reťazca sa započítavajú, koncový nulový znak nie. Pri std::string sa počítajú prvky char, čiže bajty v zmysle C++; pri std::u8string s textom v UTF-8 sa počítajú kódové jednotky char8_t. Výsledok neudáva počet kódových bodov Unicode ani znakov vnímaných používateľom. Skrátenie podľa počtu prvkov môže rozdeliť sekvenciu UTF-8.
Ak chceš presnú kópiu, odovzdaj s.data() a s.size() rozhraniu, ktoré prijíma počet prvkov; rozhranie hľadajúce koncový znak sa zastaví pri prvej nule. Ak sa veľkosť cieľového buffera meria v bajtoch, skontroluj ju v bajtoch: obsah zaberá s.size() * sizeof(CharT) bajtov bez koncového znaku. Smerník získaný z data() nepoužívaj po zániku reťazca ani po operácii, ktorá smerník zneplatní.
Pred čítaním prvku cez s[i] over i < s.size(); na pozícii s.size() je koncový nulový znak, nie prvok obsahu. at(i) pri i >= s.size() vyvolá výnimku std::out_of_range. Ak chceš ponechať najviac posledné štyri prvky, použi s.substr(n - 4) iba vtedy, keď je n = s.size() väčšie ako 4; inak ponechaj celý reťazec. Vyhneš sa tak podtečeniu pri odčítaní bez znamienka. Ak je oddeľovač povinný, porovnaj výsledok find() s npos ešte pred výpočtom začiatku ďalšieho poľa.
Prí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ýsledok
10 1 3456 2
`10` zahŕňa vnútornú nulu a `1` potvrdzuje, že sa zachovala v kópii. `3456` sú posledné štyri prvky poľa a `2` je počet kódových jednotiek UTF-8 pre U+00E9.
Súvisiace lekcie
- C++ · Lekcia 49 · Pokročilá · Verzia: 3
- C++ · Lekcia 53 · Pokročilá · Verzia: 3
- C++ · Lekcia 58 · Pokročilá · Verzia: 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