特殊变量及函数(Special Variables and Functions)
有一些变量和函数存在于全局上下文中。主要用来提供一些区块链当前的信息。
区块和交易的属性(Block And Transaction Properties)
- block.blockhash(uint blockNumber) returns (bytes32),给定区块号的哈希值,只支持最近256个区块,且不包含当前区块。
- block.coinbase (address) 当前块矿工的地址。
- block.difficulty (uint)当前块的难度。
- block.gaslimit (uint)当前块的gaslimit。
- block.number (uint)当前区块的块号。
- block.timestamp (uint)当前块的时间戳。
- msg.data (bytes)完整的调用数据(calldata)。
- msg.gas (uint)当前还剩的gas。
- msg.sender (address)当前调用发起人的地址。
- msg.sig (bytes4)调用数据的前四个字节(函数标识符)。
- msg.value (uint)这个消息所附带的货币量,单位为wei。
- now (uint)当前块的时间戳,等同于block.timestamp
- tx.gasprice (uint) 交易的gas价格。
- tx.origin (address)交易的发送者(完整的调用链)
msg的所有成员值,如msg.sender,msg.value的值可以因为每一次外部函数调用,或库函数调用发生变化(因为msg就是和调用相关的全局变量)。
如果你想在库函数中,用msg.sender实现访问控制,你需要将msg.sender做为参数(就是说不能使用默认的msg.value,因为它可能被更改)。
为了可扩展性的原因,你只能查最近256个块,所有其它的将返回0。
地址相关(Address Related)
-
<address>.balance (uint256)
:Address
的余额,以wei
为单位。 -
<address>.transfer(uint256 amount)
:发送给定数量的
ether
,以wei
为单位,到某个地址。失败时抛出异常。 -
<address>.send(uint256 amount) returns (bool)
:发送给定数量的
ether
,以wei
为单位,到某个地址。失败时返回false
。 -
<address>.call(...) returns (bool)
:发起底层的
call
调用。失败时返回false
。 -
<address>.callcode(...) returns (bool)
:发起底层的
callcode
调用,失败时返回false
。 -
<address>.delegatecall(...) returns (bool)
:发起底层的
delegatecall
调用,失败时返回false
。
使用send
方法需要注意,调用栈深不能超过1024,或gas不足,都将导致发送失败。使用时为了保证你的ether
安全,要始终检查返回结果。当用户取款时,使用transfer
或使用最佳实践的模式。
错误处理
- assert(bool condition):
如果条件不满足,则抛出 - 用于内部错误。 - require(bool condition):
如果条件不满足,则抛出 - 用于输入或外部组件中的错误。 - revert():
中止执行并恢复状态更改
合约相关(Contract Related)
-
this(当前合约的类型)
当前合约的类型,可以显式的转换为Address。
-
selfdestruct(address recipt)
销毁当前合约,并把它所有资金发送到给定的地址。
另外,当前合约里的所有函数均可支持调用,包括当前函数本身。