This is the html-template Reference Manual, version 0.9.2, generated automatically by Declt version 4.0 beta 2 "William Riker" on Tue Jul 15 05:18:02 2025 GMT+0.
The main system appears first, followed by any subsystem dependency.
html-template0.9.2
packages.lisp (file).
specials.lisp (file).
errors.lisp (file).
util.lisp (file).
template.lisp (file).
api.lisp (file).
Files are sorted by type and then listed depth-first from the systems components trees.
html-template/html-template.asdhtml-template/packages.lisphtml-template/specials.lisphtml-template/errors.lisphtml-template/util.lisphtml-template/template.lisphtml-template/api.lisphtml-template/specials.lisppackages.lisp (file).
html-template (system).
*call-template-access-function* (special variable).
*convert-nil-to-empty-string* (special variable).
*default-template-output* (special variable).
*default-template-pathname* (special variable).
*escape-char-p* (special variable).
*force-default* (special variable).
*format-non-strings* (special variable).
*ignore-empty-lines* (special variable).
*no-cache-check* (special variable).
*sequences-are-lists* (special variable).
*string-modifier* (special variable).
*template-end-marker* (special variable).
*template-start-marker* (special variable).
*template-symbol-package* (special variable).
*upcase-attribute-strings* (special variable).
*value-access-function* (special variable).
*warn-on-creation* (special variable).
*call-value-access-function* (special variable).
*current-column* (special variable).
*current-line* (special variable).
*external-format* (special variable).
*find-string-hash* (special variable).
*hyperdoc-base-uri* (special variable).
*included-files* (special variable).
*printer-hash* (special variable).
*template-output* (special variable).
hyperdoc-lookup (function).
html-template/errors.lispspecials.lisp (file).
html-template (system).
template-error (condition).
template-invocation-error (condition).
template-missing-value-error (condition).
template-not-a-string-error (condition).
template-not-a-string-error-value (reader method).
template-syntax-error (condition).
template-syntax-error-col (reader method).
template-syntax-error-line (reader method).
template-syntax-error-stream (reader method).
*syntax-error-location* (special variable).
copy-syntax-error-location (function).
make-syntax-error-location (function).
signal-template-invocation-error (macro).
signal-template-missing-value-error (macro).
signal-template-syntax-error (macro).
syntax-error-location (structure).
syntax-error-location-col (reader).
(setf syntax-error-location-col) (writer).
syntax-error-location-line (reader).
(setf syntax-error-location-line) (writer).
syntax-error-location-p (function).
syntax-error-location-stream (reader).
(setf syntax-error-location-stream) (writer).
with-syntax-error-location (macro).
html-template/util.lisperrors.lisp (file).
html-template (system).
escape-string (function).
escape-string-all (function).
escape-string-iso-8859-1 (function).
escape-string-minimal (function).
escape-string-minimal-plus-quotes (function).
%read-char (function).
list-to-string (function).
no-values (function).
read-delimited-string (function).
read-tag-rest (function).
read-until (function).
read-while (function).
skip-leading-whitespace (function).
skip-trailing-whitespace (function).
skip-whitespace (function).
whitespacep (macro).
html-template/template.lisputil.lisp (file).
html-template (system).
%create-template-printer-aux (function).
create-call-printer (function).
create-if-printer (function).
create-include-printer (function).
create-loop-printer (function).
create-repeat-printer (function).
create-simple-printer (function).
create-template-printer-aux (function).
create-var-printer (function).
with-use-value-restart (macro).
html-template/api.lisptemplate.lisp (file).
html-template (system).
clear-template-cache (function).
create-template-printer (generic function).
delete-from-template-cache (function).
fill-and-print-template (generic function).
Packages are listed by definition order.
html-templatetemplate
common-lisp.
*call-template-access-function* (special variable).
*convert-nil-to-empty-string* (special variable).
*default-template-output* (special variable).
*default-template-pathname* (special variable).
*escape-char-p* (special variable).
*force-default* (special variable).
*format-non-strings* (special variable).
*ignore-empty-lines* (special variable).
*no-cache-check* (special variable).
*sequences-are-lists* (special variable).
*string-modifier* (special variable).
*template-end-marker* (special variable).
*template-start-marker* (special variable).
*template-symbol-package* (special variable).
*upcase-attribute-strings* (special variable).
*value-access-function* (special variable).
*warn-on-creation* (special variable).
clear-template-cache (function).
create-template-printer (generic function).
delete-from-template-cache (function).
escape-string (function).
escape-string-all (function).
escape-string-iso-8859-1 (function).
escape-string-minimal (function).
escape-string-minimal-plus-quotes (function).
fill-and-print-template (generic function).
template-error (condition).
template-invocation-error (condition).
template-missing-value-error (condition).
template-not-a-string-error (condition).
template-not-a-string-error-value (generic reader).
template-syntax-error (condition).
template-syntax-error-col (generic reader).
template-syntax-error-line (generic reader).
template-syntax-error-stream (generic reader).
%create-template-printer-aux (function).
%read-char (function).
*call-value-access-function* (special variable).
*current-column* (special variable).
*current-line* (special variable).
*external-format* (special variable).
*find-string-hash* (special variable).
*hyperdoc-base-uri* (special variable).
*included-files* (special variable).
*printer-hash* (special variable).
*syntax-error-location* (special variable).
*template-output* (special variable).
copy-syntax-error-location (function).
create-call-printer (function).
create-if-printer (function).
create-include-printer (function).
create-loop-printer (function).
create-repeat-printer (function).
create-simple-printer (function).
create-template-printer-aux (function).
create-var-printer (function).
hyperdoc-lookup (function).
list-to-string (function).
make-syntax-error-location (function).
no-values (function).
read-delimited-string (function).
read-tag-rest (function).
read-until (function).
read-while (function).
signal-template-invocation-error (macro).
signal-template-missing-value-error (macro).
signal-template-syntax-error (macro).
skip-leading-whitespace (function).
skip-trailing-whitespace (function).
skip-whitespace (function).
syntax-error-location (structure).
syntax-error-location-col (reader).
(setf syntax-error-location-col) (writer).
syntax-error-location-line (reader).
(setf syntax-error-location-line) (writer).
syntax-error-location-p (function).
syntax-error-location-stream (reader).
(setf syntax-error-location-stream) (writer).
whitespacep (macro).
with-syntax-error-location (macro).
with-use-value-restart (macro).
Definitions are sorted by export status, category, package, and then by lexicographic order.
Accessor function for extracting the called template from a TMPL_CALL form.
Controls whether NIL values should resolve to empty strings or raise an error.
The output stream used by FILL-AND-PRINT-TEMPLATE when no STREAM keyword was provided.
Each pathname is merged with this value before it is used by CREATE-TEMPLATE-PRINTER.
Used by ESCAPE-STRING to test whether a character should be escaped.
The default value for the FORCE keyword argument to CREATE-TEMPLATE-PRINTER.
Controls whether TMPL_VAR will accept values which aren’t strings and convert them using (FORMAT NIL "~A" ...).
Controls whether template tags on their own lines produce empty lines or not.
Controls whether the FILE-WRITE-DATE check will be circumvented when using FILL-AND-PRINT-TEMPLATE.
Controls whether TMPL_LOOP printers expect lists or vectors.
The function which is applied to strings which replace TMPL_VAR tags. Use #’CL:IDENTITY if you don’t want to change the strings.
The string template tags must end with
The string template tags must start with
The package symbols are interned into.
Controls whether attribute strings associated with template tags are upcased before they are interned.
The function which associates (attribute) symbols with their values.
Controls whether a warning should be signaled if a new template printer is created from a pathname argument.
Complete clears all template printers from the cache.
Deletes the template printer denoted by PATHNAME from the cache. Returns true if such a printer existed, false otherwise.
Escape all characters in STRING which pass TEST. This function is not guaranteed to return a fresh string. Note that you can pass NIL for STRING which’ll just be returned.
Escapes all characters in STRING which aren’t in the 7-bit ASCII character set.
Escapes all characters in STRING which aren’t defined in ISO-8859-1.
Escape only #<, #>, and #& in STRING.
Like ESCAPE-STRING-MINIMAL but also escapes quotes.
Creates a template printer from TEMPLATE which is
an open input stream, a string, or a pathname. If FORCE is true a
printer will be newly created no matter what the state of the cache
is. If FORCE is :DO-NOT-CACHE the newly created printer won’t be
cached. Other keyword arguments will be given to WITH-OPEN-FILE.
Keyword arguments will only be accepted if TEMPLATE is a PATHNAME.
Fills the template denoted by TEMPLATE/PRINTER with
VALUES and print it to STREAM. If TEMPLATE/PRINTER is a function uses
it as if it were a template printer, otherwise creates a printer (or
pull one out of the cache) with CREATE-TEMPLATE-PRINTER. Optional
keyword arguments are given to CREATE-TEMPLATE printer and can only be
used if TEMPLATE/PRINTER is a pathname.
pathname) values &rest rest &key stream) ¶stream) values &rest rest &key stream) ¶string) values &rest rest &key stream) ¶function) values &rest rest &key stream) ¶template-not-a-string-error)) ¶template-syntax-error)) ¶col.
template-syntax-error)) ¶line.
template-syntax-error)) ¶All errors signaled by HTML-TEMPLATE are of this type.
simple-error.
Signaled when HTML-TEMPLATE functions are invoked with wrong arguments.
Signaled when a TMPL_VAR printer is provided
with a NIL value and *CONVERT-NIL-TO-EMPTY-STRING* is false.
Signaled when a TMPL_VAR printer is provided with a non-string value.
:value
This slot is read-only.
Signaled when a syntax error occurs while parsing a template.
| Initarg | Value |
|---|---|
:stream | (syntax-error-location-stream *syntax-error-location*) |
:col | (syntax-error-location-col *syntax-error-location*) |
:line | (syntax-error-location-line *syntax-error-location*) |
:line
This slot is read-only.
:col
This slot is read-only.
common-lisp.
:stream
This slot is read-only.
Accessor function for extracting the values from a TMPL_CALL form.
Internal column counter of the parser.
Internal line counter of the parser.
The external format used when opening files.
Hash tables used internally by READ-UNTIL to cache offset arrays.
Internally used by CREATE-TEMPLATE-PRINTER-AUX to avoid infinite TMPL_INCLUDE loops.
The cache for template printers.
Each entry is of the form (PRINTER . WRITE-DATE).
Used internally to remember the last position which made sense to the parser.
The output stream that’s used internally.
Checks whether CHAR is whitespace.
This is wrapped around forms in order to remember a meaningful position within the stream in case an error has to be signaled.
Provide a USE-VALUE restart for ERROR-FORM in case the value associated with SYMBOL isn’t to our liking.
Wrapper for CREATE-TEMPLATE-PRINTER-AUX to initialize *CURRENT-COLUMN* and *CURRENT-LINE*.
Like READ-CHAR but updates the line and column counters.
Used internally to create template printers for TMPL_CALL tags. SYMBOL is the symbol associated with the tag. BODY-FN is the template printer for the body of the loop. NEXT-FN is the next function to be called in the chain of closures. STRING-LIST is a list of strings in reverse order to be printed first.
Used internally to create template printers for TMPL_IF and TMPL_UNLESS tags. SYMBOL is the symbol associated with the tag. IF-FN is the printer for the IF branch, ELSE-FN is the printer for the ELSE branch. NEXT-FN is the next function to be called in the chain of closures. STRING-LIST is a list of strings in reverse order to be printed first. If UNLESSP is true, IF-FN and ELSE-FN are switched.
Used internally to create template printers for TMPL_INCLUDE. PATHNAME is the pathname associated with the tag. NEXT-FN is the next function to be called in the chain of closures. STRING-LIST is a list of strings in reverse order to be printed first.
Used internally to create template printers for TMPL_LOOP
tags. SYMBOL is the symbol associated with the tag. BODY-FN is the
template printer for the body of the loop. NEXT-FN is the next
function to be called in the chain of closures. STRING-LIST is a list
of strings in reverse order to be printed first.
Used internally to create template printers for TMPL_REPEAT
tags. SYMBOL is the symbol associated with the tag. BODY-FN is the
template printer for the body of the loop. NEXT-FN is the next
function to be called in the chain of closures. STRING-LIST is a list
of strings in reverse order to be printed first.
Used internally to create template printers for strings which don’t include template tags. NEXT-FN is the next function to be called in the chain of closures. STRING-LIST is a list of strings in reverse order to be printed first.
Reads from *STANDARD-INPUT* and returns a template printer from what it reads. When this function is entered the stream pointer must not be inside a template tag. STRING-STACK is a list of strings (in reverse order) read so far which haven’t been used to build a template printer. END-TOKEN is either NIL or one of :LOOP, :REPEAT, :IF, :IF-ELSE, or :UNLESS-ELSE denoting that we expect certain tags to close open TMPL_LOOP, TMPL_REPEAT, TMPL_IF, or TMPL_UNLESS tags. This function returns a second value which is true if, after reading TMPL_IF or TMPL_UNLESS, a corresponding TMPL_ELSE was seen.
Used internally to create template printers for TMPL_VAR. SYMBOL is the symbol associated with the tag. NEXT-FN is the next function to be called in the chain of closures. STRING-LIST is a list of strings in reverse order to be printed first.
Concatenates a list of strings to one string in reverse order. The list is destructively modified.
A function which does not return any values. This is always the last function in a chain of template printer closures.
Reads and returns a string from *STANDARD-INPUT*. The string is either delimited by ’ or " in which case the delimiters aren’t returned or it is assumed to extend to the next whitespace character. See READ-WHILE’s docstring for EOF-ACTION.
Reads the rest of a template tag from *STANDARD-INPUT* after the name of the tag has been read. Reads and returns the tag’s attribute if READ-ATTRIBUTE is true. Optionally also interns the attribute string if INTERN is true. See READ-WHILE’s docstring for EOF-ACTION.
Reads characters from *STANDARD-INPUT* up to and including STRING. Returns the string which was read (excluding STRING) unless SKIP is true. See READ-WHILE’s docstring for EOF-ACTION.
Reads characters from *STANDARD-INPUT* while PREDICATE returns a true value for each character. Returns the string which was read unless SKIP is true. On reading EOF an error is signaled if EOF-ACTION is T, NIL is silently returned if EOF-ACTION is NIL, or the function EOF-ACTION is called with one argument - the string read so far.
Removes whitespace from the end of STRING up to and including a #Newline. If there is no #Newline before the first non-whitespace character is seen nothing is removed. STRING must have a fill pointer.
Reads and skips whitespace from *STANDARD-INPUT* until a #Newline characters is seen if *IGNORE-EMPTY-LINES* is true. If there is no #Newline before the first non-whitespace character the string read so far is returned (wrapped in a list).
Read characters from *STANDARD-INPUT* as long as they are whitespace. Signals an error if the first character read isn’t whitespace and ASSERT is true. Return the string which was read unless SKIP is true. See READ-WHILE’s docstring for EOF-ACTION.
col.
line.
Structure to store parser locations consisting of a stream, a line number, and a column number.
| Jump to: | %
(
C D E F G H L M N R S T W |
|---|
| Jump to: | %
(
C D E F G H L M N R S T W |
|---|
| Jump to: | *
C L S V |
|---|
| Jump to: | *
C L S V |
|---|
| Jump to: | A C E F H P S T U |
|---|
| Jump to: | A C E F H P S T U |
|---|