配列を比較 ArrayCompare 関数

関数

配列関数

ArrayCompare 関数

 この関数は、同じ型の 2つの配列を比較した結果を取得します。

 複雑なオブジェクトを含まない単純なタイプまたはカスタム構造の配列を比較できます。文字列、動的配列、クラスなどが混ざる複雑なオブジェクトを含むものは比較できません。

データ型と構成・戻り値

int ArrayCompare(①,②,③,④,⑤);

 戻り値は、
 -1:①が②より小さい場合
  0:①が②と等しい場合
  1:①が②より大きい場合
 -2:エラーが発生する時、または③④⑤の値が配列の範囲外にある場合。

引数 [5]

 ArrayCompare関数は 5個の引数で構成されます。


引数名データ型単位初期値説明
array1[]const void&比較する配列①。比較対象は配列②。
array2[]const void&比較する配列②。比較対象は配列①。
start1int0配列①の開始インデックス。
start2int0配列②の開始インデックス。
countintWHOLE_ARRAYコピーする要素の数。「WHOLE_ARRAY」は配列全体がコピーされます。
※初期値があるものは省略可。但し、省略した引数以降は省略しなければなりません。

使用例

ArrayCompare関数による配列の比較

 比較用配列 1~3の 3つを準備してそれぞれ比較します。1と 3の配列内容は同じです。

コード

// ArrayCompare関数による配列のコピー
#property strict
void OnInit() {

int arr1[3]={11,12,13}; // 比較用配列1
int arr2[3]={21,22,23}; // 比較用配列2
int arr3[3]={11,12,13}; // 比較用配列3

Print("①arr1とarr2を比較:",ArrayCompare(arr1,arr2));
Print("②arr1とarr3を比較:",ArrayCompare(arr1,arr3));
Print("③arr2とarr3を比較:",ArrayCompare(arr2,arr3));
Print("④arr1とarr3を比較:",ArrayCompare(arr1,arr3,4,0));
}

コードをコンパイルして実行する方法はこちらを参考にしてください。(デモ口座でお試しください)

結果

 ④の比較は、比較する配列の位置をずらしており、ずらした位置には数字がないためエラー(-2)になります。

タイトルとURLをコピーしました