ObjDump

Dump an object to memory or save to file for later use. Dumped object can be compressed and encrypted using a password.

OutputVar := ObjDump(Object , Password)
Function Example: DumpBuffer := ObjDump(obj)

Parameters

OutputVar: The name of the variable in which to store the buffer containing dumped object.
Object: The object to be dumped.
Password (optional): If this parameter is omitted, dumped buffer will not be compressed and not encrypted. If password is an empty string (""), dumped object will be compressed without encryption.

General Remarks

Only following objects and items are supported:

Object: properties
Map and Array: items and properties
Buffer: memory buffer and properties
Struct is converted to unsorted Map
ComObjValue: VT_EMPTY, VT_NULL, VT_BOOL, VT_I2, VT_I4, VT_R4, VT_R8, VT_CY, VT_DATE, VT_BSTR, VT_I1, VT_UI1, VT_UI2, VT_, VT_UI4, VT_I8, VT_UI8, VT_INT, VT_UINT
Other types of Objects are not supported

For user defined classes "base" is not saved and can not be restored.
Unsorted Objects, Arrays and Maps are supported too.

Related

Examples

; Create a simple object
obj := {key:"value",1:"test",2:10}

; Dump an object to variable.
buf := ObjDump(obj)
; Get the dump size of an object 
MsgBox buf.size

; Restore an object from variable
obj := ObjLoad(buf)

; Dump an object to file
f:=FileOpen(A_ScriptDir "\MyDump.bin","w -rwd")
f.RawWrite(ObjDump(obj)),f.Close()

; Restore an object from file
obj := ObjLoad(A_ScriptDir "\MyDump.bin")