Namespaces
Variants

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

    Aus de.cppreference.net
     
    C++
     
    Zeichenkettenbibliothek
     
    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, dass der Bereich

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

    		(bis C++11)

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

    		(seit C++11)

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

    Das zurückgegebene Array muss nicht null-terminiert 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 null-terminiert, das heißt, data() und c_str() führen dieselbe Funktion aus.

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

    		(seit C++11)

    Der von data() bezogene Zeiger kann ungültig werden durch:

    • Übergabe einer nicht-konstanten Referenz auf die Zeichenkette an eine beliebige Standardbibliotheksfunktion, oder
    • Aufruf nicht-konstanter Memberfunktionen auf der Zeichenkette, ausschließlich von operator[](), at(), front(), back(), begin(), end(), rbegin(), rend().
    1) Das Bearbeiten des Zeichenarrays, auf das über die konstante Überladung von data zugegriffen wird, hat undefiniertes Verhalten.
    2) Das Ändern des terminierenden Null-Terminators, der bei data() + size() auf einen anderen Wert als CharT() gespeichert ist, hat undefiniertes Verhalten.

    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> )