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

FreeBSD Manual Pages

  
 
  

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

NAME
       std::basic_string::ends_with - std::basic_string::ends_with

Synopsis
	  constexpr bool ends_with( std::basic_string_view<CharT,Traits> sv
	  )
       (1) (since C++20)
	  const	noexcept;
	  constexpr    bool    ends_with(    CharT   c	 )   const   noexcept;
       (2) (since C++20)
	  constexpr   bool   ends_with(	   const    CharT*    s	   )	const;
       (3) (since C++20)

	  Checks  if  the string ends with the given suffix. The suffix	may be
       one of the
	  following:

	  1) a string view sv (which may be a result  of  implicit  conversion
       from another
	  std::basic_string).
	  2) a single character	c.
	  3) a null-terminated character string	s.

	  All three overloads effectively return std::basic_string_view<CharT,
       Traits>(data(),
	  size()).ends_with(x),	where x	is the parameter.

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

Return value
	  true if the string ends with the provided suffix, false otherwise.

Notes
	  Feature-test macro: __cpp_lib_starts_ends_with

Example
       // Run this code

	#include <iostream>
	#include <string_view>
	#include <string>

	template <typename SuffixType>
	void test_suffix_print(const std::string& str, SuffixType suffix)
	{
	    std::cout << '\'' << str <<	"' ends	with '"	<< suffix << "': " <<
		str.ends_with(suffix) << '\n';
	}

	int main()
	{
	    std::boolalpha(std::cout);
	    auto helloWorld = std::string("hello world");

	    test_suffix_print(helloWorld, std::string_view("world"));

	    test_suffix_print(helloWorld, std::string_view("goodbye"));

	    test_suffix_print(helloWorld, 'd');

	    test_suffix_print(helloWorld, 'x');
	}

Output:
	'hello world' ends with	'world': true
	'hello world' ends with	'goodbye': false
	'hello world' ends with	'd': true
	'hello world' ends with	'x': false

See also
	  starts_with checks if	the string starts with the given prefix
	  (C++20)     (public member function)
	  starts_with checks if	the string view	starts with the	given prefix
	  (C++20)	   (public     member	  function     of     std::ba-
       sic_string_view<CharT,Traits>)
	  ends_with   checks if	the string view	ends with the given suffix
	  (C++20)	  (public     member	 function     of      std::ba-
       sic_string_view<CharT,Traits>)
	  contains     checks  if  the	string contains	the given substring or
       character
	  (C++23)     (public member function)
	  contains    checks if	the string view	contains the  given  substring
       or character
	  (C++23)	   (public     member	  function     of     std::ba-
       sic_string_view<CharT,Traits>)
	  compare     compares two strings
		      (public member function)
	  substr      returns a	substring
		      (public member function)

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

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

home | help