CKTIS / C++
std::basic_string::size — število elementov niza
`size()` šteje shranjene elemente, ne znakov, kot jih zazna uporabnik. Uporabi ga za omejevanje kopiranja, preverjanje indeksov in krajšanje polj.
Različica: 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 je članska funkcija const brez parametrov, deklarirana v <string>. Vrne število elementov CharT kot vrednost nepredznačenega tipa size_type. Izvede se v konstantnem času O(1), niza ne spremeni, je noexcept in je od C++20 constexpr. length() vrne isto vrednost; capacity() opisuje pomnilniško zmogljivost, ne dolžine vsebine.
Vdelane ničle se štejejo, zaključna ničla pa ne. Pri std::string se štejejo elementi char, torej bajti v pomenu C++; pri std::u8string z besedilom UTF-8 se štejejo kodne enote char8_t. Rezultat ni število kodnih točk Unicode niti znakov, kot jih zazna uporabnik. Krajšanje po številu elementov lahko razdeli zaporedje UTF-8.
Za natančno kopijo podaj s.data() in s.size() vmesniku, ki sprejme število elementov; vmesnik, ki išče zaključni znak, se ustavi pri prvi ničli. Če je ciljni medpomnilnik merjen v bajtih, preveri njegovo velikost v bajtih: vsebina zavzema s.size() * sizeof(CharT) bajtov brez zaključnega znaka. Kazalca iz data() ne uporabljaj po uničenju niza ali po operaciji, ki kazalec razveljavi.
Pred branjem elementa s s[i] preveri i < s.size(); na mestu s.size() je zaključni znak, ne element vsebine. at(i) pri i >= s.size() sproži izjemo std::out_of_range. Če želiš obdržati največ zadnje štiri elemente, uporabi s.substr(n - 4) samo, če je n = s.size() večje od 4; sicer obdrži cel niz. Tako se izogneš prehodu na veliko vrednost pri nepredznačenem odštevanju. Če je ločilo obvezno, primerjaj rezultat find() z npos, preden izračunaš začetek naslednjega polja.
Primeri
#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` vključuje vdelano ničlo, `1` pa potrjuje, da je ostala v kopiji. `3456` so zadnji štirje elementi polja, `2` pa je število kodnih enot UTF-8 za U+00E9.
Povezane lekcije
- C++ · Lekcija 49 · Napredna · Različica: 3
- C++ · Lekcija 53 · Napredna · Različica: 3
- C++ · Lekcija 58 · Napredna · Različica: 3
Viri
- 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