home | help 
std::experi...string_view(3)   C++ Standard Libary  std::experi...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::ba-
     sic_string_view<char>
	std::experimental::wstring_view 		  std::experimental::ba-
     sic_string_view<wchar_t>
	std::experimental::u16string_view		  std::experimental::ba-
     sic_string_view<char16_t>
	std::experimental::u32string_view		  std::experimental::ba-
     sic_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 specializa-
     tion)
	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 sup-
     ported
					   (macro constant)

Category:
	  * Noindexed pages

http://cppreference.com 	   2024.06.10	    std::experi...string_view(3)
home | help