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...
ScriptBacktrace
Eredita: RefCounted < Object
Un backtrace catturato di uno specifico linguaggio di script.
Descrizione
ScriptBacktrace contiene un backtrace già catturato di uno specifico linguaggio di scripting, come GDScript o C#, che è catturato attraverso Engine.capture_script_backtraces().
Consultare ProjectSettings.debug/settings/gdscript/always_track_call_stacks e ProjectSettings.debug/settings/gdscript/always_track_local_variables per informazioni su come controllare il contenuto di questa classe.
Metodi
get_frame_count() const |
|
get_frame_file(index: int) const |
|
get_frame_function(index: int) const |
|
get_frame_line(index: int) const |
|
get_global_variable_count() const |
|
get_global_variable_name(variable_index: int) const |
|
get_global_variable_value(variable_index: int) const |
|
get_language_name() const |
|
get_local_variable_count(frame_index: int) const |
|
get_local_variable_name(frame_index: int, variable_index: int) const |
|
get_local_variable_value(frame_index: int, variable_index: int) const |
|
get_member_variable_count(frame_index: int) const |
|
get_member_variable_name(frame_index: int, variable_index: int) const |
|
get_member_variable_value(frame_index: int, variable_index: int) const |
|
is_empty() const |
Descrizioni dei metodi
String format(indent_all: int = 0, indent_frames: int = 4) const 🔗
Converte il backtrace in una 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 Object.to_string() su uno ScriptBacktrace produrrà lo stesso risultato di chiamare format(), con tutti i parametri lasciati ai loro valori predefiniti.
Restituisce il numero di frame dello stack nel backtrace.
String get_frame_file(index: int) const 🔗
Restituisce il nome di file del sito di chiamata rappresentato dal frame dello stack all'indice specificato.
String get_frame_function(index: int) const 🔗
Restituisce il nome della funzione chiamata al frame dello stack all'indice specificato.
int get_frame_line(index: int) const 🔗
Restituisce il numero di riga del sito di chiamata rappresentato dal frame dello stack all'indice specificato.
int get_global_variable_count() const 🔗
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 Engine.capture_script_backtraces().
String get_global_variable_name(variable_index: int) const 🔗
Restituisce il nome della variabile globale al frame dello stack all'indice specificato.
Variant get_global_variable_value(variable_index: int) const 🔗
Restituisce il valore della variabile globale all'indice specificato.
Attenzione: Con i backtrace di GDScript, il Variant restituito sarà il valore attuale della variabile, inclusi eventuali riferimenti a oggetti. Ciò significa che memorizzando il Variant restituito si impedirà la deallocazione di tali oggetti, quindi in genere si consiglia di non farlo.
String get_language_name() const 🔗
Restituisce il nome del linguaggio di script da cui è stato catturato questo backtrace.
int get_local_variable_count(frame_index: int) const 🔗
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 Engine.capture_script_backtraces().
String get_local_variable_name(frame_index: int, variable_index: int) const 🔗
Restituisce il nome della variabile locale all'indice variable_index nel frame all'indice frame_index dello stack.
Variant get_local_variable_value(frame_index: int, variable_index: int) const 🔗
Restituisce il valore della variabile locale all'indice variable_index nello stack frame all'indice frame_index.
Attenzione: Con i backtrace di GDScript, il Variant restituito sarà il valore attuale della variabile, inclusi eventuali riferimenti a oggetti. Ciò significa che memorizzando il Variant restituito si impedirà la deallocazione di tali oggetti, quindi in genere si consiglia di non farlo.
int get_member_variable_count(frame_index: int) const 🔗
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 Engine.capture_script_backtraces().
String get_member_variable_name(frame_index: int, variable_index: int) const 🔗
Restituisce il nome della variabile membro all'indice variable_index nel frame all'indice frame_index dello stack.
Variant get_member_variable_value(frame_index: int, variable_index: int) const 🔗
Restituisce il valore della variabile membro all'indice variable_index nello stack frame all'indice frame_index.
Attenzione: Con i backtrace di GDScript, il Variant restituito sarà il valore attuale della variabile, inclusi eventuali riferimenti a oggetti. Ciò significa che memorizzando il Variant restituito si impedirà la deallocazione di tali oggetti, quindi in genere si consiglia di non farlo.
Restituisce true se il backtrace non ha frame dello stack.