CKTIS / C++
std::basic_string::assign — zastępowanie zawartości łańcucha
Dobierz przeciążenie do rodzaju źródła. W przypadku bufora o znanej długości podaj wskaźnik i liczbę elementów, aby zachować także zera wewnątrz danych.
Wersja: ISO C++23; implementation support may vary
Składnia
// 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 nagłówka <string> zastępuje całą zawartość istniejącego łańcucha, w tym std::string. Zwraca *this przez referencję, więc wywołania można łączyć. W przeciwieństwie do append nie dopisuje na końcu. Przeciążenia przyjmujące cały basic_string działają jak kopiujące lub przenoszące operator=. Przeniesienie nie gwarantuje przejęcia bufora, a jego noexcept zależy od cech alokatora.
assign(p, count) kopiuje dokładnie count elementów CharT, także wewnętrzne '\0'. Zakres [p, p + count) musi być prawidłowy i dostępny do odczytu; funkcja nie sprawdza rozmiaru bufora. Przed wywołaniem sprawdź niezaufaną długość względem dostępnych danych. assign(p) wymaga natomiast prawidłowego łańcucha zakończonego zerem i kopiuje tylko do pierwszego zera, bez niego.
assign(src, pos, count) wybiera fragment łańcucha lub źródła typu widoku. Liczba elementów jest ograniczona do pozostałej długości; pominięcie count lub podanie npos oznacza kopiowanie do końca. pos == size() daje pusty wynik, a pos > size() źródła powoduje std::out_of_range. Oba szablony dla źródeł typu widoku (od C++17) wymagają niejawnej konwersji z const T& do odpowiedniego std::basic_string_view. Tylko szablon przyjmujący całe źródło wyklucza niejawną konwersję z const T& do const CharT*; szablon z pos i count nie ma tego ograniczenia.
assign(count, ch) zapisuje count kopii ch, assign(first, last) kopiuje prawidłowy zakres półotwarty wyznaczony przez iteratory wejściowe, a assign({…}) kopiuje listę inicjalizacyjną. assign_range(r) to osobna metoda w C++23; jej dostępność zależy od biblioteki standardowej.
Kopiowanie nie tworzy widoku źródła, ale dane źródłowe muszą być dostępne podczas odczytu. Po udanym przypisaniu pobierz na nowo wskaźniki, referencje, iteratory i widoki odnoszące się do poprzedniej zawartości: mogły zostać unieważnione. Jeśli wynik przekroczyłby max_size(), operacja zgłasza std::length_error. Jeśli metoda zgłosi wyjątek, obiekt docelowy pozostaje bez zmian; nieprawidłowy zakres powoduje niezdefiniowane zachowanie, a nie gwarantowany wyjątek.
Przykłady
#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';
}Wynik
size=3 preserved=yes
Przed obliczeniem pozycji za obowiązkowym separatorem `:` kod sprawdza wynik `find` względem `npos`. Bufor nie ma zera na końcu; jawna długość pozwala skopiować wszystkie trzy elementy pola `A`, `\0`, `B`.
Powiązane lekcje
- C++ · Lekcja 58 · Zaawansowany · Wersja: 3