Sagittarius Users' Reference

(text json mutable) - Mutable JSON

This library provides an mutable JSON representation.

The following example shows how to use:

(import (rnrs)
        (text json mutable))

(define json '#(("key" . "value")))
(define mutable-json (json->mutable-json json))

(mutable-json-object-set! mutable-json "key" '#(("value" . "as object")))

(mutable-json->json mutable-json)
;; -> #(("key" . #(("value" . "as object"))))

Function json->mutable-json json

Converts the given json to a mutable JSON.

Function mutable-json->json mutable-json

Converts the given mutable-json to a JSON.

Function mutable-json? obj

Returns #t if the given obj is a mutable JSON, otherwise #f.

Mutable JSON object consists with 2 containers

Mutable JSON object
Mutable JSON array

Mutable JSON object

Mutable JSON object is a JSON object. The difference is a mutable JSON object doesn't allow to have multiple identical keys while JSON object allows it.

Function mutable-json-object? obj

Returns #t if the given obj is a mutable JSON object, otherwise #f.

Function mutable-json-object-set! mutable-json-object key value

Associates the given key and value to the mutable-json.

Function mutable-json-object-merge! mutable-json-object mutable-json-object1 ... mutable-json-object*

Merges the mutable-json-object1 and mutable-json-object* into mutable-json-object.

Function mutable-json-object-delete! mutable-json-object key

Remves the given key from the mutable-json-object.

Function mutable-json-object-contains? mutable-json-object key

Returns #t if the given key exists in the mutable-json-object, otherwise #f.

Function mutable-json-object-ref mutable-json-object key

Returns the value associated with the given key in the mutable-json-object, otherwise returns mutable JSON not foundobject.

Function mutable-json-not-found? obj

Returns #t if the given obj is a mutable JSON not found, otherwise #f.

Mutable JSON array

Mutable JSON array is a JSON array with capability of expansion or shrinking.

Function mutable-json-array? obj

Returns #t if the given obj is a mutable JSON array otherwise #f.

Function mutable-json-array-set! mutable-json-array index value

Sets the given value value to the _mutable-json-array_on position of index.

Function mutable-json-array-insert! mutable-json-array index value

Insets the given value value to the _mutable-json-array_on position of index.

Function mutable-json-array-delete! mutable-json-array index

Deletes the value of given _mutable-json-array_on position of index and shrink it.

Function mutable-json-array-ref mutable-json-array index

Retrieves the value of mutable-json-array on position of index.

Function mutable-json-array-size mutable-json-array

Returns the size of the given mutable-json-array.