home | help 
std::basic_..._view::rfind(3)  C++ Standard Libary std::basic_..._view::rfind(3)

NAME
     std::basic_string_view::rfind - std::basic_string_view::rfind

Synopsis
	constexpr  size_type  rfind( basic_string_view v, size_type pos =    (1)
     (since C++17)
	npos ) const noexcept;
	constexpr size_type rfind( CharT ch, size_type pos = npos )  const   (2)
     (since C++17)
	noexcept;
	constexpr  size_type  rfind( const CharT* s, size_type pos,	     (3)
     (since C++17)
	size_type count ) const;
	constexpr size_type rfind( const CharT* s, size_type pos = npos  )   (4)
     (since C++17)
	const;

	Finds  the last substring that is equal to the given character sequence.
     The search
	begins at pos and proceeds from right to  left	(thus,	the  found  sub-
     string, if any,
	cannot	begin  in  a  position	following pos). If npos or any value not
     smaller than
	size() - 1 is passed as pos, the whole string will be searched.

	1) Finds the last occurrence of v in this  view,  starting  at	position
     pos.
	2) Equivalent to rfind(basic_string_view(std::addressof(ch), 1), pos).
	3) Equivalent to rfind(basic_string_view(s, count), pos).
	4) Equivalent to rfind(basic_string_view(s), pos).

Parameters
	v     - view to search for
	pos   - position at which to start the search
	count - length of substring to search for
	s     - pointer to a character string to search for
	ch    - character to search for

Return value
	Position  of  the  first  character of the found substring or npos if no
     such substring
	is found.

Complexity
	O(size() * v.size()) at worst.

Example
     // Run this code

      #include <string_view>

      int main()
      {
	  using namespace std::literals;
	  constexpr auto N = std::string_view::npos;

	  static_assert(true
	      && (6 == "AB AB AB"sv.rfind("AB"))
	      && (6 == "AB AB AB"sv.rfind("ABCD", N, 2))
	      && (3 == "AB AB AB"sv.rfind("AB", 5))
	      && (0 == "AB CD EF"sv.rfind("AB", 0))
	      && (2 == "B AB AB "sv.rfind("AB", 2))
	      && (N == "B AB AB "sv.rfind("AB", 1))
	      && (5 == "B AB AB "sv.rfind('A'))
	      && (4 == "AB AB AB"sv.rfind('B', 4))
	      && (N == "AB AB AB"sv.rfind('C'))
	  );
      }

See also
	find		  find characters in the view
			  (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)
			  find the last occurrence of a substring
	rfind		  (public member function of
			  std::basic_string<CharT,Traits,Allocator>)

http://cppreference.com 	   2024.06.10	   std::basic_..._view::rfind(3)
home | help