C / C++ / 系统课时
map 的方括号有什么副作用
map 的方括号有什么副作用
std::map 看起来可以像数组一样用方括号访问元素,但它的 operator[] 不只是“读取”。当键不存在时,它会先创建这个键,并为对应值进行默认初始化。理解这一点,才能避免一次看似普通的查询悄悄改变容器内容。
学习目标
- 理解
operator[]在键不存在时为什么会插入新元素 - 区分
operator[]、at和find的读取行为 - 根据是否允许修改
map选择合适的访问方式
方括号不是纯读取操作
对于 std::map<Key, T>,表达式 m[key] 会查找 key。如果键已经存在,它返回对应值的引用;如果键不存在,则先插入该键,并创建一个默认初始化的 T,再返回这个新值的引用。
例如 T 是 int 时,新值通常为 0;如果是 std::string,新值为空字符串。因此下面这样的代码虽然没有显式调用 insert,却会改变 map:
#include <iostream>
#include <map>
#include <stdexcept>
#include <string>
int main() {
std::map<std::string, int> scores{{"alice", 90}};
std::cout << "initial size: " << scores.size() << '\n';
std::cout << "alice: " << scores["alice"] << '\n';
// bob 不存在,operator[] 会插入 bob,并把 int 默认初始化为 0。
std::cout << "bob via []: " << scores["bob"] << '\n';
std::cout << "size after []: " << scores.size() << '\n';
// find 只查找,不会因为键不存在而插入元素。
auto it = scores.find("carol");
if (it == scores.end()) {
std::cout << "carol not found\n";
}
std::cout << "size after find: " << scores.size() << '\n';
try {
scores.at("dave");
} catch (const std::out_of_range&) {
std::cout << "at(dave): out_of_range\n";
}
std::cout << "size after at: " << scores.size() << '\n';
}预期输出:
initial size: 1
alice: 90
bob via []: 0
size after []: 2
carol not found
size after find: 2
at(dave): out_of_range
size after at: 2可以看到,真正让容器大小从 1 变成 2 的只有 scores["bob"]。后面的 find 和 at 都没有创建不存在的键。
at 适合必须存在的键
at(key) 也返回对应值的引用,但它不会自动插入。如果键不存在,会抛出 std::out_of_range。因此,当程序逻辑认为某个键理应已经存在时,at 能比 operator[] 更早暴露错误。
这种方式常见于已经完成初始化的配置表、固定编号映射等场景。若缺少键本身代表程序状态异常,使用 at 往往比悄悄产生默认值更安全。
at 还有一个重要区别:它提供 const 版本,可以用于只读的 const std::map。而 operator[] 可能需要插入元素,因此不能对 const map 使用。
find 适合把不存在当成正常情况
如果“键可能不存在”本身就是业务中的正常分支,通常使用 find。它返回迭代器;找到时迭代器指向元素,找不到时等于 end()。
这种写法既不会修改容器,也不依赖异常处理,尤其适合查询缓存、检查用户是否已登记、判断配置项是否可选等场景。找到后可以通过 it->first 取得键,通过 it->second 取得值。
三种访问方式可以这样选择:
| 方式 | 键不存在时 | 是否可能修改容器 | 典型用途 |
|---|---|---|---|
operator[] |
插入键并创建默认值 | 是 | 读取后准备修改,或有意创建元素 |
at |
抛出 std::out_of_range |
否 | 键必须存在 |
find |
返回 end() |
否 | 键可能不存在,需要显式判断 |
最容易出现的隐蔽错误
当 map 被用作查询表时,直接写 if (counts[key] > 0) 可能会给每个查询失败的 key 都创建一条值为 0 的记录。查询次数很多时,容器会不断增长,后续遍历、统计甚至内存占用都会受到影响。
因此,只有在“缺失时创建默认值”正是你想要的行为时,才应把 operator[] 当作便利操作。例如词频统计中的 ++counts[word] 就非常合适:第一次出现的单词会先得到 0,再自增为 1。纯查询则优先考虑 find,而对于必须存在的键使用 at 更能表达程序意图。