Modèle de pile de l’API C de Lua
Comprenez la pile Lua, les indices et les opérations élémentaires d’empilement et de dépilement.
Modèle de pile de l’API C de Lua est une leçon Lua Academy gratuite sur CoddyKit. Ceci est la leçon 1 sur 4. Tu peux lire la leçon complète ci-dessous gratuitement — puis la pratiquer en direct dans le navigateur avec un éditeur de code intégré et un tuteur IA 24/7. Elle fait partie du parcours d'apprentissage Lua Academy, et ta progression se synchronise sur le web et l'application CoddyKit. Le cours Lua Academy comprend 4 leçons au total.
Pourquoi l’API C ?
Lua peut être intégré à des applications C/C++. Le code C hôte crée un état Lua, charge des scripts, appelle des fonctions Lua et expose des fonctions C à Lua — le tout via l’API C de Lua.
La pile Lua
L’API C de Lua communique au moyen d’une pile virtuelle. Le code C empile les valeurs avant les appels et lit les valeurs de retour après les appels.
Créer un état Lua
luaL_newstate() crée un nouvel état d’interpréteur Lua. luaL_openlibs(L) charge les bibliothèques standard.
// C code
#include <lua.h>
#include <lualib.h>
#include <lauxlib.h>
lua_State *L = luaL_newstate();
luaL_openlibs(L);
// ... use L ...
lua_close(L);Indices de la pile
Les indices positifs sont comptés depuis le bas (1 = bas). Les indices négatifs sont comptés depuis le sommet (-1 = sommet, -2 = deuxième élément depuis le sommet).
Empiler des valeurs
Empilez différents types sur la pile à l’aide de fonctions d’empilement propres à chaque type.
// 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 nilLire des valeurs
Lisez les valeurs de la pile sans les supprimer à l’aide des fonctions 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);Manipuler la pile
Utilisez lua_pop(L, n) pour supprimer n valeurs au sommet. lua_gettop(L) renvoie la hauteur actuelle de la pile.
// 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)); // 1Vérification des types
Vérifiez le type d’une valeur de la pile avec lua_type(L, idx), qui renvoie LUA_TNUMBER, LUA_TSTRING, etc.
Empiler des tables
Créez et remplissez une nouvelle table depuis C.
// C code
lua_newtable(L); // push empty table
lua_pushstring(L, "world");
lua_setfield(L, -2, "hello"); // t.hello = "world"Vérification des erreurs
La plupart des fonctions de l’API C susceptibles d’échouer renvoient un code d’erreur (LUA_OK = 0). Vérifiez toujours les codes de retour et appelez lua_tostring(L, -1) pour obtenir le message d’erreur.
Équilibre de la pile
Il vous incombe de maintenir l’équilibre de la pile. Chaque empilement doit être compensé par une suppression (ou la valeur doit être consommée par un appel). Un débordement de pile provoque une panique.
Question sur le modèle de pile
À quoi l’indice -1 fait-il référence dans la pile de l’API C de Lua ?
Récapitulatif : modèle de pile de l’API C de Lua
L’API C de Lua utilise une pile virtuelle pour tous les échanges de données. Empilez les valeurs avant les appels et lisez les résultats après. Utilisez des indices positifs (du bas vers le haut) ou négatifs (du haut vers le bas). Maintenez l’équilibre de la pile pour éviter les débordements.
Questions Fréquemment Posées
La leçon « Modèle de pile de l’API C de Lua » est-elle gratuite ?
Oui — le texte complet de « Modèle de pile de l’API C de Lua » est gratuit à lire ici sur le web. Pour la pratiquer de manière interactive (un éditeur de code intégré et un tuteur IA 24/7) et déverrouiller le reste du cours Lua Academy, passe à CoddyKit PRO. Le cours Lua Academy comprend 4 leçons au total.
Qu'est-ce que j'apprendrai dans « Modèle de pile de l’API C de Lua » ?
Comprenez la pile Lua, les indices et les opérations élémentaires d’empilement et de dépilement. Tu pratiques Lua Academy avec du code pratique que tu exécutes directement dans le navigateur, et un tuteur IA 24/7 répond à tes questions au fur et à mesure que tu avances dans la leçon.
Dois-je avoir de l'expérience pour commencer Lua Academy ?
Aucune expérience préalable n'est requise. Lua Academy sur CoddyKit est structuré pour les débutants jusqu'aux apprenants avancés, donc tu peux commencer ici ou depuis le début et avancer à ton rythme. Ceci est la leçon 1 sur 4.
Combien de temps prend la leçon « Modèle de pile de l’API C de Lua » ?
La plupart des leçons CoddyKit prennent environ 5–10 minutes. Chacune est courte et interactive, tu progresses régulièrement et tu repiques exactement où tu t'es arrêté sur le web et l'app.
Peux-tu écrire et exécuter du code dans cette leçon Lua Academy ?
Oui. Chaque leçon Lua Academy inclut un éditeur de code intégré, tu écris et exécutes du vrai code directement dans ton navigateur et tu reçois des retours IA instantanés — aucune configuration locale requise.
Toutes les leçons de ce cours
- Modèle de pile de l’API C de Lua
- Appeler des fonctions Lua depuis C
- Enregistrer des fonctions C dans Lua
- Gérer l’état et les erreurs