Lua Academy · Lección

Modelo de pila de la API C de Lua

Comprenda la pila de Lua, sus índices y las operaciones básicas push/pop.

Modelo de pila de la API C de Lua es una lección gratuita de Lua Academy en CoddyKit. Esta es la lección 1 de 4. Puedes leer la lección completa abajo gratuitamente — luego la practicas en el navegador con un editor de código integrado y un tutor de IA 24/7. Forma parte de la ruta de aprendizaje de Lua Academy, y tu progreso se sincroniza en la web y la app de CoddyKit. El curso de Lua Academy incluye 4 lecciones en total.

¿Por qué la API de C?

Lua puede integrarse en aplicaciones de C/C++. El código C anfitrión crea un estado de Lua, carga scripts, llama a funciones de Lua y expone funciones de C a Lua, todo mediante la API de C de Lua.

La pila de Lua

La API de C de Lua se comunica mediante una pila virtual. El código C introduce valores en la pila antes de las llamadas y lee de ella los valores devueltos después de las llamadas.

Crear un estado de Lua

luaL_newstate() crea un nuevo estado del intérprete de Lua. luaL_openlibs(L) carga las bibliotecas estándar.

// C code
#include <lua.h>
#include <lualib.h>
#include <lauxlib.h>

lua_State *L = luaL_newstate();
luaL_openlibs(L);
// ... use L ...
lua_close(L);

Índices de la pila

Los índices positivos se cuentan desde la base (1 = base). Los índices negativos se cuentan desde la cima (-1 = cima, -2 = segundo elemento desde la cima).

Introducir valores en la pila

Introduzca distintos tipos en la pila mediante funciones de inserción específicas para cada tipo.

// C code
lua_pushnumber(L, 42.0);      // push number
lua_pushstring(L, "hello");   // push string
lua_pushboolean(L, 1);        // push true
lua_pushnil(L);               // push nil

Leer valores

Lea valores de la pila sin eliminarlos mediante las funciones lua_to*.

// C code
double n = lua_tonumber(L, -1);     // read top as number
const char *s = lua_tostring(L, 1); // read bottom as string
int b = lua_toboolean(L, -2);

Manipulación de la pila

Use lua_pop(L, n) para descartar n valores de la cima. lua_gettop(L) devuelve la altura actual de la pila.

// C code
lua_pushstring(L, "a");
lua_pushstring(L, "b");
printf("stack size: %d\n", lua_gettop(L)); // 2
lua_pop(L, 1);
printf("stack size: %d\n", lua_gettop(L)); // 1

Comprobación de tipos

Compruebe el tipo de un valor de la pila con lua_type(L, idx), que devuelve LUA_TNUMBER, LUA_TSTRING, etc.

Introducir tablas en la pila

Cree y rellene una tabla nueva desde C.

// C code
lua_newtable(L);             // push empty table
lua_pushstring(L, "world");
lua_setfield(L, -2, "hello"); // t.hello = "world"

Comprobación de errores

La mayoría de las funciones de la API de C que pueden fallar devuelven un código de error (LUA_OK = 0). Compruebe siempre los códigos devueltos y llame a lua_tostring(L, -1) para obtener el mensaje de error.

Equilibrio de la pila

Es responsabilidad de usted mantener equilibrada la pila. Cada inserción debe corresponderse con una extracción (o con el consumo del valor mediante una llamada). El desbordamiento de la pila provoca un panic.

Pregunta sobre el modelo de la pila

¿A qué se refiere el índice -1 en la pila de la API de C de Lua?

Repaso: modelo de la pila de la API de C de Lua

La API de C de Lua utiliza una pila virtual para todo intercambio de datos. Introduzca los valores antes de las llamadas y lea los resultados después. Use índices positivos (de abajo arriba) o negativos (de arriba abajo). Mantenga equilibrada la pila para evitar desbordamientos.

Preguntas frecuentes

¿La lección «Modelo de pila de la API C de Lua» es gratis?

Sí — el texto completo de «Modelo de pila de la API C de Lua» es gratis para leer aquí en la web. Para practicarla de forma interactiva (editor de código integrado y tutor de IA 24/7) y desbloquear el resto del curso de Lua Academy, actualiza a CoddyKit PRO. El curso de Lua Academy incluye 4 lecciones en total.

¿Qué aprenderé en «Modelo de pila de la API C de Lua»?

Comprenda la pila de Lua, sus índices y las operaciones básicas push/pop. Practicas Lua Academy con código real que ejecutas directamente en el navegador, y un tutor de IA 24/7 responde tus preguntas mientras trabajas en la lección.

¿Necesito experiencia previa para empezar Lua Academy?

No se requiere experiencia previa. Lua Academy en CoddyKit está estructurado para principiantes hasta estudiantes avanzados, así que puedes empezar aquí o desde el inicio y avanzar a tu ritmo. Esta es la lección 1 de 4.

¿Cuánto tiempo toma la lección «Modelo de pila de la API C de Lua»?

La mayoría de las lecciones de CoddyKit toman alrededor de 5–10 minutos. Cada una es compacta e interactiva, así que avanzas constantemente y retomas exactamente por donde dejaste en la web y la app.

¿Puedo escribir y ejecutar código en esta lección de Lua Academy?

Sí. Cada lección de Lua Academy incluye un editor de código integrado, así que escribes y ejecutas código real directamente en tu navegador y obtienes retroalimentación instantánea de IA — sin configuración local necesaria.

Todas las lecciones de este curso

← Volver a Lua Academy