资讯专栏INFORMATION COLUMN

智能合约语言Solidity教程系列5 - 数组介绍

draveness / 3784人阅读

摘要:还需注意的一点是,定长数组,不能与变长数组相互赋值,我们来看下面的代码无法编译已经计划在未来移除这样的限制。的变长数组,可以通过给赋值调整数组长度。的变长数组不支持。

本文首发于深入浅出区块链社区
原文链接:智能合约语言Solidity教程系列5 - 数组介绍原文已更新,请读者前往原文阅读

Solidity 教程系列第5篇 - Solidity 数组介绍。
Solidity 系列完整的文章列表请查看分类-Solidity。

写在前面

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

本文前半部分是参考Solidity官方文档(当前最新版本:0.4.20)进行翻译,后半部分对官方文档中没有提供代码的知识点补充代码说明(订阅专栏阅读)。

数组(Arrays)

数组可以声明时指定长度,也可以是动态变长。对storage存储的数组来说,元素类型可以是任意的,类型可以是数组,映射类型,结构体等。但对于memory的数组来说。如果作为public函数的参数,它不能是映射类型的数组,只能是支持ABI的类型。

一个元素类型为T,固定长度为k的数组,可以声明为T[k],而一个动态大小(变长)的数组则声明为T[]
还可以声明一个多维数组,如声明一个类型为uint的数组长度为5的变长数组(5个元素都是变长数组),可以声明为uint[][5]。(注意,相比非区块链语言,多维数组的长度声明是反的。)

要访问第三个动态数组的第二个元素,使用x2。数组的序号是从0开始的,序号顺序与定义相反。

bytesstring是一种特殊的数组。bytes类似byte[],但在外部函数作为参数调用中,bytes会进行压缩打包。string类似bytes,但不提供长度和按序号的访问方式(目前)。
所以应该尽量使用bytes而不是byte[]

</>复制代码

  1. 可以将字符串s通过bytes(s)转为一个bytes,可以通过bytes(s).length获取长度,bytes(s)[n]获取对应的UTF-8编码。通过下标访问获取到的不是对应字符,而是UTF-8编码,比如中文编码是多字节,变长的,所以下标访问到的只是其中的一个编码。
    类型为数组的状态变量,可以标记为public,从而让Solidity创建一个访问器,如果要访问数组的某个元素,指定数字下标就好了。(稍后代码事例)
创建内存数组

可使用new关键字创建一个memory的数组。与stroage数组不同的是,你不能通过.length的长度来修改数组大小属性。我们来看看下面的例子:

</>复制代码

  1. pragma solidity ^0.4.16;
  2. contract C {
  3. function f(uint len) public pure {
  4. uint[] memory a = new uint[](7);
  5. //a.length = 100; // 错误
  6. bytes memory b = new bytes(len);
  7. // Here we have a.length == 7 and b.length == len
  8. a[6] = 8;
  9. }
  10. }
数组常量及内联数组

数组常量,是一个数组表达式(还没有赋值到变量)。下面是一个简单的例子:

</>复制代码

  1. pragma solidity ^0.4.16;
  2. contract C {
  3. function f() public pure {
  4. g([uint(1), 2, 3]);
  5. }
  6. function g(uint[3] _data) public pure {
  7. // ...
  8. }
  9. }

通过数组常量,创建的数组是memory的,同时还是定长的。元素类型则是使用刚好能存储的元素的能用类型,比如[1, 2, 3],只需要uint8即可存储,它的类型是uint8[3] memory

由于g()方法的参数需要的是uint(默认的uint表示的其实是uint256),所以需要对第一个元素进行类型转换,使用uint(1)来进行这个转换。

还需注意的一点是,定长数组,不能与变长数组相互赋值,我们来看下面的代码:

</>复制代码

  1. // 无法编译
  2. pragma solidity ^0.4.0;
  3. contract C {
  4. function f() public {
  5. // The next line creates a type error because uint[3] memory
  6. // cannot be converted to uint[] memory.
  7. uint[] x = [uint(1), 3, 4];
  8. }
  9. }

已经计划在未来移除这样的限制。当前因为ABI传递数组还有些问题。

成员 length属性

数组有一个.length属性,表示当前的数组长度。storage的变长数组,可以通过给.length赋值调整数组长度。memory的变长数组不支持。
不能通过访问超出当前数组的长度的方式,来自动实现改变数组长度。memory数组虽然可以通过参数,灵活指定大小,但一旦创建,大小不可调整。

