建議使用 Visual Studio 2017

concurrent_unordered_multimap 類別

 

如需 Visual Studio 2017 的最新文件請參閱 Visual Studio 2017 文件

concurrent_unordered_multimap 類別是一種並行安全容器,可控制 std::pair<const K, _Element_type> 類型項目的不同長度序列。 序列的表示方式導致啟用並行安全附加、項目存取、迭代器存取及迭代器周遊作業。

template <typename K,
    typename _Element_type,
    typename _Hasher = std::tr1::hash<K>,
    typename key_equality = std::equal_to<K>,
    typename _Allocator_type = std::allocator<std::pair<const K,
    _Element_type>>
>,
 typename key_equality = std::equal_to<K>,
    typename _Allocator_type = std::allocator<std::pair<const K,
    _Element_type>>> class concurrent_unordered_multimap : public details::_Concurrent_hash<details::_Concurrent_unordered_map_traits<K,
    _Element_type,
 details::_Hash_compare<K,
    _Hasher,
 key_equality>,
    _Allocator_type,
 true>>;

參數

K
索引鍵類型。

_Element_type
對應的類型。

_Hasher
雜湊函式物件類型。 這個引數是選擇性的,而且預設值是 std::tr1::hash<``K``>

key_equality
相等比較函式物件類型。 這個引數是選擇性的,而且預設值是 std::equal_to<``K``>

_Allocator_type
表示封裝有關配置和解除配置之記憶體的並行向量的詳細資訊的預存配置器物件的型別。 這個引數是選擇性的預設值是std::allocator<std::pair<``K_Element_type``>>

公用 Typedefs

名稱說明
allocator_type管理儲存體的配置器類型。
const_iterator用於受控制序列的常數迭代器類型。
const_local_iterator用於受控制序列的常數 Bucket 迭代器類型。
const_pointer項目的常數指標類型。
const_reference項目的常數參考類型。
difference_type兩個項目之間帶正負號距離的類型。
hasher雜湊函式的類型。
iterator受控制序列之迭代器的類型。
key_equal比較函式的類型。
key_type排序索引鍵的類型。
local_iterator用於受控制序列的 Bucket 迭代器類型。
mapped_type與每個索引鍵關聯的對應值類型。
pointer項目的指標類型。
reference項目的參考類型。
size_type兩個項目之間不帶正負號距離的類型。
value_type元素的類型。

公用建構函式

名稱說明
concurrent_unordered_multimap:: concurrent_unordered_multimap 建構函式多載。 建構並行的未排序多重對應。

公用方法

名稱描述
concurrent_unordered_multimap:: hash_function 方法傳回儲存的雜湊函式物件。
concurrent_unordered_multimap:: insert 方法多載。 將項目來加入concurrent_unordered_multimap物件。
concurrent_unordered_multimap:: key_eq 方法傳回預存的相等比較函式物件。
concurrent_unordered_multimap:: swap 方法交換兩個內容concurrent_unordered_multimap物件。 這個方法不是並行安全。
concurrent_unordered_multimap:: unsafe_erase 方法多載。 移除項目從concurrent_unordered_multimap位於指定位置。 這個方法不是並行安全。

公用運算子

名稱說明
concurrent_unordered_multimap:: operator = 運算子多載。 另一個內容指派concurrent_unordered_multimap這個物件。 這個方法不是並行安全。

如需詳細資訊concurrent_unordered_multimap類別,請參閱平行容器和物件

_Traits

_Concurrent_hash

concurrent_unordered_multimap

標頭︰ concurrent_unordered_map.h

命名空間: concurrency

傳回迭代器指向並行容器中的第一個項目。 這個方法是並行安全。

iterator begin();

const_iterator begin() const;

傳回值

並行容器中的第一個元素的迭代器。

傳回指向並行容器中的第一個元素的 const 迭代器。 這個方法是並行安全。

const_iterator cbegin() const;

傳回值

並行容器中的第一個項目為 const 迭代器。

傳回指向下一個位置定址,並行容器中的最後一個元素的 const 迭代器。 這個方法是並行安全。

const_iterator cend() const;

傳回值

Const 迭代器之後,並行容器中的最後一個元素的位置。

清除並行容器中的所有項目。 此函式不是並行安全。

void clear();

建構並行的未排序多重對應。

explicit concurrent_unordered_multimap(
    size_type _Number_of_buckets = 8,
    const hasher& _Hasher = hasher(),
    const key_equal& key_equality = key_equal(),
    const allocator_type& _Allocator = allocator_type());

concurrent_unordered_multimap(
    const allocator_type& _Allocator);

template <typename _Iterator>
concurrent_unordered_multimap(_Iterator _Begin,
    _Iterator _End,
    size_type _Number_of_buckets = 8,
    const hasher& _Hasher = hasher(),
    const key_equal& key_equality = key_equal(),
    const allocator_type& _Allocator = allocator_type());

