:github_url: hide .. _class_ScriptBacktrace: ScriptBacktrace =============== **Eredita:** :ref:`RefCounted` **<** :ref:`Object` Un backtrace catturato di uno specifico linguaggio di script. .. rst-class:: classref-introduction-group Descrizione ---------------------- **ScriptBacktrace** contiene un backtrace già catturato di uno specifico linguaggio di scripting, come GDScript o C#, che è catturato attraverso :ref:`Engine.capture_script_backtraces()`. Consultare :ref:`ProjectSettings.debug/settings/gdscript/always_track_call_stacks` e :ref:`ProjectSettings.debug/settings/gdscript/always_track_local_variables` per informazioni su come controllare il contenuto di questa classe. .. rst-class:: classref-reftable-group Metodi ------------ .. table:: :widths: auto +-------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`String` | :ref:`format`\ (\ indent_all\: :ref:`int` = 0, indent_frames\: :ref:`int` = 4\ ) |const| | +-------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`get_frame_count`\ (\ ) |const| | +-------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`String` | :ref:`get_frame_file`\ (\ index\: :ref:`int`\ ) |const| | +-------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`String` | :ref:`get_frame_function`\ (\ index\: :ref:`int`\ ) |const| | +-------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`get_frame_line`\ (\ index\: :ref:`int`\ ) |const| | +-------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`get_global_variable_count`\ (\ ) |const| | +-------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`String` | :ref:`get_global_variable_name`\ (\ variable_index\: :ref:`int`\ ) |const| | +-------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Variant` | :ref:`get_global_variable_value`\ (\ variable_index\: :ref:`int`\ ) |const| | +-------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`String` | :ref:`get_language_name`\ (\ ) |const| | +-------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`get_local_variable_count`\ (\ frame_index\: :ref:`int`\ ) |const| | +-------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`String` | :ref:`get_local_variable_name`\ (\ frame_index\: :ref:`int`, variable_index\: :ref:`int`\ ) |const| | +-------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Variant` | :ref:`get_local_variable_value`\ (\ frame_index\: :ref:`int`, variable_index\: :ref:`int`\ ) |const| | +-------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`get_member_variable_count`\ (\ frame_index\: :ref:`int`\ ) |const| | +-------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`String` | :ref:`get_member_variable_name`\ (\ frame_index\: :ref:`int`, variable_index\: :ref:`int`\ ) |const| | +-------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Variant` | :ref:`get_member_variable_value`\ (\ frame_index\: :ref:`int`, variable_index\: :ref:`int`\ ) |const| | +-------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`is_empty`\ (\ ) |const| | +-------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ .. rst-class:: classref-section-separator ---- .. rst-class:: classref-descriptions-group Descrizioni dei metodi -------------------------------------------- .. _class_ScriptBacktrace_method_format: .. rst-class:: classref-method :ref:`String` **format**\ (\ indent_all\: :ref:`int` = 0, indent_frames\: :ref:`int` = 4\ ) |const| :ref:`🔗` Converte il backtrace in una :ref:`String`, dove l'intera stringa sarà rientrata di un numero di spazi pari a ``indent_all`` e i singoli stack frame saranno ulteriormente rientrati di un numero di spazi pari a ``indent_frames``. \ **Nota:** Chiamare :ref:`Object.to_string()` su uno **ScriptBacktrace** produrrà lo stesso risultato di chiamare :ref:`format()`, con tutti i parametri lasciati ai loro valori predefiniti. .. rst-class:: classref-item-separator ---- .. _class_ScriptBacktrace_method_get_frame_count: .. rst-class:: classref-method :ref:`int` **get_frame_count**\ (\ ) |const| :ref:`🔗` Restituisce il numero di frame dello stack nel backtrace. .. rst-class:: classref-item-separator ---- .. _class_ScriptBacktrace_method_get_frame_file: .. rst-class:: classref-method :ref:`String` **get_frame_file**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` Restituisce il nome di file del sito di chiamata rappresentato dal frame dello stack all'indice specificato. .. rst-class:: classref-item-separator ---- .. _class_ScriptBacktrace_method_get_frame_function: .. rst-class:: classref-method :ref:`String` **get_frame_function**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` Restituisce il nome della funzione chiamata al frame dello stack all'indice specificato. .. rst-class:: classref-item-separator ---- .. _class_ScriptBacktrace_method_get_frame_line: .. rst-class:: classref-method :ref:`int` **get_frame_line**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` Restituisce il numero di riga del sito di chiamata rappresentato dal frame dello stack all'indice specificato. .. rst-class:: classref-item-separator ---- .. _class_ScriptBacktrace_method_get_global_variable_count: .. rst-class:: classref-method :ref:`int` **get_global_variable_count**\ (\ ) |const| :ref:`🔗` Restituisce il numero di variabili globali (ad esempio, singleton autoload) nel backtrace. \ **Nota:** Questo valore sarà diverso da zero solo se il parametro ``include_variables`` era ``true`` durante la cattura del backtrace con :ref:`Engine.capture_script_backtraces()`. .. rst-class:: classref-item-separator ---- .. _class_ScriptBacktrace_method_get_global_variable_name: .. rst-class:: classref-method :ref:`String` **get_global_variable_name**\ (\ variable_index\: :ref:`int`\ ) |const| :ref:`🔗` Restituisce il nome della variabile globale al frame dello stack all'indice specificato. .. rst-class:: classref-item-separator ---- .. _class_ScriptBacktrace_method_get_global_variable_value: .. rst-class:: classref-method :ref:`Variant` **get_global_variable_value**\ (\ variable_index\: :ref:`int`\ ) |const| :ref:`🔗` Restituisce il valore della variabile globale all'indice specificato. \ **Attenzione:** Con i backtrace di GDScript, il :ref:`Variant` restituito sarà il valore attuale della variabile, inclusi eventuali riferimenti a oggetti. Ciò significa che memorizzando il :ref:`Variant` restituito si impedirà la deallocazione di tali oggetti, quindi in genere si consiglia di non farlo. .. rst-class:: classref-item-separator ---- .. _class_ScriptBacktrace_method_get_language_name: .. rst-class:: classref-method :ref:`String` **get_language_name**\ (\ ) |const| :ref:`🔗` Restituisce il nome del linguaggio di script da cui è stato catturato questo backtrace. .. rst-class:: classref-item-separator ---- .. _class_ScriptBacktrace_method_get_local_variable_count: .. rst-class:: classref-method :ref:`int` **get_local_variable_count**\ (\ frame_index\: :ref:`int`\ ) |const| :ref:`🔗` Restituisce il numero di variabili locali nello stack frame all'indice specificato. \ **Nota:** Questo valore sarà diverso da zero solo se il parametro ``include_variables`` era ``true`` durante la cattura del backtrace con :ref:`Engine.capture_script_backtraces()`. .. rst-class:: classref-item-separator ---- .. _class_ScriptBacktrace_method_get_local_variable_name: .. rst-class:: classref-method :ref:`String` **get_local_variable_name**\ (\ frame_index\: :ref:`int`, variable_index\: :ref:`int`\ ) |const| :ref:`🔗` Restituisce il nome della variabile locale all'indice ``variable_index`` nel frame all'indice ``frame_index`` dello stack. .. rst-class:: classref-item-separator ---- .. _class_ScriptBacktrace_method_get_local_variable_value: .. rst-class:: classref-method :ref:`Variant` **get_local_variable_value**\ (\ frame_index\: :ref:`int`, variable_index\: :ref:`int`\ ) |const| :ref:`🔗` Restituisce il valore della variabile locale all'indice ``variable_index`` nello stack frame all'indice ``frame_index``. \ **Attenzione:** Con i backtrace di GDScript, il :ref:`Variant` restituito sarà il valore attuale della variabile, inclusi eventuali riferimenti a oggetti. Ciò significa che memorizzando il :ref:`Variant` restituito si impedirà la deallocazione di tali oggetti, quindi in genere si consiglia di non farlo. .. rst-class:: classref-item-separator ---- .. _class_ScriptBacktrace_method_get_member_variable_count: .. rst-class:: classref-method :ref:`int` **get_member_variable_count**\ (\ frame_index\: :ref:`int`\ ) |const| :ref:`🔗` Restituisce il numero di variabili membro nello stack frame all'indice specificato. \ **Nota:** Questo valore sarà diverso da zero solo se il parametro ``include_variables`` era ``true`` durante la cattura del backtrace con :ref:`Engine.capture_script_backtraces()`. .. rst-class:: classref-item-separator ---- .. _class_ScriptBacktrace_method_get_member_variable_name: .. rst-class:: classref-method :ref:`String` **get_member_variable_name**\ (\ frame_index\: :ref:`int`, variable_index\: :ref:`int`\ ) |const| :ref:`🔗` Restituisce il nome della variabile membro all'indice ``variable_index`` nel frame all'indice ``frame_index`` dello stack. .. rst-class:: classref-item-separator ---- .. _class_ScriptBacktrace_method_get_member_variable_value: .. rst-class:: classref-method :ref:`Variant` **get_member_variable_value**\ (\ frame_index\: :ref:`int`, variable_index\: :ref:`int`\ ) |const| :ref:`🔗` Restituisce il valore della variabile membro all'indice ``variable_index`` nello stack frame all'indice ``frame_index``. \ **Attenzione:** Con i backtrace di GDScript, il :ref:`Variant` restituito sarà il valore attuale della variabile, inclusi eventuali riferimenti a oggetti. Ciò significa che memorizzando il :ref:`Variant` restituito si impedirà la deallocazione di tali oggetti, quindi in genere si consiglia di non farlo. .. rst-class:: classref-item-separator ---- .. _class_ScriptBacktrace_method_is_empty: .. rst-class:: classref-method :ref:`bool` **is_empty**\ (\ ) |const| :ref:`🔗` Restituisce ``true`` se il backtrace non ha frame dello stack. .. |virtual| replace:: :abbr:`virtual (Questo metodo dovrebbe solitamente essere sovrascritto dall'utente per aver un effetto.)` .. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)` .. |const| replace:: :abbr:`const (Questo metodo non ha effetti collaterali. Non modifica alcuna variabile appartenente all'istanza.)` .. |vararg| replace:: :abbr:`vararg (Questo metodo accetta qualsiasi numero di argomenti oltre a quelli descritti qui.)` .. |constructor| replace:: :abbr:`constructor (Questo metodo è utilizzato per creare un tipo.)` .. |static| replace:: :abbr:`static (Questo metodo non necessita di alcun'istanza per essere chiamato, quindi può essere chiamato direttamente usando il nome della classe.)` .. |operator| replace:: :abbr:`operator (Questo metodo descrive un operatore valido da usare con questo tipo come operando di sinistra.)` .. |bitfield| replace:: :abbr:`BitField (Questo valore è un intero composto da una maschera di bit dei seguenti flag.)` .. |void| replace:: :abbr:`void (Nessun valore restituito.)`