#include <stl_multiset.h>
Inheritance diagram for std::multiset< Key, Compare, Alloc >:
pair< iterator, iterator > | equal_range (const key_type &x) |
Finds a subsequence matching given key. | |
pair< const_iterator, const_iterator > | equal_range (const key_type &x) const |
Finds a subsequence matching given key. | |
template<class K1, class C1, class A1> | |
bool | operator== (const multiset< K1, C1, A1 > &, const multiset< K1, C1, A1 > &) |
Finds a subsequence matching given key. | |
template<class K1, class C1, class A1> | |
bool | operator< (const multiset< K1, C1, A1 > &, const multiset< K1, C1, A1 > &) |
Finds a subsequence matching given key. | |
Public Types | |
typedef Key | key_type |
typedef Key | value_type |
typedef Compare | key_compare |
typedef Compare | value_compare |
typedef Alloc::pointer | pointer |
typedef Alloc::const_pointer | const_pointer |
typedef Alloc::reference | reference |
typedef Alloc::const_reference | const_reference |
typedef Rep_type::const_iterator | iterator |
typedef Rep_type::const_iterator | const_iterator |
typedef Rep_type::const_reverse_iterator | reverse_iterator |
typedef Rep_type::const_reverse_iterator | const_reverse_iterator |
typedef Rep_type::size_type | size_type |
typedef Rep_type::difference_type | difference_type |
typedef Rep_type::allocator_type | allocator_type |
Public Member Functions | |
multiset () | |
Default constructor creates no elements. | |
multiset (const Compare &comp, const allocator_type &a=allocator_type()) | |
template<class InputIterator> | |
multiset (InputIterator first, InputIterator last) | |
Builds a multiset from a range. | |
template<class InputIterator> | |
multiset (InputIterator first, InputIterator last, const Compare &comp, const allocator_type &a=allocator_type()) | |
Builds a multiset from a range. | |
multiset (const multiset< Key, Compare, Alloc > &x) | |
Multiset copy constructor. | |
multiset< Key, Compare, Alloc > & | operator= (const multiset< Key, Compare, Alloc > &x) |
Multiset assignment operator. | |
key_compare | key_comp () const |
Returns the comparison object. | |
value_compare | value_comp () const |
Returns the comparison object. | |
allocator_type | get_allocator () const |
Returns the memory allocation object. | |
iterator | begin () const |
iterator | end () const |
reverse_iterator | rbegin () const |
reverse_iterator | rend () const |
bool | empty () const |
Returns true if the set is empty. | |
size_type | size () const |
Returns the size of the set. | |
size_type | max_size () const |
Returns the maximum size of the set. | |
void | swap (multiset< Key, Compare, Alloc > &x) |
Swaps data with another multiset. | |
iterator | insert (const value_type &x) |
Inserts an element into the multiset. | |
iterator | insert (iterator position, const value_type &x) |
Inserts an element into the multiset. | |
template<class InputIterator> | |
void | insert (InputIterator first, InputIterator last) |
A template function that attemps to insert a range of elements. | |
void | erase (iterator position) |
Erases an element from a multiset. | |
size_type | erase (const key_type &x) |
Erases elements according to the provided key. | |
void | erase (iterator first, iterator last) |
Erases a [first,last) range of elements from a multiset. | |
void | clear () |
size_type | count (const key_type &x) const |
Finds the number of elements with given key. | |
iterator | find (const key_type &x) |
Tries to locate an element in a set. | |
const_iterator | find (const key_type &x) const |
Tries to locate an element in a set. | |
iterator | lower_bound (const key_type &x) |
Finds the beginning of a subsequence matching given key. | |
const_iterator | lower_bound (const key_type &x) const |
Finds the beginning of a subsequence matching given key. | |
iterator | upper_bound (const key_type &x) |
Finds the end of a subsequence matching given key. | |
const_iterator | upper_bound (const key_type &x) const |
Finds the end of a subsequence matching given key. | |
Private Types | |
typedef Rb_tree< key_type, value_type, Identity< value_type >, key_compare, Alloc > | Rep_type |
Private Attributes | |
Rep_type | M_t |
Meets the requirements of a container, a reversible container, and an associative container (using equivalent keys). For a multiset<Key>
the key_type and value_type are Key.
Multisets support bidirectional iterators.
Definition at line 105 of file stl_multiset.h.
std::multiset< Key, Compare, Alloc >::multiset | ( | ) | [inline] |
std::multiset< Key, Compare, Alloc >::multiset | ( | InputIterator | first, | |
InputIterator | last | |||
) | [inline] |
Builds a multiset from a range.
first | An input iterator. | |
last | An input iterator. |
Definition at line 165 of file stl_multiset.h.
std::multiset< Key, Compare, Alloc >::multiset | ( | InputIterator | first, | |
InputIterator | last, | |||
const Compare & | comp, | |||
const allocator_type & | a = allocator_type() | |||
) | [inline] |
Builds a multiset from a range.
first | An input iterator. | |
last | An input iterator. | |
comp | A comparison functor. | |
a | An allocator object. |
Definition at line 181 of file stl_multiset.h.
std::multiset< Key, Compare, Alloc >::multiset | ( | const multiset< Key, Compare, Alloc > & | x | ) | [inline] |
Multiset copy constructor.
x | A multiset of identical element and allocator types. |
Reimplemented in __gnu_debug_def::multiset< Key, Compare, Allocator >.
Definition at line 194 of file stl_multiset.h.
iterator std::multiset< Key, Compare, Alloc >::begin | ( | ) | const [inline] |
Returns a read/write iterator that points to the first element in the multiset. Iteration is done in ascending order according to the keys.
Reimplemented in __gnu_debug_def::multiset< Key, Compare, Allocator >.
Definition at line 232 of file stl_multiset.h.
void std::multiset< Key, Compare, Alloc >::clear | ( | ) | [inline] |
Erases all elements in a multiset. Note that this function only erases the elements, and that if the elements themselves are pointers, the pointed-to memory is not touched in any way. Managing the pointer is the user's responsibilty.
Reimplemented in __gnu_debug_def::multiset< Key, Compare, Allocator >.
Definition at line 405 of file stl_multiset.h.
size_type std::multiset< Key, Compare, Alloc >::count | ( | const key_type & | x | ) | const [inline] |
Finds the number of elements with given key.
x | Key of elements to be located. |
Definition at line 416 of file stl_multiset.h.
bool std::multiset< Key, Compare, Alloc >::empty | ( | ) | const [inline] |
iterator std::multiset< Key, Compare, Alloc >::end | ( | ) | const [inline] |
Returns a read/write iterator that points one past the last element in the multiset. Iteration is done in ascending order according to the keys.
Reimplemented in __gnu_debug_def::multiset< Key, Compare, Allocator >.
Definition at line 241 of file stl_multiset.h.
pair<const_iterator,const_iterator> std::multiset< Key, Compare, Alloc >::equal_range | ( | const key_type & | x | ) | const [inline] |
Finds a subsequence matching given key.
x | Key to be located. |
std::make_pair(c.lower_bound(val), c.upper_bound(val))
This function probably only makes sense for multisets.
Reimplemented in __gnu_debug_def::multiset< Key, Compare, Allocator >.
Definition at line 500 of file stl_multiset.h.
pair<iterator,iterator> std::multiset< Key, Compare, Alloc >::equal_range | ( | const key_type & | x | ) | [inline] |
Finds a subsequence matching given key.
x | Key to be located. |
std::make_pair(c.lower_bound(val), c.upper_bound(val))
This function probably only makes sense for multisets.
Reimplemented in __gnu_debug_def::multiset< Key, Compare, Allocator >.
Definition at line 496 of file stl_multiset.h.
void std::multiset< Key, Compare, Alloc >::erase | ( | iterator | first, | |
iterator | last | |||
) | [inline] |
Erases a [first,last) range of elements from a multiset.
first | Iterator pointing to the start of the range to be erased. | |
last | Iterator pointing to the end of the range to be erased. |
Definition at line 392 of file stl_multiset.h.
size_type std::multiset< Key, Compare, Alloc >::erase | ( | const key_type & | x | ) | [inline] |
Erases elements according to the provided key.
x | Key of element to be erased. |
Reimplemented in __gnu_debug_def::multiset< Key, Compare, Allocator >.
Definition at line 377 of file stl_multiset.h.
void std::multiset< Key, Compare, Alloc >::erase | ( | iterator | position | ) | [inline] |
Erases an element from a multiset.
position | An iterator pointing to the element to be erased. |
Definition at line 359 of file stl_multiset.h.
const_iterator std::multiset< Key, Compare, Alloc >::find | ( | const key_type & | x | ) | const [inline] |
Tries to locate an element in a set.
x | Element to be located. |
end()
) iterator.
Reimplemented in __gnu_debug_def::multiset< Key, Compare, Allocator >.
Definition at line 438 of file stl_multiset.h.
iterator std::multiset< Key, Compare, Alloc >::find | ( | const key_type & | x | ) | [inline] |
Tries to locate an element in a set.
x | Element to be located. |
end()
) iterator.
Reimplemented in __gnu_debug_def::multiset< Key, Compare, Allocator >.
Definition at line 434 of file stl_multiset.h.
allocator_type std::multiset< Key, Compare, Alloc >::get_allocator | ( | ) | const [inline] |
void std::multiset< Key, Compare, Alloc >::insert | ( | InputIterator | first, | |
InputIterator | last | |||
) | [inline] |
A template function that attemps to insert a range of elements.
first | Iterator pointing to the start of the range to be inserted. | |
last | Iterator pointing to the end of the range. |
Reimplemented in __gnu_debug_def::multiset< Key, Compare, Allocator >.
Definition at line 345 of file stl_multiset.h.
iterator std::multiset< Key, Compare, Alloc >::insert | ( | iterator | position, | |
const value_type & | x | |||
) | [inline] |
Inserts an element into the multiset.
position | An iterator that serves as a hint as to where the element should be inserted. | |
x | Element to be inserted. |
Note that the first parameter is only a hint and can potentially improve the performance of the insertion process. A bad hint would cause no gains in efficiency.
See http://gcc.gnu.org/onlinedocs/libstdc++/23_containers/howto.html#4 for more on "hinting".
Insertion requires logarithmic time (if the hint is not taken).
Definition at line 329 of file stl_multiset.h.
iterator std::multiset< Key, Compare, Alloc >::insert | ( | const value_type & | x | ) | [inline] |
Inserts an element into the multiset.
x | Element to be inserted. |
Insertion requires logarithmic time.
Reimplemented in __gnu_debug_def::multiset< Key, Compare, Allocator >.
Definition at line 305 of file stl_multiset.h.
key_compare std::multiset< Key, Compare, Alloc >::key_comp | ( | ) | const [inline] |
Returns the comparison object.
Definition at line 215 of file stl_multiset.h.
Referenced by std::multiset< Key, Compare, Allocator >::key_comp().
const_iterator std::multiset< Key, Compare, Alloc >::lower_bound | ( | const key_type & | x | ) | const [inline] |
Finds the beginning of a subsequence matching given key.
x | Key to be located. |
Reimplemented in __gnu_debug_def::multiset< Key, Compare, Allocator >.
Definition at line 459 of file stl_multiset.h.
iterator std::multiset< Key, Compare, Alloc >::lower_bound | ( | const key_type & | x | ) | [inline] |
Finds the beginning of a subsequence matching given key.
x | Key to be located. |
Reimplemented in __gnu_debug_def::multiset< Key, Compare, Allocator >.
Definition at line 455 of file stl_multiset.h.
size_type std::multiset< Key, Compare, Alloc >::max_size | ( | ) | const [inline] |
multiset<Key,Compare,Alloc>& std::multiset< Key, Compare, Alloc >::operator= | ( | const multiset< Key, Compare, Alloc > & | x | ) | [inline] |
Multiset assignment operator.
x | A multiset of identical element and allocator types. |
Definition at line 205 of file stl_multiset.h.
reverse_iterator std::multiset< Key, Compare, Alloc >::rbegin | ( | ) | const [inline] |
Returns a read/write reverse iterator that points to the last element in the multiset. Iteration is done in descending order according to the keys.
Reimplemented in __gnu_debug_def::multiset< Key, Compare, Allocator >.
Definition at line 250 of file stl_multiset.h.
reverse_iterator std::multiset< Key, Compare, Alloc >::rend | ( | ) | const [inline] |
Returns a read/write reverse iterator that points to the last element in the multiset. Iteration is done in descending order according to the keys.
Reimplemented in __gnu_debug_def::multiset< Key, Compare, Allocator >.
Definition at line 259 of file stl_multiset.h.
size_type std::multiset< Key, Compare, Alloc >::size | ( | ) | const [inline] |
void std::multiset< Key, Compare, Alloc >::swap | ( | multiset< Key, Compare, Alloc > & | x | ) | [inline] |
Swaps data with another multiset.
x | A multiset of the same element and allocator types. |
Compare
type (which itself is often stateless and empty), so it should be quite fast.) Note that the global std::swap() function is specialized such that std::swap(s1,s2) will feed to this function.
Definition at line 289 of file stl_multiset.h.
Referenced by std::swap().
const_iterator std::multiset< Key, Compare, Alloc >::upper_bound | ( | const key_type & | x | ) | const [inline] |
Finds the end of a subsequence matching given key.
x | Key to be located. |
Reimplemented in __gnu_debug_def::multiset< Key, Compare, Allocator >.
Definition at line 475 of file stl_multiset.h.
iterator std::multiset< Key, Compare, Alloc >::upper_bound | ( | const key_type & | x | ) | [inline] |
Finds the end of a subsequence matching given key.
x | Key to be located. |
Reimplemented in __gnu_debug_def::multiset< Key, Compare, Allocator >.
Definition at line 471 of file stl_multiset.h.
value_compare std::multiset< Key, Compare, Alloc >::value_comp | ( | ) | const [inline] |
bool operator< | ( | const multiset< K1, C1, A1 > & | , | |
const multiset< K1, C1, A1 > & | ||||
) | [friend] |
Finds a subsequence matching given key.
x | Key to be located. |
std::make_pair(c.lower_bound(val), c.upper_bound(val))
This function probably only makes sense for multisets.
bool operator== | ( | const multiset< K1, C1, A1 > & | , | |
const multiset< K1, C1, A1 > & | ||||
) | [friend] |
Finds a subsequence matching given key.
x | Key to be located. |
std::make_pair(c.lower_bound(val), c.upper_bound(val))
This function probably only makes sense for multisets.