CKTIS / C++
std::basic_string::assign — substituir o conteúdo de uma cadeia
Escolhe a sobrecarga em função da origem. Para um buffer de comprimento conhecido, passa um ponteiro e uma contagem para preservar os caracteres nulos internos.
Versão: ISO C++23; implementation support may vary
Sintaxe
// 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, declarada em <string>, substitui todo o conteúdo de uma cadeia existente, como uma std::string. Devolve *this por referência, pelo que podes encadear chamadas. Ao contrário de append, não acrescenta ao fim. As sobrecargas que recebem uma basic_string inteira comportam-se como operator= por cópia ou por movimento. O movimento não garante a transferência do buffer de origem e a sua condição noexcept depende das características do alocador.
assign(p, count) copia exactamente count elementos CharT, incluindo caracteres \0 internos. [p, p + count) tem de ser um intervalo válido e legível; a função não verifica o tamanho do buffer. Antes da chamada, confirma que qualquer comprimento não fiável cabe nos dados disponíveis. Já assign(p) exige uma cadeia válida terminada por um carácter nulo e só copia até ao primeiro nulo, sem o incluir.
assign(src, pos, count) retira uma parte de uma cadeia ou de uma origem compatível com uma vista. A contagem fica limitada ao comprimento restante; omitir count ou indicar npos significa copiar até ao fim. pos == size() dá um resultado vazio; se pos > size() da origem, é lançada std::out_of_range. Ambos os modelos para vistas (desde C++17) exigem conversão implícita de const T& para o std::basic_string_view correspondente. Só o modelo que recebe a origem inteira exclui a conversão implícita de const T& para const CharT*; o modelo com pos e count não impõe essa restrição.
assign(count, ch) guarda count cópias de ch, assign(first, last) copia um intervalo semiaberto válido de iteradores de entrada e assign({…}) copia uma lista de inicialização. assign_range(r) é um método distinto de C++23; a sua disponibilidade depende da implementação da biblioteca padrão.
A cópia não mantém uma vista sobre a origem, mas os dados de origem têm de permanecer válidos durante a leitura. Depois de uma atribuição bem-sucedida, volta a obter os ponteiros, as referências, os iteradores e as vistas sobre o conteúdo anterior do destino: podem ter sido invalidados. Um resultado que excederia max_size() provoca std::length_error. Se o método lançar uma excepção, o destino não se altera; um intervalo inválido provoca comportamento indefinido, não uma excepção garantida.
Exemplos
#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';
}Resultado
size=3 preserved=yes
O código compara o resultado de `find` com `npos` antes de calcular a posição após o separador obrigatório `:`. O buffer não tem um carácter nulo final; o comprimento explícito permite copiar os três elementos do campo: `A`, `\0` e `B`.
Lições relacionadas
- C++ · Lição 58 · Avançado · Versão: 3