CKTIS / C++
std::basic_string::substr — podniz s vlastitim podacima
Izdvoji dio znakovnog niza u novi niz koji posjeduje svoje podatke. Saznaj kako se ograničava duljina, kada početni položaj izaziva iznimku i što mijenja preopterećenje za rvalue u C++23.
Verzija: ISO C++23; implementation support may vary
Sintaksa
// 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 članska je funkcija deklarirana u <string>. s.substr(pos, count) vraća novi znakovni niz istog tipa koji posjeduje svoje podatke. pos je početni indeks od nule; count je broj elemenata, a ne završni indeks. Zadana vrijednost za pos jest 0, a za count je npos, što znači „do kraja”.
Ako je pos <= s.size(), rezultat sadrži std::min(count, s.size() - pos) elemenata. Prevelik count ograničava se na raspoloživ broj elemenata. pos == s.size() ili count == 0 uz valjan pos daje prazan niz. pos > s.size() izaziva iznimku std::out_of_range čak i kad je count == 0. Provjeri negativne ulaze prije pretvorbe u nepredznačeni tip size_type i provjeri duljinu prije izračuna s.size() - 4 kako se rezultat nepredznačenog oduzimanja ne bi prelomio pri prolasku ispod nule.
Prije C++23 postojalo je samo jedno preopterećenje const, koje je od C++20 bilo constexpr. U C++23 oba su preopterećenja constexpr; podrška može ovisiti o biblioteci. const & kopira raspon bez promjene izvora. && odabire se za nekonstantni rvalue kao što je std::move(s) i može ponovno upotrijebiti memoriju izvora, ali nije zajamčeno da će izbjeći alokaciju. Nakon uspješnog poziva izvor je valjan, ali u nespecificiranom stanju. Oba preopterećenja zadano konstruiraju alokator rezultata umjesto kopiranja s.get_allocator(). Ako se pojavi iznimka, izvor ostaje nepromijenjen.
Položaji i duljine broje elemente CharT: bajtove za std::string i kodne jedinice UTF-8 tipa char8_t za std::u8string. Rez u UTF-8 može razdvojiti kodnu točku. substr čuva ugrađene nulte elemente; za točnu kopiju cijelog raspona proslijedi konstruktoru niza i s.data() i s.size(), a ne samo pokazivač. Rezultat std::basic_string_view::substr ne posjeduje podatke; koristi ga samo dok je memorija na koju upućuje valjana.
Za slova i znamenke iz osnovnog skupa znakova s.substr(0, 3) uzima do tri slova ako su na početku, a s.substr(3) uzima ostatak ako je s.size() >= 3. substr izdvaja raspon, ne filtrira. Ako niz već sadrži samo znamenke i ima barem četiri elementa, upotrijebi digits.substr(digits.size() - 4); u suprotnom ispred njega dodaj nule iz std::string(4 - digits.size(), '0').
Primjeri
#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";
}
}Rezultat
ABC 12345 2345 0007 [] out_of_range
Primjer prikazuje prefiks, ograničavanje broja elemenata, zadržavanje posljednjih četiriju znamenaka ili dodavanje nula slijeva te razliku između početka izvatka na kraju niza i iza njega.
Povezane lekcije
- C++ · Lekcija 49 · Napredno · Verzija: 3
- C++ · Lekcija 53 · Napredno · Verzija: 3