Classe Variant

Informazioni su Godot

Variant è il tipo di dati più importante in Godot. Un Variant occupa solo 24 byte sulle piattaforme a 64 bit (20 byte sulle piattaforme a 32 bit) e può contenere quasi tutti i tipi di dati del motore al suo interno. I Variant sono raramente utilizzati per conservare informazioni per lunghi periodi di tempo, ma sono utilizzati principalmente per la comunicazione, la modifica, la serializzazione e, in generale, lo spostamento dei dati.

Un Variant può:

  • Memorizzare quasi qualunque tipo di dati.

  • Eseguire operazioni tra molte varianti (GDScript utilizza Variant come tipo di dati atomico/nativo).

  • Be hashed, so it can be compared quickly to other variants.

  • Essere utilizzato per convertire in modo sicuro tra diversi tipi di dati.

  • Be used to abstract calling methods and their arguments (Godot exports all its functions through variants).

  • Essere utilizzato per rimandare le chiamate o spostare dati tra thread.

  • Essere serializzato come binario e memorizzato su disco, oppure trasferito tramite rete.

  • Essere serializzato in testo e utilizzato per stampare valori e impostazioni modificabili.

  • Funzionare come una proprietà esportata, affinché l'editor possa modificarla universalmente.

  • Essere utilizzata per dizionari, array, parser, ecc.

Basically, thanks to the Variant class, writing Godot itself was a much, much easier task, as it allows for highly dynamic constructs not common of C++ with little effort. Become a friend of Variant today.

Nota

Tutti i tipi in Variant, ad eccezione di Nil e Object, non possono essere null e devono sempre memorizzare un valore valido. Questi tipi in Variant sono quindi chiamati tipi non-nullable.

Uno dei tipi Variant è Nil, che può memorizzare solo il valore null. Pertanto, è possibile che un Variant contenga il valore null, sebbene tutti i tipi Variant, ad eccezione di Nil e Object, non siano nullabili.

Riferimenti

Elenco dei tipi variant

In Variant sono disponibili i seguenti tipi:

Tipo

Note

Nil (può memorizzare solo null)

Tipo nullable

bool

int

float

String

Vector2

Vector2i

Rect2

Controparte 2D di AABB

Rect2i

Vector3

Vector3i

Transform2D

Vector4

Vector4i

Plane

Quaternion

AABB

Controparte 3D di Rect2

Basis

Transform3D

Projection

Color

StringName

NodePath

RID

Object

Tipo nullable

Callable

Signal

Dictionary

Array

PackedByteArray

PackedInt32Array

PackedInt64Array

PackedFloat32Array

PackedFloat64Array

PackedStringArray

PackedVector2Array

PackedVector3Array

PackedColorArray

PackedVector4Array

Contenitori: Array e 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.

Le modifiche a un contenitore modificheranno tutti i riferimenti ad esso. È necessario creare un Mutex per bloccarlo se si desidera un accesso su più thread.

Riferimenti