Liking cljdoc? Tell your friends :D

medley.core

A small collection of useful, mostly pure functions that might not look out of place in the clojure.core namespace.

A small collection of useful, mostly pure functions that might not look out
of place in the clojure.core namespace.
raw docstring

absclj/s

(abs x)

Returns the absolute value of a number.

Returns the absolute value of a number.
sourceraw docstring

assoc-someclj/s

(assoc-some m k v)
(assoc-some m k v & kvs)

Associates a key with a value in a map, if and only if the value is not nil.

Associates a key with a value in a map, if and only if the value is not nil.
sourceraw docstring

boolean?clj/s

(boolean? x)

Returns true if x is a boolean.

Returns true if x is a boolean.
sourceraw docstring

dedupe-byclj/s

(dedupe-by f)
(dedupe-by f coll)

Returns a lazy sequence of the elements of coll, removing any consecutive elements that return duplicate values when passed to a function f.

Returns a lazy sequence of the elements of coll, removing any **consecutive**
elements that return duplicate values when passed to a function f.
sourceraw docstring

deep-mergeclj/s≠

clj
(deep-merge & maps)
cljs
(deep-merge)
(deep-merge a)
(deep-merge a b)
(deep-merge a b & more)

Recursively merges maps together. If all the maps supplied have nested maps under the same keys, these nested maps are merged. Otherwise the value is overwritten, as in clojure.core/merge.

Recursively merges maps together. If all the maps supplied have nested maps
under the same keys, these nested maps are merged. Otherwise the value is
overwritten, as in `clojure.core/merge`.
sourceraw docstring

deref-reset!clj/s

(deref-reset! atom newval)

Sets the value of the atom without regard for the current value, then returns the original value of the atom. See also: deref-swap!.

Sets the value of the atom without regard for the current value, then returns
the original value of the atom. See also: [[deref-swap!]].
sourceraw docstring

deref-swap!clj/s≠

clj
(deref-swap! atom f & args)
cljs
(deref-swap! atom f)
(deref-swap! atom f & args)

Atomically swaps the value of the atom to be (apply f x args), where x is the current value of the atom, then returns the original value of the atom. This function therefore acts like an atomic deref then swap!.

Atomically swaps the value of the atom to be `(apply f x args)`, where x is
the current value of the atom, then returns the original value of the atom.
This function therefore acts like an atomic `deref` then `swap!`.
sourceraw docstring

dissoc-inclj/s

(dissoc-in m ks)
(dissoc-in m ks & kss)

Dissociate a value in a nested associative structure, identified by a sequence of keys. Any collections left empty by the operation will be dissociated from their containing structures.

Dissociate a value in a nested associative structure, identified by a sequence
of keys. Any collections left empty by the operation will be dissociated from
their containing structures.
sourceraw docstring

distinct-byclj/s

(distinct-by f)
(distinct-by f coll)

Returns a lazy sequence of the elements of coll, removing any elements that return duplicate values when passed to a function f.

Returns a lazy sequence of the elements of coll, removing any elements that
return duplicate values when passed to a function f.
sourceraw docstring

drop-uptoclj/s

(drop-upto pred)
(drop-upto pred coll)

Returns a lazy sequence of the items in coll starting after the first item for which (pred item) returns true.

Returns a lazy sequence of the items in coll starting *after* the first item
for which `(pred item)` returns true.
sourceraw docstring

ex-causeclj/s

(ex-cause ex)

Returns the cause attached to the given ExceptionInfo/Throwable object. For all other types returns nil. Same as cljs.core/ex-cause except it works for Clojure as well as ClojureScript.

Returns the cause attached to the given ExceptionInfo/Throwable object. For
all other types returns nil. Same as `cljs.core/ex-cause` except it works for
Clojure as well as ClojureScript.
sourceraw docstring

ex-messageclj/s

(ex-message ex)

Returns the message attached to the given Error/Throwable object. For all other types returns nil. Same as cljs.core/ex-message except it works for Clojure as well as ClojureScript.

Returns the message attached to the given Error/Throwable object. For all
other types returns nil. Same as `cljs.core/ex-message` except it works for
Clojure as well as ClojureScript.
sourceraw docstring

filter-keysclj/s

(filter-keys pred coll)

Returns a new associative collection of the items in coll for which (pred (key item)) returns true.

Returns a new associative collection of the items in coll for which
`(pred (key item))` returns true.
sourceraw docstring

