Strategy of C

MQL4 の関数の中には、失敗した場合、[GetLastError()](https://docs.mql4.com/check/getlasterror) でエラーコードを取得できるものがあります。

しかし、このエラーコードは [Trade Server Return Codes](https://docs.mql4.com/constants/errorswarnings/enum_trade_return_codes) に載ってないものが多く、そのままでは役に立ちません。

そのため、`ErrorDescription()` という標準関数が用意されています公式のサンプルの中でもよく使われています。

2018/10/19 追記


「載ってないものが多く」と書いたのですが、[Runtime Errors](https://docs.mql4.com/constants/errorswarnings/errorcodes) の方には 4000番台のエラーも載っていましたどこかで見た気はしていた。
[Trade Server Return Codes](https://docs.mql4.com/constants/errorswarnings/enum_trade_return_codes) は [Runtime Errors](https://docs.mql4.com/constants/errorswarnings/errorcodes) から若い番号のものを抜粋した表のようです。

[OrderModify()](https://docs.mql4.com/trading/ordermodify) 等は 4000番台のエラーも返すのに、リンクされているドキュメントが不十分というのは不親切だなぁ。




### `ErrorDescription()` の使用方法
まず `stdlib.mqh` を include します。

```mq4
#include <stdlib.mqh>
```

あとは以下のように `GetLastError()` で取得したエラーコードを与えると、対応したエラーメッセージが返されます。

```mq4
if (!OrderModify(ticket, price, stoploss, takeprofit, expiration)) {
    int error = GetLastError();
    printf("OrderModify error \"%s\"(%d)", ErrorDescription(error), error);
}

// 結果
// OrderModify error "invalid ticket"(4108)
```

なお、`GetLastError()` は2度呼ぶと値が変わってしまうので、上記のように変数で一度受けて使用しましょう。

> 参考
>
> [[MQL4] GetLastError() は2度呼んではいけない](https://strategyofc.blogspot.com/2018/10/mql4-getlasterror-2.html)

MQL4 では直前の関数が失敗した場合、[GetLastError()](https://docs.mql4.com/check/getlasterror) を使ってエラーコードを取得することが出来ます。

しかし、この関数を連続して呼び出すと値が変わってしまうので要注意です。


### 2度目は値が0
具体的には以下のように、2度目の呼び出しでは値が 0 になってしまいますなお、4108 は "Invalid Ticket"。

```mq4
if (!OrderModify(ticket, price, stoploss, takeprofit, expiration)) {
    printf("GetLastError1 %d", GetLastError());
    printf("GetLastError2 %d", GetLastError());
}

// 結果
// GetLastError1 4108
// GetLastError2 0
```

こんなあからさまに2度呼ぶことは無いと思うのですが、後述の `ErrorDescription()` を使う場合など、うっかり書いてしまうことはありそうです。


### GetLastError() は必ず変数で受けてから使う
対策としては、エラー発生直後に必ず変数で受けるよう習慣づけるのが一番かと思います。

```mq4
if (!OrderModify(ticket, price, stoploss, takeprofit, expiration)) {
    int error = GetLastError();
    printf("GetLastError1 %d", error);
    printf("GetLastError2 %d", error);
}    

// 結果
// GetLastError1 4108
// GetLastError2 4108
```


### エラーコードをエラーメッセージに変換する方法
このエラーコード、[Trade Server Return Codes](https://docs.mql4.com/constants/errorswarnings/enum_trade_return_codes) に一覧があると思いきや、この表には一部のコードしか載っていません4108 も載っていない。

これではエラーの原因がわからないので、これを文字列に変換する標準ライブラリが用意されています。

> 参考
>
> [[MQL4] GetLastError() で取得したエラーコードをエラーメッセージに変換する方法](https://strategyofc.blogspot.com/2018/10/mql4-getlasterror.html)

2018/10/19 追記


「一部のコードしか載っていません」と書いたのですが、[Runtime Errors](https://docs.mql4.com/constants/errorswarnings/errorcodes) の方には 4000番台のエラーも載っていましたどこかで見た気はしていた。
[Trade Server Return Codes](https://docs.mql4.com/constants/errorswarnings/enum_trade_return_codes) は [Runtime Errors](https://docs.mql4.com/constants/errorswarnings/errorcodes) から若い番号のものを抜粋した表のようです。

[OrderModify()](https://docs.mql4.com/trading/ordermodify) 等は 4000番台のエラーも返すのに、リンクされているドキュメントが不十分というのは不親切だなぁ。

@MetaTrader 4.00 Build 1090

MetaTrader 4 の設定には「チャートの最大バー数」という項目があります。



この設定値が何を意味するのか調べてみました。
と言っても、正式なドキュメントを見つけることができなかったので動作からの推察です。

なお、この値は** MT4 を再起動しないと反映されません**何度も再起動するのが地味に面倒くさい。

`include/Arrays` 以下にはオブジェクトを格納できる [CArrayObj](https://www.mql5.com/en/docs/standardlibrary/datastructures/carrayobj) と [CList](https://www.mql5.com/en/docs/standardlibrary/datastructures/clist) が定義されています。
どちらも大体同じような機能を提供しているのですが、何が違うのか見てみました。

結論から言うと、`CArrayObj` の方は内部で配列を持っているのに対し、`CList` は [CObject](https://www.mql5.com/en/docs/standardlibrary/cobject) の持つリンクリスト機能を使っています。

### CArrayObj
`CArrayObj` は一般的な配列同様に使用できます。
ランダムアクセスする場合などはこちらを使うと良いでしょう。

> 参考
>
> [MQL4 で可変長配列を使用する方法 | Strategy of C](https://strategyofc.blogspot.com/2018/10/mql4.html)

### CList
`CList` は内部にポジションを持っており、`GetNextNode()` のようにイテレーティブな処理をする場合、高速に処理できます。

全要素に対して一気に処理をかけるような処理に向いています。

以下に簡単な例を挙げます。

```mq4
#property strict
 
#include <Object.mqh>
#include <Arrays/List.mqh>
 
class Item : public CObject {
private:
    const int m_value;
 
public:
    Item(int value) : m_value(value) {
    }
 
    virtual ~Item() {
    }
 
    int GetValue() const {
        return m_value;
    }
 
    virtual int Compare(const CObject *node, const int mode=0) const {
        int diff = this.GetValue() - dynamic_cast(node).GetValue();
        return (diff == 0) ? 0 : (diff > 0) ? 1 : -1;
    }
};
 
CList m_item_list;
 
void OnStart()
{
    for (int i = 0; i < 10; i++) {
        int value = (i % 2 == 0) ? i : i + 10;
        m_item_list.Add(new Item(value));
    }    
 
    // 内部ポインタを最初にもどす
    m_item_list.MoveToIndex(0);
    
    Item* item;
    // 「最後まで一気に処理する」みたいなのに向いている
    while ((item = m_item_list.GetNextNode()) != NULL) {
        printf("%d", item.GetValue());
    }
}
```

なお、`CList` も `CArrayObj` と同様、Sort 済みでないと検索が出来ません。
また、`Compare()` の実装によっては検索結果が想定外になることもあるので気をつけてください。

> 参考
>
> [[MQL4] CArrayObj はソート済みじゃないと Search() の結果が -1 になってしまう](https://strategyofc.blogspot.com/2018/10/mql4-carrayobj-search-1.html)

[CArrayObj](https://www.mql5.com/en/docs/standardlibrary/datastructures/carrayobj) の `Insert()` で `Total` 以上の値を指定したらどのようになるかやってみました。

結果は、「どんなに大きな値を指定しても最後に挿入される」でした。
エラーが返ってこない仕様なのでそして、ソースコードも読めるので、そうだろうとは思ってたけど、念の為。

```mq4
    // index 0〜9 の要素を追加
    for (int i = 0; i < 10; i++) {
        int value = (i % 2 == 0) ? i : i + 10;
        m_item_array.Add(new Item(value));
    }    
 
    Item* item = new Item(99);

    // index 99？に挿入
    // 実際は index 10 （最後）に挿入される
    m_item_array.Insert(item, 99);
```

`Item` 等の実装は以下のリンク先に掲載したものと同じです。

> 参考
> 
> [MQL4 で可変長配列を使用する方法 | Strategy of C](https://strategyofc.blogspot.com/2018/10/mql4.html)

[MQL4 で可変長配列を使用する方法](https://strategyofc.blogspot.com/2018/10/mql4.html) に書いたのですが、`Sort()` 済みの [CArrayObj](https://www.mql5.com/en/docs/standardlibrary/datastructures/carrayobj) から `Search()` でインデックスを取得しても正しいインデックスを返さない場合があるので注意が必要です。

具体的な例を以下に挙げます。

[MQL4 で可変長配列を使用する方法](https://strategyofc.blogspot.com/2018/10/mql4.html) で既に書いたのですが、以下のように `CArrayObj::Search()` を呼んでも正しくインデックスが返ってこない時があります。

`Item` 等の定義は [MQL4 で可変長配列を使用する方法](https://strategyofc.blogspot.com/2018/10/mql4.html) を参照してください。

```mq4
    for (int i = 0; i < 10; i++) {
        int value = (i % 2 == 0) ? i : i + 10;
        m_item_array.Add(new Item(value));
    }    

    // 途中に挿入
    Item* item_100 = new Item(100);
    m_item_array.Insert(item_100, 5);
    
    // 今挿入したばかりのオブジェクトを検索する
    int index = m_item_array.Search(item_100);

    printf("index: %d", index);
    
    // 結果
    // index: -1
```

2019/4/12 追記


[CArray](https://www.mql5.com/en/docs/standardlibrary/datastructures/carray) 系クラスの中で使用されているメモリの動的確保について書きました。

[MQL4 で配列用メモリを動的確保する方法 | Strategy of C](https://strategyofc.blogspot.com/2019/04/mql4.html)

場合によっては、こちらを直接使った方が良いかもしれません。



@MetaTrader 4 (Version 4.00 Build 1090)

MQL4 では C++ の [std::vector](http://www.cplusplus.com/reference/vector/vector/) のような動的配列が標準で使用できますBuild 600 で入った変更を受けて作成された模様。

`Include/Arrays/` 以下に定義されており、#include <Arrays/ArrayObj.mqh> のように include するだけで使用可能です。

今回はその中の [CArrayObj](https://www.mql5.com/en/docs/standardlibrary/datastructures/carrayobj) について簡単な使い方を書こうと思いますが、
[CArrayInt](https://www.mql5.com/en/docs/standardlibrary/datastructures/carrayint)、[CArrayChar](https://www.mql5.com/en/docs/standardlibrary/datastructures/carraychar) 等他の class も基本の思想は同じです。

公式のリファレンスを探したのですが、 MQL5 用のものしか見つけられませんでした。
ただ、確認した限り、MQL4 でも同様に使用できるようですMQL5 から逆移植されたものと思われる。

> 参考
>
> [Standard Library / Data Collections - Reference on algorithmic/automated trading language for MetaTrader 5](https://www.mql5.com/en/docs/standardlibrary/datastructures)

なお、完全に動作するソースコードは最後に載せておきます。