哈希表add方法中各分支return True的含义及对代码的影响是什么？

给定的add方法完整代码如下：

def add(self, key, value):
    key_hash = self._get_hash(key)
    key_value = [key, value]

    if self.map[key_hash] is None:
        self.map[key_hash] = list([key_value])
        return True
    else:
        for pair in self.map[key_hash]:
            if pair[0] == key:
                pair[1] = value
                return True
        self.map[key_hash].append(key_value)
        return True

设计意图 #

这两处返回True的设计逻辑是统一的，核心意图如下：

• 执行pair[1] = value后返回True：对应key已存在、更新原有值的操作场景，返回True是给调用方明确反馈：更新操作执行成功
• 执行self.map[key_hash].append(key_value)后返回True：对应key不存在、新增键值对的操作场景，返回True是给调用方明确反馈：新增操作执行成功

整个方法的设计逻辑是把新增和更新能力合并到同一个add接口里，只要操作正常完成，不管是新增还是更新，统一返回成功标识，降低调用方的使用成本——调用方不需要提前判断key是否存在，直接调用add方法就能完成写入需求，也不需要区分返回值的不同含义。

对代码运行的影响 #

正面影响 #

• 接口使用门槛低：调用方不需要提前查询key是否存在，一行调用就能完成写入需求，适合绝大多数只关心「是否写入成功」的通用KV存储场景
• 返回值逻辑简单：所有正常执行的场景都返回True，调用方只要判断返回值为True就能确认操作没有问题，不需要处理多种返回状态

负面影响 #

• 无法区分操作类型：如果业务场景需要感知本次写入是新增了key、还是更新了已有key（比如统计新增key数量、实现仅当key不存在时才写入的需求），这个接口的返回值无法提供对应信息，调用方必须额外先做一次查询，增加了遍历哈希桶的性能开销
• 没有失败状态反馈：当前代码没有任何异常处理分支，理论上只要没有触发运行时异常就永远返回True，调用方无法通过返回值判断是否出现了隐性异常（比如hash计算异常、内存溢出这类极端问题）

内容的提问来源于stack exchange，提问作者StudentProgrammer12