racket/pkgs/racket-doc/scribblings/guide/named-let.scrbl
Matthew Flatt 2d4f3e2ac9 remove the "racket-pkgs" directory layer
The layer is now redundant, since everything left in "pkgs" is in the
"racket-pkgs" category.
2014-12-08 05:22:59 -07:00

38 lines
1008 B
Racket

#lang scribble/doc
@(require scribble/manual scribble/eval "guide-utils.rkt")
@title{Named @racket[let]}
A named @racket[let] is an iteration and recursion form. It uses the
same syntactic keyword @racket[let] as for local binding, but an
identifier after the @racket[let] (instead of an immediate open
parenthesis) triggers a different parsing.
@specform[
(let proc-id ([arg-id init-expr] ...)
body ...+)
]
A named @racket[let] form is equivalent to
@racketblock[
(letrec ([_proc-id (lambda (_arg-id ...)
_body ...+)])
(_proc-id _init-expr ...))
]
That is, a named @racket[let] binds a function identifier that is
visible only in the function's body, and it implicitly calls the
function with the values of some initial expressions.
@defexamples[
(define (duplicate pos lst)
(let dup ([i 0]
[lst lst])
(cond
[(= i pos) (cons (car lst) lst)]
[else (cons (car lst) (dup (+ i 1) (cdr lst)))])))
(duplicate 1 (list "apple" "cheese burger!" "banana"))
]