CKTIS / C++
std::basic_string::size — broj elemenata znakovnog niza
`size()` broji pohranjene elemente, a ne znakove koje korisnik opaža. Upotrijebi je za ograničavanje kopiranja, provjeru indeksa i skraćivanje polja.
Verzija: ISO C++23; implementation support may vary
Sintaksa
#include <string>
// Member declaration inside std::basic_string<CharT, Traits, Allocator> (C++23):
constexpr size_type size() const noexcept;std::basic_string::size članska je funkcija const bez parametara, deklarirana u <string>. Vraća broj elemenata CharT kao vrijednost tipa size_type bez predznaka. Izvodi se u konstantnom vremenu O(1), ne mijenja niz, označena je s noexcept i od C++20 je constexpr. length() vraća istu vrijednost; capacity() opisuje kapacitet pohrane, a ne duljinu sadržaja.
Nule unutar niza broje se, a završni nulti znak ne. Za std::string broje se elementi char, odnosno bajtovi u smislu C++; za std::u8string s tekstom u UTF-8 broje se kodne jedinice char8_t. Rezultat nije broj kodnih točaka Unicodea ni znakova koje korisnik opaža. Skraćivanje prema broju elemenata može presjeći sekvencu UTF-8.
Za točnu kopiju proslijedi s.data() i s.size() sučelju koje prima broj elemenata; sučelje koje traži završni znak staje na prvoj nuli. Ako se veličina odredišnog međuspremnika mjeri u bajtovima, provjeri je u bajtovima: sadržaj zauzima s.size() * sizeof(CharT) bajtova bez završnog znaka. Pokazivač dobiven iz data() nemoj upotrebljavati nakon uništenja niza ili operacije koja pokazivač čini nevaljanim.
Prije čitanja elementa s s[i] provjeri i < s.size(); na položaju s.size() nalazi se završni znak, a ne element sadržaja. at(i) baca iznimku std::out_of_range ako je i >= s.size(). Da zadržiš najviše zadnja četiri elementa, upotrijebi s.substr(n - 4) samo ako je n = s.size() veće od 4; inače zadrži cijeli niz. Tako izbjegavaš prelazak na veliku vrijednost pri oduzimanju bez predznaka. Ako je razdjelnik obavezan, usporedi rezultat find() s npos prije izračuna početka sljedećeg polja.
Primjeri
#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';
}Rezultat
10 1 3456 2
`10` uključuje unutarnju nulu, a `1` potvrđuje da je ostala u kopiji. `3456` su zadnja četiri elementa polja, a `2` je broj kodnih jedinica UTF-8 za U+00E9.
Povezane lekcije
- C++ · Lekcija 49 · Napredno · Verzija: 3
- C++ · Lekcija 53 · Napredno · Verzija: 3
- C++ · Lekcija 58 · Napredno · Verzija: 3
Izvori
- 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