There are no results.

Parsing and generating of JSON.

Parsing JSON

This module provides support for parsing and generating JSON, conforming to RFC 8259 (https://www.rfc-editor.org/rfc/rfc8259). Tests were performed against the test corpus provided by the article https://seriot.ch/projects/parsing_json.html. Extensions such as parsing NaN, Infinity, and comments are not supported.

The easiest way to parse JSON is using Json.parse:

import std.json (Json)

Json.parse('[10]').get # => Json.Array([Json.Int(10)])

The parser enforces limits on the number of nested objects and the size of strings. These limits can be adjusted by using the Parser type directly like so:

import std.json (Parser)

let parser = Parser.new('[10]')

parser.max_depth = 4
parser.max_string_size = 128
parser.parse

Generating JSON

Generating JSON strings is done using Json.to_string and Json.to_pretty_string:

import std.json (Json)

Json.Array([Json.Int(1), Json.Int(2)]).to_string # => '[1, 2]'

When using to_pretty_string, the default indentation is two spaces per indentation level. You can change this value by using the Generator type directly:

import std.json (Generator, Json)

let val = Json.Array([Json.Int(1), Json.Int(2)])
let gen = Generator.new(indent: 4)

gen.generate(val)

This would then produce the following JSON:

[
    1,
    2
]

Performance

The implementation provided by this module isn't optimised for maximum performance or optimal memory usage. Instead this module aims to provide an implementation that's good enough for most cases.

Classes