CLCS
src report error
Index
return-from Data and Control Flow Dictionary tagbody
Macro

return

return [result] ⇒ #<NoValue>

Arguments and Values

resulta form; evaluated. The default is nil.

Description

Returns, as if by return-from, from the block named nil.

Examples

 (block nil (return) 1) ⇒  NIL
 (block nil (return 1) 2) ⇒  1
 (block nil (return (values 1 2)) 3) ⇒  1, 2
 (block nil (block alpha (return 1) 2)) ⇒  1
 (block alpha (block nil (return 1)) 2) ⇒  2
 (block nil (block nil (return 1) 2)) ⇒  1

See Also

block, return-from, Evaluation

Notes

 (return) ≡ (return-from nil)
 (return form) ≡ (return-from nil form)

The implicit blocks established by macros such as do are often named nil, so that return can be used to exit from such forms.

Backlinks

block, Condition System Concepts, Control Transfer Clauses, Data and Control Flow Dictionary, do, do*, do-symbols, do-external-symbols, do-all-symbols, dolist, dotimes, Expanding Loop Forms, Initial and Final Execution, loop, Order of Execution, prog, prog*, Return Values, return-from, Simple Loop, Symbols in the COMMON-LISP Package, throw, unwind-protect