<string_view>
Defines the class template basic_string_view and related types and operators. (Requires compiler option std:c++17 or later.)
Syntax
#include <string_view>
Remarks
The string_view family of template specializations provides an efficient way to pass a read-only, exception-safe, non-owning handle to the character data of any string-like objects with the first element of the sequence at position zero. A function parameter of type string_view (which is a typedef for basic_string_view<char>) can accept arguments such as std::string, char*, or any other string-like class of narrow characters for which an implicit conversion to string_view is defined. Similarly, a parameter of wstring_view, u16string_view or u32string_view can accept any string type for which an implicit conversion is defined. For more information, see basic_string_view Class.
Typedefs
| Type name | Description |
|---|---|
string_view |
A specialization of the class template basic_string_view with elements of type char. |
wstring_view |
A specialization of the class template basic_string_view with elements of type wchar_t. |
u16string_view |
A specialization of the class template basic_string_view with elements of type char16_t. |
u32string_view |
A specialization of the class template basic_string_view with elements of type char32_t. |
Operators
The <string_view> operators can compare string_view objects to objects of any convertible string types.
| Operator | Description |
|---|---|
operator!= |
Tests if the object on the left side of the operator isn't equal to the object on the right side. |
operator== |
Tests if the object on the left side of the operator is equal to the object on the right side. |
operator< |
Tests if the object on the left side of the operator is less than to the object on the right side. |
operator<= |
Tests if the object on the left side of the operator is less than or equal to the object on the right side. |
operator<\< |
A template function that inserts a string_view into an output stream. |
operator> |
Tests if the object on the left side of the operator is greater than to the object on the right side. |
operator>= |
Tests if the object on the left side of the operator is greater than or equal to the object on the right side. |
Literals
| Operator | Description |
|---|---|
sv |
Constructs a string_view, wstring_view, u16string_view, or u32string_view depending on the type of the string literal to which it's appended. |
Classes
| Class | Description |
|---|---|
basic_string_view Class |
A class template that provides a read-only view into a sequence of arbitrary character-like objects. |
hash |
Function object that produces a hash value for a string_view. |
Requirements
Header:
<string_view>Namespace:
stdCompiler Option:
std:c++17or later.