std::basic_string<CharT,Traits,Allocator>::data
来自 cppreference.cn
< cpp | string | basic_string
const CharT* data() const; |
(1) | (C++11 起无异常抛出) (C++20 起为 constexpr) |
CharT* data() noexcept; |
(2) | (C++17 起) (C++20 起为 constexpr) |
返回指向用作字符存储的底层数组的指针。该指针使范围
|
(C++11 前) |
|
(C++11 起) |
有效,并且其中的值与字符串中存储的值相对应。
返回的数组不要求以空字符终止。 如果 empty() 返回 true,则该指针是非空指针,不应解引用。 |
(C++11 前) |
返回的数组以空字符终止,即 如果 empty() 返回 true,则该指针指向单个空字符。 |
(C++11 起) |
通过 data()
获取的指针可能因以下情况而失效:
- 将字符串的非 const 引用传递给任何标准库函数,或
- 在字符串上调用非 const 成员函数,不包括
operator[]()
、at()、front()、back()、begin()、end()、rbegin()、rend()。
1) 通过
data
的 const 重载访问字符数组并进行修改具有未定义行为。目录 |
[编辑] 参数
(无)
[编辑] 返回值
指向底层字符存储的指针。
data()[i] == operator[](i) 对于 |
(C++11 前) |
data() + i == std::addressof(operator[](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> 的公共成员函数) |