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