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
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
|
<html><head><title>XLISP expand</title>
<link rel="stylesheet" type="text/css" href="reference.css">
</head>
<body>
<a href="../start.htm">Nyquist / XLISP 2.0</a> -
<a href="../manual/contents.htm">Contents</a> |
<a href="../tutorials/tutorials.htm">Tutorials</a> |
<a href="../examples/examples.htm">Examples</a> |
<a href="reference-index.htm">Reference</a>
<hr>
<h1>expand</h1>
<hr>
<p><table cellpadding="0" cellspacing="0" style="margin-left:10px"><tbody>
<tr valign="top">
<td><nobr>Type:</nobr></td>
<td><nobr> - </nobr></td>
<td width="100%"><nobr>function (subr)</nobr></td>
</tr>
<tr valign="top">
<td><nobr>Source:</nobr></td>
<td><nobr> - </nobr></td>
<td width="100%"><nobr>xlsys.c, xldmem.c</nobr></td>
</tr>
</tbody></table></p>
<h2>Syntax</h2>
<dl>
<dt>(expand <i>segments</i>)</dt>
<dd><i>segments</i> - the number of segments to add as an integer expression<br>
returns - the number of segments added</dd>
</dl>
<h2>Description</h2>
<p>The 'expand' function expands memory by the specified number of
'segments'. The number of 'segments' added is returned as the result. The
power up default is 1000 nodes per segment. Note that
<a href="alloc.htm">alloc</a> allows you to change the number of
nodes per segment.</p>
<h2>Examples</h2>
<pre class="example">
(room) <font color="#008844">; prints Nodes: 8000</font>
<font color="#008844">; Free nodes: 5622</font>
<font color="#008844">; Segments: 6</font>
<font color="#008844">; Allocate: 1000</font>
<font color="#008844">; Total: 92586</font>
<font color="#008844">; Collections: 8</font>
<font color="#008844">; returns NIL</font>
(expand 2) <font color="#008844">; add more nodes</font>
(room) <font color="#008844">; prints Nodes: 10000</font>
<font color="#008844">; Free nodes: 7608</font>
<font color="#008844">; Segments: 8</font>
<font color="#008844">; Allocate: 1000</font>
<font color="#008844">; Total: 112602</font>
<font color="#008844">; Collections: 8</font>
<font color="#008844">; returns NIL</font>
</pre>
<p><b>Note:</b> When <a href="gc.htm">gc</a> is called or an
automatic garbage collection occurs, if the amount of free memory is still
low after the garbage collection, the system attempts to add more segments
[an automatic 'expand'].</p>
<p>See the
<a href="../manual/xlisp-man-031.htm#expand">expand</a>
function in the <nobr>XLISP 2.0</nobr> manual.</p>
<p><nobr> <a href="#top">Back to Top</nobr></a></p>
<hr>
<a href="../start.htm">Nyquist / XLISP 2.0</a> -
<a href="../manual/contents.htm">Contents</a> |
<a href="../tutorials/tutorials.htm">Tutorials</a> |
<a href="../examples/examples.htm">Examples</a> |
<a href="reference-index.htm">Reference</a>
</body></html>
|
