データ処理

このページで紹介する関数はコレクション（オブジェクトや配列）に要素を追加したり削除したりといった操作をするものがほとんどです。
batonコアで述べたように、batonjsではページ状態が変わったかどうかを===で判断します。
ということは、オブジェクトのプロパティを更新したときや、配列の要素を追加・削除したときは、新しいコレクションが手元にあるようにしないといけないわけです。
このページで紹介する関数はその要求に応えるものですので、withStateと一緒に使うのに適しています。

なお、ここで紹介する関数は、配列をリストとして、オブジェクトを「文字列をキーとするマップ」として扱います。
リストとは、先頭から末尾まで要素が抜けなく詰まった並びのことです。

typeOf(null)  // === "null"
typeOf([])  // === "array"
typeOf({})  // === "object"
typeOf(0)  // === "number"
typeOf("")  // === "string"
typeOf(false)  // === "boolean"
typeOf(undefined)  // === "undefined"
typeof(() => 0)  // === "function"

insert(0, "a", [0, 1, 2])  // --> ["a", 0, 1, 2]
insert(3, "a", [0, 1, 2])  // --> [0, 1, 2, "a"]
insert("a", "a", {x: 1, y: 2})  // --> {x: 1, y: 2, a: "a"}
insert("x", "x", {x: 1, y: 2})  // --> エラー

remove(0, [0, 1, 2])  // --> [1, 2]
remove(3, [0, 1, 2])  // --> エラー
remove("x", {x: 1, y: 2})  // --> {y: 2}
remove("a", {x: 1, y: 2})  // --> エラー

update(0, "a", [0, 1, 2])  // --> ["a", 1, 2]
update(0, "a", 2, "b", [0, 1, 2])  // --> ["a", 1, "b"]
update(3, "a", [0, 1, 2])  // --> エラー
update("x", "a", {x: 0, y: 1, z: 2})  // --> {x: "a", y: 1, z: 2}
update("x", "a", "z", "b", {x: 0, y: 1, z: 2})  // --> {x: "a", y: 1, z: "b"}
update("a", "a", {x: 0, y: 1, z: 2})  // --> エラー

const less = (a, b) => (a - b)
sort(less, [5, 2, 4, 1, 3])  // --> [1, 2, 3, 4, 5]