Scroll to navigation

std::experimental::basic_string_view(3) C++ Standard Libary std::experimental::basic_string_view(3)

NAME

std::experimental::basic_string_view - std::experimental::basic_string_view

Synopsis


Defined in header <experimental/string_view>
template<


class CharT, (library fundamentals TS)
class Traits = std::char_traits<CharT>


> class basic_string_view;


The class template basic_string_view describes an object that can refer to a
constant contiguous sequence of char-like objects with the first element of the
sequence at position zero.


A typical implementation holds only two members: a pointer to constant CharT and a
size.


Several typedefs for common character types are provided:


Defined in header <experimental/string_view>
Type Definition
std::experimental::string_view std::experimental::basic_string_view<char>
std::experimental::wstring_view std::experimental::basic_string_view<wchar_t>
std::experimental::u16string_view std::experimental::basic_string_view<char16_t>
std::experimental::u32string_view std::experimental::basic_string_view<char32_t>

Template parameters


CharT - character type
Traits - traits class specifying the operations on the character type

Member types


Member type Definition
traits_type Traits
value_type CharT
pointer CharT*
const_pointer const CharT*
reference CharT&
const_reference const CharT&
const_iterator implementation-defined LegacyRandomAccessIterator
iterator const_iterator
reverse_iterator const_reverse_iterator
const_reverse_iterator std::reverse_iterator<const_iterator>
size_type std::size_t
difference_type std::ptrdiff_t


Note: iterator and const_iterator are the same type because string views are views
into constant character sequences.

Member functions


constructor constructs a basic_string_view
(public member function)
operator= assigns a view
(public member function)

Iterators


begin returns an iterator to the beginning
cbegin (public member function)
end returns an iterator to the end
cend (public member function)
rbegin returns a reverse iterator to the beginning
crbegin (public member function)
rend returns a reverse iterator to the end
crend (public member function)

Element access


operator[] access specified character
(public member function)
at access specified character with bounds checking
(public member function)
front accesses the first character
(public member function)
back accesses the last character
(public member function)
data returns a pointer to the first character of a view
(public member function)

Capacity


size returns the number of characters
length (public member function)
max_size returns the maximum number of characters
(public member function)
empty checks whether the view is empty
(public member function)

Modifiers


remove_prefix shrinks the view by moving its start forward
(public member function)
remove_suffix shrinks the view by moving its end backward
(public member function)
swap swaps the contents
(public member function)

Operations


to_string creates a string from the view
operator basic_string (public member function)
copy copies characters
(public member function)
substr returns a substring
(public member function)
compare compares two views
(public member function)
find find characters in the view
(public member function)
rfind find the last occurrence of a substring
(public member function)
find_first_of find first occurrence of characters
(public member function)
find_last_of find last occurrence of characters
(public member function)
find_first_not_of find first absence of characters
(public member function)
find_last_not_of find last absence of characters
(public member function)

Constants


npos special value. The exact meaning depends on the context
[static] (public static member constant)

Non-member functions


operator==
operator!=
operator< lexicographically compares two views
operator> (function template)
operator<=
operator>=

Input/output


operator<< performs stream output on views
(function template)

Helper classes


std::hash<std::experimental::string_view>
std::hash<std::experimental::wstring_view> hash support for views
std::hash<std::experimental::u16string_view> (class template specialization)
std::hash<std::experimental::u32string_view>


Feature test macros


a value of at least 201411 indicates that
__cpp_lib_experimental_string_view basic_string_view template is supported
(macro constant)

Category:


* Noindexed pages

2024.06.10 http://cppreference.com