The parenscript Reference Manual

4.1.1 parenscript/parenscript.asd

Source

parenscript.asd.

Parent Component

parenscript (system).

ASDF Systems

parenscript.

---

4.1.2 parenscript/src/package.lisp

Source

parenscript.asd.

Parent Component

src (module).

Packages

parenscript.

---

4.1.3 parenscript/src/js-dom-symbol-exports.lisp

Dependency

package.lisp (file).

Source

parenscript.asd.

Parent Component

src (module).

Packages

• ps-dom1-symbols.
• ps-dom2-symbols.
• ps-js-symbols.
• ps-dhtml-symbols.
• ps-window-wd-symbols.
• ps-dom-nonstandard-symbols.

Internals

re-export-symbols (function).

---

4.1.4 parenscript/src/js-ir-package.lisp

Dependency

js-dom-symbol-exports.lisp (file).

Source

parenscript.asd.

Parent Component

src (module).

Packages

ps-js.

---

4.1.5 parenscript/src/utils.lisp

Dependency

js-ir-package.lisp (file).

Source

parenscript.asd.

Parent Component

src (module).

Internals

• encode-js-identifier (function).
• flatten (function).
• flatten-blocks (function).
• js-target-at-least (function).
• ordered-set-difference (function).
• parse-semver (function).
• simple-style-warning (condition).
• tree-find (function).

---

4.1.6 parenscript/src/namespace.lisp

Dependency

utils.lisp (file).

Source

parenscript.asd.

Parent Component

src (module).

Public Interface

• obfuscate-package (function).
• ps-package-prefix (macro).
• symbol-to-js-string (function).
• unobfuscate-package (function).

Internals

• *obfuscated-packages* (special variable).
• *package-prefix-table* (special variable).
• maybe-obfuscate-symbol (function).

---

4.1.7 parenscript/src/compiler.lisp

Dependency

namespace.lisp (file).

Source

parenscript.asd.

Parent Component

src (module).

Public Interface

• *defined-operators* (special variable).
• *ps-gensym-counter* (special variable).
• *version* (special variable).
• define-ps-symbol-macro (macro).
• defmacro+ps (macro).
• defpsmacro (macro).
• import-macros-from-lisp (function).
• maybe-once-only (macro).
• ps-gensym (function).
• ps-once-only (macro).
• with-ps-gensyms (macro).

Internals

• %compiling-reserved-forms-p% (special variable).
• %define-special-operator (macro).
• *compilation-level* (special variable).
• *current-block-tag* (special variable).
• *dynamic-return-tags* (special variable).
• *enclosing-function-arguments* (special variable).
• *enclosing-lexicals* (special variable).
• *function-block-names* (special variable).
• *function-lambda-list* (special variable).
• *lambda-wrappable-statements* (special variable).
• *local-function-names* (special variable).
• *loop-return-set-var* (special variable).
• *loop-return-var* (special variable).
• *loop-scope-lexicals* (special variable).
• *loop-scope-lexicals-captured* (special variable).
• *macro-env* (special variable).
• *macro-toplevel* (special variable).
• *macro-toplevel-lambda-list* (special variable).
• *reserved-symbol-names* (special variable).
• *setf-expanders* (special variable).
• *special-expression-operators* (special variable).
• *special-statement-operators* (special variable).
• *special-variables* (special variable).
• *symbol-macro-env* (special variable).
• *symbol-macro-toplevel* (special variable).
• *used-up-names* (special variable).
• *vars-needing-to-be-declared* (special variable).
• adjust-compilation-level (function).
• clear-multiple-values? (special variable).
• compile-expression (function).
• compile-expression-error (condition).
• compile-expression? (special variable).
• compile-special-form (function).
• compile-statement (function).
• define-expression-operator (macro).
• define-statement-operator (macro).
• defined-operator-override-check (function).
• error-form (reader method).
• in-case? (special variable).
• in-function-scope? (special variable).
• in-loop-scope? (special variable).
• lookup-macro-def (function).
• make-macro-dictionary (function).
• make-ps-macro-function (function).
• ps-compile (function).
• ps-macroexpand (function).
• ps-macroexpand-1 (function).
• reserved-symbol-p (function).
• special-form? (function).
• special-variable? (function).
• symbol-macro? (function).

---

4.1.8 parenscript/src/printer.lisp

Dependency

compiler.lisp (file).

Source

parenscript.asd.

Parent Component

src (module).

Public Interface

• *indent-num-spaces* (special variable).
• *js-string-delimiter* (special variable).
• *ps-print-pretty* (special variable).

Internals

• *column* (special variable).
• *indent-level* (special variable).
• *js-lisp-escaped-chars* (special variable).
• *psw-stream* (special variable).
• associative? (function).
• defprinter (macro).
• newline-and-indent (function).
• parenscript-print (function).
• parenthesize-print (function).
• precedence (function).
• print-comma-delimited-list (function).
• print-comment (function).
• print-fun-def (function).
• print-op (function).
• print-op-argument (function).
• ps-print (generic function).
• ps-print% (generic function).
• psw (function).

