The hu.dwim.util Reference Manual

4.1.1 hu.dwim.util/hu.dwim.util.asd

Source

hu.dwim.util.asd.

Parent Component

hu.dwim.util (system).

ASDF Systems

hu.dwim.util.

---

4.1.2 hu.dwim.util/source/anaphora.lisp

Dependency

package.lisp (file).

Source

hu.dwim.util.asd.

Parent Component

source (module).

Public Interface

• cond-bind (macro).
• if-bind (macro).
• prog1-bind (macro).
• when-bind (macro).

---

4.1.3 hu.dwim.util/source/dynamic-context.lisp

Dependency

miscellaneous.lisp (file).

Source

hu.dwim.util.asd.

Parent Component

source (module).

Public Interface

• define-dynamic-context (macro).
• define-dynamic-context* (macro).

---

4.1.4 hu.dwim.util/source/error-handling-early.lisp

Dependencies

• package.lisp (file).
• miscellaneous.lisp (file).

Source

hu.dwim.util.asd.

Parent Component

source (module).

Public Interface

• *debug-on-error* (special variable).
• collect-backtrace (function).
• collect-call-path (function).
• debug-on-error? (generic function).
• make-error-log-decorator (macro).
• make-special-variable-printing-error-log-decorator (macro).
• maybe-invoke-debugger (function).
• nested-condition (condition).
• print-error-safely (function).
• with-error-log-decorator (macro).
• with-error-log-decorators (macro).

Internals

• *error-log-decorators* (special variable).
• nested-condition-of (reader method).
• (setf nested-condition-of) (writer method).
• nested-condition-p (function).

---

4.1.5 hu.dwim.util/source/generic-operator.lisp

Dependency

package.lisp (file).

Source

hu.dwim.util.asd.

Parent Component

source (module).

Public Interface

• g* (generic function).
• g+ (generic function).
• g- (generic function).
• g/ (generic function).
• g< (generic function).
• g<= (generic function).
• g= (generic function).
• g> (generic function).
• g>= (generic function).

---

4.1.6 hu.dwim.util/source/hash-table.lisp

Dependency

package.lisp (file).

Source

hu.dwim.util.asd.

Parent Component

source (module).

Public Interface

• hash-key (generic function).
• hash-value (function).
• (setf hash-value) (function).
• remove-hash-value (function).

---

4.1.7 hu.dwim.util/source/integer-to-string.lisp

Dependency

package.lisp (file).

Source

hu.dwim.util.asd.

Parent Component

source (module).

Public Interface

integer-to-string (function).

Internals

• %integer-to-string (function).
• +cached-integer-names/base-10/unindented+ (constant).
• +integer-to-string-cache-size+ (constant).

---

4.1.8 hu.dwim.util/source/iterate.lisp

Dependency

package.lisp (file).

Source

hu.dwim.util.asd.

Parent Component

source (module).

Internals

• clause-anding-2 (function).
• clause-oring-3 (function).
• clause-summing*-1 (function).

---

4.1.9 hu.dwim.util/source/number.lisp

Dependency

package.lisp (file).

Source

hu.dwim.util.asd.

Parent Component

source (module).

Public Interface

• product (function).
• product* (function).
• round* (function).
• sum* (function).

---

4.1.10 hu.dwim.util/source/package.lisp

Source

hu.dwim.util.asd.

Parent Component

source (module).

Packages

• hu.dwim.util/error-reports.
• hu.dwim.util.

---

4.1.11 hu.dwim.util/source/pattern-matcher.lisp

Dependency

package.lisp (file).

Source

hu.dwim.util.asd.

Parent Component

source (module).

Public Interface

• pattern-case (macro).
• pattern-match (function).

Internals

• +failed-match+ (constant).
• +no-bindings+ (constant).
• binding-val (function).
• binding-var (function).
• collect-pattern-variables (function).
• extend-bindings (function).
• first-match-pos (function).
• get-binding (function).
• lookup (function).
• make-binding (function).
• match-and (function).
• match-if (function).
• match-is (function).
• match-not (function).
• match-or (function).
• match-variable (function).
• object-matcher (function).
• object-pattern-p (function).
• pattern-variable-p (function).
• segment-match (function).
• segment-match+ (function).
• segment-match-fn (function).
• segment-match? (function).
• segment-matcher (function).
• segment-pattern-p (function).
• single-match-fn (function).
• single-matcher (function).
• single-pattern-p (function).

---

4.1.12 hu.dwim.util/source/place.lisp

Dependency

package.lisp (file).

Source

hu.dwim.util.asd.

Parent Component

source (module).

Public Interface

• clearf (macro).
• notf (macro).
• symbol-global-value (function).
• (setf symbol-global-value) (function).

---

4.1.13 hu.dwim.util/source/sequence.lisp

Dependency

package.lisp (file).

Source

hu.dwim.util.asd.

Parent Component

source (module).

Public Interface

