Extended core library for Clojure/Script that emphasizes:
This lib's mostly for my own use and for advanced users that feel comfortable reading this source. Not providing much beginner-oriented documentation for this, sorry.
Quick Taoensso naming conventions:
foo - Dynamic var.
foo! - Fn with side effects, or that should otherwise be used cautiously.
foo? - Truthy val or fn that returns truthy val.
foo!? - Fn that has side effects (or requires caution) and that returns
a truthy val. Note: !?, not ?!.
foo$ - Fn that's notably expensive to compute (e.g. hits db).
foo_ - Dereffable val (e.g. atom, volatile, delay, etc.).
_ - Unnamed val.
_foo - Named but unused val.
?foo - Optional val (emphasize that val may be nil).
foo* - A variation of foo
(e.g. foo*
macro vs foo
fn).
-foo - Public implementation detail or intermediate (e.g. uncoerced) val.
foo - Val "to foo" (e.g. >sender, >host), or fn to put/coerce/transform. <foo - Val "from foo" (e.g. <sender, <host), or fn to take/coerce/transform. ->foo - Fn to put/coerce/transform.
Extended core library for Clojure/Script that emphasizes: * Cross platform API compatibility * Flexibility * Performance * Backwards compatibility This lib's mostly for my own use and for advanced users that feel comfortable reading this source. Not providing much beginner-oriented documentation for this, sorry. Quick Taoensso naming conventions: **foo** - Dynamic var. foo! - Fn with side effects, or that should otherwise be used cautiously. foo? - Truthy val or fn that returns truthy val. foo!? - Fn that has side effects (or requires caution) and that returns a truthy val. Note: !?, not ?!. foo$ - Fn that's notably expensive to compute (e.g. hits db). foo_ - Dereffable val (e.g. atom, volatile, delay, etc.). _ - Unnamed val. _foo - Named but unused val. ?foo - Optional val (emphasize that val may be nil). foo* - A variation of `foo` (e.g. `foo*` macro vs `foo` fn). -foo - Public implementation detail or intermediate (e.g. uncoerced) val. >foo - Val "to foo" (e.g. >sender, >host), or fn to put/coerce/transform. <foo - Val "from foo" (e.g. <sender, <host), or fn to take/coerce/transform. ->foo - Fn to put/coerce/transform.
(-cas! atom_ old-val new-val)
Micro optimization.
Micro optimization.
(-swap-val! atom_ k f)
Used internally by memoization utils.
Used internally by memoization utils.
(after-timeout msecs & body)
Alpha, subject to change. Returns a TimeoutFuture that will execute body after timeout. Body must be non-blocking or cheap.
Alpha, subject to change. Returns a TimeoutFuture that will execute body after timeout. Body must be non-blocking or cheap.
(ajax-lite uri
{:keys [method params headers timeout-ms resp-type with-credentials?]
:as opts
:or {method :get timeout-ms 10000 resp-type :auto}}
callback-fn)
Alpha, subject to change. Simple, lightweight Ajax via Google Closure. Returns the resulting XhrIo[1] instance, or nil.
(ajax-lite "/my-post-route" {:method :post :params {:username "Rich Hickey" :type "Awesome"} :headers {"Foo" "Bar"} :resp-type :text :timeout-ms 7000 :with-credentials? false ; Enable if using CORS (requires xhr v2+) } (fn async-callback-fn [resp-map] (let [{:keys [success? ?status ?error ?content ?content-type]} resp-map] ;; ?status - e/o #{nil 200 404 ...}, non-nil iff server responded ;; ?error - e/o #{nil <http-error-status-code> <exception> :timeout :abort :http-error :exception :xhr-pool-depleted} (js/alert (str "Ajax response: " resp-map)))))
[1] Ref. https://developers.google.com/closure/library/docs/xhrio
Alpha, subject to change. Simple, lightweight Ajax via Google Closure. Returns the resulting XhrIo[1] instance, or nil. (ajax-lite "/my-post-route" {:method :post :params {:username "Rich Hickey" :type "Awesome"} :headers {"Foo" "Bar"} :resp-type :text :timeout-ms 7000 :with-credentials? false ; Enable if using CORS (requires xhr v2+) } (fn async-callback-fn [resp-map] (let [{:keys [success? ?status ?error ?content ?content-type]} resp-map] ;; ?status - e/o #{nil 200 404 ...}, non-nil iff server responded ;; ?error - e/o #{nil <http-error-status-code> <exception> :timeout :abort :http-error :exception :xhr-pool-depleted} (js/alert (str "Ajax response: " resp-map))))) [1] Ref. https://developers.google.com/closure/library/docs/xhrio
(as-map kvs & [kf vf])
Deprecated, prefer reduce-kvs
Deprecated, prefer `reduce-kvs`
(assert-min-encore-version min-version)
Version check for dependency conflicts, etc.
Version check for dependency conflicts, etc.
(assoc-nx m kvs)
(assoc-nx m k v)
(assoc-nx m k v & kvs)
Assocs each kv iff its key doesn't already exist.
Assocs each kv iff its key doesn't already exist.
(assoc-some m kvs)
(assoc-some m k v)
(assoc-some m k v & kvs)
Assocs each kv iff its value is not nil.
Assocs each kv iff its value is not nil.
(assoc-when m kvs)
(assoc-when m k v)
(assoc-when m k v & kvs)
Assocs each kv iff its val is truthy.
Assocs each kv iff its val is truthy.
(call-after-timeout msecs f)
(call-after-timeout impl_ msecs f)
Alpha, subject to change.
Returns a TimeoutFuture that will execute f
after given msecs.
Does NOT do any automatic binding conveyance.
Performance depends on the provided timer implementation (impl_
).
The default implementation offers O(logn) add, O(1) cancel, O(1) tick.
See ITimeoutImpl
for extending to arbitrary timer implementations.
Alpha, subject to change. Returns a TimeoutFuture that will execute `f` after given msecs. Does NOT do any automatic binding conveyance. Performance depends on the provided timer implementation (`impl_`). The default implementation offers O(logn) add, O(1) cancel, O(1) tick. See `ITimeoutImpl` for extending to arbitrary timer implementations.
(case-eval expr & clauses)
Like case
but evals test constants for their compile-time value.
Like `case` but evals test constants for their compile-time value.
(catching try-expr)
(catching try-expr error-sym catch-expr)
(catching try-expr error-sym catch-expr finally-expr)
Cross-platform try/catch/finally.
Cross-platform try/catch/finally.
(caught-error-data & body)
Handy for error-throwing unit tests.
Handy for error-throwing unit tests.
(check-all test)
(check-all test & more)
Returns all logical false/throwing expressions (ids/forms), or nil.
Returns all logical false/throwing expressions (ids/forms), or nil.
(check-some test)
(check-some test & more)
Returns first logical false/throwing expression (id/form), or nil.
Returns first logical false/throwing expression (id/form), or nil.
(compile-if test then)
(compile-if test then else)
Evaluates test
. If it returns logical true (and doesn't throw), expands
to then
, otherwise expands to else
.
Evaluates `test`. If it returns logical true (and doesn't throw), expands to `then`, otherwise expands to `else`.
Returns (fn [?ns]) -> truthy.
Returns (fn [?ns]) -> truthy.
(cond & clauses)
Like core/cond
but supports implicit (final) else
clause, and special
test keywords: :else, :let, :do, :when, :when-not, :when-some.
:let support inspired by https://github.com/Engelberg/better-cond.
Like `core/cond` but supports implicit (final) `else` clause, and special test keywords: :else, :let, :do, :when, :when-not, :when-some. :let support inspired by https://github.com/Engelberg/better-cond.
(cond! & clauses)
Like cond
but throws on non-match like case
and condp
.
Like `cond` but throws on non-match like `case` and `condp`.
(conj-some)
(conj-some coll)
(conj-some coll x)
(conj-some coll x & more)
Conjoins each non-nil value.
Conjoins each non-nil value.
(conj-when)
(conj-when coll)
(conj-when coll x)
(conj-when coll x & more)
Conjoins each truthy value.
Conjoins each truthy value.
(declare-remote & syms)
Declares given ns-qualified symbols, preserving metadata. Useful for circular dependencies.
Declares given ns-qualified symbols, preserving metadata. Useful for circular dependencies.
(defalias src)
(defalias sym src)
(defalias sym src attrs)
Defines an alias for a var, preserving its metadata.
Defines an alias for a var, preserving its metadata.
Simple one-timeout timeout implementation provided by platform timer. O(logn) add, O(1) cancel, O(1) tick. Fns must be non-blocking or cheap. Similar efficiency to core.async timers (binary heap vs DelayQueue).
Simple one-timeout timeout implementation provided by platform timer. O(logn) add, O(1) cancel, O(1) tick. Fns must be non-blocking or cheap. Similar efficiency to core.async timers (binary heap vs DelayQueue).
(defonce sym & args)
Like core/defonce
but supports optional docstring and attrs map.
Like `core/defonce` but supports optional docstring and attrs map.
(defstub sym)
Experimental. Declares a stub var that can be initialized from any
namespace with unstub-<stub-name>
. Separates a var's declaration
(location) and its initialization (value). Handy for defining vars in a
shared ns from elsewhere (e.g. a private or cyclic ns).
Experimental. Declares a stub var that can be initialized from any namespace with `unstub-<stub-name>`. Separates a var's declaration (location) and its initialization (value). Handy for defining vars in a shared ns from elsewhere (e.g. a private or cyclic ns).
(deprecated & body)
Elides body when TAOENSSO_ELIDE_DEPRECATED
sys val is truthy.
Elides body when `TAOENSSO_ELIDE_DEPRECATED` sys val is truthy.
(distinct-by keyfn coll)
Deprecated, prefer xdistinct
Deprecated, prefer `xdistinct`
(distinctv coll)
(distinctv keyfn coll)
Deprecated, prefer xdistinct
Deprecated, prefer `xdistinct`
(doto-cond [sym x] & clauses)
Cross between doto
, cond->
and as->
.
Cross between `doto`, `cond->` and `as->`.
(error-data x)
Returns data map iff x
is an error of any type on platform.
Returns data map iff `x` is an error of any type on platform.
(exp-backoff n-attempt)
(exp-backoff n-attempt {:keys [min max factor] :or {factor 1000}})
Returns binary exponential backoff value for n<=36.
Returns binary exponential backoff value for n<=36.
(format fmt & args)
Like core/format
but:
format
!).Like `core/format` but: * Returns "" when fmt is nil rather than throwing an NPE. * Formats nil as "nil" rather than "null". * Provides ClojureScript support via goog.string.format (this has fewer formatting options than Clojure's `format`!).
(get-substr s start)
(get-substr s start end)
Like subs
but provides consistent clj/s behaviour and never throws
(snaps to valid start and end indexes).
Like `subs` but provides consistent clj/s behaviour and never throws (snaps to valid start and end indexes).
(get-substring s start)
(get-substring s start length)
Like get-substr
but:
length
instead of end
(index).start
=> index from right of string.Like `get-substr` but: - Takes `length` instead of `end` (index). - -ive `start` => index from right of string.
(get-subvec v start)
(get-subvec v start end)
Like subvec
but never throws (snaps to valid start and end indexes).
Like `subvec` but never throws (snaps to valid start and end indexes).
(get-subvector v start)
(get-subvector v start length)
Like get-subvec
but:
length
instead of end
(index).start
=> index from right of vector.Like `get-subvec` but: - Takes `length` instead of `end` (index). - -ive `start` => index from right of vector.
(get-win-loc)
Returns js/window
's current location as a map.
Returns `js/window`'s current location as a map.
(have pred (:in) x)
(have pred (:in) x & more-xs)
Takes a pred and one or more vals. Tests pred against each val, trapping errors. If any pred test fails, throws a detailed assertion error. Otherwise returns input val/vals for convenient inline-use/binding.
Respects assert value so tests can be elided from production for zero runtime costs.
Provides a small, simple, flexible feature subset to alternative tools like clojure.spec, core.typed, prismatic/schema, etc.
;; Will throw a detailed error message on invariant violation: (fn my-fn [x] (str/trim (have string? x)))
You may attach arbitrary debug info to assertion violations like:
(have string? x :data {:my-arbitrary-debug-info "foo"})
See also have?
, have!
.
Takes a pred and one or more vals. Tests pred against each val, trapping errors. If any pred test fails, throws a detailed assertion error. Otherwise returns input val/vals for convenient inline-use/binding. Respects *assert* value so tests can be elided from production for zero runtime costs. Provides a small, simple, flexible feature subset to alternative tools like clojure.spec, core.typed, prismatic/schema, etc. ;; Will throw a detailed error message on invariant violation: (fn my-fn [x] (str/trim (have string? x))) You may attach arbitrary debug info to assertion violations like: `(have string? x :data {:my-arbitrary-debug-info "foo"})` See also `have?`, `have!`.
(have! pred (:in) x)
(have! pred (:in) x & more-xs)
Like have
but ignores assert value (so can never be elided). Useful
for important conditions in production (e.g. security checks).
Like `have` but ignores *assert* value (so can never be elided). Useful for important conditions in production (e.g. security checks).
(have!? pred (:in) x)
(have!? pred (:in) x & more-xs)
Specialized cross between have?
and have!
. Not used often but can be
handy for semantic clarification and/or to improve multi-val performance
when the return vals aren't necessary.
WARNING: Do NOT use in :pre/:post conds since those are ALWAYS subject
to assert, directly contradicting the intention of the bang (!
) here.
Specialized cross between `have?` and `have!`. Not used often but can be handy for semantic clarification and/or to improve multi-val performance when the return vals aren't necessary. **WARNING**: Do NOT use in :pre/:post conds since those are ALWAYS subject to *assert*, directly contradicting the intention of the bang (`!`) here.
(have? pred (:in) x)
(have? pred (:in) x & more-xs)
Like have
but returns true
on successful tests. In particular, this
can be handy for use with :pre/:post conditions. Compare:
(fn my-fn [x] {:post [(have nil? %)]} nil) ; {:post [nil]} FAILS
(fn my-fn [x] {:post [(have? nil? %)]} nil) ; {:post [true]} passes as intended
Like `have` but returns `true` on successful tests. In particular, this can be handy for use with :pre/:post conditions. Compare: (fn my-fn [x] {:post [(have nil? %)]} nil) ; {:post [nil]} FAILS (fn my-fn [x] {:post [(have? nil? %)]} nil) ; {:post [true]} passes as intended
(idx-fn)
Returns a new stateful index fn that returns: 0, 1, 2, ...
Returns a new stateful index fn that returns: 0, 1, 2, ...
(if-let bindings then)
(if-let bindings then else)
Like core/if-let
but can bind multiple values for then
iff all tests
are truthy, supports internal :let
s.
Like `core/if-let` but can bind multiple values for `then` iff all tests are truthy, supports internal `:let`s.
(if-not test-or-bindings then)
(if-not test-or-bindings then else)
Like core/if-not
but acts like if-let
when given a binding vector
as test expr.
Like `core/if-not` but acts like `if-let` when given a binding vector as test expr.
(if-some bindings then)
(if-some bindings then else)
Like core/if-some
but can bind multiple values for then
iff all tests
are non-nil, supports internal :let
s.
Like `core/if-some` but can bind multiple values for `then` iff all tests are non-nil, supports internal `:let`s.
(interleave-all)
(interleave-all c1)
(interleave-all c1 c2)
(interleave-all c1 c2 & colls)
Greedy version of interleave
.
Greedy version of `interleave`.
(into-all to from)
(into-all to from & more)
Like into
but supports multiple "from"s.
Like `into` but supports multiple "from"s.
(into-str & xs)
Simple Hiccup-like string templating to complement Tempura.
Simple Hiccup-like string templating to complement Tempura.
(is! x)
(is! pred x)
(is! pred x fail-?data)
Cheaper have!
that provides less diagnostic info.
Cheaper `have!` that provides less diagnostic info.
(tf-cancel! _)
Returns true iff the timeout was successfully cancelled (i.e. was previously pending).
Returns true iff the timeout was successfully cancelled (i.e. was previously pending).
(tf-poll _)
Returns :timeout/pending, :timeout/cancelled, or the timeout's completed result.
Returns :timeout/pending, :timeout/cancelled, or the timeout's completed result.
(tf-done? _)
Returns true iff the timeout is not pending (i.e. has a completed result or is cancelled).
Returns true iff the timeout is not pending (i.e. has a completed result or is cancelled).
(tf-state _)
Returns a map of timeout's public state.
Returns a map of timeout's public state.
(tf-pending? _)
Returns true iff the timeout is pending.
Returns true iff the timeout is pending.
(tf-cancelled? _)
Returns true iff the timeout is cancelled.
Returns true iff the timeout is cancelled.
(keys-by f coll)
Returns {(f x) x} map for xs in coll
.
Returns {(f x) x} map for xs in `coll`.
(limiter specs)
Takes {<spec-id> [<n-max-reqs> <msecs-window>]}, and returns a rate limiter (fn check-limits! [req-id]) -> nil (all limits pass), or [<worst-spec-id> <worst-backoff-msecs> {<spec-id> <backoff-msecs>}].
Limiter fn commands: :rl/peek <req-id> - Check limits w/o side effects. :rl/reset <req-id> - Reset all limits for given req-id.
Takes {<spec-id> [<n-max-reqs> <msecs-window>]}, and returns a rate limiter (fn check-limits! [req-id]) -> nil (all limits pass), or [<worst-spec-id> <worst-backoff-msecs> {<spec-id> <backoff-msecs>}]. Limiter fn commands: :rl/peek <req-id> - Check limits w/o side effects. :rl/reset <req-id> - Reset all limits for given req-id.
(limiter* specs)
Experimental. Like limiter
but returns [<limiter> <state_>].
Experimental. Like `limiter` but returns [<limiter> <state_>].
(map-kvs kf vf m)
Deprecated, prefer reduce-kv
Deprecated, prefer `reduce-kv`
(mapply f & args)
Like apply
but calls seq-kvs
on final arg.
Like `apply` but calls `seq-kvs` on final arg.
(memoize* f)
(memoize* ttl-ms f)
(memoize* cache-size ttl-ms f)
Like core/memoize
but:
ttl-ms
opt.cache-size
opt.:mem/del
or :mem/fresh
.Like `core/memoize` but: * Often faster, depending on opts. * Prevents race conditions on writes. * Supports auto invalidation & gc with `ttl-ms` opt. * Supports cache size limit & gc with `cache-size` opt. * Supports invalidation by prepending args with `:mem/del` or `:mem/fresh`.
(memoize-last f)
Like memoize
but only caches the fn's most recent call.
Great for Reactjs render op caching on mobile devices, etc.
Like `memoize` but only caches the fn's most recent call. Great for Reactjs render op caching on mobile devices, etc.
(memoize_ f)
Like core/memoize
but faster, non-racy, and supports invalidation.
Like `core/memoize` but faster, non-racy, and supports invalidation.
(merge & maps)
Like core/merge
but faster, supports :swap/dissoc
rvals.
Like `core/merge` but faster, supports `:swap/dissoc` rvals.
(merge-with f & maps)
Like core/merge-with
but faster, supports :swap/dissoc
rvals.
Like `core/merge-with` but faster, supports `:swap/dissoc` rvals.
(ms & {:as opts :keys [years months weeks days hours mins secs msecs ms]})
Returns ~number of milliseconds in period defined by given args.
Returns ~number of milliseconds in period defined by given args.
(name-with-attrs sym args)
(name-with-attrs sym args attrs-merge)
Given a symbol and args, returns [<name-with-attrs-meta> <args>] with
support for defn
style ?docstring
and ?attrs-map
.
Given a symbol and args, returns [<name-with-attrs-meta> <args>] with support for `defn` style `?docstring` and `?attrs-map`.
(nested-merge & maps)
Like merge
but does nested merging.
Like `merge` but does nested merging.
(nested-merge-with f & maps)
Like merge-with
but does nested merging.
Like `merge-with` but does nested merging.
(nnil)
(nnil x)
(nnil x y)
(nnil x y z)
(nnil x y z & more)
Returns first non-nil arg, or nil.
Returns first non-nil arg, or nil.
(norm-word-breaks s)
Converts all word breaks of any form and length (including line breaks of any form, tabs, spaces, etc.) to a single regular space.
Converts all word breaks of any form and length (including line breaks of any form, tabs, spaces, etc.) to a single regular space.
Uses window context as epoch, Ref. http://goo.gl/mWZWnR
Uses window context as epoch, Ref. http://goo.gl/mWZWnR
(oget o k)
(oget o k not-found)
Like get
for JS objects, Ref. https://goo.gl/eze8hY.
Like `get` for JS objects, Ref. https://goo.gl/eze8hY.
(oget-in o ks)
(oget-in o ks not-found)
Like get-in
for JS objects.
Like `get-in` for JS objects.
(parse-query-params s & [keywordize? encoding])
Based on ring-codec/form-decode
.
Based on `ring-codec/form-decode`.
(pr-edn x)
(pr-edn _opts x)
Prints arg to an edn string readable with read-edn
.
Prints arg to an edn string readable with `read-edn`.
(preserve-reduced rf)
As core/preserving-reduced
.
As `core/preserving-reduced`.
(pull-val! atom_ k)
(pull-val! atom_ k not-found)
Removes and returns value mapped to key.
Removes and returns value mapped to key.
(queue)
(queue coll)
Returns a PersistentQueue.
Returns a PersistentQueue.
(quick-bench nlaps form)
(quick-bench nlaps form & more)
Returns fastest of 3 sets of times for each form, in msecs.
Returns fastest of 3 sets of times for each form, in msecs.
(rate-limiter* specs)
Deprecated, prefer limiter
Deprecated, prefer `limiter`
(read-edn s)
(read-edn opts s)
Attempts to pave over differences in:
clojure.edn/read-string
, clojure.tools.edn/read-string
,
cljs.reader/read-string
, cljs.tools.reader/read-string
.
cljs.reader
in particular can be a pain.
Attempts to pave over differences in: `clojure.edn/read-string`, `clojure.tools.edn/read-string`, `cljs.reader/read-string`, `cljs.tools.reader/read-string`. `cljs.reader` in particular can be a pain.
(reduce-indexed rf init coll)
Like reduce
but takes (rf [acc idx in]) with idx as in map-indexed
.
Like `reduce` but takes (rf [acc idx in]) with idx as in `map-indexed`.
(reduce-kvs rf init kvs)
Like reduce-kv
but takes a flat sequence of kv pairs.
Like `reduce-kv` but takes a flat sequence of kv pairs.
(reduce-obj f init o)
Like reduce-kv
but for JavaScript objects.
Like `reduce-kv` but for JavaScript objects.
(reduce-top n rf init coll)
(reduce-top n keyfn rf init coll)
(reduce-top n keyfn cmp rf init coll)
Reduces the top n
items from coll
of N items into in O(N.logn) time.
For comparsion, (take n (sort-by ...)) is O(N.logN).
Reduces the top `n` items from `coll` of N items into in O(N.logn) time. For comparsion, (take n (sort-by ...)) is O(N.logN).
(repeatedly-into coll n f)
Like repeatedly
but faster and conj
s items into given collection.
Like `repeatedly` but faster and `conj`s items into given collection.
(reset-in! atom_ val)
(reset-in! atom_ ks val)
(reset-in! atom_ ks not-found val)
Like reset!
but supports update-in
semantics,
returns <old-key-val>.
Like `reset!` but supports `update-in` semantics, returns <old-key-val>.
(reset-val! atom_ k val)
(reset-val! atom_ k not-found val)
Low-level util, returns <old-key-val>.
Low-level util, returns <old-key-val>.
(reset-val!? atom_ k new-val)
Maps value to key and returns true iff the mapped value changed or was created.
Maps value to key and returns true iff the mapped value changed or was created.
(sb-append str-builder s)
(sb-append str-builder s & more)
For cross-platform string building
For cross-platform string building
(str-?index s substr)
(str-?index s substr start-idx)
(str-?index s substr start-idx last?)
For cross-platform string building
For cross-platform string building
(str-join coll)
(str-join separator coll)
(str-join separator xform coll)
Faster, transducer-based generalization of clojure.string/join
with xform
support
Faster, transducer-based generalization of `clojure.string/join` with `xform` support
(str-join-once separator coll)
Like string/join
but skips duplicate separators.
Like `string/join` but skips duplicate separators.
(str-replace s match replacement)
Like str/replace
but provides consistent clj/s behaviour.
Workaround for http://dev.clojure.org/jira/browse/CLJS-794, http://dev.clojure.org/jira/browse/CLJS-911.
Note that ClojureScript 1.7.145 introduced a partial fix for CLJS-911. A full fix could unfortunately not be introduced w/o breaking compatibility with the previously incorrect behaviour. CLJS-794 also remains unresolved.
Like `str/replace` but provides consistent clj/s behaviour. Workaround for http://dev.clojure.org/jira/browse/CLJS-794, http://dev.clojure.org/jira/browse/CLJS-911. Note that ClojureScript 1.7.145 introduced a partial fix for CLJS-911. A full fix could unfortunately not be introduced w/o breaking compatibility with the previously incorrect behaviour. CLJS-794 also remains unresolved.
(substr s start-idx & [?max-len])
Deprecated, prefer get-substr
or get-substring
Deprecated, prefer `get-substr` or `get-substring`
(subvec* v start-idx & [?max-len])
Deprecated, prefer get-subvec
or get-subvector
Deprecated, prefer `get-subvec` or `get-subvector`
(swap-in! atom_ f)
(swap-in! atom_ ks f)
(swap-in! atom_ ks not-found f)
Like swap!
but supports update-in
semantics,
returns <new-key-val> or <swapped-return-val>.
Like `swap!` but supports `update-in` semantics, returns <new-key-val> or <swapped-return-val>.
(swap-in!* atom_ f)
(swap-in!* atom_ ks f)
(swap-in!* atom_ ks not-found f)
Like swap!
but supports update-in
semantics,
returns [<old-key-val> <new-key-val>].
Like `swap!` but supports `update-in` semantics, returns [<old-key-val> <new-key-val>].
(swap-val! atom_ k f)
(swap-val! atom_ k not-found f)
Low-level util, returns <new-key-val> or <swapped-return-val>.
Low-level util, returns <new-key-val> or <swapped-return-val>.
(swap-val!* atom_ k f)
(swap-val!* atom_ k not-found f)
Low-level util, returns [<old-key-val> <new-key-val>].
Low-level util, returns [<old-key-val> <new-key-val>].
(time-ms & body)
Returns number of milliseconds it took to execute body.
Returns number of milliseconds it took to execute body.
(time-ns & body)
Returns number of nanoseconds it took to execute body.
Returns number of nanoseconds it took to execute body.
(top n coll)
(top n keyfn coll)
(top n keyfn cmp coll)
Returns a sorted vector of the top n
items from coll
using reduce-top
.
Returns a sorted vector of the top `n` items from `coll` using `reduce-top`.
(top-into to n coll)
(top-into to n keyfn coll)
(top-into to n keyfn cmp coll)
Conjoins the top n
items from coll
into to
using reduce-top
.
Conjoins the top `n` items from `coll` into `to` using `reduce-top`.
(update-in m ks f)
(update-in m ks not-found f)
Like core/update-in
but resolves an ambiguity with empty ks
,
adds support for not-found
, :swap/dissoc
vals.
Like `core/update-in` but resolves an ambiguity with empty `ks`, adds support for `not-found`, `:swap/dissoc` vals.
(url-decode s & [encoding])
Stolen from http://goo.gl/99NSR1
Stolen from http://goo.gl/99NSR1
(url-encode s)
Stolen from http://goo.gl/99NSR1
Stolen from http://goo.gl/99NSR1
(use-fixtures fixture-type & fixtures)
Cross-platform test/use-fixtures
Cross-platform `test/use-fixtures`
(uuid-str)
(uuid-str max-length)
Returns a UUIDv4 string of form "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx". Ref. http://www.ietf.org/rfc/rfc4122.txt, https://gist.github.com/franks42/4159427
Returns a UUIDv4 string of form "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx". Ref. http://www.ietf.org/rfc/rfc4122.txt, https://gist.github.com/franks42/4159427
(when test-or-bindings & body)
Like core/when
but acts like when-let
when given a binding vector
as test expr.
Like `core/when` but acts like `when-let` when given a binding vector as test expr.
(when-let bindings & body)
Like core/when-let
but can bind multiple values for body
iff all tests
are truthy, supports internal :let
s.
Like `core/when-let` but can bind multiple values for `body` iff all tests are truthy, supports internal `:let`s.
(when-not test-or-bindings & body)
Like core/when-not
but acts like when-let
when given a binding vector
as test expr.
Like `core/when-not` but acts like `when-let` when given a binding vector as test expr.
(with-dynamic-assertion-data data & body)
Executes body with dynamic assertion data bound to given value. This data will be included in any violation errors thrown by body.
Executes body with dynamic assertion data bound to given value. This data will be included in any violation errors thrown by body.
cljdoc is a website building & hosting documentation for Clojure/Script libraries
× close