# hs.plist

Read and write Property List files

# API Overview

Functions - API calls offered directly by the extension

read
readString
write
writeString

# API Documentation

# Functions

# read


Signature	`hs.plist.read(filepath) -> table`
Type	Function
Description	Loads a Property List file
Parameters	filepath - The path and filename of a plist file to read
Returns	The contents of the plist as a Lua table
Notes	None
Examples	None
Source	extensions/plist/libplist.m line 4

# readString


Signature	`hs.plist.readString(value, [binary]) -> table \| nil`
Type	Function
Description	Interprets a property list file within a string into a table.
Parameters	value - The contents of the property list as a string binary - an optional boolean, specifying whether the value should be treated as raw binary (true) or as an UTF8 encoded string (false). If you do not provide this argument, the function will attempt to auto-detect the type.
Returns	The contents of the property list as a Lua table or `nil` if an error occurs
Notes	None
Examples	None
Source	extensions/plist/libplist.m line 23

# write


Signature	`hs.plist.write(filepath, data[, binary]) -> boolean`
Type	Function
Description	Writes a Property List file
Parameters	filepath - The path and filename of the plist file to write data - A Lua table containing the data to write into the plist binary - An optional boolean, if true, the plist will be written as a binary file. Defaults to false
Returns	A boolean, true if the plist was written successfully, otherwise false
Notes	Only simple types can be converted to plist items: Strings Numbers Booleans Tables You should be careful when reading a plist, modifying and writing it - Hammerspoon may not be able to preserve all of the datatypes via Lua
Examples	None
Source	extensions/plist/libplist.m line 100

# writeString


Signature	`hs.plist.writeString(data, [binary]) -> string \| nil`
Type	Function
Description	Interprets a property list file within a string into a table.
Parameters	data - A Lua table containing the data to write into a plist string binary - an optional boolean, default false, specifying that the resulting string should be encoded as a binary plist.
Returns	A string representing the data as a plist or nil if there was a problem with the date or serialization.
Notes	None
Examples	None
Source	extensions/plist/libplist.m line 62