lbaselib.c 14 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527
  1. /*
  2. ** $Id: lbaselib.c $
  3. ** Basic library
  4. ** See Copyright Notice in lua.h
  5. */
  6. #define lbaselib_c
  7. #define LUA_LIB
  8. #include "lprefix.h"
  9. #include <ctype.h>
  10. #include <stdio.h>
  11. #include <stdlib.h>
  12. #include <string.h>
  13. #include "lua.h"
  14. #include "lauxlib.h"
  15. #include "lualib.h"
  16. static int luaB_print (lua_State *L) {
  17. int n = lua_gettop(L); /* number of arguments */
  18. int i;
  19. for (i = 1; i <= n; i++) { /* for each argument */
  20. size_t l;
  21. const char *s = luaL_tolstring(L, i, &l); /* convert it to string */
  22. if (i > 1) /* not the first element? */
  23. lua_writestring("\t", 1); /* add a tab before it */
  24. lua_writestring(s, l); /* print it */
  25. lua_pop(L, 1); /* pop result */
  26. }
  27. lua_writeline();
  28. return 0;
  29. }
  30. /*
  31. ** Creates a warning with all given arguments.
  32. ** Check first for errors; otherwise an error may interrupt
  33. ** the composition of a warning, leaving it unfinished.
  34. */
  35. static int luaB_warn (lua_State *L) {
  36. int n = lua_gettop(L); /* number of arguments */
  37. int i;
  38. luaL_checkstring(L, 1); /* at least one argument */
  39. for (i = 2; i <= n; i++)
  40. luaL_checkstring(L, i); /* make sure all arguments are strings */
  41. for (i = 1; i < n; i++) /* compose warning */
  42. lua_warning(L, lua_tostring(L, i), 1);
  43. lua_warning(L, lua_tostring(L, n), 0); /* close warning */
  44. return 0;
  45. }
  46. #define SPACECHARS " \f\n\r\t\v"
  47. static const char *b_str2int (const char *s, int base, lua_Integer *pn) {
  48. lua_Unsigned n = 0;
  49. int neg = 0;
  50. s += strspn(s, SPACECHARS); /* skip initial spaces */
  51. if (*s == '-') { s++; neg = 1; } /* handle sign */
  52. else if (*s == '+') s++;
  53. if (!isalnum((unsigned char)*s)) /* no digit? */
  54. return NULL;
  55. do {
  56. int digit = (isdigit((unsigned char)*s)) ? *s - '0'
  57. : (toupper((unsigned char)*s) - 'A') + 10;
  58. if (digit >= base) return NULL; /* invalid numeral */
  59. n = n * base + digit;
  60. s++;
  61. } while (isalnum((unsigned char)*s));
  62. s += strspn(s, SPACECHARS); /* skip trailing spaces */
  63. *pn = (lua_Integer)((neg) ? (0u - n) : n);
  64. return s;
  65. }
  66. static int luaB_tonumber (lua_State *L) {
  67. if (lua_isnoneornil(L, 2)) { /* standard conversion? */
  68. if (lua_type(L, 1) == LUA_TNUMBER) { /* already a number? */
  69. lua_settop(L, 1); /* yes; return it */
  70. return 1;
  71. }
  72. else {
  73. size_t l;
  74. const char *s = lua_tolstring(L, 1, &l);
  75. if (s != NULL && lua_stringtonumber(L, s) == l + 1)
  76. return 1; /* successful conversion to number */
  77. /* else not a number */
  78. luaL_checkany(L, 1); /* (but there must be some parameter) */
  79. }
  80. }
  81. else {
  82. size_t l;
  83. const char *s;
  84. lua_Integer n = 0; /* to avoid warnings */
  85. lua_Integer base = luaL_checkinteger(L, 2);
  86. luaL_checktype(L, 1, LUA_TSTRING); /* no numbers as strings */
  87. s = lua_tolstring(L, 1, &l);
  88. luaL_argcheck(L, 2 <= base && base <= 36, 2, "base out of range");
  89. if (b_str2int(s, (int)base, &n) == s + l) {
  90. lua_pushinteger(L, n);
  91. return 1;
  92. } /* else not a number */
  93. } /* else not a number */
  94. luaL_pushfail(L); /* not a number */
  95. return 1;
  96. }
  97. static int luaB_error (lua_State *L) {
  98. int level = (int)luaL_optinteger(L, 2, 1);
  99. lua_settop(L, 1);
  100. if (lua_type(L, 1) == LUA_TSTRING && level > 0) {
  101. luaL_where(L, level); /* add extra information */
  102. lua_pushvalue(L, 1);
  103. lua_concat(L, 2);
  104. }
  105. return lua_error(L);
  106. }
  107. static int luaB_getmetatable (lua_State *L) {
  108. luaL_checkany(L, 1);
  109. if (!lua_getmetatable(L, 1)) {
  110. lua_pushnil(L);
  111. return 1; /* no metatable */
  112. }
  113. luaL_getmetafield(L, 1, "__metatable");
  114. return 1; /* returns either __metatable field (if present) or metatable */
  115. }
  116. static int luaB_setmetatable (lua_State *L) {
  117. int t = lua_type(L, 2);
  118. luaL_checktype(L, 1, LUA_TTABLE);
  119. luaL_argexpected(L, t == LUA_TNIL || t == LUA_TTABLE, 2, "nil or table");
  120. if (luaL_getmetafield(L, 1, "__metatable") != LUA_TNIL)
  121. return luaL_error(L, "cannot change a protected metatable");
  122. lua_settop(L, 2);
  123. lua_setmetatable(L, 1);
  124. return 1;
  125. }
  126. static int luaB_rawequal (lua_State *L) {
  127. luaL_checkany(L, 1);
  128. luaL_checkany(L, 2);
  129. lua_pushboolean(L, lua_rawequal(L, 1, 2));
  130. return 1;
  131. }
  132. static int luaB_rawlen (lua_State *L) {
  133. int t = lua_type(L, 1);
  134. luaL_argexpected(L, t == LUA_TTABLE || t == LUA_TSTRING, 1,
  135. "table or string");
  136. lua_pushinteger(L, lua_rawlen(L, 1));
  137. return 1;
  138. }
  139. static int luaB_rawget (lua_State *L) {
  140. luaL_checktype(L, 1, LUA_TTABLE);
  141. luaL_checkany(L, 2);
  142. lua_settop(L, 2);
  143. lua_rawget(L, 1);
  144. return 1;
  145. }
  146. static int luaB_rawset (lua_State *L) {
  147. luaL_checktype(L, 1, LUA_TTABLE);
  148. luaL_checkany(L, 2);
  149. luaL_checkany(L, 3);
  150. lua_settop(L, 3);
  151. lua_rawset(L, 1);
  152. return 1;
  153. }
  154. static int pushmode (lua_State *L, int oldmode) {
  155. lua_pushstring(L, (oldmode == LUA_GCINC) ? "incremental" : "generational");
  156. return 1;
  157. }
  158. static int luaB_collectgarbage (lua_State *L) {
  159. static const char *const opts[] = {"stop", "restart", "collect",
  160. "count", "step", "setpause", "setstepmul",
  161. "isrunning", "generational", "incremental", NULL};
  162. static const int optsnum[] = {LUA_GCSTOP, LUA_GCRESTART, LUA_GCCOLLECT,
  163. LUA_GCCOUNT, LUA_GCSTEP, LUA_GCSETPAUSE, LUA_GCSETSTEPMUL,
  164. LUA_GCISRUNNING, LUA_GCGEN, LUA_GCINC};
  165. int o = optsnum[luaL_checkoption(L, 1, "collect", opts)];
  166. switch (o) {
  167. case LUA_GCCOUNT: {
  168. int k = lua_gc(L, o);
  169. int b = lua_gc(L, LUA_GCCOUNTB);
  170. lua_pushnumber(L, (lua_Number)k + ((lua_Number)b/1024));
  171. return 1;
  172. }
  173. case LUA_GCSTEP: {
  174. int step = (int)luaL_optinteger(L, 2, 0);
  175. int res = lua_gc(L, o, step);
  176. lua_pushboolean(L, res);
  177. return 1;
  178. }
  179. case LUA_GCSETPAUSE:
  180. case LUA_GCSETSTEPMUL: {
  181. int p = (int)luaL_optinteger(L, 2, 0);
  182. int previous = lua_gc(L, o, p);
  183. lua_pushinteger(L, previous);
  184. return 1;
  185. }
  186. case LUA_GCISRUNNING: {
  187. int res = lua_gc(L, o);
  188. lua_pushboolean(L, res);
  189. return 1;
  190. }
  191. case LUA_GCGEN: {
  192. int minormul = (int)luaL_optinteger(L, 2, 0);
  193. int majormul = (int)luaL_optinteger(L, 3, 0);
  194. return pushmode(L, lua_gc(L, o, minormul, majormul));
  195. }
  196. case LUA_GCINC: {
  197. int pause = (int)luaL_optinteger(L, 2, 0);
  198. int stepmul = (int)luaL_optinteger(L, 3, 0);
  199. int stepsize = (int)luaL_optinteger(L, 4, 0);
  200. return pushmode(L, lua_gc(L, o, pause, stepmul, stepsize));
  201. }
  202. default: {
  203. int res = lua_gc(L, o);
  204. lua_pushinteger(L, res);
  205. return 1;
  206. }
  207. }
  208. }
  209. static int luaB_type (lua_State *L) {
  210. int t = lua_type(L, 1);
  211. luaL_argcheck(L, t != LUA_TNONE, 1, "value expected");
  212. lua_pushstring(L, lua_typename(L, t));
  213. return 1;
  214. }
  215. static int luaB_next (lua_State *L) {
  216. luaL_checktype(L, 1, LUA_TTABLE);
  217. lua_settop(L, 2); /* create a 2nd argument if there isn't one */
  218. if (lua_next(L, 1))
  219. return 2;
  220. else {
  221. lua_pushnil(L);
  222. return 1;
  223. }
  224. }
  225. static int luaB_pairs (lua_State *L) {
  226. luaL_checkany(L, 1);
  227. if (luaL_getmetafield(L, 1, "__pairs") == LUA_TNIL) { /* no metamethod? */
  228. lua_pushcfunction(L, luaB_next); /* will return generator, */
  229. lua_pushvalue(L, 1); /* state, */
  230. lua_pushnil(L); /* and initial value */
  231. }
  232. else {
  233. lua_pushvalue(L, 1); /* argument 'self' to metamethod */
  234. lua_call(L, 1, 3); /* get 3 values from metamethod */
  235. }
  236. return 3;
  237. }
  238. /*
  239. ** Traversal function for 'ipairs'
  240. */
  241. static int ipairsaux (lua_State *L) {
  242. lua_Integer i = luaL_checkinteger(L, 2) + 1;
  243. lua_pushinteger(L, i);
  244. return (lua_geti(L, 1, i) == LUA_TNIL) ? 1 : 2;
  245. }
  246. /*
  247. ** 'ipairs' function. Returns 'ipairsaux', given "table", 0.
  248. ** (The given "table" may not be a table.)
  249. */
  250. static int luaB_ipairs (lua_State *L) {
  251. luaL_checkany(L, 1);
  252. lua_pushcfunction(L, ipairsaux); /* iteration function */
  253. lua_pushvalue(L, 1); /* state */
  254. lua_pushinteger(L, 0); /* initial value */
  255. return 3;
  256. }
  257. static int load_aux (lua_State *L, int status, int envidx) {
  258. if (status == LUA_OK) {
  259. if (envidx != 0) { /* 'env' parameter? */
  260. lua_pushvalue(L, envidx); /* environment for loaded function */
  261. if (!lua_setupvalue(L, -2, 1)) /* set it as 1st upvalue */
  262. lua_pop(L, 1); /* remove 'env' if not used by previous call */
  263. }
  264. return 1;
  265. }
  266. else { /* error (message is on top of the stack) */
  267. luaL_pushfail(L);
  268. lua_insert(L, -2); /* put before error message */
  269. return 2; /* return fail plus error message */
  270. }
  271. }
  272. static int luaB_loadfile (lua_State *L) {
  273. const char *fname = luaL_optstring(L, 1, NULL);
  274. const char *mode = luaL_optstring(L, 2, NULL);
  275. int env = (!lua_isnone(L, 3) ? 3 : 0); /* 'env' index or 0 if no 'env' */
  276. int status = luaL_loadfilex(L, fname, mode);
  277. return load_aux(L, status, env);
  278. }
  279. /*
  280. ** {======================================================
  281. ** Generic Read function
  282. ** =======================================================
  283. */
  284. /*
  285. ** reserved slot, above all arguments, to hold a copy of the returned
  286. ** string to avoid it being collected while parsed. 'load' has four
  287. ** optional arguments (chunk, source name, mode, and environment).
  288. */
  289. #define RESERVEDSLOT 5
  290. /*
  291. ** Reader for generic 'load' function: 'lua_load' uses the
  292. ** stack for internal stuff, so the reader cannot change the
  293. ** stack top. Instead, it keeps its resulting string in a
  294. ** reserved slot inside the stack.
  295. */
  296. static const char *generic_reader (lua_State *L, void *ud, size_t *size) {
  297. (void)(ud); /* not used */
  298. luaL_checkstack(L, 2, "too many nested functions");
  299. lua_pushvalue(L, 1); /* get function */
  300. lua_call(L, 0, 1); /* call it */
  301. if (lua_isnil(L, -1)) {
  302. lua_pop(L, 1); /* pop result */
  303. *size = 0;
  304. return NULL;
  305. }
  306. else if (!lua_isstring(L, -1))
  307. luaL_error(L, "reader function must return a string");
  308. lua_replace(L, RESERVEDSLOT); /* save string in reserved slot */
  309. return lua_tolstring(L, RESERVEDSLOT, size);
  310. }
  311. static int luaB_load (lua_State *L) {
  312. int status;
  313. size_t l;
  314. const char *s = lua_tolstring(L, 1, &l);
  315. const char *mode = luaL_optstring(L, 3, "bt");
  316. int env = (!lua_isnone(L, 4) ? 4 : 0); /* 'env' index or 0 if no 'env' */
  317. if (s != NULL) { /* loading a string? */
  318. const char *chunkname = luaL_optstring(L, 2, s);
  319. status = luaL_loadbufferx(L, s, l, chunkname, mode);
  320. }
  321. else { /* loading from a reader function */
  322. const char *chunkname = luaL_optstring(L, 2, "=(load)");
  323. luaL_checktype(L, 1, LUA_TFUNCTION);
  324. lua_settop(L, RESERVEDSLOT); /* create reserved slot */
  325. status = lua_load(L, generic_reader, NULL, chunkname, mode);
  326. }
  327. return load_aux(L, status, env);
  328. }
  329. /* }====================================================== */
  330. static int dofilecont (lua_State *L, int d1, lua_KContext d2) {
  331. (void)d1; (void)d2; /* only to match 'lua_Kfunction' prototype */
  332. return lua_gettop(L) - 1;
  333. }
  334. static int luaB_dofile (lua_State *L) {
  335. const char *fname = luaL_optstring(L, 1, NULL);
  336. lua_settop(L, 1);
  337. if (luaL_loadfile(L, fname) != LUA_OK)
  338. return lua_error(L);
  339. lua_callk(L, 0, LUA_MULTRET, 0, dofilecont);
  340. return dofilecont(L, 0, 0);
  341. }
  342. static int luaB_assert (lua_State *L) {
  343. if (lua_toboolean(L, 1)) /* condition is true? */
  344. return lua_gettop(L); /* return all arguments */
  345. else { /* error */
  346. luaL_checkany(L, 1); /* there must be a condition */
  347. lua_remove(L, 1); /* remove it */
  348. lua_pushliteral(L, "assertion failed!"); /* default message */
  349. lua_settop(L, 1); /* leave only message (default if no other one) */
  350. return luaB_error(L); /* call 'error' */
  351. }
  352. }
  353. static int luaB_select (lua_State *L) {
  354. int n = lua_gettop(L);
  355. if (lua_type(L, 1) == LUA_TSTRING && *lua_tostring(L, 1) == '#') {
  356. lua_pushinteger(L, n-1);
  357. return 1;
  358. }
  359. else {
  360. lua_Integer i = luaL_checkinteger(L, 1);
  361. if (i < 0) i = n + i;
  362. else if (i > n) i = n;
  363. luaL_argcheck(L, 1 <= i, 1, "index out of range");
  364. return n - (int)i;
  365. }
  366. }
  367. /*
  368. ** Continuation function for 'pcall' and 'xpcall'. Both functions
  369. ** already pushed a 'true' before doing the call, so in case of success
  370. ** 'finishpcall' only has to return everything in the stack minus
  371. ** 'extra' values (where 'extra' is exactly the number of items to be
  372. ** ignored).
  373. */
  374. static int finishpcall (lua_State *L, int status, lua_KContext extra) {
  375. if (status != LUA_OK && status != LUA_YIELD) { /* error? */
  376. lua_pushboolean(L, 0); /* first result (false) */
  377. lua_pushvalue(L, -2); /* error message */
  378. return 2; /* return false, msg */
  379. }
  380. else
  381. return lua_gettop(L) - (int)extra; /* return all results */
  382. }
  383. static int luaB_pcall (lua_State *L) {
  384. int status;
  385. luaL_checkany(L, 1);
  386. lua_pushboolean(L, 1); /* first result if no errors */
  387. lua_insert(L, 1); /* put it in place */
  388. status = lua_pcallk(L, lua_gettop(L) - 2, LUA_MULTRET, 0, 0, finishpcall);
  389. return finishpcall(L, status, 0);
  390. }
  391. /*
  392. ** Do a protected call with error handling. After 'lua_rotate', the
  393. ** stack will have <f, err, true, f, [args...]>; so, the function passes
  394. ** 2 to 'finishpcall' to skip the 2 first values when returning results.
  395. */
  396. static int luaB_xpcall (lua_State *L) {
  397. int status;
  398. int n = lua_gettop(L);
  399. luaL_checktype(L, 2, LUA_TFUNCTION); /* check error function */
  400. lua_pushboolean(L, 1); /* first result */
  401. lua_pushvalue(L, 1); /* function */
  402. lua_rotate(L, 3, 2); /* move them below function's arguments */
  403. status = lua_pcallk(L, n - 2, LUA_MULTRET, 2, 2, finishpcall);
  404. return finishpcall(L, status, 2);
  405. }
  406. static int luaB_tostring (lua_State *L) {
  407. luaL_checkany(L, 1);
  408. luaL_tolstring(L, 1, NULL);
  409. return 1;
  410. }
  411. static const luaL_Reg base_funcs[] = {
  412. {"assert", luaB_assert},
  413. {"collectgarbage", luaB_collectgarbage},
  414. {"dofile", luaB_dofile},
  415. {"error", luaB_error},
  416. {"getmetatable", luaB_getmetatable},
  417. {"ipairs", luaB_ipairs},
  418. {"loadfile", luaB_loadfile},
  419. {"load", luaB_load},
  420. {"next", luaB_next},
  421. {"pairs", luaB_pairs},
  422. {"pcall", luaB_pcall},
  423. {"print", luaB_print},
  424. {"warn", luaB_warn},
  425. {"rawequal", luaB_rawequal},
  426. {"rawlen", luaB_rawlen},
  427. {"rawget", luaB_rawget},
  428. {"rawset", luaB_rawset},
  429. {"select", luaB_select},
  430. {"setmetatable", luaB_setmetatable},
  431. {"tonumber", luaB_tonumber},
  432. {"tostring", luaB_tostring},
  433. {"type", luaB_type},
  434. {"xpcall", luaB_xpcall},
  435. /* placeholders */
  436. {LUA_GNAME, NULL},
  437. {"_VERSION", NULL},
  438. {NULL, NULL}
  439. };
  440. LUAMOD_API int luaopen_base (lua_State *L) {
  441. /* open lib into global table */
  442. lua_pushglobaltable(L);
  443. luaL_setfuncs(L, base_funcs, 0);
  444. /* set global _G */
  445. lua_pushvalue(L, -1);
  446. lua_setfield(L, -2, LUA_GNAME);
  447. /* set global _VERSION */
  448. lua_pushliteral(L, LUA_VERSION);
  449. lua_setfield(L, -2, "_VERSION");
  450. return 1;
  451. }