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