WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

std::basic_string::substr — Teilstring mit eigenem Speicher

Erzeuge aus einem Ausschnitt einen eigenständigen String. Lerne, wann die Länge begrenzt wird, welche Startposition eine Ausnahme auslöst und was die Rvalue-Überladung in C++23 ändert.

Version: 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 ist eine in <string> deklarierte Memberfunktion. s.substr(pos, count) liefert einen neuen String desselben Typs, dem seine Daten selbst gehören. pos ist der bei null beginnende Startindex; count ist eine Elementanzahl, kein Endindex. Standardmäßig ist pos gleich 0 und count gleich npos, also „bis zum Ende“.

Für pos <= s.size() enthält das Ergebnis std::min(count, s.size() - pos) Elemente. Ein zu großes count wird begrenzt. pos == s.size() oder count == 0 bei gültigem pos liefert einen leeren String. pos > s.size() löst auch bei count == 0 eine std::out_of_range-Ausnahme aus. Prüfe negative Eingaben vor der Umwandlung in den vorzeichenlosen Typ size_type und prüfe die Länge vor s.size() - 4, damit die vorzeichenlose Subtraktion nicht umschlägt.

Vor C++23 gab es eine einzige const-Überladung, die seit C++20 constexpr war. In C++23 sind beide Überladungen constexpr; die Bibliotheksunterstützung kann variieren. const & kopiert den Ausschnitt, ohne die Quelle zu ändern. && wird für einen nicht konstanten Rvalue wie std::move(s) gewählt und kann den Speicher der Quelle wiederverwenden; eine Ausführung ohne Allokation ist nicht garantiert. Nach Erfolg bleibt die Quelle gültig, ihr Zustand ist aber nicht spezifiziert. Beide Überladungen konstruieren den Allokator des Ergebnisses standardmäßig, statt s.get_allocator() zu kopieren. Bei einer Ausnahme bleibt die Quelle unverändert.

Positionen und Längen zählen CharT-Elemente: Bytes bei std::string und UTF-8-Codeeinheiten des Typs char8_t bei std::u8string. Ein UTF-8-Ausschnitt kann einen Codepunkt zerschneiden. substr erhält eingebettete Nullelemente. Übergib dem String-Konstruktor sowohl s.data() als auch s.size(), um den gesamten Bereich exakt zu kopieren, nicht nur den Zeiger. Das Ergebnis von std::basic_string_view::substr besitzt seine Daten dagegen nicht; verwende es nur, solange der zugrunde liegende Speicher gültig bleibt.

Bei Buchstaben und Ziffern aus dem Basiszeichensatz liefert s.substr(0, 3) bis zu drei Buchstaben, wenn diese am Anfang stehen, und s.substr(3) liefert bei s.size() >= 3 den Rest. substr schneidet aus, filtert aber nicht. Besteht der String bereits aus Ziffern, verwende ab vier Elementen digits.substr(digits.size() - 4); andernfalls stelle mit std::string(4 - digits.size(), '0') Nullen voran.

Beispiele

#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";
    }
}

Ergebnis

ABC
12345
2345
0007
[]
out_of_range

Das Beispiel zeigt ein Präfix, eine begrenzte Länge, das Behalten der letzten vier Ziffern oder das Auffüllen von links sowie den Unterschied zwischen einer Startposition am Ende und einer dahinter.

Zugehörige Lektionen

  • C++ · Lektion 49 · Fortgeschritten · Version: 3
  • C++ · Lektion 53 · Fortgeschritten · Version: 3

Quellen