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
Успадковує: 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, якщо зворотна трасування не має стекових кадрів.