Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / C++

std::basic_string::assign — zamenjava vsebine niza

Izberi preobremenitev glede na vir. Za medpomnilnik znane dolžine podaj kazalec in število elementov, da ohraniš tudi ničelne znake znotraj podatkov.

Različica: ISO C++23; implementation support may vary

Sintaksa

// ISO C++23 member declarations inside std::basic_string<CharT, Traits, Allocator> (<string>)
constexpr basic_string& assign(const basic_string& str);
constexpr basic_string& assign(basic_string&& str)
    noexcept(std::allocator_traits<Allocator>::propagate_on_container_move_assignment::value ||
             std::allocator_traits<Allocator>::is_always_equal::value);
constexpr basic_string& assign(const basic_string& str, size_type pos, size_type count = npos);
// Both templates require implicit conversion from const T& to std::basic_string_view<CharT, Traits>.
// Only the whole-source template also requires that const T& not be implicitly convertible to const CharT*.
template<class T> constexpr basic_string& assign(const T& t);
template<class T> constexpr basic_string& assign(const T& t, size_type pos, size_type count = npos);
constexpr basic_string& assign(const CharT* p, size_type count);
constexpr basic_string& assign(const CharT* p);
constexpr basic_string& assign(size_type count, CharT ch);
// InputIt must qualify as an input iterator.
template<class InputIt> constexpr basic_string& assign(InputIt first, InputIt last);
constexpr basic_string& assign(std::initializer_list<CharT> ilist);

std::basic_string::assign iz glave <string> zamenja celotno vsebino obstoječega niza, na primer std::string. Vrne *this po referenci, zato lahko klice verižiš. Za razliko od append ne dodaja na konec. Preobremenitvi za celoten basic_string delujeta kot kopirni oziroma premikalni operator=. Premik ne zagotavlja prevzema izvornega medpomnilnika, njegov pogoj noexcept pa je odvisen od lastnosti alokatorja.

assign(p, count) kopira natanko count elementov CharT, vključno z notranjimi znaki \0. [p, p + count) mora biti veljavno berljivo območje; funkcija ne preverja velikosti medpomnilnika. Pred klicem preveri, ali nezaupanja vredna dolžina ustreza razpoložljivim podatkom. assign(p) pa zahteva veljaven niz, zaključen z ničelnim znakom, in kopira le do prvega ničelnega znaka, ki ga ne vključi.

assign(src, pos, count) vzame odsek niza ali vira, pretvorljivega v pogled. Število elementov je omejeno na preostalo dolžino; če izpustiš count ali podaš npos, se kopira do konca. pos == size() da prazen rezultat; če za vir velja pos > size(), se sproži std::out_of_range. Obe predlogi za poglede (od C++17) zahtevata implicitno pretvorbo iz const T& v ustrezen std::basic_string_view. Le predloga za celoten vir izključuje implicitno pretvorbo iz const T& v const CharT*; za predlogo s pos in count ta omejitev ne velja.

assign(count, ch) shrani count kopij ch, assign(first, last) kopira veljavno polodprto območje vhodnih iteratorjev, assign({…}) pa kopira inicializacijski seznam. assign_range(r) je ločena metoda iz C++23; njena razpoložljivost je odvisna od izvedbe standardne knjižnice.

Kopija ne ohrani pogleda v vir, vendar morajo biti izvorni podatki med branjem veljavni. Po uspešni prireditvi znova pridobi kazalce, reference, iteratorje in poglede na prejšnjo vsebino cilja: morda niso več veljavni. Če bi rezultat presegel max_size(), se sproži std::length_error. Če metoda sproži izjemo, cilj ostane nespremenjen; neveljavno območje pomeni nedefinirano obnašanje, ne zagotovljene izjeme.

Primeri

#include <iostream>
#include <string>
#include <string_view>

int main() {
    const char buffer[] = {'I', 'D', ':', 'A', '\0', 'B'};
    const std::string_view record{buffer, sizeof buffer};
    const auto separator = record.find(':');
    if (separator == std::string_view::npos) {
        std::cerr << "missing separator\n";
        return 1;
    }

    const auto start = separator + 1;
    std::string field = "old";
    field.assign(record.data() + start, record.size() - start);

    std::cout << "size=" << field.size() << '\n';
    std::cout << "preserved="
              << (field == std::string("A\0B", 3) ? "yes" : "no") << '\n';
}

Rezultat

size=3
preserved=yes

Koda primerja rezultat `find` z `npos`, preden izračuna položaj za obveznim ločilom `:`. Medpomnilnik nima končnega ničelnega znaka; izrecno podana dolžina omogoči kopiranje vseh treh elementov polja: `A`, `\0` in `B`.

Povezane lekcije

  • C++ · Lekcija 58 · Napredna · Različica: 3

Viri