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

CKTIS / C++

std::basic_string::push_back — añadir una unidad de código

Añade una unidad de código al final de una cadena, directamente o con un iterador de salida, y conserva los caracteres nulos de los datos de longitud conocida.

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

Sintaxis

constexpr void push_back(CharT ch);

std::basic_string::push_back es una función miembro no constante declarada en <string> y es constexpr desde C++20. Recibe un CharT por valor (char para std::string), lo añade al final incluso si la cadena está vacía, aumenta size() en uno y devuelve void. No hay una sobrecarga para cadenas ni rangos. s.append(1, ch) y s += ch tienen el mismo efecto, pero devuelven una referencia a s. Para añadir un rango válido de n elementos a partir de p, usa s.append(p, n).

Una llamada añade una unidad de código, no necesariamente un carácter Unicode completo, y no codifica ni valida el texto. En std::string, un '\0' añadido forma parte del contenido y cuenta en size(). Es distinto del terminador adicional situado en s.data()[s.size()]. Si los datos contienen caracteres nulos, pasa data() y size() a una interfaz que respete la longitud.

La inserción al final tiene coste constante amortizado, pero una llamada puede asignar memoria y mover el contenido existente. Llamar a reserve() antes de una serie de inserciones puede reducir las asignaciones. La modificación puede invalidar punteros, referencias e iteradores a los elementos; vuelve a obtenerlos después, incluido el puntero de data(). Superar max_size() lanza std::length_error; la asignación de memoria también puede fallar. Si la llamada lanza una excepción, la cadena queda intacta.

std::back_inserter(s), de <iterator>, crea un iterador de salida de tipo std::back_insert_iterator. Una asignación como *out++ = ch llama a s.push_back(ch) en lugar de sobrescribir un elemento existente. El adaptador se refiere al objeto cadena, no a su búfer. La cadena debe seguir viva mientras se escribe a través del adaptador, que no impide las asignaciones de memoria.

Ejemplos

#include <algorithm>
#include <iostream>
#include <iterator>
#include <string>
#include <string_view>

int main() {
    constexpr std::string_view payload{"4\0" "2", 3};
    std::string record{"ID"};
    record.push_back(':');
    std::copy(payload.begin(), payload.end(), std::back_inserter(record));

    const bool has_embedded_nul = record.size() == 6 && record.data()[4] == '\0';
    std::cout << record.substr(0, 3) << '\n'
              << "size: " << static_cast<unsigned long long>(record.size()) << '\n'
              << "embedded NUL: " << std::boolalpha << has_embedded_nul << '\n';
}

Resultado

ID:
size: 6
embedded NUL: true

`push_back(':')` añade el separador y `std::copy` usa el adaptador para añadir los tres elementos del rango de longitud explícita. La comprobación del tamaño protege la lectura del índice 4 y permite confirmar el carácter nulo sin imprimirlo.

Lecciones relacionadas

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

Fuentes