Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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