109 lines
2.7 KiB
ReStructuredText
109 lines
2.7 KiB
ReStructuredText
.. Algorithms/Querying Algorithms//upper_bound |70
|
|
|
|
upper_bound
|
|
===========
|
|
|
|
Synopsis
|
|
--------
|
|
|
|
.. parsed-literal::
|
|
|
|
template<
|
|
typename Sequence
|
|
, typename T
|
|
, typename Pred = less<_1,_2>
|
|
>
|
|
struct upper_bound
|
|
{
|
|
typedef |unspecified| type;
|
|
};
|
|
|
|
|
|
|
|
Description
|
|
-----------
|
|
|
|
Returns the last position in the sorted ``Sequence`` where ``T`` could be inserted without
|
|
violating the ordering.
|
|
|
|
|
|
Header
|
|
------
|
|
|
|
.. parsed-literal::
|
|
|
|
#include <boost/mpl/upper_bound.hpp>
|
|
|
|
|
|
|
|
Parameters
|
|
----------
|
|
|
|
+---------------+-------------------------------+-----------------------------------+
|
|
| Parameter | Requirement | Description |
|
|
+===============+===============================+===================================+
|
|
|``Sequence`` | |Forward Sequence| | A sorted sequence to search in. |
|
|
+---------------+-------------------------------+-----------------------------------+
|
|
|``T`` | Any type | A type to search a position for. |
|
|
+---------------+-------------------------------+-----------------------------------+
|
|
|``Pred`` | Binary |Lambda Expression| | A search criteria. |
|
|
+---------------+-------------------------------+-----------------------------------+
|
|
|
|
|
|
Expression semantics
|
|
--------------------
|
|
|
|
For any sorted |Forward Sequence| ``s``, binary |Lambda Expression| ``pred``, and
|
|
arbitrary type ``x``:
|
|
|
|
|
|
.. parsed-literal::
|
|
|
|
typedef upper_bound< s,x,pred >::type i;
|
|
|
|
:Return type:
|
|
|Forward Iterator|
|
|
|
|
:Semantics:
|
|
``i`` is the furthermost iterator in |begin/end<s>| such that, for every iterator
|
|
``j`` in ``[begin<s>::type, i)``,
|
|
|
|
.. parsed-literal::
|
|
|
|
apply< pred, x, deref<j>::type >::type::value == false
|
|
|
|
|
|
Complexity
|
|
----------
|
|
|
|
The number of comparisons is logarithmic: at most log\ :sub:`2`\ ( ``size<s>::value`` ) + 1.
|
|
If ``s`` is a |Random Access Sequence| then the number of steps through the range
|
|
is also logarithmic; otherwise, the number of steps is proportional to
|
|
``size<s>::value``.
|
|
|
|
|
|
Example
|
|
-------
|
|
|
|
.. parsed-literal::
|
|
|
|
typedef vector_c<int,1,2,3,3,3,5,8> numbers;
|
|
typedef upper_bound< numbers, int_<3> >::type iter;
|
|
|
|
BOOST_MPL_ASSERT_RELATION(
|
|
(distance< begin<numbers>::type,iter >::value), ==, 5
|
|
);
|
|
|
|
BOOST_MPL_ASSERT_RELATION( deref<iter>::type::value, ==, 5 );
|
|
|
|
|
|
See also
|
|
--------
|
|
|
|
|Querying Algorithms|, |lower_bound|, |find|, |find_if|, |min_element|
|
|
|
|
|
|
.. copyright:: Copyright © 2001-2009 Aleksey Gurtovoy and David Abrahams
|
|
Distributed under the Boost Software License, Version 1.0. (See accompanying
|
|
file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
|