既刊のオブジェクトポインタの記事では、
直近N件のログだけを保持するリングバッファを、
new/deleteを直接使って自作しました。
ただ、その記事のFAQでは、
「CObjectを継承すればCArrayObjで管理できる」
と予告したまま、実装はしていませんでした。
この記事では、標準ライブラリのCArrayObjクラスを使い、
固定サイズの手動管理を、
可変長の自動管理に書き換える方法を解説します。
・CArrayObjクラスの基本的な使い方
・Add/At/Delete/Total/FreeModeの役割
・既刊リングバッファとの実装の違い
・発注ログをCArrayObjで管理する実際に動くコード
CArrayObjとは何か
まず、この記事が解決する問題を整理します。
既刊記事での「予告止まり」
既刊オブジェクトポインタの記事は、
CObjectという土台クラスの説明で、
CArrayObjの名前だけ紹介して終わっていました。
固定サイズ配列から卒業する
・既刊のリングバッファは配列サイズが固定だった
・CArrayObjは要素数に応じて自動で伸び縮みする
・標準ライブラリのクラスなので#includeするだけで使える
「何個になるか実行中まで分からない」
という場面では、固定サイズの配列より、
CArrayObjの方が書きやすくなります。
CObjectを継承したクラスを作る
CArrayObjが管理できるのは、
CObjectを継承したクラスだけです。
既刊CLogEntryをCObject継承に書き換える
既刊記事で自作したCLogEntryクラスの、
class宣言部分だけを次のように変更します。
class CLogEntry : public CObject
{
public:
datetime time;
string message;
};
継承しても使い方自体は変わらない
メンバー変数へのアクセス方法は、
継承前のCLogEntryと同じです。
主なメンバー関数
公式リファレンス(CArrayObj)によると、継承元はCArrayクラスです。
Add/At/Total(追加・取得・件数)
| 関数 | シグネチャ | 役割 |
|---|---|---|
| Add | bool Add(CObject* element) | 末尾に要素を追加、NULLは追加されない |
| At | CObject* At(int pos) | 指定位置を取得、範囲外はNULLを返す |
| Total | int Total() const | 現在の要素数を返す |
Delete/Clear(削除)
Delete(int pos)は指定位置を1件削除し、
Clear()は全件を削除します。
いずれもFreeModeが有効なら、
要素のメモリも一緒に解放されます。
FreeMode(メモリ管理フラグ)
・FreeMode(true)でDelete/Clear時に要素をdeleteする
・falseの場合は配列から外すだけでdeleteされない
・setter版の正確な仕様・既定値は公式ページに明記が薄い
・そのため必ずコードで明示的に指定する
実際に動くコード全体:発注ログをCArrayObjで管理する
既刊のリングバッファを、
CArrayObjベースの可変長ログに書き換えます。
//+------------------------------------------------------------------+
//| OrderLogCArrayObj.mq5 |
//| Copyright 2026, FX-EA System Project Creator |
//| https://creator.fx-ea-system-project.com/ |
//+------------------------------------------------------------------+
#property strict
#include <Arrays\ArrayObj.mqh>
class CLogEntry : public CObject
{
public:
datetime time;
string message;
CLogEntry(datetime t, string m) : time(t), message(m) {}
};
CArrayObj logEntries;
//+------------------------------------------------------------------+
int OnInit()
{
logEntries.FreeMode(true); //Delete/Clear時にdeleteまで行う
return(INIT_SUCCEEDED);
}
//+------------------------------------------------------------------+
void AddLog(string message)
{
CLogEntry *entry = new CLogEntry(TimeCurrent(), message);
if(!logEntries.Add(entry))
{
Print("ログ追加に失敗したためメモリを解放します");
delete entry;
}
}
//+------------------------------------------------------------------+
void PrintAllLogs()
{
for(int i = 0; i < logEntries.Total(); i++)
{
CLogEntry *entry = logEntries.At(i);
if(entry == NULL)
continue;
PrintFormat("%s: %s", TimeToString(entry.time), entry.message);
}
}
//+------------------------------------------------------------------+
void OnDeinit(const int reason)
{
logEntries.Clear(); //FreeMode(true)のため要素もdeleteされる
}
//+------------------------------------------------------------------+
固定サイズからの変化
既刊のリングバッファは、
配列の添字を自分で計算して上書きしていました。
CArrayObjではAdd()を呼ぶだけで、
要素数が自動的に増えていきます。
Add失敗時の後始末
Add()がfalseを返すのは、
渡したポインタがNULLだった場合などです。
追加されなかったオブジェクトは、
CArrayObj側では管理されないため、
呼び出し側でdeleteして後始末する必要があります。
MetaEditorでの実行手順
実際に動かして挙動を確認する手順です。
- MetaEditorで新規EA「OrderLogCArrayObj」を作成し、上のコードを貼り付ける
- F7キーでコンパイルし、「0 error(s), 0 warning(s)」になることを確認する
- OnTick()等からAddLog(“テスト”)を呼び出すコードを一時的に追加して動作確認する
- PrintAllLogs()を呼び、「エキスパート」タブに記録した内容が表示されるか確認する
よくあるエラーと注意点
実装時につまずきやすい点をまとめます。
FreeMode(true)を忘れるとメモリリークする
FreeModeを指定しないまま、
newしたオブジェクトをCArrayObjに入れ続けると、
Clear()を呼んでも配列から外れるだけで、
メモリは解放されずに残ってしまいます。
At()が範囲外を指定するとNULLが返る
ループの範囲をTotal()より1つ多く回すと、
At()はNULLを返すため、
NULLチェックをせずにメンバーへアクセスすると、
実行時エラーで停止します。
ソートにはCompare()の実装が必要
CArrayObjを継承したクラスを、
内容で並べ替えたい場合は、
CObjectのCompare()メソッドを、
自分のクラスでオーバーライドする必要があります。
よくある質問
CArrayObjについて、よく検索される疑問に回答します。
既刊のリングバッファとどちらを使うべきですか?
保持件数が固定で分かっているなら、
既刊のリングバッファのシンプルさにも利点があります。
件数が実行中まで分からないなら、CArrayObjが向いています。
#includeを忘れるとどうなりますか?
Arrays\ArrayObj.mqhを#includeし忘れると、
CArrayObjという識別子が見つからず、
コンパイルエラーになります。
MQL4でも使えますか?
CArrayObjはMQL5の標準ライブラリに含まれるクラスで、
既刊オブジェクトポインタの記事の通り、
ポインタの概念自体がMQL4には存在しません。
【MQL5】CArrayObjクラスで可変長のオブジェクト配列を管理する方法について解説してみた(オブジェクトポインタの続編):まとめ
CArrayObjは、既刊オブジェクトポインタの記事で、
名前だけ予告して終わっていた標準ライブラリのクラスです。
CObjectを継承したクラスを作り、
FreeMode(true)を明示的に指定すれば、
固定サイズの手動管理から、
可変長の自動管理へ書き換えられます。
くわしい自動化の開示方針は編集方針ページもご覧ください。
コメント