Reference: PLT Scheme

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
11`` | Macros
12`` | Input and Output
13`` | Reflection and Security
14`` | Operating System
15`` | Memory Management
16`` | Running PLT Scheme
| Bibliography
| Index

On this page:

collect-garbage
current-memory-use
dump-memory-stats

Version: 4.0.2
contents index
← prev up next →

#### 15.4`` Garbage Collection

(collect-garbage) → void?

Forces an immediate garbage collection. Some effectively unreachable data may remain uncollected, because the collector cannot prove that it is unreachable.

The collect-garbage procedure provides some control over the timing of collections, but garbage will obviously be collected even if this procedure is never called.

(current-memory-use [cust]) → nonnegative-exact-integer?
cust : custodian? = #f

Returns an estimate of the number of bytes of memory occupied by reachable data from cust. (The estimate is calculated without performing an immediate garbage collection; performing a collection generally decreases the number returned by current-memory-use.) If cust is not provided, the estimate is a total reachable from any custodians.

When PLT Scheme is compiled without support for memory accounting, the estimate is the same (i.e., all memory) for any individual custodian; see also custodian-memory-accounting-available?.

(dump-memory-stats) → any

Dumps information about memory usage to the (low-level) standard output port.

contents index
← prev up next →