► |  | The Racket Reference

1 | Language Model
2 | Syntactic Forms
3 | Datatypes
4 | Structures
5 | Classes and Objects
6 | Units
7 | Contracts
8 | Pattern Matching
9 | Control Flow
10 | Concurrency and Parallelism
11 | Macros
12 | Input and Output
13 | Reflection and Security
14 | Operating System
15 | Memory Management
16 | Unsafe Operations
17 | Running Racket
| Bibliography
| Index

▼ | 3 | Datatypes

3.1 | Booleans and Equality
3.2 | Numbers
3.3 | Strings
3.4 | Byte Strings
3.5 | Characters
3.6 | Symbols
3.7 | Regular Expressions
3.8 | Keywords
3.9 | Pairs and Lists
3.10 | Mutable Pairs and Lists
3.11 | Vectors
3.12 | Boxes
3.13 | Hash Tables
3.14 | Sequences and Streams
3.15 | Dictionaries
3.16 | Sets
3.17 | Procedures
3.18 | Void and Undefined

► | 3.10 | Mutable Pairs and Lists

3.10.1 | Mutable Pair Constructors and Selectors

On this page:

3.10.1`` Mutable Pair Constructors and Selectors
mpair?
mcons
mcar
mcdr
set-mcar!
set-mcdr!

top ← prev up next →

#### 3.10`` Mutable Pairs and Lists

A mutable pair is like a pair created by cons, but it supports set-mcar! and set-mcdr! mutation operations to change the parts of the mutable pair (like traditional Lisp and Scheme pairs).

A mutable list is analogous to a list created with pairs, but instead created with mutable pairs.

A mutable pair is not a pair; they are completely separate datatypes. Similarly, a mutable list is not a list, except that the empty list is also the empty mutable list. Instead of programming with mutable pairs and mutable lists, data structures such as pairs, lists, and hash tables are practically always better choices.

A mutable list can be used as a single-valued sequence (see Sequences). The elements of the mutable list serve as elements of the sequence. See also in-mlist.

##### 3.10.1`` Mutable Pair Constructors and Selectors

> > procedure

> > (mpair? v) → boolean?

> v : any/c

Returns #t if v is a mutable pair, #f otherwise.

> > procedure

> > (mcons a d) → pair?

> a : any/c
> d : any/c

Returns a newly allocated mutable pair whose first element is a and second element is d.

> > procedure

> > (mcar p) → any/c

> p : mpair?

Returns the first element of the mutable pair p.

> > procedure

> > (mcdr p) → any/c

> p : mpair?

Returns the second element of the mutable pair p.

> > procedure

> > (set-mcar! p v) → void?

> p : mpair?
> v : any/v

Changes the mutable pair p so that its first element is v.

> > procedure

> > (set-mcdr! p v) → void?

> p : mpair?
> v : any/v

Changes the mutable pair p so that its second element is v.
top ← prev up next →