SimuEngine V5.0用户手册-API函数.pdf

附录六 API 函数 附录六、API 函数 SimuEngine API API 的 函数是以类的形式调用的， 函数类的声明形式如下： SEAPI TSEApi* __stdcall new_TSEApi ( int simuflow = AutoSimuflow, //流程号，若为AutoSimuFlow ，则自动选择 bool promptWhenNotRun = true, // true SimuEngine 若为 ，则在找不到运行的 时提示 错误 bool exitWhenNotRun = true, // true SimuEngine 若为 ，则在找不到运行的 时终止 运行 bool treatNaNAsZero = true, // true SimuEngine 若为 ，则当从 获取的变量值为非法 时返回 const char* verifyString = NULL //校验字符串 ) ； SEAPI TSEApi* __stdcall new_TSEApiEx ( int simuflow = AutoSimuflow, // 同new_TSEApi bool promptWhenNotRun = true, // 同new_TSEApi bool exitWhenNotRun = true, // 同new_TSEApi const TSEApiArgs* args = NULL, //API 参数，若为NULL ，则取TSEApiArgs 的缺省 值 const char* verifyString = NULL // 同new_TSEApi ) ； struct TSEApiArgs { bool treatNaNAsZero; // true 若为 ，则在以非字符串方式取值时，当变量值 非法时返回 bool treatLogicAndCharAsInt; // true 若为 ，则在以字符串方式取值时，将逻辑和字 符类型的值作为整数返回 int floatPrecision; // ( 以字符串方式取值时，浮点数包括单精度、双精度 ) 以及复数的输出精度 TSEApiArgs() 101 SimuEngine 5.0 用户手册 { treatNaNAsZero = true; treatLogicAndCharAsInt = true; floatPrecision = 7; }; }; 其中当以非字符串方式取值时，两个定义形式是一样的；当以字符串的方式取值时，则 需要用_TSEApiEx 来构建对象。 在应用API 函数时，要先创建一个对象，然后API 功能函数以该对象的成员函数的形 式进行调用。如查询SimuEngine 的流程号，可通过以下方法实