Gestión del estado y los errores

Puede ejecutar varias instancias de lua_State en el mismo proceso. Cada una es completamente independiente: tiene globales y pilas separadas, y no comparte memoria de forma predeterminada.

lua_newthread(L) crea un hilo secundario (coroutine) que comparte el mismo entorno global, pero tiene su propia pila. Así se implementan las coroutines de Lua en C.

Los datos no se pueden pasar directamente entre estados de Lua independientes. Serialícelos como strings o use estructuras de memoria compartida del lado de C accesibles mediante userdata.

lua_pcall captura los errores (usa setjmp/longjmp internamente). lua_call propaga los errores y aborta el programa. Use siempre lua_pcall en producción.

Los errores en Lua pueden ser cualquier valor, no solo strings. error({code=404, msg="not found"}) introduce una tabla como error. El código C la lee de la pila cuando falla pcall.

Si un error escapa de un pcall (por ejemplo, desde una función de C llamada sin protección), Lua llama al manejador de panic establecido mediante lua_atpanic(L, fn) antes de abortar.

Después de un error de lua_pcall, la pila se restaura al estado anterior a la llamada (sin la función ni los argumentos, pero con el objeto de error en la cima).

Cierre siempre el estado con lua_close(L) cuando termine. Esto activa todos los finalizadores __gc y libera toda la memoria asignada.

Un estado de Lua no es seguro para subprocesos. No llame nunca de forma simultánea a dos funciones de la API de C sobre el mismo estado. Use un estado por hilo del sistema operativo o un mutex para serializar el acceso.

De forma predeterminada, Lua usa realloc. Proporcione un asignador personalizado mediante lua_newstate(allocFn, ud) para realizar un seguimiento de la memoria, establecer límites o usar pools personalizados.

Ejecute el código que no sea de confianza en un estado de Lua nuevo y aislado, sin abrir las bibliotecas estándar. Cualquier error grave o agotamiento de recursos quedará contenido en ese estado.

Use lua_pcall (nunca lua_call) en producción. Establezca un manejador de panic para la recuperación como último recurso. Mantenga un estado por hilo. Use varios estados aislados para crear sandboxes. Llame siempre a lua_close para realizar la limpieza.