• all-the-same? (function).
• collect-if (function).
• ensure-sequence (function).
• find/tree (function).
• foreach (macro).
• map/tree (function).
• optional-list (function).
• optional-list* (function).
• partition (function).
• shrink-vector (function).
• split-sequence (function).
• split-sequence-by-partitioning (function).
• subseq-if-longer (function).
• substitute-all (function).
• substitute/tree (function).
• the-non-nil (compiler macro).
• the-non-nil (function).
• the-only-element (compiler macro).
• the-only-element (function).

---

4.1.14 hu.dwim.util/source/string.lisp

Dependency

miscellaneous.lisp (file).

Source

hu.dwim.util.asd.

Parent Component

source (module).

Public Interface

• +alphanumeric-ascii-alphabet+ (constant).
• +ascii-alphabet+ (constant).
• +base64-alphabet+ (constant).
• +lower-case-ascii-alphabet+ (constant).
• +upper-case-ascii-alphabet+ (constant).
• +whitespace-characters+ (constant).
• find-symbol* (function).
• levenshtein-distance (function).
• levenshtein-relative-distance (function).
• make-adjustable-string (function).
• make-string-of-spaces (function).
• parse-roman-numeral (function).
• random-string (function).
• roman-numeral-digit-character? (function).
• sanitize-string (function).
• sanitize-string/printable-ascii (function).
• string-trim-whitespace (function).
• string-with-integers< (function).
• string-with-numeric< (function).
• string-with-roman-numerals< (function).
• string/trim-whitespace-and-maybe-nil-it (macro).
• whitespace? (function).
• with-string-type-dispatch (macro).
• write-characters (function).
• write-spaces (function).

Internals

• +indent-length->string-of-spaces+ (constant).
• +string-of-spaces/cache-size+ (constant).

---

4.1.15 hu.dwim.util/source/string-early.lisp

Dependency

package.lisp (file).

Source

hu.dwim.util.asd.

Parent Component

source (module).

Public Interface

• join-strings (function).
• string+ (compiler macro).
• string+ (function).

---

4.1.16 hu.dwim.util/source/threads-early.lisp

Dependency

package.lisp (file).

Source

hu.dwim.util.asd.

Parent Component

source (module).

Public Interface

• atomic-counter (structure).
• atomic-counter/decrement (function).
• atomic-counter/increment (function).
• atomic-counter/value (function).
• make-atomic-counter (function).

Internals

• ac/counter (reader).
• (setf ac/counter) (writer).
• atomic-counter-p (function).
• copy-atomic-counter (function).

---

4.1.17 hu.dwim.util/source/type.lisp

Dependency

package.lisp (file).

Source

hu.dwim.util.asd.

Parent Component

source (module).

Public Interface

• +bottom-type+ (constant).
• +top-type+ (constant).
• expand-type (function).
• expand-type-1 (function).
• function-designator (type).
• function-name (type).
• type-instance-count-upper-bound (function).
• type-instance-list (function).

---

4.1.18 hu.dwim.util/source/miscellaneous.lisp

Dependencies

• package.lisp (file).
• string-early.lisp (file).

Source

hu.dwim.util.asd.

Parent Component

source (module).

Public Interface

• +process-return-code/no-error+ (constant).
• +xml-namespace-uri+ (constant).
• bit-value (macro).
• (setf bit-value) (setf expander).
• econd (macro).
• enable-standard-hu.dwim-syntaxes (function).
• eval-always (macro).
• eval/interpret (function).
• find-direct-slot (function).
• find-fully-qualified-symbol (function).
• find-function (function).
• find-slot (function).
• fully-qualified-symbol-name (function).
• get-monotonic-time (function).
• handle-otherwise (macro).
• handle-otherwise* (macro).
• handle-otherwise/value (function).
• if-symbol-exists (function).
• mandatory-argument (function).
• not-yet-implemented (function).
• not-yet-implemented/crucial-api (function).
• not-yet-implemented/form (function).
• operation-not-supported (function).
• quit (function).
• quoted-form? (function).
• quoted-symbol? (function).
• rebind (macro).
• sbcl-version>= (function).
• surround-body-unless (macro).
• surround-body-unless* (macro).
• surround-body-when (macro).
• surround-body-when* (macro).
• to-boolean (macro).
• with-dynamic-memoize (macro).
• with-keyword-package (macro).
• with-muffled-boring-compiler-warnings (macro).
• with-muffled-redefinition-warnings (macro).
• with-muffled-warnings (macro).
• with-thread-activity-description (macro).
• with-thread-name (macro).

---

4.1.19 hu.dwim.util/integration/sbcl.lisp

If Feature

(:and :sbcl (:not :windows))

Source

hu.dwim.util.asd.

Parent Component

integration (module).

Public Interface

with-profiling (macro).

Internals

call-with-profiling (function).

---

6.1.1 Constants

Constant: +alphanumeric-ascii-alphabet+ ¶

Package

hu.dwim.util.

Source

string.lisp.

Constant: +ascii-alphabet+ ¶

Package

hu.dwim.util.