---

4.1.9 parenscript/src/compilation-interface.lisp

Dependency

printer.lisp (file).

Source

parenscript.asd.

Parent Component

src (module).

Public Interface

• *js-inline-string-delimiter* (special variable).
• *js-target-version* (special variable).
• *parenscript-stream* (special variable).
• *ps-read-function* (special variable).
• ps (macro).
• ps* (function).
• ps-compile-file (function).
• ps-compile-stream (function).
• ps-doc (macro).
• ps-doc* (function).
• ps-inline (macro).
• ps-inline* (function).
• ps-to-stream (macro).

Internals

with-blank-compilation-environment (macro).

---

4.1.10 parenscript/src/non-cl.lisp

Dependency

compilation-interface.lisp (file).

Source

parenscript.asd.

Parent Component

src (module).

Public Interface

• chain (function).
• false (special variable).
• lisp (function).
• stringify (function).
• var (macro).

Internals

define-trivial-special-ops (macro).

---

4.1.11 parenscript/src/special-operators.lisp

Dependency

non-cl.lisp (file).

Source

parenscript.asd.

Parent Component

src (module).

Internals

• assignment-op (function).
• compile-loop-body (function).
• compile-progn (function).
• fix-nary-comparison (function).
• inc-dec (macro).
• make-for-vars/inits (function).
• maybe-rename-lexical-var (function).
• references? (function).
• return-exp (function).
• return-result-of (function).
• returning-values? (special variable).
• try-expressionizing-if? (function).
• with-declaration-effects (macro).
• with-lambda-scope (function).
• with-local-macro-environment (macro).
• wrap-for-dynamic-return (function).

---

4.1.12 parenscript/src/parse-lambda-list.lisp

Dependency

special-operators.lisp (file).

Source

parenscript.asd.

Parent Component

src (module).

Internals

• *lambda-list-keywords* (special variable).
• collect (macro).
• collect-list-expander (function).
• parse-lambda-list (function).
• parse-lambda-list-like-thing (function).
• style-warn (function).

---

4.1.13 parenscript/src/function-definition.lisp

Dependency

parse-lambda-list.lisp (file).

Source

parenscript.asd.

Parent Component

src (module).

Internals

• collapse-function-return-blocks (function).
• collect-function-names (function).
• compile-function-body (function).
• compile-local-function-defs (function).
• compile-named-function-body (function).
• compile-named-local-function (function).
• local-functions (macro).
• maybe-rename-local-function (function).
• parse-body (function).
• parse-extended-function (function).
• parse-key-spec (function).
• parse-optional-spec (function).

---

4.1.14 parenscript/src/macros.lisp

Dependency

function-definition.lisp (file).

Source

parenscript.asd.

Parent Component

src (module).

Internals

• *defun-setf-name-prefix* (special variable).
• check-setq-args (function).
• complex-js-expr? (function).
• def-js-maths (macro).
• destructuring-wrap (function).
• do-make-for-steps (function).
• do-make-iter-psteps (function).
• do-make-iteration-bindings (function).
• hoist-expr? (function).
• pop-declarations-for-var (function).

---

4.1.15 parenscript/src/deprecated-interface.lisp

Dependency

macros.lisp (file).

Source

parenscript.asd.

Parent Component

src (module).

Public Interface

• compile-script (function).
• concat-string (function).
• define-script-symbol-macro (macro).
• defjsmacro (macro).
• defmacro/ps (macro).
• gen-js-name (function).
• js (macro).
• js* (function).
• js-compile (function).
• js-inline (macro).
• js-inline* (function).
• symbol-to-js (function).
• while (macro).
• with-unique-js-names (macro).

Internals

• defpsmacro-deprecated (macro).
• defun-js (macro).
• js-compile-list (function).
• js-equal (function).
• warn-deprecated (function).

---

4.1.16 parenscript/src/lib/ps-html.lisp

Source

parenscript.asd.

Parent Component

lib (module).

Public Interface

• *ps-html-empty-tag-aware-p* (special variable).
• *ps-html-mode* (special variable).
• ps-html (macro).
• who-ps-html (macro).

Internals

• *html-empty-tags* (special variable).
• concat-constant-strings (function).
• empty-tag-p (function).
• process-html-forms-cl-who (function).
• process-html-forms-lhtml (function).

---

4.1.17 parenscript/src/lib/ps-loop.lisp

Source

parenscript.asd.

Parent Component

lib (module).

Public Interface

for-in (function).

Internals

