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

FreeBSD Manual Pages

  
 
  

home | help
std::basic_...w::ends_with(3) C++ Standard Libarystd::basic_...w::ends_with(3)

NAME
       std::basic_string_view::ends_with - std::basic_string_view::ends_with

Synopsis
	  constexpr bool ends_with( basic_string_view sv ) const noexcept; (1)
       (since C++20)
	  constexpr bool ends_with( CharT ch ) const noexcept;		   (2)
       (since C++20)
	  constexpr bool ends_with( const CharT* s ) const;		   (3)
       (since C++20)

	  Checks if the	string view ends with the given	suffix,	where

	  1)  the  suffix  is  a  string  view.	 Effectively returns size() >=
       sv.size() &&
	  compare(size() - sv.size(), npos, sv)	== 0.
	  2) the suffix	is a single character. Effectively returns !empty() &&
	  Traits::eq(back(), ch).
	  3) the suffix	is a null-terminated character string. Effectively re-
       turns
	  ends_with(basic_string_view(s)).

Parameters
	  sv - a string	view which may be a result of implicit conversion from
	       std::basic_string
	  ch - a single	character
	  s  - a null-terminated character string

Return value
	  true if the string view ends with the	provided suffix, false	other-
       wise.

Notes
	      Feature-test macro      Value    Std		      Feature
	  __cpp_lib_starts_ends_with  201711L (C++20) String prefix and	suffix
       checking:
						     starts_with()	   and
       ends_with()

Example
       // Run this code

	#include <cassert>
	#include <string_view>

	int main()
	{
	    using namespace std::literals;

	    assert
	    (""
		// (1) ends_with( basic_string_view sv )
		&&			   std::string_view("https://cpprefer-
       ence.com").ends_with(".com"sv) == true
		&&			   std::string_view("https://cpprefer-
       ence.com").ends_with(".org"sv) == false

		// (2) ends_with( CharT	c )
		&& std::string_view("C++20").ends_with('0') == true
		&& std::string_view("C++20").ends_with('3') == false

		// (3) ends_with( const	CharT* s )
		&& std::string_view("string_view").ends_with("view") ==	true
		&& std::string_view("string_view").ends_with("View") ==	false
	    );
	}

See also
	  starts_with checks if	the string view	starts with the	given prefix
	  (C++20)     (public member function)
	  starts_with checks if	the string starts with the given prefix
	  (C++20)	   (public     member	  function     of     std::ba-
       sic_string<CharT,Traits,Allocator>)

	  ends_with   checks if	the string ends	with the given suffix
	  (C++20)	  (public     member	 function     of      std::ba-
       sic_string<CharT,Traits,Allocator>)

	  contains     checks  if  the	string contains	the given substring or
       character
	  (C++23)	  (public     member	 function     of      std::ba-
       sic_string<CharT,Traits,Allocator>)

	  contains     checks  if the string view contains the given substring
       or character
	  (C++23)     (public member function)
	  compare     compares two views
		      (public member function)

http://cppreference.com		  2024.06.10	 std::basic_...w::ends_with(3)

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

home | help