Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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

Izvori