The form-fiddle Reference Manual

Table of Contents

The form-fiddle Reference Manual

This is the form-fiddle Reference Manual, version 1.1.0, generated automatically by Declt version 3.0 "Montgomery Scott" on Wed Oct 13 10:54:54 2021 GMT+0.

1 Introduction

About Form-Fiddle

Often times I need to destructure a form definition in a macro. This is a set of simple utilities to help with that.

How To

There's individual functions to extract each part of a lambda-definition-form: function, name, qualifiers, lambda-list, body, declarations, docstring and the forms. You can get all in one with split-lambda-form, or directly as a binding macro with with-destructured-lambda-form.

(split-lambda-form '(defun lambda-body (lambda-form)
                      (cddr lambda-form)))

(with-destructured-lambda-form (:forms forms)
    '(defmacro foo (bar)
       (declare (ignore bar))
       "Testing macro!"
       (print "test!"))
  forms)

See Also

• Lambda-Fiddle To destructure lambda-lists.

2 Systems

The main system appears first, followed by any subsystem dependency.

2.1 form-fiddle

Maintainer

Nicolas Hafner <shinmera@tymoon.eu>

Author

Nicolas Hafner <shinmera@tymoon.eu>

Home Page

https://Shinmera.github.io/form-fiddle/

Source Control

(:git "https://github.com/shinmera/form-fiddle.git")

Bug Tracker

https://github.com/Shinmera/form-fiddle/issues

License

zlib

Description

A collection of utilities to destructure lambda forms.

Version

1.1.0

Dependency

documentation-utils

Source

form-fiddle.asd (file)

Components

• package.lisp (file)
• form-fiddle.lisp (file)
• documentation.lisp (file)

3 Files

Files are sorted by type and then listed depth-first from the systems components trees.

3.1 Lisp

3.1.1 form-fiddle.asd

Location

form-fiddle.asd

Systems

form-fiddle (system)

3.1.2 form-fiddle/package.lisp

Parent

form-fiddle (system)

Location

package.lisp

Packages

form-fiddle

3.1.3 form-fiddle/form-fiddle.lisp

Dependency

package.lisp (file)

Parent

form-fiddle (system)

Location

form-fiddle.lisp

Exported Definitions

• lambda-body (function)
• lambda-declarations (function)
• lambda-docstring (function)
• lambda-forms (function)
• lambda-function (function)
• lambda-lambda-list (function)
• lambda-name (function)
• lambda-qualifiers (function)
• split-body-options (function)
• split-lambda-form (function)
• with-body-options (macro)
• with-destructured-lambda-form (macro)

Internal Definitions

• declaration-p (function)
• docstring-p (function)
• removef (function)

3.1.4 form-fiddle/documentation.lisp

Dependency

form-fiddle.lisp (file)

Parent

form-fiddle (system)

Location

documentation.lisp

4 Packages

Packages are listed by definition order.

4.1 form-fiddle

Source

package.lisp (file)

Nickname

org.shirakumo.form-fiddle

Use List

common-lisp

Exported Definitions

• lambda-body (function)
• lambda-declarations (function)
• lambda-docstring (function)
• lambda-forms (function)
• lambda-function (function)
• lambda-lambda-list (function)
• lambda-name (function)
• lambda-qualifiers (function)
• split-body-options (function)
• split-lambda-form (function)
• with-body-options (macro)
• with-destructured-lambda-form (macro)

Internal Definitions

• declaration-p (function)
• docstring-p (function)
• removef (function)

5 Definitions

Definitions are sorted by export status, category, package, and then by lexicographic order.

5.1 Exported definitions

5.1.1 Macros

Macro: with-body-options (BODY OTHER-OPTIONS &rest OPTIONS) FORM &body BODY-FORMS

Destructures the body according to split-body-kargs.

OTHER-OPTIONS will be bound to contain all the options that occur in the body but were not explicitly requested in OPTIONS. BODY will be bound to the remaining body forms. Each option in OPTIONS can be either a symbol or a list of symbol and default. The symbol is automatically converted to a keyword to match against the body options.

Package

form-fiddle

Source

form-fiddle.lisp (file)

Macro: with-destructured-lambda-form (&key FUNCTION NAME QUALIFIERS LAMBDA-LIST DOCSTRING DECLARATIONS FORMS) EXPRESSION &body BODY

Destructures the given EXPRESSION into its lambda-form parts.

Package

form-fiddle

Source

form-fiddle.lisp (file)

5.1.2 Functions

Function: lambda-body LAMBDA-FORM

Returns all BODY forms of the lambda-form.

|¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯v¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯| (function [name] qualifier* lambda-list [[docstring? | declaration*]] form*)

Package

form-fiddle

Source

form-fiddle.lisp (file)

Function: lambda-declarations LAMBDA-FORM

Returns the DECLARATIONS of the lambda-form, if any.

v
(function [name] qualifier* lambda-list [[docstring? | declaration*]] form*)

Package

form-fiddle

Source

form-fiddle.lisp (file)

Function: lambda-docstring LAMBDA-FORM

Returns the DOCSTRING of the lambda-form, if any.

v
(function [name] qualifier* lambda-list [[docstring? | declaration*]] form*)

Package

form-fiddle

Source

form-fiddle.lisp (file)

Function: lambda-forms LAMBDA-FORM

Returns the actual body forms of the lambda-form, if any.

v (function [name] qualifier* lambda-list [[docstring? | declaration*]] form*)

Package

form-fiddle

Source

form-fiddle.lisp (file)

Function: lambda-function LAMBDA-FORM

Returns the defining FUNCTION of the lambda-form.
v
(function [name] qualifier* lambda-list [[docstring? | declaration*]] form*)

Package

form-fiddle

Source

form-fiddle.lisp (file)

Function: lambda-lambda-list LAMBDA-FORM

Returns the LAMBDA-LIST of the lambda-form.

v
(function [name] qualifier* lambda-list [[docstring? | declaration*]] form*)

Package

form-fiddle

Source

form-fiddle.lisp (file)

Function: lambda-name LAMBDA-FORM

Returns the NAME of the lambda-form, if any.

v
(function [name] qualifier* lambda-list [[docstring? | declaration*]] form*)

Package

form-fiddle

Source

form-fiddle.lisp (file)

Function: lambda-qualifiers LAMBDA-FORM

Returns the QUALIFIERS of the lambda-form.

v
(function [name] qualifier* lambda-list [[docstring? | declaration*]] form*)

Package

form-fiddle

Source

form-fiddle.lisp (file)

Function: split-body-options BODY

Parses the body into two separate lists of forms and options.
This is found in some expressions like in the clause body of RESTART-CASE.

BODY ::= OPTION* FORM*
OPTION ::= KEYWORD EXPRESSION

Package

form-fiddle

Source

form-fiddle.lisp (file)

Function: split-lambda-form LAMBDA-FORM

Returns all parts of a lambda-form as a list in the following order: FUNCTION NAME QUALIFIERS LAMBDA-LIST DOCSTRING DECLARATIONS FORMS

Package

form-fiddle

Source

form-fiddle.lisp (file)

5.2 Internal definitions

5.2.1 Functions

Function: declaration-p FORM

Returns T if the given thing is a declaration expression.

Package

form-fiddle

Source

form-fiddle.lisp (file)

Function: docstring-p FORM

Returns T if the given thing is a docstring.

Package

form-fiddle

Source

form-fiddle.lisp (file)

Function: removef PLIST &rest ARGS

Package

form-fiddle

Source

form-fiddle.lisp (file)

Appendix A Indexes

A.1 Concepts

A.2 Functions

A.3 Variables

A.4 Data types