concurrent_unordered_multimap(
    const concurrent_unordered_multimap& _Umap);

concurrent_unordered_multimap(
    const concurrent_unordered_multimap& _Umap,
    const allocator_type& _Allocator);

concurrent_unordered_multimap(
    concurrent_unordered_multimap&& _Umap);

參數

_Iterator
輸入迭代器的類型。

_Number_of_buckets
這個未排序多重對應的 Bucket 初始數量。

_Hasher
這個未排序多重對應的雜湊函式。

key_equality
這個未排序多重對應的相等比較函式。

_Allocator
這個未排序多重對應的配置器。

_Begin
要複製的元素範圍中第一個元素的位置。

_End
超出要複製之元素範圍的第一個元素的位置。

_Umap
來源concurrent_unordered_multimap来複製元素的物件。

備註

所有建構函式都會儲存配置器物件 _Allocator 並初始化未排序的多重對應。

第一個建構函式會指定空的初始多重對應,並明確指定要使用的 Bucket、雜湊函式、相等函式和配置器類型的數目。

第二個建構函式會為未排序多重對應指定配置器。

第三個建構函式會指定迭代器範圍所提供的值 [ _Begin_End)。

第四個和第五個建構函式會指定並行未排序之多重對應 _Umap 的複製作業。

最後一個建構函式會指定並行未排序之多重對應 _Umap 的移動作業。

計算符合指定之索引鍵的項目數目。 此函式是並行安全。

size_type count(const key_type& KVal) const;

參數

KVal
要搜尋的索引鍵。

傳回值

次數的索引鍵會出現在容器中的次數。

測試項目是否不存在。 這個方法是並行安全。

bool empty() const;

傳回值

true並行容器是空的如果false否則。

備註

有並行插入是不是空白,並行容器可能會變更之後立即呼叫此函式,即使讀取傳回值之前。

傳回迭代器指向下一個位置定址,並行容器中的最後一個項目。 這個方法是並行安全。

iterator end();

const_iterator end() const;

傳回值

迭代器之後,並行容器中的最後一個元素的位置。

尋找符合指定的索引鍵範圍。 此函式是並行安全。

std::pair<iterator,
    iterator> equal_range(
    const key_type& KVal);

std::pair<const_iterator,
    const_iterator> equal_range(
    const key_type& KVal) const;

參數

KVal
要搜尋的索引鍵的值。

傳回值

A其中的第一個元素是開頭的迭代器,而第二個元素是範圍結尾的迭代器。

備註

它有可能會造成額外的金鑰之後開始迭代器,以及結尾迭代器之前,要插入的並行插入。

尋找符合指定之索引鍵的元素。 此函式是並行安全。

iterator find(const key_type& KVal);

const_iterator find(const key_type& KVal) const;

參數

KVal
要搜尋的索引鍵的值。

傳回值

迭代器指向的位置比對提供的索引鍵的第一個元素或迭代器end()如果沒有這類項目。

傳回這個並行容器的預存配置器物件。 這個方法是並行安全。

allocator_type get_allocator() const;

傳回值

這個並行容器預存配置器物件。

傳回儲存的雜湊函式物件。

hasher hash_function() const;

傳回值

儲存的雜湊函式物件。

將項目來加入concurrent_unordered_multimap物件。

iterator insert(
    const value_type& value);

iterator insert(
    const_iterator _Where,
    const value_type& value);

template<class _Iterator>
void insert(_Iterator first,
    _Iterator last);

template<class V>
iterator insert(
    V&& value);

template<class V>
typename std::tr1::enable_if<!std::tr1::is_same<const_iterator,
    typename std::tr1::remove_reference<V>::type>::value,
    iterator>::type insert(
    const_iterator _Where,
    V&& value);

參數

_Iterator
用來插入的迭代器類型。

V
插入對應的值型別。

value
要插入的值。

_Where
要搜尋插入點的起始位置。

first
要插入之範圍的開頭。

last
要插入之範圍的結尾。

傳回值

指向插入位置的迭代器。

備註

第一個成員函式會將 value 項目插入受控制的序列中,然後傳回指定所插入項目的迭代器。

第二個成員函式會傳回 insert ( value),並使用_Where做為要搜尋插入點的受控制序列內的起始位置。

第三個成員函式的序列,插入項目值的範圍從 [ firstlast)。

最後兩個成員函式的行為與前兩個相同,不過 value 是用來建構插入的值。

傳回預存的相等比較函式物件。

key_equal key_eq() const;

傳回值

預存的相等比較函式物件。

計算並傳回目前的負載因數的容器。 載入因數是除以值區數目的容器中的項目數。

float load_factor() const;

傳回值

容器的載入因數。

