CKTIS / C++
std::basic_string::data — acceso al búfer y límites de escritura
Combina `data()` con `size()` para conservar los ceros internos y comprueba los límites y el tiempo de vida de la cadena antes de usar el puntero.
Versión: ISO C++23; implementation support may vary
Sintaxis
// <string>; members of std::basic_string<CharT, Traits, Allocator> in C++23
constexpr const CharT* data() const noexcept;
constexpr CharT* data() noexcept;std::basic_string::data, declarado en <string>, devuelve en tiempo constante un puntero al almacenamiento contiguo de la cadena, sin copiar datos ni transferir su propiedad. Una cadena const selecciona la sobrecarga que devuelve const CharT*; una cadena no const selecciona la que devuelve CharT*, incorporada en C++17. Desde C++11, la sobrecarga const es noexcept y el búfer tiene un terminador cero garantizado. La sobrecarga que permite escribir es noexcept desde su introducción; ambas son constexpr desde C++20. Esta entrada describe ISO C++23; la compatibilidad puede variar según la implementación.
Los elementos de la cadena ocupan [s.data(), s.data() + s.size()). s.data()[s.size()] vale CharT{} y no cuenta para size(); si la cadena está vacía, el puntero apunta a ese terminador. c_str() da acceso de solo lectura al mismo búfer. Una función para cadenas de C como std::strlen para char se detiene en el primer cero, aunque esté dentro de la cadena. std::basic_string_view::data() no garantiza un terminador al final de la vista.
Para una copia exacta, pasa un puntero y un número de elementos, como en std::string(s.data(), s.size()) para una std::string. Para un fragmento que empieza en pos, comprueba pos <= s.size() antes de count <= s.size() - pos. size() cuenta elementos CharT, no caracteres Unicode: std::string usa char, mientras que std::u8string (desde C++20) usa char8_t, así que su puntero no se puede pasar directamente a una API que espera const char*.
No escribas a través del puntero de la sobrecarga const. A través de CharT*, sobrescribe solo elementos con índices menores que size(). Asignar un valor distinto de cero al terminador o acceder más allá de él mediante este puntero tiene un comportamiento indefinido. reserve() no aumenta size(); para ampliar el intervalo de escritura, llama a resize() y vuelve a obtener el puntero. No lo uses tras la destrucción de la cadena, aunque sea temporal, ni después de una operación que pueda invalidarlo, como append().
Ejemplos
#include <cstring>
#include <iostream>
#include <string>
int main() {
const std::string input("A\0B", 3);
std::string copy(input.data(), input.size());
copy.data()[2] = 'C';
std::cout << copy.size() << '\n'
<< std::strlen(copy.c_str()) << '\n'
<< copy.data()[2] << '\n';
}
Resultado
3 1 C
El constructor con un número de elementos conserva el cero interno. La escritura mediante `data()` cambia el tercer elemento a `C`, mientras que `std::strlen` sigue devolviendo `1`.
Lecciones relacionadas
- C++ · Lección 49 · Avanzado · Versión: 3
- C++ · Lección 58 · Avanzado · Versión: 3
Fuentes
- C++ working draft — Accessors [string.accessors]
- C++ working draft — Class template basic_string: General [basic.string.general]
- C++ working draft — General requirements [string.require]
- C++ working draft — Constructors and assignment operators [string.cons]
- C++ working draft — Capacity [string.capacity]
- C++ working draft — String view element access [string.view.access]
- C++ working draft — Header <cstring> synopsis [cstring.syn]
- WG21 N4296 — C++ working draft, post-C++11 [string.accessors]
- WG21 N4713 — C++ working draft, post-C++17 [string.accessors]
- WG21 N4860 — C++20 Draft International Standard [string.accessors]