mirror of https://github.com/lua/lua
287 lines
6.9 KiB
C
287 lines
6.9 KiB
C
/*
|
|
** $Id: lauxlib.c,v 1.70 2002/05/15 18:57:44 roberto Exp roberto $
|
|
** Auxiliary functions for building Lua libraries
|
|
** See Copyright Notice in lua.h
|
|
*/
|
|
|
|
|
|
#include <stdarg.h>
|
|
#include <stdio.h>
|
|
#include <string.h>
|
|
|
|
/* This file uses only the official API of Lua.
|
|
** Any function declared here could be written as an application function.
|
|
** With care, these functions can be used by other libraries.
|
|
*/
|
|
|
|
#include "lua.h"
|
|
|
|
#include "lauxlib.h"
|
|
#include "luadebug.h"
|
|
#include "lualib.h"
|
|
|
|
|
|
LUALIB_API int luaL_findstring (const char *name, const char *const list[]) {
|
|
int i;
|
|
for (i=0; list[i]; i++)
|
|
if (strcmp(list[i], name) == 0)
|
|
return i;
|
|
return -1; /* name not found */
|
|
}
|
|
|
|
|
|
LUALIB_API int luaL_argerror (lua_State *L, int narg, const char *extramsg) {
|
|
lua_Debug ar;
|
|
lua_getstack(L, 0, &ar);
|
|
lua_getinfo(L, "n", &ar);
|
|
if (strcmp(ar.namewhat, "method") == 0) narg--; /* do not count `self' */
|
|
if (ar.name == NULL)
|
|
ar.name = "?";
|
|
return luaL_verror(L, "bad argument #%d to `%s' (%s)",
|
|
narg, ar.name, extramsg);
|
|
}
|
|
|
|
|
|
LUALIB_API int luaL_typerror (lua_State *L, int narg, const char *tname) {
|
|
const char *msg = lua_pushfstring(L, "%s expected, got %s",
|
|
tname, lua_typename(L, lua_type(L,narg)));
|
|
return luaL_argerror(L, narg, msg);
|
|
}
|
|
|
|
|
|
static void tag_error (lua_State *L, int narg, int tag) {
|
|
luaL_typerror(L, narg, lua_typename(L, tag));
|
|
}
|
|
|
|
|
|
LUALIB_API void luaL_check_stack (lua_State *L, int space, const char *mes) {
|
|
if (!lua_checkstack(L, space))
|
|
luaL_verror(L, "stack overflow (%s)", mes);
|
|
}
|
|
|
|
|
|
LUALIB_API void luaL_check_type (lua_State *L, int narg, int t) {
|
|
if (lua_type(L, narg) != t)
|
|
tag_error(L, narg, t);
|
|
}
|
|
|
|
|
|
LUALIB_API void luaL_check_any (lua_State *L, int narg) {
|
|
if (lua_type(L, narg) == LUA_TNONE)
|
|
luaL_argerror(L, narg, "value expected");
|
|
}
|
|
|
|
|
|
LUALIB_API const char *luaL_check_lstr (lua_State *L, int narg, size_t *len) {
|
|
const char *s = lua_tostring(L, narg);
|
|
if (!s) tag_error(L, narg, LUA_TSTRING);
|
|
if (len) *len = lua_strlen(L, narg);
|
|
return s;
|
|
}
|
|
|
|
|
|
LUALIB_API const char *luaL_opt_lstr (lua_State *L, int narg, const char *def, size_t *len) {
|
|
if (lua_isnoneornil(L, narg)) {
|
|
if (len)
|
|
*len = (def ? strlen(def) : 0);
|
|
return def;
|
|
}
|
|
else return luaL_check_lstr(L, narg, len);
|
|
}
|
|
|
|
|
|
LUALIB_API lua_Number luaL_check_number (lua_State *L, int narg) {
|
|
lua_Number d = lua_tonumber(L, narg);
|
|
if (d == 0 && !lua_isnumber(L, narg)) /* avoid extra test when d is not 0 */
|
|
tag_error(L, narg, LUA_TNUMBER);
|
|
return d;
|
|
}
|
|
|
|
|
|
LUALIB_API lua_Number luaL_opt_number (lua_State *L, int narg, lua_Number def) {
|
|
if (lua_isnoneornil(L, narg)) return def;
|
|
else return luaL_check_number(L, narg);
|
|
}
|
|
|
|
|
|
LUALIB_API int luaL_callmeta (lua_State *L, int obj, const char *event) {
|
|
if (!lua_getmetatable(L, obj)) /* no metatable? */
|
|
return 0;
|
|
lua_pushstring(L, event);
|
|
lua_rawget(L, -2);
|
|
if (lua_isnil(L, -1)) {
|
|
lua_pop(L, 2); /* remove metatable and metafield */
|
|
return 0;
|
|
}
|
|
lua_pushvalue(L, obj);
|
|
lua_rawcall(L, 1, 1);
|
|
return 1;
|
|
}
|
|
|
|
|
|
LUALIB_API void luaL_openlib (lua_State *L, const luaL_reg *l, int nup) {
|
|
for (; l->name; l++) {
|
|
int i;
|
|
lua_pushstring(L, l->name);
|
|
for (i=0; i<nup; i++) /* copy upvalues to the top */
|
|
lua_pushvalue(L, -(nup+1));
|
|
lua_pushcclosure(L, l->func, nup);
|
|
lua_settable(L, -(nup+3));
|
|
}
|
|
lua_pop(L, nup);
|
|
}
|
|
|
|
|
|
LUALIB_API void luaL_opennamedlib (lua_State *L, const char *libname,
|
|
const luaL_reg *l, int nup) {
|
|
lua_pushstring(L, libname);
|
|
lua_insert(L, -(nup+1));
|
|
lua_newtable(L);
|
|
lua_insert(L, -(nup+1));
|
|
luaL_openlib(L, l, nup);
|
|
lua_settable(L, LUA_GLOBALSINDEX);
|
|
}
|
|
|
|
|
|
LUALIB_API int luaL_verror (lua_State *L, const char *fmt, ...) {
|
|
lua_Debug ar;
|
|
const char *msg;
|
|
va_list argp;
|
|
va_start(argp, fmt);
|
|
msg = lua_pushvfstring(L, fmt, argp);
|
|
va_end(argp);
|
|
if (lua_getstack(L, 1, &ar)) { /* check calling function */
|
|
lua_getinfo(L, "Snl", &ar);
|
|
if (ar.currentline > 0)
|
|
lua_pushfstring(L, "%s:%d: %s", ar.short_src, ar.currentline, msg);
|
|
}
|
|
return lua_errorobj(L);
|
|
}
|
|
|
|
|
|
/*
|
|
** {======================================================
|
|
** Generic Buffer manipulation
|
|
** =======================================================
|
|
*/
|
|
|
|
|
|
#define buffempty(B) ((B)->p == (B)->buffer)
|
|
#define bufflen(B) ((B)->p - (B)->buffer)
|
|
#define bufffree(B) ((size_t)(LUAL_BUFFERSIZE - bufflen(B)))
|
|
|
|
#define LIMIT (LUA_MINSTACK/2)
|
|
|
|
|
|
static int emptybuffer (luaL_Buffer *B) {
|
|
size_t l = bufflen(B);
|
|
if (l == 0) return 0; /* put nothing on stack */
|
|
else {
|
|
lua_pushlstring(B->L, B->buffer, l);
|
|
B->p = B->buffer;
|
|
B->level++;
|
|
return 1;
|
|
}
|
|
}
|
|
|
|
|
|
static void adjuststack (luaL_Buffer *B) {
|
|
if (B->level > 1) {
|
|
lua_State *L = B->L;
|
|
int toget = 1; /* number of levels to concat */
|
|
size_t toplen = lua_strlen(L, -1);
|
|
do {
|
|
size_t l = lua_strlen(L, -(toget+1));
|
|
if (B->level - toget + 1 >= LIMIT || toplen > l) {
|
|
toplen += l;
|
|
toget++;
|
|
}
|
|
else break;
|
|
} while (toget < B->level);
|
|
lua_concat(L, toget);
|
|
B->level = B->level - toget + 1;
|
|
}
|
|
}
|
|
|
|
|
|
LUALIB_API char *luaL_prepbuffer (luaL_Buffer *B) {
|
|
if (emptybuffer(B))
|
|
adjuststack(B);
|
|
return B->buffer;
|
|
}
|
|
|
|
|
|
LUALIB_API void luaL_addlstring (luaL_Buffer *B, const char *s, size_t l) {
|
|
while (l--)
|
|
luaL_putchar(B, *s++);
|
|
}
|
|
|
|
|
|
LUALIB_API void luaL_addstring (luaL_Buffer *B, const char *s) {
|
|
luaL_addlstring(B, s, strlen(s));
|
|
}
|
|
|
|
|
|
LUALIB_API void luaL_pushresult (luaL_Buffer *B) {
|
|
emptybuffer(B);
|
|
lua_concat(B->L, B->level);
|
|
B->level = 1;
|
|
}
|
|
|
|
|
|
LUALIB_API void luaL_addvalue (luaL_Buffer *B) {
|
|
lua_State *L = B->L;
|
|
size_t vl = lua_strlen(L, -1);
|
|
if (vl <= bufffree(B)) { /* fit into buffer? */
|
|
memcpy(B->p, lua_tostring(L, -1), vl); /* put it there */
|
|
B->p += vl;
|
|
lua_pop(L, 1); /* remove from stack */
|
|
}
|
|
else {
|
|
if (emptybuffer(B))
|
|
lua_insert(L, -2); /* put buffer before new value */
|
|
B->level++; /* add new value into B stack */
|
|
adjuststack(B);
|
|
}
|
|
}
|
|
|
|
|
|
LUALIB_API void luaL_buffinit (lua_State *L, luaL_Buffer *B) {
|
|
B->L = L;
|
|
B->p = B->buffer;
|
|
B->level = 0;
|
|
}
|
|
|
|
/* }====================================================== */
|
|
|
|
|
|
LUALIB_API int luaL_ref (lua_State *L, int t) {
|
|
int ref;
|
|
lua_rawgeti(L, t, 0); /* get first free element */
|
|
ref = (int)lua_tonumber(L, -1);
|
|
lua_pop(L, 1); /* remove it from stack */
|
|
if (ref != 0) { /* any free element? */
|
|
lua_rawgeti(L, t, ref); /* remove it from list */
|
|
lua_rawseti(L, t, 0);
|
|
}
|
|
else { /* no free elements */
|
|
ref = lua_getn(L, t) + 1; /* use next `n' */
|
|
lua_pushliteral(L, "n");
|
|
lua_pushnumber(L, ref);
|
|
lua_rawset(L, t); /* n = n+1 */
|
|
}
|
|
lua_rawseti(L, t, ref);
|
|
return ref;
|
|
}
|
|
|
|
|
|
LUALIB_API void luaL_unref (lua_State *L, int t, int ref) {
|
|
if (ref >= 0) {
|
|
lua_rawgeti(L, t, 0);
|
|
lua_pushnumber(L, ref);
|
|
lua_rawseti(L, t, 0);
|
|
lua_rawseti(L, t, ref);
|
|
}
|
|
}
|
|
|