std::basic_string::data

 

C++

Apoyo de compiladores

Implementaciones independientes y albergadas

Lenguaje

Biblioteca estándar

Encabezados de la biblioteca estándar

Requisitos denominados

Macros de prueba de característica (C++20)

Biblioteca de apoyo del lenguaje

Biblioteca de conceptos (C++20)

Biblioteca de diagnósticos

Biblioteca de gestión de memoria

Biblioteca de metaprogramación (C++11)

Biblioteca de servicios generales

Biblioteca de contenedores

Biblioteca de iteradores

Biblioteca de rangos (C++20)

Biblioteca de algoritmos

Biblioteca de cadenas

Biblioteca de procesamiento de texto

Biblioteca numérica

Biblioteca de fecha y hora

Biblioteca de entrada/salida

Biblioteca del sistema de archivos (C++17)

Biblioteca de apoyo de concurrencia (C++11)

Biblioteca de apoyo de ejecución (C++26)

Especificaciones técnicas

Índice de símbolos

Bibliotecas externas

 

Biblioteca de cadenas

Cadenas terminadas en nulo

Cadenas de bytes

Cadenas multibyte

De caracteres anchos

Clases

basic_string

basic_string_view (C++17)

char_traits

 

std::basic_string

Funciones miembro basic_string::basic_string basic_string::operator= basic_string::assign basic_string::get_allocator Acceso a elementos basic_string::at basic_string::operator[] basic_string::front (C++11) basic_string::back (C++11) basic_string::data basic_string::c_str basic_string::operator basic_string_view (C++17) Iteradores basic_string::beginbasic_string::cbegin (C++11) basic_string::endbasic_string::cend (C++11) basic_string::rbeginbasic_string::crbegin (C++11) basic_string::rendbasic_string::crend (C++11) Capacidad basic_string::empty basic_string::sizebasic_string::length basic_string::max_size basic_string::reserve basic_string::capacity basic_string::shrink_to_fit (C++11)

Operaciones basic_string::clear basic_string::insert basic_string::erase basic_string::push_back basic_string::pop_back (C++11) basic_string::append basic_string::operator+= basic_string::compare basic_string::starts_with (C++20) basic_string::ends_with (C++20) basic_string::replace basic_string::substr basic_string::copy basic_string::resize basic_string::swap Búsqueda basic_string::find basic_string::rfind basic_string::find_first_of basic_string::find_first_not_of basic_string::find_last_of basic_string::find_last_not_of Constantes basic_string::npos

Funciones no miembro operator+ swap(std::basic_string) operator""s (C++14) erase(std::basic_string)erase_if(std::basic_string) (C++20)(C++20) E/S operator<<operator>> getline Comparación operator==operator!=operator<operator>operator<=operator>=operator<=> (hasta C++20)(hasta C++20)(hasta C++20)(hasta C++20)(hasta C++20)(C++20) Conversión numérica (C++11) stoistolstoll stoulstoull stofstodstold to_string to_wstring Clases auxiliares hash<std::string>hash<std::wstring>hash<std::u32string>hash<std::u16string>hash<std::u8string> (C++11)(C++11)(C++11)(C++11)(C++20) hash<std::pmr::string>hash<std::pmr::wstring>hash<std::pmr::u32string>hash<std::pmr::u16string>hash<std::pmr::u8string> (C++20)(C++20)(C++20)(C++20)(C++20) Guías de deducción(C++17)

 

<tbody> </tbody> <tbody class="t-dcl-rev t-dcl-rev-num "> </tbody><tbody> </tbody> <tbody class="t-dcl-rev t-dcl-rev-num "> </tbody><tbody> </tbody>

	(1)
const CharT* data() const;			(hasta C++11)
const CharT* data() const noexcept;			(desde C++11) (hasta C++20)
constexpr const CharT* data() const noexcept;			(desde C++20)
		(2)
CharT* data() noexcept;				(desde C++17) (hasta C++20)
constexpr CharT* data() noexcept;				(desde C++20)

See More

Devuelve un puntero al array subyacente que sirve como almacenamiento de caracteres. El puntero es tal que el rango [data(); data() + size()) es válido y los valores en él corresponden con los valores almacenados en la cadena.

El array devuelto no se requiere que esté terminado en nulo. Si empty() devuelve true, el puntero es un puntero no nulo que no deberá desreferenciarse.	(hasta C++11)
El array devuelto está terminado en nulo. Es decir, data() y c_str() realizan la misma función. Si empty() devuelve true, el puntero apunta a un solo carácter nulo.	(desde C++11)

El puntero obtenido de data() puede invalidarse por:

• Pasar una referencia no const a la cadena de cualquier función de la biblioteca estándar, o
• Llamar a funciones miembro no const en la cadena, excluyendo a operator[](), at(), front(), back(), begin(), end(), rbegin(), rend().

1) Modificar el array de caracteres accedido mediante la sobrecarga const de data tiene un comportamiento indefinido.

2) Modificar el terminador nulo despues del final, almacenado en data()+size() con cualquier valor distinto de CharT() tiene un comportamiento indefinido.

Parámetros

(Ninguno)

Valor de retorno

Un puntero al almacenamiento de caracteres subyacente.

data()[i] == operator[](i) para cada i en [0, size()).	(hasta C++11)
data() + i == std::addressof(operator[](i)) para cada i en [0, size()].	(desde C++11)

Complejidad

Constante.

Ejemplo

Ejecuta este código

#include <algorithm>
#include <cassert>
#include <cstring>
#include <string>

int main()
{
  std::string const s("Emplar");
  assert(s.size() == std::strlen(s.data()));
  assert(std::equal(s.begin(), s.end(), s.data()));
  assert(std::equal(s.data(), s.data() + s.size(), s.begin()));
  assert(0 == *(s.data() + s.size()));
}

Véase también

front (C++11)	Accede al primer carácter (función miembro pública)
back (C++11)	Accede al último carácter (función miembro pública)
c_str	Devuelve una versión de la cadena que es un array de caracteres no modificable de C estándar (función miembro pública)