boring.writer — org.replikativ/boring 0.1.9

CBOR writer for ClojureScript.

Design follows measurements taken on node before any of this was written:

• DataView, not hand-rolled shift/mask. Manual byte assembly measured 2.2x SLOWER than DataView for a big-endian i32 (4.34 vs 1.97 ns), which is the opposite of the usual instinct. DataView's default byte order is big-endian, which is also CBOR's.
• TextEncoder costs ~56 ns per call regardless of string length, so a manual ASCII loop wins below ~55 characters (8.7 ns for 9 chars). Keywords and map keys are almost always shorter than that, so using TextEncoder everywhere would cost ~6x on the hot case.
• setBigInt64 is 5.7x a normal write, so it is reserved for values outside the safe-integer range.

ARRAY cljs

ASCII-LOOP-MAX cljs

buffer cljs

(buffer w)

BYTES cljs

head! cljs

(head! w major val)

Header byte for major carrying unsigned val, in the shortest form.

MAP cljs

MAX-SAFE cljs

NAME-QUEUE cljs

NAME-SORTED-MAP cljs

NAME-SORTED-SET cljs

NAME-WITH-META cljs

NINT cljs

position cljs

(position w)

reset! cljs

(reset! w)

SIMPLE cljs

TAG cljs

TAG-DATETIME cljs

TAG-DECIMAL cljs

TAG-GENERIC-OBJ cljs

TAG-IDENTIFIER cljs

TAG-NEG-BIGNUM cljs

TAG-POS-BIGNUM cljs

TAG-RATIONAL cljs

TAG-REGEX cljs

TAG-SET cljs

TAG-SHAPED-ARRAY cljs

TAG-SR-NS cljs

TAG-STRINGREF cljs

TAG-URI cljs

TAG-UUID cljs

TEXT cljs

text-encoder cljs

to-bytes cljs

(to-bytes w)

typed-array-tags cljs

UINT cljs

write-bool! cljs

(write-bool! w b)

write-bytes! cljs

(write-bytes! w bs)

write-f16! cljs

(write-f16! w bits)

write-f32! cljs

(write-f32! w f)

write-f64! cljs

(write-f64! w d)

write-int! cljs

(write-int! w n)

write-nil! cljs

(write-nil! w)

write-shortest-float! cljs

(write-shortest-float! w d)

RFC 8949 §4.2.2 preferred serialisation: narrowest form that round-trips.

write-string! cljs

(write-string! w s)

write-stringref-namespace! cljs

(write-stringref-namespace! w)

write-value! cljs

(write-value! w x)

writer cljs

(writer)

(writer size)