Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C++

std::basic_string::substr — sottostringa con dati propri

Estrai un frammento in una nuova stringa che possiede i propri dati. Scopri come viene limitata la lunghezza, quando la posizione genera un’eccezione e cosa cambia con l’overload per rvalue di C++23.

Versione: ISO C++23; implementation support may vary

Sintassi

// ISO C++23 — member declarations in std::basic_string (<string>)
constexpr basic_string substr(size_type pos = 0, size_type count = npos) const &;
constexpr basic_string substr(size_type pos = 0, size_type count = npos) &&;

std::basic_string::substr è una funzione membro dichiarata in <string>. s.substr(pos, count) restituisce una nuova stringa dello stesso tipo che possiede i propri dati. pos è l’indice iniziale a partire da zero; count è un numero di elementi, non un indice finale. Per impostazione predefinita pos vale 0 e count vale npos, cioè «fino alla fine».

Se pos <= s.size(), il risultato contiene std::min(count, s.size() - pos) elementi. Un count troppo grande viene limitato agli elementi disponibili. pos == s.size() oppure count == 0 con un pos valido produce una stringa vuota. pos > s.size() genera std::out_of_range anche se count == 0. Controlla gli input negativi prima di convertirli nel tipo senza segno size_type e verifica la lunghezza prima di calcolare s.size() - 4, per evitare il wraparound della sottrazione senza segno.

Prima di C++23 c’era un solo overload const, dichiarato constexpr a partire da C++20. In C++23 entrambi gli overload sono constexpr; il supporto può variare a seconda della libreria. const & copia l’intervallo senza modificare la sorgente. && viene selezionato per un rvalue non const come std::move(s) e può riutilizzare la memoria della sorgente, ma non è garantito che eviti un’allocazione. Dopo una chiamata riuscita, la sorgente è valida ma in uno stato non specificato. Entrambi gli overload costruiscono per default l’allocatore del risultato anziché copiare s.get_allocator(). Se viene lanciata un’eccezione, la sorgente rimane invariata.

Posizioni e lunghezze contano elementi CharT: byte per std::string e unità di codice UTF-8 di tipo char8_t per std::u8string. Un taglio in UTF-8 può spezzare un punto di codice. substr conserva gli elementi nulli interni; per copiare esattamente l’intero intervallo, passa s.data() e s.size() al costruttore della stringa, non solo il puntatore. Al contrario, il risultato di std::basic_string_view::substr non possiede i dati: usalo solo finché la memoria sottostante resta valida.

Per lettere e cifre dell’insieme di caratteri di base, s.substr(0, 3) prende fino a tre lettere se sono all’inizio, e s.substr(3) prende il resto se s.size() >= 3. substr estrae un intervallo, non filtra. Se la stringa è già composta di sole cifre, usa digits.substr(digits.size() - 4) quando ha almeno quattro elementi; altrimenti anteponi gli zeri prodotti da std::string(4 - digits.size(), '0').

Esempi

#include <iostream>
#include <stdexcept>
#include <string>

std::string last_four(const std::string& digits) {
    if (digits.size() < 4) {
        return std::string(4 - digits.size(), '0') + digits;
    }
    return digits.substr(digits.size() - 4);
}

int main() {
    const std::string label = "ABC12345";
    std::cout << label.substr(0, 3) << '\n';
    std::cout << label.substr(3, 99) << '\n';
    std::cout << last_four(label.substr(3)) << '\n';
    std::cout << last_four("7") << '\n';
    std::cout << '[' << label.substr(label.size()) << "]\n";

    try {
        (void)label.substr(label.size() + 1, 0);
    } catch (const std::out_of_range&) {
        std::cout << "out_of_range\n";
    }
}

Risultato

ABC
12345
2345
0007
[]
out_of_range

L’esempio mostra un prefisso, una lunghezza limitata agli elementi disponibili, come mantenere le ultime quattro cifre o aggiungere zeri a sinistra e la differenza tra iniziare alla fine e oltre la fine.

Lezioni correlate

  • C++ · Lezione 49 · Avanzato · Versione: 3
  • C++ · Lezione 53 · Avanzato · Versione: 3

Fonti