在之前的文章中[1]我們介紹了Solidity語言函數的一些基本語法。下面來繼續介紹作為一個分布式網絡語言所特有的internal
和external
這兩種不同的函數調用方式,以及Solidity提供的對函數調用時的可見性控制語法。
一、 調用方式
Solidity封裝了兩種函數的調用方式internal
和external
。
internal
internal
調用,實現時轉為簡單的EVM跳轉,所以它能直接使用上下文環境中的數據,對于引用傳遞時將會變得非常高效(不用拷貝數據)。
在當前的代碼單元內,如對合約內函數,引入的庫函數,以及父類合約中的函數直接使用即是以internal
方式的調用。我們來看個簡單的例子:
pragma solidity ^0.4.0;
contract Test {
function f(){}
//以`internal`的方式調用
function callInternally(){
f();
}
}
在上述代碼中,callInternally()
以internal
的方式對f()
函數進行了調用。
external
external
調用,實現為合約的外部消息調用。所以在合約初始化時不能external
的方式調用自身函數,因為合約還未初始化完成。下面來看一個以external
方式調用的例子:
pragma solidity ^0.4.0;
contract A{
function f(){}
}
contract B{
//以`external`的方式調用另一合約中的函數
function callExternal(A a){
a.f();
}
}
雖然當前合約A
和B
的代碼放在一起,但部署到網絡上后,它們是兩個完全獨立的合約,它們之間的方法調用是通過消息調用。上述代碼中,在合約B
中的callExternal()
以external
的方式調用了合約A
的f()
。
external
調用時,實際是向目標合約發送一個消息調用。消息中的函數定義部分是一個24字節大小的消息體,20字節為地址,4字節為函數簽名[2]。
this
我們可以在合約的調用函數前加this.
來強制以external
方式的調用。需要注意的是這里的this
的用法與大多數語言的都不一致。
pragma solidity ^0.4.0;
contract A{
function f() internal{}
function callInternally(){
f();
}
//以`external`的方式調用
//f()只能以`internal`的方式調用
//Untitled3:7:9: Error: Member "f" not found or not visible after argument-dependent lookup in contract A
function callExternally(){
//this.f();
}
}
調用方式說明
上面所提到的internal
和external
指的函數調用方式,請不要與后面的函數可見性聲明的external
,public
,internal
,private
弄混。聲明只是意味著這個函數需要使用相對應的調用方式去調用。后續說明中會用以某某方式調用
,來強調是對調用方式的闡述以加以區分。
二、函數的可見性
Solidity為函數提供了四種可見性,external
,public
,internal
,private
。
external
- 聲明為
external
的可以從其它合約或通過Transaction
進行調用,所以聲明為external
的函數是合約對外接口的一部分。 - 不能以
internal
的方式進行調用。 - 有時在接收大的數據數組時性能更好。
pragma solidity ^0.4.5;
contract FuntionTest{
function externalFunc() external{}
function callFunc(){
//以`internal`的方式調用函數報錯
//Error: Undeclared identifier.
//externalFunc();
//以`external`的方式調用函數
this.externalFunc();
}
}
聲明為external
的externalFunc()
只能以external
的方式進行調用,以internal
的方式調用會報Error: Undeclared identifier.
。
public
- 函數默認聲明為
public
。 -
public
的函數既允許以internal
的方式調用,也允許以external
的方式調用。 -
public
的函數由于被外部合約訪問,是合約對外接口的一部分。
pragma solidity ^0.4.5;
contract FuntionTest{
//默認是public函數
function publicFunc(){}
function callFunc(){
//以`internal`的方式調用函數
publicFunc();
//以`external`的方式調用函數
this.publicFunc();
}
}
我們可以看到聲明為public
的publicFunc()
允許兩種調用方式。
internal
- 在當前的合約或繼承的合約中,只允許以
internal
的方式調用。
pragma solidity ^0.4.5;
contract A{
//默認是public函數
function internalFunc() internal{}
function callFunc(){
//以`internal`的方式調用函數
internalFunc();
}
}
contract B is A{
//子合約中調用
function callFunc(){
internalFunc();
}
}
上述例子中聲明為internal
的internalFunc()
在定義合約,和子合約中均只能以internal
的方式可以進行調用。
private
- 只能在當前合約中被訪問(不可在被繼承的合約中訪問)。
- 即使聲明為
private
,仍能被所有人查看到里面的數據。訪問權限只是阻止了其它合約訪問函數或修改數據。
pragma solidity ^0.4.5;
contract A{
//默認是public函數
function privateFunc() private{}
function callFunc(){
//以`internal`的方式調用函數
privateFunc();
}
}
contract B is A{
//不可調用`private`
function callFunc(){
//privateFunc();
}
}
上述例子中,聲明為private
的privateFunc()
只能在定義的合約中以internal
的方式進行調用。
關于作者
專注基于以太坊(Ethereum)的相關區塊鏈(Blockchain)技術,了解以太坊,Solidity,Truffle,web3.js。
-
鏈接中的?函數的傳輸的數據?部分了解更多 http://me.tryblockchain.org/Solidity-call-callcode-delegatecall.html ?