mirror of
https://github.com/pocketpy/pocketpy
synced 2025-10-30 16:30:16 +00:00
40 lines
907 B
Markdown
40 lines
907 B
Markdown
---
|
|
icon: dot
|
|
label: 'Miscellaneous'
|
|
order: 0
|
|
---
|
|
|
|
## The scope lock of gc
|
|
|
|
Sometimes you need to use the following code to prevent the gc from collecting objects.
|
|
|
|
```cpp
|
|
auto _lock = vm->heap.gc_scope_lock();
|
|
```
|
|
|
|
The scope lock is required if you create a PyObject and then try to run python-level bytecodes.
|
|
|
|
For example, you create a temporary object on the stack and then call `vm->py_str`.
|
|
|
|
```cpp
|
|
void some_func(VM* vm){
|
|
PyObject* obj = VAR(List(5));
|
|
// unsafe
|
|
PyObject obj_string = vm->py_str(obj);
|
|
}
|
|
```
|
|
|
|
Because users can have an overload of `__str__`, this call is unsafe.
|
|
When the vm is running python-level bytecodes, gc may start and delete your temporary object.
|
|
|
|
The scope lock prevents this from happening.
|
|
|
|
```cpp
|
|
void some_func(VM* vm){
|
|
PyObject* obj = VAR(List(5));
|
|
// safe
|
|
auto _lock = vm->heap.gc_scope_lock();
|
|
PyObject obj_string = vm->py_str(obj);
|
|
}
|
|
```
|