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
- [string.append] — basic_string::append and push_back
- [string.op.append] — basic_string::operator+=
- [string.require] — basic_string general requirements
- [basic.string.general] — basic_string storage and terminator
- [string.capacity] — basic_string size, capacity and reserve
- [back.insert.iterator] — back_insert_iterator and back_inserter
- std::basic_string<CharT,Traits,Allocator>::push_back — cppreference
- N4950 — Working Draft, Standard for Programming Language C++