Next: Introduction, Previous: (dir), Up: (dir) [Contents][Index]
This is the yason Reference Manual, version 0.8.3, generated automatically by Declt version 4.0 beta 2 "William Riker" on Thu Sep 15 06:33:40 2022 GMT+0.
Next: Systems, Previous: The yason Reference Manual, Up: The yason Reference Manual [Contents][Index]
YASON is a Common Lisp library for encoding and decoding data in the JSON interchange format. JSON is used as a lightweight alternative to XML. YASON has the sole purpose of encoding and decoding data and does not impose any object model on the Common Lisp application that uses it.
Please proceed to the Documentation
This project was maintained by https://github.com/hanshuebner/ until 2019.
Next: Files, Previous: Introduction, Up: The yason Reference Manual [Contents][Index]
The main system appears first, followed by any subsystem dependency.
JSON parser/encoder
Hans Huebner <hans@huebner.org>
BSD
YASON is a Common Lisp library for encoding and
decoding data in the JSON interchange format. JSON is used as a
lightweight alternative to XML. YASON has the sole purpose of
encoding and decoding data and does not impose any object model on
the Common Lisp application that uses it.
0.8.3
Next: Packages, Previous: Systems, Up: The yason Reference Manual [Contents][Index]
Files are sorted by type and then listed depth-first from the systems components trees.
Next: yason/package.lisp, Previous: Lisp, Up: Lisp [Contents][Index]
yason (system).
Next: yason/encode.lisp, Previous: yason/yason.asd, Up: Lisp [Contents][Index]
Next: yason/parse.lisp, Previous: yason/package.lisp, Up: Lisp [Contents][Index]
package.lisp (file).
yason (system).
Previous: yason/encode.lisp, Up: Lisp [Contents][Index]
package.lisp (file).
yason (system).
Next: Definitions, Previous: Files, Up: The yason Reference Manual [Contents][Index]
Packages are listed by definition order.
Next: yason.system, Previous: Packages, Up: Packages [Contents][Index]
common-lisp.
Next: Indexes, Previous: Packages, Up: The yason Reference Manual [Contents][Index]
Definitions are sorted by export status, category, package, and then by lexicographic order.
Next: Internals, Previous: Definitions, Up: Definitions [Contents][Index]
Next: Macros, Previous: Public Interface, Up: Public Interface [Contents][Index]
The actual function used to encode a LIST.
Can be changed to encode ALISTs or PLISTs as dictionaries by
setting it to ENCODE-ALIST or ENCODE-PLIST.
If set to a true value, JSON arrays will be parsed as vectors, not as lists.
If set to a true value, JSON booleans will be read as the symbols TRUE and FALSE, not as T and NIL, respectively.
If set to a true value, JSON nulls will be read as the keyword :NULL, not as NIL.
Set to either :hash-table, :plist or :alist to determine the data structure that objects are parsed to.
DEPRECATED, provided for backward compatibility
Function to call to convert a key string in a JSON array to a key in the CL hash produced.
The actual function used to encode a SYMBOL. You might want ENCODE-SYMBOL-AS-LOWERCASE or ENCODE-SYMBOL-AS-STRING here.
The actual function used to encode a SYMBOL when seen as a key.
You might want ENCODE-SYMBOL-AS-LOWERCASE or
ENCODE-SYMBOL-AS-STRING here.
The function returns just a string - the quotes are added when writing the key.
Next: Compiler macros, Previous: Special variables, Up: Public Interface [Contents][Index]
Open a JSON array, then run BODY. Inside the body, ENCODE-ARRAY-ELEMENT or nested WITH-ARRAY resp. WITH-OBJECT must be used to encode elements to the opened array. Must be called within an existing JSON encoder context, see WITH-OUTPUT and WITH-OUTPUT-TO-STRING*.
Open a JSON object, then run BODY. Inside the body, ENCODE-OBJECT-ELEMENT or WITH-OBJECT-ELEMENT must be called to encode elements to the object. Must be called within an existing JSON encoder context, see WITH-OUTPUT and WITH-OUTPUT-TO-STRING*.
Open a new encoding context to encode a JSON object element. KEY is the key of the element. The value will be whatever BODY serializes to the current JSON output context using one of the stream encoding functions. This can be used to stream out nested object structures.
Set up a JSON streaming encoder context on STREAM, then evaluate BODY.
Set up a JSON streaming encoder context, then evaluate BODY. Return a string with the generated JSON output.
Next: Ordinary functions, Previous: Macros, Up: Public Interface [Contents][Index]
Compiler macro to allow open-coding with ENCODE-OBJECT-SLOTS when slots are a literal list.
Next: Generic functions, Previous: Compiler macros, Up: Public Interface [Contents][Index]
Encode OBJECT as next array element to the last JSON array opened with WITH-ARRAY in the dynamic context. OBJECT is encoded using the ENCODE generic function, so it must be of a type for which an ENCODE method is defined.
Encode OBJECTS, a list of JSON encodable objects, as array elements.
Encode KEY and VALUE as object element to the last JSON object opened with WITH-OBJECT in the dynamic context. KEY and VALUE are encoded using the ENCODE generic function, so they both must be of a type for which an ENCODE method is defined.
Encode plist ELEMENTS as object elements.
For each slot in SLOTS, encode that slot on OBJECT as an object element. Equivalent to calling ENCODE-OBJECT-ELEMENT for each slot where the key is the slot name, and the value is the (SLOT-VALUE OBJECT slot). LOWERCASE-KEYS? says whether the key should be in lowercase.
Encodes a symbol KEY as a lowercase string.
Ensure that there’s no intentional lower-case character lost.
Encodes a symbol SYM as string PACKAGE:SYMBOL-NAME.
Always prints a double colon, as exportedness
might not make sense for the receiver;
this way reading the input in again is consistent.
Preserves case.
Breaks if the package name includes colons.
Parse INPUT, which needs to be a string or a stream, as JSON. Returns the lisp representation of the JSON structure parsed. The keyword arguments can be used to override the parser settings as defined by the respective special variables.
Next: Standalone methods, Previous: Ordinary functions, Up: Public Interface [Contents][Index]
Encode OBJECT to STREAM in JSON format. May be
specialized by applications to perform specific rendering.
STREAM must be a JSON-OUTPUT-STREAM; you can get one via
MAKE-JSON-OUTPUT-STREAM, WITH-OUTPUT, or WITH-OUTPUT-TO-STRING*.
Generic function to encode an object. The default implementation opens a new object encoding context and calls ENCODE-SLOTS on the argument.
Generic function to encode object slots. It should be called in an object encoding context. It uses PROGN combination with MOST-SPECIFIC-LAST order, so that base class slots are encoded before derived class slots.
progn.
:most-specific-last
Create a JSON output stream with indentation enabled.
Next: Conditions, Previous: Generic functions, Up: Public Interface [Contents][Index]
sb-gray.
Previous: Standalone methods, Up: Public Interface [Contents][Index]
This condition is signalled when one of the stream encoding function is used outside the dynamic context of a WITH-OUTPUT or WITH-OUTPUT-TO-STRING* body.
error.
Previous: Public Interface, Up: Definitions [Contents][Index]
Next: Special variables, Previous: Internals, Up: Internals [Contents][Index]
Default length of strings that are created while reading json input.
Initial size of JSON arrays read, they will grow as needed.
Set to T or an numeric indentation width in order to have YASON indent its output by default.
Default indentation width for output if indentation is selected with no indentation width specified.
Next: Ordinary functions, Previous: Special variables, Up: Internals [Contents][Index]
Set up serialization context for aggregate serialization with the object encoder.
Set up context for aggregate serialization for the stream encoder.
Next: Generic functions, Previous: Macros, Up: Internals [Contents][Index]
Parse JSON array from input, calling ADD-ELEMENT-FUNCTION for each array element parsed.
Return an adjustable empty string, usable as a buffer for parsing strings and numbers.
stg.
Next: Conditions, Previous: Ordinary functions, Up: Internals [Contents][Index]
automatically generated reader method
automatically generated reader method
automatically generated writer method
automatically generated reader method
automatically generated writer method
automatically generated reader method
automatically generated reader method
automatically generated writer method
Next: Structures, Previous: Generic functions, Up: Internals [Contents][Index]
error.
:key-string
This slot is read-only.
error.
:key-string
This slot is read-only.
error.
:key-string
This slot is read-only.
Next: Classes, Previous: Conditions, Up: Internals [Contents][Index]
Escape mechanism to allow more intricate JSON exports.
(MAKE-RAW-JSON-OUTPUT X)
causes the string X to be written to the JSON output verbatim,
ie. without any encoding.
(Bad) example:
(yason:encode (vector 1 2 (make-raw-json-output "{}")
structure-object.
string
Previous: Structures, Up: Internals [Contents][Index]
Objects of this class capture the state of a JSON stream encoder.
fundamental-character-output-stream.
| Initarg | Value |
|---|---|
| :indent | *default-indent* |
:output-stream
This slot is read-only.
0
:indent
Previous: Definitions, Up: The yason Reference Manual [Contents][Index]
| Jump to: | %
(
A C E F G I K M N O P R S U W |
|---|
| Jump to: | %
(
A C E F G I K M N O P R S U W |
|---|
Next: Data types, Previous: Functions, Up: Indexes [Contents][Index]
| Jump to: | *
+
C I K O S |
|---|
| Jump to: | *
+
C I K O S |
|---|
| Jump to: | C D E F J N P R S Y |
|---|
| Jump to: | C D E F J N P R S Y |
|---|