Solidity 函数

函数是一组可重用代码的包装，接受输入，返回输出。

Solidity 支持函数定义和调用。

1. 函数定义

Solidity中，定义函数的语法如下：

语法

function function_name(<parameter list>) <visibility> <state mutability> [returns(<return type>)] {
    //语句
}

函数由关键字function声明，后面跟函数名、参数、状态可变性、可见性、返回值的定义。

可见性（visibility）

函数的可见性有四种：

Private（私有）：函数只能在所定义的智能合约内部调用。
Internal（内部）：可以在所定义智能合约内部调用该函数，也可以从继承合约中调用该函数。
External（外部）：只能从智能合约外部调用。如果要从智能合约中调用它，则必须使用 this。
Public（公开）：可以从任何地方调用。

状态可变性（mutability）

view：用view声明的函数只能读取状态，而不能修改状态。
pure：用pure声明的函数既不能读取也不能修改状态。
payable：用payable声明的函数可以接受发送给合约的以太币，如果未指定，该函数将自动拒绝所有发送给它的以太币

示例

下面的例子，定义了一个名为getResult的函数，该函数不接受任何参数：

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;

contract Test {
   function getResult() public view returns(uint){
      uint a = 1; // 局部变量
      uint b = 2;
      uint result = a + b;
      return result;
   }
}

2. 函数调用

要调用函数，只需使用函数名，并传入参数即可。

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;
contract SolidityTest {
   constructor() {
   }
   
   function getResult() public pure returns(string memory){
      return integerToString(3);  // 调用函数 integerToString
   }
      // integerToString 函数定义   function integerToString(uint _i) internal pure 
      returns (string memory) {
      if (_i == 0) {
         return "0";
      }
      uint j = _i;
      uint len;
      while (j != 0) {
         len++;
         j /= 10;
      }
      bytes memory bstr = new bytes(len);
      uint k = len - 1;
      while (_i != 0) {
         bstr[k--] = byte(uint8(48 + _i % 10));
         _i /= 10;
      }
      return string(bstr);
   }
}

运行上述程序，输出：

0: string: 3

3. return 语句

Solidity中，函数可以返回多个值。

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;

contract Test {
   function getResult() public view returns(uint product, uint sum){
      uint a = 1; // 局部变量
      uint b = 2;
      product = a * b; // 使用返回参数返回值
      sum = a + b; // 使用返回参数返回值

      // 也可以使用return返回多个值
      // return(a*b, a+b);
   }
}

运行上述程序，输出：

0: uint256: product 2
1: uint256: sum 3

下一章：Solidity 函数返回值

Solidity 函数的返回值可以使用名字，也可以采用匿名方式。Solidity 函数的返回值可以通过名字赋值，也可以使用 return 返回。Solidity 函数支持多个返回值。// SPDX-Licens ...

上一章：Solidity 赋值的数据位置规则

下一章：Solidity 函数返回值