2
** $Id: liolib.c,v 2.73.1.3 2008/01/18 17:47:43 roberto Exp $
3
** Standard I/O (and system) library
4
** See Copyright Notice in lua.h
27
static const char *const fnames[] = {"input", "output"};
30
static int pushresult (lua_State *L, int i, const char *filename) {
31
int en = errno; /* calls to Lua API may change this value */
33
lua_pushboolean(L, 1);
39
lua_pushfstring(L, "%s: %s", filename, strerror(en));
41
lua_pushfstring(L, "%s", strerror(en));
42
lua_pushinteger(L, en);
48
static void fileerror (lua_State *L, int arg, const char *filename) {
49
lua_pushfstring(L, "%s: %s", filename, strerror(errno));
50
luaL_argerror(L, arg, lua_tostring(L, -1));
54
#define tofilep(L) ((FILE **)luaL_checkudata(L, 1, LUA_FILEHANDLE))
57
static int io_type (lua_State *L) {
60
ud = lua_touserdata(L, 1);
61
lua_getfield(L, LUA_REGISTRYINDEX, LUA_FILEHANDLE);
62
if (ud == NULL || !lua_getmetatable(L, 1) || !lua_rawequal(L, -2, -1))
63
lua_pushnil(L); /* not a file */
64
else if (*((FILE **)ud) == NULL)
65
lua_pushliteral(L, "closed file");
67
lua_pushliteral(L, "file");
72
static FILE *tofile (lua_State *L) {
73
FILE **f = tofilep(L);
75
luaL_error(L, "attempt to use a closed file");
82
** When creating file handles, always creates a `closed' file handle
83
** before opening the actual file; so, if there is a memory error, the
84
** file is not left opened.
86
static FILE **newfile (lua_State *L) {
87
FILE **pf = (FILE **)lua_newuserdata(L, sizeof(FILE *));
88
*pf = NULL; /* file handle is currently `closed' */
89
luaL_getmetatable(L, LUA_FILEHANDLE);
90
lua_setmetatable(L, -2);
96
** function to (not) close the standard files stdin, stdout, and stderr
98
static int io_noclose (lua_State *L) {
100
lua_pushliteral(L, "cannot close standard file");
106
** function to close 'popen' files
108
static int io_pclose (lua_State *L) {
109
FILE **p = tofilep(L);
110
int ok = lua_pclose(L, *p);
112
return pushresult(L, ok, NULL);
117
** function to close regular files
119
static int io_fclose (lua_State *L) {
120
FILE **p = tofilep(L);
121
int ok = (fclose(*p) == 0);
123
return pushresult(L, ok, NULL);
127
static int aux_close (lua_State *L) {
129
lua_getfield(L, -1, "__close");
130
return (lua_tocfunction(L, -1))(L);
134
static int io_close (lua_State *L) {
135
if (lua_isnone(L, 1))
136
lua_rawgeti(L, LUA_ENVIRONINDEX, IO_OUTPUT);
137
tofile(L); /* make sure argument is a file */
142
static int io_gc (lua_State *L) {
143
FILE *f = *tofilep(L);
144
/* ignore closed files */
151
static int io_tostring (lua_State *L) {
152
FILE *f = *tofilep(L);
154
lua_pushliteral(L, "file (closed)");
156
lua_pushfstring(L, "file (%p)", f);
161
static int io_open (lua_State *L) {
162
const char *filename = luaL_checkstring(L, 1);
163
const char *mode = luaL_optstring(L, 2, "r");
164
FILE **pf = newfile(L);
165
*pf = fopen(filename, mode);
166
return (*pf == NULL) ? pushresult(L, 0, filename) : 1;
171
** this function has a separated environment, which defines the
172
** correct __close for 'popen' files
174
static int io_popen (lua_State *L) {
175
const char *filename = luaL_checkstring(L, 1);
176
const char *mode = luaL_optstring(L, 2, "r");
177
FILE **pf = newfile(L);
178
*pf = lua_popen(L, filename, mode);
179
return (*pf == NULL) ? pushresult(L, 0, filename) : 1;
183
static int io_tmpfile (lua_State *L) {
184
FILE **pf = newfile(L);
186
return (*pf == NULL) ? pushresult(L, 0, NULL) : 1;
190
static FILE *getiofile (lua_State *L, int findex) {
192
lua_rawgeti(L, LUA_ENVIRONINDEX, findex);
193
f = *(FILE **)lua_touserdata(L, -1);
195
luaL_error(L, "standard %s file is closed", fnames[findex - 1]);
200
static int g_iofile (lua_State *L, int f, const char *mode) {
201
if (!lua_isnoneornil(L, 1)) {
202
const char *filename = lua_tostring(L, 1);
204
FILE **pf = newfile(L);
205
*pf = fopen(filename, mode);
207
fileerror(L, 1, filename);
210
tofile(L); /* check that it's a valid file handle */
213
lua_rawseti(L, LUA_ENVIRONINDEX, f);
215
/* return current value */
216
lua_rawgeti(L, LUA_ENVIRONINDEX, f);
221
static int io_input (lua_State *L) {
222
return g_iofile(L, IO_INPUT, "r");
226
static int io_output (lua_State *L) {
227
return g_iofile(L, IO_OUTPUT, "w");
231
static int io_readline (lua_State *L);
234
static void aux_lines (lua_State *L, int idx, int toclose) {
235
lua_pushvalue(L, idx);
236
lua_pushboolean(L, toclose); /* close/not close file when finished */
237
lua_pushcclosure(L, io_readline, 2);
241
static int f_lines (lua_State *L) {
242
tofile(L); /* check that it's a valid file handle */
248
static int io_lines (lua_State *L) {
249
if (lua_isnoneornil(L, 1)) { /* no arguments? */
250
/* will iterate over default input */
251
lua_rawgeti(L, LUA_ENVIRONINDEX, IO_INPUT);
255
const char *filename = luaL_checkstring(L, 1);
256
FILE **pf = newfile(L);
257
*pf = fopen(filename, "r");
259
fileerror(L, 1, filename);
260
aux_lines(L, lua_gettop(L), 1);
267
** {======================================================
269
** =======================================================
273
static int read_number (lua_State *L, FILE *f) {
275
if (fscanf(f, LUA_NUMBER_SCAN, &d) == 1) {
276
lua_pushnumber(L, d);
279
else return 0; /* read fails */
283
static int test_eof (lua_State *L, FILE *f) {
286
lua_pushlstring(L, NULL, 0);
291
static int read_line (lua_State *L, FILE *f) {
293
luaL_buffinit(L, &b);
296
char *p = luaL_prepbuffer(&b);
297
if (fgets(p, LUAL_BUFFERSIZE, f) == NULL) { /* eof? */
298
luaL_pushresult(&b); /* close buffer */
299
return (lua_objlen(L, -1) > 0); /* check whether read something */
302
if (l == 0 || p[l-1] != '\n')
305
luaL_addsize(&b, l - 1); /* do not include `eol' */
306
luaL_pushresult(&b); /* close buffer */
307
return 1; /* read at least an `eol' */
313
static int read_chars (lua_State *L, FILE *f, size_t n) {
314
size_t rlen; /* how much to read */
315
size_t nr; /* number of chars actually read */
317
luaL_buffinit(L, &b);
318
rlen = LUAL_BUFFERSIZE; /* try to read that much each time */
320
char *p = luaL_prepbuffer(&b);
321
if (rlen > n) rlen = n; /* cannot read more than asked */
322
nr = fread(p, sizeof(char), rlen, f);
323
luaL_addsize(&b, nr);
324
n -= nr; /* still have to read `n' chars */
325
} while (n > 0 && nr == rlen); /* until end of count or eof */
326
luaL_pushresult(&b); /* close buffer */
327
return (n == 0 || lua_objlen(L, -1) > 0);
331
static int g_read (lua_State *L, FILE *f, int first) {
332
int nargs = lua_gettop(L) - 1;
336
if (nargs == 0) { /* no arguments? */
337
success = read_line(L, f);
338
n = first+1; /* to return 1 result */
340
else { /* ensure stack space for all results and for auxlib's buffer */
341
luaL_checkstack(L, nargs+LUA_MINSTACK, "too many arguments");
343
for (n = first; nargs-- && success; n++) {
344
if (lua_type(L, n) == LUA_TNUMBER) {
345
size_t l = (size_t)lua_tointeger(L, n);
346
success = (l == 0) ? test_eof(L, f) : read_chars(L, f, l);
349
const char *p = lua_tostring(L, n);
350
luaL_argcheck(L, p && p[0] == '*', n, "invalid option");
352
case 'n': /* number */
353
success = read_number(L, f);
356
success = read_line(L, f);
359
read_chars(L, f, ~((size_t)0)); /* read MAX_SIZE_T chars */
360
success = 1; /* always success */
363
return luaL_argerror(L, n, "invalid format");
369
return pushresult(L, 0, NULL);
371
lua_pop(L, 1); /* remove last result */
372
lua_pushnil(L); /* push nil instead */
378
static int io_read (lua_State *L) {
379
return g_read(L, getiofile(L, IO_INPUT), 1);
383
static int f_read (lua_State *L) {
384
return g_read(L, tofile(L), 2);
388
static int io_readline (lua_State *L) {
389
FILE *f = *(FILE **)lua_touserdata(L, lua_upvalueindex(1));
391
if (f == NULL) /* file is already closed? */
392
luaL_error(L, "file is already closed");
393
sucess = read_line(L, f);
395
return luaL_error(L, "%s", strerror(errno));
396
if (sucess) return 1;
398
if (lua_toboolean(L, lua_upvalueindex(2))) { /* generator created file? */
400
lua_pushvalue(L, lua_upvalueindex(1));
401
aux_close(L); /* close it */
407
/* }====================================================== */
410
static int g_write (lua_State *L, FILE *f, int arg) {
411
int nargs = lua_gettop(L) - 1;
413
for (; nargs--; arg++) {
414
if (lua_type(L, arg) == LUA_TNUMBER) {
415
/* optimization: could be done exactly as for strings */
417
fprintf(f, LUA_NUMBER_FMT, lua_tonumber(L, arg)) > 0;
421
const char *s = luaL_checklstring(L, arg, &l);
422
status = status && (fwrite(s, sizeof(char), l, f) == l);
425
return pushresult(L, status, NULL);
429
static int io_write (lua_State *L) {
430
return g_write(L, getiofile(L, IO_OUTPUT), 1);
434
static int f_write (lua_State *L) {
435
return g_write(L, tofile(L), 2);
439
static int f_seek (lua_State *L) {
440
static const int mode[] = {SEEK_SET, SEEK_CUR, SEEK_END};
441
static const char *const modenames[] = {"set", "cur", "end", NULL};
443
int op = luaL_checkoption(L, 2, "cur", modenames);
444
long offset = luaL_optlong(L, 3, 0);
445
op = fseek(f, offset, mode[op]);
447
return pushresult(L, 0, NULL); /* error */
449
lua_pushinteger(L, ftell(f));
455
static int f_setvbuf (lua_State *L) {
456
static const int mode[] = {_IONBF, _IOFBF, _IOLBF};
457
static const char *const modenames[] = {"no", "full", "line", NULL};
459
int op = luaL_checkoption(L, 2, NULL, modenames);
460
lua_Integer sz = luaL_optinteger(L, 3, LUAL_BUFFERSIZE);
461
int res = setvbuf(f, NULL, mode[op], sz);
462
return pushresult(L, res == 0, NULL);
467
static int io_flush (lua_State *L) {
468
return pushresult(L, fflush(getiofile(L, IO_OUTPUT)) == 0, NULL);
472
static int f_flush (lua_State *L) {
473
return pushresult(L, fflush(tofile(L)) == 0, NULL);
477
static const luaL_Reg iolib[] = {
483
{"output", io_output},
486
{"tmpfile", io_tmpfile},
493
static const luaL_Reg flib[] = {
499
{"setvbuf", f_setvbuf},
502
{"__tostring", io_tostring},
507
static void createmeta (lua_State *L) {
508
luaL_newmetatable(L, LUA_FILEHANDLE); /* create metatable for file handles */
509
lua_pushvalue(L, -1); /* push metatable */
510
lua_setfield(L, -2, "__index"); /* metatable.__index = metatable */
511
luaL_register(L, NULL, flib); /* file methods */
515
static void createstdfile (lua_State *L, FILE *f, int k, const char *fname) {
518
lua_pushvalue(L, -1);
519
lua_rawseti(L, LUA_ENVIRONINDEX, k);
521
lua_pushvalue(L, -2); /* copy environment */
522
lua_setfenv(L, -2); /* set it */
523
lua_setfield(L, -3, fname);
527
static void newfenv (lua_State *L, lua_CFunction cls) {
528
lua_createtable(L, 0, 1);
529
lua_pushcfunction(L, cls);
530
lua_setfield(L, -2, "__close");
534
LUALIB_API int luaopen_io (lua_State *L) {
536
/* create (private) environment (with fields IO_INPUT, IO_OUTPUT, __close) */
537
newfenv(L, io_fclose);
538
lua_replace(L, LUA_ENVIRONINDEX);
540
luaL_register(L, LUA_IOLIBNAME, iolib);
541
/* create (and set) default files */
542
newfenv(L, io_noclose); /* close function for default files */
543
createstdfile(L, stdin, IO_INPUT, "stdin");
544
createstdfile(L, stdout, IO_OUTPUT, "stdout");
545
createstdfile(L, stderr, 0, "stderr");
546
lua_pop(L, 1); /* pop environment for default files */
547
lua_getfield(L, -1, "popen");
548
newfenv(L, io_pclose); /* create environment for 'popen' */
549
lua_setfenv(L, -2); /* set fenv for 'popen' */
550
lua_pop(L, 1); /* pop 'popen' */