lua/lundump.h

/*
** $Id: lundump.h $
** load precompiled Lua chunks
** See Copyright Notice in lua.h
*/

#ifndef lundump_h
#define lundump_h

#include <limits.h>

#include "llimits.h"
#include "lobject.h"
#include "lzio.h"


/* data to catch conversion errors */
#define LUAC_DATA	"\x19\x93\r\n\x1a\n"

#define LUAC_INT	0x5678
#define LUAC_NUM	cast_num(370.5)

/*
** Encode major-minor version in one byte, one nibble for each
*/
#define LUAC_VERSION	(LUA_VERSION_MAJOR_N*16+LUA_VERSION_MINOR_N)

#define LUAC_FORMAT	0	/* this is the official format */


/* load one chunk; from lundump.c */
LUAI_FUNC LClosure* luaU_undump (lua_State* L, ZIO* Z, const char* name,
                                               int fixed);

/* dump one chunk; from ldump.c */
LUAI_FUNC int luaU_dump (lua_State* L, const Proto* f, lua_Writer w,
                         void* data, int strip);

#endif
module to load bytecodes from files. 1998-01-14 23:49:01 +08:00			`/*`
Removed extra information from RCS keyword strings Version numbers and dates (mostly wrong) from RCS keyword strings removed from all source files; only the file name are kept. 2018-08-24 01:26:12 +08:00			`** $Id: lundump.h $`
new versions by lhf 2005-11-16 19:55:07 +08:00			`** load precompiled Lua chunks`
module to load bytecodes from files. 1998-01-14 23:49:01 +08:00			`** See Copyright Notice in lua.h`
			`*/`

			`#ifndef lundump_h`
			`#define lundump_h`

Revising code for Varint encoding in dumps - Usign lua_Unsigned to count strings. - Varint uses a type large enough both for size_t and lua_Unsigned. - Most-Significant Bit 0 means last byte, to conform to common usage. - (unrelated) Change in macro 'getaddr' so that multiplication is by constants. 2024-02-13 02:16:11 +08:00			`#include <limits.h>`

make sure that LUAC_INT is a lua_Integer and that LUAC_NUM is a lua_Number 2014-03-11 22:22:54 +08:00			`#include "llimits.h"`
module to load bytecodes from files. 1998-01-14 23:49:01 +08:00			`#include "lobject.h"`
			`#include "lzio.h"`

more explicit handling of headers for binary chunks 2014-02-28 00:56:20 +08:00
			`/* data to catch conversion errors */`
			`#define LUAC_DATA "\x19\x93\r\n\x1a\n"`

macros cast_integer/cast_unsigned replaced by cast_u2s/cast_s2u, that should be used only between lua_Integer and lua_Unsigned 2014-04-15 22:29:30 +08:00			`#define LUAC_INT 0x5678`
make sure that LUAC_INT is a lua_Integer and that LUAC_NUM is a lua_Number 2014-03-11 22:22:54 +08:00			`#define LUAC_NUM cast_num(370.5)`
more explicit handling of headers for binary chunks 2014-02-28 00:56:20 +08:00
Back to old encoding of versions in binary files (Undoing part of commit f53eabeed8.) It is better to keep this encoding stable, so that all Lua versions can read at least the version of a binary file. 2020-05-07 01:19:08 +08:00			`/*`
			`** Encode major-minor version in one byte, one nibble for each`
			`*/`
Details 2023-07-04 01:12:54 +08:00			`#define LUAC_VERSION (LUA_VERSION_MAJOR_N*16+LUA_VERSION_MINOR_N)`
Back to old encoding of versions in binary files (Undoing part of commit f53eabeed8.) It is better to keep this encoding stable, so that all Lua versions can read at least the version of a binary file. 2020-05-07 01:19:08 +08:00
more explicit handling of headers for binary chunks 2014-02-28 00:56:20 +08:00			`#define LUAC_FORMAT 0 /* this is the official format */`

Revising code for Varint encoding in dumps - Usign lua_Unsigned to count strings. - Varint uses a type large enough both for size_t and lua_Unsigned. - Most-Significant Bit 0 means last byte, to conform to common usage. - (unrelated) Change in macro 'getaddr' so that multiplication is by constants. 2024-02-13 02:16:11 +08:00
new versions from lhf 2002-06-06 01:26:23 +08:00			`/* load one chunk; from lundump.c */`
Added suport for Fixed Buffers A fixed buffer keeps a binary chunk "forever", so that the program does not need to copy some of its parts when loading it. 2023-09-06 02:30:45 +08:00			`LUAI_FUNC LClosure* luaU_undump (lua_State* L, ZIO* Z, const char* name,`
			`int fixed);`
modifications by lhf 1999-12-03 03:11:51 +08:00
dump/undump of upvalue names 2003-01-27 23:52:57 +08:00			`/* dump one chunk; from ldump.c */`
detail (breaking too long lines) 2014-03-11 03:52:47 +08:00			`LUAI_FUNC int luaU_dump (lua_State* L, const Proto* f, lua_Writer w,`
Cleaner protocol between 'lua_dump' and writer function 'lua_dump' signals to the writer function the end of a dump, so that is has more freedom when using the stack. 2023-12-14 22:41:57 +08:00			`void* data, int strip);`
new versions from lhf 2002-06-06 01:26:23 +08:00
new version by lhf. 1999-03-31 04:29:34 +08:00			`#endif`