variable_instance_get()

組み込み関数 用途別 > 変数操作 > variable_instance_get()

variable_instance_get() †

この関数を使用すると、指定された名前付き変数から値を取得できます。 一意のインスタンスID値（ルームエディターのインスタンスプロパティから取得、または instance_create_layer() を呼び出すと返されます）と、値を文字列として取得する変数の名前を指定します。 この関数は、変数が保持している値を返します。

注意

この関数は主に、インポートされたプロジェクトの互換性スクリプトおよびドラッグ&ドロップアクション用に変換されたコードで使用するためのものです

重要！

取得する変数が存在しない場合、関数はキーワード undefined を返し、ゲームが機能しなくなるエラーが発生する可能性があるため、undefined となる可能性がある場合は、この関数を呼び出す前に variable_instance_exists() を使用してチェックするようにしてください。

構文 †

variable_instance_get(instance_id, name);

instance_id

インスタンスID

name

変数の名前（文字列）

戻り値 †

変数名に対応する値

変数のデータ型 or undefined(変数が存在しない場合)

例 †

if variable_instance_exists(id, "shields")
{
  var ss = variable_instance_get(id, "shields");
}
else
|
  var ss = -1;
}

上記コードは、インスタンス変数 "shields" が存在する場合は、ローカル変数 "ss" にその値を代入し、存在しない場合は "-1" を代入します。