EA编程教程大全之数组函数

使用数组的一组函数。

数组的最大维数为四维。

每个维数被索引编为从0 至维度-1。

事实上，第一维数组的50 个，在调用时第一个数组显示为[0], 最后一个数组显示为[49]。

使用这些函数(除那些改变定量和定性的数组外)

能够预定义时间系列

Time[], Open[], High[], Low[], Close[], Volume[]

ArrayBsearch

ArrayCopy

ArrayCopyRates

ArrayCopySeries

ArrayDimension

ArrayGetAsSeries

ArrayInitialize

ArrayIsSeries

ArrayMaximum

ArrayMinimum

ArrayRange

ArrayResize

ArraySetAsSeries

ArraySize

ArraySort

int ArrayBsearch( double array[], double value, void count, void start, void direction)

如果没有发现事件，值会返回到第一个维度的数组或者最近的一个数组。

此函数不能用在字符型或连续数字的数组上(除打开柱的连续数组)。

注解: 双元查找只能够存储数。存储数字数组使用ArraySort() 函数。

参量:

array[] - 需要搜索的数组.

value - 将要搜索的值

count - 搜索的数量，默认搜索所有的数组.

start - 搜索的开始点，默认从头开始.

direction - 搜索的方向:

MODE_ASCEND 顺序搜索,

MODE_DESCEND 倒序搜索.

示例:

datetime daytimes[];

int shift=10,dayshift;

// 全部 Time[] 数组被排列在后面的形式

ArrayCopySeries(daytimes,MODE_TIME,Symbol(),PERIOD_D1);

if(Time[shift]=daytimes[0]) dayshift=0;

else

