【MQL5】Copy関数について

Copy関数の働き・役割
Copy関数の引数について
Copy関数の戻り値について
Copy関数を使ったサンプルコード
サンプルコードの解説
Copy関数を使ってEAを作る際のアイディア

Copy関数の働き・役割

Copy関数は、既存の行列やベクトルのデータを新しいオブジェクトにコピーするための機能を持つ関数です。この関数を使用すると、元のデータを変更することなく、同じデータを持つ独立したオブジェクトを作成することができます。

例えば、ある計算処理の途中で元のデータを保持しながら別の計算を行いたい場合に、Copy関数を用いて複製を作成します。これにより、元の行列やベクトルをそのまま保持しつつ、複製データを操作できます。

この仕組みは、元のデータを保護しながら計算や変更を行う際に役立ちます。特に、データが重要であり、直接操作することで予期せぬ変更を避けたい場合に有用です。

Copy関数の引数について

Copy関数は、行列またはベクトルをコピーするために使用されます。それぞれ以下のような引数を取ります。

bool matrix::Copy(
  const matrix&  a    // コピーされた行列
  );

行列をコピーする場合
引数にはコピー元の行列を指定します。matrix::Copyの場合、この引数はコピー元となる行列のオブジェクトです。

例:
matrix::Copy(const matrix& a)では、aがコピー元の行列です。

bool vector::Copy(
  const vector&  v    // コピーされたベクトル
  );

ベクトルをコピーする場合
引数にはコピー元のベクトルを指定します。vector::Copyの場合、この引数はコピー元となるベクトルのオブジェクトです。

例:
vector::Copy(const vector& v)では、vがコピー元のベクトルです。

行列またはベクトルのデータをコピー先に渡すために、いずれの場合もコピー元のオブジェクトを引数として渡します。この引数は常に元のオブジェクトを参照する形式で指定されますが、元のデータは変更されません。

Copy関数の戻り値について

Copy関数は、コピーが成功したかどうかを示す論理値（ブール値）を戻り値として返します。

成功した場合はtrueを返します。この場合、コピー先の行列やベクトルは、指定されたコピー元と同じデータを持つ独立したオブジェクトになります。
失敗した場合はfalseを返します。この場合、コピー先にはデータが反映されず、操作は完了しません。

Copy関数の戻り値を利用することで、コピー処理が正常に行われたかどうかを確認し、失敗時に適切なエラーハンドリングを行うことが可能です。

Copy関数を使ったサンプルコード

以下は、Copy関数を使用して行列をコピーする例です。

// スクリプトの開始
void OnStart()
{
    // 行列aを作成します。ここでは単位行列（対角線上が1で他が0の行列）を作成します。
    // matrix::Eye関数を使って、3行4列の単位行列を生成します。
    matrix a = matrix::Eye(3, 4);

    // 空の行列bを作成します。データを持たない初期状態の行列です。
    matrix b;

    // Copy関数を使用して、行列aを行列bにコピーします。
    // 成功すると、行列bには行列aと同じデータが格納されます。
    b.Copy(a);

    // 行列aを別の行列cに直接代入します。
    // この方法では、行列bと同様に行列aの内容をコピーします。
    matrix c = a;

    // エキスパートログに行列bの内容を出力します。
    // Print関数を使用して、"matrix b"というラベルとともに行列のデータを表示します。
    Print("matrix b \n", b);

    // エキスパートログに行列cの内容を出力します。
    // "matrix_c"というラベルを付けて内容を表示します。
    Print("matrix_c \n", c);
}

サンプルコードの解説

行列の生成

matrix::Eye関数は、指定したサイズの単位行列を作成します。この関数では、引数に行数と列数を渡します。例えば、matrix::Eye(3, 4)は3行4列の単位行列を生成します。この行列では、対角線上の要素が1、それ以外は0です。行列の作成は、複雑な計算を始める前の基本的な準備です。

生成された行列は、aという変数に格納されます。aはこのプログラム内でコピーの元となる行列です。

空の行列の作成

変数bはmatrix型として宣言されていますが、初期化されていない空の状態です。このような状態の変数は、後でデータを代入するための準備として使用されます。ここではbがCopy関数によるデータの受け取り先として使用されます。

Copy関数によるコピー

b.Copy(a)は、Copy関数を使用して行列aの内容をbにコピーする操作を示しています。この関数では、元となる行列を引数に指定します。コピー後、bはaと同じデータを持ちますが、aとは独立して操作可能です。

直接代入によるコピー

matrix c = aでは、直接代入によって行列aを行列cにコピーしています。これはCopy関数を使用しない場合の簡略的な方法です。この場合も、cはaと同じデータを持つ独立したオブジェクトとなります。

エキスパートログへの出力

Print関数は、指定した内容をエキスパートログに出力するための関数です。ここでは、ラベル（”matrix b”や”matrix_c”）と行列の内容を同時に出力することで、コードの動作を確認しています。

基本的な文法事項

変数の宣言
matrix a;やmatrix b;のように、変数を使う前に型を指定して宣言します。ここでmatrixは行列を表す型です。
関数呼び出し
matrix::Eye(3, 4)のように、クラスに属する関数を使用する際にはクラス名::関数名の形式を用います。
メソッドの呼び出し
b.Copy(a)のように、オブジェクトに属する関数を使用する際にはオブジェクト名.メソッド名の形式を用います。
コメントアウト
//の後に記述することで、コードに説明を付けることができます。コードの動作を理解しやすくするために非常に重要です。