racket/collects/scribblings/guide/boxes.scrbl
2008-06-09 16:07:52 +00:00

24 lines
545 B
Racket

#lang scribble/doc
@(require scribble/manual
scribble/eval
"guide-utils.ss")
@title[#:tag "boxes"]{Boxes}
A @deftech{box} is like a single-element vector. It prints as
@litchar{#&} followed by the printed form of the boxed value. A
@litchar{#&} form can also be used as an expression, but since the
resulting box is constant, it has practically no use.
@; So what are boxes good for, anyway?
@examples[
(define b (box "apple"))
b
(unbox b)
(set-box! b '(banana boat))
b
]
@refdetails["boxes"]{boxes and box procedures}