Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
std::experi...string_view(3)  C++ Standard Libary std::experi...string_view(3)

NAME
       std::experimental::basic_string_view	 -	std::experimental::ba-
       sic_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 el-
       ement of	the
	  sequence at position zero.

	  A typical implementation holds only two members: a pointer  to  con-
       stant 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	 LegacyRandomAccessIt-
       erator
	  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	check-
       ing
				(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  spe-
       cialization)
	  std::hash<std::experimental::u32string_view>

	 Feature test macros

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

http://cppreference.com		  2022.07.31	  std::experi...string_view(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=std::experimental::basic_string_view&sektion=3&manpath=FreeBSD+Ports+15.0>

home | help