const CharT* c_str() const;
(noexcept since C++11)Returns a pointer to a null-terminated character array with data equivalent to those stored in the string.
The pointer is such that the range [
c_str(),
c_str() + size()]
is valid and the values in it correspond to the values stored in the string with an additional null character after the last position.
The pointer obtained from c_str()
may be invalidated by:
Writing to the character array accessed through c_str()
is undefined behavior.
c_str()
and data() perform the same function.
(none)
[edit] Return valuePointer to the underlying character storage.
c_str()[i] == operator[](i) for every i
in [
â0â,
size())
.
c_str() + i == std::addressof(operator[](i)) for every i
in [
â0â,
size()]
.
Constant.
[edit] NotesThe pointer obtained from c_str()
may only be treated as a pointer to a null-terminated character string if the string object does not contain other null characters.
#include <algorithm> #include <cassert> #include <cstring> #include <string> extern "C" void c_func(const char* c_str) { printf("c_func called with '%s'\n", c_str); } int main() { std::string const s("Emplary"); const char* p = s.c_str(); assert(s.size() == std::strlen(p)); assert(std::equal(s.begin(), s.end(), p)); assert(std::equal(p, p + s.size(), s.begin())); assert('\0' == *(p + s.size())); c_func(s.c_str()); }
Output:
c_func called with 'Emplary'[edit] See also accesses the first character
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4