JSON module for AutoHotkey
Requires AutoHotkey v1.1.17.00+ OR 2.0-a057+
License: WTFPL
There are multiple version(s) available (as branches) in this repo to provide support for different AutoHotkey builds. The master branch is for v1.1
(except for Json2.ahk which is version independent) while the v2 branch is for AHK v2.0-a
.
Deserialize src (a JSON formatted string) to an AutoHotkey object
obj := JSON.parse( src [, jsonize := false ] )
An AutoHotkey object
- src [in] - JSON formatted string
- jsonize [in, opt] - if true, objects(
{}
) and arrays([]
) are wrapped as JSON.object and JSON.array instances respectively. This is to compensate for AutoHotkey's non-distinction between these types and other AHK object type quirks. e.g.: In AutoHotkey, object keys are enumerated in alphabetical order not in the sequence in which they are created
serialize obj to a JSON formatted string
str := JSON.stringify( obj, [, indent := "" ] )
A JSON formatted string
- obj [in] - AutoHotkey object. Non-standard AHK objects like COM, Func, FileObject, RegExMatchObject are not supported.
- indent [in, opt] -if indent is a non-negative integer or string, then JSON array elements and object members will be pretty-printed with that indent level. Blank(
""
) (the default) or0
selects the most compact representation. Using a positive integer indent indents that many spaces per level. If indent is a string (such as"`t"
), that string is used to indent each level. (I'm lazy, wording taken from Python docs)
Similar to the JSON class above just implemented as a function. Unlike JSON (class) above, this implementation provides reading from and writing to file. Works on both AutoHotkey v1.1 and v2.0
Deserialize src (a JSON formatted string) to an AutoHotkey object
obj := Jxon_Load( src [ , object_base := "", array_base := "" ] )
- src [in] - JSON formatted string or path to the file containing JSON formatted string.
- object_base [in, opt] - an object to use as prototype for objects(
{}
) created during parsing. - array_base [in, opt] - an object to use as prototype for arrays(
[]
) created during parsing.
Serialize obj to a JSON formatted string
str := Jxon_Dump( obj [ , indent := "" ] )
A JSON formatted string.
- obj [in] - this argument has the same meaning as in JSON.stringify()
- indent [in, opt] - this argument has the same meaning as in JSON.stringify()
Similar to Jxon_Load()
except src is a path to the file containing a JSON document.
Jxon_Read( src [ , object_base := "", array_base := "" ] )
- - -
Similar to Jxon_Dump()
except output is written to dest. The number of bytes written is returned if successful.
bytes_written := Jxon_Write( obj , dest [ , indent := "" ] )