std::basic_string_view

 

C++

Поддержка компилятором

Автономные и размещённые реализации

Язык

Заголовки стандартной библиотеки

Требования к именованию

Макросы тестирования функциональности (C++20)

Поддержка языка

Библиотека концептов (C++20)

Библиотека диагностики

Библиотека общих утилит

Библиотека строк

Библиотека контейнеров

Библиотека итераторов

Библиотека диапазонов (C++20)

Библиотека алгоритмов

Библиотека численных данных

Библиотека ввода/вывода

Библиотека локализаций

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

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

Библиотека поддержки потоков (C++11)

Библиотека файловой системы (C++17)

Технические спецификации

Указатель символов

Внешние библиотеки

 

Строки

Строки с завершающим нулём

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

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

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

Классы

basic_string

basic_string_view (C++17)

char_traits

 

std::basic_string_view

Функции-элементы basic_string_view::basic_string_view    basic_string_view::operator= Итераторы basic_string_view::beginbasic_string_view::cbegin basic_string_view::endbasic_string_view::cend basic_string_view::rbeginbasic_string_view::crbegin basic_string_view::rendbasic_string_view::crend Доступ к элементу basic_string_view::at basic_string_view::operator[] basic_string_view::front basic_string_view::back basic_string_view::data Ёмкость basic_string_view::sizebasic_string_view::length basic_string_view::max_size basic_string_view::empty Модификаторы basic_string_view::remove_prefix basic_string_view::remove_suffix basic_string_view::swap

Операции basic_string_view::copy basic_string_view::substr basic_string_view::compare basic_string_view::starts_with (C++20) basic_string_view::ends_with (C++20) basic_string_view::contains (C++23) basic_string_view::find basic_string_view::rfind basic_string_view::find_first_of basic_string_view::find_last_of basic_string_view::find_first_not_of basic_string_view::find_last_not_of Константы basic_string_view::npos Функции, не являющиеся элементами operator==operator!=operator<operator>operator<=operator>=operator<=> (до C++20)(до C++20)(до C++20)(до C++20)(до C++20)(C++20) operator<< operator""sv Вспомогательные классы hash<std::string_view>hash<std::wstring_view>hash<std::u8string_view>hash<std::u16string_view>hash<std::u32string_view> (C++20) Руководства по выводу (C++20)

 

Определено в заголовочном файле <string_view>
template<     class CharT,     class Traits = std::char_traits<CharT> > class basic_string_view;		(начиная с C++17)

Шаблон класса basic_string_view описывает объект, который может ссылаться на постоянную непрерывную последовательность char подобных объектов с первым элементом последовательности в нулевой позиции.

Каждая специализация std::basic_string_view является типом TriviallyCopyable.

(начиная с C++23)

Типичная реализация содержит только два элемента: указатель на константу CharT и размер.

Предусмотрено несколько определений типов для общих типов символов:

Определены в заголовочном файле <string_view>
Тип	Определение
std::string_view	std::basic_string_view<char>
std::wstring_view	std::basic_string_view<wchar_t>
std::u8string_view (C++20)	std::basic_string_view<char8_t>
std::u16string_view	std::basic_string_view<char16_t>
std::u32string_view	std::basic_string_view<char32_t>

Параметры шаблона

CharT	—	тип символа
Traits	—	класс CharTraits определяет операции с типом символа. Как и для basic_string, Traits::char_type должен именовать тот же тип, что и CharT, иначе программа некорректна.

Типы элементы

Тип элемент	Определение
traits_type	Traits
value_type	CharT
pointer	CharT*
const_pointer	const CharT*
reference	CharT&
const_reference	const CharT&
const_iterator	определяемые реализацией константы LegacyRandomAccessIterator, ConstexprIterator (начиная с C++20) и LegacyContiguousIterator (до C++20)contiguous_iterator (начиная с C++20), для которых value_type равно CharT
iterator	const_iterator
const_reverse_iterator	std::reverse_iterator<const_iterator>
reverse_iterator	const_reverse_iterator
size_type	std::size_t
difference_type	std::ptrdiff_t

Примечание: iterator и const_iterator относятся к одному и тому же типу, поскольку строковые представления являются представлениями постоянных последовательностей символов.

Все требования к типам итераторов для Container применяются также к типам iterator и const_iterator для basic_string_view.

Функции-элементы

