Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / C++

std::basic_string::substr — podreťazec s vlastnými údajmi

Vyberte časť reťazca do nového reťazca s vlastnými údajmi. Zistite, ako sa obmedzuje dĺžka, kedy počiatočná pozícia vyvolá výnimku a čo mení preťaženie pre rvalue v C++23.

Verzia: 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 je členská funkcia deklarovaná v <string>. s.substr(pos, count) vráti nový reťazec rovnakého typu, ktorý vlastní svoje údaje. pos je počiatočný index od nuly; count je počet prvkov, nie koncový index. Predvolená hodnota pos je 0 a predvolená hodnota count je npos, čiže „až do konca“.

Ak pos <= s.size(), výsledok obsahuje std::min(count, s.size() - pos) prvkov. Príliš veľké count sa obmedzí na dostupný počet prvkov. pos == s.size() alebo count == 0 pri platnom pos vráti prázdny reťazec. pos > s.size() vyvolá std::out_of_range, aj keď count == 0. Záporné vstupy skontrolujte pred konverziou na typ size_type bez znamienka a pred výpočtom s.size() - 4 overte dĺžku, aby sa výsledok odčítania nepretočil.

Pred C++23 existovalo jediné preťaženie const, od C++20 označené ako constexpr. V C++23 sú obe preťaženia constexpr; podpora sa môže líšiť podľa knižnice. const & kopíruje rozsah bez zmeny zdroja. && sa vyberá pre nekonštantnú rvalue, napríklad std::move(s), a môže znova využiť pamäť zdroja, ale nezaručuje, že sa vyhne alokácii. Po úspechu je zdroj platný, ale v nešpecifikovanom stave. Obe preťaženia predvolene konštruujú alokátor výsledku namiesto kopírovania s.get_allocator(). Pri výnimke zostane zdroj nezmenený.

Pozície a dĺžky počítajú prvky CharT: bajty v std::string a kódové jednotky UTF-8 typu char8_t v std::u8string. Rez v UTF-8 môže rozdeliť kódový bod. substr zachováva vnorené nulové prvky; na presné skopírovanie celého rozsahu odovzdajte konštruktoru reťazca s.data() aj s.size(), nie iba ukazovateľ. Výsledok std::basic_string_view::substr údaje nevlastní; používajte ho len dovtedy, kým je podkladová pamäť platná.

Pri písmenách a čísliciach zo základnej znakovej sady vezme s.substr(0, 3) najviac tri písmená, ak sú na začiatku, a s.substr(3) vezme zvyšok, ak s.size() >= 3. substr vyberá súvislý rozsah, nefiltruje. Ak reťazec už obsahuje len číslice, pri aspoň štyroch prvkoch použite digits.substr(digits.size() - 4); inak na začiatok pridajte nuly z std::string(4 - digits.size(), '0').

Prí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ýsledok

ABC
12345
2345
0007
[]
out_of_range

Príklad ukazuje predponu, obmedzenie dĺžky, ponechanie posledných štyroch číslic alebo doplnenie núl zľava a rozdiel medzi začiatkom výrezu na konci reťazca a za ním.

Súvisiace lekcie

  • C++ · Lekcia 49 · Pokročilá · Verzia: 3
  • C++ · Lekcia 53 · Pokročilá · Verzia: 3

Zdroje