▼ |  | Unstable: May Change Without Warning

1 | Guidelines for Developing unstable Libraries
2 | Automata: Compiling State Machines
3 | Bytes
4 | Contracts
5 | Converting Values to Strings
6 | Contracts for Macro Subexpressions
7 | Debugging
8 | Definitions
9 | Filesystem
10 | Find
11 | Flonums
12 | Futures
13 | Functions
14 | Hash Tables
15 | Interface-Oriented Programming for Classes
16 | Lazy Require
17 | Lists
18 | Logging
19 | Mark Parameters
20 | Match
21 | Parameter Groups
22 | Pretty-Printing
23 | Sequences
24 | Strings
25 | Structs
26 | Syntax
27 | Temporal Contracts: Explicit Contract Monitors
28 | GUI Libraries

On this page:

mark-parameter
mark-parameter-first
mark-parameter-all
mark-parameters-all
mark-parameterize

Version: 5.3
top← prev up next →

### 19`` Mark Parameters

Jay McCarthy <jay@racket-lang.org>

This library is unstable; compatibility will not be maintained. See Unstable: May Change Without Warning for more information.

(require unstable/markparam)

This library provides a simplified version of parameters that are backed by continuation marks, rather than parameterizations. This means they are slightly slower, are not inherited by child threads, do not have initial values, and cannot be imperatively mutated.

> > struct

> > (struct mark-parameter ())

The struct for mark parameters. It is guaranteed to be serializable and transparent. If used as a procedure, it calls mark-parameter-first on itself.

> > procedure

> > (mark-parameter-first mp [tag]) → any/c

> mp : mark-parameter?

> | tag |  | : |  | continuation-prompt-tag?
> |  |  | = |  | default-continuation-prompt-tag

Returns the first value of mp up to tag.

> > procedure

> > (mark-parameter-all mp [tag]) → list?

> mp : mark-parameter?

> | tag |  | : |  | continuation-prompt-tag?
> |  |  | = |  | default-continuation-prompt-tag

Returns the values of mp up to tag.

> > procedure

> > (mark-parameters-all mps none-v [tag]) → (listof vector?)

> mps : (listof mark-parameter?)
> none-v : [any/c #f]

> | tag |  | : |  | continuation-prompt-tag?
> |  |  | = |  | default-continuation-prompt-tag

Returns the values of the mps up to tag. The length of each vector in the result list is the same as the length of mps, and a value in a particular vector position is the value for the corresponding mark parameter in mps. Values for multiple mark parameter appear in a single vector only when the mark parameters are for the same continuation frame in the current continuation. The none-v argument is used for vector elements to indicate the lack of a value.

> > syntax

> > (mark-parameterize ([mp expr] ...) body-expr ...)

Parameterizes (begin body-expr ...) by associating each mp with the evaluation of expr in the parameterization of the entire expression.
top← prev up next →