std::multiset<Key,Compare,Allocator>::upper_bound
From cppreference.com
| iterator upper_bound( const Key& key ); |
(1) | |
| const_iterator upper_bound( const Key& key ) const; |
(2) | |
template< class K > iterator upper_bound( const K& x ); |
(3) | (C++14以降) |
| template< class K > const_iterator upper_bound( const K& x ) const; |
(4) | (C++14以降) |
1,2) key よりも *大きい* 最初の要素を指すイテレータを返します。
3,4) 値 x と *比較して大きい* 最初の要素を指すイテレータを返します。このオーバーロードは、修飾子 Compare::is_transparent が有効で、型を参照している場合にのみオーバーロード解決に参加します。これにより、
Key のインスタンスを構築せずにこの関数を呼び出すことができます。目次 |
[編集] パラメータ
| key | - | 比較対象の値 |
| x | - | Key と比較可能な代替値 |
[編集] 戻り値
key よりも *大きい* 最初の要素を指すイテレータ。そのような要素が見つからない場合は、末尾を過ぎたイテレータ (end() を参照) が返されます。
[編集] 計算量
コンテナのサイズに対して対数時間。
注釈
| 機能テストマクロ | 値 | 規格 | 機能 |
|---|---|---|---|
__cpp_lib_generic_associative_lookup |
201304L |
(C++14) | 連想コンテナでの異種比較検索(オーバーロード (3,4)) |
[編集] 例
| このセクションは未完成です 理由: 例がありません |
[編集] 関連項目
| 特定のキーに一致する要素の範囲を返す (公開メンバ関数) | |
| 指定されたキーより小さくない最初の要素へのイテレータを返す (公開メンバ関数) |