Source

string.lisp.

Constant: +base64-alphabet+ ¶

Package

hu.dwim.util.

Source

string.lisp.

Constant: +bottom-type+ ¶

Package

hu.dwim.util.

Source

type.lisp.

Constant: +lower-case-ascii-alphabet+ ¶

Package

hu.dwim.util.

Source

string.lisp.

Constant: +process-return-code/no-error+ ¶

Package

hu.dwim.util.

Source

miscellaneous.lisp.

Constant: +top-type+ ¶

Package

hu.dwim.util.

Source

type.lisp.

Constant: +upper-case-ascii-alphabet+ ¶

Package

hu.dwim.util.

Source

string.lisp.

Constant: +whitespace-characters+ ¶

Package

hu.dwim.util.

Source

string.lisp.

Constant: +xml-namespace-uri+ ¶

Package

hu.dwim.util.

Source

miscellaneous.lisp.

---

6.1.2 Special variables

Special Variable: *debug-on-error* ¶

The default, system wide, value for debug-on-error.

Package

hu.dwim.util.

Source

error-handling-early.lisp.

---

6.1.3 Macros

Macro: bit-value (index integer) ¶

Returns the INDEX’th bit of INTEGER as a boolean.

Package

hu.dwim.util.

Source

miscellaneous.lisp.

Setf expander for this macro

(setf bit-value).

Macro: clearf (&rest places) ¶

Package

hu.dwim.util.

Source

place.lisp.

Macro: cond-bind (var &body clauses) ¶

Just like COND but VAR will be bound to the result of the condition in the clause when executing the body of the clause.

Package

hu.dwim.util.

Source

anaphora.lisp.

Macro: define-dynamic-context (name direct-slots &key direct-superclasses export-symbols class-name chain-parents create-struct create-class struct-options defclass-macro-name) ¶

The purpose of this macro is to provide an easy way to access a group of related special variables. To do so, it generates with-NAME/in-NAME/current-NAME/has-NAME macros to access either a CLOS instance or a defstruct in a special variable. Optionally it can chain the "parent" bindings (use :CHAIN-PARENTS T and access with PARENT-CONTEXT-OF).

Package

hu.dwim.util.

Source

dynamic-context.lisp.

Macro: define-dynamic-context* (name direct-slots &rest args &key defclass-macro-name &allow-other-keys) ¶

Package

hu.dwim.util.

Source

dynamic-context.lisp.

Macro: econd (&rest clauses) ¶

Package

hu.dwim.util.

Source

miscellaneous.lisp.

Macro: eval-always (&body body) ¶

Package

hu.dwim.util.

Source

miscellaneous.lisp.

Macro: foreach (function first-sequence &rest more-sequences) ¶

Package

hu.dwim.util.

Source

sequence.lisp.

Macro: handle-otherwise (&body default-error-forms) ¶

Package

hu.dwim.util.

Source

miscellaneous.lisp.

Macro: handle-otherwise* ((&key default-message) &body default-forms) ¶

Package

hu.dwim.util.

Source

miscellaneous.lisp.

Macro: if-bind (var test &body then/else) ¶

Package

hu.dwim.util.

Source

anaphora.lisp.

Macro: make-error-log-decorator (&body body) ¶

Package

hu.dwim.util.

Source

error-handling-early.lisp.

Macro: make-special-variable-printing-error-log-decorator (&rest variables) ¶

Package

hu.dwim.util.

Source

error-handling-early.lisp.

Macro: notf (&rest places) ¶

Package

hu.dwim.util.

Source

place.lisp.

Macro: pattern-case (expr &body clauses) ¶

Package

hu.dwim.util.

Source

pattern-matcher.lisp.

Macro: prog1-bind (var ret &body body) ¶

Package

hu.dwim.util.

Source

anaphora.lisp.

Macro: rebind (bindings &body body) ¶

Package

hu.dwim.util.

Source

miscellaneous.lisp.

Macro: string/trim-whitespace-and-maybe-nil-it (variable) ¶

Package

hu.dwim.util.

Source

string.lisp.

Macro: surround-body-unless (test surround-with &body body) ¶

Package

hu.dwim.util.

Source

miscellaneous.lisp.

Macro: surround-body-unless* ((test surround-with &key body-name) &body body) ¶

Package

hu.dwim.util.

Source

miscellaneous.lisp.

Macro: surround-body-when (test surround-with &body body) ¶

Package

hu.dwim.util.

Source

miscellaneous.lisp.

Macro: surround-body-when* ((test surround-with &key body-name) &body body) ¶

Package

hu.dwim.util.

Source

miscellaneous.lisp.

Macro: to-boolean (form) ¶

Package

hu.dwim.util.

Source

miscellaneous.lisp.

Macro: when-bind (var test &body body) ¶

Package

hu.dwim.util.

Source

anaphora.lisp.

Macro: with-dynamic-memoize ((name &rest keys) &body forms) ¶

Package

hu.dwim.util.

Source

miscellaneous.lisp.

