playbook/skills/tsl-api-reference/references/codegen/builtin/system/runtime.md

Builtin - 系统 / 运行时

运行时

setPrecision(number, precision)

从指定精度四舍五入截断小数点位数，返回number的保留小数点Precision位后的值

参数	类型	说明
number	real	实数/实数数组。
precision	integer	整数，目的是为了截取实数后面小数点的位数。

返回：real

示例

return setPrecision(123.4567, 3); // 返回值为保留3位小数点后的实数：123.457。

toStm(v, gtype, stm_type, p_n)

转换成为STM流数据。可以通过stmType参数控制是否转换为新流模式或超大流新流模式，新的stm流占用空间更少，访问效率更高。

参数	类型	说明
v		任意类型数据
gtype	integer	可选参数，图型等特殊类型 ，默认为0
stm_type	integer	可选参数，流模式，0：普通模式；1：新流模式；2：超极大流的紧缩模式；默认为0。其中，超大流模式能处理超大结果集。
p_n	integer	可选参数，精度，默认为-1，全精度

返回：binary

示例

return toStm(array(1, 23, 4, 5, 6, 7,)); // 返回以.stm为后缀名的二进制文件。
// 可选参数的应用
t := rand(4, 5);
s := toStm(t, 0, 1, 2); // 用新流模式，且保留两位小数
return stm(s);
// 返回如下：

toStn(v, n)

转换成为STN字符串。小数位四舍五入，尾数是五就进一。

参数	类型	说明
v	any	任意类型数据
n	integer	整型，保留小数点后的位数，可选参数。只对v是小数时且v的小数数位比N大有效。

返回：string

示例

范例一：

return toStn(12345); // 返回值为字符串：’12345’。

范例二：

return toStn(1.2345, 2); // 返回值为字符串：’1.23’。

exportCsv(data, csv_str, include_index, include_header)

将指定数组Data转换为csv格式字符串并存储在csvStr参数中。仅支持一维及二维数组的转换。和ExportCsvne的区别：在处理浮点数据时，ExportCsv的结果会输出为1E15等格式。

参数	类型	说明
data	array	数组类型，要转换成csv格式字符串的数组。
csv_str	string	字符串类型，转换成功的csv格式字符串（输出值）。
include_index	bool	可选参数，布尔类型。转换结果是否包含数组下标信息。默认为False。
include_header	bool	可选参数，布尔类型。转换结果是否包含字段头部信息。默认为True。

返回：bool

示例

范例01：一维数组转换成csv格式字符串（含大数量级数据）

data := array(1, 2, "3", "A", 9, 1E15);
ret := exportCsv(data, s);
if ret then return s;
else return ret;
// 输出：
// 示例未提供可直接输出的返回表达式。

范例02：二维数组转换成csv格式字符串

data := array((2, 5, 0), (3, 2, 1), (4, 7, 2));
ret := exportCsv(data, s);
if ret then return s;
else return ret;
// 输出：
// 示例未提供可直接输出的返回表达式。

范例03：转换成csv格式字符串，结果包含数组下标信息

data := array("A": (2, 5, 0), "B": (3, 2, 1), "C": (4, 7, 2));
ret := exportCsv(data, s, 1);
if ret then return s;
else return ret;
// 输出：
// 示例未提供可直接输出的返回表达式。

范例04：转换成csv格式字符串，结果不包含字段头部信息

data := array((2, 5, 0), (3, 2, 1), (4, 7, 2));
ret := exportCsv(data, s, 0, 0);
if ret then return s;
else return ret;
// 输出：
// 示例未提供可直接输出的返回表达式。

setProfiler(flag)

设置需要记录的优化信息（当设置了记录优化信息的时候，运行速度可能会比正常运行慢很多）并返回设置前的状态值，如果设置了记录优化信息，在平台运行的模型结束的时候会在终端打开优化信息的窗口，用户也可以调用GetProfilerInfo来手动获得优化信息。

参数	类型	说明
flag		整数，可省略，若省略则仅返回状态值而不设置。设置需要记录的优化信息，由一个四位二进制数组成，即以下几种常见组合说明: 取值 说明

返回：integer

示例

范例01：1+2+4的优化信息返回

