Solidity 小白教程:7. 映射类型 mapping
这一讲,我们将介绍 solidity 中的哈希表:映射(Mapping)类型。
映射 Mapping
在映射中,人们可以通过键(Key )来查询对应的值(Value ),比如:通过一个人的id 来查询他的钱包地址。
声明映射的格式为mapping(_KeyType => _ValueType) ,其中**_KeyType和 _ValueType分别是 Key和Value**的变量类型。例子:
solidity
mapping(uint => address) public idToAddress; // id映射到地址
mapping(address => address) public swapPair; // 币对的映射,地址到地址
映射的规则
- 规则 1 :映射的**_KeyType只能选择 solidity默认的类型,比如 uint**,address 等,不能用自定义的结构体。而**_ValueType可以使用自定义的类型。下面这个例子会报错,因为_KeyType**使用了我们自定义的结构体:
solidity
// 我们定义一个结构体 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**对应新增的键值对。例子:
solidity
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**等。