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