template/env

(env-new :)

create a new empty Env handle.

(let [e (env-new)] (env-free e))

Since: 0.1.0

(env-set [env : int key : cstr val : cstr] :)

set or shadow a scalar string binding in the env.

(env-set e "title" "Hello")

Since: 0.1.0

(env-set-list [env : int key : cstr vals : int] :)

set or shadow a list-valued binding in the env.

(env-set-list e "items" (cons "a" (cons "b" 0)))

Since: 0.1.0

(env-get [env : int key : cstr] :)

look up a key, returning the first (scalar) value.

(env-get e "title")  ; => "Hello"

Since: 0.1.0

(env-has? [env : int key : cstr] :)

check whether a binding exists for `key`.

(env-has? e "title")  ; => true

Since: 0.1.0

(env-get-list-len [env : int key : cstr] :)

number of values bound to `key`.

(env-get-list-len e "items")  ; => 3

Since: 0.1.0

(env-get-list-at [env : int key : cstr i : int] :)

fetch the i-th value bound to `key`.

(env-get-list-at e "items" 1)  ; => "b"

Since: 0.1.0

(env-push-scalar [env : int key : cstr val : cstr] :)

push a single scalar binding (for renderer scopes).

(env-push-list [env : int key : cstr vals : int] :)

push a list binding (for renderer scopes).

(env-pop [env : int] :)

remove the top binding from the env stack.

(env-free [env : int] :)

release all storage associated with an Env handle.

(env-free e)

Since: 0.1.0