Object.Clearメソッド

説明

オブジェクトのデフォルトプロパティを初期化します。

初期化

初期化はデフォルトプロパティのデータ型（オブジェクトのValueType）に応じて行われます。（オブジェクト生成時に設定した初期値に戻すことではありません）

例えば、Stringオブジェクトの場合は空文字列に初期化され、Numberオブジェクトの場合は0に初期化されます。

Clearメソッドは操作対象のオブジェクトについて詳細を意識することなく初期化できる点で、デフォルトプロパティへの初期値の代入と異なります。

操作対象がNumberオブジェクトやStringオブジェクトなど初期化すべき値が異なるケースでも、Clearメソッドにより同じ手順で安全に初期化できます。

デフォルトプロパティ

デフォルトプロパティは、多くのクラスでValueプロパティですが、それ以外のプロパティがデフォルトプロパティのクラスもあります。

また、デフォルトプロパティがないクラスもあります。デフォルトプロパティがないクラスではClearメソッドは何も効果はありません。

デフォルトプロパティについては各クラスのドキュメントを参照してください。

配列オブジェクト

配列オブジェクトに対してClearメソッドを実行しても、その各要素オブジェクトには反映されません。配列要素オブジェクトには個別にClearメソッドを実行する必要があります。

呼出形式

obj.Clear( )

戻り値

なし

引数

なし

例外

なし

使用例

Function OnTouch(e) {
    var childArray = GetChildObjects();
    for (var i in childArray) {
        childArray[i].Clear();
    }
}

関連項目

ClearChildメソッド