User Tools


Function COMPILE

Syntax

  • compile name &optional definitionfunction, warnings-p, failure-p

Arguments and Values

Description

Compiles an interpreted function.

compile produces a compiled function from definition. If the definition is a lambda expression, it is coerced to a function.

If the definition is already a compiled function, compile either produces that function itself (i.e. is an identity operation) or an equivalent function.

If the name is nil, the resulting compiled function is returned directly as the primary value. If a non-nil name is given, then the resulting compiled function replaces the existing function definition of name and the name is returned as the primary value; if name is a symbol that names a macro, its macro function is updated and the name is returned as the primary value.

Literal objects appearing in code processed by the compile function are neither copied nor coalesced. The code resulting from the execution of compile references objects that are eql to the corresponding objects in the source code.

compile is permitted, but not required, to establish a handler for conditions of type error. For example, the handler might issue a warning and restart compilation from some implementation-dependent point in order to let the compilation proceed without manual intervention.

The secondary value, warnings-p, is false if no conditions of type error or warning were detected by the compiler, and true otherwise.

The tertiary value, failure-p, is false if no conditions of type error or warning (other than style-warning) were detected by the compiler, and true otherwise.

Examples

(defun foo () "bar")

FOO

(compiled-function-p #'foo)

implementation-dependent

(compile 'foo)

FOO NIL NIL

(compiled-function-p #'foo)

true

(setf (symbol-function 'foo) (compile nil '(lambda () "replaced")))

#<Compiled-Function>

(foo)

"replaced"

Affected By

*error-output*,

*macroexpand-hook*.

The presence of macro definitions and proclamations.

Exceptional Situations

The consequences are undefined if the lexical environment surrounding the function to be compiled contains any bindings other than those for macros, symbol macros, or declarations.

For information about errors detected during the compilation process, see section {\secref\FileCompilerExceptions}.

See Also

Notes

None.

\issue{QUOTE-SEMANTICS:NO-COPYING} \issue{COMPILER-DIAGNOSTICS:USE-HANDLER} \issue{COMPILER-WARNING-STREAM} \issue{COMPILE-ARGUMENT-PROBLEMS-AGAIN:FIX} \issue{FUNCTION-NAME:LARGE} \issue{COMPILED-FUNCTION-REQUIREMENTS:TIGHTEN} \issue{COMPILE-ARGUMENT-PROBLEMS-AGAIN:FIX}