11.6 Local Binding with Splicing Body

Examples:

> (splicing-let-syntax ([one (lambda (stx) #'1)])       (define o one))

> o

1

> one

reference to undefined identifier: one

When a splicing binding form occurs in a top-level context or module context, its local bindings are treated similarly to definitions. In particular, if a reference to one of the splicing form’s bound variables is evaluated before the variable is initialized, an unbound variable error is raised, instead of the variable evaluating to the undefined value. Also, syntax bindings are evaluated every time the module is visited, instead of only once during compilation as in let-syntax, etc.

Example:

> (splicing-letrec ([x bad]                       [bad 1])       x)

reference to undefined identifier: bad.3

Note that require transformers and provide transformers are not affected by syntax parameterization. While all uses of require and provide will be spliced into the enclosing context, derived import or export specifications will expand as if they had not been inside of the splicing-syntax-parameterize.

Examples:

> (define-syntax-parameter place (lambda (stx) #'"Kansas"))

> (define-syntax-rule (where) `(at ,(place)))

> (where)

'(at "Kansas")

> (splicing-syntax-parameterize ([place (lambda (stx) #'"Oz")])       (define here (where)))

> here

'(at "Oz")