BCR学院

用于获取货币对及其时间段内价格数据的一组函数，在BCR外汇交易中应用广泛。

如果请求的数据（货币对名称或时段不同于当前图表）来自其他图表，可能出现该图表未在客户端内打开，需要从服务器端下载数据的情况。此时，错误信息ERR_HISTORY_WILL_UPDATED（4066-请求的历史数据正在更新中）将被记录在last_error变量中，用户需要重新发起请求以更新数据（可参阅ArrayCopySeries()范例）。

在测试中，同一货币对的价格数据或不同时段的价格数据会被精确模拟（成交量除外）。其他时段的成交量不会被模拟，其他货币对的价格数据同样也不会被模拟。无论何种情况，一个时段内的柱子总数会被精确模拟。

iBars() – 获取柱体数量

iBarShift() – 搜索指定柱体

iClose() – 获取柱体收盘价

iHigh() – 获取柱体最高价

iHighest() – 柱体最高值偏移量

iLow() – 获取柱体最低价

iLowest() – 柱体最低值偏移量

iOpen() – 获取柱体开盘价

iTime() – 获取柱体开盘时间

iVolume() – 获取柱体成交量

iBars() – 获取柱体数量

int iBars(string symbol, int timeframe) 返回指定图表中柱体（K线）的数量，适用于BCR外汇平台的技术分析。

对于当前图表，柱体数量的信息保存在预定义的变量Bars中。

参数：

symbol - 要计算指标数据的货币对名称。NULL表示当前货币对。timeframe - 时间周期。可以是时间周期列举中的任意值。0表示当前图表的时间周期。示例：

Print("'EURUSD'在PERIOD_H1时段的柱数:",iBars("EUROUSD",PERIOD_H1)); iBarShift() – 搜索指定柱体

int iBarShift(string symbol, int timeframe, datetime time, void exact) 根据开盘时间搜索柱体（K线）。此函数返回带有指定开盘时间的柱体。如果指定开盘时间的柱体丢失，函数将返回-1或最近的柱体，具体取决于exact参数设置。

参数：

symbol - 要计算指标数据的货币对名称。NULL表示当前货币对。timeframe - 时间周期。可以是时间周期列举中的任意值。0表示当前图表的时间周期。time - 柱体（K线）的开盘时间。exact - 未发现柱子的返回模式。false返回最近的柱子，true返回-1。示例：

datetime some_time=D'2004.03.21 12:00'; int shift=iBarShift("EUROUSD",PERIOD_M1,some_time); Print("带有打开时间的柱体 ",TimeToStr(some_time)," 是 ",shift);iClose() – 获取柱体收盘价

double iClose(string symbol, int timeframe, int shift) 返回指定时段和偏移量的货币对柱体（K线）的收盘价。如果本地历史表为空（历史数据未加载），函数返回0。

对于当前图表，收盘价的信息保存在预定义数组Close[]中。

参数：

symbol - 要计算指标数据的货币对名称。NULL表示当前货币对。timeframe - 时间周期。可以是时间周期列举中的任意值。0表示当前图表的时间周期。shift - 从指标缓冲区中获取值的索引（相对当前柱子向前移动一定数量周期的偏移量）。示例：

Print("对于 USDCHF H1当前柱: ",iTime("USDCHF",PERIOD_H1,i),", ", iOpen("USDCHF",PERIOD_H1,i),", ", iHigh("USDCHF",PERIOD_H1,i),", ", iLow("USDCHF",PERIOD_H1,i),", ", iClose("USDCHF",PERIOD_H1,i),", ", iVolume("USDCHF",PERIOD_H1,i));iHigh() – 获取柱体最高价

double iHigh(string symbol, int timeframe, int shift) 返回指定时段和偏移量的货币对柱体（K线）的最高价。如果本地历史表为空（历史数据未加载），函数返回0。

对于当前图表，最高价的信息保存在预定义数组High[]中。

参数：

symbol - 要计算指标数据的货币对名称。NULL表示当前货币对。timeframe - 时间周期。可以是时间周期列举中的任意值。0表示当前图表的时间周期。shift - 从指标缓冲区中获取值的索引（相对当前柱子向前移动一定数量周期的偏移量）。示例：

Print("对于 USDCHF H1当前柱: ",iTime("USDCHF",PERIOD_H1,i),", ", iOpen("USDCHF",PERIOD_H1,i),", ", iHigh("USDCHF",PERIOD_H1,i),", ", iLow("USDCHF",PERIOD_H1,i),", ", iClose("USDCHF",PERIOD_H1,i),", ", iVolume("USDCHF",PERIOD_H1,i));iHighest() – 柱体最高值偏移量

int iHighest(string symbol, int timeframe, int type, void count, void start) 根据类型返回指定时间周期内最大值的偏移量。

参数：

symbol - 要计算指标数据的货币对名称。NULL表示当前货币对。timeframe - 时间周期。可以是时间周期列举中的任意值。0表示当前图表的时间周期。type - 序列数组的识别符。它可以是序列数据识别符枚举中的任意值。count - 要计算的周期数（沿着开头柱子到后面柱子的方向）。start - 开始柱子，相对于当前柱子，开始采集数据的柱子。示例：

