智能合约语言 Solidity 教程系列6 - 结构体与映射

masturbator 发布于2019-06-27 18:27 / 1122人阅读

摘要：本文首发于深入浅出区块链社区原文链接智能合约语言教程系列结构体与映射原文已更新，请读者前往原文阅读教程系列第篇结构体与映射。不能声明一个同时将自身作为成员，这个限制是基于结构体的大小必须是有限的。

本文首发于深入浅出区块链社区
原文链接:智能合约语言Solidity教程系列6 - 结构体与映射原文已更新，请读者前往原文阅读

Solidity 教程系列第6篇 - Solidity 结构体与映射。
Solidity 系列完整的文章列表请查看分类-Solidity。

写在前面

Solidity 是以太坊智能合约编程语言，阅读本文前，你应该对以太坊、智能合约有所了解，
如果你还不了解，建议你先看以太坊是什么

本系列文章一部分是参考Solidity官方文档（当前最新版本：0.4.20）进行翻译，另一部分是Solidity深入分析，这部分请订阅区块链技术专栏阅读。

结构体(Structs)

Solidity提供struct来定义自定义类型，自定义的类型是引用类型。
我们看看下面的例子：

pragma solidity ^0.4.11;

contract CrowdFunding {
    // 定义一个包含两个成员的新类型
    struct Funder {
        address addr;
        uint amount;
    }

    struct Campaign {
        address beneficiary;
        uint fundingGoal;
        uint numFunders;
        uint amount;
        mapping (uint => Funder) funders;
    }

    uint numCampaigns;
    mapping (uint => Campaign) campaigns;

    function newCampaign(address beneficiary, uint goal) public returns (uint campaignID) {
        campaignID = numCampaigns++; // campaignID 作为一个变量返回
        // 创建一个结构体实例，存储在storage ，放入mapping里
        campaigns[campaignID] = Campaign(beneficiary, goal, 0, 0);
    }

    function contribute(uint campaignID) public payable {
        Campaign storage c = campaigns[campaignID];
        // 用mapping对应项创建一个结构体引用
        // 也可以用 Funder(msg.sender, msg.value) 来初始化.
        c.funders[c.numFunders++] = Funder({addr: msg.sender, amount: msg.value});
        c.amount += msg.value;
    }

    function checkGoalReached(uint campaignID) public returns (bool reached) {
        Campaign storage c = campaigns[campaignID];
        if (c.amount < c.fundingGoal)
            return false;
        uint amount = c.amount;
        c.amount = 0;
        c.beneficiary.transfer(amount);
        return true;
    }
}

上面是一个简化版的众筹合约，但它可以让我们理解structs的基础概念，struct可以用于映射和数组中作为元素。其本身也可以包含映射和数组等类型。

不能声明一个struct同时将自身struct作为成员，这个限制是基于结构体的大小必须是有限的。
但struct可以作为mapping的值类型成员。

注意在函数中，将一个struct赋值给一个局部变量（默认是storage类型），实际是拷贝的引用，所以修改局部变量值的同时，会影响到原变量。

当然，也可以直接通过访问成员修改值，而不用一定赋值给一个局部变量，如campaigns[campaignID].amount = 0

映射(Mappings)

映射类型，一种键值对的映射关系存储结构。定义方式为mapping(_KeyType => _KeyValue)。键类型允许除映射、变长数组、合约、枚举、结构体外的几乎所有类型（）。值类型没有任何限制，可以为任何类型包括映射类型。

映射可以被视作为一个哈希表，所有可能的键会被虚拟化的创建，映射到一个类型的默认值（二进制的全零表示）。在映射表中，并不存储键的数据，仅仅存储它的keccak256哈希值，这个哈希值在查找值时需要用到。
正因为此，映射是没有长度的，也没有键集合或值集合的概念。

映射类型，仅能用来作为状态变量，或在内部函数中作为storage类型的引用。

可以通过将映射标记为public，来让Solidity创建一个访问器。通过提供一个键值做为参数来访问它，将返回对应的值。
映射的值类型也可以是映射，使用访问器访问时，要提供这个映射值所对应的键，不断重复这个过程。
来看一个例子：

pragma solidity ^0.4.0;

