1.6.1 典型Solidity源文件包含的组成部分

Solidity是以太坊创始人之一的Gavin Wood博士发明的以太坊智能合约编程语言,它是一个面向合约的高级语言,其语法类似Javascript,运行在以太坊虚拟机中。
Solidity是静态类型的编程语言,编译期间会检查其数据类型,它支持继承,类和复杂的用户定义类型。
本节我们将会分门别类介绍Solidity语言的各个特性。本章所有内容基于Solidity 0.4.24版本,其参考网址为:https://solidity.readthedocs.io/en/v0.4.24/

1.6.1 典型Solidity源文件包含的组成部分

一个Solidity源文件可以包含任意的智能合约定义,标识符及编译标识。

1.6.1.1 Pragma版本

Solidity源文件可以包含标识符所指定的编译器版本。如果不指定编译器版本,系统可能调用不兼容的编译器来编译源文件,从而产生编译错误。
编译器标识符的使用方式如下:
pragma solidity ^0.4.0;
经过这样定义,系统编译该文件时,就不会调用早于0.4.0和晚于(包括)0.5.0的编译器编译。也可以使用npm定义更复杂的编译选项。

1.6.1.2 导入源文件

1.6.1.2.1 语义及语法

和javascript类似,Solidity可以导入其它源文件。
可以在全局作用域导入其它源文件,比如:
import “filename”;
该语句将在此源文件中包含进”filename”的全部内容。
import * as symbolName from "filename";
上面这条语句创建了新的标识“symbolName”,这个新的标识文件名将包含“filename”的所有内容。
import {symbol1 as alias, symbol2} from "filename";
上面这条语句将把“filename”中的“symbol1”标识为“alias”,“symbol2”标识为“symbol2”。
还有一种用法,可能会更符合多数程序员的习惯:
import "filename" as symbolName;
它等价于 import * as symbolName from "filename";

1.6.1.2.2 路径

在上述定义中“filename”总是被定义为以“/”为分隔符的路径名。“.”表示当前目录,“..”表示当前目录的上一层目录。所有的“filename”定义都会被视为绝对路劲,除非定义以“.”或“..”开头。

1.6.1.2.3 重映射在编译器中的用法

当调用编译器时,不仅可以定义如何找到路径中的第一个目录在哪里,还可以重新映射路径。比如:
github.com/ethereum/dapp-bin/library
可以被重新映射为:
/usr/local/dapp-bin/library
这样编译器就会从“/usr/local/dapp-bin/library”读取文件。如果定义了多个重映射,则包含最长字符的那个会被首先作为重映射。这种用法可用于“回退重映射”(“fallback-remapping”),比如:
“”
可被重新映射为:
“/usr/local/include/solidity”
重映射依赖于源代码的上下文。当同一个库文件有不同的版本时,用户可以利用这个特性定义具体使用哪个版本。我们以Solc和Remix这两个编译器为例看具体的使用方法。
1)solc编译器
Solc是个命令行编译器。在solc中,重映射可作为context:prefix = target的参数。如果所有的重映射参数是文件名,则这些文件都会被编译。这种机制完全后向兼容。
如果用户把github.com/ethereum/dapp-bin/ 克隆到本地/usr/local/dapp-bin,可以使用下列定义:
import "github.com/ethereum/dapp-bin/library/iterable_mapping.sol" as it_mapping;
然后用下列命令进行编译:
solc github.com/ethereum/dapp-bin/=/usr/local/dapp-bin/ source.sol
下面我们看一个更复杂的例子。加入用户要使用的一个模块,这个模块会用到一个很老版本的dapp-in。这个dapp-in的路径为/usr/local/dapp-bin_old,可以用如下命令:
solc module1:github.com/ethereum/dapp-bin/=/usr/local/dapp-bin/ \
module2:github.com/ethereum/dapp-bin/=/usr/local/dapp-bin_old/ \
source.sol
这样module2里面使用的就是老版本的dapp-bin_old,而module1里使用的就是新版本的dapp-in。
2)Remix编译器
Remix能自动把github重映射,自动从github读取文件,用户可以导入迭代映射,如下所示:
import "github.com/ethereum/dapp-bin/library/iterable_mapping.sol" as it_mapping;

1.6.1.3 注释

Solidity支持单行注释“//”和多行注释“/*…*/”。
// 这是单行注释
/*
这是
多行注释
*/
另外,还有一种注释符,称为“natspec”注释,这种注释方式并没有正式地出现在官方文档中。这种方式用三个斜杠表示“///”或“/**…*/”。这种注释方式必须紧跟在函数声明或定义之前。用户可以在注释内描述函数的功能,注释函数的判断条件等。在下例中,我们注释了合约名,两个输入参数和两个返回值。
pragma solidity ^0.4.0;
/** @title Shape calculator. */
contract shapeCalculator {
/** @dev Calculates a rectangle's surface and perimeter.
* @param w Width of the rectangle.
* @param h Height of the rectangle.
* @return s The calculated surface.
* @return p The calculated perimeter.
*/
function rectangle(uint w, uint h) returns (uint s, uint p) {
s = w * h;
p = 2 * (w + h);
}
}