variable_struct_get()

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

variable_struct_get() †

この関数を使用すると、構造体内の特定の名前付き変数から値を取得できます。 構造体参照と変数の名前を指定して、の値を文字列として取得します（以下のサンプルコードを参照）。 この関数は、変数が保持する値、または名前付き変数が存在しない場合は未定義の値を返します。

重要！

指定の変数が存在しない場合、関数はキーワードundefinedを返し、ゲームが機能しなくなるエラーが発生する可能性があるため、取得できない可能性がある場合は事前にvariable_struct_exists() を使用して存在チェックを行ってください。

構文 †

variable_instance_get(struct_id, name);

struct

構造体

name

取得する変数名(文字列)

戻り値 †

Value

様々なデータ種別。取得できない場合は undefined

例 †

if variable_struct_exists(mystruct, "shields")
{ 
  var ss = variable_struct_get(mystruct, "shields");
} 
else 
{ 
  var ss = -1;
}

上記コードは構造体 "" に変数 ""が存在するかどうかをチェックして、存在する場合は変数 "ss" にその値を入れ、存在しない場合は -1 を設定します