• *loop-keywords* (special variable).
• a-with-clause (function).
• accum-kind (reader method).
• (setf accum-kind) (writer method).
• accum-var (reader method).
• (setf accum-var) (writer method).
• accumulate (function).
• as-keyword (function).
• body-clause (function).
• build-body (function).
• build-loop (function).
• clause (function).
• clauses (reader method).
• (setf clauses) (writer method).
• dot->rest (function).
• eat (function).
• err (function).
• extract-bindings (function).
• finally (reader method).
• (setf finally) (writer method).
• fold-iterations-where-possible (function).
• for-= (function).
• for-clause (function).
• for-from (function).
• for-keys-of (function).
• for-on (function).
• loop-case (macro).
• loop-state (class).
• master-loop (function).
• maybe-hoist (function).
• name (reader method).
• (setf name) (writer method).
• organize-iterations (function).
• parse-ps-loop (function).
• peek (function).
• prologue (reader method).
• (setf prologue) (writer method).
• prologue-wrap (function).
• property-bindings (function).
• property-bindings-p (function).
• push-body-clause (function).
• push-iter-clause (function).
• push-tokens (function).
• repeat-clause (function).
• tokens (reader method).
• (setf tokens) (writer method).
• until-clause (function).
• while-clause (function).

---

4.1.18 parenscript/src/lib/ps-dom.lisp

Source

parenscript.asd.

Parent Component

lib (module).

Internals

assert-is-one-of (function).

---

4.1.19 parenscript/runtime/ps-runtime-lib.lisp

Source

parenscript.asd.

Parent Component

runtime (module).

Public Interface

*ps-lisp-library* (special variable).

---

6.1.1 Special variables

Special Variable: *defined-operators* ¶

Special operators and macros defined by Parenscript. Replace at your own risk!

Package

parenscript.

Source

compiler.lisp.

Special Variable: *indent-num-spaces* ¶

Package

parenscript.

Source

printer.lisp.

Special Variable: *js-inline-string-delimiter* ¶

Controls the string delimiter char used when compiling Parenscript in ps-inline.

Package

parenscript.

Source

compilation-interface.lisp.

Special Variable: *js-string-delimiter* ¶

Specifies which character should be used for delimiting strings.

This variable is used when you want to embed the resulting JavaScript in an html attribute delimited by #\" as opposed to #\’, or vice-versa.

Package

parenscript.

Source

printer.lisp.

Special Variable: *js-target-version* ¶

Package

parenscript.

Source

compilation-interface.lisp.

Special Variable: *parenscript-stream* ¶

Package

parenscript.

Source

compilation-interface.lisp.

Special Variable: *ps-gensym-counter* ¶

Package

parenscript.

Source

compiler.lisp.

Special Variable: *ps-html-empty-tag-aware-p* ¶

Package

parenscript.

Source

ps-html.lisp.

Special Variable: *ps-html-mode* ¶

One of :sgml or :xml

Package

parenscript.

Source

ps-html.lisp.

Special Variable: *ps-lisp-library* ¶

Package

parenscript.

Source

ps-runtime-lib.lisp.

Special Variable: *ps-print-pretty* ¶

Package

parenscript.

Source

printer.lisp.

Special Variable: *ps-read-function* ¶

Package

parenscript.

Source

compilation-interface.lisp.

Special Variable: *version* ¶

Parenscript compiler version.

Package

parenscript.

Source

compiler.lisp.

Special Variable: false ¶

Package

parenscript.

Source

non-cl.lisp.

---

6.1.2 Macros

Macro: define-ps-symbol-macro (symbol expansion) ¶

Package

parenscript.

Source

compiler.lisp.

Macro: define-script-symbol-macro (name &body body) ¶

Package

parenscript.

Source

deprecated-interface.lisp.

Macro: defjsmacro (&rest args) ¶

Package

parenscript.

Source

deprecated-interface.lisp.

Macro: defmacro+ps (name args &body body) ¶

Define a Lisp macro and a Parenscript macro with the same macro function (ie - the same result from macroexpand-1), for cases when the two have different full macroexpansions (for example if the CL macro contains implementation-specific code when macroexpanded fully in the CL environment).

Package

parenscript.

Source

compiler.lisp.

Macro: defmacro/ps (name args &body body) ¶

Package

parenscript.

Source

deprecated-interface.lisp.

Macro: defpsmacro (name args &body body) ¶

Package

parenscript.

Source

compiler.lisp.

Macro: js (&rest args) ¶

Package

parenscript.

Source

deprecated-interface.lisp.

Macro: js-inline (&rest body) ¶

Package

parenscript.

Source

deprecated-interface.lisp.

Macro: maybe-once-only ((&rest vars) &body body) ¶

Helper macro for writing Parenscript macros. Like PS-ONCE-ONLY,
except that if the given VARS are variables or constants, no intermediate variables are created.

Package

parenscript.

Source

compiler.lisp.

Macro: ps (&body body) ¶

Given Parenscript forms (an implicit progn), compiles those forms to a JavaScript string at macro-expansion time. Expands into a form which evaluates to a string.

Package

parenscript.

Source

compilation-interface.lisp.

Macro: ps-doc (&body body) ¶

Expands Parenscript forms in a clean environment.

Package

parenscript.

Source

compilation-interface.lisp.

Macro: ps-html (&rest html-forms) ¶

Package

parenscript.

Source

ps-html.lisp.

Macro: ps-inline (form &optional string-delimiter) ¶

Package

parenscript.

Source

compilation-interface.lisp.

Macro: ps-once-only ((&rest vars) &body body) ¶

