public member function
<map>

std::map::count

size_type count (const key_type& k) const;
計算具有特定鍵的元素
在容器中搜索鍵與 k 等價的元素,並返回匹配的數量。

因為 map 容器中的所有元素都是唯一的,所以該函式只能返回 1(如果找到元素)或零(否則)。

當容器的 比較物件 返回false時,兩個被視為等價(即,無論鍵作為引數傳遞的順序如何)。

引數

k
要搜尋的鍵。
成員型別key_type是容器中元素鍵的型別,在 map 中定義為第一個模板引數的別名().

返回值

1如果容器包含一個鍵與 k 等價的元素,否則為零。

成員型別size_type是一種無符號整型型別。

示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
// map::count
#include <iostream>
#include <map>

int main ()
{
  std::map<char,int> mymap;
  char c;

  mymap ['a']=101;
  mymap ['c']=202;
  mymap ['f']=303;

  for (c='a'; c<'h'; c++)
  {
    std::cout << c;
    if (mymap.count(c)>0)
      std::cout << " is an element of mymap.\n";
    else 
      std::cout << " is not an element of mymap.\n";
  }

  return 0;
}

輸出
a is an element of mymap.
b is not an element of mymap.
c is an element of mymap.
d is not an element of mymap.
e is not an element of mymap.
f is an element of mymap.
g is not an element of mymap.


複雜度

size 的對數複雜度。

迭代器有效性

沒有變化。

資料競爭

訪問容器。
不訪問對映值:併發訪問或修改元素是安全的。

異常安全

強保證:如果丟擲異常,容器沒有發生變化。

另見