自由DLL接口规范 - 版本历史

John: /* 返回值类型 */

2016-11-14T06:54:14Z

‎返回值类型

John: /* DLL的参数类型 */

2016-11-14T06:51:05Z

‎DLL的参数类型

2016年11月14日 (一) 06:46 John

2016-11-14T06:46:32Z

2016年11月14日 (一) 06:35 John

2016-11-14T06:35:47Z

2016年11月14日 (一) 06:22 John

2016-11-14T06:22:07Z

2016年11月14日 (一) 06:02 John

2016-11-14T06:02:41Z

2016年11月14日 (一) 05:31 John

2016-11-14T05:31:31Z

2016年11月14日 (一) 05:19 John

2016-11-14T05:19:23Z

2016年11月14日 (一) 03:36 John

2016-11-14T03:36:44Z

Coogle: /* DLL的参数类型 */

2014-06-20T07:10:38Z

‎DLL的参数类型

@@ 第32行： / 第32行： @@
 =返回值类型=
-公式中，有些类型的名字与C不同。
+若要在DLL内修改一条序列或者修改整个数组，可以通过传序列参数或数组参数的方法，在DLL里面赋值。DLL 里面都使用 float * 来接收参数。
-其中，float*，有可能是NumericRef，也可能是NumericSeries，还可以是NumericArray 。
-但打算传入单值，并改变值返回，那么用NumericRef，如果打算传入序列那么用NumericSeries，如果传入数组，那么用NumericArray 。
 =自由DLL接口的调用=

@@ 第250行： / 第250行： @@
+  }
-=DLL的参数类型=
+=DLL的参数类型参考=
 {| class="wikitable"
 |-
-!    - !!   单值 !!   序列 !!   数组 !!   引用
+!-    类型  !!   公式 !!   DLL
 |-
-| 数值 || NumericSimple || NumericSeries || NumericArray || NumericRef
+| 数值 || NumericSimple || float, int, char, bool
 |-
-| 字符串 || String || - || StringArray || StringRef
+| 字符串 || LPCWSTR || wchar_t*
 |}
 =无效数据表示=

@@ 第230行： / 第230行： @@
 注意逐根运行模式下，每一根K线都会调用dll，所以通常每次调用只需要赋值比上一根K线新增加的类型，
 例如计算收盘价均值时，每次在BarPos位置填入当根K线的均值即可。由此可见，这种应用下通常需要把
-BarPos(当前是第几根K线)作为参数传入Dll中。
+BarPos(当前是第几根K线)作为参数传入Dll中。返回序列和数组可以参考上面传入序列的公式例子。
-  extern "C" __declspec(dllexport) void WINAPI my_test4(float*pReturn, int nIndex)
+下面一个例子是在图形上输出当前是第几根K线的例子：
-−
- 	pReturn[nIndex-1] = 123;
+ // 公式中的声明与调用
+  extern 'FoxFunc.dll' void test9(NumericSeries, int);
-  extern "C" __declspec(dllexport) void WINAPI my_test5(float*pReturn, int nLen)
+ MyIndi:0;
+  {
-  	for(int i=0;i<nLen;i++)
+  	// 每根都会调用一次，所以每次只需赋值当前根
- 		pReturn[i] = 0;
+ 	pf[n - 1] = n;
+  }
 =DLL的参数类型=

@@ 第161行： / 第161行： @@
   //var2 数组实际大小是5+1
   test4(var1, BarsCount(close), var2, 6);
   // c++ .h 声明
@@ 第173行： / 第172行： @@
 *传入引用的公式例子
 =DLL的返回值=
 新格式DLL可返回单值，序列和数组。单值类型大致分为两种：数值类型和字符串类型，可以通过函数返回值直接返回。
 *返回单值类型的c语言例子
-  //返回整数
-  extern "C" __declspec(dllexport) int WINAPI my_test1()
+ // 公式声明与调用例子
+  {
   	return 1;
+  }
- //返回浮点
+  extern "C" __declspec(dllexport) float __stdcall test7()
-  extern "C" __declspec(dllexport) float WINAPI my_test2()
+  {
-  	return 2.0f;
+  	return 0.5f;
+  }
- //返回字符串
+  extern "C" __declspec(dllexport) wchar_t* __stdcall test8()
-  extern "C" __declspec(dllexport) LPCWSTR WINAPI my_test3()
+  {
-  	return L"TEST STRING";
+  	return L"test string 1";
+  }
-相应的公式调用例子
- #MAINCHART
+*返回序列或数组
- #Run_By_Bar
- extern 'MyDll2.dll' int my_test1();
- extern 'MyDll2.dll' float my_test2();
- extern 'MyDll2.dll' LPCWSTR my_test3();
- k1: my_test1;
- k2: my_test2;
- comment(my_test3);
 若要返回序列或数组，则把需要返回的序列赋值目标当作参数传递给DLL，在DLL内部直接修改已达到赋值。
@@ 第207行： / 第231行： @@
 例如计算收盘价均值时，每次在BarPos位置填入当根K线的均值即可。由此可见，这种应用下通常需要把
 BarPos(当前是第几根K线)作为参数传入Dll中。
-*返回序列和数组的例子
   extern "C" __declspec(dllexport) void WINAPI my_test4(float*pReturn, int nIndex)