{

dayshift=ArrayBsearch(daytimes,Time[shift],WHOLE_ARRAY,0,MODE_DESCEND);

if(Period()

}

Print(TimeToStr(Time[shift])," corresponds to ",dayshift," day bar opened at ",

TimeToStr(daytimes[dayshift]));

ArrayCopy

int ArrayCopy( void dest[], object source[], void start_dest, void start_source, void count)

复制一个数组到另外一个数组。 只有double[], int[], datetime[], color[], 和 bool[] 这些类型的数组可以被复制。

返回复制元素总量。

参量:

dest[] - 目标数组 。

source[] - 源数组 。

start_dest - 从目标数组的第几位开始写入，默认为0 。

start_source - 从源数组的第几位开始读取，默认为0 。

count - 读取多少位的数组 。默认值为WHOLE_ARRAY常数。

示例:

double array1[][6];

double array2[10][6];

// 数组2 被相同数据添满

ArrayCopyRates(array1);

ArrayCopy(array2,array1,0,0,60);

// 现在数组2 的前10个柱来自历史(前10个柱包括索引[Bars-1])

ArrayCopy(array2,array1,0,Bars*6-60,60);

// 现在数组2 的后10个柱来自历史(后10个柱包括索引[0])

ArrayCopyRates

int ArrayCopyRates( void dest_array[], void symbol, void timeframe)

复制一段走势图上的数据到一个二维数组，并返回复制柱总量，如果是-1表示失败。数组的第二维只有6个项目分别是:

0 - 时间,

1 - 开盘价格,

2 - 最低价格,

3 - 最高价格,

4 - 收盘价格,

5 - 成交量.

如果数据(货币对名称/不同于当前的时间周期) 拒绝其他图表，这种情况下相应的图表不能够在客户端内打开，数据自然会拒绝服务器。这种情况， 错误 ERR_HISTORY_WILL_UPDATED (4066 - 拒绝刷新历史数据) 将被放置到 last_error 变量中，并且将再次拒绝(查看范例ArrayCopySeries()).

注解:此数组通常用于到DLL函数的通过数据。

对于数据数组内存没有真正的分配，没有真正地执行复制。当数组访问时，将会改变方向。

参量:

dest_array[] - 在二维数组上的双重目标数组。

symbol - 货币对名称

timeframe - 时间周期. 可以是列出时间周期的任意值。

示例:

double array1[][6];

ArrayCopyRates(array1,"EURUSD", PERIOD_H1);

Print("当前柱 ",TimeToStr(array1[0][0]),"开盘价格", array1[0][1]);

ArrayCopySeries

int ArrayCopySeries( void array[], int series_index, void symbol, void timeframe)

复制一个系列的走势图数据到数组上.

对于数据数组内存没有真正的分配，没有真正地执行复制。当数组访问时，将会改变方向。在客户指标内禁止数组作为 数组下标分配。这种情况下，数组被真正复制。

如果数据从不同货币对/时间周期图表复制，数据可能缺乏。这种情况下， 错误 ERR_HISTORY_WILL_UPDATED (4066 - 拒绝刷新历史数据)将被放置到 last_error 变量中，并且在确定的时间周期内将重新尝试复制。

注解: 如果series_index是MODE_TIME, 那么第一个参量必须是日期型的数组

参量:

array[] - 目标第一维数字数组。

series_index - 连续数组识别符。必须是连续数组列表识别符其中的值。

symbol - 当前货币对名称

timeframe - 图表时间周期。可以是 列出时间周期的任意值。

示例:

datetime daytimes[];

int shift=10,dayshift,error;

//---- 此Time[] 数组被排列在后面的命令

ArrayCopySeries(daytimes,MODE_TIME,Symbol(),PERIOD_D1);

error=GetLastError();

if(error==4066)

{

//---- 使两个以上接受只读

for(int i=0;i<2; i++)

{

Sleep(5000);

ArrayCopySeries(daytimes,MODE_TIME,Symbol(),PERIOD_D1);

//---- 检查但前每日柱时间

datetime last_day=daytimes[0];

if(Year()==TimeYear(last_day) && Month()==TimeMonth(last_day) && Day()==TimeDay(last_day)) break;

}

}

if(Time[shift]=daytimes[0]) dayshift=0;

else

{

dayshift=ArrayBsearch(daytimes,Time[shift],WHOLE_ARRAY,0,MODE_DESCEND);

if(Period()

}

Print(TimeToStr(Time[shift])," 相应 ",dayshift," day bar opened at ", TimeToStr(daytimes[dayshift]));

ArrayDimension

int ArrayDimension( object array[])

返回数组的多元维数

参量:

array[] - 将要返回的数组。

示例:

int num_array[10][5];

int dim_size;

dim_size=ArrayDimension(num_array);

// dim_size=2

ArrayGetAsSeries

bool ArrayGetAsSeries( object array[])

返回TRUE，如果数组有组织序列的数组(是否从最后到最开始排序过的)，否则返回FALSE。

参量:

array[] - 需要检查的数组。

示例:

if(ArrayGetAsSeries(array1)==true)

Print("数组1是作为连续指数被编入索引");

else

Print("数组1 正常编入索引(从左到右)");

ArrayInitialize

int ArrayInitialize( void array[], double value)

对数组进行初始化，返回经过初始化的数组项的个数。

注解:在客户指标中的init()函数不建议使用到初始化缓冲，在这种函数自动初始化"空值"将自动分配和缓冲重新分配。

参量:

array[] - 需要初始化的数组。

value - 新的数组项的值 。

示例:

//----初始化所有带有2.1的数组

double myarray[10];

ArrayInitialize(myarray,2.1);

ArrayIsSeries

bool ArrayIsSeries( object array[])

如果检查数组是连续的(Time[],Open[],Close[],High[],Low[], or Volume[]), 返回 TRUE，否则返回FALSE。

参量:

array[] - 需要检查的数组。

示例:

if(ArrayIsSeries(array1)==false)

ArrayInitialize(array1,0);

else

{

Print("连续数组不能被初始化!");

return(-1);

}

ArrayMaximum

int ArrayMaximum( double array[], void count, void start)

找出数组中最大值的定位 。在数组中函数返回最大值位置。

参量:

array[] - 搜索数字数组。

count - 搜索数组中项目的个数。

start - 搜索的开始指数。

示例:

double num_array[15]={4,1,6,3,9,4,1,6,3,9,4,1,6,3,9};

int maxValueIdx=ArrayMaximum(num_array);

Print("最大值 = ", num_array[maxValueIdx]);

ArrayMinimum

int ArrayMinimum( double array[], void count, void start)

找出数组中最小值的定位 。在数组中函数返回最小值位置。

参量:

array[] - 搜索数字数组。

count - 搜索数组中项目的个数。

start - 搜索的开始指数。

示例:

double num_array[15]={4,1,6,3,9,4,1,6,3,9,4,1,6,3,9};

int minValueidx=ArrayMinimum(num_array);

Print("最小值 = ", num_array[minValueIdx]);

ArrayRange

int ArrayRange( object array[], int range_index)

取数组中指定维数中项目的数量。 索引以零为基础，维度的大小要大于最大索引1个点。

参量:

array[] - 需要检查的数组。

range_index - 指定的维数 。

示例:

int dim_size;

double num_array[10,10,10];

dim_size=ArrayRange(num_array, 1);

ArrayResize

int ArrayResize( void array[], int new_size)

设定第一维度的大小。如果成功执行，在重新设定后返回包含的全部个数。如果数组没有重设，返回 -1。

注解:在函数完成执行后，在函数内数组地方水平化并且重设将保留不变。 在函数被重新调用后，一些数组将不同于表明的数组。

参量:

array[] - 需要重设的数组。

new_size - 第一维中数组的新大小 。

示例:

double array1[][4];

int element_count=ArrayResize(array1, 20);

// 新大小 - 80个

ArraySetAsSeries

bool ArraySetAsSeries( void array[], bool set)

设定指数数组为系列数组。如果设置参量值为TRUE，数组将被编入索引。数组0位的值是最后的值。其FALSE值设定一个标准的索引命令。此函数返回先前状态。

参量:

array[] - 需要设置的数组。

set - 索引数组命令。

示例:

double macd_buffer[300];

double signal_buffer[300];

int i,limit=ArraySize(macd_buffer);

ArraySetAsSeries(macd_buffer,true);

for(i=0; i

macd_buffer=iMA(NULL,0,12,0,MODE_EMA,PRICE_CLOSE,i)-iMA(NULL,0,26,0,MODE_EMA,PRICE_CLOSE,i);

for(i=0; i

signal_buffer=iMAOnArray(macd_buffer,limit,9,0,MODE_SMA,i);

ArraySize

int ArraySize( object array[])

返回数组的项目数 。对于第一维数组，用ArraySize函数返回的 ArrayRange(array,0)。

参量:

array[] - 任何类型数组。

示例:

int count=ArraySize(array1);

for(int i=0; i

{

// 一些计算.

}

ArraySort

int ArraySort( void array[], void count, void start, void sort_dir)

对数组进行排序，系列数组不能ArraySort()使用进行排序。

参量:

array[] - 被排列的数组。

count - 对多少个数组项进行排序。

start - 排序的开始点。

sort_dir - 排序方式，

MODE_ASCEND顺序排列，

MODE_DESCEND倒序排列。

示例:

double num_array[5]={4,1,6,3,9};

// 新数组包含值4,1,6,3,9

ArraySort(num_array);

// 被排列新数组1,3,4,6,9

ArraySort(num_array,WHOLE_ARRAY,0,MODE_DESCEND);

// 被排列新数组 9,6,4,3,1