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  )	 const
       (1) (since C++20)
	  noexcept;
	  constexpr							  bool
       (2) (since C++20)
	      ends_with( CharT ch ) const noexcept;
	  constexpr							  bool
       (3) (since C++20)
	      ends_with( const CharT* s	) const;

	  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	ch.
	  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
	  ch - 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      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>
	#include <string_view>

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

	    const auto str = "Hello, C++20!"s;

	    assert
	    (""
		&& str.ends_with("C++20!"sv)  // (1)
		&& !str.ends_with("c++20!"sv) // (1)
		&&  str.ends_with("C++20!"s)	//  (1)	 implicit   conversion
       string to string_view
		&&   !str.ends_with("c++20!"s)	 //  (1)  implicit  conversion
       string to string_view
		&& str.ends_with('!')	      // (2)
		&& !str.ends_with('?')	      // (2)
		&& str.ends_with("C++20!")    // (3)
		&& !str.ends_with("c++20!")   // (3)
	    );
	}

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		  2024.06.10	  std::basic_...::ends_with(3)

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

home | help