std::vector<T,Allocator>:: data

返回指向作为元素存储的底层数组的指针。该指针满足范围 [ data ( ) , data ( ) + size() ) 始终是 有效范围

如果 * this 为空，则 data() 不可解引用。

返回值

指向底层元素存储的指针。对于非空容器，返回的指针与首元素地址比较结果相等。

复杂度

常量。

注释

如果 * this 为空， data() 可能返回也可能不返回空指针。

示例

#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) // since 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.data() 而非 &container[0]
    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++标准。

参见