library引入

常常，我们会进行加减乘除的操作，如下的函数就是对两个函数参数进行了四则运算。

1
2
3
4
5
6
 
function operate(uint a, uint b) pure returns(uint,uint,uint,uint){
  uint add = a+b;
  uint sub = a-b;
  uint mul = a*b;
  uint div = a/b;
}

library库

上面的函数其实是有问题的，因为它不能够避免出错，例如如果为b传递为0，就会报错。并且没有防止溢出***的问题。有很多时候，对于一些基础性的操作，我们可以把他们封装起来，这就是library库的作用。

library的定义

如下例所示，就是上面4则运算使用的library库，对于溢出等进行了问题规避。
library库中，不能包含状态变量、

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
 
library SafeMath{

    function mul(uint a,uint b) pure returns(uint){

        uint c = a*b;
        assert(c/a==b);
        return c;
    }

    function div(uint a,uint b) pure returns(uint){
        uint c = a/b;
        assert(a== b*c +a%b);
        return c;
    }

      function sub(uint a,uint b) pure returns(uint){

        assert(a>=b);
        return a-b;
    }

     function add(uint a,uint b) pure returns(uint){

       uint c = a+b;
       assert(c>=a);
        return c;
    }
}

library库的使用

直接使用库函数中的函数。

1
2
3
4
5
6
7
8
 
function operate(uint a,uint b) pure returns(uint,uint,uint,uint){

      uint jia = SafeMath.add(a,b);
      uint jian = SafeMath.sub(a,b);
      uint cheng =SafeMath.mul(a,b);
      uint chu = SafeMath.div(a,b);
      return(jia,jian,cheng,chu);
  }

方式2:使用 using SafeMath for uint之后，可以调用库函数。例如a.add(b) 意味着 执行了safemath库中的 add(a,b)

1
2
3
4
5
6
7
8
 
  using SafeMath for uint;
function operate2(uint a,uint b) pure returns(uint,uint,uint,uint){
      uint jia = a.add(b);
      uint jian = a.sub(b);
      uint cheng =a.mul(b);
      uint chu = a.div(b);
      return(jia,jian,cheng,chu);
  }

library库深入机制

使用library，底层是使用了delegatecall来远程的调用另外一个合约的代码。只有在某些极少数的情况下，并不是使用了远程调用，而是编译器直接将library库的代码嵌套进了合约中。
例如：下面的例子中，library库中的代码全是pure类型，并且使用了SafeMath.add的方式来调用合约，因此，在编译的时候，会直接将library库的add方法加载到合约中。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
 
pragma solidity 0.4.23;
library SafeMath{

     function add(uint a,uint b) pure returns(uint){

       uint c = a+b;
       assert(c>=a);
        return c;
    }
}

contract math{
    function operate(uint a,uint b)  returns(uint){
        uint jia = SafeMath.add(a,b);
        return(jia);
    }

}

当library库中，有this关键字，函数参数中有storage属性，或者使用了using SafeMath for uint来调用library库的时候，会使用到远程的library库。
下面的例子，编译器都会需要外部的一个library库的地址，从而能够远程调用到library合约。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
 
pragma solidity 0.4.23;
library SafeMath{

     function add(uint a,uint b) pure returns(uint){

       uint c = a+b;
       assert(c>=a);
        return c;
    }
}

contract math{
   using SafeMath for uint;
    function operate(uint a,uint b)  returns(uint){
        uint jia = a.add(b);
        return(jia);
    }
}

编译math合约的时候，其二进制代码如下：

1
 
"608060405234801561001057600080fd5b5061017c806100206000396000f300608060405260043610610041576000357c0100000000000000000000000000000000000000000000000000000000900463ffffffff168063db17ebcd14610046575b600080fd5b34801561005257600080fd5b5061007b6004803603810190808035906020019092919080359060200190929190505050610091565b6040518082815260200191505060405180910390f35b6000808373__browser/test6.sol:SafeMath____________63771602f79091856040518363ffffffff167c0100000000000000000000000000000000000000000000000000000000028152600401808381526020018281526020019250505060206040518083038186803b15801561010957600080fd5b505af415801561011d573d6000803e3d6000fd5b505050506040513d602081101561013357600080fd5b8101908080519060200190929190505050905080915050929150505600a165627a7a7230582006c538588770740653d6eba03016e0ef64c5da4f370291bdb71ea916cfbf166a0029"

注意到，在此二进制代码中，有一段预留的标识符，其是__browser/test6.sol:SafeMath____________.这一段预留的标识符就是远程library库的地址。

完整代码

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
 
pragma solidity 0.4.23;



library SafeMath{

    function mul(uint a,uint b) pure returns(uint){

        uint c = a*b;
        assert(c/a==b);
        return c;
    }

    function div(uint a,uint b) pure returns(uint){
        uint c = a/b;
        assert(a== b*c +a%b);
        return c;
    }

      function sub(uint a,uint b) pure returns(uint){

        assert(a>=b);
        return a-b;
    }

     function add(uint a,uint b) pure returns(uint){

       uint c = a+b;
       assert(c>=a);
        return c;
    }
}


contract math{

    using SafeMath for uint;

    function operate(uint a,uint b)  returns(uint,uint,uint,uint){

        uint jia = SafeMath.add(a,b);
        uint jian = SafeMath.sub(a,b);
        uint cheng =SafeMath.mul(a,b);
        uint chu = SafeMath.div(a,b);
        return(jia,jian,cheng,chu);
    }

     function operate2(uint a,uint b)  returns(uint,uint,uint,uint){

        uint jia = a.add(b);
        uint jian = a.sub(b);
        uint cheng =a.mul(b);
        uint chu = a.div(b);
        return(jia,jian,cheng,chu);
    }

}

复杂library例子

下例中，CounterContract合约 使用了CounterLib库中的结构体构建了自己的结构体变量counter。并调用了CounterLib库中的方法，实现了counter中i加一的操作。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
 
pragma solidity ^0.4.23;
library CounterLib {
  struct Counter { uint i; }

  function incremented(Counter storage self) returns (uint) {
      return ++self.i;
  }
}


contract CounterContract {
  using CounterLib for CounterLib.Counter;

  CounterLib.Counter counter;// struct Counter { uint i; }

  function increment() returns (uint) {
      return counter.incremented();
  }
}

  • 本文链接： https://dreamerjonson.com/2018/11/23/solidity-45-library/

  • 版权声明： 本博客所有文章除特别声明外，均采用 CC BY 4.0 CN协议 许可协议。转载请注明出处！

solidity智能合约[45]-library库_第1张图片