std::vector<T,Allocator>:: data
|
T
*
data
(
)
;
|
(1) |
(C++11부터 noexcept)
(C++20부터 constexpr) |
|
const
T
*
data
(
)
const
;
|
(2) |
(C++11부터 noexcept)
(C++20부터 constexpr) |
요소 저장소 역할을 하는 기반 배열에 대한 포인터를 반환합니다. 이 포인터는
[
data
(
)
,
data
(
)
+
size()
)
범위가 항상
유효한 범위
가 되도록 합니다.
만약
*
this
가 비어 있다면,
data()
는 역참조할 수 없습니다.
목차 |
반환값
기반 요소 저장소에 대한 포인터. 비어 있지 않은 컨테이너의 경우, 반환된 포인터는 첫 번째 요소의 주소와 동일하게 비교됩니다.
복잡도
상수.
참고 사항
만약
*
this
가 비어 있다면,
data()
는 null 포인터를 반환할 수도 있고 반환하지 않을 수도 있습니다.
예제
#include <cstddef> #include <iostream> #include <span> #include <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) // C++20 이후 { std::cout << "data = "; for (const int e : data) std::cout << e << ' '; std::cout << '\n'; } int main() { std::vector<int> container{1, 2, 3, 4}; // &container[0]보다 container.data()를 선호합니다 pointer_func(container.data(), container.size()); // std::span은 분리된 포인터/크기에 대한 더 안전한 대안입니다. span_func({container.data(), container.size()}); }
출력:
data = 1 2 3 4 data = 1 2 3 4
결함 보고서
다음의 동작 변경 결함 보고서들은 이전에 발표된 C++ 표준에 소급 적용되었습니다.
| DR | 적용 대상 | 게시된 동작 | 올바른 동작 |
|---|---|---|---|
| LWG 464 | C++98 |
vector
에 이 멤버 함수가 없었음
|
추가됨 |
| LWG 1312 | C++98 |
반환 타입이
pointer
와
const_pointer
였음
|
각각 T * 와 const T * 로 변경됨 |
참고 항목
|
첫 번째 요소에 접근
(public member function) |
|
|
마지막 요소에 접근
(public member function) |
|
|
요소의 개수를 반환
(public member function) |
|
|
지정된 요소에 접근
(public member function) |
|
|
(C++20)
|
연속된 객체 시퀀스에 대한 비소유 뷰
(class template) |
|
(C++17)
|
기본 배열에 대한 포인터를 얻음
(function template) |