Concatenates the given vectors in logarithmic time.

appends elements on either side

(conj-both 1 2 3) => 1 2 3

appends elements on the left

(conj-left 4 3 2 1) => 1 2 3 4

appends elements on the right

(conj-right 1 2 3 4) => 1 2 3 4

For a list or queue, same as first, for a vector, same as, but much more efficient than, last. If the collection is empty, returns nil.

peeks at the first element on the left

(peek-left 1 2 3 4) => 1

For a list or queue, returns a new list/queue without the first item, for a vector, returns a new vector without the last item. If the collection is empty, throws an exception. Note - not the same as next/butlast.

pops an element from the left

(pop-left 1 2 3 4) => 2 3 4

updates the leftmost element

(update-left 1 2 3 dec) => 0 2 3

updates the rightmost element

(update-right 1 2 3 inc) => 1 2 4

Creates a new vector containing the args.