CKTIS / C++
std::basic_string::substr — deelstring met eigen gegevens
Haal een deel uit een string en bewaar het in een nieuwe string met eigen gegevens. Leer hoe de lengte wordt begrensd, wanneer de startpositie een uitzondering geeft en wat C++23 verandert voor rvalues.
Versie: ISO C++23; implementation support may vary
Syntax
// 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 is een lidfunctie die in <string> is gedeclareerd. s.substr(pos, count) geeft een nieuwe string van hetzelfde type terug die zijn gegevens zelf beheert. pos is de startindex vanaf nul; count is het aantal elementen, niet de eindindex. Standaard is pos gelijk aan 0 en count gelijk aan npos, oftewel ‘tot het einde’.
Als pos <= s.size(), bevat het resultaat std::min(count, s.size() - pos) elementen. Een te grote count wordt begrensd. pos == s.size() of count == 0 bij een geldige pos levert een lege string op. pos > s.size() werpt std::out_of_range, ook als count == 0. Controleer negatieve invoer vóór omzetting naar het unsigned type size_type en controleer de lengte vóór s.size() - 4, zodat de unsigned aftrekking niet onder nul omslaat.
Vóór C++23 was er één const-overload, die sinds C++20 constexpr was. In C++23 zijn beide overloads constexpr; ondersteuning kan per bibliotheek verschillen. const & kopieert het gekozen bereik zonder de bron te wijzigen. && wordt gekozen voor een niet-const rvalue zoals std::move(s) en kan het geheugen van de bron hergebruiken, maar het is niet gegarandeerd dat er geen allocatie plaatsvindt. Na succes is de bron geldig, maar de toestand ervan is niet gespecificeerd. Beide overloads construeren de allocator van het resultaat standaard in plaats van s.get_allocator() te kopiëren. Bij een uitzondering blijft de bron ongewijzigd.
Posities en lengtes tellen CharT-elementen: bytes voor std::string en UTF-8-code-eenheden van het type char8_t voor std::u8string. Een UTF-8-fragment kan midden in een codepunt beginnen of eindigen. substr behoudt ingebedde nulelementen; geef zowel s.data() als s.size() door aan de stringconstructor om het hele bereik exact te kopiëren, niet alleen de pointer. Het resultaat van std::basic_string_view::substr leent zijn gegevens; gebruik het alleen zolang het achterliggende geheugen geldig blijft.
Bij letters en cijfers uit de basistekenset geeft s.substr(0, 3) maximaal drie letters als die vooraan staan, en s.substr(3) geeft de rest als s.size() >= 3. substr knipt een bereik uit en filtert niet. Bevat de string alleen cijfers, gebruik dan digits.substr(digits.size() - 4) bij minstens vier elementen; zet anders de nullen uit std::string(4 - digits.size(), '0') ervoor.
Voorbeelden
#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";
}
}Resultaat
ABC 12345 2345 0007 [] out_of_range
Het voorbeeld toont een prefix, een begrensd aantal elementen, het behouden van de laatste vier cijfers of het links aanvullen met nullen, en het verschil tussen starten op het einde en voorbij het einde.
Gerelateerde lessen
- C++ · Les 49 · Gevorderd · Versie: 3
- C++ · Les 53 · Gevorderd · Versie: 3