map::at

指定されたキー値を持つ要素を検索します。

Type& at( 
   const Key& _Key 
); 
const Type& at( 
   const Key& _Key 
) const;

パラメーター

パラメーター	説明
_Key	検索するキー値。

戻り値

見つかった要素のデータ値への参照。

解説

引数のキー値が見つからない場合、この関数は、out_of_range クラス クラスのオブジェクトをスローします。

使用例

// map_at.cpp
// compile with: /EHsc
#include <map>
#include <iostream>

typedef std::map<char, int> Mymap; 
int main() 
    { 
    Mymap c1; 
 
    c1.insert(Mymap::value_type('a', 1)); 
    c1.insert(Mymap::value_type('b', 2)); 
    c1.insert(Mymap::value_type('c', 3)); 
 
// find and show elements
    std::cout << "c1.at('a') == " << c1.at('a') << std::endl; 
    std::cout << "c1.at('b') == " << c1.at('b') << std::endl; 
    std::cout << "c1.at('c') == " << c1.at('c') << std::endl; 

    return (0); 
    } 

出力

c1.at('a') == 1
c1.at('b') == 2
c1.at('c') == 3

必要条件

ヘッダー: <map>

名前空間: std

参照

関連項目

map クラス

標準テンプレート ライブラリ