三分钟入门区块链语言Solidity函数｜入门系列

函数在所有的语言中都是一种常见类型。Solidity中的函数关键字是function，我们先来看一个最简单的例子：

pragma solidity ^0.4.0;
contract SimpleFunc {
function hello(uint i){
//todo
}
}


这样我们就学会了函数的编写。将上述代码复制到在线的浏览器编译器：https://ethereum.github.io/browser-solidity/ 中运行，就能立即看到效果。

函数的参数

函数的入参定义与变量类似。我们可以省略未使用到的参数变量名，如下例所示：

pragma solidity ^0.4.0;
contract Simple {
//函数的入参如变量的定义方式
//未使用的参数可以省略变量名
function InputPara(uint a, uint) {
a = a + 1;
}
}


例子中我们按变量定义的方式定义了uint a。由于我们在函数中未使用到第二个参数，省略了第二个参数的变量名。

命名参数

函数调用可以使用命名参数。将参数名和参数值这样的键值对以任意顺序放进{}即可。请确认所传参数一定要与定义的一致。下面来看个简单的例子：

pragma solidity ^0.4.0;
contract C {
//交换传入值的顺序并返回
function f(uint key, uint value) returns (uint, uint){
return (value, key);
}
function g() returns (uint, uint){
//任意顺序的通过变量名来指定参数值
return f({value: 2, key: 1});//2,1
}
}


通过指定参数名称，实际传入的值为1,2，通过调用f()函数，我们得到了交换顺序后的2,1。

函数的返回值

返回值的定义与参数类似，跟在returns关键字后即可。

pragma solidity ^0.4.0;
contract Simple {
//定义了一个返回值变量`r`
function outputParameter(uint a, uint b) returns (uint r){
r = a + b;
}
}


上例中，我们定义了一个返回值变量uint r，并在函数内让r = a + b;，从而返回了结果。

return关键字

我们还可以使用return关键字来指定返回的值，使用return时，我们不会用到返回值的变量名称，可以省略。

pragma solidity ^0.4.0;
contract Simple { //使用`return`关键字指定返回值
function output1(uint a, uint b) returns (uint r){
return a + b;
} //省略返回参数的变量名定义
function output2(uint a, uint b) returns (uint){
return a + b;
} /*
function output3(uint a, uint b) returns (uint x, uint mul){
x = a + b;
mul = a * b;
//不能混合使用两种定义方式
//使用`return`时要返回所有定义
//Untitled3:18:9: Error: Different number of arguments in return statement than in returns declaration.
return x;
}
*/ function output4(uint a, uint b) returns (uint mul){
mul = a * b;
//不能混合使用两种定义方式
//使用`return`时要返回所有定义
//Untitled3:18:9: Error: Different number of arguments in return statement than in returns declaration.
return 1;//1
}
}


我们在output1()中使用了return关键字来指定要返回的值；在output2()中我们省略了返回参数的变量名定义；一旦使用了return的定义方式，我们要保证return返回的参数数量要与定义匹配，如output3()所示。从output4()中我们可以看出来，如果同时使用return关键字和变量定义方式，以return为准。

返回多个值

Solidity语言支持在一个函数中返回多个结果。使用return (v0, v1, ... vn);来返回多个值。

pragma solidity ^0.4.0;
contract Simple {
//返回多个值
function returnMul(uint a) returns (uint, uint){
return (a, a + 1);
}
}


上述函数返回了原值，和原值加一后的新值两个结果。

杂项

返回参数会被初始化为0，如果没有被明确的设置值，那么它会一直保持零。

函数的参数和返回值可以在函数体内被用作表达式的一部分。当然他们也可被赋值，由于基本类型是值传递，所以即使变量被修改为新值，也不会影响函数外的调用原值。

pragma solidity ^0.4.0;
contract Simple { function f(uint a) returns (uint){
//修改传入的参数变量，并返回
a = a + 1;
return a;
} function callFun() returns (uint, uint){
uint i = 1;
//传入的参数`i`并没有被改变
uint j = f(i);
return (i, j);//1,2
}
}


我们看到在调用f()时传入了i，并在函数内修改了它的值；但函数f()函数调用完成后，i仍为1。

函数的高级特性

由于Solidity语言本身是一门基于区块链网络的分布式语言。它还支持跨合约函数调用的可见性控制，函数级别货币支付支持，函数级的访问控制等独有特性。我们将在下一节的高级特性中进行进一步的讲解。

关于作者

专注基于以太坊的相关区块链技术，了解以太坊，Solidity，Truffle。
博客：http://me.tryblockchain.org
Solidity中文翻译：http://solidity.tryblockchain.org