cp.plist.archiver

Supports 'defrosting' a table which is made up from an 'NSKeyArchiver' record.

---

API Overview

Functions - API calls offered directly by the extension

• isPlist
• unarchive
• unarchiveBase64
• unarchiveFile

---

API Documentation

Functions

isPlist

Signature	cp.plist.archiver.isPlist(data) -> boolean
Type	Function
Description	Checks if the given data is a supported plist.
Parameters	data - The data to check.
Returns	true if the data is a supported plist, false otherwise.
Notes	None
Examples	None
Source	src/extensions/cp/plist/archiver.lua line 162

---

unarchive

Signature	cp.plist.archiver.unarchive(archive, defrostFn) -> table | nil, string
Type	Function
Description	Unarchives a LUA table which was archived into a plist using the NSKeyedArchiver.
Parameters	archive - the table containing the archive plist as a table defrostFn - (optional) a function which will be passed an object with a '$class' entry
Returns	The unarchived plist table
Notes	A 'defrost' function can be provided, which will be called whenever a table with a '$class' structure is present. It will receive the table and the classname and should either return a modified value if the class was handled, or nil if it was unable to handle the class. Eg: </li><li> local result = archiver.unarchive(archiveData, function(frozen, classname)</li><li> if classname == "XXMyClass" then</li><li> return MyClass:new(frozen.foo, frozen.bar)</li><li> end</li><li> return nil</li><li> end)</li><li>
Examples	None
Source	src/extensions/cp/plist/archiver.lua line 173

---

unarchiveBase64

Signature	cp.plist.archiver.unarchiveBase64(base64data, defrostFn) -> table | nil, string
Type	Function
Description	Unarchives a Base64 encoded string which was archived into a plist using the NSKeyedArchiver.
Parameters	base64data - the file containing the archive plist defrostFn - (optional) a function which will be passed an object with a '$class' entry
Returns	The unarchived plist.
Notes	A 'defrost' function can be provided, which will be called whenever a table with a '$class' structure is present. It will receive the table and the classname and should either return a modified value if the class was handled, or nil if it was unable to handle the class. Eg: </li><li> local result = archiver.unarchiveFile(filename, function(frozen, classname)</li><li> if classname == "XXMyClass" then</li><li> return MyClass:new(frozen.foo, frozen.bar)</li><li> end</li><li> return nil</li><li> end)</li><li>
Examples	None
Source	src/extensions/cp/plist/archiver.lua line 210

---

unarchiveFile

Signature	cp.plist.archiver.unarchiveFile(filename, defrostFn) -> table | nil, string
Type	Function
Description	Unarchives a plist file which was archived into a plist using the NSKeyedArchiver.
Parameters	filename - the file containing the archive plist defrostFn - (optional) a function which will be passed an object with a '$class' entry
Returns	The unarchived plist.
Notes	A 'defrost' function can be provided, which will be called whenever a table with a '$class' structure is present. It will receive the table and the classname and should either return a modified value if the class was handled, or nil if it was unable to handle the class. Eg: </li><li> local result = archiver.unarchiveFile(filename, function(frozen, classname)</li><li> if classname == "XXMyClass" then</li><li> return MyClass:new(frozen.foo, frozen.bar)</li><li> end</li><li> return nil</li><li> end)</li><li>
Examples	None
Source	src/extensions/cp/plist/archiver.lua line 243

---

---