table

table(X, [X1], [X2], .....) 或 table(capacity:size, colNames, colTypes)

用法一：将单个或多个向量/矩阵/元组，或多个向量和元组的混合数据形式转换成表。

DolphinDB 支持将元素不等长的普通元组自动识别为列式元组存储；对于元素等长的元组，必须通过 setColumnarTuple! 函数转化为列式元组才能将每个元素按行存储。

用法二：创建一个固定数据类型的空表或初始化的表。

第一种用法中，X, X1, X2 ... 可以是向量、矩阵或元组。

第二种用法中：

• capacity 是正整数，表示建表时系统为该表分配的内存（以记录数为单位）。当记录数超过 capacity 时，系统首先会分配 capacity 1.2~2倍的新的内存空间，然后复制数据到新的内存空间，最后释放原来的内存。对于规模较大的表，此类操作的内存占用会很高。因此，建议创建内存表时预先分配一个合理的 capacity。

• size 是整数，表示该表新建时的行数。若 size =0，创建一个空表。 若 size>0，则建立一个只包含 size 条记录的表，记录初始值如下：

  • BOOL 类型默认值为 false；

  • 数值类型、时间类型、IPADDR、COMPLEX、POINT 的默认值为 0；

  • Literal, INT128 类型的默认值为 NULL。

  注： 如果 colTypes 指定为数组向量， size 必须为0。

• colNames 是一个向量，表示列名。

• colTypes 是一个向量，表示每列的数据类型。可使用表示数据类型的系统保留字或相应的字符串。

第一种用法：

id=`XOM`GS`AAPL
x=102.1 33.4 73.6
table(id, x);

table(`XOM`GS`AAPL as id, 102.1 33.4 73.6 as x);

m=matrix(1 2, 3 4, 5 6);
m;

table(m);

m.rename!(1 2, `a`b`x);
m;

table(m);

x=1..6
y=matrix(11..16, 17..22)
z=(101..106, 201..206)
t=table(x,y,z)
t.rename!(`x`y1`y2`z1`z2);

t;

目前不支持通过建表语句 table(capacity:size, colNames, colTypes) 指定 colTypes 为 ANY 类型，若需要创建包含 ANY 类型的内存表，必须通过用法一使用 ANY 向量来生成表对象。此时的 ANY 对象必须是一个列式元组，即元素类型必须是相同的元组，创建方法为：

id = 1 2 3
val = [[1,2,3], [4,5,6],[7,8,9]]
t = table(id, val)
schema(t)

第二种用法：

table(100:5, `name`id`value, [STRING,INT,DOUBLE]);

table(100:5, `name`id`value, `STRING`INT`DOUBLE);

table(100:1, [`value], [DOUBLE]);