filter-kvclj/s

(filter-kv pred coll)

Returns a new associative collection of the items in coll for which (pred (key item) (val item)) returns true.

Returns a new associative collection of the items in coll for which
`(pred (key item) (val item))` returns true.
sourceraw docstring

filter-valsclj/s

(filter-vals pred coll)

Returns a new associative collection of the items in coll for which (pred (val item)) returns true.

Returns a new associative collection of the items in coll for which
`(pred (val item))` returns true.
sourceraw docstring

find-firstclj/s

(find-first pred)
(find-first pred coll)

Finds the first item in a collection that matches a predicate.

Finds the first item in a collection that matches a predicate.
sourceraw docstring

greatestclj/s≠

clj
(greatest & xs)
cljs
(greatest)
(greatest a)
(greatest a b)
(greatest a b & more)

Find the greatest argument (as defined by the compare function) in O(n) time.

Find the greatest argument (as defined by the compare function) in O(n) time.
sourceraw docstring

index-byclj/s

(index-by f coll)

Returns a map of the elements of coll keyed by the result of f on each element. The value at each key will be the last element in coll associated with that key. This function is similar to clojure.core/group-by, except that elements with the same key are overwritten, rather than added to a vector of values.

Returns a map of the elements of coll keyed by the result of f on each
element. The value at each key will be the last element in coll associated
with that key. This function is similar to `clojure.core/group-by`, except
that elements with the same key are overwritten, rather than added to a
vector of values.
sourceraw docstring

indexedclj/s

(indexed)
(indexed coll)

Returns an ordered, lazy sequence of vectors [index item], where item is a value in coll, and index its position starting from zero.

Returns an ordered, lazy sequence of vectors `[index item]`, where item is a
value in coll, and index its position starting from zero.
sourceraw docstring

insert-nthclj/s

(insert-nth index item)
(insert-nth index item coll)

Returns a lazy sequence of the items in coll, with a new item inserted at the supplied index, followed by all subsequent items of the collection. Runs in O(n) time.

Returns a lazy sequence of the items in coll, with a new item inserted at
the supplied index, followed by all subsequent items of the collection. Runs
in O(n) time.
sourceraw docstring

interleave-allclj/s≠

clj
(interleave-all & colls)
cljs
(interleave-all)
(interleave-all c1)
(interleave-all c1 c2)
(interleave-all c1 c2 & colls)

Returns a lazy seq of the first item in each coll, then the second, etc. Unlike clojure.core/interleave, the returned seq contains all items in the supplied collections, even if the collections are different sizes.

Returns a lazy seq of the first item in each coll, then the second, etc.
Unlike `clojure.core/interleave`, the returned seq contains all items in the
supplied collections, even if the collections are different sizes.
sourceraw docstring

joinclj/s

(join colls)

Lazily concatenates a collection of collections into a flat sequence.

Lazily concatenates a collection of collections into a flat sequence.
sourceraw docstring

leastclj/s≠

clj
(least & xs)
cljs
(least)
(least a)
(least a b)
(least a b & more)

Return the least argument (as defined by the compare function) in O(n) time.

Return the least argument (as defined by the compare function) in O(n) time.
sourceraw docstring

map-entryclj/s

(map-entry k v)

Create a map entry for a key and value pair.

Create a map entry for a key and value pair.
sourceraw docstring

map-keysclj/s

(map-keys f coll)

Maps a function over the keys of an associative collection.

Maps a function over the keys of an associative collection.
sourceraw docstring

map-kvclj/s

(map-kv f coll)

Maps a function over the key/value pairs of an associative collection. Expects a function that takes two arguments, the key and value, and returns the new key and value as a collection of two elements.

Maps a function over the key/value pairs of an associative collection. Expects
a function that takes two arguments, the key and value, and returns the new
key and value as a collection of two elements.
sourceraw docstring

map-kv-keysclj/s

(map-kv-keys f coll)

Maps a function over the key/value pairs of an associative collection, using the return of the function as the new key.

Maps a function over the key/value pairs of an associative collection, using
the return of the function as the new key.
sourceraw docstring

map-kv-valsclj/s

(map-kv-vals f coll)

Maps a function over the key/value pairs of an associative collection, using the return of the function as the new value.

Maps a function over the key/value pairs of an associative collection, using
the return of the function as the new value.
sourceraw docstring

map-valsclj/s

