std:json

Contents

• JSON

JSON

import { JSON } from "std:json";

Run

The JSON namespace parses and stringifies JSON data. The same functions can also be imported directly: import { parse, stringify, stringifyPretty } from "std:json";.

Methods

static fn parse(json: String) -> Any

Parses a JSON string and returns the matching Pleno value: Map, Array, String, Int, Float, Bool or null. Invalid JSON throws an error.

import { JSON } from "std:json";

let data = JSON.parse(`{"name": "Alice", "age": 30}`);
print(data.name); // Alice
print(data.age);  // 30

try {
    JSON.parse("{bad");
} catch (e) {
    print(e.message); // JSON parse error: key must be a string at line 1 column 2
}

Run

static fn stringify(value: Any) -> String

Converts a Pleno value into a compact JSON string. Map keys keep their insertion order. Functions and other values with no JSON form become null.

import { JSON } from "std:json";

let obj = { "name": "Bob", "age": 25 };
print(JSON.stringify(obj)); // {"name":"Bob","age":25}

Run

static fn stringifyPretty(value: Any, indent: Int = 2) -> String

Converts a Pleno value into JSON on several lines, indenting nested values by indent spaces (0 to 16). The indent can be passed by position or by name.

import { JSON } from "std:json";

let obj = { "name": "Bob" };
print(JSON.stringifyPretty(obj, indent: 4));
// {
//     "name": "Bob"
// }

Run

---