1.1 dll简介
动态链接库(Dynamic Link Library或者Dynamic-link library,缩写为DLL),是微软公司在微软视窗操作系统中实现共享函数库概念的一种实作方式。DLL是一个包含可由多个程序同时使用的代码和数据的库,DLL不是可执行文件。简单的说,dll有以下几个优点:
1) 节省内存。同一个软件模块,若是以源代码的形式重用,则会被编译到不同的可执行程序中,同时运行这些exe时这些模块的二进制码会被重复加载到内存中。如果使用dll,则只在内存中加载一次,所有使用该dll的进程会共享此块内存(当然,像dll中的全局变量这种东西是会被每个进程复制一份的)。
2) 不需编译的软件系统升级,若一个软件系统使用了dll,则该dll被改变(函数名不变)时,系统升级只需要更换此dll即可,不需要重新编译整个系统。事实上,很多软件都是以这种方式升级的。例如我们经常玩的星际、魔兽等游戏也是这样进行版本升级的。
3) Dll库可以供多种编程语言使用,例如用c编写的dll可以在vb中调用。这一点上DLL还做得很不够,因此在dll的基础上发明了COM技术,更好的解决了一系列问题。源: http://www.cnblogs.com/marktubu/p/4699140.html
更多关于Dll的学习可以参照以下帖子:http://www.blogjava.net/wxb_nudt/archive/2007/09/11/144371.html
1.2 MT4 自带的dll例子解析
我使用的是MT4的build950版本,其中自带了一个DLLSample,使用的时候需要将 MQL4\Scripts\Examples\DLL\Libraries(或者打开MetaEditor中打开该文件夹)中的DLLSample.dll复制到Libraries文件夹下,才能正确运行,以下是对其中代码的详细解析。
Script目录下有以下四个文件,在Libararies文件夹下还有一个DLLSample.dll:
1.2.1 DLLSample.cpp
该文件已经编译过,可以通过VS或者直接在MetaEditor中打开。
(一)头文件和预编译:
#define WIN32_LEAN_AND_MEAN // 从头文件中除去很少用的部分
#include "stdafx.h" //Standard Application Framework Extensions(标准应用程序框架的扩展)预先编译,
//以后该工程编译时,不再编译这部分头文件,仅仅使用预编译的结果。这样可以加快编译速度,节省时间
#include <windows.h> //windowAPI基础头文件
#include <stdlib.h> //标准库头文件,包含了C/c++常用的函数库
#include <stdio.h> //标准输入输出头文件
(二)预定义 __declspec(dllexport) :
使用__declspec(dllexport)在源代码中定义dll的输出函数,可以减少使用*.def文件的使用。在每个要输出的函数前面加上声明__declspec(dllexport),例如:
__declspec(dllexport) void FuncInDll (void)
其中FuncInDll是自定义的函数名称。在MT4中为了区别,程序先预定义了该部分代码:
#define MT4_EXPFUNC __declspec(dllexport)
(三)品种交易数据信息结构体:
//+------------------------------------------------------------------+
//| 品种交易数据信息结构体 |
//+------------------------------------------------------------------+
#pragma pack(push,1)
struct RateInfo
{
__int64 ctm;
double open;
double low;
double high;
double close;
unsigned __int64 vol_tick;
int spread;
unsigned __int64 vol_real;
};
#pragma pack(pop)
//---
struct MqlStr
{
int len;
char *string;
};
static int CompareMqlStr(const void *left,const void *right);//声明静态函数
其中 #pragma pack(push,1)...#pragma pack(pop)是对齐字节,可以节约结构体的空间,详细可以从http://blog.chinaunix.net/uid-25445243-id-2354324.html中了解。
(四)Dll主函数:
BOOL APIENTRY DllMain(HANDLE hModule,DWORD ul_reason_for_call,LPVOID lpReserved)
{
//---
switch(ul_reason_for_call)
{
case DLL_PROCESS_ATTACH:
case DLL_THREAD_ATTACH:
case DLL_THREAD_DETACH:
case DLL_PROCESS_DETACH:
break;
}
//---
return(TRUE);
}
其中 APIENTRY是windows自带的应用类,主函数的三个输入参量分别是句柄(windows编程中常用的部件的唯一标志参数)、第二个是一个DWORD(win的整型类)的dll状态变量,最后一个是保留未来使用的指针变量。
(五)自定义导出函数:
以下函数是需要从dll中导出,被其他程序加载的函数,具体的结构应为:
__declspec(dllexport) 返回类型 __stdcall 函数名称(输入变量类型 变量名)
{
...
}
__stdcall
由于开头已经预定义了则用MT4_EXPFUNC 代替__declspec(dllexport) ,以下是各个函数的代码说明:
MT4_EXPFUNC int __stdcall GetIntValue(const int ipar)
{
printf("GetIntValue takes %d\n",ipar); //在控制台输出int类型并换行
return(ipar);
}
//+------------------------------------------------------------------+
//| |
//+------------------------------------------------------------------+
MT4_EXPFUNC double __stdcall GetDoubleValue(const double dpar)
{
printf("GetDoubleValue takes %.8lf\n",dpar);//在控制台输出double类型并换行
return(dpar);
}
//+------------------------------------------------------------------+
//| |
//+------------------------------------------------------------------+
MT4_EXPFUNC wchar_t* __stdcall GetStringValue(wchar_t *spar)
{
wprintf(L"GetStringValue takes \"%s\"\n",spar);//在控制台输出宽chart类型并换行
return(spar);
}
额外说明:wchar_t是C/C++的字符数据类型,是一种扩展的字符存储方式,wchar_t类型主要用在国际化程序的实现中,但它不等同于unicode编码。unicode编码的字符一般以wchar_t类型存储。char是8位字符类型,最多只能包含256种字符,许多外文字符集所含的字符数目超过256个,char型无法表示。
/+------------------------------------------------------------------+
//| 获取数组的值,输入参数分别是数组名、数组大小、数组序号 |
//+------------------------------------------------------------------+
MT4_EXPFUNC double __stdcall GetArrayItemValue(const double *arr,const int arraysize,const int nitem)
{
//---安全性检查
if(arr==NULL) //若数组为空
{
printf("GetArrayItemValue: NULL array\n");
return(0.0);
}
if(arraysize<=0)
{
printf("GetArrayItemValue: wrong arraysize (%d)\n", arraysize);
return(0.0);
}
if(nitem<0 || nitem>=arraysize)
{
printf("GetArrayItemValue: wrong item number (%d)\n", nitem);
return(0.0);
}
//---
return(arr[nitem]);
}
//+------------------------------------------------------------------+
//| 设置数组的值 |
//+------------------------------------------------------------------+
MT4_EXPFUNC bool _stdcall SetArrayItemValue(double *arr,const int arraysize,const int nitem,const double value)
{
//---
if(arr==NULL)
{
printf("GetArrayItemValue: NULL array\n");
return(FALSE);
}
if(arraysize<=0)
{
printf("GetArrayItemValue: wrong arraysize (%d)\n", arraysize);
return(FALSE);
}
if(nitem<0 || nitem>=arraysize)
{
printf("GetArrayItemValue: wrong item number (%d)\n", nitem);
return(FALSE);
}
//---
arr[nitem]=value;
return(TRUE);
}
//+------------------------------------------------------------------+
//| 获取结构体中的数据,nrate的值代表了结构体中不同属性 |
//+------------------------------------------------------------------+
MT4_EXPFUNC double __stdcall GetRatesItemValue(const RateInfo* rates,const int rates_total,const int shift,const int nrate)
{
//---
if(rates==NULL)
{
printf("GetRatesItemValue: NULL array\n");
return(0.0);
}
//---
if(rates_total<0)
{
printf("GetRatesItemValue: wrong rates_total number (%d)\n", rates_total);
return(0.0);
}
//---
if(shift<0 || shift>=rates_total)
{
printf("GetRatesItemValue: wrong shift number (%d)\n", shift);
return(0.0);
}
//---
if(nrate<0 || nrate>5)
{
printf("GetRatesItemValue: wrong rate index (%d)\n", nrate);
return(0.0);
}
//---
int nitem=rates_total-1-shift;
switch(nrate)
{
case 0: return double(rates[nitem].ctm);
case 1: return rates[nitem].open;
case 2: return rates[nitem].low;
case 3: return rates[nitem].high;
case 4: return rates[nitem].close;
case 5: return double(rates[nitem].vol_tick);
}
//---
return(0.0);
}
//+------------------------------------------------------------------+
//| 存储mql字符串数组,失败返回-1 |
//+------------------------------------------------------------------+
MT4_EXPFUNC int __stdcall SortStringArray(MqlStr *arr,const int arraysize)
{
//---
if(arr==NULL)
{
printf("SortStringArray: NULL array\n");
return(-1);
}
if(arraysize<=0)
{
printf("SortStringArray: wrong arraysize (%d)\n", arraysize);
return(-1);
}
//---字符串排序
qsort(arr,arraysize,sizeof(MqlStr),CompareMqlStr);
//---
return(arraysize);
}
//+------------------------------------------------------------------+
//| 处理字符串数组,将MqlStr整理成字符串,失败返回-1,成功返回字符串长度 |
//+------------------------------------------------------------------+
MT4_EXPFUNC int __stdcall ProcessStringArray(MqlStr *arr,const int arraysize)
{
int len1,len2;
//---
if(arr==NULL)
{
printf("ProcessStringArray: NULL array\n");
return(-1);
}
if(arraysize<=0)
{
printf("ProcessStringArray: wrong arraysize (%d)\n", arraysize);
return(-1);
}
//---
for(int i=0; i<arraysize-1; i++)
{
if(arr[i].string==NULL) len1=0;
else len1=strlen(arr[i].string);
if(arr[i+1].string==NULL) len2=0;
else len2=strlen(arr[i+1].string);
//--- uninitialized string
if(arr[i+1].string==NULL) continue;
//--- destination string is uninitialized and cannot be allocated within dll
if(arr[i].string==NULL) continue;
//--- memory piece is less than needed and cannot be reallocated within dll
if(arr[i].len<len1+len2) continue;
//--- final processing
strcat(arr[i].string,arr[i+1].string);
}
//---
return(arraysize);
}
//+------------------------------------------------------------------+
//| |
//+------------------------------------------------------------------+
int CompareMqlStr(const void *left,const void *right)
{
MqlStr *leftstr=(MqlStr *)left;
MqlStr *rightstr=(MqlStr *)right;
//---
if(leftstr->string==NULL) return(-1);
if(rightstr->string==NULL) return(1);
//---
return(strcmp(leftstr->string,rightstr->string));
}
//+------------------------------------------------------------------+
其中第110行代码中的qsort()是编译器函数库自带的快速排序函数。使用qsort()排序并用 bsearch()搜索是一个比较常用的组合,使用方便快捷。
qsort 的函数原型是:
void qsort(void*base,size_t num,size_t width,int(__cdecl*compare)(const void*,const void*));
最后一个比较函数的目的是确定是升序排列还是降序排列。其中base是排序的一个集合数组,num是这个数组元素的个数,width是一个元素的大小,comp是一个比较函数。比如:对一个长为1000的数组进行排序时,int a[1000]; 那么base应为a,num应为 1000,width应为 sizeof(int),comp函数随自己的命名。
qsort(a,1000,sizeof(int),comp);
其中comp函数应写为:
上面是由小到大排序,return *(int *)b - *(int *)a; 为由大到小排序。