std::unordered_map<Key,T,Hash,KeyEqual,Allocator>:: bucket
From cppreference.net
<
cpp
|
container
|
unordered map
|
size_type bucket
(
const
Key
&
key
)
const
;
|
(1) | (C++11부터) |
|
template
<
typename
K
>
size_type bucket ( const K & x ) const ; |
(2) | (C++26부터) |
1)
키에 대한 버킷 인덱스를 반환합니다.
key
에 해당하는 키를 가진 요소(존재하는 경우)는 항상 이 버킷에서 발견됩니다.
2)
값
x
와 비교적
동등한(equivalent)
키에 대한 버킷 인덱스를 반환합니다.
x
와 비교적 동등한 키를 가진 요소(존재하는 경우)는 항상 이 버킷에서 발견됩니다. 이 오버로드는
Hash
와
KeyEqual
가 모두
투명(transparent)
인 경우에만 오버로드 해결에 참여합니다. 이는 해당
Hash
가
K
와
Key
타입 모두로 호출 가능하고,
KeyEqual
가 투명하다는 것을 가정하며, 이를 통해
Key
의 인스턴스를 생성하지 않고 이 함수를 호출할 수 있습니다.
반환된 값은 bucket_count() 가 동일한 값을 반환하는 컨테이너 인스턴스에 대해서만 유효합니다 (예: rehash() 는 이전에 획득한 값을 무효화합니다).
bucket_count() 가 0인 경우 동작은 정의되지 않습니다.
목차 |
매개변수
| key | - | 검사할 키의 값 |
| x | - | 키와 투명하게 비교될 수 있는 모든 타입의 값 |
반환값
요청된 키에 대한 버킷 인덱스입니다.
복잡도
상수.
참고 사항
| Feature-test 매크로 | 값 | 표준 | 기능 |
|---|---|---|---|
__cpp_lib_associative_heterogeneous_insertion
|
202311L
|
(C++26) | 정렬된 및 비정렬 연관 컨테이너 에서 남은 멤버 함수들에 대한 이종 오버로드. ( 2 ) |
예제
|
이 섹션은 불완전합니다
이유: 예제가 없음 |
참고 항목
|
특정 버킷의 요소 수를 반환합니다
(public member function) |