dllからMQL4へ参照渡しで複数のデータを返す方法は前回確認しました。今回は、dllから文字列を返す方法を確認してみます。
文字列を戻す
dllから複数の戻り値を取得する方法はこちらでやりました。
文字列は数値と違って少し手間がかかるので、別の記事として試してみることにしました。
戻り値で文字列を返す
最初は、関数の戻り値として dll から文字列を受け取る、いちばん簡単な方法を試してみます。
MT4は build 600 以降、MQL4の string が Unicode(UTF-16)になっています。そのため dll 側では、Windowsでは1文字2バイトのワイド文字型 wchar_t を使い、文字列リテラルには L プレフィックス(L”…”)をつけます。
ポイントは、戻り値の型を文字1つ分の wchar_t ではなく、文字列の先頭を指すポインタ const wchar_t* にすることです。
|
1 2 3 4 5 6 7 8 |
// MQL4 string str = FShift07(); // dll const wchar_t* FShift07() { const wchar_t* result = L"Hello world !"; return result; } |
文字列リテラル(L”…”)はプログラムが動いている間ずっとメモリに残っているので、そのアドレスを返しても問題ありません。逆に、関数の中で作ったローカル配列(例:wchar_t buf[64];)のアドレスを返すと、関数を抜けた時点で中身が無効になるのでNGです。
まとめてみると、MQL4側は次のようになります。
MQL4
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 |
... #import "Test_DLLstr.dll" string FShift07(); #import int count=0; int OnInit(){ return(INIT_SUCCEEDED); } void OnDeinit(const int reason){ } //●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●● // OnTick() //●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●● void OnTick(){ // only 1 task if(count==0){ string str = FShift07(); Print("str =" + str); count=1; } } |
dllは Visual Studio 2022 で作成します。プロパティ設定(呼び出し規約 __stdcall、Cコードとしてコンパイル、Release / x86 など)が合っていないと、このコードの通りには動きません(エラーになる)ので注意してください。
dllmain.cpp
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 |
// dllmain.cpp : DLL アプリケーションのエントリ ポイントを定義します。 #include "pch.h" #include <wchar.h> BOOL APIENTRY DllMain( HMODULE hModule, DWORD ul_reason_for_call, LPVOID lpReserved ) { switch (ul_reason_for_call) { case DLL_PROCESS_ATTACH: case DLL_THREAD_ATTACH: case DLL_THREAD_DETACH: case DLL_PROCESS_DETACH: break; } return TRUE; } __declspec(dllexport) const wchar_t* FShift07() { const wchar_t* result = L"Hello world !"; return result; } |
これをストラテジーテスターで実行すると、Hello world ! の文字列が戻ってきているのが分かります。
return で文字列を返す方法は比較的簡単に済みます。ただし、1回の呼び出しで返せるのは文字列1つだけです。
参照渡しで文字列を返す
複数の文字列を返したい場合は参照渡しにします。ただし文字列配列はdllでは使えないので、文字列の引数をいくつか並べる程度になります。
ここで大事なのは、受け皿になる文字列のメモリをMQL4側で確保しておくことです。MQL4の string を dll に渡すと、dll に届くのは文字列の先頭アドレス(ポインタ)だけで、dll側からMQL4の文字列の領域を広げることはできません。string str = “”; のような空の文字列にそのまま書き込むと、確保されていないメモリを上書きしてしまい、MT4が落ちる原因になります。
そこでMQL4側では StringInit で必要な文字数分のバッファを確保し、そのサイズ(StringBufferLen で取得)も一緒に dll に渡します。StringInit(str, 256, 0) のように埋める文字を 0 にすると、256文字分の領域が確保され、中身は空(長さ0)の文字列になります。
dll側では、次の2つの関数を使います。
- wcslen:ワイド文字列の文字数を返します。ワイド文字(2バイト)単位で数え、終端のヌル文字は含みません。それ以外は strlen と同じ動作です。
- wcscpy_s:ワイド文字列をコピーします。2番目の引数はコピー先バッファのサイズ(終端のヌル文字を含む文字数)で、コピー元の文字数ではありません。
wcscpy_s はコピー先が小さすぎるとエラー扱いになり、既定ではプログラム(ここではMT4)ごと強制終了してしまいます。そのため、wcslen で「文字数+1(終端の分)」がバッファに収まるかを先に確認してからコピーします。
dllmain.cpp
|
1 2 3 4 5 6 7 8 9 |
... __declspec(dllexport) void FShift07(wchar_t* s1, int size1, wchar_t* s2, int size2) { const wchar_t* res1 = L"Hello world!"; const wchar_t* res2 = L"2nd Text"; // 受け皿に収まるときだけコピー(+1 は終端のヌル文字の分) if ((int)wcslen(res1) + 1 <= size1) wcscpy_s(s1, size1, res1); if ((int)wcslen(res2) + 1 <= size2) wcscpy_s(s2, size2, res2); } |
MQL4
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 |
... #import "Test_DLLstr.dll" void FShift07(string &parst1, int size1, string &parst2, int size2); #import ... string str1, str2; StringInit(str1, 256, 0); // 256文字分の受け皿を確保 StringInit(str2, 256, 0); FShift07(str1, StringBufferLen(str1), str2, StringBufferLen(str2)); Print("str1 =" + str1); Print("str2 =" + str2); ... |
ストラテジーテスターでは、
Hello world! と 2nd Text の文字列が戻ってきました。
日本語の文字列
漢字などの日本語も、やり方は参照渡しとまったく同じです。MQL4の string も dll の wchar_t も同じ UTF-16 なので、そのままコピーすれば日本語が返ってきます。
setlocale を一緒に呼ぶ例も見かけますが、setlocale が影響するのはマルチバイト文字(char)との変換や printf などの表示です。ワイド文字のままコピーするだけなら必要ありません。
注意したいのはソースファイルの文字コードです。日本語版Windowsの Visual Studio ならそのままで問題ありませんが、L”…” の中の日本語が文字化けする場合は、ソースを UTF-8(BOM付き)で保存するか、コンパイルオプションに /utf-8 を追加します。
dllmain.cpp
|
1 2 3 4 5 6 7 |
... __declspec(dllexport) void FShift07(wchar_t* s1, int size1) { const wchar_t* res = L"外部関数の記述 別のモジュールで定義された外部関数は明示的に記述されるべきです。"; if ((int)wcslen(res) + 1 <= size1) wcscpy_s(s1, size1, res); } |
MQL4
|
1 2 3 4 5 6 7 8 9 10 11 12 |
... #import "Test_DLLstr.dll" void FShift07(string &parst, int size); #import ... string str; StringInit(str, 256, 0); FShift07(str, StringBufferLen(str)); Print("str =" + str); ... |
ストラテジーテスターでは、日本語の文字列が返ってきています。
※ この記事の例はどれも関数名が FShift07 なので、例ごとに dll を作り直して試しています。
まとめ
| 方法 | dll側 | MQL4側 | 向いている場面 |
| 戻り値で返す | const wchar_t* を返す | string を戻り値として宣言 | 決まった文字列を1つ返す |
| 参照渡しで返す | wchar_t* とバッファサイズを受け取り wcscpy_s でコピー | StringInit で受け皿を確保して string & で渡す | 複数の文字列や日本語を返す |
2014年、MT4は build 509 から 600 にアップデートされ、仕様が大幅に変わりました。文字列が Unicode になったのもこのときで、それ以前の char*(ANSI)前提で作られた dll は、そのままでは文字化けしたり正しく動かなくなったりしました。
MetaQuotes はMT4からMT5に移行してほしかったのでしょうけれど、MT4愛用者がMT5に移行せずにとどまっているので、無理くりMT4をMT5に近づけていったのでは、と個人的には思っています。
そのためでしょうか、MQL4もC言語のようなC++のような、中途半端な感じです。
※ 2026年10月:コード例を見直し、戻り値の型、受け皿となるバッファの確保、wcscpy_s に渡すサイズを修正しました。
参考:
関連記事:
- MQL4 dll を Visual Studio で作成
- MQL4 dll から複数の値を戻す方法
- MQL4 dllから文字列を戻す




















