Просмотр кода страницы cpp/string/basic string view

У вас нет прав на выполнение действия «редактирование этой страницы» по следующей причине:
Запрошенное действие ��огут выполнять участники одной из следующих групп: Участники, Администраторы.
Вы можете просмотреть и скопировать исходный код этой страницы.
{{cpp/title|basic_string_view}}
{{cpp/string/basic_string_view/navbar}}
{{ddcl | header=string_view | since=c++17 | 1=
template< 
    class CharT, 
    class Traits = std::char_traits<CharT> 
> class basic_string_view;
}}

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

{{rrev|since=c++23|
Каждая специализация {{tt|std::basic_string_view}} является типом {{named req|TriviallyCopyable}}.	
}}

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

Предусмотрено несколько определений типов для общих типов символов:
{{dsc begin}}
{{dsc header | string_view}}
{{dsc hitem | Тип | Определение}}
{{dsc | {{lc|std::string_view}} | {{co|std::basic_string_view<char>}} }}
{{dsc | {{lc|std::wstring_view}} | {{co|std::basic_string_view<wchar_t>}} }}
{{dsc | {{lc|std::u8string_view}} {{mark c++20}} | {{co|std::basic_string_view<char8_t>}}}}
{{dsc | {{lc|std::u16string_view}} | {{co|std::basic_string_view<char16_t>}} }}
{{dsc | {{lc|std::u32string_view}} | {{co|std::basic_string_view<char32_t>}} }}
{{dsc end}}

===Параметры шаблона===
{{par begin}}
{{par | CharT | тип символа}}
{{par | Traits | класс {{named req|CharTraits}} определяет операции с типом символа. Как и для {{lc|std::basic_string}}, {{tt|Traits::char_type}} должен именовать тот же тип, что и {{tt|CharT}}, иначе программа некорректна.}}
{{par end}}

===Типы элементы===
{{dsc begin}}
{{dsc hitem | Тип элемент | Определение}}
{{dsc | {{tt|traits_type}} | {{tt|Traits}} }}
{{dsc | {{tt|value_type}} | {{tt|CharT}} }}
{{dsc | {{tt|pointer}} | {{co|CharT*}} }}
{{dsc | {{tt|const_pointer}} | {{co|const CharT*}} }}
{{dsc | {{tt|reference}} | {{co|CharT&}} }}
{{dsc | {{tt|const_reference}} | {{co|const CharT&}} }}
{{dsc | {{tt|const_iterator}} | определяемые реализацией константы {{named req|RandomAccessIterator}}<br>
{{rev begin|noborder=false}}
{{rev|until=c++20|and {{named req|ContiguousIterator}}}}
{{rev|since=c++20|{{named req|ConstexprIterator}}, and {{lconcept|contiguous_iterator}}}}
{{rev end}}
whose {{tt|value_type}} is {{tt|CharT}}}}
{{dsc|{{tt|iterator}}|{{tt|const_iterator}}}}
{{dsc|{{tt|const_reverse_iterator}}|{{co|std::reverse_iterator<const_iterator>}}}}
{{dsc|{{tt|reverse_iterator}}|{{tt|const_reverse_iterator}}}}
{{dsc|{{tt|size_type}}|{{lc|std::size_t}}}}
{{dsc|{{tt|difference_type}}|{{lc|std::ptrdiff_t}}}}
{{dsc end}}

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

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

===Функции-элементы===
{{dsc begin}}
{{dsc h2 | Конструкторы и присваивания}}
{{dsc inc | cpp/string/basic_string_view/dsc constructor}}
{{dsc inc | cpp/string/basic_string_view/dsc operator{{=}}}}

{{dsc h2 | Итераторы}}
{{dsc inc | cpp/string/basic_string_view/dsc begin}}
{{dsc inc | cpp/string/basic_string_view/dsc end}}
{{dsc inc | cpp/string/basic_string_view/dsc rbegin}}
{{dsc inc | cpp/string/basic_string_view/dsc rend}}

{{dsc h2 | Доступ к элементу}}
{{dsc inc | cpp/string/basic_string_view/dsc operator_at}}
{{dsc inc | cpp/string/basic_string_view/dsc at}}
{{dsc inc | cpp/string/basic_string_view/dsc front}}
{{dsc inc | cpp/string/basic_string_view/dsc back}}
{{dsc inc | cpp/string/basic_string_view/dsc data}}

{{dsc h2 | Ёмкость}}
{{dsc inc | cpp/string/basic_string_view/dsc size}}
{{dsc inc | cpp/string/basic_string_view/dsc max_size}}
{{dsc inc | cpp/string/basic_string_view/dsc empty}}

{{dsc h2 | Модификаторы}}
{{dsc inc | cpp/string/basic_string_view/dsc remove_prefix}}
{{dsc inc | cpp/string/basic_string_view/dsc remove_suffix}}
{{dsc inc | cpp/string/basic_string_view/dsc swap}}

{{dsc h2 | Операции}}
{{dsc inc | cpp/string/basic_string_view/dsc copy}}
{{dsc inc | cpp/string/basic_string_view/dsc substr}}
{{dsc inc | cpp/string/basic_string_view/dsc compare}}
{{dsc inc | cpp/string/basic_string_view/dsc starts_with}}
{{dsc inc | cpp/string/basic_string_view/dsc ends_with}}
{{dsc inc | cpp/string/basic_string_view/dsc contains}}
{{dsc inc | cpp/string/basic_string_view/dsc find}}
{{dsc inc | cpp/string/basic_string_view/dsc rfind}}
{{dsc inc | cpp/string/basic_string_view/dsc find_first_of}}
{{dsc inc | cpp/string/basic_string_view/dsc find_last_of}}
{{dsc inc | cpp/string/basic_string_view/dsc find_first_not_of}}
{{dsc inc | cpp/string/basic_string_view/dsc find_last_not_of}}

{{dsc h1 | Константы}}
{{dsc inc | cpp/string/basic_string_view/dsc npos}}
{{dsc end}}

===Функции, не являющиеся элементами===
{{dsc begin}}
{{dsc inc | cpp/string/basic_string_view/dsc operator_cmp}}
{{dsc h2 | Ввод/вывод}}
{{dsc inc | cpp/string/basic_string_view/dsc operator_ltlt}}
{{dsc end}}

===Литералы===
{{dsc begin}}
{{dsc namespace | [[cpp/header/string_view#Синопсис|std::literals::string_view_literals]] | inline=true }}
{{dsc inc | cpp/string/basic_string_view/dsc operator""sv}}
{{dsc end}}

===Вспомогательные классы===
{{dsc begin}}
{{dsc inc | cpp/string/basic_string_view/dsc hash}}
{{dsc end}}

===Вспомогательные шаблоны===
{{ddcl|since=c++20|1=
template<class CharT, class Traits>
inline constexpr bool ranges::enable_borrowed_range<std::basic_string_view<CharT, Traits>> = true;
}}
Эта специализация {{ltt|cpp/ranges/borrowed_range|std::ranges::enable_borrowed_range}} заставляет {{tt|basic_string_view}} соответствовать {{lconcept|borrowed_range}}.

{{ddcl|since=c++20|1=
template<class CharT, class Traits>
inline constexpr bool ranges::enable_view<std::basic_string_view<CharT, Traits>> = true;
}}

Эта специализация {{ltt|cpp/ranges/view|std::ranges::enable_view}} делает {{tt|basic_string_view}} соответствующей {{lconcept|view}}.

==={{rl|deduction guides|Руководства по выводу}} {{mark since c++20}}===

===Примечания===
Ответственность за то, чтобы {{tt|std::string_view}} не пережил указанный им массив символов, является обязанностью программиста:
{{source|1=
std::string_view good {"строковый литерал"};
  // "Хороший" случай: `good` указывает на статический массив. Строковые литералы
  // обычно находятся в постоянных сегментах данных.

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

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

{{ftm begin|std=1|comment=1}}
{{ftm|std=C++17|value=201606L|__cpp_lib_string_view|rowspan="2"|[[#Top|{{tt|std::string_view}}]]}}
{{ftm|std=C++20|value=201803L|-|{{named req|ConstexprIterator}}}}
{{ftm|std=C++23|value=202011L|__cpp_lib_string_contains|{{rlt|contains}}}}
{{ftm end}}

===Пример===
{{example|code=
#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';
    }
}
| output=
▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─
▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─
▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄
▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀
▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─
▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─
}}

===Смотрите также===
{{dsc begin}}
{{dsc inc | cpp/string/dsc basic_string}}
{{dsc inc | cpp/container/dsc span}}
{{dsc inc | cpp/utility/dsc initializer_list}}
{{dsc end}}

{{langlinks|de|en|es|ja|zh}}
Шаблоны, используемые на этой странице:
Возврат к странице cpp/string/basic string view.
cppreference.com

Поиск

Пространства имён

Варианты

Просмотры

Действия

Просмотр кода страницы cpp/string/basic string view

Навигация

Инструменты