Helper macro for writing Parenscript macros. Useful for preventing unwanted multiple evaluation.

Package

parenscript.

Source

compiler.lisp.

Macro: ps-package-prefix (package) ¶

Package

parenscript.

Source

namespace.lisp.

Macro: ps-to-stream (stream &body body) ¶

Given Parenscript forms (an implicit progn), compiles those forms to a JavaScript string at macro-expansion time. Expands into a form which writes the resulting code to stream.

Package

parenscript.

Source

compilation-interface.lisp.

Macro: var (name &optional value docstr) ¶

Package

parenscript.

Source

non-cl.lisp.

Macro: while (test &body body) ¶

Package

parenscript.

Source

deprecated-interface.lisp.

Macro: who-ps-html (&rest html-forms) ¶

Package

parenscript.

Source

ps-html.lisp.

Macro: with-ps-gensyms (symbols &body body) ¶

Helper macro for writing Parenscript macros. Each element of SYMBOLS is either a symbol or a list of (symbol gensym-prefix-string).

Package

parenscript.

Source

compiler.lisp.

Macro: with-unique-js-names (&rest args) ¶

Package

parenscript.

Source

deprecated-interface.lisp.

---

6.1.3 Ordinary functions

Function: chain (method-calls) ¶

Package

parenscript.

Source

non-cl.lisp.

Function: compile-script (ps-form &key output-stream) ¶

Compiles the Parenscript form PS-FORM into Javascript.
If OUTPUT-STREAM is NIL, then the result is a string; otherwise code is output to the OUTPUT-STREAM stream.

Package

parenscript.

Source

deprecated-interface.lisp.

Function: concat-string (&rest things) ¶

Package

parenscript.

Source

deprecated-interface.lisp.

Function: for-in (place state) ¶

Package

parenscript.

Source

ps-loop.lisp.

Function: gen-js-name (&optional prefix) ¶

Package

parenscript.

Source

deprecated-interface.lisp.

Function: import-macros-from-lisp (&rest names) ¶

Import the named Lisp macros into the Parenscript macro environment. When the imported macro is macroexpanded by Parenscript, it is first fully macroexpanded in the Lisp macro environment, and then that expansion is further expanded by Parenscript.

Package

parenscript.

Source

compiler.lisp.

Function: js* (&rest args) ¶

Package

parenscript.

Source

deprecated-interface.lisp.

Function: js-compile (form) ¶

Package

parenscript.

Source

deprecated-interface.lisp.

Function: js-inline* (&rest body) ¶

Package

parenscript.

Source

deprecated-interface.lisp.

Function: lisp (x) ¶

Package

parenscript.

Source

non-cl.lisp.

Function: obfuscate-package (package-designator &optional symbol-map) ¶

Package

parenscript.

Source

namespace.lisp.

Function: ps* (&rest body) ¶

Compiles body to a JavaScript string. If *parenscript-stream* is bound, writes the output to *parenscript-stream*, otherwise returns a string.

Package

parenscript.

Source

compilation-interface.lisp.

Function: ps-compile-file (source-file &key element-type external-format) ¶

Opens file as input stream and calls ps-compile-stream on it.

Package

parenscript.

Source

compilation-interface.lisp.

Function: ps-compile-stream (stream) ¶