Macro: with-error-log-decorator (decorator &body body) ¶

Package

hu.dwim.util.

Source

error-handling-early.lisp.

Macro: with-error-log-decorators (bindings &body body) ¶

Multiple binding version of with-error-log-decorator.

Package

hu.dwim.util.

Source

error-handling-early.lisp.

Macro: with-keyword-package (&body body) ¶

Package

hu.dwim.util.

Source

miscellaneous.lisp.

Macro: with-muffled-boring-compiler-warnings (&body body) ¶

Package

hu.dwim.util.

Source

miscellaneous.lisp.

Macro: with-muffled-redefinition-warnings (&body body) ¶

Package

hu.dwim.util.

Source

miscellaneous.lisp.

Macro: with-muffled-warnings ((&rest types) &body body) ¶

Package

hu.dwim.util.

Source

miscellaneous.lisp.

Macro: with-profiling (() &body with-body1) ¶

Package

hu.dwim.util.

Source

sbcl.lisp.

Macro: with-string-type-dispatch ((variable &optional types) &body body) ¶

Package

hu.dwim.util.

Source

string.lisp.

Macro: with-thread-activity-description ((name) &body body) ¶

This is a debugging helper tool. Information provided here may show up in backtraces unless compiled without the debug helpers.

Package

hu.dwim.util.

Source

miscellaneous.lisp.

Macro: with-thread-name (name &body body) ¶

Package

hu.dwim.util.

Source

miscellaneous.lisp.

---

6.1.4 Compiler macros

Compiler Macro: string+ (&rest args) ¶

Package

hu.dwim.util.

Source

string-early.lisp.

Compiler Macro: the-non-nil (value) ¶

Package

hu.dwim.util.

Source

sequence.lisp.

Compiler Macro: the-only-element (elements) ¶

Package

hu.dwim.util.

Source

sequence.lisp.

---

6.1.5 Setf expanders

Setf Expander: (setf bit-value) (index integer) ¶

Package

hu.dwim.util.

Source

miscellaneous.lisp.

Reader

bit-value (macro).

---

6.1.6 Ordinary functions

Function: all-the-same? (sequence &key test key) ¶

Returns true if every element in the LIST are equal to each other using TEST.

Package

hu.dwim.util.

Source

sequence.lisp.

Function: atomic-counter/decrement (atomic-counter &optional delta) ¶

A convenience version of ATOMIC-COUNTER/INCREMENT, mostly to keep the user code readable.

Package

hu.dwim.util.

Source

threads-early.lisp.

Function: atomic-counter/increment (atomic-counter &optional delta) ¶

Increments a special place holding a machine word sized integer in a way that paralell CPU’s don’t step on each other’s toes when incrementing/decrementing it. These operation don’t expand to bignums, they just overflow/underflow when the high/low bound of the word sized integer is crossed.

Package

hu.dwim.util.

Source

threads-early.lisp.

Function: atomic-counter/value (atomic-counter) ¶

See ATOMIC-COUNTER for details.

Package

hu.dwim.util.

Source

threads-early.lisp.

Function: collect-backtrace (&key start count) ¶

Package

hu.dwim.util.

Source

error-handling-early.lisp.

Function: collect-call-path (&key start count) ¶

Package

hu.dwim.util.

Source

error-handling-early.lisp.

Function: collect-if (predicate sequence &key key) ¶

Collects elements from SEQUENCE for which the PREDICATE is true into a freshly allocated sequence.

Package

hu.dwim.util.

Source

sequence.lisp.

Function: enable-standard-hu.dwim-syntaxes () ¶

