命名空间
变体
操作

std::basic_string<CharT,Traits,Allocator>::data

来自 cppreference.cn
< cpp‎ | string‎ | basic_string
 
 
 
std::basic_string
 
const CharT* data() const;
(1) (C++11 起无异常抛出)
(C++20 起为 constexpr)
CharT* data() noexcept;
(2) (C++17 起)
(C++20 起为 constexpr)

返回指向用作字符存储的底层数组的指针。该指针使范围

[data()data() + size())

(C++11 前)

[data()data() + size()]

(C++11 起)

有效,并且其中的值与字符串中存储的值相对应。

返回的数组不要求以空字符终止。

如果 empty() 返回 true,则该指针是非空指针,不应解引用。

(C++11 前)

返回的数组以空字符终止,即 data()c_str() 执行相同的功能。

如果 empty() 返回 true,则该指针指向单个空字符。

(C++11 起)

通过 data() 获取的指针可能因以下情况而失效:

1) 通过 data 的 const 重载访问字符数组并进行修改具有未定义行为。
2) 将存储在 data() + size() 处的超尾空终止符修改为 CharT() 以外的任何值具有未定义行为。

目录

[编辑] 参数

(无)

[编辑] 返回值

指向底层字符存储的指针。

data()[i] == operator[](i) 对于 [0size()) 中的每个 i

(C++11 前)

data() + i == std::addressof(operator[](i)) 对于 [0size()] 中的每个 i

(C++11 起)

[编辑] 复杂度

常数时间。

[编辑] 示例

#include <algorithm>
#include <cassert>
#include <cstring>
#include <string>
 
int main()
{
    std::string const s("Emplary");
    assert(s.size() == std::strlen(s.data()));
    assert(std::equal(s.begin(), s.end(), s.data()));
    assert(std::equal(s.data(), s.data() + s.size(), s.begin()));
    assert('\0' == *(s.data() + s.size()));
}

[编辑] 参阅

(DR*)
访问第一个字符
(public member function) [编辑]
(DR*)
访问最后一个字符
(public member function) [编辑]
返回字符串的不可修改的标准 C 字符数组版本
(public member function) [编辑]
返回指向视图首字符的指针
(std::basic_string_view<CharT,Traits> 的公共成员函数) [编辑]