Next: Introduction, Previous: (dir), Up: (dir) [Contents][Index]
This is the cl-interpol Reference Manual, version 0.2.7, generated automatically by Declt version 4.0 beta 2 "William Riker" on Thu Sep 15 03:51:59 2022 GMT+0.
Next: Systems, Previous: The cl-interpol Reference Manual, Up: The cl-interpol Reference Manual [Contents][Index]
CL-INTERPOL is a library for Common Lisp which modifies the reader so that you can have interpolation within strings similar to Perl or Unix Shell scripts. It also provides various ways to insert arbitrary characters into literal strings even if your editor/IDE doesn't support them. Here's an example:
(named-readtables:in-readtable :interpol-syntax)
(let ((a 42))
#?"foo: \xC4\N{Latin capital letter U with diaeresis}\nbar: ${a}")
"foo: ÄÜ
bar: 42"
CL-INTERPOL comes with a BSD-style license so you can basically do with it whatever you want.
Complete documentation for CL-INTERPOL can be found in the docs
directory or at the project documentation
site
Next: Files, Previous: Introduction, Up: The cl-interpol Reference Manual [Contents][Index]
The main system appears first, followed by any subsystem dependency.
BSD-2-Clause
0.2.7
Next: Packages, Previous: Systems, Up: The cl-interpol Reference Manual [Contents][Index]
Files are sorted by type and then listed depth-first from the systems components trees.
Next: cl-interpol/packages.lisp, Previous: Lisp, Up: Lisp [Contents][Index]
cl-interpol (system).
Next: cl-interpol/specials.lisp, Previous: cl-interpol/cl-interpol.asd, Up: Lisp [Contents][Index]
cl-interpol (system).
Next: cl-interpol/util.lisp, Previous: cl-interpol/packages.lisp, Up: Lisp [Contents][Index]
packages.lisp (file).
cl-interpol (system).
Next: cl-interpol/alias.lisp, Previous: cl-interpol/specials.lisp, Up: Lisp [Contents][Index]
specials.lisp (file).
cl-interpol (system).
Next: cl-interpol/read.lisp, Previous: cl-interpol/util.lisp, Up: Lisp [Contents][Index]
util.lisp (file).
cl-interpol (system).
Previous: cl-interpol/alias.lisp, Up: Lisp [Contents][Index]
alias.lisp (file).
cl-interpol (system).
Next: Definitions, Previous: Files, Up: The cl-interpol Reference Manual [Contents][Index]
Packages are listed by definition order.
Next: cl-interpol, Previous: Packages, Up: Packages [Contents][Index]
Previous: cl-interpol-asd, Up: Packages [Contents][Index]
interpol
Next: Indexes, Previous: Packages, Up: The cl-interpol Reference Manual [Contents][Index]
Definitions are sorted by export status, category, package, and then by lexicographic order.
Next: Internals, Previous: Definitions, Up: Definitions [Contents][Index]
Next: Macros, Previous: Public Interface, Up: Public Interface [Contents][Index]
Legal delimiters for interpolation with #$ and #@.
Whether to allow ~X(...) as format control directives in interpolated strings.
What is inserted between the elements of a list which is interpolated by #@.
Whether text following $ or @ should interpolate even without a following delimiter. Lexical variables are handled correctly, but the rules are somewhat complex – see the docs for details.
Legal outer delimiters for CL-INTERPOL strings.
Next: Ordinary functions, Previous: Special variables, Up: Public Interface [Contents][Index]
Restore readtable which was active before last call to ENABLE-INTERPOL-SYNTAX. If there was no such call, the standard readtable is used.
Enable CL-INTERPOL reader syntax.
Previous: Macros, Up: Public Interface [Contents][Index]
The actual reader function for the ’sub-character’ #?.
This function can be used directly outside of a read table by passing ‘recursive-p‘ as NIL.
Previous: Public Interface, Up: Definitions [Contents][Index]
A stack which holds the previous readtables that have been pushed here by ENABLE-INTERPOL-SYNTAX.
Bound to the current readtable if it has to be temporarily modified.
Outer delimiters which automatically enable regex mode.
Whether we have to re-process an L or U because it closes several scopes.
Bound to the opening outer delimiter while parsing a string.
Bound to the stream which is read from while parsing a string.
Bound to the closing outer delimiter while parsing a string.
A hash table which maps Unicode aliases to their real names.
A declaration form to quiet warnings about unbound variables within a lexical environment.
Next: Ordinary functions, Previous: Special variables, Up: Internals [Contents][Index]
Like DEFVAR, but the variable will be unbound rather than getting an initial value. This is useful for variables which should have no global value but might have a dynamically bound value.
Convenience macro because we always peek at the same string with the same arguments.
Convenience macro because we always read from the same string with the same arguments.
Like ERROR but signals a SIMPLE-READER-ERROR for the stream *STREAM*.
Next: Conditions, Previous: Macros, Up: Internals [Contents][Index]
Internal function used to restore previous readtable.
Internal function used to enable reader syntax and store current readtable on stack.
Returns a copy of the readtable which was current when INTERPOL-READER was invoked. Memoizes its result.
Parses and returns a named character after "\N" has already been read. This function reads from *STREAM*.
Find the closing delimiter corresponding to the opening delimiter START-DELIMITER in a list DELIMITERS which is formatted like *OUTER-DELIMITERS*. If ERRORP is true, signal an error if none was found, otherwise return NIL.
Reads and consumes the number *STREAM* is currently looking at and returns it. Returns NIL if no number could be identified. RADIX is used as in PARSE-INTEGER. If MAX is not NIL we’ll read at most the next MAX characters.
Helper function for INTERPOL-READER which does all the work. May call itself recursively.
Whether CHAR is a character which has case and is lowercase.
Create character from char-code NUMBER. NUMBER can be NIL which is interpreted as 0.
Create an empty string which can be extended by VECTOR-PUSH-EXTEND.
Return a subvector by pointing to location in original vector.
Reads and returns one or more Lisp forms from *STREAM* if the character we’re looking at is a valid inner delimiter. Otherwise returns NIL.
Reads and returns a format directive (as a string) along with one or more lisp forms (as per read-form).
Read the stuff following an optional delimiter, returning a form that tries to deal correctly with lexical variables.
Reads characters from *STREAM* while PREDICATE returns a true value for each character. Returns at most MAX characters if MAX is true.
Tries to return a character which was encoded as \N<NAME>.
Concatenates a list of strings to one string.
Convert the characters(s) on *STREAM* following a backslash into a character which is returned. This function is to be called when the backslash has already been consumed.
Previous: Ordinary functions, Up: Internals [Contents][Index]
A reader error which can be signalled by ERROR.
Previous: Definitions, Up: The cl-interpol Reference Manual [Contents][Index]
| Jump to: | %
C D E F G H I L M N P R S U |
|---|
| Jump to: | %
C D E F G H I L M N P R S U |
|---|
Next: Data types, Previous: Functions, Up: Indexes [Contents][Index]
| Jump to: | *
Q S |
|---|
| Jump to: | *
Q S |
|---|
| Jump to: | A C F P R S U |
|---|
| Jump to: | A C F P R S U |
|---|