setProfiler(7);
a := array();
setSysParam(PN_Stock(), 'SH000001');
for i := 20000101t to 20200721T do
begin
if not spec(isTradeDay(i), 'SH000001') then continue;
echo specDate(close(), i);
end
return 1;
// 结果：times为函数运行的次数，seconds为运行时间，op为指令的优化信息，type为函数类型。

范例02：内置对象的优化信息返回

setProfiler(8);
o := new TStringList();
o.text := "Tinysoft"; // 给对象的属性赋值
o.delimited_text := 'A=abc,B=123,C=abc,F=996,E=abd';
o.add("G=666");
return 1;
// 优化信息如：

randomfrom(avalues)

返回一个随机的数组元素，这个数组是由参数Avalue传递进来的。

参数	类型	说明
avalues	array of any	数组名称，可以是整数数组或实数数组

返回：any

示例

a := array('a', 'b', 'c', 'd', 'e', 'f');
return randomFrom(a);
// 返回值为随机返回A字符串中一个字符：’b’。

getSysParams()

取出所有系统参数的值。

返回：array

Logger_debug(msg)

打印带执行节点的调试信息

参数	类型	说明
msg	string	任意数据类型，如果是字符串原样打印，如果非字符串按tostn打印

返回：any

logger_info(msg)

打印带执行节点的提示信息

参数	类型	说明
msg	string	任意数据类型，如果是字符串原样打印，如果非字符串按tostn打印

返回：any

logger_warning(msg)

打印带执行节点的调试信息

参数	类型	说明
msg	any	任意数据类型，如果是字符串原样打印，如果非字符串按tostn打印

返回：any

logger_info2(p1, p2, p3, pn)

打印带执行节点的提示信息

参数	类型	说明
p1	any	第一个参数的内容
p2	any	第二个参数的内容，可省略
p3	any	第三个参数的内容，可省略
pn	any	第N个参数的内容，可省略

返回：any

sp_UserSysParam2()

用户自定义函数教学范例，获得当前系统参数

返回：string

sp_SetSysParam1()

设置系统参数教学范例，使用缺省系统参数,返回股票.基本信息

返回：any

sp_SetSysParam2()

设置系统参数教学范例，指定系统参数(当前为SH600718),返回股票.基本信息

返回：any

ifThen3(left, right, r1, r2, r3)

比较left与Right大小，若Left大，则返回r1;若相等，返回r2;若Right大，返回r3。

参数	类型	说明
left	real	实数
right	real	实数
r1	expr	表达式
r2	expr	表达式
r3	expr	表达式

返回：expr

示例

return ifThen3(1, 2, '左大', '相等', '右大');
// 返回：’右大’

safeEval(exp)

表达式求值

参数	类型	说明
exp	texpression	表达式类型

返回：any

tsAppServerName()

返回平台设置的名字，如果没有设置，默认是ip:进程路径。

返回：string

示例

return tsAppServerName();
// 结果：192.168.101.26:z:\server\bin\exec64.exe

call(func_name, p1, pn)

根据名称或者函数指针调用指定的函数，后面带的参数将自动送入该函数。

参数	类型	说明
func_name	string|tfunction	如果是字符串，表示函数的名称，也可以是函数类型。
p1	any	整数，参数1
pn	any	整数，参数N。

返回：any

示例

// 采用字符串方式来调用函数
return call("IntTodate", 20140101);
// 返回41640
// 采用函数指针来调用函数
f := ThisFunction(int_to_date);
return call(f, 20140101);
// 返回41640

toXml(v)

转换成为XML字符串。

参数	类型	说明
v	any	任意类型

返回：string

示例

return toXml('this is XML document');
{返回值为字符串：
<?xml version="1.0" encoding="GB2312"?>
<TSXML Copyright="Generated by ShenZhen Tinysoft Corp,Ltd. All rights reserved." TYPE="STRING" VALUE="this is XML document"/>}
// 差异说明
// 仅windows中支持，Linux中暂不支持。

xml(v)

把XML串转换为任意类型。

参数	类型	说明
v	string	字符串，XML串

返回：any

示例

return xml('<?xml version="1.0" encoding="GB2312"?>
<TSXML Copyright="Generated by ShenZhen Tinysoft Corp,Ltd. All rights reserved." type="STRING" VALUE="this is XML document"/>');
// 返回值为字符串：’this is a document’。
// 差异说明
// 仅windows中支持，Linux中暂不支持。

exportCsvne(data, csv_str, include_index, include_header)

将指定数组Data转换为csv格式字符串并存储在csvStr参数中。仅支持一维及二维数组的转换。和ExportCsv的区别：在处理浮点数据时，ExportCsvne的结果不会输出为1E15等格式。

参数	类型	说明
data	array
csv_str	string
include_index
include_header	bool

返回：bool

示例

范例01：一维数组转换成csv格式字符串（含大数量级数据）

data := array(1, 2, "3", "A", 9, 1E15);
ret := exportCsvne(data, s);
if ret then return s;
else return ret;
// 输出：
// 示例未提供可直接输出的返回表达式。

范例02：二维数组转换成csv格式字符串

data := array((2, 5, 0), (3, 2, 1), (4, 7, 2));
ret := exportCsvne(data, s);
if ret then return s;
else return ret;
// 输出：
// 示例未提供可直接输出的返回表达式。

范例03：转换成csv格式字符串，结果包含数组下标信息

data := array("A": (2, 5, 0), "B": (3, 2, 1), "C": (4, 7, 2));
ret := exportCsvne(data, s, 1);
if ret then return s;
else return ret;
// 输出：
// 示例未提供可直接输出的返回表达式。

范例04：转换成csv格式字符串，结果不包含字段头部信息

data := array((2, 5, 0), (3, 2, 1), (4, 7, 2));
ret := exportCsvne(data, s, 0, 0);
if ret then return s;
else return ret;
// 输出：
// 示例未提供可直接输出的返回表达式。

callInArray(func_name, param_content)

根据名称或者函数指针调用指定的函数，将参数放入一个数组中送入该函数，不支持变参。另外，天软的函数指针可以用thisfunction()获得。该函数与call函数功能类似，注意两个函数设置参数的区别。Call函数直接列举，CallInArray函数将调用的函数的参数放在Array中。

参数	类型	说明
func_name	string|tfunction	如果是字符串，表示函数名称，也可以是函数类型。
param_content	array	数组类型，第一个参数放在ParamContent[0]，第二个放在ParamContent[1]以此类推。

返回：any

示例

范例1：根据函数名称调用，第一个参数为函数名称

return callInArray("StrToIntDef", array('1234', 999));
// 返回1234

范例2：调用匿名函数，第一个参数是指向匿名函数的变量

{func1是一个变量，我们将一个函数体赋值给这个变量，变量型函数我们称为匿名函数，匿名函数的语句段放在某个函数体内，调用的时候，需使用call或callinarray函数进行调用。
这个例子中，a是一个变量，当a在func1匿名函数中，并在匿名函数体重修改a，使a := a+10; ，但执行完匿名函数后，a参数的值是不变的，即不支持变参，所以最后返回a为10，b为20。
callinarray在这里执行匿名函数func1时，其参数不需要跟在func1之后。}
a := 10;
func1 := function(a) begin
a := a+10;
return a;
end;
b := callInArray(func1, array(a));
return array(a, b);
// array(10,20)

范例3：根据函数指针调用，第一个参数为函数指针

{thisfunction()函数可获得函数指针；由于调用的是stockzf3，该函数没有参数，因此，callinarray的第二个参数给空数组}
setSysParam(pn_stock(), 'SH000001');
return callInArray(thisfunction(stockzf3), array());

范例04：调用时指定参数传参

function CCC(a, b, c, d); // 展示各参数的值
begin
echo "A:", a, " B:", b, " C:", c, " D:", d;
return b;
end;
// 调用
return callInArray("CCC", array("b": 1, "d": 4));
// 返回：1
// 打印结果：A: <NIL> B: 1 C: <NIL> D: 40
// 解析：callINArray在通过数组传参数时，可以通过指定下标的方式给指定参数进行传参，下标对应函数定义中的变量名。
// 上面示例中，只对参数b与d进行了传参，其它两参数没有进行传值，所以是nil。

doubleVariableExecute(arr, sys_name, time_arr, exp)

计算指定系统参数，指定时间序列下的指标表达式的值

参数	类型	说明
arr	integer	二维数组，设置的系统参数的值
sys_name	integer	字符串，指定的系统参数名
time_arr	integer	二维数组，需要计算的指定时间
exp	texpression	表达式，指标表达式

返回：array

示例

stocks := array(getBk('上证50'));
timer := marketTradeDayQk(20220101T, 20221211T);
return doubleVariableExecute(stocks, pn_Stock(), timer, @close());
// 返回: （部分结果截图）

multipleExecute(exp)

表达式求值

参数	类型	说明
exp	texpression	表达式

返回：array

singleVariableExecute(arr, sys_name, exp)

设置系统变量SysName的值为Arr中的元素，执行表达式exp，将表达式的值放到数组Arr中。

参数	类型	说明
arr	array	数组，
sys_name	string	字符串，指定系统参数名称
exp	texpression	表达式

返回：array

示例

// Arr中存储的是代码，获取2019年3月1日，Arr中所有代码的收盘价
arr := array('SZ000001', 'SZ000002');
return singleVariableExecute(arr, pn_stock(), @close());

safeSetSysParam(systype, value)

设置系统参数。主要是将value的值转化为正确的对应于systype数据类型，再通过setsysparam进行设置setysparam(systype,value)，保证系统参数设置成功。

参数	类型	说明
systype	string	字符串，系统参数名称
value	real	实数或字符串，系统参数值

返回：integer

tsAppServer()

获得当前运行的模型所在的运算服务器的标识。

返回：string

示例

a := rand(10, 10);
return tsAppServer();
// 结果：192.168.101.45:3328(Z:\server\bin5)

dupValue(value)

返回一份value的复制值，一般无需要使用，特别用于不需要变参的函数调用。

参数	类型	说明
value	any	任意类型，被复制的数据

返回：any

示例

// 主函数
function test1();
begin
a := 1;
b := 2;
c := 3;
d := test2(dupValue (a), b, c);
return array(a, b, c, d);
end;
// 返回array(1,20,3,33)
// 被调用函数
function test2(a, b, c);
begin
a := 10;
b := 20;
return a+b+c;
end;
// 由test1执行出来的结果可以知道，a变量，由于使用了dupValue复制值，虽然在子函数test2中改变了其值，但在主函数中的a变量仍然没变。而b变量则发生了改变。

ifThen(avalue, atrue, a_false)

如果Avalue值为真，返回参数Atrue，否则返回参数Afalse

参数	类型	说明
avalue	bool	布尔类型，判定条件
atrue	any	任意类型，Avalue为真返回值
a_false	any	任意类型，Avalue为假返回值

返回：any

示例

a := 1;
b := 2;
return ifThen(a>b, a, b);
// 返回：2。

integer(value)

强制成整数，类型转换，对有些必需要指定类型的函数有用,如format

参数	类型	说明
value	real	实数或整数

返回：integer

示例

return integer(123.456); // 返回值为整型数据：123。

int64(value)

强制成整数，类型转换，对有些必需要指定类型的函数有用,如format

参数	类型	说明
value	real	实数或整数

返回：int64

示例

return int64(123); // 返回值为64位整型数据：123。

real(value)

强制为实数，类型转换，对有些必需要指定类型的函数有用，如format

参数	类型	说明
value	real	实数或整数

返回：real

示例

return real(123); // 返回值为实数数据：123.00

wideString(value)

将字符串转为Unicode字符串，或者强制让二进制为Unicode字符串。

参数	类型	说明
value	string|binary|widestring	字符串或者二进制数据

返回：widestring

示例

return wideString('abcd');
// 返回值为Unicode字符串：L’abcd’。

binary(value)

强制把字符串或者Unicode字符串转化为二进制流，对有些必需要指定类型的函数有用

参数	类型	说明
value	string|binary|widestring	字符串或者二进制数据

返回：binary

示例

return binary('111111'); // 返回值为二进制流。

stn(v)

把STN串转换为任意类型。

参数	类型	说明
v	string	字符串，STN串

返回：any

randomize()

已废弃函数。

返回：any

random()

（参考文档未提供简述。）

返回：real

tslfilename()

获取正在执行的 .tsl 主脚本完整路径。

返回：string

sysgettsllibpath()

获取当前函数库查找路径。

返回：string

错误与断言函数

assert(error)

断言。若Check为假，返回出错信息

参数	类型	说明
error	string	字符串类型

返回：string

示例

return assert(0, '无效的语段');
// 输出：
// 示例包含说明文字，未作为可执行片段运行。

getProfilerInfo(clear)

获得记录的优化信息。

参数	类型	说明
clear	bool	Boolean。

返回：array

示例

范例01：不弹出profiler窗口

setProfiler(7); // 记录TSL源代码函数调用+二进制函数的调用+指令调用的优化信息
a := 99;
b := intToStr(a); // inttostr是函数
a := rand(1000, 1); // rand是指令
a := select * from a where [0]>0.5 end; // select是指令
setSysParam(pn_stock(), "SZ000002");
b := nDay3(100, close()); // nday3也算是指令，不是函数 ,close是函数
return getProfilerInfo(1);
// 输出：
// array(
// ("name":"__main__","times":0,"seconds":0.0,"op":
// (
// ("name":"usercall","times":4,"seconds":4.1E-5),
// ("name":"select","times":1,"seconds":0.0007792),
// ("name":"nday3","times":1,"seconds":6.8E-6),
// ("name":":=","times":6,"seconds":0.0011755),
// ("name":">","times":1000,"seconds":0.000292900000000004),
// ("name":"[","times":1000,"seconds":0.000127500000000002),
// ("name":"rand","times":1,"seconds":0.0002869)),"type":"tsl"),
// ("name":"getProfilerInfo","times":1,"seconds":0.0,"type":"bin"),
// ("name":"intToStr","times":1,"seconds":1.72E-5,"type":"bin"),
// ... 共 14 行输出，已截断。

范例02：弹出profiler窗口

setProfiler(7); // 记录TSL源代码函数调用+二进制函数的调用+指令调用的优化信息
a := 99;
b := intToStr(a); // inttostr是函数
a := rand(1000, 1); // rand是指令
a := select * from a where [0]>0.5 end; // select是指令
setSysParam(pn_stock(), "SZ000002");
b := nDay3(100, close()); // nday3也算是指令，不是函数 ,close是函数
t := getProfilerInfo();
return b;
// 输出：返回程序结果的同时，另外弹出profiler窗口

importCsv(csv_str, data, include_index, include_header, single_arr)

将指定csv格式字符串csvStr转换为数组，并存储在Data参数中。

参数	类型	说明
csv_str	string	字符串类型，csv格式字符串。
data	array	数组类型，转换成功的数组（输出值）。
include_index	bool	可选参数，布尔类型。指定字符串中是否包含数组下标信息。默认为False。
include_header	bool	可选参数，布尔类型。指定字符串中是否包含字段头部信息。默认为True。
single_arr	bool	可选参数，布尔类型。是否转换为一个一维数组。默认为False。

返回：bool

示例

范例01：将指定csv格式字符串转换成二维数组

s := "0,1,2\r\n2,5,0\r\n3,2,1\r\n4,7,2\r\n";
ret := importCsv(s, data);
if ret then return data;
else return ret;
// 输出：
// 示例未提供可直接输出的返回表达式。

范例02：读取本地csv文件，并将其转换成数组

// 本地csv文件内容如下：
filepath := "D:\\test\\csv\\data.csv";
rdo2 readFile(rwRaw(), "", filepath, 0, 1000, s);
ret := importCsv(s, data, 1);
if ret then return data;
else return ret;
// 输出：
// Execute script error at Line:4
// function:__main__:line 4:instruction:usercall: 执行函数 importCsv 出错。
// function:__main__:line 4:instruction:usercall: function execute error

stm(v)

把STM流转换为任意类型。

参数	类型	说明
v	binary	二进制类型，STM流

返回：any

getGlobalCache(name, out_value)

按键读取全局缓存。

参数	类型	说明
name	string	缓存键
out_value	any	输出变量，接收缓存值

返回：any