MQL4MQL5 テクニカル指標
iCCI()
- できること
- CCI（商品チャネル指数）の値を取得する
- 対応
- MQL4・MQL5
iCCI() とは
CCI（Commodity Channel Index）を計算する関数です。価格が平均からどれだけ離れているかを表し、±100 を超えたかどうかがよく目安にされます。
iCCI() の書式と引数
MQL4 の場合MT4
double iCCI(
string symbol,
int timeframe,
int period,
int applied_price,
int shift
)| 引数 | 型 | 省略時 | 説明 |
|---|---|---|---|
symbol | string | 必須 | 銘柄名。チャートの銘柄なら _Symbol（NULL も可）。 |
timeframe | int | 必須 | 時間足。0 または PERIOD_CURRENT でチャートの時間足。 |
period | int | 必須 | CCI の期間（よく使われるのは 14 や 20）。 |
applied_price | int | 必須 | 計算に使う価格。PRICE_CLOSE（終値）、PRICE_OPEN、PRICE_HIGH、PRICE_LOW、PRICE_MEDIAN（(高値+安値)/2）、PRICE_TYPICAL など。MQL5 では、別のインジケーターのハンドルを渡して、そのインジケーターの値をもとに計算させることもできます（そのため型は int です）。 |
shift | int | 必須 | 値を取得するバーの位置。0 が現在（未確定）のバー、1 がひとつ前の確定したバー。 |
戻り値（MQL4）
CCI の値。
MQL5 の場合MT5
int iCCI(
string symbol,
ENUM_TIMEFRAMES period,
int ma_period,
int applied_price
)| 引数 | 型 | 省略時 | 説明 |
|---|---|---|---|
symbol | string | 必須 | 銘柄名。チャートの銘柄なら _Symbol（NULL も可）。 |
period | ENUM_TIMEFRAMES | 必須 | 時間足。PERIOD_CURRENT でチャートの時間足。 |
ma_period | int | 必須 | CCI の期間（よく使われるのは 14 や 20）。 |
applied_price | int | 必須 | 計算に使う価格。PRICE_CLOSE（終値）、PRICE_OPEN、PRICE_HIGH、PRICE_LOW、PRICE_MEDIAN（(高値+安値)/2）、PRICE_TYPICAL など。MQL5 では、別のインジケーターのハンドルを渡して、そのインジケーターの値をもとに計算させることもできます（そのため型は int です）。 |
戻り値（MQL5）
インジケーターのハンドル。
iCCI() の使い方（コード例）
MQL4
double cci = iCCI(_Symbol, 0, 14, PRICE_TYPICAL, 1);
if(cci > 100) Print("CCI が +100 超え：", cci);MQL5
int hCci = INVALID_HANDLE;
int OnInit()
{
hCci = iCCI(_Symbol, PERIOD_CURRENT, 14, PRICE_TYPICAL);
return hCci == INVALID_HANDLE ? INIT_FAILED : INIT_SUCCEEDED;
}
void OnTick()
{
double v[];
if(CopyBuffer(hCci, 0, 1, 1, v) == 1 && v[0] > 100)
Print("CCI が +100 超え：", v[0]);
}OnTick()・OnStart() などの関数の中に書いて使う例です。MetaEditor でコンパイルできることを確認済みです。
iCCI() の注意点
- MQL5 では値ではなく「ハンドル」（インジケーターの番号）が返ります。ハンドルは OnInit() で1回だけ作り、OnTick() などで CopyBuffer() を使って値を読み出します。毎ティック作り直すと動作が重くなります。
