multiset::equal_range (STL/CLR)
Finds range that matches a specified key.
cliext::pair<iterator, iterator> equal_range(key_type key);
Parameters
- key
Key value to search for.
Remarks
The member function returns a pair of iterators cliext::pair<iterator, iterator>( multiset::lower_bound (STL/CLR)(key), multiset::upper_bound (STL/CLR)(key)). You use it to determine the range of elements currently in the controlled sequence that match a specified key.
Example
// cliext_multiset_equal_range.cpp
// compile with: /clr
#include <cliext/set>
typedef cliext::multiset<wchar_t> Mymultiset;
typedef Mymultiset::pair_iter_iter Pairii;
int main()
{
Mymultiset c1;
c1.insert(L'a');
c1.insert(L'b');
c1.insert(L'c');
// display initial contents " a b c"
for each (wchar_t elem in c1)
System::Console::Write(" {0}", elem);
System::Console::WriteLine();
// display results of failed search
Pairii pair1 = c1.equal_range(L'x');
System::Console::WriteLine("equal_range(L'x') empty = {0}",
pair1.first == pair1.second);
// display results of successful search
pair1 = c1.equal_range(L'b');
for (; pair1.first != pair1.second; ++pair1.first)
System::Console::Write(" {0}", *pair1.first);
System::Console::WriteLine();
return (0);
}
a b c equal_range(L'x') empty = True b
Requirements
Header: <cliext/set>
Namespace: cliext