+  {
@@ 第253行： / 第277行： @@
   k1:Invalid;
 则k1指标线不会输出

@@ 第116行： / 第116行： @@
+  {
   	size_t l = MultiByteToWideChar(936, 0, lpa, -1, NULL, 0);
-−
   	std::wstring s;
   	s.resize(l - 1);
@@ 第145行： / 第145行： @@
 *传入序列的公式例子
 =DLL的返回值=

@@ 第37行： / 第37行： @@
 但打算传入单值，并改变值返回，那么用NumericRef，如果打算传入序列那么用NumericSeries，如果传入数组，那么用NumericArray 。
-=DLL公式例子=
+=自由DLL接口的调用=
-无参数时的例子：
+*无参数时的例子：
   // 公式里面的声明与调用
@@ 第54行： / 第66行： @@
+  }
-传入单值的公式例子：
+*传入单值的公式例子：
   // 公式里面的声明与调用
@@ 第76行： / 第88行： @@
   extern "C" __declspec(dllexport) void __stdcall test2(int i, float f, bool b, char c)
+  {
-−
+  }
-注意事项：
+*传入字符串的公式例子
-*字符串使用单引号，双引号是另一种格式的引用，不能混用
-*DLL 需要在 .def 文件中 EXPORTS 项添加要调用的函数，否则有可能找不到函数
-*公式中函数名大小写要与DLL中的一致
-// C 代码里的声明
+公式里面的字符串变量是宽字符，编码是GB2312,DLL里面可以使用MultiByteToWideChar/MultiByteToWideChar进行字符转换
- extern "C" __declspec(dllexport) void WINAPI my_ma2(float*, float*, int, int)
-公式里面的声明
-// 公式里面的声明
-  extern 'MyDll2.dll' void  my_ma2(NumericSeries ResultBuffer, NumericSeries DataBuffer, int n, int barpos);
-根据声明的不同，运行模式的不同，同一公式传入DLL的数值可能不同。
+ // 公式里面的声明与调用
-以一句myFunc( close )为例：
+ // c++ .h 函数声明
-如果myfunc的声明是 extern 'myDll' void myFunc( float x );
+ // c++ .cpp 函数实现
+ #include <string>
-则传入的实际是close[0]。
-如果myfunc的声明是 extern 'myDll' void myFunc( NumericSeries x );
+*传入序列的公式例子
-则传入的实际是close的整个序列的起始地址
-=自由DLL接口的调用=
+=DLL的返回值=
 新格式DLL可返回单值，序列和数组。单值类型大致分为两种：数值类型和字符串类型，可以通过函数返回值直接返回。
 *返回单值类型的c语言例子

@@ 第1行： / 第1行： @@
 =简介=
-相比传统DLL接口(飞狐接口），自由DLL接口的特点是放弃了对参数的要求。
+相比传统DLL接口(飞狐接口），自由DLL接口的特点是参数更加灵活，由用户指定传入的参数，参数类型是c/c++的标准数据类型。
-传统DLL必须引入一个CalcInfo的结构化参数，通过它来传入行情数据。
+传统DLL必须引入一个CalcInfo的结构化参数，通过它来传入行情数据，这种设计的好处是用户操心得少一些，因为数据总是有的，不利之处是限制了发挥，难以返回多个序列结果，难以接入没有按接口要求编写的DLL。
-这种设计的好处是用户操心得少一些，因为数据总是有的，不利之处是限制了发挥，难以返回多个序列结果，难以接入没有按接口要求编写的DLL。
+自由DLL接口，不再传入CalcInfo参数，取而代之的是，用户必须自己负责传入所有的数据。获得的回报是，
 .支持任意多的参数。
@@ 第16行： / 第12行： @@
 .更灵活的参数传递。例如，可以根据需要传入地址，也可以传入值。
-.支持逐根的计算。每次只计算一根的值并返回单值。
+.支持逐根的计算。每次只计算一根的值并返回单值。自由DLL只能在逐根模式下运行。
-−
 与传统接口DLL一样，自由接口DLL也必须放置在FmlDLL目录下。
@@ 第25行： / 第20行： @@
 为了让公式系统知道DLL的参数格式，调用前需要使用extern语句进行声明
-  extern 返回值类型 函数名(参数类型 参数,...);
+  extern 返回值类型 函数名(参数类型1, 参数类型2...);
-参数的个数和名称都没有限制
+参数的个数没有限制
 =参数类型=
@@ 第33行： / 第28行： @@
 传入DLL的参数有类型限制，目前支持的C类型包括
 float, double, int,BOOL, LONG, DWORD, float*, LPCWSTR等
-暂不支持double *
+不支持double *
 公式中，有些类型的名字与C不同。
 其中，float*，有可能是NumericRef，也可能是NumericSeries，还可以是NumericArray 。
 但打算传入单值，并改变值返回，那么用NumericRef，如果打算传入序列那么用NumericSeries，如果传入数组，那么用NumericArray 。
 // C 代码里的声明
-  extern "C" __declspec(dllexport) void WINAPI my_ma2(float* pResultBuffer, float* pDataBuffer, int n, int barpos)
+  extern "C" __declspec(dllexport) void WINAPI my_ma2(float*, float*, int, int)
 公式里面的声明
 // 公式里面的声明

@@ 第131行： / 第131行： @@
 | 字符串 || String || - || StringArray || StringRef
 |}
+<br>
-其中，公式中NumericSimpe，在DLL中对应float（64位版本对应double）
+其中，公式中NumericSimpe，在DLL中对应float（64位版本对应double）<br>
 公式中NumericSeries，NumericArray，NumericRef，在DLL中都对应float* (64位版本对应double*)，具体的区别只是数据长度的不同。NumericSeries是随K线增长自动增长的，NumericArray是定长数组，而NumericRef是单值。