CKTIS / C++
std::basic_string::size — contare gli elementi di una stringa
`size()` conta gli elementi memorizzati, non i caratteri percepiti dall’utente. Serve a delimitare le copie, controllare gli indici e troncare i campi.
Versione: ISO C++23; implementation support may vary
Sintassi
#include <string>
// Member declaration inside std::basic_string<CharT, Traits, Allocator> (C++23):
constexpr size_type size() const noexcept;std::basic_string::size è una funzione membro const senza parametri, dichiarata in <string>. Restituisce il numero di elementi CharT come valore del tipo senza segno size_type. Richiede tempo costante O(1), non modifica la stringa, è noexcept ed è constexpr da C++20. length() restituisce lo stesso valore; capacity() indica la capacità di memorizzazione, non la lunghezza del contenuto.
Gli zeri interni vengono contati, il terminatore nullo finale no. In std::string si contano gli elementi char, cioè byte nel senso di C++; in uno std::u8string contenente testo UTF-8 si contano le unità di codice char8_t. Non si contano né i punti di codice Unicode né i caratteri percepiti dall’utente. Troncare in base al numero di elementi può spezzare una sequenza UTF-8.
Per una copia esatta, passa s.data() e s.size() a un’interfaccia che accetta un numero di elementi; un’interfaccia che cerca un terminatore si ferma al primo zero. Se il buffer di destinazione è dimensionato in byte, controlla la sua dimensione in byte: il contenuto occupa s.size() * sizeof(CharT) byte, escluso il terminatore. Non usare un puntatore ottenuto da data() dopo che la stringa è stata distrutta o un’operazione ha invalidato il puntatore.
Prima di leggere un elemento con s[i], verifica i < s.size(); in posizione s.size() si trova il terminatore, non un elemento del contenuto. at(i) lancia std::out_of_range se i >= s.size(). Per conservare al massimo gli ultimi quattro elementi, usa s.substr(n - 4) solo se n = s.size() è maggiore di 4; altrimenti conserva l’intera stringa. Così eviti il ritorno a un valore elevato dovuto all’aritmetica senza segno. Se un separatore è obbligatorio, confronta il risultato di find() con npos prima di calcolare l’inizio del campo successivo.
Esempi
#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';
}Risultato
10 1 3456 2
`10` include lo zero interno e `1` conferma che è presente nella copia. `3456` sono gli ultimi quattro elementi del campo e `2` è il numero di unità di codice UTF-8 per U+00E9.
Lezioni correlate
- C++ · Lezione 49 · Avanzato · Versione: 3
- C++ · Lezione 53 · Avanzato · Versione: 3
- C++ · Lezione 58 · Avanzato · Versione: 3
Fonti
- 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