< cpp‎ | container‎ | array

T* data() noexcept;
(until C++17)
constexpr T* data() noexcept;
(since C++17)
const T* data() const noexcept;
(until C++17)
constexpr const T* data() const noexcept;
(since C++17)

Returns pointer to the underlying array serving as element storage. The pointer is such that range [data(); data() + size()) is always a valid range, even if the container is empty (data() is not dereferenceable in that case).



Return value

Pointer to the underlying element storage. For non-empty containers, the returned pointer compares equal to the address of the first element.




If size() is 0, data() may or may not return a null pointer.

See also

access the first element
(public member function)
access the last element
(public member function)
returns the number of elements
(public member function)