Lambda-Fiddle

About Lambda-Fiddle

Lambda-fiddle is a collection of utilities to process lambda-lists. Mostly useful in contexts where you want a macro that uses lambda-lists in some fashion but need more precise processing.

How To

Included are --for each standard lambda-list part-- a remove-*-part and *-lambda-var/s function that remove the specified part or extract the associated variable/s, respectively. These are all based on the more generale collect-for-keyword and exclude-for-keyword functions that will scan the given lambda-list for the keyword and collect accordingly. The generalised functions may also be useful if you plan to include your own non-standard keywords.

(lambda-fiddle:remove-aux-part '(foo bar &key baz &aux (something else) altogether))
(lambda-fiddle:aux-lambda-vars '(foo bar &key baz &aux (something else) altogether))

Additionally, there is split-lambda-list and its macro partner with-destructured-lambda-list that split the lambda-list into all its parts and return/bind them accordingly, allowing for easy access.

(lambda-fiddle:split-lambda-list '(&whole wide world &key roles))
(lambda-fiddle:with-destructured-lambda-list (:required req) '(foo bar &optional baz)
  req)

Copyright

lambda-fiddle is licensed under the Artistic license. © Nicolas Hafner <shinmera@tymoon.eu> . This library can be obtained on https://github.com/Shinmera/lambda-fiddle.

Package Index

LAMBDA-FIDDLE (ORG.SHIRAKUMO.LAMBDA-FIDDLE)

special
*LAMBDA-KEYWORDS*
```
List of all standard lambda-keywords.
```

special

`SINGLE-ARGUMENT-KEYWORDS`

List of all standard lambda-keywords that only allow one argument.

function (

`AUX-LAMBDA-VARS`

LAMBDA-LIST)

Returns all auxiliary variables of the ordinary-lambda-list.

function (

`BODY-LAMBDA-VAR`

LAMBDA-LIST)

Returns the body variable of the ordinary-lambda-list.

function (

`COLLECT-FOR-KEYWORD`

KEYWORD LAMBDA-LIST &KEY (SPANNING T))

Returns a fresh list of elements listed after the KEYWORD in the lambda-list.
If SPANNING is T, it includes everything up until the next keyword, otherwise only one token each.

function (
CONSTRUCT-LAMBDA-LIST
&KEY WHOLE ENVIRONMENT REQUIRED OPTIONAL REST BODY KEY ALLOW-OTHER-KEYS AUX)
```
Construct a lambda-list out of the given parts.
```

function (

`ENVIRONMENT-LAMBDA-VAR`

LAMBDA-LIST)

Returns the environment variable of the lambda-list

function (

`EXCLUDE-FOR-KEYWORD`

KEYWORD LAMBDA-LIST &KEY (SPANNING T))

Returns a fresh lambda-list but without the parts identified by KEYWORD.
If SPANNING is T, it excludes everything up until the next keyword, otherwise only one token each.

function (

`EXTRACT-ALL-LAMBDA-VARS`

LAMBDA-LIST)

Extracts all variable bindings from the lambda-list, including the present-p ones.

function (

`EXTRACT-LAMBDA-VARS`

LAMBDA-LIST)

Extracts the symbols that name the variables in the lambda-list.

function (

`FLATTEN-LAMBDA-LIST`

LAMBDA-LIST)

Flattens the lambda-list by replacing all lists within it with their respective first symbol.
This also properly flattens inner lambda-lists of macro-lambda-lists.

function (

`FLATTEN-METHOD-LAMBDA-LIST`

LAMBDA-LIST)

Flattens the lambda-list by replacing all lists within it with their respective first symbol.
Unlike FLATTEN-LAMBDA-LIST, this works for method lambda lists.

function (

`KEY-LAMBDA-VARS`

LAMBDA-LIST)

Returns all keyword variables of the ordinary-lambda-list.

function (

`LAMBDA-KEYWORD-P`

SYMBOL)

Returns the symbol if it is a lambda-keyword symbol (the &-options).

function (

`OPTIONAL-LAMBDA-VARS`

LAMBDA-LIST)

Returns all optional variables of the ordinary-lambda-list.

function (

`REMOVE-AUX-PART`

LAMBDA-LIST)

Returns a fresh lambda-list without the &aux part.

function (

`REMOVE-BODY-PART`

LAMBDA-LIST)

Returns a fresh lambda-list without the &body part.

function (

`REMOVE-ENVIRONMENT-PART`

LAMBDA-LIST)

Returns a fresh lambda-list without the &environment part.

function (

`REMOVE-KEY-PART`

LAMBDA-LIST)

Returns a fresh lambda-list without the &key part (also removing &allow-other-keys if present).

function (

`REMOVE-OPTIONAL-PART`

LAMBDA-LIST)

Returns a fresh lambda-list without the &optional part.

function (

`REMOVE-REQUIRED-PART`

LAMBDA-LIST)

Returns a fresh lambda-list without the required variables part.

function (

`REMOVE-REST-PART`

LAMBDA-LIST)

Returns a fresh lambda-list without the &rest part.

function (

`REMOVE-WHOLE-PART`

LAMBDA-LIST)

Returns a fresh lambda-list without the &whole part.

function (

`REQUIRED-LAMBDA-VARS`

LAMBDA-LIST)

Returns all required variables of the ordinary-lambda-list.

function (

`REST-LAMBDA-VAR`

LAMBDA-LIST)

Returns the rest variable of the ordinary-lambda-list.

function (

`SINGLE-ARGUMENT-KEYWORD-P`

SYMBOL)

Returns the symbol if it is a single-argument-keyword symbol.

function (

`SPLIT-LAMBDA-LIST`

LAMBDA-LIST)

Splits the lambda-list into its individual definition parts. Returns a list of values as follows:
 ((REQUIRED*) WHOLE ENVIRONMENT (OPTIONAL*) REST BODY (KEY*) (AUX*))

function (

`WHOLE-LAMBDA-VAR`

LAMBDA-LIST)

Returns the &whole variable of the lambda-list.

macro (
WITH-DESTRUCTURED-LAMBDA-LIST
(&REST PARTS &KEY WHOLE ENVIRONMENT REQUIRED OPTIONAL REST BODY KEY AUX &ALLOW-OTHER-KEYS) EXPRESSION &BODY FORMS)
```
Destructures the given EXPRESSION into its lambda-list parts.
```

lambda-fiddle

About Lambda-Fiddle

How To

Copyright

Package Index

LAMBDA-FIDDLE (ORG.SHIRAKUMO.LAMBDA-FIDDLE)

`LAMBDA-KEYWORDS`

`SINGLE-ARGUMENT-KEYWORDS`

`AUX-LAMBDA-VARS`

`BODY-LAMBDA-VAR`

`COLLECT-FOR-KEYWORD`

`CONSTRUCT-LAMBDA-LIST`

`ENVIRONMENT-LAMBDA-VAR`

`EXCLUDE-FOR-KEYWORD`

`EXTRACT-ALL-LAMBDA-VARS`

`EXTRACT-LAMBDA-VARS`

`FLATTEN-LAMBDA-LIST`

`FLATTEN-METHOD-LAMBDA-LIST`

`KEY-LAMBDA-VARS`

`LAMBDA-KEYWORD-P`

`OPTIONAL-LAMBDA-VARS`

`REMOVE-AUX-PART`

`REMOVE-BODY-PART`

`REMOVE-ENVIRONMENT-PART`

`REMOVE-KEY-PART`

`REMOVE-OPTIONAL-PART`

`REMOVE-REQUIRED-PART`

`REMOVE-REST-PART`

`REMOVE-WHOLE-PART`

`REQUIRED-LAMBDA-VARS`

`REST-LAMBDA-VAR`

`SINGLE-ARGUMENT-KEYWORD-P`

`SPLIT-LAMBDA-LIST`

`WHOLE-LAMBDA-VAR`

`WITH-DESTRUCTURED-LAMBDA-LIST`