取得或設定容器的最大載入因數。 最大載入因數是容器增加其內部資料表會被貯體中最大元素數目。

float max_load_factor() const;

void max_load_factor(float _Newmax);

參數

_Newmax

傳回值

第一個成員函式會傳回儲存的最大載入因數。 第二個成員函式沒有傳回值,但會擲回out_of_range例外狀況,如果提供的載入因數無效...

傳回並行容器,取決於配置的大小上限。 這個方法是並行安全。

size_type max_size() const;

傳回值

可以插入這個並行容器的項目數目上限。

備註

此上限值實際上可能會高於什麼容器可以實際保留的。

另一個內容指派concurrent_unordered_multimap這個物件。 這個方法不是並行安全。

concurrent_unordered_multimap& operator= (const concurrent_unordered_multimap& _Umap);

concurrent_unordered_multimap& operator= (concurrent_unordered_multimap&& _Umap);

參數

_Umap
來源 concurrent_unordered_multimap 物件。

傳回值

參考concurrent_unordered_multimap物件。

備註

在清除並行未排序的多重對應中的任何現有項目之後,operator= 會將 _Umap 的內容複製或移動至並行的未排序多重對應內。

重建雜湊資料表。

void rehash(size_type _Buckets);

參數

_Buckets
需要的值區數。

備註

成員函式會將 Bucket 的數目改變為至少 _Buckets,並視需要重建雜湊資料表。 值區數目必須是 2 的乘冪。 如果不 2 的乘冪,它會無條件進位到下一個最大 2 的乘冪。

它會擲回out_of_range例外狀況,如果是無效的值區數目 (0 或大於 bucket 最大數目)。

傳回這個並行容器中的項目數目。 這個方法是並行安全。

size_type size() const;

傳回值

容器中的項目數目。

備註

有並行插入存在時,並行容器中的項目數可能會在呼叫這個函式之後立即變更,甚至會是在尚未讀取傳回值的情況下。

交換兩個內容concurrent_unordered_multimap物件。 這個方法不是並行安全。

void swap(concurrent_unordered_multimap& _Umap);

參數

_Umap
要交換的 concurrent_unordered_multimap 物件。

傳回在這個特定的值區容器中的第一個元素的迭代器。

local_iterator unsafe_begin(size_type _Bucket);

const_local_iterator unsafe_begin(size_type _Bucket) const;

參數

_Bucket
值區索引。

傳回值

指向的值區開頭迭代器。

傳回特定索引鍵對應到此容器中的值區索引。

size_type unsafe_bucket(const key_type& KVal) const;

參數

KVal
要搜尋的項目索引鍵。

傳回值

此容器中的索引鍵的值區索引。

傳回目前的值區數目,此容器中。

size_type unsafe_bucket_count() const;

傳回值

目前此容器中的值區數目。

在這個容器的特定值區中傳回的項目數。

size_type unsafe_bucket_size(size_type _Bucket);

參數

_Bucket
若要搜尋的值區。

傳回值

目前此容器中的值區數目。

傳回在這個特定的值區容器中的第一個元素的迭代器。

const_local_iterator unsafe_cbegin(size_type _Bucket) const;

參數

_Bucket
值區索引。

傳回值

指向的值區開頭迭代器。

傳回迭代器,之後在特定的值區中的最後一個元素的位置。

const_local_iterator unsafe_cend(size_type _Bucket) const;

參數

_Bucket
值區索引。

傳回值

指向的值區開頭迭代器。

傳回在這個特定的值區容器中的最後一個元素的迭代器。

local_iterator unsafe_end(size_type _Bucket);

const_local_iterator unsafe_end(size_type _Bucket) const;

參數

_Bucket
值區索引。

傳回值

指向的值區結尾迭代器。

移除項目從concurrent_unordered_multimap位於指定位置。 這個方法不是並行安全。

iterator unsafe_erase(
    const_iterator _Where);

size_type unsafe_erase(
    const key_type& KVal);

iterator unsafe_erase(
    const_iterator first,
    const_iterator last);

參數

_Where
若要清除從迭代器位置。

KVal
清除金鑰值。

first
last

傳回值

前兩個成員函式會傳回迭代器,以指定的任何項目移除,剩餘的第一個項目或concurrent_unordered_multimap::end(),如果沒有這類項目。 第三個成員函式傳回的項目數,它會移除。

備註

第一個成員函式會移除 _Where 所指向之受控制序列中的項目。 第二個成員函式範圍中移除項目 [ _Begin_End)。

第三個成員函式來分隔範圍中移除項目concurrent_unordered_multimap::equal_range(KVal)。

此容器中傳回值區的數目上限。

size_type unsafe_max_bucket_count() const;

傳回值

此容器中的值區數目上限。

concurrency 命名空間
平行容器和物件

顯示: