Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / C++

Añadir al final de una cadena: std::basic_string::append

Elige la sobrecarga de `append` según el origen: una cadena completa, un fragmento o un búfer de longitud conocida. Añade los separadores de forma explícita y conserva los nulos internos.

Versión: ISO C++23; implementation support may vary

Sintaxis

In <string>, for std::basic_string<CharT, Traits, Allocator> dst (C++23):
dst.append(str);                     // whole basic_string
dst.append(str, pos, count = npos);  // slice of a basic_string
dst.append(viewLike);                // whole view
dst.append(viewLike, pos, count = npos); // slice of a view
dst.append(p);                       // null-terminated sequence
dst.append(p, count);                // exactly count elements
dst.append(count, ch);               // count copies of ch
dst.append(first, last);              // valid input-iterator range [first, last)
dst.append({ch1, ch2});               // initializer list
All forms return basic_string&. The notation count = npos denotes a default argument, not an assignment at the call site. append_range(range) is a separate C++23 member.

std::basic_string::append, declarado en <string>, añade elementos CharT al final de una cadena existente (std::string es la especialización para char). Devuelve *this por referencia, lo que permite encadenar llamadas. A diferencia de assign, no sustituye el contenido existente ni inserta separadores automáticamente. Para un carácter, usa push_back(ch) o += ch; push_back devuelve void.

append(str) copia toda la cadena. append(str, pos, count) copia hasta count elementos desde el índice pos del origen, sin rebasar su final. Omite count o pasa npos para copiar hasta el final. En el origen, pos == size() produce un fragmento vacío y pos > size() lanza std::out_of_range. Las sobrecargas para tipos compatibles con una vista, disponibles desde C++17, funcionan igual. En C++23, ambas solo participan en la resolución de sobrecargas si const T& se puede convertir implícitamente a std::basic_string_view<CharT, Traits>. Solo la sobrecarga que copia el origen completo exige además que const T& no se pueda convertir implícitamente a const CharT*.

append(p) requiere una secuencia válida terminada en nulo y copia hasta el primer nulo, sin incluirlo. append(p, count) copia exactamente count elementos, incluidos los nulos internos. No ajusta la cantidad a la longitud del búfer: compruébala con el tamaño real del búfer, porque un rango no válido implica comportamiento indefinido. Pasa tanto data() como size() a un receptor que acepte datos con longitud explícita.

append(count, ch) añade count copias de ch. También puedes pasar un rango válido de iteradores de entrada [first, last) o una lista de inicialización. Estas sobrecargas de append son constexpr desde C++20. append_range(range) es una función miembro distinta de C++23; comprueba si tu biblioteca estándar la admite.

Añadir datos puede invalidar punteros, referencias e iteradores a los elementos de la cadena de destino y, por tanto, las vistas de su almacenamiento. Vuelve a obtenerlos tras modificarla. Superar max_size() lanza std::length_error; la asignación de memoria también puede fallar. Si una llamada a append lanza una excepción, la cadena de destino queda como estaba justo antes de esa llamada.

Ejemplos

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

int main() {
    const std::string header = "kind=sample";
    const char payload[] = {'A', '\0', 'B'};

    const auto cut = header.find('=');
    if (cut == std::string::npos) {
        return 1;
    }

    std::string message;
    message.append(header, 0, cut)
           .append(1, ':')
           .append(payload, sizeof payload);

    const std::string_view received{message.data(), message.size()};
    if (received != std::string_view{"kind:A\0B", 8}) {
        return 2;
    }

    std::cout << "accepted: " << received.size() << " bytes\n";
}

Resultado

accepted: 8 bytes

El programa comprueba que la cabecera contiene el `=` obligatorio comparando el resultado de `find` con `std::string::npos`. Después añade el fragmento anterior a `=`, el separador explícito `:` y tres bytes de datos. El receptor compara los ocho bytes, incluido el `\0` interno. Usar `append(payload)` sin indicar la longitud solo copiaría `A`.

Lecciones relacionadas

  • C++ · Lección 58 · Avanzado · Versión: 3

Fuentes