ScriptBacktrace
Наследует: RefCounted < Object
Захваченный обратный след определенного скриптового языка.
Описание
ScriptBacktrace содержит уже захваченную обратную трассировку определенного языка скрипта, например GDScript или C#, которые захватываются с помощью Engine.capture_script_backtraces().
См. ProjectSettings.debug/settings/gdscript/always_track_call_stacks и ProjectSettings.debug/settings/gdscript/always_track_local_variables для способов управления содержимым этого класса.
Методы
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 |
Описания метода
String format(indent_all: int = 0, indent_frames: int = 4) const 🔗
Преобразует обратную трассировку в String, где вся строка будет иметь отступ в indent_all пробелов, а отдельные кадры стека будут дополнительно иметь отступ в indent_frames пробелов.
Примечание: Вызов Object.to_string() в ScriptBacktrace даст тот же вывод, что и вызов format() со всеми параметрами, оставленными со значениями по умолчанию.
Возвращает количество кадров стека в обратной трассировке.
String get_frame_file(index: int) const 🔗
Возвращает имя файла места вызова, представленного стековым кадром по указанному индексу.
String get_frame_function(index: int) const 🔗
Возвращает имя функции, вызванной в кадре стека по указанному индексу.
int get_frame_line(index: int) const 🔗
Возвращает номер строки места вызова, представленного стековым кадром по указанному индексу.
int get_global_variable_count() const 🔗
Возвращает количество глобальных переменных (например, автозагрузочных синглтонов) в обратной трассировке.
Примечание: Это будет ненулевым, только если параметр include_variables был true при захвате обратной трассировки с помощью Engine.capture_script_backtraces().
String get_global_variable_name(variable_index: int) const 🔗
Возвращает имя глобальной переменной по указанному индексу.
Variant get_global_variable_value(variable_index: int) const 🔗
Возвращает значение глобальной переменной по указанному индексу.
Предупреждение: При обратной трассировке GDScript возвращаемый Variant будет фактическим значением переменной, включая любые ссылки на объекты. Это означает, что сохранение возвращаемого Variant предотвратит освобождение любого такого объекта, поэтому обычно рекомендуется этого не делать.
String get_language_name() const 🔗
Возвращает название языка скрипта, с которого была получена эта трассировка.
int get_local_variable_count(frame_index: int) const 🔗
Возвращает количество локальных переменных в стековом кадре по указанному индексу.
Примечание: Это будет ненулевым, только если параметр include_variables был true при захвате обратной трассировки с помощью Engine.capture_script_backtraces().
String get_local_variable_name(frame_index: int, variable_index: int) const 🔗
Возвращает имя локальной переменной с указанным variable_index в кадре стека с указанным frame_index.
Variant get_local_variable_value(frame_index: int, variable_index: int) const 🔗
Возвращает значение локальной переменной по указанному variable_index в стековом кадре по указанному frame_index.
Предупреждение: При использовании обратных трассировок GDScript возвращаемый Variant будет фактическим значением переменной, включая любые ссылки на объекты. Это означает, что сохранение возвращаемого Variant предотвратит освобождение любого такого объекта, поэтому обычно рекомендуется этого не делать.
int get_member_variable_count(frame_index: int) const 🔗
Возвращает количество переменных-членов в стековом фрейме по указанному индексу.
Примечание: Это будет ненулевым, только если параметр include_variables был true при захвате обратной трассировки с помощью Engine.capture_script_backtraces().
String get_member_variable_name(frame_index: int, variable_index: int) const 🔗
Возвращает имя переменной-члена с указанным variable_index в кадре стека с указанным frame_index.
Variant get_member_variable_value(frame_index: int, variable_index: int) const 🔗
Возвращает значение переменной-члена по указанному variable_index в стековом кадре по указанному frame_index.
Предупреждение: При обратной трассировке GDScript возвращаемый Variant будет фактическим значением переменной, включая любые ссылки на объекты. Это означает, что сохранение возвращаемого Variant предотвратит освобождение любого такого объекта, поэтому обычно рекомендуется этого не делать.
Возвращает true, если обратная трассировка не имеет стековых кадров.