std::map


ヘッダ <map> で定義

template< class Key, class T, class Compare = std::less<Key>, class Allocator = std::allocator<std::pair<const Key, T> > > class map;	(1)

namespace pmr { template <class Key, class T, class Compare = std::less<Key>> using map = std::map<Key, T, Compare, std::pmr::polymorphic_allocator<std::pair<const Key,T>>>; }	(2)(c++17以上)

テンプレート引数

Key	-	キーの型
T	-	値の型
Compare	-	キー比較関数狭義弱順序を提供する Compare 型。
Allocator	-	メモリを確保/解放したり、そのメモリに要素を構築/破棄したりするために使用されるアロケータ。この型は Allocator の要件を満たさなければなりません。 Allocator::value_type と Key が同じでない場合、動作は未定義です。

std::map は一意なキーを持つキー値ペアを格納するソートされた連想コンテナです。キーは比較関数 Compare を使用してソートされます。検索、削除、挿入の操作の計算量は対数時間です。

標準ライブラリが Compare 要件を使用する場所ではすべて、一意性は同等関係を使用して決定されます。不正確な言葉で言うと、2つのオブジェクト a と b は、どちらがどちらより小さいわけでもない (!comp(a, b) && !comp(b, a)) 場合に等しいとみなされます。

std::map は Container, AllocatorAwareContainer, AssociativeContainer, ReversibleContainer の要件を満たします。たします。

1. 始めに

[概要]

適当に簡単なサンプルプログラムを作成してみます。

[環境]


コンパイラ :	g++,	9.3.0

OS :	Ubuntu (WSL2),	20.04

[プログラムソース "map_01.cpp"]

#include <iostream>
#include <string>
#include <map>

using namespace std;

template <class T, class U>
void output(const map<T, U>& container)
{
    cout << '{';
    for (const auto& data : container){
//  for (const pair<T, U>& data : container){
        cout << '(' << data.first << ", " << data.second << "), ";
    }
    cout << '}' << endl;
}

int main()
{
    map<string, int> data_a;
    map<string, int> data_b = {{"red", 1}, {"blue", 2}, {"yellow", 3}};

    output(data_a);
    output(data_b);

    cout << "data_b[\"red\"]    = " << data_b["red"]    << endl;
    cout << "data_b[\"blue\"]   = " << data_b["blue"]   << endl;
    cout << "data_b[\"yellow\"] = " << data_b["yellow"] << endl;
}

[出力]

{}
{(blue, 2), (red, 1), (yellow, 3), }
data_b["red"]  = 1
data_b["blue"] = 2
data_b["yellow"] = 3

MIT License

Copyright (c) 2021 Kinoshita Hidetoshi

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

std::map

std::map

テンプレート引数

1. 始めに

[概要]

[環境]

ライセンス

参考

記載