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

FreeBSD Manual Pages

  
 
  

home | help
std::set::upper_bound(3)      C++ Standard Libary     std::set::upper_bound(3)

NAME
       std::set::upper_bound - std::set::upper_bound

Synopsis
	  iterator upper_bound(	const Key& key );	      (1)
	  const_iterator upper_bound( const Key& key ) const; (2)
	  template<   class  K	>				   (3)	(since
       C++14)
	  iterator upper_bound(	const K& x );
	  template<  class  K  >				  (4)	(since
       C++14)
	  const_iterator upper_bound( const K& x ) const;

	  1,2)	Returns	 an  iterator  pointing	 to  the first element that is
       greater than key.
	  3,4) Returns an iterator pointing to the first element that compares
       greater to the
	  value	x. This	overload participates in overload resolution  only  if
       the qualified-id
	  Compare::is_transparent is valid and denotes a type. It allows call-
       ing this	function
	  without constructing an instance of Key.

Parameters
	  key -	key value to compare the elements to
	  x   -	alternative value that can be compared to Key

Return value
	  Iterator  pointing to	the first element that is greater than key. If
       no such element
	  is found, past-the-end (see end()) iterator is returned.

Complexity
	  Logarithmic in the size of the container.

Notes
	  Feature-test macro: __cpp_lib_generic_associative_lookup (for	 over-
       loads (3,4))

Example
	   This	section	is incomplete
	   Reason: no example

See also
	  equal_range returns range of elements	matching a specific key
		      (public member function)
	  lower_bound  returns	an iterator to the first element not less than
       the given key
		      (public member function)

http://cppreference.com		  2022.07.31	      std::set::upper_bound(3)

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

home | help