lower_bound

命令の条件にバイナリ述語によって指定される可能性がある値により大きい値が等価か、順序が指定された範囲の先頭の要素の位置を検索します。

template<class ForwardIterator, class Type>
   ForwardIterator lower_bound(
      ForwardIterator _First, 
      ForwardIterator _Last,
      const Type& _Val
   );
template<class ForwardIterator, class Type, class BinaryPredicate>
   ForwardIterator lower_bound(
      ForwardIterator _First, 
      ForwardIterator _Last,
      const Type& _Val,
      BinaryPredicate _Comp
   );

パラメーター

  • _First
    検索する範囲内の先頭の要素の位置を示す前方反復子。

  • _Last
    検索する範囲の最後の要素の一つ前の位置 1 に対処前方反復子。

  • _Val
    最初の位置や可能な最初の位置、順序付けされた範囲内で検索する値。

  • _Comp
    要素が別の値より小さいかを意味を定義するユーザー定義の述語関数オブジェクト。バイナリ述語が満たされなかった場合に完了したら 2 個の引数を受け取り、truefalse を返します。

戻り値

等価性がバイナリ述語で指定された、指定の値によりも大きいか、同じ値を持つ順序付けられた範囲の先頭の要素の位置の前方反復子。

解説

参照される分類されたソース範囲内で有効である必要があります; すべての反復子 dereferenceable は、シーケンス内で最後の位置は incrementation によって最初から到達できる必要があります。

並べ替えられたスコープは、命令がバイナリ述語で指定されたと同じであるに lower_bound の使用の事前条件です。

スコープは lower_boundアルゴリズムによって変更されません。

前方反復子の値型、またはそのほか未満であること (という意味でいずれも他より小さくない) 等しいことが、2 個の要素は、いずれかの決定される命令に対応する小さいある必要があります。これは、不一致要素間の順序で発生します

アルゴリズムの複雑性はランダム アクセス反復子用に、対数に比例した手順の数と、線形場合 (_Last1 – _First1)。

使用例

// alg_lower_bound.cpp
// compile with: /EHsc
#include <vector>
#include <algorithm>
#include <functional>      // For greater<int>( )
#include <iostream>

// Return whether modulus of elem1 is less than modulus of elem2
bool mod_lesser ( int elem1, int elem2 )
{
   if ( elem1 < 0 )
      elem1 = - elem1;
   if ( elem2 < 0 )
      elem2 = - elem2;
   return elem1 < elem2;
}

int main( )
{
   using namespace std;
   vector <int> v1;
   vector <int>::iterator Iter1, Result1;

   // Constructing vectors v1a & v1b with default less than ordering
   int i;
   for ( i = -1 ; i <= 4 ; i++ )
   {
      v1.push_back(  i );
   }

   int ii;
   for ( ii =-3 ; ii <= 0 ; ii++ )
   {
      v1.push_back(  ii  );
   }

   sort ( v1.begin ( ) , v1.end ( ) );
   cout << "Original vector v1 with range sorted by the\n "
        << "binary predicate less than is  v1 = ( " ;
   for ( Iter1 = v1.begin( ) ; Iter1 != v1.end( ) ; Iter1++ )
      cout << *Iter1 << " ";
   cout << ")." << endl;

   // Constructing vectors v2 with range sorted by greater
   vector <int> v2 ( v1 );
   vector <int>::iterator Iter2, Result2;
   sort ( v2.begin ( ) , v2.end ( ) , greater<int> ( ) );

   cout << "Original vector v2 with range sorted by the\n "
        << "binary predicate greater is    v2 = ( " ;
   for ( Iter2 = v2.begin ( ) ; Iter2 != v2.end ( ) ; Iter2++ )
      cout << *Iter2 << " ";
   cout << ")." << endl;

   // Constructing vectors v3 with range sorted by mod_lesser
   vector <int> v3 ( v1 );
   vector <int>::iterator Iter3, Result3;
   sort ( v3.begin ( ) , v3.end ( ) , mod_lesser );

   cout << "Original vector v3 with range sorted by the\n "
        <<  "binary predicate mod_lesser is v3 = ( " ;
   for ( Iter3 = v3.begin ( ) ; Iter3 != v3.end ( ) ; Iter3++ )
      cout << *Iter3 << " ";
   cout << ")." << endl;

   // lower_bound of 3 in v1 with default binary predicate less <int> ( )
   Result1 = lower_bound ( v1.begin ( ) , v1.end ( ) , 3 );
   cout << "The lower_bound in v2 for the element with a value of 3 is: "
        << *Result1 << "." << endl;

   // lower_bound of 3 in v2 with the binary predicate greater <int> ( )
   Result2 = lower_bound ( v2.begin ( ) , v2.end ( ) , 3, greater <int> ( ) );
   cout << "The lower_bound in v2 for the element with a value of 3 is: "
        << *Result2 << "." << endl;

   // lower_bound of 3 in v3 with the binary predicate  mod_lesser
   Result3 = lower_bound ( v3.begin ( ) , v3.end ( ) , 3,  mod_lesser  );
   cout << "The lower_bound in v3 for the element with a value of 3 is: "
        << *Result3 << "." << endl;
}
  
  
  
  
  
  

必要条件

ヘッダー: <algorithm>

名前空間: std

参照

関連項目

lower_bound (STL Samples)

Predicate Version of lower_bound

標準テンプレート ライブラリ