`<string_view>`

Article
03/01/2022

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: std
Compiler Option: std:c++17 or later.