Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C++

std::basic_string::assign — nahrazení obsahu řetězce

Zvolte přetížení podle zdroje. U bufferu se známou délkou předejte ukazatel a počet prvků, aby se zachovaly i nulové znaky uvnitř dat.

Verze: ISO C++23; implementation support may vary

Syntaxe

// 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 z hlavičky <string> nahradí celý obsah existujícího řetězce, například std::string. Vrací *this referencí, takže volání lze řetězit. Na rozdíl od append nic nepřidává na konec. Přetížení pro celý basic_string fungují jako kopírovací nebo přesouvací operator=. Přesun nemusí převzít buffer zdroje a jeho podmínka noexcept závisí na vlastnostech alokátoru.

assign(p, count) zkopíruje přesně count prvků CharT včetně vnitřních znaků \0. [p, p + count) musí být platný čitelný rozsah; funkce velikost bufferu nekontroluje. Před voláním ověřte nedůvěryhodnou délku vůči množství dostupných dat. assign(p) naopak vyžaduje platný řetězec ukončený nulovým znakem a kopíruje jen po první nulový znak, bez něj.

assign(src, pos, count) vybere část řetězce nebo zdroje převoditelného na pohled. Počet prvků je omezen zbývající délkou; vynechání count nebo hodnota npos znamená kopírování do konce. pos == size() dává prázdný výsledek, zatímco pos > size() zdroje vyvolá std::out_of_range. Obě šablony pro pohledy (od C++17) vyžadují implicitní převod z const T& na odpovídající std::basic_string_view. Jen šablona pro celý zdroj vylučuje implicitní převod z const T& na const CharT*; šablona s pos a count toto omezení nemá.

assign(count, ch) uloží count kopií ch, assign(first, last) zkopíruje platný polootevřený rozsah vstupních iterátorů a assign({…}) zkopíruje inicializační seznam. assign_range(r) je samostatná metoda v C++23; její dostupnost závisí na implementaci standardní knihovny.

Výsledek kopírování není pohledem do zdroje, ale zdrojová data musejí být platná po dobu čtení. Po úspěšném přiřazení znovu získejte ukazatele, reference, iterátory a pohledy do původního obsahu cíle: mohly pozbýt platnosti. Pokud by výsledek přesáhl max_size(), vyvolá se std::length_error. Pokud metoda vyvolá výjimku, cíl zůstane beze změny; neplatný rozsah znamená nedefinované chování, nikoli zaručenou výjimku.

Příklady

#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';
}

Výsledek

size=3
preserved=yes

Kód zkontroluje výsledek `find` vůči `npos` dříve, než vypočte pozici za povinným oddělovačem `:`. Buffer nemá koncový nulový znak; zadaná délka umožní zkopírovat všechny tři prvky pole: `A`, `\0` a `B`.

Související lekce

  • C++ · Lekce 58 · Pokročilá · Verze: 3

Zdroje