Difference between revisions of "cpp/container/unordered set"
From cppreference.com
m (Shorten template names. Use {{lc}} where appropriate.) |
m (Update links.) |
||
Line 17: | Line 17: | ||
{{dsc begin}} | {{dsc begin}} | ||
{{dsc hitem | Member type | Definition}} | {{dsc hitem | Member type | Definition}} | ||
− | {{dsc inc | cpp/container/ | + | {{dsc inc | cpp/container/dsc key_type | unordered_set}} |
− | {{dsc inc | cpp/container/ | + | {{dsc inc | cpp/container/dsc value_type | unordered_set}} |
− | {{dsc inc | cpp/container/ | + | {{dsc inc | cpp/container/dsc size_type | unordered_set}} |
− | {{dsc inc | cpp/container/ | + | {{dsc inc | cpp/container/dsc difference_type | unordered_set}} |
− | {{dsc inc | cpp/container/ | + | {{dsc inc | cpp/container/dsc hasher | unordered_set}} |
− | {{dsc inc | cpp/container/ | + | {{dsc inc | cpp/container/dsc key_equal | unordered_set}} |
− | {{dsc inc | cpp/container/ | + | {{dsc inc | cpp/container/dsc allocator_type | unordered_set}} |
− | {{dsc inc | cpp/container/ | + | {{dsc inc | cpp/container/dsc reference | unordered_set}} |
− | {{dsc inc | cpp/container/ | + | {{dsc inc | cpp/container/dsc const_reference | unordered_set}} |
− | {{dsc inc | cpp/container/ | + | {{dsc inc | cpp/container/dsc pointer | unordered_set}} |
− | {{dsc inc | cpp/container/ | + | {{dsc inc | cpp/container/dsc const_pointer | unordered_set}} |
− | {{dsc inc | cpp/container/ | + | {{dsc inc | cpp/container/dsc iterator | unordered_set}} |
− | {{dsc inc | cpp/container/ | + | {{dsc inc | cpp/container/dsc const_iterator | unordered_set}} |
− | {{dsc inc | cpp/container/ | + | {{dsc inc | cpp/container/dsc local_iterator | unordered_set}} |
− | {{dsc inc | cpp/container/ | + | {{dsc inc | cpp/container/dsc const_local_iterator | unordered_set}} |
{{dsc end}} | {{dsc end}} | ||
Line 38: | Line 38: | ||
===Member functions=== | ===Member functions=== | ||
{{dsc begin}} | {{dsc begin}} | ||
− | {{dsc inc | cpp/container/ | + | {{dsc inc | cpp/container/dsc constructor | unordered_set}} |
− | {{dsc inc | cpp/container/ | + | {{dsc inc | cpp/container/dsc destructor | unordered_set}} |
− | {{dsc inc | cpp/container/ | + | {{dsc inc | cpp/container/dsc operator{{=}} | unordered_set}} |
− | {{dsc inc | cpp/container/ | + | {{dsc inc | cpp/container/dsc get_allocator | unordered_set}} |
{{dsc h2 | Iterators}} | {{dsc h2 | Iterators}} | ||
− | {{dsc inc | cpp/container/ | + | {{dsc inc | cpp/container/dsc begin | unordered_set}} |
− | {{dsc inc | cpp/container/ | + | {{dsc inc | cpp/container/dsc end | unordered_set}} |
{{dsc h2 | Capacity}} | {{dsc h2 | Capacity}} | ||
− | {{dsc inc | cpp/container/ | + | {{dsc inc | cpp/container/dsc empty | unordered_set}} |
− | {{dsc inc | cpp/container/ | + | {{dsc inc | cpp/container/dsc size | unordered_set}} |
− | {{dsc inc | cpp/container/ | + | {{dsc inc | cpp/container/dsc max_size | unordered_set}} |
{{dsc h2 | Modifiers}} | {{dsc h2 | Modifiers}} | ||
− | {{dsc inc | cpp/container/ | + | {{dsc inc | cpp/container/dsc clear | unordered_set}} |
− | {{dsc inc | cpp/container/ | + | {{dsc inc | cpp/container/dsc insert | unordered_set}} |
− | {{dsc inc | cpp/container/ | + | {{dsc inc | cpp/container/dsc emplace | unordered_set}} |
− | {{dsc inc | cpp/container/ | + | {{dsc inc | cpp/container/dsc emplace_hint | unordered_set}} |
− | {{dsc inc | cpp/container/ | + | {{dsc inc | cpp/container/dsc erase | unordered_set}} |
− | {{dsc inc | cpp/container/ | + | {{dsc inc | cpp/container/dsc swap | unordered_set}} |
{{dsc h2 | Lookup}} | {{dsc h2 | Lookup}} | ||
− | {{dsc inc | cpp/container/ | + | {{dsc inc | cpp/container/dsc count | unordered_set}} |
− | {{dsc inc | cpp/container/ | + | {{dsc inc | cpp/container/dsc find | unordered_set}} |
− | {{dsc inc | cpp/container/ | + | {{dsc inc | cpp/container/dsc equal_range | unordered_set}} |
{{dsc h2 | Bucket interface}} | {{dsc h2 | Bucket interface}} | ||
− | {{dsc inc | cpp/container/ | + | {{dsc inc | cpp/container/dsc begin(int) | unordered_set}} |
− | {{dsc inc | cpp/container/ | + | {{dsc inc | cpp/container/dsc end(int) | unordered_set}} |
− | {{dsc inc | cpp/container/ | + | {{dsc inc | cpp/container/dsc bucket_count | unordered_set}} |
− | {{dsc inc | cpp/container/ | + | {{dsc inc | cpp/container/dsc max_bucket_count | unordered_set}} |
− | {{dsc inc | cpp/container/ | + | {{dsc inc | cpp/container/dsc bucket_size | unordered_set}} |
− | {{dsc inc | cpp/container/ | + | {{dsc inc | cpp/container/dsc bucket | unordered_set}} |
{{dsc h2 | Hash policy}} | {{dsc h2 | Hash policy}} | ||
− | {{dsc inc | cpp/container/ | + | {{dsc inc | cpp/container/dsc load_factor | unordered_set}} |
− | {{dsc inc | cpp/container/ | + | {{dsc inc | cpp/container/dsc max_load_factor | unordered_set}} |
− | {{dsc inc | cpp/container/ | + | {{dsc inc | cpp/container/dsc rehash | unordered_set}} |
− | {{dsc inc | cpp/container/ | + | {{dsc inc | cpp/container/dsc reserve | unordered_set}} |
{{dsc h2 | Observers}} | {{dsc h2 | Observers}} | ||
− | {{dsc inc | cpp/container/ | + | {{dsc inc | cpp/container/dsc hash_function | unordered_set}} |
− | {{dsc inc | cpp/container/ | + | {{dsc inc | cpp/container/dsc key_eq | unordered_set}} |
{{dsc end}} | {{dsc end}} | ||
===Non-member functions=== | ===Non-member functions=== | ||
{{dsc begin}} | {{dsc begin}} | ||
− | {{dsc inc | cpp/container/ | + | {{dsc inc | cpp/container/dsc operator_cmp_unord | unordered_set}} |
− | {{dsc inc | cpp/container/ | + | {{dsc inc | cpp/container/dsc swap2 | unordered_set}} |
{{dsc end}} | {{dsc end}} | ||
Revision as of 21:51, 31 May 2013
Defined in header <unordered_set>
|
||
template< class Key, |
(since C++11) | |
Unordered set is an associative container that contains set of unique objects of type Key. Search, insertion, and removal have average constant-time complexity.
std::unordered_set
meets the requirements of Template:concept, Template:concept, Template:concept.
Contents |
Member types
Member type | Definition |
key_type
|
Key
|
value_type
|
Key
|
size_type
|
Unsigned integer type (usually std::size_t) |
difference_type
|
Signed integer type (usually std::ptrdiff_t) |
hasher
|
Hash
|
key_equal
|
KeyEqual
|
allocator_type
|
Allocator
|
reference
|
value_type& |
const_reference
|
const value_type& |
pointer
|
std::allocator_traits<Allocator>::pointer |
const_pointer
|
std::allocator_traits<Allocator>::const_pointer |
iterator
|
Constant LegacyForwardIterator to value_type
|
const_iterator
|
LegacyForwardIterator to const value_type |
local_iterator
|
An iterator type whose category, value, difference, pointer and reference types are the same as iterator . This iteratorcan be used to iterate through a single bucket but not across buckets |
const_local_iterator
|
An iterator type whose category, value, difference, pointer and reference types are the same as const_iterator . This iteratorcan be used to iterate through a single bucket but not across buckets |
Member functions
constructs the unordered_set (public member function) | |
destructs the unordered_set (public member function) | |
assigns values to the container (public member function) | |
returns the associated allocator (public member function) | |
Iterators | |
returns an iterator to the beginning (public member function) | |
returns an iterator to the end (public member function) | |
Capacity | |
checks whether the container is empty (public member function) | |
returns the number of elements (public member function) | |
returns the maximum possible number of elements (public member function) | |
Modifiers | |
clears the contents (public member function) | |
inserts elements or nodes(since C++17) (public member function) | |
constructs element in-place (public member function) | |
constructs elements in-place using a hint (public member function) | |
erases elements (public member function) | |
swaps the contents (public member function) | |
Lookup | |
returns the number of elements matching specific key (public member function) | |
finds element with specific key (public member function) | |
returns range of elements matching a specific key (public member function) | |
Bucket interface | |
returns an iterator to the beginning of the specified bucket (public member function) | |
returns an iterator to the end of the specified bucket (public member function) | |
returns the number of buckets (public member function) | |
returns the maximum number of buckets (public member function) | |
returns the number of elements in specific bucket (public member function) | |
returns the bucket for specific key (public member function) | |
Hash policy | |
returns average number of elements per bucket (public member function) | |
manages maximum average number of elements per bucket (public member function) | |
reserves at least the specified number of buckets and regenerates the hash table (public member function) | |
reserves space for at least the specified number of elements and regenerates the hash table (public member function) | |
Observers | |
returns function used to hash the keys (public member function) | |
returns the function used to compare keys for equality (public member function) |
Non-member functions
(C++11)(C++11)(removed in C++20) |
compares the values in the unordered_set (function template) |
specializes the std::swap algorithm (function template) |
Notes
The member types iterator
and const_iterator
may be aliases to the same type. This means defining a pair of function overloads using the two types as parameter types may violate the One Definition Rule. Since iterator
is convertible to const_iterator
, a single function with a const_iterator
as parameter type will work instead.