Files
marqdo/lib/table.mq.md
T

4.4 KiB

markup, title, description
markup title description
occlusion lib/table List and map helpers. Prefer put (1-based path, same nesting as link-index get); at/set_at/slice are 0-based. Use lib/json only for parse/stringify.

List and map helpers. Prefer put for nested writes; authors should read with link-index get, not new footnote indexes.

put

+ `in`
+ `at`
+ `value`

Update one element of collection in at path at to value.

at is a text key, a 1-based list index, or a list of keys/indices (same nesting as link-index get).

Caller: [table.put] in=None at="Authorization" value="Bearer-x"

> host_collection_put in=in at=at value=value

len

+ `xs`

Length of list or map xs.

> len xs

rows

+ `xs`

Row count for list xs (alias of len).

> len xs

at

+ `xs`
+ `i`

Zero-based index into xs at i (same as builtin at). Out of range → None.

> at value=xs index=i

row_at

+ `xs`
+ `i`

Zero-based row from xs at i.

> at value=xs index=i

append

+ `list`
+ `item`

Append item to list.

> host_list_append list=list item=item

prepend

+ `list`
+ `item`

Prepend item to list.

> host_list_prepend list=list item=item

concat

+ `a`
+ `b`

Concatenate lists a and b.

> host_list_concat a=a b=b

insert

+ `list`
+ `index`
+ `item`

Insert item into list at zero-based index (may insert at len to append).

> host_list_insert list=list index=index item=item

set_at

+ `list`
+ `index`
+ `item`

Zero-based replace of list at index with item. Prefer put with a 1-based index for author-facing edits.

> host_list_set_at list=list index=index item=item

remove_at

+ `list`
+ `index`

Remove zero-based index from list.

> host_list_remove_at list=list index=index

pop

+ `list`

Drop the last item of list (errors if empty). Use last first when you need the removed value.

n = > len list

  1. n > 0 > host_list_remove_at list=list index=n - 1

> host_list_remove_at list=list index=0

first

+ `list`

First item of list.

> host_list_first list=list

last

+ `list`

Last item of list.

> host_list_last list=list

slice

+ `list`
+ `start`
+ `end`=None

Zero-based half-open slice of list from start to end.

> host_list_slice list=list start=start end=end

contains

+ `list`
+ `item`

Whether list contains item.

> host_list_contains list=list item=item

index_of

+ `list`
+ `item`

Zero-based index of item in list, or None.

> host_list_index_of list=list item=item

reverse

+ `list`

Reverse list.

> host_list_reverse list=list

sort

+ `list`

Ascending sort of list (int/num/text preferred).

> host_list_sort list=list

sort_by

+ `list`
+ `key`

Sort a list of maps by field key.

> host_list_sort_by list=list key=key

unique

+ `list`

Stable unique of list (first wins).

> host_list_unique list=list

chunk

+ `list`
+ `size`

Split list into chunks of size.

> host_list_chunk list=list size=size

zip

+ `a`
+ `b`

Pair lists a and b until the shorter ends.

> host_list_zip a=a b=b

flatten

+ `list`

One-level flatten of list.

> host_list_flatten list=list

clear

+ `value`

Empty list or empty map for value (by type).

> host_collection_clear value=value

get

+ `map`
+ `key`

Shallow get from map at key. Missing → None. Prefer link-index get in author code.

> host_map_get map=map key=key

set

+ `map`
+ `key`
+ `value`

Shallow map update. Prefer put for nested paths.

> host_map_set map=map key=key value=value

delete

+ `map`
+ `key`

Delete key from map.

> host_map_delete map=map key=key

has

+ `map`
+ `key`

Whether map has key.

> host_map_has map=map key=key

keys

+ `map`

Keys of map.

> host_map_keys map=map

values

+ `map`

Values of map.

> host_map_values map=map

items

+ `map`

Key/value rows from map.

> host_map_items map=map

merge

+ `a`
+ `b`

Merge maps a and b (right-hand keys win).

> host_map_merge a=a b=b

size

+ `map`

Key count of map.

> host_map_size map=map

empty_list

Empty list.

> host_list_concat a=None b=None

empty_map

Empty map.

> host_map_merge a=None b=None