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