合约
代码语言:javascript复制在solidity中的合约可以类比看做java等面向对象语言中的类。合约可以包含状态变量、函数、函数修饰符、事件、错误、结构体、枚举类型等等。
还有一些特殊的合约可以被称作库或者接口
状态变量
代码语言:javascript复制状态变量指的是永久存在区块链合约中的变量。
state variables
代码语言:javascript复制// SPDX-License-Identifier: GPL-3.0
pragma solidity >=0.4.0 <0.9.0;
contract SimpleStorage {
uint storedData; // State variable
// ...
}
函数
代码语言:javascript复制函数是可执行的代码单元。通常定义在合约内部,也可以定义在合约外部。
functions
代码语言:javascript复制// SPDX-License-Identifier: GPL-3.0
pragma solidity >=0.7.1 <0.9.0;
contract SimpleAuction {
function bid() public payable { // Function
// ...
}
}
// Helper function defined outside of a contract
function helper(uint x) pure returns (uint) {
return x * 2;
}
函数修饰器
代码语言:javascript复制用来修饰函数,在函数定义的时候增强或者约束函数的语义。
函数修饰器不支持overload(同名不同参数),但是支持override。
Function Modifiers
代码语言:javascript复制// SPDX-License-Identifier: GPL-3.0
pragma solidity >=0.4.22 <0.9.0;
contract Purchase {
address public seller;
modifier onlySeller() { // Modifier 定义modifier
require(
msg.sender == seller,
"Only seller can call this."
);
_;
}
function abort() public view onlySeller { // Modifier usage 使用modifier
// ...
}
}
事件
代码语言:javascript复制事件是一种供EVM日志机制使用的接口
Evnet
代码语言:javascript复制// SPDX-License-Identifier: GPL-3.0
pragma solidity >=0.4.21 <0.9.0;
contract SimpleAuction {
event HighestBidIncreased(address bidder, uint amount); // Event
function bid() public payable {
// ...
emit HighestBidIncreased(msg.sender, msg.value); // Triggering event
}
}
错误
代码语言:javascript复制有点类似于java中的异常。能够在出现错误的时候提供一种低成本的,更详细的错误描述。
Errors
代码语言:javascript复制// SPDX-License-Identifier: GPL-3.0
pragma solidity ^0.8.4;
/// Not enough funds for transfer. Requested `requested`,
/// but only `available` available.
error NotEnoughFunds(uint requested, uint available);
contract Token {
mapping(address => uint) balances;
function transfer(address to, uint amount) public {
uint balance = balances[msg.sender];
if (balance < amount)
revert NotEnoughFunds(amount, balance);
balances[msg.sender] -= amount;
balances[to] = amount;
// ...
}
}
结构体
代码语言:javascript复制类似于C中的结构体
Struct
代码语言:javascript复制// SPDX-License-Identifier: GPL-3.0
pragma solidity >=0.4.0 <0.9.0;
contract Ballot {
struct Voter { // Struct
uint weight;
bool voted;
address delegate;
uint vote;
}
}
枚举类型
Enum
代码语言:javascript复制// SPDX-License-Identifier: GPL-3.0
pragma solidity >=0.4.0 <0.9.0;
contract Purchase {
enum State { Created, Locked, Inactive } // Enum
}