std::basic_string::c_str

 

C++

Язык

Понятия (концепции)

Утилиты

Строки

Контейнеры

Алгоритмы

Итераторы

Работа с числами

Ввод / вывод

Локализация

Регулярные выражения (C++11)

Атомарные примитивы (C++11)

Потоки (C++11)

 

Строки

Байтовые строки с завершающим нулем

Однобайтовые строки

Многобайтовые строки

Широкие строки

Классы

basic_string

char_traits

 

std::basic_string

Функции-члены

basic_string::basic_string

basic_string::operator=

basic_string::assign

basic_string::get_allocator

Доступ к элементам

basic_string::at

basic_string::operator[]

basic_string::front (C++11)

basic_string::back (C++11)

basic_string::data

basic_string::c_str

Итераторы

basic_string::begin basic_string::cbegin (C++11)

basic_string::end basic_string::cend (C++11)

basic_string::rbegin basic_string::crbegin (C++11)

basic_string::rend basic_string::crend (C++11)

Вместимость

basic_string::empty

basic_string::size

basic_string::length

basic_string::max_size

basic_string::reserve

basic_string::capacity

basic_string::shrink_to_fit (C++11)

Операции

basic_string::clear

basic_string::insert

basic_string::erase

basic_string::push_back

basic_string::pop_back (C++11)

basic_string::append

basic_string::operator+=

basic_string::compare

basic_string::replace

basic_string::substr

basic_string::copy

basic_string::resize

basic_string::swap

Поиск

basic_string::find

basic_string::rfind

basic_string::find_first_of

basic_string::find_first_not_of

basic_string::find_last_of

basic_string::find_last_not_of

Константы

basic_string::npos

Функции, не являющиеся членами

operator+

operator== operator!= operator< operator> operator<= operator>=

swap(std::basic_string)

operator<< operator>>

getline

stoi stol stoll (C++11) (C++11) (C++11)

stoul stoull (C++11) (C++11)

stof stod stold (C++11) (C++11) (C++11)

to_string (C++11)

to_wstring (C++11)

Вспомогательные классы

hash<std::string> hash<std::wstring> hash<std::u32string> hash<std::u16string> (C++11)

 

const CharT* c_str() const;

Возвращает указатель на массив символов с завершающим нулем, который содержит данные, идентичные тем, что хранятся в строке. Указатель будет таким, что диапазон [c_str(); c_str() + size()] является действительным и его значения соответствуют значениям, хранящимся в строке с дополнительными нулевым символом следующим за последним символом.

Заметки

Указатель, полученный с помощью c_str() может рассматриваться как указатель на строку с завершающим нулем только в том случае, если в строке не содержится других нулевых символов.

Запись в массив символов, полученный с помощью c_str() вызовет неопределенное поведение.

Начиная с С++11 c_str() и data() выполняют одну и ту же функцию.

Параметры

(Нет)

Возвращаемое значение

Указатель на массив символов с завершающим нулем, такой, что для каждого data()[i] == operator[](i) i в [0, size()]. (до C++11)

Указатель на лежащий в основе строки массив, такой, что data() + i == &operator[](i) для каждого i в [0, size()]. (начиная с C++11)

Сложность

Константная

Исключения

спецификация noexcept:  

noexcept

  

См. также

front (C++11)	получение первого символа (public функция-член)
back (C++11)	получение последнего символа (public функция-член)
data	возвращает указатель на первый символ строки (public функция-член)