std::basic_string_view<CharT,Traits>::data

 

C++

Compiler-Unterstützung

Freestanding und gehostet

Sprache

Standardbibliothek

Header der Standardbibliothek

Benannte Anforderungen

Feature-Test-Makros (C++20)

Bibliothek für Sprachunterstützung

Konzepte-Bibliothek (C++20)

Diagnostik-Bibliothek

Speicherverwaltungsbibliothek

Metaprogrammierungsbibliothek (C++11)

Allgemeine Dienstprogramme-Bibliothek

Container-Bibliothek

Iterator-Bibliothek

Ranges-Bibliothek (C++20)

Algorithmen-Bibliothek

Bibliothek für Zeichenketten

Textverarbeitungsbibliothek

Numerik-Bibliothek

Datums- und Zeitbibliothek

Ein-/Ausgabe-Bibliothek

Dateisystembibliothek (C++17)

Unterstützung für nebenläufige Programmierung (C++11)

Ausführungssteuerungsbibliothek (C++26)

Technische Spezifikationen

Symbolverzeichnis

Externe Bibliotheken

 

Bibliothek für Zeichenketten

Klassen

basic_string

basic_string_view (C++17)

char_traits

 

std::basic_string_view

Memberfunktionen basic_string_view::basic_string_view    basic_string_view::operator= Iteratoren basic_string_view::beginbasic_string_view::cbegin basic_string_view::endbasic_string_view::cend basic_string_view::rbeginbasic_string_view::crbegin basic_string_view::rendbasic_string_view::crend Kapazität basic_string_view::sizebasic_string_view::length basic_string_view::max_size basic_string_view::empty Operationen basic_string_view::copy basic_string_view::substr basic_string_view::compare basic_string_view::starts_with (C++20) basic_string_view::ends_with (C++20) basic_string_view::contains (C++23) basic_string_view::find basic_string_view::rfind basic_string_view::find_first_of basic_string_view::find_last_of basic_string_view::find_first_not_of basic_string_view::find_last_not_of

Elementzugriff basic_string_view::at basic_string_view::operator[] basic_string_view::front basic_string_view::back basic_string_view::data Modifizierer basic_string_view::remove_prefix basic_string_view::remove_suffix basic_string_view::swap Konstanten basic_string_view::npos Nicht-Member-Funktionen operator==operator!=operator<operator>operator<=operator>=operator<=> (bis C++20)(bis C++20)(bis C++20)(bis C++20)(bis C++20)(C++20) operator<< operator""sv Hilfsklassen hash<std::string_view>hash<std::wstring_view>hash<std::u8string_view>hash<std::u16string_view>hash<std::u32string_view> (C++20) Leitfäden zur Deduktion (C++20)

 

constexpr const_pointer data() const noexcept;		(seit C++17)

Gibt einen Zeiger auf das zugrundeliegende Zeichenarray zurück. Der Zeiger ist so beschaffen, dass der Bereich [data(), data() + size()) gültig ist und die Werte darin den Werten der Ansicht entsprechen.

Parameter

(keine)

Rückgabewert

Ein Zeiger auf das zugrundeliegende Zeichenarray.

Komplexität

Konstant.

Hinweise

Im Gegensatz zu std::basic_string::data() und String-Literalen gibt std::basic_string_view::data() einen Zeiger auf einen Puffer zurück, der nicht notwendigerweise null-terminiert ist, z. B. eine Substring-Ansicht (z. B. von remove_suffix). Daher ist es typischerweise ein Fehler, data() an eine Routine zu übergeben, die nur ein const CharT* annimmt und einen null-terminierten String erwartet.

Beispiel

Führen Sie diesen Code aus

#include <cstring>
#include <cwchar>
#include <iostream>
#include <string>
#include <string_view>
 
int main()
{
    std::wstring_view wcstr_v = L"xyzzy";
    std::cout << std::wcslen(wcstr_v.data()) << '\n';
    // OK: the underlying character array is null-terminated
 
    char array[3] = {'B', 'a', 'r'};
    std::string_view array_v(array, sizeof array);
    // std::cout << std::strlen(array_v.data()) << '\n';
    // error: the underlying character array is not null-terminated
 
    std::string str(array_v.data(), array_v.size()); // OK
    std::cout << std::strlen(str.data()) << '\n';
    // OK: the underlying character array of a std::string is always null-terminated
}

Ausgabe

5
3

Siehe auch

front	greift auf das erste Zeichen zu (öffentliche Member-Funktion)
back	greift auf das letzte Zeichen zu (öffentliche Member-Funktion)
data	gibt einen Zeiger auf das erste Zeichen eines Strings zurück (public member function of std::basic_string<CharT,Traits,Allocator>)