push方法

storage的变长数组和bytes都有一个push方法(string没有),用于附加新元素到数据末端,返回值为新的长度。

限制情况

当前在external函数中,不能使用多维数组。

另外,基于EVM的限制,不能通过外部函数返回动态的内容。

</>复制代码

  1. contract C {
  2. function f() returns (uint[]) { ... }
  3. }

在这个的例子中,如果通过web.js调用能返回数据,但从Solidity中调用不能返回数据。一种绕过这个问题的办法是使用一个非常大的静态数组。

</>复制代码

  1. pragma solidity ^0.4.16;
  2. contract ArrayContract {
  3. uint[2**20] m_aLotOfIntegers;
  4. // 这里不是两个动态数组的数组,而是一个动态数组里,每个元素是长度为二的数组。
  5. bool[2][] m_pairsOfFlags;
  6. // newPairs 存在 memory里,因为是函数参数
  7. function setAllFlagPairs(bool[2][] newPairs) public {
  8. m_pairsOfFlags = newPairs;
  9. }
  10. function setFlagPair(uint index, bool flagA, bool flagB) public {
  11. // 访问不存在的index会抛出异常
  12. m_pairsOfFlags[index][0] = flagA;
  13. m_pairsOfFlags[index][1] = flagB;
  14. }
  15. function changeFlagArraySize(uint newSize) public {
  16. // 如果新size更小, 移除的元素会被销毁
  17. m_pairsOfFlags.length = newSize;
  18. }
  19. function clear() public {
  20. // 销毁
  21. delete m_pairsOfFlags;
  22. delete m_aLotOfIntegers;
  23. // 同销毁一样的效果
  24. m_pairsOfFlags.length = 0;
  25. }
  26. bytes m_byteData;
  27. function byteArrays(bytes data) public {
  28. // byte arrays ("bytes") are different as they are stored without padding,
  29. // but can be treated identical to "uint8[]"
  30. m_byteData = data;
  31. m_byteData.length += 7;
  32. m_byteData[3] = byte(8);
  33. delete m_byteData[2];
  34. }
  35. function addFlag(bool[2] flag) public returns (uint) {
  36. return m_pairsOfFlags.push(flag);
  37. }
  38. function createMemoryArray(uint size) public pure returns (bytes) {
  39. // Dynamic memory arrays are created using `new`:
  40. uint[2][] memory arrayOfPairs = new uint[2][](size);
  41. // Create a dynamic byte array:
  42. bytes memory b = new bytes(200);
  43. for (uint i = 0; i < b.length; i++)
  44. b[i] = byte(i);
  45. return b;
  46. }
  47. }
补充事例说明

事例代码及讲解,请订阅区块链技术查看。

参考视频

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

参考文档

Solidity官方文档-数组

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

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

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

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

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

相关文章

  • 智能合约语言Solidity教程系列1 - 类型介绍

    摘要:本文首发于深入浅出区块链社区原文链接智能合约语言教程系列地址类型介绍原文已更新,请读者前往原文阅读现在的中文文档,要么翻译的太烂,要么太旧,决定重新翻译下。枚举类型应至少有一名成员。 本文首发于深入浅出区块链社区原文链接:智能合约语言 Solidity 教程系列2 - 地址类型介绍原文已更新,请读者前往原文阅读 现在的Solidity中文文档,要么翻译的太烂,要么太旧,决定重新翻译下。...

    andycall 评论0 收藏0
  • 智能合约语言 Solidity 教程系列9 - 错误处理

    摘要:本文首发于深入浅出区块链社区原文链接智能合约语言教程系列错误处理原文已更新,请读者前往原文阅读这是教程系列文章第篇介绍错误处理。如果合约没有修饰符的的函数在接收以太币时包括构造函数,和回退函数。如果合约通过一个的函数接收以太币。 本文首发于深入浅出区块链社区原文链接:智能合约语言 Solidity 教程系列9 - 错误处理原文已更新,请读者前往原文阅读 这是Solidity教程系列文章...

    xialong 评论0 收藏0
  • 区块链技术学习指引

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

    Cristic 评论0 收藏0
  • 智能合约语言 Solidity 教程系列4 - 数据存储位置分析

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

    Galence 评论0 收藏0
  • 智能合约语言 Solidity 教程系列6 - 结构体与映射

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

    masturbator 评论0 收藏0

发表评论

0条评论

最新活动
阅读需要支付1元查看
<