std::multimap lower_bound() 方法

自 C++14 起

// (1) Non const version
iterator lower_bound( const Key& key );

// (2) Const version
const_iterator lower_bound( const Key& key ) const;

// (3) Non const version
template< class K >
iterator lower_bound( const K& x );

// (4) Const version
template< class K >
const_iterator lower_bound( const K& x ) const;

C++98 起

// (1) Non const version
iterator lower_bound( const Key& key );

// (2) Const version
const_iterator lower_bound( const Key& key ) const;

• (1-2) 返回一个迭代器，指向第一个不小于（即大于或等于）key 的元素。
• (3,4) 返回一个迭代器，指向第一个与值 x 比较不小于（即大于或等于）的元素。此重载仅在 qualified-id Compare::is_transparent 有效且表示一个类型时才参与重载决议。它允许在不构造 Key 实例的情况下调用此函数。

参数

• key - 要计数的元素的键值
• x - 可以与键透明比较的任何类型的值

返回值

迭代器指向第一个不小于 key 的元素。如果没有找到这样的元素，则返回一个 past-the-end 迭代器（参见end()）。

复杂度

对容器大小呈对数关系 - O(log size())。

异常

(无)

备注

特性测试宏：__cpp_lib_generic_associative_lookup（用于重载 (3) 和 (4)）。