scheme-rs 0.2.0

Embedded scheme for the Rust ecosystem
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29

# Threads

The threads library `(import (threads))` provides threading primitives. 

## Values and threads 

All values in scheme-rs are safe to send across threads and all mutations are 
atomic. 

## `spawn` _procedure_

```scheme
(spawn thunk)
```

Invokes `thunk` in a newly created thread and returns a [join handle](#join-handle).

## `join` _procedure_

```scheme
(join join-handle)
```

Takes a [join handle](#join-handle) and blocks until the thread returns, 
returning the values. After the thread has returned, the same values will be 
returned on subsequent calls.

If the thread throws an exception, `join` will re-throw the same exception each
time it is called.