关于Mappings

Solidity中Mappings 的概念类似于java中的hashmap或者python中的dictionnary。它们使用都起来有一点像hash表,

尽管它们在以下方面略有不同:

在solidity中所有可能的变量都以默认值初始化。

正因为如此， mappings是没有长度的。没有设置一个key或者value的概念。关键数据不是储存在一个mapping中的，相反的它的keccak256 hash值用来存储关键数据指向的value值。

如何来定义一个Mapping?

mapping (_KeyType => _ValueType) mappingName;

一个好建议：在mapping变量名之前使用public关键字。这将会自动为mapping创建一个getter方法。你只需要通过传入_KeyType参数给getter就能返回_ValueType.

mapping (_KeyType => _ValueType) public mappingName;

如何使用一个mapping?

对关联关系非常有用,就像将一个eth的地址和一个uint的整数关联起来 mapping(address => _valueType) my_mapping
mapping(uint => _valueType) my_mapping

举个例子在游戏中我们把玩家的地址和玩家的等级关联起来

mapping(address => uint) public userLevel;

另一个例子列出地址是否能够发送eth？

mapping(address => bool) allowedToSend;

另外一个例子mapping的value值是一个struct类型。

struct someStruct {}

mapping(uint => someStruct) canDoSomething;

uint canDoSomethingKey = 0;

function addCanDoSomething() {
     canDoSomething[canDoSomethingKey] = someStruct(arg1, arg2, ...);
     canDoSomethingKey++;
}

如何从Mapping中获得value值?

function currentLevel(address userAddress) public view returns (uint) {
     return userLevel[userAddress];
}

使用Mapping作为另一个Mapping的value值

contract C {
    struct S { uint a; uint b; }
    uint x;
    mapping(uint => mapping(uint => S)) data;
}

循环一个mapping？

因为开头所说的原因不能直接去循环一个mapping变量。

mappings are virtually initialised such that every possible key exists and is mapped to a value

然而可以实现一个基于mapping之上的数据结构，来使得mapping可以被循环。

可以记录一个counter的计数器，来告诉你mapping的长度当有新增的value值的时候。

Mappings作为函数的参数

这是一个比较难得主题，但是我们还是尝试去探讨一下。Mappings可以作为参数传到函数中，但是它们必须满足下面的2个要求：

Mappings只能作为内部和私有函数的参数
Mappings作为参数传递时，数据的存储位置只能是storage

你不能使用Mappings的地方

不能直接循环mapping类型
Mappings在solidity中参数不能作为参数传递到公有函数和外部函数
Mappings不能作为函数的返回值

Variable Type	Key Type	Value Type
`int / uint`	✔️	✔️
`string`	✔️	✔️
`byte / bytes`	✔️	✔️
`address`	✔️	✔️
`struct`	❌	✔️
`mapping`	❌	✔️
`enum`	❌	✔️
`contract`	❌	✔️
* fixed-sized array `T[k]`	✔️	✔️
* dynamic-sized array `T[]`	❌	✔️
* multi-dimentional array `T[][]`	❌	✔️
`variable`	❌	❌

## github仓库
<https://github.com/coffiasd/solidity-learn>

Solidity之Mappings篇