(map-vals f coll)
(map-vals f c1 & colls)

Maps a function over the values of one or more associative collections. The function should accept number-of-colls arguments. Any keys which are not shared among all collections are ignored.

Maps a function over the values of one or more associative collections.
The function should accept number-of-colls arguments. Any keys which are not
shared among all collections are ignored.
sourceraw docstring

mapplyclj/s≠

clj
(mapply f & args)
cljs
(mapply f m)
(mapply f a & args)

Applies a function f to the argument list formed by concatenating everything but the last element of args with the last element of args. This is useful for applying a function that accepts keyword arguments to a map.

Applies a function f to the argument list formed by concatenating
everything but the last element of args with the last element of
args. This is useful for applying a function that accepts keyword
arguments to a map.
sourceraw docstring

queueclj/s

(queue)
(queue coll)

Creates an empty persistent queue, or one populated with a collection.

Creates an empty persistent queue, or one populated with a collection.
sourceraw docstring

queue?clj/s

(queue? x)

Returns true if x implements clojure.lang.PersistentQueue.

Returns true if x implements clojure.lang.PersistentQueue.
sourceraw docstring

random-uuidclj/s

(random-uuid)

Generates a new random UUID. Same as cljs.core/random-uuid except it works for Clojure as well as ClojureScript.

Generates a new random UUID. Same as `cljs.core/random-uuid` except it works
for Clojure as well as ClojureScript.
sourceraw docstring

remove-keysclj/s

(remove-keys pred coll)

Returns a new associative collection of the items in coll for which (pred (key item)) returns false.

Returns a new associative collection of the items in coll for which
`(pred (key item))` returns false.
sourceraw docstring

remove-kvclj/s

(remove-kv pred coll)

Returns a new associative collection of the items in coll for which (pred (key item) (val item)) returns false.

Returns a new associative collection of the items in coll for which
`(pred (key item) (val item))` returns false.
sourceraw docstring

remove-nthclj/s

(remove-nth index)
(remove-nth index coll)

Returns a lazy sequence of the items in coll, except for the item at the supplied index. Runs in O(n) time.

Returns a lazy sequence of the items in coll, except for the item at the
supplied index. Runs in O(n) time.
sourceraw docstring

remove-valsclj/s

(remove-vals pred coll)

Returns a new associative collection of the items in coll for which (pred (val item)) returns false.

Returns a new associative collection of the items in coll for which
`(pred (val item))` returns false.
sourceraw docstring

replace-nthclj/s

(replace-nth index item)
(replace-nth index item coll)

Returns a lazy sequence of the items in coll, with a new item replacing the item at the supplied index. Runs in O(n) time.

Returns a lazy sequence of the items in coll, with a new item replacing the
item at the supplied index. Runs in O(n) time.
sourceraw docstring

take-uptoclj/s

(take-upto pred)
(take-upto pred coll)

Returns a lazy sequence of successive items from coll up to and including the first item for which (pred item) returns true.

Returns a lazy sequence of successive items from coll up to and including
the first item for which `(pred item)` returns true.
sourceraw docstring

update-existingclj/s≠

clj
(update-existing m k f & args)
cljs
(update-existing m k f)
(update-existing m k f x)
(update-existing m k f x y)
(update-existing m k f x y z)
(update-existing m k f x y z & more)

Updates a value in a map given a key and a function, if and only if the key exists in the map. See: clojure.core/update.

Updates a value in a map given a key and a function, if and only if the key
exists in the map. See: `clojure.core/update`.
sourceraw docstring

update-existing-inclj/s

(update-existing-in m ks f & args)

Updates a value in a nested associative structure, if and only if the key path exists. See: clojure.core/update-in.

Updates a value in a nested associative structure, if and only if the key
path exists. See: `clojure.core/update-in`.
sourceraw docstring

uuidclj/s

(uuid s)

Returns a UUID generated from the supplied string. Same as cljs.core/uuid in ClojureScript, while in Clojure it returns a java.util.UUID object.

Returns a UUID generated from the supplied string. Same as `cljs.core/uuid`
in ClojureScript, while in Clojure it returns a `java.util.UUID` object.
sourceraw docstring

uuid?clj/s

(uuid? x)

Returns true if the value is a UUID.

Returns true if the value is a UUID.
sourceraw docstring

cljdoc is a website building & hosting documentation for Clojure/Script libraries

× close