CARVIEW |
Select Language
HTTP/1.1 301 Moved Permanently
Server: nginx
Date: Sat, 19 Jul 2025 15:30:44 GMT
Content-Type: text/html; charset=UTF-8
Transfer-Encoding: chunked
Connection: keep-alive
Location: /reference/unordered_map/unordered_map/cbegin/
HTTP/1.1 200 OK
Server: nginx
Date: Sat, 19 Jul 2025 15:30:44 GMT
Content-Type: text/html; charset=utf-8
Transfer-Encoding: chunked
Connection: keep-alive
ETag: W/"8d61-7Od7Ni8bVomX+AIHCQ3owAzXDag"
Content-Encoding: gzip
Returns a const_iterator pointing to the first element in the unordered_map container (1) or in one of its buckets (2).
A const_iterator is an iterator that points to const content. This iterator can be increased and decreased (unless it is itself also const), just like the iterator returned by unordered_map::begin, but it cannot be used to modify the contents it points to.
Both const_iterator and const_local_iterator are member types. In the unordered_map class template, these are forward iterator types.
const_local_iterator is an interator of the same category as const_iterator. Their value_type, difference_type, pointer and reference member types are also the same. But the iterators themselves are not necessarily of the same type.
Possible output:
Reference
C library:
- <cassert> (assert.h)
- <cctype> (ctype.h)
- <cerrno> (errno.h)
-
<cfenv> (fenv.h)C++11
- <cfloat> (float.h)
-
<cinttypes> (inttypes.h)C++11
- <ciso646> (iso646.h)
- <climits> (limits.h)
- <clocale> (locale.h)
- <cmath> (math.h)
- <csetjmp> (setjmp.h)
- <csignal> (signal.h)
- <cstdarg> (stdarg.h)
-
<cstdbool> (stdbool.h)C++11
- <cstddef> (stddef.h)
-
<cstdint> (stdint.h)C++11
- <cstdio> (stdio.h)
- <cstdlib> (stdlib.h)
- <cstring> (string.h)
-
<ctgmath> (tgmath.h)C++11
- <ctime> (time.h)
-
<cuchar> (uchar.h)C++11
- <cwchar> (wchar.h)
- <cwctype> (wctype.h)
Containers:
-
<array>C++11
- <deque>
-
<forward_list>C++11
- <list>
- <map>
- <queue>
- <set>
- <stack>
-
<unordered_map>C++11
-
<unordered_set>C++11
- <vector>
-
Input/Output:
Multi-threading:
-
<atomic>C++11
-
<condition_variable>C++11
-
<future>C++11
-
<mutex>C++11
-
<thread>C++11
-
Other:
- <algorithm>
- <bitset>
-
<chrono>C++11
-
<codecvt>C++11
- <complex>
- <exception>
- <functional>
-
<initializer_list>C++11
- <iterator>
- <limits>
- <locale>
- <memory>
- <new>
- <numeric>
-
<random>C++11
-
<ratio>C++11
-
<regex>C++11
- <stdexcept>
- <string>
-
<system_error>C++11
-
<tuple>C++11
-
<type_traits>C++11
-
<typeindex>C++11
- <typeinfo>
- <utility>
- <valarray>
<unordered_map>
-
unordered_mapC++11
-
unordered_multimapC++11
unordered_map
-
unordered_map::~unordered_mapC++11
-
unordered_map::unordered_mapC++11
member functions
-
unordered_map::atC++11
-
unordered_map::beginC++11
-
unordered_map::bucketC++11
-
unordered_map::bucket_countC++11
-
unordered_map::bucket_sizeC++11
-
unordered_map::cbeginC++11
-
unordered_map::cendC++11
-
unordered_map::clearC++11
-
unordered_map::countC++11
-
unordered_map::emplaceC++11
-
unordered_map::emplace_hintC++11
-
unordered_map::emptyC++11
-
unordered_map::endC++11
-
unordered_map::equal_rangeC++11
-
unordered_map::eraseC++11
-
unordered_map::findC++11
-
unordered_map::get_allocatorC++11
-
unordered_map::hash_functionC++11
-
unordered_map::insertC++11
-
unordered_map::key_eqC++11
-
unordered_map::load_factorC++11
-
unordered_map::max_bucket_countC++11
-
unordered_map::max_load_factorC++11
-
unordered_map::max_sizeC++11
-
unordered_map::operator[]C++11
-
unordered_map::operator=C++11
-
unordered_map::rehashC++11
-
unordered_map::reserveC++11
-
unordered_map::sizeC++11
-
unordered_map::swapC++11
-
non-member overloads
-
operators (unordered_map)C++11
-
swap (unordered_map)C++11
-
public member function
<unordered_map>
std::unordered_map::cbegin
container iterator (1) | const_iterator cbegin() const noexcept; |
---|---|
bucket iterator (2) | const_local_iterator cbegin ( size_type n ) const; |
Return const_iterator to beginning
A const_iterator is an iterator that points to const content. This iterator can be increased and decreased (unless it is itself also const), just like the iterator returned by unordered_map::begin, but it cannot be used to modify the contents it points to.
Parameters
- n
- Bucket number. This shall be lower than bucket_count.
It is an optional parameter that changes the behavior of this member function: if set, the iterator retrieved points to the first element of a bucket, otherwise it points to the first element of the container.
Member type size_type is an unsigned integral type.
Return Value
A const_iterator to the first element in the container (1) or the bucket (2).Both const_iterator and const_local_iterator are member types. In the unordered_map class template, these are forward iterator types.
const_local_iterator is an interator of the same category as const_iterator. Their value_type, difference_type, pointer and reference member types are also the same. But the iterators themselves are not necessarily of the same type.
Example
|
|
Possible output:
mymap contains: France:Paris Australia:Canberra U.S.:Washington mymap's buckets contain: bucket #0 contains: bucket #1 contains: bucket #2 contains: bucket #3 contains: bucket #4 contains: bucket #5 contains: France:Paris bucket #6 contains: bucket #7 contains: Australia:Canberra bucket #8 contains: U.S.:Washington bucket #9 contains: bucket #10 contains: |
Complexity
Constant.Iterator validity
No changes.See also
- unordered_map::end
- Return iterator to end (public member function)
- unordered_map::cbegin
- Return const_iterator to beginning (public member function)
- unordered_map::operator[]
- Access element (public member function)
Home page | Privacy policy
© cplusplus.com, 2000-2025 - All rights reserved - v3.3.4s
Spotted an error? contact us
© cplusplus.com, 2000-2025 - All rights reserved - v3.3.4s
Spotted an error? contact us