Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C++

std::basic_string::substr — podřetězec s vlastními daty

Vyřízněte část řetězce do nového řetězce s vlastními daty. Zjistěte, jak se omezuje délka, kdy počáteční pozice vyvolá výjimku a co mění přetížení pro rvalue v C++23.

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

Syntaxe

// 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 je členská funkce deklarovaná v <string>. s.substr(pos, count) vrací nový řetězec stejného typu, který vlastní svá data. pos je počáteční index od nuly; count je počet prvků, nikoli koncový index. Výchozí pos je 0 a výchozí count je npos, tedy „až do konce“.

Při pos <= s.size() má výsledek std::min(count, s.size() - pos) prvků. Příliš velké count se omezí na dostupný počet prvků. pos == s.size() nebo count == 0 při platném pos vrací prázdný řetězec. pos > s.size() vyvolá std::out_of_range, i když count == 0. Záporné vstupy zkontrolujte před převodem na typ size_type bez znaménka a před výpočtem s.size() - 4 ověřte délku, aby se výsledek odečítání nepřetočil.

Před C++23 existovalo jediné přetížení const, od C++20 označené constexpr. V C++23 jsou obě přetížení constexpr; podpora knihoven se může lišit. const & kopíruje rozsah beze změny zdroje. && se vybere pro nekonstantní rvalue, například std::move(s), a může znovu využít paměť zdroje, ale nezaručuje, že nebude alokovat. Po úspěchu je zdroj platný, ale v nespecifikovaném stavu. Obě přetížení výchozím způsobem konstruují alokátor výsledku namísto kopírování s.get_allocator(). Při výjimce se zdroj nezmění.

Pozice a délky počítají prvky CharT: bajty v std::string a kódové jednotky UTF-8 typu char8_t v std::u8string. Řez v UTF-8 může rozdělit kódový bod. substr zachovává vložené nulové prvky. K přesnému zkopírování celého rozsahu předejte konstruktoru řetězce s.data() i s.size(), nejen ukazatel. Výsledek std::basic_string_view::substr naopak data nevlastní; používejte jej jen po dobu platnosti podkladové paměti.

U písmen a číslic ze základní znakové sady vezme s.substr(0, 3) až tři písmena, jsou-li na začátku, a s.substr(3) vezme zbytek při s.size() >= 3. substr vyřezává rozsah, ale nefiltruje. Obsahuje-li řetězec už jen číslice, při nejméně čtyřech prvcích použijte digits.substr(digits.size() - 4); jinak na začátek přidejte nuly z std::string(4 - digits.size(), '0').

Příklady

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

Výsledek

ABC
12345
2345
0007
[]
out_of_range

Příklad ukazuje předponu, omezení délky, ponechání posledních čtyř číslic nebo doplnění nul zleva a rozdíl mezi začátkem výřezu na konci řetězce a za ním.

Související lekce

  • C++ · Lekce 49 · Pokročilá · Verze: 3
  • C++ · Lekce 53 · Pokročilá · Verze: 3

Zdroje