This function sets up the common readtable modifications we (http://dwim.hu) use in almost all of our projects. Some projects enable more, but this is available almost everywhere.

Package

hu.dwim.util.

Source

miscellaneous.lisp.

Function: ensure-sequence (thing) ¶

Package

hu.dwim.util.

Source

sequence.lisp.

Function: eval/interpret (form) ¶

Package

hu.dwim.util.

Source

miscellaneous.lisp.

Function: expand-type (type &optional env) ¶

Package

hu.dwim.util.

Source

type.lisp.

Function: expand-type-1 (type &optional env) ¶

Package

hu.dwim.util.

Source

type.lisp.

Function: find-direct-slot (class-or-name slot-name &key otherwise) ¶

Package

hu.dwim.util.

Source

miscellaneous.lisp.

Function: find-fully-qualified-symbol (name &key otherwise) ¶

The inverse of FULLY-QUALIFIED-SYMBOL-NAME. Does not INTERN but it does instantiate package-less symbols.

Package

hu.dwim.util.

Source

miscellaneous.lisp.

Function: find-function (name &key otherwise) ¶

Package

hu.dwim.util.

Source

miscellaneous.lisp.

Function: find-slot (class-or-name slot-name &key otherwise) ¶

Package

hu.dwim.util.

Source

miscellaneous.lisp.

Function: find-symbol* (symbol-name &key packages otherwise) ¶

Package

hu.dwim.util.

Source

string.lisp.

Function: find/tree (item sequence &key key test) ¶

Package

hu.dwim.util.

Source

sequence.lisp.

Function: fully-qualified-symbol-name (symbol &key separator) ¶

Package

hu.dwim.util.

Source

miscellaneous.lisp.

Function: get-monotonic-time () ¶

Returns such a time measure that constantly grows (it’s a number in seconds, and it’s unaffected by setting the system clock).

Package

hu.dwim.util.

Source

miscellaneous.lisp.

Function: handle-otherwise/value (otherwise &key default-message) ¶

Package

hu.dwim.util.

Source

miscellaneous.lisp.

Function: hash-value (key hashtable) ¶

Package

hu.dwim.util.

Source

hash-table.lisp.

Function: (setf hash-value) (key hashtable) ¶

Package

hu.dwim.util.

Source

hash-table.lisp.

Function: if-symbol-exists (package name) ¶

Can be used to conditionalize at read-time like this: #+#.(hu.dwim.util:if-symbol-exists "PKG" "FOO")(pkg::foo ...)

Package

hu.dwim.util.

Source

miscellaneous.lisp.

Function: integer-to-string (integer &key minimum-column-count maximum-digit-count base) ¶

Package

hu.dwim.util.

Source

integer-to-string.lisp.

Function: join-strings (strings &optional separator) ¶

Package

hu.dwim.util.

Source

string-early.lisp.

Function: levenshtein-distance (s1 s2) ¶

Package

hu.dwim.util.

Source

string.lisp.

Function: levenshtein-relative-distance (s1 s2) ¶

Package

hu.dwim.util.

Source

string.lisp.

Function: make-adjustable-string (initial-contents) ¶

Package

hu.dwim.util.

Source

string.lisp.

Function: make-atomic-counter (&key counter) ¶

Package

hu.dwim.util.

Source

threads-early.lisp.

Function: make-string-of-spaces (count) ¶

Package

hu.dwim.util.

Source

string.lisp.

Function: mandatory-argument () ¶

Package

hu.dwim.util.

Source

miscellaneous.lisp.

Function: map/tree (visitor sequence &key key) ¶

Depth-first, returns with (VALUES).

Package

hu.dwim.util.

Source

sequence.lisp.

Function: maybe-invoke-debugger (condition &key context) ¶

Package

hu.dwim.util.

Source

error-handling-early.lisp.

Function: not-yet-implemented (&optional datum &rest args) ¶

Package

hu.dwim.util.

Source

miscellaneous.lisp.

Function: not-yet-implemented/crucial-api (name) ¶

Package

hu.dwim.util.

Source

miscellaneous.lisp.

Function: not-yet-implemented/form (name &key runtime-signal-kind) ¶

Package

hu.dwim.util.

Source

miscellaneous.lisp.

Function: operation-not-supported (&optional datum &rest args) ¶

Package

hu.dwim.util.

Source

miscellaneous.lisp.

Function: optional-list (&rest elements) ¶

Package

hu.dwim.util.

Source

sequence.lisp.

Function: optional-list* (&rest elements) ¶

Package

hu.dwim.util.

Source

sequence.lisp.

Function: parse-roman-numeral (str &key start end) ¶

Package

hu.dwim.util.

Source

string.lisp.

Function: partition (sequence &rest predicates) ¶

Package

hu.dwim.util.

Source

sequence.lisp.

Function: pattern-match (pattern input &optional bindings) ¶

Match pattern against input in the context of the bindings

Package

hu.dwim.util.

Source

pattern-matcher.lisp.

Function: print-error-safely (&optional message &rest args) ¶

Package

hu.dwim.util.

Source

error-handling-early.lisp.

Function: product (&rest args) ¶

Package

hu.dwim.util.

Source

number.lisp.

Function: product* (list &key key ignore-non-numbers) ¶

Package

hu.dwim.util.

Source

number.lisp.

Function: quit (status-code) ¶

Package

hu.dwim.util.

Source

miscellaneous.lisp.

Function: quoted-form? (thing) ¶

Package

hu.dwim.util.

Source

miscellaneous.lisp.

Function: quoted-symbol? (thing) ¶

Package

hu.dwim.util.

Source

miscellaneous.lisp.

Function: random-string (&optional length alphabet prefix) ¶

Package

hu.dwim.util.

Source

string.lisp.

Function: remove-hash-value (key hashtable) ¶

Package

hu.dwim.util.

Source

hash-table.lisp.

Function: roman-numeral-digit-character? (char) ¶

Package

hu.dwim.util.

Source

string.lisp.

Function: round* (number &optional divisor) ¶

CL:ROUND rounds so that .5 is rounded up for odd and down for even quotients. ROUND* always rounds .5 up.

Package

hu.dwim.util.

Source

number.lisp.

Function: sanitize-string (string lower-limit upper-limit &key replacement) ¶

By default sanitize for the printable ASCII range. Limits are inclusive.

Package

hu.dwim.util.

Source

string.lisp.

Function: sanitize-string/printable-ascii (string &key replacement) ¶

Package

hu.dwim.util.

Source

string.lisp.

Function: sbcl-version>= (&rest subversions) ¶

Can be used to conditionalize at read-time like this: #+#.(hu.dwim.util:sbcl-version>= 1 2) (some-sbcl-form ...). Reads nothing when not on SBCL.

Package

hu.dwim.util.

Source

miscellaneous.lisp.

Function: shrink-vector (vector &optional size) ¶

Fast shrinking for simple vectors. It’s not thread-safe, use only on local vectors!

Package

hu.dwim.util.

Source

sequence.lisp.

Function: split-sequence (delimiter seq &key count remove-empty-subseqs from-end start end test test-not key) ¶

Return a list of subsequences in seq delimited by delimiter.

If :remove-empty-subseqs is NIL, empty subsequences will be included in the result; otherwise they will be discarded. All other keywords work analogously to those for CL:SUBSTITUTE. In particular, the behaviour of :from-end is possibly different from other versions of this function; :from-end values of NIL and T are equivalent unless :count is supplied. The second return value is an index suitable as an argument to CL:SUBSEQ into the sequence indicating where processing stopped.

Package

hu.dwim.util.

Source

sequence.lisp.

Function: split-sequence-by-partitioning (sequence &rest predicates) ¶

Package

hu.dwim.util.

Source

sequence.lisp.

Function: string+ (&rest args) ¶

Package

hu.dwim.util.

Source

string-early.lisp.

Function: string-trim-whitespace (text) ¶

Package

hu.dwim.util.

Source

string.lisp.

Function: string-with-integers< (str1 str2 &key start1 start2) ¶

Package

hu.dwim.util.

Source

string.lisp.

Function: string-with-numeric< (str1 str2 digit-p parse-number &key start1 start2) ¶

Package

hu.dwim.util.

Source

string.lisp.

Function: string-with-roman-numerals< (str1 str2 &key start1 start2) ¶

Package

hu.dwim.util.

Source

string.lisp.

Function: subseq-if-longer (limit sequence &key postfix) ¶

Package

hu.dwim.util.

Source

sequence.lisp.

Function: substitute-all (old-elements new-element sequence &key test start count end key from-end) ¶

Package

hu.dwim.util.

Source

sequence.lisp.

Function: substitute/tree (new old list &key from-end test test-not end count key start) ¶

Starting from LIST non-destructively replaces OLD with NEW.

Package

hu.dwim.util.

Source

sequence.lisp.

Function: sum* (list &key key ignore-non-numbers) ¶

Package

hu.dwim.util.

Source

number.lisp.

Function: symbol-global-value (symbol) ¶

Operates on the global binding of SYMBOL (as opposed to the thread local binding accessed by CL:SYMBOL-VALUE).

Package

hu.dwim.util.

Source

place.lisp.

Function: (setf symbol-global-value) (symbol) ¶

Operates on the global binding of SYMBOL (as opposed to the thread local binding accessed by CL:SYMBOL-VALUE).

Package

hu.dwim.util.

Source

place.lisp.

Function: the-non-nil (value) ¶

Package

hu.dwim.util.

Source

sequence.lisp.

Function: the-only-element (elements) ¶

Package

hu.dwim.util.

Source

sequence.lisp.

Function: type-instance-count-upper-bound (input-type) ¶

Package

hu.dwim.util.

Source

type.lisp.

Function: type-instance-list (type) ¶

Package

hu.dwim.util.

Source

type.lisp.

Function: whitespace? (character) ¶

Package

hu.dwim.util.

Source

string.lisp.

Function: write-characters (character count &optional stream) ¶

Package

hu.dwim.util.

Source

string.lisp.

Function: write-spaces (count &optional stream) ¶

Package

hu.dwim.util.

Source

string.lisp.

---

6.1.7 Generic functions

Generic Function: debug-on-error? (context error) ¶

Package

hu.dwim.util.

Source

error-handling-early.lisp.

Methods

Method: debug-on-error? (context error) ¶

Generic Function: g* (object-1 object-2) ¶

Package

hu.dwim.util.

Source

generic-operator.lisp.

Methods

Method: g* ((object-1 number) (object-2 number)) ¶

Generic Function: g+ (object-1 object-2) ¶

Package

hu.dwim.util.

Source

generic-operator.lisp.

Methods

Method: g+ ((object-1 number) (object-2 number)) ¶

Generic Function: g- (object-1 object-2) ¶

Package

hu.dwim.util.

Source

generic-operator.lisp.

Methods

Method: g- ((object-1 number) (object-2 number)) ¶

Generic Function: g/ (object-1 object-2) ¶

Package

hu.dwim.util.

Source

generic-operator.lisp.

Methods

Method: g/ ((object-1 number) (object-2 number)) ¶

Generic Function: g< (object-1 object-2) ¶

Package

hu.dwim.util.

Source

generic-operator.lisp.

Methods

Method: g< ((object-1 number) (object-2 number)) ¶

Method: g< ((object-1 string) (object-2 string)) ¶

Generic Function: g<= (object-1 object-2) ¶

Package

hu.dwim.util.

Source

generic-operator.lisp.

Methods

Method: g<= ((object-1 number) (object-2 number)) ¶

Method: g<= ((object-1 string) (object-2 string)) ¶

Generic Function: g= (object-1 object-2) ¶

Package

hu.dwim.util.

Source

generic-operator.lisp.

Methods

Method: g= (object-1 object-2) ¶

Method: g= ((object-1 number) (object-2 number)) ¶

Method: g= ((object-1 string) (object-2 string)) ¶

Method: g= ((object-1 symbol) (object-2 symbol)) ¶

Method: g= ((object-1 list) (object-2 list)) ¶

Method: g= ((object-1 array) (object-2 array)) ¶

Method: g= ((object-1 hash-table) (object-2 hash-table)) ¶

Method: g= ((object-1 structure-object) (object-2 structure-object)) ¶

Method: g= ((object-1 standard-object) (object-2 standard-object)) ¶

Generic Function: g> (object-1 object-2) ¶

Package

hu.dwim.util.

Source

generic-operator.lisp.

Methods

Method: g> ((object-1 number) (object-2 number)) ¶

Method: g> ((object-1 string) (object-2 string)) ¶

Generic Function: g>= (object-1 object-2) ¶

Package

hu.dwim.util.

Source

generic-operator.lisp.

Methods

Method: g>= ((object-1 number) (object-2 number)) ¶

Method: g>= ((object-1 string) (object-2 string)) ¶

Generic Function: hash-key (object) ¶

Package

hu.dwim.util.

Source

hash-table.lisp.

Methods

Method: hash-key (object) ¶

---

6.1.8 Conditions

Condition: nested-condition ¶

Package

hu.dwim.util.

Source

error-handling-early.lisp.

Direct superclasses

condition.

Direct methods

• (setf nested-condition-of).
• nested-condition-of.

Direct slots

Slot: nested-condition ¶

Initform

(quote nil)

Initargs

:nested-condition

Readers

nested-condition-of.

Writers

(setf nested-condition-of).

---

6.1.9 Structures

Structure: atomic-counter ¶

Package

hu.dwim.util.

Source

threads-early.lisp.

Direct superclasses

structure-object.

Direct slots

Slot: counter ¶

Type

(unsigned-byte 64)

Initform

0

Readers

ac/counter.

Writers

(setf ac/counter).

---

6.1.10 Types

Type: function-designator () ¶

Package

hu.dwim.util.

Source

type.lisp.

Type: function-name () ¶

Package

hu.dwim.util.

Source

type.lisp.

---

6.2.1 Constants

Constant: +cached-integer-names/base-10/unindented+ ¶

Package

hu.dwim.util.

Source

integer-to-string.lisp.

Constant: +failed-match+ ¶

Package

hu.dwim.util.

Source

pattern-matcher.lisp.

Constant: +indent-length->string-of-spaces+ ¶

Package

hu.dwim.util.

Source

string.lisp.

Constant: +integer-to-string-cache-size+ ¶

Package

hu.dwim.util.

Source

integer-to-string.lisp.

Constant: +no-bindings+ ¶

Package

hu.dwim.util.

Source

pattern-matcher.lisp.

Constant: +string-of-spaces/cache-size+ ¶

Package

hu.dwim.util.

Source

string.lisp.

---

6.2.2 Special variables

Special Variable: *error-log-decorators* ¶

List of decorators that will be invoked when an error backtrace is logged. A decorator is a closure that will be FUNCALL’d and can print to *STANDARD-OUTPUT* (caret will not be on a new line when called).

Package

hu.dwim.util.

Source

error-handling-early.lisp.

---

6.2.3 Ordinary functions

Function: %integer-to-string (integer minimum-column-count maximum-digit-count base) ¶

Package

hu.dwim.util.

Source

integer-to-string.lisp.

Reader: ac/counter (instance) ¶

Writer: (setf ac/counter) (instance) ¶

Package

hu.dwim.util.

Source

threads-early.lisp.

Target Slot

counter.

Function: atomic-counter-p (object) ¶

Package

hu.dwim.util.

Source

threads-early.lisp.

Function: binding-val (binding) ¶

Get the value part of a single binding.

Package

hu.dwim.util.

Source

pattern-matcher.lisp.

Function: binding-var (binding) ¶

Get the variable part of a single binding.

Package

hu.dwim.util.

Source

pattern-matcher.lisp.

Function: call-with-profiling (fn0) ¶

Package

hu.dwim.util.

Source

sbcl.lisp.

Function: clause-anding-2 (&key anding into) ¶

Package

hu.dwim.util.

Source

iterate.lisp.

Function: clause-oring-3 (&key oring into) ¶

Package

hu.dwim.util.

Source

iterate.lisp.

Function: clause-summing*-1 (&key summing* into) ¶

Sum into a variable when expr evaluates to non nil at least once, otherwise nil

Package

hu.dwim.util.

Source

iterate.lisp.

Function: collect-pattern-variables (syntax &optional found-so-far) ¶

Return a list of leaves of tree satisfying predicate, with duplicates removed.

Package

hu.dwim.util.

Source

pattern-matcher.lisp.

Function: copy-atomic-counter (instance) ¶

Package

hu.dwim.util.

Source

threads-early.lisp.

Function: extend-bindings (var val bindings) ¶

Add a (var . value) pair to a binding list.

Package

hu.dwim.util.

Source

pattern-matcher.lisp.

Function: first-match-pos (pat1 input start) ¶

Find the first position that pat1 could possibly match input, starting at position start. If pat1 is non-constant, then just return start.

Package

hu.dwim.util.

Source

pattern-matcher.lisp.

Function: get-binding (var bindings) ¶

Find a (variable . value) pair in a binding list.

Package

hu.dwim.util.

Source

pattern-matcher.lisp.

Function: lookup (var bindings) ¶

Get the value part (for var) from a binding list.

Package

hu.dwim.util.

Source

pattern-matcher.lisp.

Function: make-binding (var val) ¶

Package

hu.dwim.util.

Source

pattern-matcher.lisp.

Function: match-and (patterns input bindings) ¶

Succeed if all the patterns match the input.

Package

hu.dwim.util.

Source

pattern-matcher.lisp.

Function: match-if (pattern input bindings) ¶

Test an arbitrary expression involving variables. The pattern looks like ((?if code) . rest).

Package

hu.dwim.util.

Source

pattern-matcher.lisp.

Function: match-is (var-and-pred input bindings) ¶

Succeed and bind var if the input satisfies pred, where var-and-pred is the list (var pred).

Package

hu.dwim.util.

Source

pattern-matcher.lisp.

Function: match-not (patterns input bindings) ¶

Succeed if none of the patterns match the input. This will never bind any variables.

Package

hu.dwim.util.

Source

pattern-matcher.lisp.

Function: match-or (patterns input bindings) ¶

Succeed if any one of the patterns match the input.

Package

hu.dwim.util.

Source

pattern-matcher.lisp.

Function: match-variable (var input bindings) ¶

Does VAR match input? Uses (or updates) and returns bindings.

Package

hu.dwim.util.

Source

pattern-matcher.lisp.

Function: nested-condition-p (object) ¶

Package

hu.dwim.util.

Source

error-handling-early.lisp.

Function: object-matcher (pattern input bindings) ¶

Package

hu.dwim.util.

Source

pattern-matcher.lisp.

Function: object-pattern-p (pattern) ¶

Package

hu.dwim.util.

Source

pattern-matcher.lisp.

Function: pattern-variable-p (x) ¶

Is x a variable (a symbol beginning with ‘?’)?

Package

hu.dwim.util.

Source

pattern-matcher.lisp.

Function: segment-match (pattern input bindings &optional start) ¶

Match the segment pattern ((?* var) . pat) against input.

Package

hu.dwim.util.

Source

pattern-matcher.lisp.

Function: segment-match+ (pattern input bindings) ¶

Match one or more elements of input.

Package

hu.dwim.util.

Source

pattern-matcher.lisp.

Function: segment-match-fn (x) ¶

Get the segment-match function for x, if it is a symbol that has one.

Package

hu.dwim.util.

Source

pattern-matcher.lisp.

Function: segment-match? (pattern input bindings) ¶

Match zero or one element of input.

Package

hu.dwim.util.

Source

pattern-matcher.lisp.

Function: segment-matcher (pattern input bindings) ¶

Call the right function for this kind of segment pattern.

Package

hu.dwim.util.

Source

pattern-matcher.lisp.

Function: segment-pattern-p (pattern) ¶

Is this a segment-matching pattern like ((?* var) . pat)?

Package

hu.dwim.util.

Source

pattern-matcher.lisp.

Function: single-match-fn (x) ¶

Get the single-match function for x, if it is a symbol that has one.

Package

hu.dwim.util.

Source

pattern-matcher.lisp.

Function: single-matcher (pattern input bindings) ¶

Call the right function for this kind of single pattern.

Package

hu.dwim.util.

Source

pattern-matcher.lisp.

Function: single-pattern-p (pattern) ¶

Is this a single-matching pattern?
E.g. (?is x predicate) (?and . patterns) (?or . patterns).

Package

hu.dwim.util.

Source

pattern-matcher.lisp.

---

6.2.4 Generic functions

Generic Reader: nested-condition-of (condition) ¶

Generic Writer: (setf nested-condition-of) (condition) ¶

Package

hu.dwim.util.

Methods

Reader Method: nested-condition-of ((condition nested-condition)) ¶

Writer Method: (setf nested-condition-of) ((condition nested-condition)) ¶

Source

error-handling-early.lisp.

Target Slot

nested-condition.

---