lua-serialize

除了其他库也提供的序列化功能，本库增加了import机制来导入引用，一方面可以用以序列化函数，一方面使旧数据可以比较容易兼容新的程序改动，比较一般的做法是把函数，元表，以及资源字符串之类的部分作为引用导入。

serialize support 4 functions:

save(tbl,[import=nil,loader=error])

tbl: the table to save tbl: 要存储的table import: a value-location map, returned by import function 值-路径表由import函数生成 load(savestr,[import=nil,saver=error]) savestr:is returned by save. savestr:save生成的字符串 import: can be the table passed to import. import: 可以直接用存储时给import的参数 import(reftable,[flit=flit]) import{{A={1,2}}}=>{{1,2}={1,'A'}}.flit returns true if you want the value refed 如果希望一个值被引用, 就通过flit函数返回true flit(k,v,t) default by import import默认过滤函数,返回true表示可引用 return true if the value shall be refed

this serialize lib is compatible with lua5.14 lua5.32 and luajit2.0 support cycle, not support functions or userdata directly, use import and saver/loader for to catch function,userdata and coroutine. 能够处理环形引用, 不能直接function closure thread userdata，使用import导入引用表，或者通过saver函数转化成直接支持的类型，再通过loader函数返回

basic usage 基本用法 local slz=require'serialize'

local tt={1,2,3,4,str='Hello'}
tt.root=tt --cycle
local str=slz.save(tt)
local tc=slz.load(str)
print(str,tc.str,unpack(tc))

通过import函数使用引用方式存储函数

local mt={__index=function(t,k)return 'INDEX:'..k end}
local lib={mt,Str='Language', notused='notused'}
tt.strref=lib.Str
setmetatable(tt,mt)
str=slz.save(tt,slz.import(lib))

load时使用的表只需要提供被tt引用的成员即可(mt,Str), 值不必相同，可以用这种办法来使旧数据兼容新程序 tc=slz.load(str,{mt,Str='语言'}) print(str,tc.strref,tc.NotExist)

默认过滤函数： function flit(k,v,t) local kt,vt=type(k),type(v) return ( (kt=='number' and isint(k)) or kt=='string' or kt=='boolean') and vt~='number' and vt~='boolean' end import{1,A=96,[3.14]='PI',[true]='TURE'} 等效于 import{1,A=96,[true]='TURE'} import{1,A=96,[3.14]='PI',[true]='TURE'} equal to import{1,A=96,[true]='TURE'}

给入flit函数使序列化时不引用lib.Str use flit by avoid referencing lib.Str

str=slz.save(tt,slz.import(lib,function(k,v,t)return slz.flit(k,v,t) and v~=lib.Str end))
tc=slz.load(str,{mt,Str='String Three Not import'})
print(tc.strref)

如果要存储的值类型是function closure thread userdata 又不在import列表里会调用saver函数默认saver为error 既遇到没有import的function closure thread userdata直接报错

if a is not a function closure thread or userdata,and not imported, saver willbe called，the default saver function is error.

local function saveprint(fun)
	if fun==print then return 'print' end
end

local function loadprint(name)
	if name=='print' then return print end
end

tt={p=print}
str=slz.save(tt,nil,saveprint)
tc=slz.load(str,nil,loadprint)
tc.p'printing:Hello Word'

QSlash/lua-serialize

lua-serialize