Attention: Here be dragons
This is the latest
(unstable) version of this documentation, which may document features
not available in or compatible with released stable versions of Godot.
Checking the stable version of the documentation...
Classe Variant
Informazioni
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).
Essere sottoposto ad hash, in modo da potersi confrontare rapidamente con altre varianti.
Essere utilizzato per convertire in modo sicuro tra diversi tipi di dati.
Essere utilizzato per astrarre le chiamate di metodi e i loro argomenti (Godot esporta tutte le sue funzioni tramite varianti).
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.
Fondamentalmente, grazie alla classe Variant, scrivere Godot stesso è stato molto, molto più semplice, poiché ciò consente di realizzare costrutti altamente dinamici, non comuni in C++, con poco sforzo. Diventa amico di Variant oggi stesso.
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 |
Tipo nullable |
Controparte 2D di AABB |
|
Controparte 3D di Rect2 |
|
Tipo nullable |
|
Contenitori: Array e Dictionary
Sia Array sia Dictionary sono implementati utilizzando le varianti. Un dizionario può far corrispondere qualsiasi tipo di dato utilizzato come chiave a qualsiasi altro tipo di dato. Un array è composto solo da un array di varianti. Naturalmente, una variante può contenere anche un dizionario o un array al suo interno, rendendola ancora più flessibile.
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.