strojure / vectops

Basic operations with Clojure vectors.

vectops

Basic operations with Clojure(Script) vectors.

Purpose

• Provide functions for basic operations with persistent vectors like inserting or removing elements at index.
• Performant implementation without extra dependencies.
• Support Clojure and ClojureScript.

Usage

insert-at

The function insert-at inserts element in persistent vector at specified index. There is also insert-at! function for transient vectors.

(ns readme.usage.insert-at
  (:require [strojure.vectops.core :as vec]))

(vec/insert-at [0 1 2 3 4] 0 :x)
#_=> [:x 0 1 2 3 4]

(vec/insert-at [0 1 2 3 4] 2 :x)
#_=> [0 1 :x 2 3 4]

(vec/insert-at [0 1 2 3 4] 5 :x)
#_=> [0 1 2 3 4 :x]

(vec/insert-at [0 1 2 3 4] 6 :x)
;; Execution error (IndexOutOfBoundsException)

(vec/insert-at nil 0 :x)
#_=> [:x]

remove-at

The function remove-at removes element at specified index from persistent vector. There is also remove-at! function for transient vectors.

(ns readme.usage.remove-at
  (:require [strojure.vectops.core :as vec]))

(vec/remove-at [0 1 2 3 4] 0)
#_=> [1 2 3 4]

(vec/remove-at [0 1 2 3 4] 2)
#_=> [0 1 3 4]

(vec/remove-at [0 1 2 3 4] 4)
#_=> [0 1 2 3]

(vec/remove-at [0 1 2 3 4] 5)
;; Execution error (IndexOutOfBoundsException)

swap-at

The function swap-at swaps elements in persistent vector at two indexes. There is also swap-at! function for transient vectors.

(ns readme.usage.swap-at
  (:require [strojure.vectops.core :as vec]))

(vec/swap-at [0 1 2 3 4] 1 3)
#_[0 3 2 1 4]

(vec/swap-at [0 1 2 3 4] 0 5)
;; Execution error (IndexOutOfBoundsException)

Performance

• vec/insert-at

• vec/remove-at

• vec/swap-at

vectops's Issues

Removing in subvec at -1 does not throw exceptions

Looks like a bug in clojure core.

(thrown? IndexOutOfBoundsException (vec/remove-at (subvec [0 1 2 3 4 5] 1) -1))

Consider using subvec to remove first element in `remove-at`

subvec is fast way to remove first element but it returns not editable collection which is slower in further manipulations.