基础数据类型
eos合约开发使用的c++14语言,c++14定义的基本数据类型eos都支持,但eos在c++14基本数据类型基础上定义了新的数据类型。
eos宏N
宏N就是将一个字符串编码为一个uint64_t整数,使用eos标准库中的string_to_name完成编码,string_to_name允许的编码字符串最大长度为13个字符,且字符串中字符限制为.12345abcdefghijklmnopqrstuvwxyz共32个字符。
uint64_t account = N(hello) // account = 7684013976526520320
eos中常用字符串描述的数据在eos内部被转换为uint64_t整数进行运算和存储,这样eos就有了一类特别的基础数据类型,对外表现形式为最大13个限制字符的字符串,内部运算和存储形式为uint64_t整数类型。eos中各种名称类型均属于这类,包括账户名称、权限名称、代币名称、表名称、范围名称、action名称等。
宏N就是将一个字符串编码为一个uint64_t整数,使用eos标准库中的string_to_name完成编码,string_to_name将一个最大长度为13且组成字符仅包含以上32个字符的一个字符串编码为一个uint64_t整数。
eos定的标准数据类型
1. account_name、permission_name、token_name、table_name、scope_name、action_name
account_name、permission_name、token_name、table_name、scope_name、action_name这些类型对外表现形成均为最大13个限制字符的字符串,内部编码为uint64_t类型,在合约开发中经常需要将这类数据类型在不同形式之间转换。
1.1.int基本类型
类型名 | 类型 | 说明 |
account_name | uint64_t | 账号名称 |
permission_name | uint64_t | 权限名称 |
table_name | uint64_t | 表名称 |
time | uint32_t | 时间,单位为秒 |
scope_name | uint64_t | 域名,一般指一个合约 |
action_name | uint64_t | action的名称 |
weight_type | uint16_t | 权限权重值 |
token_name | uint64_t | token名称 |
region_id | uint16_t | block头上的region类型 |
eos标准开发库中没有获取系统时间的接口,也没有c++标准定义的time类型,eos没有获取系统时间的接口并不意味中eos合约开发中不能或者不用处理时间类型,其实很多时候需要处理时间类型的,eos定义了time类型为uint32_t。
1.2.复合基本类型
所有复合基础类型都是两字节对齐。
#define ALIGNED(X) __attribute__ ((aligned (16))) X
这里运用了LLVM集成GNU的关键字__attribute__和方法aligned,功能可以参考ANSI C的pack。比如这里:
struct ALIGNED(checksum256) {
uint8_t hash[32];
};
其实和:
#pragma pack(2)
struct checksum256 {
uint8_t hash[32];
};
作用一致。
类型名 | 类型 | 说明 |
public_key | 34 bytes | 公钥 |
signature | 66 bytes | 签名 |
checksum256 | 256-bit | 256位检验和 |
checksum160 | 160-bit | 160位校验和 |
checksum512 | 512-bit | 512位校验和 |
transaction_id_type | checksum256 | transaction的ID |
block_id_type | checksum256 | block的ID |
1.3.. 扩展类型
CPP在上面基础类型之上扩展了一个"name"的类型
struct name {
account_name value = 0;
}
其本质就是个"account_name"或者说是 "uint64_t"
2. block_timestamp
block头上的时间戳类型。
3. asset结构体
4. db