iBands() の使い方・引数・戻り値（MQL4／MQL5）

iBands() とは

ボリンジャーバンド（移動平均線と、その上下に標準偏差の幅で引いた線）を計算する関数です。中心線・上のバンド・下のバンドのどれを取得するかを指定します。

iBands() の書式と引数

MQL4 の場合MT4

double iBands(
   string symbol,
   int timeframe,
   int period,
   double deviation,
   int bands_shift,
   int applied_price,
   int mode,
   int shift
)

戻り値（MQL4）

MQL5 の場合MT5

int iBands(
   string symbol,
   ENUM_TIMEFRAMES period,
   int bands_period,
   int bands_shift,
   double deviation,
   int applied_price
)

戻り値（MQL5）

iBands() の使い方（コード例）

MQL4

double upper = iBands(_Symbol, 0, 20, 2.0, 0, PRICE_CLOSE, MODE_UPPER, 1);
double lower = iBands(_Symbol, 0, 20, 2.0, 0, PRICE_CLOSE, MODE_LOWER, 1);
double c1    = iClose(_Symbol, 0, 1);
if(c1 > upper)      Print("+2σ を上回って確定");
else if(c1 < lower) Print("-2σ を下回って確定");

MQL5

int hBands = INVALID_HANDLE;

int OnInit()
{
   hBands = iBands(_Symbol, PERIOD_CURRENT, 20, 0, 2.0, PRICE_CLOSE);
   return hBands == INVALID_HANDLE ? INIT_FAILED : INIT_SUCCEEDED;
}

void OnTick()
{
   double up[], lo[];
   if(CopyBuffer(hBands, UPPER_BAND, 1, 1, up) < 1 || CopyBuffer(hBands, LOWER_BAND, 1, 1, lo) < 1)
      return;
   double c1 = iClose(_Symbol, PERIOD_CURRENT, 1);
   if(c1 > up[0])      Print("+2σ を上回って確定");
   else if(c1 < lo[0]) Print("-2σ を下回って確定");
}

OnTick()・OnStart() などの関数の中に書いて使う例です。MetaEditor でコンパイルできることを確認済みです。

iBands() の注意点

• MQL5 では値ではなく「ハンドル」（インジケーターの番号）が返ります。ハンドルは OnInit() で1回だけ作り、OnTick() などで CopyBuffer() を使って値を読み出します。毎ティック作り直すと動作が重くなります。
• MQL4 と MQL5 で deviation と bands_shift の順番が逆です。移植するときは引数の順番に注意します。

MQL4 と MQL5 の違い

関連する関数

• CopyBuffer()インジケーターのハンドルから値を配列に読み出す
• iMA()移動平均線（MA）の値を取得する
• iATR()ATR（平均的な値幅）の値を取得する

テクニカル指標の関数一覧

• iMA
• iRSI
• iMACD
• iBands
• iStochastic
• iATR
• iCCI
• iADX
• iMomentum
• iSAR
• iIchimoku
• iCustom
• CopyBuffer
• BarsCalculated
• IndicatorRelease

← MQL関数リファレンスで、ほかの関数を探す