Namensräume
Varianten
Aktionen

std::inplace_vector<T,N>::data

Von cppreference.com
 
 
 
 
constexpr T* data() noexcept;
(1) (seit C++26)
constexpr const T* data() const noexcept;
(2) (seit C++26)

Gibt einen Zeiger auf das zugrunde liegende Array zurück, das als Speicherelement dient. Der Zeiger ist so, dass der Bereich [data()data() + size()) immer ein gültiger Bereich ist, auch wenn der Container leer ist (data() ist in diesem Fall nicht dereferenzierbar).

Inhalt

[bearbeiten] Parameter

(keine)

[bearbeiten] Rückgabewert

Zeiger auf den zugrunde liegenden Elementenspeicher. Für nicht-leere Container ist der zurückgegebene Zeiger gleich der Adresse des ersten Elements, d.h. data() == std::addressof(front()) ist true.

[bearbeiten] Komplexität

Konstant.

[bearbeiten] Anmerkungen

Wenn size() 0 ist, kann data() einen Nullzeiger zurückgeben oder auch nicht.

[bearbeiten] Beispiel

#include <cstddef>
#include <iostream>
#include <span>
#include <inplace_vector>
 
void pointer_func(const int* p, std::size_t size)
{
    std::cout << "data = ";
    for (std::size_t i = 0; i < size; ++i)
        std::cout << p[i] << ' ';
    std::cout << '\n';
}
 
void span_func(std::span<const int> data) // since C++20
{
    std::cout << "data = ";
    for (const int e : data)
        std::cout << e << ' ';
    std::cout << '\n';
}
 
int main()
{
    std::inplace_vector<int, 4> container{1, 2, 3, 4};
 
    // Prefer container.data() over &container[0]
    pointer_func(container.data(), container.size());
 
    // std::span is a safer alternative to separated pointer/size.
    span_func({container.data(), container.size()});
}

Ausgabe

data = 1 2 3 4
data = 1 2 3 4

[bearbeiten] Siehe auch

Greift auf das erste Element zu
(public member function) [edit]
Greift auf das letzte Element zu
(public member function) [edit]
Gibt die Anzahl der Elemente zurück
(public member function) [edit]
Greift auf ein bestimmtes Element zu
(public member function) [edit]
(C++20)
eine nicht besitzende Ansicht über eine zusammenhängende Sequenz von Objekten
(class template) [bearbeiten]
(C++17)
erhält den Zeiger auf das zugrundeliegende Array
(function template) [bearbeiten]