contract MappingExample {
    mapping(address => uint) public balances;

    function update(uint newBalance) public {
        balances[msg.sender] = newBalance;
    }
}

contract MappingUser {
    function f() public returns (uint) {
        MappingExample m = new MappingExample();
        m.update(100);
        return m.balances(this);
    }
}

注意：
映射并未提供迭代输出的方法，可以自行实现一个这样的数据结构。参考iterable mapping

参考视频

我们也推出了目前市面上最全的视频教程：深入详解以太坊智能合约语言Solidity
目前我们也在招募体验师，可以点击链接了解。

参考文档

Solidity官方文档

☛ 深入浅出区块链 - 系统学习区块链，打造最好的区块链技术博客。

☛ 我的知识星球为各位解答区块链技术问题，欢迎加入讨论。

☛ 关注公众号“深入浅出区块链技术”第一时间获取区块链技术信息。

GPU云服务器云服务器智能合约区块链智能合约技术区块链智能合约开发 linux系列教程

文章版权归作者所有，未经允许请勿转载,若此文章存在违规行为，您可以联系管理员删除。

转载请注明本文地址：https://www.ucloud.cn/yun/24112.html

区块链技术学习指引

摘要：引言给迷失在如何学习区块链技术的同学一个指引，区块链技术是随比特币诞生，因此要搞明白区块链技术，应该先了解下比特币。但区块链技术不单应用于比特币，还有非常多的现实应用场景，想做区块链应用开发，可进一步阅读以太坊系列。本文始发于深入浅出区块链社区, 原文：区块链技术学习指引原文已更新，请读者前往原文阅读本章的文章越来越多，本文是一个索引帖，方便找到自己感兴趣的文章，你也可以使用左侧...

Cristic 2019-06-27 18:14 评论0 收藏0
智能合约语言Solidity教程系列5 - 数组介绍

摘要：还需注意的一点是，定长数组，不能与变长数组相互赋值，我们来看下面的代码无法编译已经计划在未来移除这样的限制。的变长数组，可以通过给赋值调整数组长度。的变长数组不支持。本文首发于深入浅出区块链社区原文链接:智能合约语言Solidity教程系列5 - 数组介绍原文已更新，请读者前往原文阅读 Solidity 教程系列第5篇 - Solidity 数组介绍。Solidity 系列完整的文章...

draveness 2019-06-27 18:26 评论0 收藏0
智能合约语言 Solidity 教程系列4 - 数据存储位置分析

摘要：状态变量合约内声明的公有变量还有一个存储位置是，用来存储函数参数，是只读的，不会永久存储的一个数据位置。称这个为状态改变，这也是合约级变量称为状态变量的原因。本文首发于深入浅出区块链社区原文链接:智能合约语言 Solidity 教程系列4 - 数据存储位置分析原文已更新，请读者前往原文阅读 Solidity教程系列第4篇 - Solidity数据位置分析。写在前面 Solidity...

Galence 2019-06-27 18:14 评论0 收藏0
智能合约语言Solidity教程系列7 - 以太单位及时间单位

摘要：如果想对输入的变量说明其不同的单位，可以使用下面的方式参考视频我们也推出了目前市面上最全的视频教程深入详解以太坊智能合约语言目前我们也在招募体验师，可以点击链接了解。本文首发于深入浅出区块链社区原文链接:智能合约语言 Solidity 教程系列7 - 以太单位及时间单位原文已更新，请读者前往原文阅读这是Solidity教程系列文章第7篇介绍以太单位及时间单位，系列带你全面深入理解S...

justCoding 2019-06-27 18:25 评论0 收藏0
智能合约语言 Solidity 教程系列10 - 完全理解函数修改器

摘要：本文首发于深入浅出区块链社区原文链接智能合约语言教程系列完全理解函数修改器原文已更新，请读者前往原文阅读这是教程系列文章第篇，带大家完全理解的函数修改器。在此上下文中，所有的函数中引入的符号，在修改器中均可见。本文首发于深入浅出区块链社区原文链接:智能合约语言 Solidity 教程系列10 - 完全理解函数修改器原文已更新，请读者前往原文阅读这是Solidity教程系列文章第10...

Object 2019-06-27 18:27 评论0 收藏0