Reads (using the value of *ps-read-function*, #’read by default, as the read function) Parenscript forms from stream and compiles them as if by ps*. If *parenscript-stream* is bound, writes the output to *parenscript-stream*, otherwise and returns a string.

Package

parenscript.

Source

compilation-interface.lisp.

Function: ps-doc* (&rest body) ¶

Package

parenscript.

Source

compilation-interface.lisp.

Function: ps-gensym (&optional x) ¶

Package

parenscript.

Source

compiler.lisp.

Function: ps-inline* (form &optional *js-string-delimiter*) ¶

Package

parenscript.

Source

compilation-interface.lisp.

Function: stringify (&rest things) ¶

Like concatenate but prints all of its arguments.

Package

parenscript.

Source

non-cl.lisp.

Function: symbol-to-js (symbol) ¶

Package

parenscript.

Source

deprecated-interface.lisp.

Function: symbol-to-js-string (symbol &optional mangle-symbol-name?) ¶

Package

parenscript.

Source

namespace.lisp.

Function: unobfuscate-package (package-designator) ¶

Package

parenscript.

Source

namespace.lisp.

---

6.2.1 Special variables

Special Variable: %compiling-reserved-forms-p% ¶

Used to issue warnings when replacing PS special operators or macros.

Package

parenscript.

Source

compiler.lisp.

Special Variable: *column* ¶

Package

parenscript.

Source

printer.lisp.

Special Variable: *compilation-level* ¶

This value takes on the following values:
:toplevel indicates that we are traversing toplevel forms. :inside-toplevel-form indicates that we are inside a call to ps-compile-* nil indicates we are no longer toplevel-related.

Package

parenscript.

Source

compiler.lisp.

Special Variable: *current-block-tag* ¶

Name of the lexically enclosing block, if any.

Package

parenscript.

Source

compiler.lisp.

Special Variable: *defun-setf-name-prefix* ¶

Package

parenscript.

Source

macros.lisp.

Special Variable: *dynamic-return-tags* ¶

Tags that need to be thrown to to reach.

Package

parenscript.

Source

compiler.lisp.

Special Variable: *enclosing-function-arguments* ¶

Lexical variables bound in all lexically enclosing function argument lists.

Package

parenscript.

Source

compiler.lisp.

Special Variable: *enclosing-lexicals* ¶

All enclosing lexical variables (includes function names).

Package

parenscript.

Source

compiler.lisp.

Special Variable: *function-block-names* ¶

All block names that this function is responsible for catching.

Package

parenscript.

Source

compiler.lisp.

Special Variable: *function-lambda-list* ¶

Table of lambda lists for defined functions.

Package

parenscript.

Source

compiler.lisp.

Special Variable: *html-empty-tags* ¶

Package

parenscript.

Source

ps-html.lisp.

Special Variable: *indent-level* ¶

Package

parenscript.

Source

printer.lisp.

Special Variable: *js-lisp-escaped-chars* ¶

Package

parenscript.

Source

printer.lisp.

Special Variable: *lambda-list-keywords* ¶

Package

parenscript.

Source

parse-lambda-list.lisp.

Special Variable: *lambda-wrappable-statements* ¶

Statement special forms that can be wrapped in a lambda to make them into expressions. Control transfer forms like BREAK, RETURN, and CONTINUE need special treatment, and are not included.

Package

parenscript.

Source

compiler.lisp.

Special Variable: *local-function-names* ¶

Functions named by flet and label.

Package

parenscript.

Source

compiler.lisp.

Special Variable: *loop-keywords* ¶

Package

parenscript.

Source

ps-loop.lisp.

Special Variable: *loop-return-set-var* ¶

Variable which is set by RETURN-FROM when it returns a value from inside a loop. The value is the name of a PS variable which dynamically indicates if the return statement indeed has been invoked.

Package

parenscript.

Source

compiler.lisp.

Special Variable: *loop-return-var* ¶

Variable which is used to return values from inside loop bodies.

Package

parenscript.

Source

compiler.lisp.

Special Variable: *loop-scope-lexicals* ¶

Lexical variables introduced by a loop.

Package

parenscript.

Source

compiler.lisp.

Special Variable: *loop-scope-lexicals-captured* ¶

Lexical variables introduced by a loop that are also captured by lambdas inside a loop.

Package

parenscript.

Source

compiler.lisp.

Special Variable: *macro-env* ¶

Current macro environment.

Package

parenscript.

Source

compiler.lisp.

Special Variable: *macro-toplevel* ¶

Toplevel macro environment dictionary.

Package

parenscript.

Source

compiler.lisp.

Special Variable: *macro-toplevel-lambda-list* ¶

Table of lambda lists for toplevel macros.

Package

parenscript.

Source

compiler.lisp.

Special Variable: *obfuscated-packages* ¶

Package

parenscript.

Source

namespace.lisp.

Special Variable: *package-prefix-table* ¶

Package

parenscript.

Source

namespace.lisp.

Special Variable: *psw-stream* ¶

Package

parenscript.

Source

printer.lisp.

Special Variable: *reserved-symbol-names* ¶

Package

parenscript.

Source

compiler.lisp.

Special Variable: *setf-expanders* ¶

Setf expander dictionary. Key is the symbol of the access function of the place, value is an expansion function that takes the arguments of the access functions as a first value and the form to be stored as the second value.

Package

parenscript.

Source

compiler.lisp.

Special Variable: *special-expression-operators* ¶

Package

parenscript.

Source

compiler.lisp.

Special Variable: *special-statement-operators* ¶

Package

parenscript.

Source

compiler.lisp.

Special Variable: *special-variables* ¶

Special variables declared during any Parenscript run. Re-bind this if you want to clear the list.

Package

parenscript.

Source

compiler.lisp.

Special Variable: *symbol-macro-env* ¶

Package

parenscript.

Source

compiler.lisp.

Special Variable: *symbol-macro-toplevel* ¶

Package

parenscript.

Source

compiler.lisp.

Special Variable: *used-up-names* ¶

Names that have been already used for lexical bindings in the current function scope.

Package

parenscript.

Source

compiler.lisp.

Special Variable: *vars-needing-to-be-declared* ¶

This special variable is expected to be bound to a fresh list by special forms that introduce a new JavaScript lexical block (currently function definitions and lambdas). Enclosed special forms are expected to push variable declarations onto the list when the variables declaration cannot be made by the enclosed form (for example, a x,y,z expression progn). It is then the responsibility of the enclosing special form to introduce the variable declarations in its lexical block.

Package

parenscript.

Source

compiler.lisp.

Special Variable: clear-multiple-values? ¶

Package

parenscript.

Source

compiler.lisp.

Special Variable: compile-expression? ¶

Package

parenscript.

Source

compiler.lisp.

Special Variable: in-case? ¶

Bind to T when compiling CASE branches.

Package

parenscript.

Source

compiler.lisp.

Special Variable: in-function-scope? ¶

Lets the compiler know when lambda wrapping is necessary.

Package

parenscript.

Source

compiler.lisp.

Special Variable: in-loop-scope? ¶

Used for seeing when we’re in loops, so that we can introduce proper scoping for lambdas closing over loop-bound variables (otherwise they all share the same binding).

Package

parenscript.

Source

compiler.lisp.

Special Variable: returning-values? ¶

Package

parenscript.

Source

special-operators.lisp.

---

6.2.2 Macros

Macro: %define-special-operator (type name lambda-list &body body) ¶

Package

parenscript.

Source

compiler.lisp.

Macro: collect (collections &body body) ¶

Package

parenscript.

Source

parse-lambda-list.lisp.

Macro: def-js-maths (&rest mathdefs) ¶

Package

parenscript.

Source

macros.lisp.

Macro: define-expression-operator (name lambda-list &body body) ¶

Package

parenscript.

Source

compiler.lisp.

Macro: define-statement-operator (name lambda-list &body body) ¶

Package

parenscript.

Source

compiler.lisp.

Macro: define-trivial-special-ops (&rest mappings) ¶

Package

parenscript.

Source

non-cl.lisp.

Macro: defprinter (js-primitive args &body body) ¶

Package

parenscript.

Source

printer.lisp.

Macro: defpsmacro-deprecated (old new) ¶

Package

parenscript.

Source

deprecated-interface.lisp.

Macro: defun-js (old-name new-name args &body body) ¶

Package

parenscript.

Source

deprecated-interface.lisp.

Macro: inc-dec (op op1 op2) ¶

Package

parenscript.

Source

special-operators.lisp.

Macro: local-functions (special-op &body bindings) ¶

Package

parenscript.

Source

function-definition.lisp.

Macro: loop-case (key &body forms) ¶

Package

parenscript.

Source

ps-loop.lisp.

Macro: with-blank-compilation-environment (&body body) ¶

Package

parenscript.

Source

compilation-interface.lisp.

Macro: with-declaration-effects ((var block) &body body) ¶

Package

parenscript.

Source

special-operators.lisp.

Macro: with-local-macro-environment ((var env) &body body) ¶

Package

parenscript.

Source

special-operators.lisp.

---

6.2.3 Ordinary functions

Function: a-with-clause (state) ¶

Package

parenscript.

Source

ps-loop.lisp.

Function: accumulate (kind item var state) ¶

Package

parenscript.

Source

ps-loop.lisp.

Function: adjust-compilation-level (form level) ¶

Given the current *compilation-level*, LEVEL, and the fully macroexpanded form, FORM, returns the new value for *compilation-level*.

Package

parenscript.

Source

compiler.lisp.

Function: as-keyword (key) ¶

Package

parenscript.

Source

ps-loop.lisp.

Function: assert-is-one-of (val options) ¶

Package

parenscript.

Source

ps-dom.lisp.

Function: assignment-op (op) ¶

Package

parenscript.

Source

special-operators.lisp.

Function: associative? (op) ¶

Package

parenscript.

Source

printer.lisp.

Function: body-clause (term state) ¶

Package

parenscript.

Source

ps-loop.lisp.

Function: build-body (clauses firstvar) ¶

Package

parenscript.

Source

ps-loop.lisp.

Function: build-loop (clauses) ¶

Package

parenscript.

Source

ps-loop.lisp.

Function: check-setq-args (args) ¶

Package

parenscript.

Source

macros.lisp.

Function: clause (state) ¶

Package

parenscript.

Source

ps-loop.lisp.

Function: collapse-function-return-blocks (body) ¶

Package

parenscript.

Source

function-definition.lisp.

Function: collect-function-names (fn-defs) ¶

Package

parenscript.

Source

function-definition.lisp.

Function: collect-list-expander (n-value n-tail forms) ¶

Package

parenscript.

Source

parse-lambda-list.lisp.

Function: compile-expression (form) ¶

Package

parenscript.

Source

compiler.lisp.

Function: compile-function-body (args body) ¶

Package

parenscript.

Source

function-definition.lisp.

Function: compile-local-function-defs (fn-defs renames) ¶

Package

parenscript.

Source

function-definition.lisp.

Function: compile-loop-body (loop-vars body) ¶

Package

parenscript.

Source

special-operators.lisp.

Function: compile-named-function-body (name lambda-list body) ¶

Package

parenscript.

Source

function-definition.lisp.

Function: compile-named-local-function (name args body) ¶

Package

parenscript.

Source

function-definition.lisp.

Function: compile-progn (body) ¶

Package

parenscript.

Source

special-operators.lisp.

Function: compile-special-form (form) ¶

Package

parenscript.

Source

compiler.lisp.

Function: compile-statement (form) ¶

Package

parenscript.

Source

compiler.lisp.

Function: complex-js-expr? (expr) ¶

Package

parenscript.

Source

macros.lisp.

Function: concat-constant-strings (str-list) ¶

Package

parenscript.

Source

ps-html.lisp.

Function: defined-operator-override-check (name &rest body) ¶

Package

parenscript.

Source

compiler.lisp.

Function: destructuring-wrap (arr n bindings declarations body) ¶

Package

parenscript.

Source

macros.lisp.

Function: do-make-for-steps (decls) ¶

Package

parenscript.

Source

macros.lisp.

Function: do-make-iter-psteps (decls) ¶

Package

parenscript.

Source

macros.lisp.

Function: do-make-iteration-bindings (decls) ¶

Package

parenscript.

Source

macros.lisp.

Function: dot->rest (x) ¶

Package

parenscript.

Source

ps-loop.lisp.

Function: eat (state &optional what tag) ¶

Consumes the next meaningful chunk of loop for processing.

Package

parenscript.

Source

ps-loop.lisp.

Function: empty-tag-p (tag) ¶

Package

parenscript.

Source

ps-html.lisp.

Function: encode-js-identifier (identifier) ¶

Given a string, produces to a valid JavaScript identifier by following transformation heuristics case conversion. For example, paren-script becomes parenScript, *some-global* becomes SOMEGLOBAL.

Package

parenscript.

Source

utils.lisp.

Function: err (expected got) ¶

Package

parenscript.

Source

ps-loop.lisp.

Function: extract-bindings (x) ¶

Package

parenscript.

Source

ps-loop.lisp.

Function: fix-nary-comparison (operator objects) ¶

Package

parenscript.

Source

special-operators.lisp.

Function: flatten (x &optional acc) ¶

Package

parenscript.

Source

utils.lisp.

Function: flatten-blocks (body) ¶

Package

parenscript.

Source

utils.lisp.

Function: fold-iterations-where-possible (clauses) ¶

Package

parenscript.

Source

ps-loop.lisp.

Function: for-= (place state) ¶

Package

parenscript.

Source

ps-loop.lisp.

Function: for-clause (state) ¶

Package

parenscript.

Source

ps-loop.lisp.

Function: for-from (from-key var state) ¶

Package

parenscript.

Source

ps-loop.lisp.

Function: for-keys-of (place state) ¶

Package

parenscript.

Source

ps-loop.lisp.

Function: for-on (place state) ¶

Package

parenscript.

Source

ps-loop.lisp.

Function: hoist-expr? (bindings expr) ¶

Package

parenscript.

Source

macros.lisp.

Function: js-compile-list (form) ¶

Package

parenscript.

Source

deprecated-interface.lisp.

Function: js-equal (ps-form1 ps-form2) ¶

Package

parenscript.

Source

deprecated-interface.lisp.

Function: js-target-at-least (version) ¶

Package

parenscript.

Source

utils.lisp.

Function: lookup-macro-def (name env) ¶

Package

parenscript.

Source

compiler.lisp.

Function: make-for-vars/inits (init-forms) ¶

Package

parenscript.

Source

special-operators.lisp.

Function: make-macro-dictionary () ¶

Package

parenscript.

Source

compiler.lisp.

Function: make-ps-macro-function (args body) ¶

Given the arguments and body to a parenscript macro, returns a function that may be called on the entire parenscript form and outputs some parenscript code. Returns a second value that is the effective lambda list from a Parenscript perspective.

Package

parenscript.

Source

compiler.lisp.

Function: master-loop (master-iter body) ¶

Package

parenscript.

Source

ps-loop.lisp.

Function: maybe-hoist (expr state) ¶

Package

parenscript.

Source

ps-loop.lisp.

Function: maybe-obfuscate-symbol (symbol) ¶

Package

parenscript.

Source

namespace.lisp.

Function: maybe-rename-lexical-var (x symbols-in-bindings) ¶

Package

parenscript.

Source

special-operators.lisp.

Function: maybe-rename-local-function (fun-name) ¶

Package

parenscript.

Source

function-definition.lisp.

Function: newline-and-indent (&optional indent-spaces) ¶

Package

parenscript.

Source

printer.lisp.

Function: ordered-set-difference (list1 list2 &key test) ¶

CL set-difference may not preserve order.

Package

parenscript.

Source

utils.lisp.

Function: organize-iterations (clauses) ¶

Package

parenscript.

Source

ps-loop.lisp.

Function: parenscript-print (form immediate?) ¶

Package

parenscript.

Source

printer.lisp.

Function: parenthesize-print (x) ¶

Package

parenscript.

Source

printer.lisp.

Function: parse-body (body &key allow-docstring) ¶

Parses a function or block body, which may or may not include a docstring. Returns 2 or 3 values: a docstring (if allowed for), a list of (declare ...) forms, and the remaining body.

Package

parenscript.

Source

function-definition.lisp.

Function: parse-extended-function (lambda-list body) ¶

The lambda list is transformed as follows:

* standard and optional variables are the mapped directly into the js-lambda list

* keyword variables are not included in the js-lambda list, but instead are obtained from the magic js ARGUMENTS pseudo-array. Code assigning values to keyword vars is prepended to the body of the function.

Package

parenscript.

Source

function-definition.lisp.

Function: parse-key-spec (key-spec) ¶

parses an &key parameter. Returns 5 values:
var, init-form, keyword-name, supplied-p-var, init-form-supplied-p.

Syntax of key spec:
[&key {var | ({var | (keyword-name var)} [init-form [supplied-p-parameter]])}*

Package

parenscript.

Source

function-definition.lisp.

Function: parse-lambda-list (lambda-list) ¶

Package

parenscript.

Source

parse-lambda-list.lisp.

Function: parse-lambda-list-like-thing (list) ¶

Package

parenscript.

Source

parse-lambda-list.lisp.

Function: parse-optional-spec (spec) ¶

Parses an &optional parameter. Returns 3 values: var, init-form, supplied-p-var. [&optional {var | (var [init-form [supplied-p-parameter]])}*]

Package

parenscript.

Source

function-definition.lisp.

Function: parse-ps-loop (terms) ¶

Package

parenscript.

Source

ps-loop.lisp.

Function: parse-semver (semver-string) ¶

Package

parenscript.

Source

utils.lisp.

Function: peek (state) ¶

Package

parenscript.

Source

ps-loop.lisp.

Function: pop-declarations-for-var (var declarations) ¶

Package

parenscript.

Source

macros.lisp.

Function: precedence (op) ¶

Package

parenscript.

Source

printer.lisp.

Function: print-comma-delimited-list (ps-forms) ¶

Package

parenscript.

Source

printer.lisp.

Function: print-comment (comment-str) ¶

Package

parenscript.

Source

printer.lisp.

Function: print-fun-def (name args body) ¶

Package

parenscript.

Source

printer.lisp.

Function: print-op (op) ¶

Package

parenscript.

Source

printer.lisp.

Function: print-op-argument (op argument) ¶

Package

parenscript.

Source

printer.lisp.

Function: process-html-forms-cl-who (forms) ¶

Package

parenscript.

Source

ps-html.lisp.

Function: process-html-forms-lhtml (forms) ¶

Package

parenscript.

Source

ps-html.lisp.

Function: prologue-wrap (prologue body) ¶

Package

parenscript.

Source

ps-loop.lisp.

Function: property-bindings (bindings expr body) ¶

Package

parenscript.

Source

ps-loop.lisp.

Function: property-bindings-p (x) ¶

Package

parenscript.

Source

ps-loop.lisp.

Function: ps-compile (form) ¶

Package

parenscript.

Source

compiler.lisp.

Function: ps-macroexpand (form) ¶

Package

parenscript.

Source

compiler.lisp.

Function: ps-macroexpand-1 (form) ¶

Package

parenscript.

Source

compiler.lisp.

Function: psw (&rest objs) ¶

Package

parenscript.

Source

printer.lisp.

Function: push-body-clause (clause state) ¶

Package

parenscript.

Source

ps-loop.lisp.

Function: push-iter-clause (clause state) ¶

Package

parenscript.

Source

ps-loop.lisp.

Function: push-tokens (state toks) ¶

Package

parenscript.

Source

ps-loop.lisp.

Function: re-export-symbols (from-package to-package) ¶

Package

parenscript.

Source

js-dom-symbol-exports.lisp.

Function: references? (exp place) ¶

Package

parenscript.

Source

special-operators.lisp.

Function: repeat-clause (state) ¶

Package

parenscript.

Source

ps-loop.lisp.

Function: reserved-symbol-p (symbol) ¶

Package

parenscript.

Source

compiler.lisp.

Function: return-exp (tag &optional value) ¶

Package

parenscript.

Source

special-operators.lisp.

Function: return-result-of (tag form) ¶

Package

parenscript.

Source

special-operators.lisp.

Function: special-form? (form) ¶

Package

parenscript.

Source

compiler.lisp.

Function: special-variable? (sym) ¶

Package

parenscript.

Source

compiler.lisp.

Function: style-warn (&rest args) ¶

Package

parenscript.

Source

parse-lambda-list.lisp.

Function: symbol-macro? (form) ¶

If FORM is a symbol macro, return its macro function. Otherwise, return NIL.

Package

parenscript.

Source

compiler.lisp.

Function: tree-find (a tree) ¶

Package

parenscript.

Source

utils.lisp.

Function: try-expressionizing-if? (exp &optional score) ¶

Heuristic that tries not to expressionize deeply nested if expressions.

Package

parenscript.

Source

special-operators.lisp.

Function: until-clause (state) ¶

Package

parenscript.

Source

ps-loop.lisp.

Function: warn-deprecated (old-name &optional new-name) ¶

Package

parenscript.

Source

deprecated-interface.lisp.

Function: while-clause (state) ¶

Package

parenscript.

Source

ps-loop.lisp.

Function: with-lambda-scope (form) ¶

Package

parenscript.

Source

special-operators.lisp.

Function: wrap-for-dynamic-return (handled-tags body) ¶

Package

parenscript.

Source

special-operators.lisp.

---