バリアントクラス
概要
Variant is the most important datatype in Godot. A Variant takes up only 24 bytes on 64-bit platforms (20 bytes on 32-bit platforms) and can store almost any engine datatype inside of it. Variants are rarely used to hold information for long periods of time, instead they are used mainly for communication, editing, serialization and generally moving data around.
バリアントは次のことができます:
Store almost any datatype.
多くのバリアント間で操作を実行します (GDScript はバリアントをアトミック/ネイティブデータ型として使用します)。
Be hashed, so it can be compared quickly to other variants.
Be used to convert safely between datatypes.
Be used to abstract calling methods and their arguments (Godot exports all its functions through variants).
呼び出しを延期したり、スレッド間でデータを移動したりするために使用します。
バイナリとしてシリアル化され、ディスクに保存されるか、ネットワーク経由で転送されます。
テキストにシリアル化し、値と編集可能な設定を印刷するために使用します。
エクスポートされたプロパティとして機能し、エディタがユニバーサルに編集できるようにします。
辞書、配列、パーサーなどに使用できます。
基本的に、Variantクラスのおかげで、Godot自体を書くのは、C++には一般的ではない非常に動的な構成体を簡単に作成できるので、ずっと簡単な作業でした。今日はVariantの友達になってください。
注釈
All types within Variant except Nil and Object cannot be null and
must always store a valid value. These types within Variant are therefore
called non-nullable types.
One of the Variant types is Nil which can only store the value null.
Therefore, it is possible for a Variant to contain the value null, even
though all Variant types excluding Nil and Object are non-nullable.
参照
List of variant types
These types are available in Variant:
タイプ(型) |
備考 |
|---|---|
Nil (can only store |
Nullable type |
2D counterpart of AABB |
|
3D counterpart of Rect2 |
|
Nullable type |
|
Containers: Array and Dictionary
Both Array and Dictionary are implemented using variants. A Dictionary can match any datatype used as key to any other datatype. An Array just holds an array of Variants. Of course, a Variant can also hold a Dictionary or an Array inside, making it even more flexible.
Modifications to a container will modify all references to it. A Mutex should be created to lock it if multi-threaded access is desired.