use json

JSON parsing and querying without AST construction.

Constants

Functions

fn array_get_array

Get array element as nested array by index.

Signature: (json:str index:i64 -- value:str found:i64)

Example:

"[[1,2],[3,4]]" 0 json::array_get_array  // "[1,2]" 1

fn array_get_float

Get array element as float by index.

Signature: (json:str index:i64 -- value:f64 found:i64)

Example:

"[1.5,2.5]" 0 json::array_get_float  // 1.5 1

fn array_get_int

Get array element as integer by index.

Signature: (json:str index:i64 -- value:i64 found:i64)

Example:

"[10,20,30]" 2 json::array_get_int  // 30 1

fn array_get_object

Get array element as object by index.

Signature: (json:str index:i64 -- value:str found:i64)

Example:

"[{\"a\":1},{\"b\":2}]" 1 json::array_get_object  // "{\"b\":2}" 1

fn array_get_string

Get array element as string by index.

Signature: (json:str index:i64 -- value:str found:i64)

Example:

"[\"a\",\"b\"]" 1 json::array_get_string  // "b" 1

fn array_len

Get length of JSON array.

Signature: (json:str -- length:i64)

Example:

"[1,2,3]" json::array_len print  // 3

fn arr

Build a JSON array from comma-separated elements.

Signature: (content:str -- arr:str)

Example:

"1,2,3" json::arr print  // [1,2,3]

fn empty_arr

Build an empty JSON array.

Signature: ( -- arr:str)

Example:

json::empty_arr print  // []

fn empty_obj

Build an empty JSON object.

Signature: ( -- obj:str)

Example:

json::empty_obj print  // {}

fn encode

Encode a string for JSON (add quotes and escape special chars).

Signature: (s:str -- encoded:str)

Example:

"hello" json::encode print  // "hello"

fn extract_str

Extract string value at position.

Signature: (json:str pos:i64 -- value:str)

fn find_str_end

Find end of JSON string (pos at opening quote).

Signature: (json:str pos:i64 -- end_pos:i64)

fn get_array

Get nested array as string by key.

Signature: (json:str key:str -- value:str found:i64)

Example:

"{\"arr\":[1,2]}" "arr" json::get_array  // "[1,2]" 1

fn get_bool

Get boolean value by key from object.

Signature: (json:str key:str -- value:i64 found:i64)

Example:

"{\"ok\":true}" "ok" json::get_bool  // 1 1

fn get_float

Get float value by key from object.

Signature: (json:str key:str -- value:f64 found:i64)

Example:

"{\"pi\":3.14}" "pi" json::get_float  // 3.14 1

fn get_int

Get integer value by key from object.

Signature: (json:str key:str -- value:i64 found:i64)

Example:

"{\"age\":42}" "age" json::get_int  // 42 1

fn get_object

Get nested object as string by key.

Signature: (json:str key:str -- value:str found:i64)

Example:

"{\"obj\":{\"x\":1}}" "obj" json::get_object  // "{\"x\":1}" 1

fn get_string

Get string value by key from object.

Signature: (json:str key:str -- value:str found:i64)

Example:

"{\"name\":\"Bob\"}" "name" json::get_string  // "Bob" 1

fn has_key

Check if key exists in object.

Signature: (json:str key:str -- exists:i64)

Example:

"{\"a\":1}" "a" json::has_key print  // 1

fn is_null_at

Check if value at position is null.

Signature: (json:str pos:i64 -- is_null:i64)

Example:

"null" 0 json::is_null_at print  // 1

fn join

Join multiple JSON fragments with commas.

Signature: (a:str b:str -- joined:str)

Example:

"\"a\":1" "\"b\":2" json::join print  // "a":1,"b":2

fn kv_bool

Build a key-value pair with boolean value.

Signature: (key:str value:i64 -- kv:str)

Example:

"active" 1 json::kv_bool print  // "active":true

fn kv_int

Build a key-value pair with integer value.

Signature: (key:str value:i64 -- kv:str)

Example:

"age" 42 json::kv_int print  // "age":42

fn kv

Build a key-value pair with string value.

Signature: (key:str value:str -- kv:str)

Example:

"name" "Bob" json::kv print  // "name":"Bob"

fn kv_raw

Build a key-value pair with raw JSON value (object, array, or literal).

Signature: (key:str value:str -- kv:str)

Example:

"data" "{}" json::kv_raw print  // "data":{}

fn obj

Build a JSON object from comma-separated key-value pairs.

Signature: (content:str -- obj:str)

Example:

"\"a\":1,\"b\":2" json::obj print  // {"a":1,"b":2}

fn type_at

Get JSON value type at position.

Signature: (json:str pos:i64 -- result:i64)

Example:

"{\"a\":1}" 5 json::type_at print  // 2 (Number)