Конструкторы и присваивания
(конструктор) (C++17)	конструирует basic_string_view (public функция-элемент)
operator= (C++17)	присваивает представлению (public функция-элемент)
Итераторы
begin cbegin (C++17)	возвращает итератор на начало (public функция-элемент)
end cend (C++17)	возвращает итератор на конец (public функция-элемент)
rbegin crbegin (C++17)	возвращает обратный итератор на начало (public функция-элемент)
rend crend (C++17)	возвращает обратный итератор на конец (public функция-элемент)
Доступ к элементу
operator[] (C++17)	предоставляет доступ к указанному символу (public функция-элемент)
at (C++17)	получает доступ к указанному символу с проверкой границ (public функция-элемент)
front (C++17)	предоставляет доступ к первому символу (public функция-элемент)
back (C++17)	предоставляет доступ к последнему символу (public функция-элемент)
data (C++17)	возвращает указатель на первый символ представления (public функция-элемент)
Ёмкость
size length (C++17)	возвращает количество символов (public функция-элемент)
max_size (C++17)	возвращает максимальное число символов (public функция-элемент)
empty (C++17)	проверяет, является ли представление пустым (public функция-элемент)
Модификаторы
remove_prefix (C++17)	сжимает представление, перемещая его начало вперёд (public функция-элемент)
remove_suffix (C++17)	сжимает представление, перемещая его конец назад (public функция-элемент)
swap (C++17)	обменивает содержимое (public функция-элемент)
Операции
copy (C++17)	копирует символы (public функция-элемент)
substr (C++17)	возвращает подстроку (public функция-элемент)
compare (C++17)	сравнивает два представления (public функция-элемент)
starts_with (C++20)	проверяет, начинается ли строковое представление с заданного префикса (public функция-элемент)
ends_with (C++20)	проверяет, заканчивается ли строковое представление заданным суффиксом (public функция-элемент)
contains (C++23)	проверяет, содержит ли строковое представление заданную подстроку или символ (public функция-элемент)
find (C++17)	ищет символы в представлении (public функция-элемент)
rfind (C++17)	ищет последнее вхождение подстроки (public функция-элемент)
find_first_of (C++17)	ищет первое вхождение символов (public функция-элемент)
find_last_of (C++17)	ищет последнее вхождение символов (public функция-элемент)
find_first_not_of (C++17)	ищет первое отсутствие символов (public функция-элемент)
find_last_not_of (C++17)	ищет последнее отсутствие символов (public функция-элемент)
Константы
npos [static] (C++17)	особое значение. Точное значение зависит от контекста (public static константа-элемент)

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

operator== operator!= operator< operator> operator<= operator>= operator<=> (C++17) (убрано в C++20) (убрано в C++20) (убрано в C++20) (убрано в C++20) (убрано в C++20) (C++20)	лексикографически сравнивает два строковых представления (шаблон функции)
Ввод/вывод
operator<< (C++17)	выполняет потоковый вывод строковых представлений (шаблон функции)

Литералы

Определены в пространстве имён std::literals::string_view_literals
operator""sv (C++17)	Создаёт строковое представление литерала массива символов (функция)

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

std::hash<std::string_view> std::hash<std::wstring_view> std::hash<std::u8string_view> std::hash<std::u16string_view> std::hash<std::u32string_view> (C++17) (C++17) (C++20) (C++17) (C++17)	хеш-поддержка для строковых представлений (специализация шаблона класса)

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

template<class CharT, class Traits> inline constexpr bool ranges::enable_borrowed_range<std::basic_string_view<CharT, Traits>> = true;		(начиная с C++20)

Эта специализация std::ranges::enable_borrowed_range заставляет basic_string_view соответствовать borrowed_range.

template<class CharT, class Traits> inline constexpr bool ranges::enable_view<std::basic_string_view<CharT, Traits>> = true;		(начиная с C++20)

Эта специализация std::ranges::enable_view делает basic_string_view соответствующей view.

Примечания

Ответственность за то, чтобы std::string_view не пережил указанный им массив символов, является обязанностью программиста:

std::string_view good {"строковый литерал"};
  // "Хороший" случай: `good` указывает на статический массив (строковые литералы
  // обычно находятся в постоянных сегментах данных).
std::string_view bad {"временная строка"s};	
  // "Плохой" случай: `bad` содержит висящий указатель, поскольку временный std::string,	
  // созданный std::operator""s, будет уничтожен в конце оператора.

Специализации std::basic_string_view уже являются тривиально копируемыми типами во всех существующих реализациях, даже до формального требования, введённого в C++23.

Пример

Запустить этот код

#include <iostream>
#include <string_view>
 
int main() {
    constexpr std::string_view unicode[] {
        "▀▄─", "▄▀─", "▀─▄", "▄─▀"
    };
 
    for (int y{}, p{}; y != 6; ++y, p = ((p + 1) % 4)) {
        for (int x{}; x != 16; ++x)
            std::cout << unicode[p];
        std::cout << '\n';
    }
}

Возможный вывод:

▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─
▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─
▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄
▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀
▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─
▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─

Смотрите также

basic_string	хранит и управляет последовательностями символов (шаблон класса)
span (C++20)	не владеющее представление непрерывной последовательности объектов (шаблон класса)
initializer_list (C++11)	создаёт временный массив в списке инициализации, а затем ссылается на него (шаблон класса)