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

MQL4MQL5 テクニカル指標

iStdDev()

できること: 標準偏差（価格のばらつき）の値を取得する
対応: MQL4・MQL5

iStdDev() とは

指定した期間の価格の標準偏差を計算する関数です。値動きの大きさ（ボラティリティ）の目安になり、ボリンジャーバンドの幅の元になっている値です。

iStdDev() の書式と引数

MQL4 の場合MT4

double iStdDev(
   string symbol,
   int timeframe,
   int ma_period,
   int ma_shift,
   int ma_method,
   int applied_price,
   int shift
)

引数	型	省略時	説明
`symbol`	`string`	必須	銘柄名。チャートの銘柄なら _Symbol（NULL も可）。
`timeframe`	`int`	必須	時間足。0 または PERIOD_CURRENT でチャートの時間足。
`ma_period`	`int`	必須	期間（よく使われるのは 20）。
`ma_shift`	`int`	必須	右にずらす本数。ふつうは 0。
`ma_method`	`int`	必須	平均の種類。MODE_SMA など。
`applied_price`	`int`	必須	計算に使う価格。PRICE_CLOSE など。
`shift`	`int`	必須	値を取得するバーの位置。0 が現在（未確定）のバー、1 が確定したひとつ前のバー。

戻り値（MQL4）

標準偏差（価格の幅）。

MQL5 の場合MT5

int iStdDev(
   string symbol,
   ENUM_TIMEFRAMES period,
   int ma_period,
   int ma_shift,
   ENUM_MA_METHOD ma_method,
   int applied_price
)

引数	型	省略時	説明
`symbol`	`string`	必須	銘柄名。チャートの銘柄なら _Symbol（NULL も可）。
`period`	`ENUM_TIMEFRAMES`	必須	時間足。PERIOD_CURRENT でチャートの時間足。
`ma_period`	`int`	必須	期間（よく使われるのは 20）。
`ma_shift`	`int`	必須	右にずらす本数。ふつうは 0。
`ma_method`	`ENUM_MA_METHOD`	必須	平均の種類。MODE_SMA など。
`applied_price`	`int`	必須	計算に使う価格。PRICE_CLOSE など。

戻り値（MQL5）

インジケーターのハンドル。

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

MQL4

double sd = iStdDev(_Symbol, 0, 20, 0, MODE_SMA, PRICE_CLOSE, 1);
Print("標準偏差：", DoubleToString(sd, _Digits));

MQL5

int h = iStdDev(_Symbol, PERIOD_CURRENT, 20, 0, MODE_SMA, PRICE_CLOSE);
double v[];
if(h != INVALID_HANDLE && CopyBuffer(h, 0, 1, 1, v) == 1)
   Print("標準偏差：", DoubleToString(v[0], _Digits));
IndicatorRelease(h);

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