double val; // 在20个连续柱子范围内计算最大值 // 在当前图表上从第4个至第23个的索引 val=High[iHighest(NULL,0,MODE_HIGH,20,4)];iLow() – 获取柱体最低价

double iLow(string symbol, int timeframe, int shift) 返回指定时段和偏移量的货币对柱体（K线）的最低价。如果本地历史表为空（历史数据未加载），函数返回0。

对于当前图表，最低价的信息保存在预定义数组Low[]中。

参数：

symbol - 要计算指标数据的货币对名称。NULL表示当前货币对。timeframe - 时间周期。可以是时间周期列举中的任意值。0表示当前图表的时间周期。shift - 从指标缓冲区中获取值的索引（相对当前柱子向前移动一定数量周期的偏移量）。示例：

Print("对于 USDCHF H1当前柱: ",iTime("USDCHF",PERIOD_H1,i),", ", iOpen("USDCHF",PERIOD_H1,i),", ", iHigh("USDCHF",PERIOD_H1,i),", ", iLow("USDCHF",PERIOD_H1,i),", ", iClose("USDCHF",PERIOD_H1,i),", ", iVolume("USDCHF",PERIOD_H1,i));iLowest() – 柱体最低值偏移量

int iLowest(string symbol, int timeframe, int type, void count, void start) 根据类型返回指定时间周期内最低值的偏移量。

参数：

symbol - 要计算指标数据的货币对名称。NULL表示当前货币对。timeframe - 时间周期。可以是时间周期列举中的任意值。0表示当前图表的时间周期。type - 序列数组的识别符。它可以是序列数据识别符枚举中的任意值。count - 要计算的周期数（沿着开头柱子到后面柱子的方向）。start - 开始柱子，相对于当前柱子，开始采集数据的柱子。示例：

double val; // 在20个连续柱子范围内计算最小值 // 在当前图表上从第4个至第23个的索引 val=Low[iLowest(NULL,0,MODE_LOW,20,4)];iOpen() – 获取柱体开盘价

double iOpen(string symbol, int timeframe, int shift) 返回指定时段和偏移量的货币对柱体（K线）的开盘价。如果本地历史表为空（历史数据未加载），函数返回0。

对于当前图表，开盘价的信息保存在预定义数组Open[]中。

参数：

symbol - 要计算指标数据的货币对名称。NULL表示当前货币对。timeframe - 时间周期。可以是时间周期列举中的任意值。0表示当前图表的时间周期。shift - 从指标缓冲区中获取值的索引（相对当前柱子向前移动一定数量周期的偏移量）。示例：

Print("对于 USDCHF H1当前柱: ",iTime("USDCHF",PERIOD_H1,i),", ", iOpen("USDCHF",PERIOD_H1,i),", ", iHigh("USDCHF",PERIOD_H1,i),", ", iLow("USDCHF",PERIOD_H1,i),", ", iClose("USDCHF",PERIOD_H1,i),", ", iVolume("USDCHF",PERIOD_H1,i));iTime() – 获取柱体开盘时间

datetime iTime(string symbol, int timeframe, int shift) 返回指定时段和偏移量的货币对柱体（K线）的开盘时间。如果本地历史表为空（历史数据未加载），函数返回0。

对于当前图表，开盘时间的信息保存在预定义数组Time[]中。

参数：

symbol - 要计算指标数据的货币对名称。NULL表示当前货币对。timeframe - 时间周期。可以是时间周期列举中的任意值。0表示当前图表的时间周期。shift - 从指标缓冲区中获取值的索引（相对当前柱子向前移动一定数量周期的偏移量）。示例：

Print("对于 USDCHF H1当前柱: ",iTime("USDCHF",PERIOD_H1,i),", ", iOpen("USDCHF",PERIOD_H1,i),", ", iHigh("USDCHF",PERIOD_H1,i),", ", iLow("USDCHF",PERIOD_H1,i),", ", iClose("USDCHF",PERIOD_H1,i),", ", iVolume("USDCHF",PERIOD_H1,i));iVolume() – 获取柱体成交量

datetime iVolume(string symbol, int timeframe, int shift) 返回指定时段和偏移量的货币对柱体（K线）的成交量。如果本地历史表为空（历史数据未加载），函数返回0。

对于当前图表，成交量的信息保存在预定义数组Volume[]中。

注：该成交量并非真正意义上的成交量，它是一个估计值，表示该K线下tick价格变动的数量。如果tick价格变动很快，意味着成交量较大；如果tick价格变动较慢，则成交量较小。在BCR外汇分析中，这一数据可作为辅助参考。

参数：

symbol - 要计算指标数据的货币对名称。NULL表示当前货币对。timeframe - 时间周期。可以是时间周期列举中的任意值。0表示当前图表的时间周期。shift - 从指标缓冲区中获取值的索引（相对当前柱子向前移动一定数量周期的偏移量）。示例：

Print("对于 USDCHF H1当前柱: ",iTime("USDCHF",PERIOD_H1,i),", ", iOpen("USDCHF",PERIOD_H1,i),", ", iHigh("USDCHF",PERIOD_H1,i),", ", iLow("USDCHF",PERIOD_H1,i),", ", iClose("USDCHF",PERIOD_H1,i),", ", iVolume("USDCHF",PERIOD_H1,i));