Namespaces
Variants

std::basic_string<CharT,Traits,Allocator>:: data

From cppreference.net
C++
Strings library
std::basic_string
const CharT * data ( ) const ;
(1) (noexcept seit C++11)
(constexpr seit C++20)
CharT * data ( ) noexcept ;
(2) (seit C++17)
(constexpr seit C++20)

Gibt einen Zeiger auf das zugrundeliegende Array zurück, das als Zeichenspeicher dient. Der Zeiger ist so beschaffen, dass der Bereich

[ data ( ) , data ( ) + size ( ) )

(bis C++11)

[ data ( ) , data ( ) + size ( ) ]

(seit C++11)

ist gültig und die Werte darin entsprechen den in der Zeichenkette gespeicherten Werten.

Das zurückgegebene Array muss nicht nullterminiert sein.

Wenn empty() true zurückgibt, ist der Zeiger ein nicht-null Zeiger, der nicht dereferenziert werden sollte.

(bis C++11)

Das zurückgegebene Array ist nullterminiert, das heißt, data() und c_str() erfüllen dieselbe Funktion.

Wenn empty() true zurückgibt, zeigt der Zeiger auf ein einzelnes Nullzeichen.

(seit C++11)

Der Zeiger, der von data() erhalten wird, kann ungültig werden durch:

1) Das Modifizieren des Zeichenarrays, auf das durch die const-Überladung von data zugegriffen wird, hat undefiniertes Verhalten.
2) Das Ändern des abschließenden Nullterminators nach dem Ende, gespeichert bei data() + size() auf einen anderen Wert als CharT() hat undefiniertes Verhalten zur Folge.

Inhaltsverzeichnis

Parameter

(keine)

Rückgabewert

Ein Zeiger auf den zugrundeliegenden Zeichenspeicher.

data ( ) [ i ] == operator [ ] ( i ) für jedes i im Bereich [ ​ 0 ​ , size ( ) ) .

(bis C++11)

data ( ) + i == std:: addressof ( operator [ ] ( i ) ) für jedes i im Bereich [ ​ 0 ​ , size ( ) ] .

(seit C++11)

Komplexität

Konstante.

Beispiel

Diesen Code ausführen 
#include <algorithm>
#include <cassert>
#include <cstring>
#include <string>
int main()
{
    std::string const s("Emplary");
    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()));
}

Siehe auch

( DR* )
greift auf das erste Zeichen zu
(öffentliche Elementfunktion)
( DR* )
greift auf das letzte Zeichen zu
(öffentliche Elementfunktion)
gibt eine nicht modifizierbare Standard-C-Zeichenarray-Version der Zeichenkette zurück
(öffentliche Elementfunktion)
gibt einen Zeiger auf das erste Zeichen einer Ansicht zurück
(öffentliche Elementfunktion von std::basic_string_view<CharT,Traits> )