Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C++

std::basic_string::substr — podciąg z własnymi danymi

Wytnij fragment łańcucha do nowego obiektu. Dowiedz się, jak działa ograniczanie długości, kiedy pozycja powoduje wyjątek i co zmienia przeciążenie dla r-wartości w C++23.

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

Składnia

// 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 to funkcja składowa z nagłówka <string>. Wywołanie s.substr(pos, count) zwraca nowy łańcuch tego samego typu, który sam przechowuje swoje dane. pos to indeks od zera, a count to liczba elementów, nie indeks końcowy. Domyślne pos ma wartość 0, a domyślne count to npos, czyli „do końca”.

Jeśli pos <= s.size(), wynik ma std::min(count, s.size() - pos) elementów. Za duże count zostaje ograniczone; pos == s.size() lub count == 0 przy poprawnym pos daje pusty wynik. pos > s.size() powoduje std::out_of_range nawet przy count == 0. Sprawdzaj ujemne dane wejściowe przed konwersją na bez znaku size_type; sprawdzaj też długość przed s.size() - 4, aby uniknąć zawinięcia wyniku odejmowania.

Przed C++23 istniało jedno przeciążenie const, oznaczone jako constexpr od C++20. W C++23 oba przeciążenia są constexpr; obsługa zależy od implementacji biblioteki. const & kopiuje wybrany zakres bez zmiany źródła. && jest wybierane dla nieconstowej r-wartości, np. std::move(s), i może wykorzystać pamięć źródła, ale nie gwarantuje braku alokacji. Po udanym wywołaniu źródło pozostaje w poprawnym, lecz nieokreślonym stanie. Oba przeciążenia domyślnie konstruują alokator wyniku zamiast kopiować s.get_allocator(). Jeśli zostanie zgłoszony wyjątek, źródło pozostaje bez zmian.

Indeksy i długości liczą elementy CharT: dla std::string są to bajty, a dla std::u8string jednostki kodowe UTF-8 typu char8_t. Przycinanie UTF-8 może rozdzielić punkt kodowy. substr zachowuje osadzone elementy zerowe; aby skopiować dokładnie cały zakres, przekaż konstruktorowi s.data() i s.size(), a nie sam wskaźnik. W przeciwieństwie do łańcucha wynik std::basic_string_view::substr nie jest właścicielem danych; używaj go tylko, dopóki pamięć źródłowa pozostaje ważna.

Dla liter i cyfr z podstawowego zestawu znaków s.substr(0, 3) bierze do trzech pierwszych liter, jeśli są na początku, a s.substr(3) bierze resztę, jeśli s.size() >= 3. substr wycina, ale nie filtruje. Dla łańcucha już złożonego z cyfr wybierz digits.substr(digits.size() - 4), gdy ma co najmniej cztery elementy; w przeciwnym razie poprzedź go zerami z std::string(4 - digits.size(), '0').

Przykłady

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

Wynik

ABC
12345
2345
0007
[]
out_of_range

Przykład pokazuje prefiks, ograniczenie nadmiernej długości, zachowanie ostatnich czterech cyfr lub dopełnienie zerami z lewej oraz różnicę między pozycją na końcu a pozycją poza końcem.

Powiązane lekcje

  • C++ · Lekcja 49 · Zaawansowany · Wersja: 3
  • C++ · Lekcja 53 · Zaawansowany · Wersja: 3

Źródła