速查表
操作符的优先顺序
以下是按评估顺序列出的操作符优先级。
优先级 |
描述 |
操作符 |
|---|---|---|
1 |
后置自增和自减 |
|
创建类型实例 |
|
|
数组元素 |
|
|
访问成员 |
|
|
函数调用 |
|
|
小括号 |
|
|
2 |
前置自增和自减 |
|
一元运算减 |
|
|
一元操作符 |
|
|
逻辑非 |
|
|
按位非 |
|
|
3 |
乘方 |
|
4 |
乘、除和模运算 |
|
5 |
算术加和减 |
|
6 |
移位操作符 |
|
7 |
按位与 |
|
8 |
按位异或 |
|
9 |
按位或 |
|
10 |
非等操作符 |
|
11 |
等于操作符 |
|
12 |
逻辑与 |
|
13 |
逻辑或 |
|
14 |
三元操作符 |
|
赋值操作符 |
|
|
15 |
逗号 |
|
ABI 编码和解码函数
abi.decode(bytes memory encodedData, (...)) returns (...)： ABI - 对提供的数据进行解码。类型在括号中作为第二个参数给出。 示例：(uint a, uint[2] memory b, bytes memory c) = abi.decode(data, (uint, uint[2], bytes))abi.encode(...) returns (bytes memory)： ABI - 对给定的参数进行编码。abi.encodePacked(...) returns (bytes memory)： 对给定的参数执行 紧密打包。 请注意，这种编码可能是不明确的!abi.encodeWithSelector(bytes4 selector, ...) returns (bytes memory)： ABI - 对给定参数进行编码， 并以给定的函数选择器作为起始的 4 字节数据一起返回abi.encodeCall(function functionPointer, (...)) returns (bytes memory)： 对functionPointer的调用进行ABI编码， 参数在元组中找到。执行全面的类型检查，确保类型与函数签名相符。结果等于abi.encodeWithSelector(functionPointer.selector(..))。abi.encodeWithSignature(string memory signature, ...) returns (bytes memory)： 等价于abi.encodeWithSelector(bytes4(keccak256(bytes(signature))), ...)
bytes 和 string 的成员方法
bytes.concat(...) returns (bytes memory)： 将可变数量的参数连接成一个字节数组。string.concat(...) returns (string memory)： 将可变数量的参数连接成一个字符串数组。
address 的成员方法
<address>.balance(uint256)： 地址类型 的余额，以 Wei 为单位<address>.code(bytes memory)： 在 地址类型 的代码（可以是空的）。<address>.codehash(bytes32)： 地址类型 的代码哈希值。<address payable>.send(uint256 amount) returns (bool)： 向 地址类型 发送给定数量的 Wei，失败时返回false<address payable>.transfer(uint256 amount)： 向 地址类型 发送给定数量的 Wei，失败时会把错误抛出（throw）
区块和交易属性
blockhash(uint blockNumber) returns (bytes32)： 给定区块的哈希值 - 只对最近的256个区块有效block.chainid(uint)： 当前链的IDblock.coinbase(address payable)： 当前区块矿工的地址block.difficulty(uint)： 当前区块的难度值（EVM < Paris）。对于其他EVM版本，它是block.prevrandao的一个废弃的别名，将在下一个重大改变版本中被删除。block.gaslimit(uint)： 当前区块的 gas 上限block.number(uint)： 当前区块的区块号block.prevrandao(uint)： 由信标链提供的随机数（EVM >= Paris）（见 EIP-4399 ）。block.timestamp(uint)： 当前区块的时间戳，自Unix epoch以来的秒数gasleft() returns (uint256)： 剩余gasmsg.data(bytes)： 完整的调用数据msg.sender(address)： 消息发送方（当前调用）msg.sig(bytes4)： Calldata的前四个字节（即函数标识符）。msg.value(uint)： 随消息发送的 wei 的数量tx.gasprice(uint)： 交易的 gas 价格tx.origin(address)： 交易发送方（完整调用链上的原始发送方）
验证和断言
assert(bool condition)： 如果条件为false，则中止执行并恢复状态变化（用于内部错误）。require(bool condition)： 如果条件为false，则中止执行并恢复状态变化（用于错误的输入或外部组件的错误）。require(bool condition, string memory message)： 如果条件为false，则中止执行并恢复状态变化（用于错误的输入或外部组件的错误）。同时提供错误信息。revert()： 中止执行并恢复状态变化revert(string memory message)： 中止执行并恢复状态变化，提供一个解释性的字符串
数学和密码方法
keccak256(bytes memory) returns (bytes32)： 计算输入的Keccak-256哈希值sha256(bytes memory) returns (bytes32)： 计算输入的SHA-256哈希值ripemd160(bytes memory) returns (bytes20)： 计算输入的RIPEMD-160的哈希值ecrecover(bytes32 hash, uint8 v, bytes32 r, bytes32 s) returns (address)： 从椭圆曲线签名中恢复与公钥相关的地址，错误时返回0addmod(uint x, uint y, uint k) returns (uint)： 计算(x + y) % k的值，其中加法的结果即使超过2**256也不会被截取。 从 0.5.0 版本开始会加入对k != 0的 assert（即会在此函数开头执行assert(k != 0);作为参数检查，译者注）。mulmod(uint x, uint y, uint k) returns (uint)： 计算(x * y) % k的值，其中乘法的结果即使超过2**256也不会被截取。 从 0.5.0 版本开始会加入对k != 0的 assert（即会在此函数开头执行assert(k != 0);作为参数检查，译者注）。
合约相关方法
this（当前合约的类型）： 当前合约，可明确转换为address或address payable。super： 继承层次中高一级的合约selfdestruct(address payable recipient)： 销毁当前合约，将其资金发送到给定的地址。
类型相关信息
函数可见性说明符
function myFunction() <visibility specifier> returns (bool) {
return true;
}
public： 内部、外部均可见（参考为存储/状态变量创建 getter function 函数）private： 仅在当前合约内可见external： 仅在外部可见（仅可修饰函数）——就是说，仅可用于消息调用（即使在合约内调用，也只能通过this.func的方式）internal： 仅在内部可见（也就是在当前 Solidity 源代码文件内均可见，不仅限于当前合约内，译者注）
修饰器
pure修饰函数时：不允许修改或访问状态变量。view修饰函数时：不允许修改状态变量。payable修饰函数时：允许从调用中接收以太币。constant修饰状态变量时：不允许赋值（除初始化以外），不会占据存储插槽（storage slot）。immutable修饰状态变量时：允许在构造时分配并在部署时保持不变。存储在代码中。anonymous修饰事件时：不把事件签名作为 topic 存储。indexed修饰事件参数时：将参数作为 topic 存储。virtual修饰函数和修改时：允许在派生合约中改变函数或修改器的行为。override表示该函数、修改器或公共状态变量改变了基类合约中的函数或修改器的行为。