clear

配列の内容を全消去し、配列用に確保されたメモリをすべて解放します。配列を消去すると、この配列のサイズは 0 になります。配列が不要になったら、clear 関数を使用してメモリを解放します。

int clear(array array)

array は、内容をすべて消去する配列の名前です。

clear 関数は、正常終了した場合は 1 を返し、エラーが発生した場合は 0 を返します。通常、この戻り値をエクスプレッション内で使用することはありません。

例

int $myInts[] = {1,2,3,4,5,6};
print("size of $myInts is: "+size($myInts)+"\n");
clear($myInts);
print("size of $myInts is: "+size($myInts)+"\n");

上記の 3 番目のステートメントによって配列 $myInts の内容が全消去されます。

2 番目と 4 番目のステートメントは、次のテキストをスクリプト エディタ(Script Editor)に表示します。

size of $myInts is: 6
size of $myInts is: 0