编辑“︁C++unordered map”︁（章节）

== 常用成员函数 ==

=== 元素访问 ===
* <code>operator[]</code>：访问或插入元素（键不存在时会创建）
* <code>at()</code>：访问元素（键不存在时抛出异常）

示例：
<syntaxhighlight lang="cpp">
std::unordered_map<std::string, int> ageMap = {{"Alice", 25}, {"Bob", 30}};

// 使用operator[]
ageMap["Charlie"] = 28;  // 插入新元素
int aliceAge = ageMap["Alice"];  // 访问现有元素

// 使用at()
try {
    int bobAge = ageMap.at("Bob");
    // int unknown = ageMap.at("Unknown"); // 抛出std::out_of_range异常
} catch(const std::out_of_range& e) {
    std::cerr << "Key not found: " << e.what() << '\n';
}
</syntaxhighlight>

=== 容量查询 ===
* <code>empty()</code>：检查容器是否为空
* <code>size()</code>：返回元素数量
* <code>max_size()</code>：返回容器可容纳的最大元素数

=== 修改器 ===
* <code>insert()</code>：插入元素
* <code>emplace()</code>：原位构造元素
* <code>erase()</code>：删除元素
* <code>clear()</code>：清空容器

示例：
<syntaxhighlight lang="cpp">
std::unordered_map<int, std::string> idToName;

// 插入元素
idToName.insert({1, "Alice"});
idToName.emplace(2, "Bob");  // 效率更高

// 删除元素
idToName.erase(1);  // 删除键为1的元素

// 清空容器
idToName.clear();
</syntaxhighlight>

=== 查找操作 ===
* <code>find()</code>：查找指定键的元素
* <code>count()</code>：统计具有指定键的元素数量（0或1）
* <code>contains()</code>（C++20）：检查是否包含指定键

示例：
<syntaxhighlight lang="cpp">
std::unordered_map<std::string, double> priceMap = {{"apple", 1.99}, {"banana", 0.99}};

// 使用find()
auto it = priceMap.find("apple");
if (it != priceMap.end()) {
    std::cout << "Price of apple: " << it->second << '\n';
}

// 使用count()
if (priceMap.count("banana") > 0) {
    std::cout << "Banana exists in the map\n";
}

// C++20的contains()
#if __cplusplus >= 202002L
if (priceMap.contains("orange")) {
    std::cout << "Orange exists in the map\n";
}
#endif
</syntaxhighlight>