racket/collects/scribblings/guide/boxes.scrbl
Eli Barzilay debd1f9f1e Recketizing much in `net/*', mass ".ss" -> ".rkt" conversion in .scrbl files.
(Some other minor things here and there.)
2011-06-20 04:27:14 -04:00

22 lines
537 B
Racket

#lang scribble/doc
@(require scribble/manual scribble/eval "guide-utils.rkt")
@title[#:tag "boxes"]{Boxes}
A @deftech{box} is like a single-element vector. It can print as a
quoted @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}