Solidity 小白教程：7. 映射类型 mapping

Solidity 小白教程：7. 映射类型 mapping

这一讲，我们将介绍 solidity 中的哈希表：映射（Mapping）类型。

映射 Mapping

在映射中，人们可以通过键（Key）来查询对应的值（Value），比如：通过一个人的id来查询他的钱包地址。
声明映射的格式为mapping(_KeyType => _ValueType)，其中**_KeyType和_ValueType分别是Key和Value**的变量类型。例子：

mapping(uint => address) public idToAddress; // id映射到地址
    mapping(address => address) public swapPair; // 币对的映射，地址到地址

映射的规则

• 规则 1：映射的**_KeyType只能选择solidity默认的类型，比如uint**，address等，不能用自定义的结构体。而**_ValueType可以使用自定义的类型。下面这个例子会报错，因为_KeyType**使用了我们自定义的结构体：

// 我们定义一个结构体 Struct
    struct Student{
        uint256 id;
        uint256 score;
    }
     mapping(Student => uint) public testVar;

• 规则 2：映射的存储位置必须是storage，因此可以用于合约的状态变量，函数中的storage变量，和 library 函数的参数（见例子）。不能用于public函数的参数或返回结果中，因为mapping记录的是一种关系 (key - value pair)。
• 规则 3：如果映射声明为public，那么solidity会自动给你创建一个getter函数，可以通过Key来查询对应的Value。
• 规则 4：给映射新增的键值对的语法为**_Var[_Key] = _Value**，其中**_Var是映射变量名，_Key和_Value**对应新增的键值对。例子：

function writeMap (uint _Key, address _Value) public{
        idToAddress[_Key] = _Value;
    }

映射的原理

• 原理 1: 映射不储存任何键（Key）的资讯，也没有 length 的资讯。
• 原理 2: 映射使用**keccak256(key)**当成 offset 存取 value。
• 原理 3: 因为 Ethereum 会定义所有未使用的空间为 0，所以未赋值（Value）的键（Key）初始值都是各个 type 的默认值，如 uint 的默认值是 0。

在 Remix 上验证 (以 Mapping.sol为例)

• 映射示例 1 部署
• 映射示例 2 初始值
• 映射示例 3 key-value pair

总结

这一讲，我们介绍了solidity中哈希表——映射（Mapping）的用法。至此，我们已经学习了所有常用变量种类，之后我们会学习控制流if-else,** while**等。