about summary refs log tree commit diff stats
path: root/tools/README.md
blob: 9e59dabe593c9a9384648057e9d6b394481a2b4c (plain) (blame)
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
Run all these from the top-level `mu/` directory.

### Some tools for Mu's build process

These are built automatically.

* `enumerate`: list numeric files in current directory, optionally `--until`
  some prefix.


### Miscellaneous odds and ends

These are built lazily.

* `browse_trace`: debugging tool. See `browse_trace.readme.md` for details.

* `linkify`: inserts hyperlinks from variables to definitions in Mu's html
  sources. Hacky; just see the number of tests. Invoked by `update_html`.

* `treeshake_all`: rebuild SubX binaries without tests and unused functions.
  Hacky; just helps estimate the code needed to perform various tasks.
  ```
  tools/treeshake_all
  ```

### Notes to self: constraints on the tools/ directory
* Don't overwhelm the initial view of the project with lots of crap in the
  root directory.
* Directories go up top in the github view, so too many sub-directories are
  also overwhelming.
* Don't increase increase build time too much; everything in `tools/` shouldn't
  be automatically built.
  * stuff needed all the time is built from root directory.
* `tools/` contains many independent things; don't make it hard to see
  boundaries. Ideally just one source file per tool. If not, give related
  files similar name prefixes.
'#n271'>271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 352 353 354 355 356 357 358 359 360 361 362 363 364 365 366 367 368 369 370 371 372 373 374 375 376 377 378 379 380 381 382 383 384 385 386 387 388 389 390 391 392 393 394 395 396 397 398 399 400 401 402 403 404 405 406 407 408 409 410 411 412 413 414 415 416 417 418 419 420 421 422 423 424 425 426 427 428 429 430 431 432 433
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
<html>
<head>
<meta http-equiv="content-type" content="text/html; charset=UTF-8">
<title>Mu - 064list.mu</title>
<meta name="Generator" content="Vim/7.4">
<meta name="plugin-version" content="vim7.4_v2">
<meta name="syntax" content="none">
<meta name="settings" content="number_lines,use_css,pre_wrap,no_foldcolumn,expand_tabs,line_ids,prevent_copy=">
<meta name="colorscheme" content="minimal">
<style type="text/css">
<!--
pre { white-space: pre-wrap; font-family: monospace; color: #aaaaaa; background-color: #080808; }
body { font-size: 12pt; font-family: monospace; color: #aaaaaa; background-color: #080808; }
a { color:#eeeeee; text-decoration: none; }
a:hover { text-decoration: underline; }
* { font-size: 12pt; font-size: 1em; }
.muRecipe { color: #ff8700; }
.muScenario { color: #00af00; }
.Special { color: #c00000; }
.Conceal { color: #4e4e4e; }
.Delimiter { color: #800080; }
.Comment { color: #9090ff; }
.Comment a { color:#0000ee; text-decoration:underline; }
.Constant { color: #00a0a0; }
.LineNr { color: #444444; }
.muControl { color: #c0a020; }
.muData { color: #ffff00; }
-->
</style>

<script type='text/javascript'>
<!--

/* function to open any folds containing a jumped-to line before jumping to it */
function JumpToLine()
{
  var lineNum;
  lineNum = window.location.hash;
  lineNum = lineNum.substr(1); /* strip off '#' */

  if (lineNum.indexOf('L') == -1) {
    lineNum = 'L'+lineNum;
  }
  lineElem = document.getElementById(lineNum);
  /* Always jump to new location even if the line was hidden inside a fold, or
   * we corrected the raw number to a line ID.
   */
  if (lineElem) {
    lineElem.scrollIntoView(true);
  }
  return true;
}
if ('onhashchange' in window) {
  window.onhashchange = JumpToLine;
}

-->
</script>
</head>
<body onload='JumpToLine();'>
<pre id='vimCodeElement'>
<span id="L1" class="LineNr">  1 </span><span class="Comment"># A list links up multiple objects together to make them easier to manage.</span>
<span id="L2" class="LineNr">  2 </span><span class="Comment">#</span>
<span id="L3" class="LineNr">  3 </span><span class="Comment"># The objects must be of the same type. If you want to store multiple types in</span>
<span id="L4" class="LineNr">  4 </span><span class="Comment"># a single list, use an exclusive-container.</span>
<span id="L5" class="LineNr">  5 </span>
<span id="L6" class="LineNr">  6 </span><span class="muData">container</span> <a href='064list.mu.html#L6'>list</a>:_elem [
<span id="L7" class="LineNr">  7 </span>  value:_elem
<span id="L8" class="LineNr">  8 </span>  <a href='065duplex_list.mu.html#L29'>next</a>:&amp;:<a href='064list.mu.html#L6'>list</a>:_elem
<span id="L9" class="LineNr">  9 </span>]
<span id="L10" class="LineNr"> 10 </span>
<span id="L11" class="LineNr"> 11 </span><span class="muRecipe">def</span> push x:_elem, l:&amp;:<a href='064list.mu.html#L6'>list</a>:_elem<span class="muRecipe"> -&gt; </span>l:&amp;:<a href='064list.mu.html#L6'>list</a>:_elem [
<span id="L12" class="LineNr"> 12 </span>  <span class="Constant">local-scope</span>
<span id="L13" class="LineNr"> 13 </span>  <span class="Constant">load-ingredients</span>
<span id="L14" class="LineNr"> 14 </span>  result:&amp;:<a href='064list.mu.html#L6'>list</a>:_elem <span class="Special">&lt;-</span> new <span class="Delimiter">{</span>(list _elem): type<span class="Delimiter">}</span>
<span id="L15" class="LineNr"> 15 </span>  *result <span class="Special">&lt;-</span> merge x, l
<span id="L16" class="LineNr"> 16 </span>  <span class="muControl">return</span> result
<span id="L17" class="LineNr"> 17 </span>]
<span id="L18" class="LineNr"> 18 </span>
<span id="L19" class="LineNr"> 19 </span><span class="muRecipe">def</span> first in:&amp;:<a href='064list.mu.html#L6'>list</a>:_elem<span class="muRecipe"> -&gt; </span>result:_elem [
<span id="L20" class="LineNr"> 20 </span>  <span class="Constant">local-scope</span>
<span id="L21" class="LineNr"> 21 </span>  <span class="Constant">load-ingredients</span>
<span id="L22" class="LineNr"> 22 </span>  result <span class="Special">&lt;-</span> get *in, <span class="Constant">value:offset</span>
<span id="L23" class="LineNr"> 23 </span>]
<span id="L24" class="LineNr"> 24 </span>
<span id="L25" class="LineNr"> 25 </span><span class="muRecipe">def</span> <a href='064list.mu.html#L25'>rest</a> in:&amp;:<a href='064list.mu.html#L6'>list</a>:_elem<span class="muRecipe"> -&gt; </span>result:&amp;:<a href='064list.mu.html#L6'>list</a>:_elem/contained-in:in [
<span id="L26" class="LineNr"> 26 </span>  <span class="Constant">local-scope</span>
<span id="L27" class="LineNr"> 27 </span>  <span class="Constant">load-ingredients</span>
<span id="L28" class="LineNr"> 28 </span>  result <span class="Special">&lt;-</span> get *in, <span class="Constant"><a href='065duplex_list.mu.html#L29'>next</a>:offset</span>
<span id="L29" class="LineNr"> 29 </span>]
<span id="L30" class="LineNr"> 30 </span>
<span id="L31" class="LineNr"> 31 </span><span class="muScenario">scenario</span> list-handling [
<span id="L32" class="LineNr"> 32 </span>  run [
<span id="L33" class="LineNr"> 33 </span>  <span class="Conceal">¦</span> <span class="Constant">local-scope</span>
<span id="L34" class="LineNr"> 34 </span>  <span class="Conceal">¦</span> x:&amp;:<a href='064list.mu.html#L6'>list</a>:num <span class="Special">&lt;-</span> push<span class="Constant"> 3</span>,<span class="Constant"> 0</span>
<span id="L35" class="LineNr"> 35 </span>  <span class="Conceal">¦</span> x <span class="Special">&lt;-</span> push<span class="Constant"> 4</span>, x
<span id="L36" class="LineNr"> 36 </span>  <span class="Conceal">¦</span> x <span class="Special">&lt;-</span> push<span class="Constant"> 5</span>, x
<span id="L37" class="LineNr"> 37 </span>  <span class="Conceal">¦</span> 10:num/<span class="Special">raw</span> <span class="Special">&lt;-</span> first x
<span id="L38" class="LineNr"> 38 </span>  <span class="Conceal">¦</span> x <span class="Special">&lt;-</span> <a href='064list.mu.html#L25'>rest</a> x
<span id="L39" class="LineNr"> 39 </span>  <span class="Conceal">¦</span> 11:num/<span class="Special">raw</span> <span class="Special">&lt;-</span> first x
<span id="L40" class="LineNr"> 40 </span>  <span class="Conceal">¦</span> x <span class="Special">&lt;-</span> <a href='064list.mu.html#L25'>rest</a> x
<span id="L41" class="LineNr"> 41 </span>  <span class="Conceal">¦</span> 12:num/<span class="Special">raw</span> <span class="Special">&lt;-</span> first x
<span id="L42" class="LineNr"> 42 </span>  <span class="Conceal">¦</span> 20:&amp;:<a href='064list.mu.html#L6'>list</a>:num/<span class="Special">raw</span> <span class="Special">&lt;-</span> <a href='064list.mu.html#L25'>rest</a> x
<span id="L43" class="LineNr"> 43 </span>  ]
<span id="L44" class="LineNr"> 44 </span>  memory-should-contain [
<span id="L45" class="LineNr"> 45 </span>  <span class="Conceal">¦</span><span class="Constant"> 10</span> <span class="Special">&lt;-</span><span class="Constant"> 5</span>
<span id="L46" class="LineNr"> 46 </span>  <span class="Conceal">¦</span><span class="Constant"> 11</span> <span class="Special">&lt;-</span><span class="Constant"> 4</span>
<span id="L47" class="LineNr"> 47 </span>  <span class="Conceal">¦</span><span class="Constant"> 12</span> <span class="Special">&lt;-</span><span class="Constant"> 3</span>
<span id="L48" class="LineNr"> 48 </span>  <span class="Conceal">¦</span><span class="Constant"> 20</span> <span class="Special">&lt;-</span><span class="Constant"> 0</span>  <span class="Comment"># nothing left</span>
<span id="L49" class="LineNr"> 49 </span>  ]
<span id="L50" class="LineNr"> 50 </span>]
<span id="L51" class="LineNr"> 51 </span>
<span id="L52" class="LineNr"> 52 </span><span class="muRecipe">def</span> length l:&amp;:<a href='064list.mu.html#L6'>list</a>:_elem<span class="muRecipe"> -&gt; </span>result:num [
<span id="L53" class="LineNr"> 53 </span>  <span class="Constant">local-scope</span>
<span id="L54" class="LineNr"> 54 </span>  <span class="Constant">load-ingredients</span>
<span id="L55" class="LineNr"> 55 </span>  result <span class="Special">&lt;-</span> copy<span class="Constant"> 0</span>
<span id="L56" class="LineNr"> 56 </span>  <span class="Delimiter">{</span>
<span id="L57" class="LineNr"> 57 </span>  <span class="Conceal">¦</span> <span class="muControl">break-unless</span> l
<span id="L58" class="LineNr"> 58 </span>  <span class="Conceal">¦</span> result <span class="Special">&lt;-</span> add result,<span class="Constant"> 1</span>
<span id="L59" class="LineNr"> 59 </span>  <span class="Conceal">¦</span> l <span class="Special">&lt;-</span> <a href='064list.mu.html#L25'>rest</a> l
<span id="L60" class="LineNr"> 60 </span>  <span class="Conceal">¦</span> <span class="muControl">loop</span>
<span id="L61" class="LineNr"> 61 </span>  <span class="Delimiter">}</span>
<span id="L62" class="LineNr"> 62 </span>]
<span id="L63" class="LineNr"> 63 </span>
<span id="L64" class="LineNr"> 64 </span><span class="Comment"># insert 'x' after 'in'</span>
<span id="L65" class="LineNr"> 65 </span><span class="muRecipe">def</span> insert x:_elem, in:&amp;:<a href='064list.mu.html#L6'>list</a>:_elem<span class="muRecipe"> -&gt; </span>in:&amp;:<a href='064list.mu.html#L6'>list</a>:_elem [
<span id="L66" class="LineNr"> 66 </span>  <span class="Constant">local-scope</span>
<span id="L67" class="LineNr"> 67 </span>  <span class="Constant">load-ingredients</span>
<span id="L68" class="LineNr"> 68 </span>  new-node:&amp;:<a href='064list.mu.html#L6'>list</a>:_elem <span class="Special">&lt;-</span> new <span class="Delimiter">{</span>(list _elem): type<span class="Delimiter">}</span>
<span id="L69" class="LineNr"> 69 </span>  *new-node <span class="Special">&lt;-</span> put *new-node, <span class="Constant">value:offset</span>, x
<span id="L70" class="LineNr"> 70 </span>  next-node:&amp;:<a href='064list.mu.html#L6'>list</a>:_elem <span class="Special">&lt;-</span> get *in, <span class="Constant"><a href='065duplex_list.mu.html#L29'>next</a>:offset</span>
<span id="L71" class="LineNr"> 71 </span>  *in <span class="Special">&lt;-</span> put *in, <span class="Constant"><a href='065duplex_list.mu.html#L29'>next</a>:offset</span>, new-node
<span id="L72" class="LineNr"> 72 </span>  *new-node <span class="Special">&lt;-</span> put *new-node, <span class="Constant"><a href='065duplex_list.mu.html#L29'>next</a>:offset</span>, next-node
<span id="L73" class="LineNr"> 73 </span>]
<span id="L74" class="LineNr"> 74 </span>
<span id="L75" class="LineNr"> 75 </span><span class="muScenario">scenario</span> inserting-into-list [
<span id="L76" class="LineNr"> 76 </span>  <span class="Constant">local-scope</span>
<span id="L77" class="LineNr"> 77 </span>  <a href='064list.mu.html#L6'>list</a>:&amp;:<a href='064list.mu.html#L6'>list</a>:char <span class="Special">&lt;-</span> push<span class="Constant"> 3</span>,<span class="Constant"> 0</span>
<span id="L78" class="LineNr"> 78 </span>  <a href='064list.mu.html#L6'>list</a> <span class="Special">&lt;-</span> push<span class="Constant"> 4</span>, <a href='064list.mu.html#L6'>list</a>
<span id="L79" class="LineNr"> 79 </span>  <a href='064list.mu.html#L6'>list</a> <span class="Special">&lt;-</span> push<span class="Constant"> 5</span>, <a href='064list.mu.html#L6'>list</a>
<span id="L80" class="LineNr"> 80 </span>  run [
<span id="L81" class="LineNr"> 81 </span>  <span class="Conceal">¦</span> list2:&amp;:<a href='064list.mu.html#L6'>list</a>:char <span class="Special">&lt;-</span> <a href='064list.mu.html#L25'>rest</a> <a href='064list.mu.html#L6'>list</a>  <span class="Comment"># inside list</span>
<span id="L82" class="LineNr"> 82 </span>  <span class="Conceal">¦</span> list2 <span class="Special">&lt;-</span> insert<span class="Constant"> 6</span>, list2
<span id="L83" class="LineNr"> 83 </span>  <span class="Conceal">¦</span> <span class="Comment"># check structure</span>
<span id="L84" class="LineNr"> 84 </span>  <span class="Conceal">¦</span> list2 <span class="Special">&lt;-</span> copy <a href='064list.mu.html#L6'>list</a>
<span id="L85" class="LineNr"> 85 </span>  <span class="Conceal">¦</span> 10:char/<span class="Special">raw</span> <span class="Special">&lt;-</span> first list2
<span id="L86" class="LineNr"> 86 </span>  <span class="Conceal">¦</span> list2 <span class="Special">&lt;-</span> <a href='064list.mu.html#L25'>rest</a> list2
<span id="L87" class="LineNr"> 87 </span>  <span class="Conceal">¦</span> 11:char/<span class="Special">raw</span> <span class="Special">&lt;-</span> first list2
<span id="L88" class="LineNr"> 88 </span>  <span class="Conceal">¦</span> list2 <span class="Special">&lt;-</span> <a href='064list.mu.html#L25'>rest</a> list2
<span id="L89" class="LineNr"> 89 </span>  <span class="Conceal">¦</span> 12:char/<span class="Special">raw</span> <span class="Special">&lt;-</span> first list2
<span id="L90" class="LineNr"> 90 </span>  <span class="Conceal">¦</span> list2 <span class="Special">&lt;-</span> <a href='064list.mu.html#L25'>rest</a> list2
<span id="L91" class="LineNr"> 91 </span>  <span class="Conceal">¦</span> 13:char/<span class="Special">raw</span> <span class="Special">&lt;-</span> first list2
<span id="L92" class="LineNr"> 92 </span>  ]
<span id="L93" class="LineNr"> 93 </span>  memory-should-contain [
<span id="L94" class="LineNr"> 94 </span>  <span class="Conceal">¦</span><span class="Constant"> 10</span> <span class="Special">&lt;-</span><span class="Constant"> 5</span>  <span class="Comment"># scanning next</span>
<span id="L95" class="LineNr"> 95 </span>  <span class="Conceal">¦</span><span class="Constant"> 11</span> <span class="Special">&lt;-</span><span class="Constant"> 4</span>
<span id="L96" class="LineNr"> 96 </span>  <span class="Conceal">¦</span><span class="Constant"> 12</span> <span class="Special">&lt;-</span><span class="Constant"> 6</span>  <span class="Comment"># inserted element</span>
<span id="L97" class="LineNr"> 97 </span>  <span class="Conceal">¦</span><span class="Constant"> 13</span> <span class="Special">&lt;-</span><span class="Constant"> 3</span>
<span id="L98" class="LineNr"> 98 </span>  ]
<span id="L99" class="LineNr"> 99 </span>]
<span id="L100" class="LineNr">100 </span>
<span id="L101" class="LineNr">101 </span><span class="muScenario">scenario</span> inserting-at-end-of-list [
<span id="L102" class="LineNr">102 </span>  <span class="Constant">local-scope</span>
<span id="L103" class="LineNr">103 </span>  <a href='064list.mu.html#L6'>list</a>:&amp;:<a href='064list.mu.html#L6'>list</a>:char <span class="Special">&lt;-</span> push<span class="Constant"> 3</span>,<span class="Constant"> 0</span>
<span id="L104" class="LineNr">104 </span>  <a href='064list.mu.html#L6'>list</a> <span class="Special">&lt;-</span> push<span class="Constant"> 4</span>, <a href='064list.mu.html#L6'>list</a>
<span id="L105" class="LineNr">105 </span>  <a href='064list.mu.html#L6'>list</a> <span class="Special">&lt;-</span> push<span class="Constant"> 5</span>, <a href='064list.mu.html#L6'>list</a>
<span id="L106" class="LineNr">106 </span>  run [
<span id="L107" class="LineNr">107 </span>  <span class="Conceal">¦</span> list2:&amp;:<a href='064list.mu.html#L6'>list</a>:char <span class="Special">&lt;-</span> <a href='064list.mu.html#L25'>rest</a> <a href='064list.mu.html#L6'>list</a>  <span class="Comment"># inside list</span>
<span id="L108" class="LineNr">108 </span>  <span class="Conceal">¦</span> list2 <span class="Special">&lt;-</span> <a href='064list.mu.html#L25'>rest</a> list2  <span class="Comment"># now at end of list</span>
<span id="L109" class="LineNr">109 </span>  <span class="Conceal">¦</span> list2 <span class="Special">&lt;-</span> insert<span class="Constant"> 6</span>, list2
<span id="L110" class="LineNr">110 </span>  <span class="Conceal">¦</span> <span class="Comment"># check structure like before</span>
<span id="L111" class="LineNr">111 </span>  <span class="Conceal">¦</span> list2 <span class="Special">&lt;-</span> copy <a href='064list.mu.html#L6'>list</a>
<span id="L112" class="LineNr">112 </span>  <span class="Conceal">¦</span> 10:char/<span class="Special">raw</span> <span class="Special">&lt;-</span> first list2
<span id="L113" class="LineNr">113 </span>  <span class="Conceal">¦</span> list2 <span class="Special">&lt;-</span> <a href='064list.mu.html#L25'>rest</a> list2
<span id="L114" class="LineNr">114 </span>  <span class="Conceal">¦</span> 11:char/<span class="Special">raw</span> <span class="Special">&lt;-</span> first list2
<span id="L115" class="LineNr">115 </span>  <span class="Conceal">¦</span> list2 <span class="Special">&lt;-</span> <a href='064list.mu.html#L25'>rest</a> list2
<span id="L116" class="LineNr">116 </span>  <span class="Conceal">¦</span> 12:char/<span class="Special">raw</span> <span class="Special">&lt;-</span> first list2
<span id="L117" class="LineNr">117 </span>  <span class="Conceal">¦</span> list2 <span class="Special">&lt;-</span> <a href='064list.mu.html#L25'>rest</a> list2
<span id="L118" class="LineNr">118 </span>  <span class="Conceal">¦</span> 13:char/<span class="Special">raw</span> <span class="Special">&lt;-</span> first list2
<span id="L119" class="LineNr">119 </span>  ]
<span id="L120" class="LineNr">120 </span>  memory-should-contain [
<span id="L121" class="LineNr">121 </span>  <span class="Conceal">¦</span><span class="Constant"> 10</span> <span class="Special">&lt;-</span><span class="Constant"> 5</span>  <span class="Comment"># scanning next</span>
<span id="L122" class="LineNr">122 </span>  <span class="Conceal">¦</span><span class="Constant"> 11</span> <span class="Special">&lt;-</span><span class="Constant"> 4</span>
<span id="L123" class="LineNr">123 </span>  <span class="Conceal">¦</span><span class="Constant"> 12</span> <span class="Special">&lt;-</span><span class="Constant"> 3</span>
<span id="L124" class="LineNr">124 </span>  <span class="Conceal">¦</span><span class="Constant"> 13</span> <span class="Special">&lt;-</span><span class="Constant"> 6</span>  <span class="Comment"># inserted element</span>
<span id="L125" class="LineNr">125 </span>  ]
<span id="L126" class="LineNr">126 </span>]
<span id="L127" class="LineNr">127 </span>
<span id="L128" class="LineNr">128 </span><span class="muScenario">scenario</span> inserting-after-start-of-list [
<span id="L129" class="LineNr">129 </span>  <span class="Constant">local-scope</span>
<span id="L130" class="LineNr">130 </span>  <a href='064list.mu.html#L6'>list</a>:&amp;:<a href='064list.mu.html#L6'>list</a>:char <span class="Special">&lt;-</span> push<span class="Constant"> 3</span>,<span class="Constant"> 0</span>
<span id="L131" class="LineNr">131 </span>  <a href='064list.mu.html#L6'>list</a> <span class="Special">&lt;-</span> push<span class="Constant"> 4</span>, <a href='064list.mu.html#L6'>list</a>
<span id="L132" class="LineNr">132 </span>  <a href='064list.mu.html#L6'>list</a> <span class="Special">&lt;-</span> push<span class="Constant"> 5</span>, <a href='064list.mu.html#L6'>list</a>
<span id="L133" class="LineNr">133 </span>  run [
<span id="L134" class="LineNr">134 </span>  <span class="Conceal">¦</span> <a href='064list.mu.html#L6'>list</a> <span class="Special">&lt;-</span> insert<span class="Constant"> 6</span>, <a href='064list.mu.html#L6'>list</a>
<span id="L135" class="LineNr">135 </span>  <span class="Conceal">¦</span> <span class="Comment"># check structure like before</span>
<span id="L136" class="LineNr">136 </span>  <span class="Conceal">¦</span> list2:&amp;:<a href='064list.mu.html#L6'>list</a>:char <span class="Special">&lt;-</span> copy <a href='064list.mu.html#L6'>list</a>
<span id="L137" class="LineNr">137 </span>  <span class="Conceal">¦</span> 10:char/<span class="Special">raw</span> <span class="Special">&lt;-</span> first list2
<span id="L138" class="LineNr">138 </span>  <span class="Conceal">¦</span> list2 <span class="Special">&lt;-</span> <a href='064list.mu.html#L25'>rest</a> list2
<span id="L139" class="LineNr">139 </span>  <span class="Conceal">¦</span> 11:char/<span class="Special">raw</span> <span class="Special">&lt;-</span> first list2
<span id="L140" class="LineNr">140 </span>  <span class="Conceal">¦</span> list2 <span class="Special">&lt;-</span> <a href='064list.mu.html#L25'>rest</a> list2
<span id="L141" class="LineNr">141 </span>  <span class="Conceal">¦</span> 12:char/<span class="Special">raw</span> <span class="Special">&lt;-</span> first list2
<span id="L142" class="LineNr">142 </span>  <span class="Conceal">¦</span> list2 <span class="Special">&lt;-</span> <a href='064list.mu.html#L25'>rest</a> list2
<span id="L143" class="LineNr">143 </span>  <span class="Conceal">¦</span> 13:char/<span class="Special">raw</span> <span class="Special">&lt;-</span> first list2
<span id="L144" class="LineNr">144 </span>  ]
<span id="L145" class="LineNr">145 </span>  memory-should-contain [
<span id="L146" class="LineNr">146 </span>  <span class="Conceal">¦</span><span class="Constant"> 10</span> <span class="Special">&lt;-</span><span class="Constant"> 5</span>  <span class="Comment"># scanning next</span>
<span id="L147" class="LineNr">147 </span>  <span class="Conceal">¦</span><span class="Constant"> 11</span> <span class="Special">&lt;-</span><span class="Constant"> 6</span>  <span class="Comment"># inserted element</span>
<span id="L148" class="LineNr">148 </span>  <span class="Conceal">¦</span><span class="Constant"> 12</span> <span class="Special">&lt;-</span><span class="Constant"> 4</span>
<span id="L149" class="LineNr">149 </span>  <span class="Conceal">¦</span><span class="Constant"> 13</span> <span class="Special">&lt;-</span><span class="Constant"> 3</span>
<span id="L150" class="LineNr">150 </span>  ]
<span id="L151" class="LineNr">151 </span>]
<span id="L152" class="LineNr">152 </span>
<span id="L153" class="LineNr">153 </span><span class="Comment"># remove 'x' from its surrounding list 'in'</span>
<span id="L154" class="LineNr">154 </span><span class="Comment">#</span>
<span id="L155" class="LineNr">155 </span><span class="Comment"># Returns null if and only if list is empty. Beware: in that case any other</span>
<span id="L156" class="LineNr">156 </span><span class="Comment"># pointers to the head are now invalid.</span>
<span id="L157" class="LineNr">157 </span><span class="muRecipe">def</span> remove x:&amp;:<a href='064list.mu.html#L6'>list</a>:_elem/contained-in:in, in:&amp;:<a href='064list.mu.html#L6'>list</a>:_elem<span class="muRecipe"> -&gt; </span>in:&amp;:<a href='064list.mu.html#L6'>list</a>:_elem [
<span id="L158" class="LineNr">158 </span>  <span class="Constant">local-scope</span>
<span id="L159" class="LineNr">159 </span>  <span class="Constant">load-ingredients</span>
<span id="L160" class="LineNr">160 </span>  <span class="Comment"># if 'x' is null, return</span>
<span id="L161" class="LineNr">161 </span>  <span class="muControl">return-unless</span> x
<span id="L162" class="LineNr">162 </span>  next-node:&amp;:<a href='064list.mu.html#L6'>list</a>:_elem <span class="Special">&lt;-</span> <a href='064list.mu.html#L25'>rest</a> x
<span id="L163" class="LineNr">163 </span>  <span class="Comment"># clear next pointer of 'x'</span>
<span id="L164" class="LineNr">164 </span>  *x <span class="Special">&lt;-</span> put *x, <span class="Constant"><a href='065duplex_list.mu.html#L29'>next</a>:offset</span>,<span class="Constant"> 0</span>
<span id="L165" class="LineNr">165 </span>  <span class="Comment"># if 'x' is at the head of 'in', return the new head</span>
<span id="L166" class="LineNr">166 </span>  at-head?:bool <span class="Special">&lt;-</span> equal x, in
<span id="L167" class="LineNr">167 </span>  <span class="muControl">return-if</span> at-head?, next-node
<span id="L168" class="LineNr">168 </span>  <span class="Comment"># compute prev-node</span>
<span id="L169" class="LineNr">169 </span>  prev-node:&amp;:<a href='064list.mu.html#L6'>list</a>:_elem <span class="Special">&lt;-</span> copy in
<span id="L170" class="LineNr">170 </span>  curr:&amp;:<a href='064list.mu.html#L6'>list</a>:_elem <span class="Special">&lt;-</span> <a href='064list.mu.html#L25'>rest</a> prev-node
<span id="L171" class="LineNr">171 </span>  <span class="Delimiter">{</span>
<span id="L172" class="LineNr">172 </span>  <span class="Conceal">¦</span> <span class="muControl">return-unless</span> curr
<span id="L173" class="LineNr">173 </span>  <span class="Conceal">¦</span> found?:bool <span class="Special">&lt;-</span> equal curr, x
<span id="L174" class="LineNr">174 </span>  <span class="Conceal">¦</span> <span class="muControl">break-if</span> found?
<span id="L175" class="LineNr">175 </span>  <span class="Conceal">¦</span> prev-node <span class="Special">&lt;-</span> copy curr
<span id="L176" class="LineNr">176 </span>  <span class="Conceal">¦</span> curr <span class="Special">&lt;-</span> <a href='064list.mu.html#L25'>rest</a> curr
<span id="L177" class="LineNr">177 </span>  <span class="Delimiter">}</span>
<span id="L178" class="LineNr">178 </span>  <span class="Comment"># set its next pointer to skip 'x'</span>
<span id="L179" class="LineNr">179 </span>  *prev-node <span class="Special">&lt;-</span> put *prev-node, <span class="Constant"><a href='065duplex_list.mu.html#L29'>next</a>:offset</span>, next-node
<span id="L180" class="LineNr">180 </span>]
<span id="L181" class="LineNr">181 </span>
<span id="L182" class="LineNr">182 </span><span class="muScenario">scenario</span> removing-from-list [
<span id="L183" class="LineNr">183 </span>  <span class="Constant">local-scope</span>
<span id="L184" class="LineNr">184 </span>  <a href='064list.mu.html#L6'>list</a>:&amp;:<a href='064list.mu.html#L6'>list</a>:char <span class="Special">&lt;-</span> push<span class="Constant"> 3</span>,<span class="Constant"> 0</span>
<span id="L185" class="LineNr">185 </span>  <a href='064list.mu.html#L6'>list</a> <span class="Special">&lt;-</span> push<span class="Constant"> 4</span>, <a href='064list.mu.html#L6'>list</a>
<span id="L186" class="LineNr">186 </span>  <a href='064list.mu.html#L6'>list</a> <span class="Special">&lt;-</span> push<span class="Constant"> 5</span>, <a href='064list.mu.html#L6'>list</a>
<span id="L187" class="LineNr">187 </span>  run [
<span id="L188" class="LineNr">188 </span>  <span class="Conceal">¦</span> list2:&amp;:<a href='064list.mu.html#L6'>list</a>:char <span class="Special">&lt;-</span> <a href='064list.mu.html#L25'>rest</a> <a href='064list.mu.html#L6'>list</a>  <span class="Comment"># second element</span>
<span id="L189" class="LineNr">189 </span>  <span class="Conceal">¦</span> <a href='064list.mu.html#L6'>list</a> <span class="Special">&lt;-</span> remove list2, <a href='064list.mu.html#L6'>list</a>
<span id="L190" class="LineNr">190 </span>  <span class="Conceal">¦</span> 10:bool/<span class="Special">raw</span> <span class="Special">&lt;-</span> equal list2,<span class="Constant"> 0</span>
<span id="L191" class="LineNr">191 </span>  <span class="Conceal">¦</span> <span class="Comment"># check structure like before</span>
<span id="L192" class="LineNr">192 </span>  <span class="Conceal">¦</span> list2 <span class="Special">&lt;-</span> copy <a href='064list.mu.html#L6'>list</a>
<span id="L193" class="LineNr">193 </span>  <span class="Conceal">¦</span> 11:char/<span class="Special">raw</span> <span class="Special">&lt;-</span> first list2
<span id="L194" class="LineNr">194 </span>  <span class="Conceal">¦</span> list2 <span class="Special">&lt;-</span> <a href='064list.mu.html#L25'>rest</a> list2
<span id="L195" class="LineNr">195 </span>  <span class="Conceal">¦</span> 12:char/<span class="Special">raw</span> <span class="Special">&lt;-</span> first list2
<span id="L196" class="LineNr">196 </span>  <span class="Conceal">¦</span> 20:&amp;:<a href='064list.mu.html#L6'>list</a>:char/<span class="Special">raw</span> <span class="Special">&lt;-</span> <a href='064list.mu.html#L25'>rest</a> list2
<span id="L197" class="LineNr">197 </span>  ]
<span id="L198" class="LineNr">198 </span>  memory-should-contain [
<span id="L199" class="LineNr">199 </span>  <span class="Conceal">¦</span><span class="Constant"> 10</span> <span class="Special">&lt;-</span><span class="Constant"> 0</span>  <span class="Comment"># remove returned non-null</span>
<span id="L200" class="LineNr">200 </span>  <span class="Conceal">¦</span><span class="Constant"> 11</span> <span class="Special">&lt;-</span><span class="Constant"> 5</span>  <span class="Comment"># scanning next, skipping deleted element</span>
<span id="L201" class="LineNr">201 </span>  <span class="Conceal">¦</span><span class="Constant"> 12</span> <span class="Special">&lt;-</span><span class="Constant"> 3</span>
<span id="L202" class="LineNr">202 </span>  <span class="Conceal">¦</span><span class="Constant"> 20</span> <span class="Special">&lt;-</span><span class="Constant"> 0</span>  <span class="Comment"># no more elements</span>
<span id="L203" class="LineNr">203 </span>  ]
<span id="L204" class="LineNr">204 </span>]
<span id="L205" class="LineNr">205 </span>
<span id="L206" class="LineNr">206 </span><span class="muScenario">scenario</span> removing-from-start-of-list [
<span id="L207" class="LineNr">207 </span>  <span class="Constant">local-scope</span>
<span id="L208" class="LineNr">208 </span>  <a href='064list.mu.html#L6'>list</a>:&amp;:<a href='064list.mu.html#L6'>list</a>:char <span class="Special">&lt;-</span> push<span class="Constant"> 3</span>,<span class="Constant"> 0</span>
<span id="L209" class="LineNr">209 </span>  <a href='064list.mu.html#L6'>list</a> <span class="Special">&lt;-</span> push<span class="Constant"> 4</span>, <a href='064list.mu.html#L6'>list</a>
<span id="L210" class="LineNr">210 </span>  <a href='064list.mu.html#L6'>list</a> <span class="Special">&lt;-</span> push<span class="Constant"> 5</span>, <a href='064list.mu.html#L6'>list</a>
<span id="L211" class="LineNr">211 </span>  run [
<span id="L212" class="LineNr">212 </span>  <span class="Conceal">¦</span> <a href='064list.mu.html#L6'>list</a> <span class="Special">&lt;-</span> remove <a href='064list.mu.html#L6'>list</a>, <a href='064list.mu.html#L6'>list</a>
<span id="L213" class="LineNr">213 </span>  <span class="Conceal">¦</span> <span class="Comment"># check structure like before</span>
<span id="L214" class="LineNr">214 </span>  <span class="Conceal">¦</span> list2:&amp;:<a href='064list.mu.html#L6'>list</a>:char <span class="Special">&lt;-</span> copy <a href='064list.mu.html#L6'>list</a>
<span id="L215" class="LineNr">215 </span>  <span class="Conceal">¦</span> 10:char/<span class="Special">raw</span> <span class="Special">&lt;-</span> first list2
<span id="L216" class="LineNr">216 </span>  <span class="Conceal">¦</span> list2 <span class="Special">&lt;-</span> <a href='064list.mu.html#L25'>rest</a> list2
<span id="L217" class="LineNr">217 </span>  <span class="Conceal">¦</span> 11:char/<span class="Special">raw</span> <span class="Special">&lt;-</span> first list2
<span id="L218" class="LineNr">218 </span>  <span class="Conceal">¦</span> 20:&amp;:<a href='064list.mu.html#L6'>list</a>:char/<span class="Special">raw</span> <span class="Special">&lt;-</span> <a href='064list.mu.html#L25'>rest</a> list2
<span id="L219" class="LineNr">219 </span>  ]
<span id="L220" class="LineNr">220 </span>  memory-should-contain [
<span id="L221" class="LineNr">221 </span>  <span class="Conceal">¦</span><span class="Constant"> 10</span> <span class="Special">&lt;-</span><span class="Constant"> 4</span>  <span class="Comment"># scanning next, skipping deleted element</span>
<span id="L222" class="LineNr">222 </span>  <span class="Conceal">¦</span><span class="Constant"> 11</span> <span class="Special">&lt;-</span><span class="Constant"> 3</span>
<span id="L223" class="LineNr">223 </span>  <span class="Conceal">¦</span><span class="Constant"> 20</span> <span class="Special">&lt;-</span><span class="Constant"> 0</span>  <span class="Comment"># no more elements</span>
<span id="L224" class="LineNr">224 </span>  ]
<span id="L225" class="LineNr">225 </span>]
<span id="L226" class="LineNr">226 </span>
<span id="L227" class="LineNr">227 </span><span class="muScenario">scenario</span> removing-from-end-of-list [
<span id="L228" class="LineNr">228 </span>  <span class="Constant">local-scope</span>
<span id="L229" class="LineNr">229 </span>  <a href='064list.mu.html#L6'>list</a>:&amp;:<a href='064list.mu.html#L6'>list</a>:char <span class="Special">&lt;-</span> push<span class="Constant"> 3</span>,<span class="Constant"> 0</span>
<span id="L230" class="LineNr">230 </span>  <a href='064list.mu.html#L6'>list</a> <span class="Special">&lt;-</span> push<span class="Constant"> 4</span>, <a href='064list.mu.html#L6'>list</a>
<span id="L231" class="LineNr">231 </span>  <a href='064list.mu.html#L6'>list</a> <span class="Special">&lt;-</span> push<span class="Constant"> 5</span>, <a href='064list.mu.html#L6'>list</a>
<span id="L232" class="LineNr">232 </span>  run [
<span id="L233" class="LineNr">233 </span>  <span class="Conceal">¦</span> <span class="Comment"># delete last element</span>
<span id="L234" class="LineNr">234 </span>  <span class="Conceal">¦</span> list2:&amp;:<a href='064list.mu.html#L6'>list</a>:char <span class="Special">&lt;-</span> <a href='064list.mu.html#L25'>rest</a> <a href='064list.mu.html#L6'>list</a>
<span id="L235" class="LineNr">235 </span>  <span class="Conceal">¦</span> list2 <span class="Special">&lt;-</span> <a href='064list.mu.html#L25'>rest</a> list2
<span id="L236" class="LineNr">236 </span>  <span class="Conceal">¦</span> <a href='064list.mu.html#L6'>list</a> <span class="Special">&lt;-</span> remove list2, <a href='064list.mu.html#L6'>list</a>
<span id="L237" class="LineNr">237 </span>  <span class="Conceal">¦</span> 10:bool/<span class="Special">raw</span> <span class="Special">&lt;-</span> equal list2,<span class="Constant"> 0</span>
<span id="L238" class="LineNr">238 </span>  <span class="Conceal">¦</span> <span class="Comment"># check structure like before</span>
<span id="L239" class="LineNr">239 </span>  <span class="Conceal">¦</span> list2 <span class="Special">&lt;-</span> copy <a href='064list.mu.html#L6'>list</a>
<span id="L240" class="LineNr">240 </span>  <span class="Conceal">¦</span> 11:char/<span class="Special">raw</span> <span class="Special">&lt;-</span> first list2
<span id="L241" class="LineNr">241 </span>  <span class="Conceal">¦</span> list2 <span class="Special">&lt;-</span> <a href='064list.mu.html#L25'>rest</a> list2
<span id="L242" class="LineNr">242 </span>  <span class="Conceal">¦</span> 12:char/<span class="Special">raw</span> <span class="Special">&lt;-</span> first list2
<span id="L243" class="LineNr">243 </span>  <span class="Conceal">¦</span> 20:&amp;:<a href='064list.mu.html#L6'>list</a>:char/<span class="Special">raw</span> <span class="Special">&lt;-</span> <a href='064list.mu.html#L25'>rest</a> list2
<span id="L244" class="LineNr">244 </span>  ]
<span id="L245" class="LineNr">245 </span>  memory-should-contain [
<span id="L246" class="LineNr">246 </span>  <span class="Conceal">¦</span><span class="Constant"> 10</span> <span class="Special">&lt;-</span><span class="Constant"> 0</span>  <span class="Comment"># remove returned non-null</span>
<span id="L247" class="LineNr">247 </span>  <span class="Conceal">¦</span><span class="Constant"> 11</span> <span class="Special">&lt;-</span><span class="Constant"> 5</span>  <span class="Comment"># scanning next, skipping deleted element</span>
<span id="L248" class="LineNr">248 </span>  <span class="Conceal">¦</span><span class="Constant"> 12</span> <span class="Special">&lt;-</span><span class="Constant"> 4</span>
<span id="L249" class="LineNr">249 </span>  <span class="Conceal">¦</span><span class="Constant"> 20</span> <span class="Special">&lt;-</span><span class="Constant"> 0</span>  <span class="Comment"># no more elements</span>
<span id="L250" class="LineNr">250 </span>  ]
<span id="L251" class="LineNr">251 </span>]
<span id="L252" class="LineNr">252 </span>
<span id="L253" class="LineNr">253 </span><span class="muScenario">scenario</span> removing-from-singleton-list [
<span id="L254" class="LineNr">254 </span>  <span class="Constant">local-scope</span>
<span id="L255" class="LineNr">255 </span>  <a href='064list.mu.html#L6'>list</a>:&amp;:<a href='064list.mu.html#L6'>list</a>:char <span class="Special">&lt;-</span> push<span class="Constant"> 3</span>,<span class="Constant"> 0</span>
<span id="L256" class="LineNr">256 </span>  run [
<span id="L257" class="LineNr">257 </span>  <span class="Conceal">¦</span> <a href='064list.mu.html#L6'>list</a> <span class="Special">&lt;-</span> remove <a href='064list.mu.html#L6'>list</a>, <a href='064list.mu.html#L6'>list</a>
<span id="L258" class="LineNr">258 </span>  <span class="Conceal">¦</span> 1:num/<span class="Special">raw</span> <span class="Special">&lt;-</span> copy <a href='064list.mu.html#L6'>list</a>
<span id="L259" class="LineNr">259 </span>  ]
<span id="L260" class="LineNr">260 </span>  memory-should-contain [
<span id="L261" class="LineNr">261 </span>  <span class="Conceal">¦</span><span class="Constant"> 1</span> <span class="Special">&lt;-</span><span class="Constant"> 0</span>  <span class="Comment"># back to an empty list</span>
<span id="L262" class="LineNr">262 </span>  ]
<span id="L263" class="LineNr">263 </span>]
<span id="L264" class="LineNr">264 </span>
<span id="L265" class="LineNr">265 </span><span class="Comment"># reverse the elements of a list</span>
<span id="L266" class="LineNr">266 </span><span class="Comment"># (contributed by Caleb Couch)</span>
<span id="L267" class="LineNr">267 </span><span class="muRecipe">def</span> reverse <a href='064list.mu.html#L6'>list</a>:&amp;:<a href='064list.mu.html#L6'>list</a>:_elem temp:&amp;:<a href='064list.mu.html#L6'>list</a>:_elem/contained-in:result<span class="muRecipe"> -&gt; </span>result:&amp;:<a href='064list.mu.html#L6'>list</a>:_elem [
<span id="L268" class="LineNr">268 </span>  <span class="Constant">local-scope</span>
<span id="L269" class="LineNr">269 </span>  <span class="Constant">load-ingredients</span>
<span id="L270" class="LineNr">270 </span>  <span class="muControl">return-unless</span> <a href='064list.mu.html#L6'>list</a>, temp
<span id="L271" class="LineNr">271 </span>  object:_elem <span class="Special">&lt;-</span> first, <a href='064list.mu.html#L6'>list</a>
<span id="L272" class="LineNr">272 </span>  <a href='064list.mu.html#L6'>list</a> <span class="Special">&lt;-</span> <a href='064list.mu.html#L25'>rest</a> <a href='064list.mu.html#L6'>list</a>
<span id="L273" class="LineNr">273 </span>  temp <span class="Special">&lt;-</span> push object, temp
<span id="L274" class="LineNr">274 </span>  result <span class="Special">&lt;-</span> reverse <a href='064list.mu.html#L6'>list</a>, temp
<span id="L275" class="LineNr">275 </span>]
<span id="L276" class="LineNr">276 </span>
<span id="L277" class="LineNr">277 </span><span class="muScenario">scenario</span> reverse-list [
<span id="L278" class="LineNr">278 </span>  <span class="Constant">local-scope</span>
<span id="L279" class="LineNr">279 </span>  <a href='064list.mu.html#L6'>list</a>:&amp;:<a href='064list.mu.html#L6'>list</a>:num <span class="Special">&lt;-</span> push<span class="Constant"> 1</span>,<span class="Constant"> 0</span>
<span id="L280" class="LineNr">280 </span>  <a href='064list.mu.html#L6'>list</a> <span class="Special">&lt;-</span> push<span class="Constant"> 2</span>, <a href='064list.mu.html#L6'>list</a>
<span id="L281" class="LineNr">281 </span>  <a href='064list.mu.html#L6'>list</a> <span class="Special">&lt;-</span> push<span class="Constant"> 3</span>, <a href='064list.mu.html#L6'>list</a>
<span id="L282" class="LineNr">282 </span>  run [
<span id="L283" class="LineNr">283 </span>  <span class="Conceal">¦</span> stash <span class="Constant">[list:]</span>, <a href='064list.mu.html#L6'>list</a>
<span id="L284" class="LineNr">284 </span>  <span class="Conceal">¦</span> <a href='064list.mu.html#L6'>list</a> <span class="Special">&lt;-</span> reverse <a href='064list.mu.html#L6'>list</a>
<span id="L285" class="LineNr">285 </span>  <span class="Conceal">¦</span> stash <span class="Constant">[reversed:]</span>, <a href='064list.mu.html#L6'>list</a>
<span id="L286" class="LineNr">286 </span>  ]
<span id="L287" class="LineNr">287 </span>  trace-should-contain [
<span id="L288" class="LineNr">288 </span>  <span class="Conceal">¦</span> app: <a href='064list.mu.html#L6'>list</a>:<span class="Constant"> 3</span><span class="muRecipe"> -&gt; </span>2<span class="muRecipe"> -&gt; </span>1
<span id="L289" class="LineNr">289 </span>  <span class="Conceal">¦</span> app: reversed:<span class="Constant"> 1</span><span class="muRecipe"> -&gt; </span>2<span class="muRecipe"> -&gt; </span>3
<span id="L290" class="LineNr">290 </span>  ]
<span id="L291" class="LineNr">291 </span>]
<span id="L292" class="LineNr">292 </span>
<span id="L293" class="LineNr">293 </span><span class="muScenario">scenario</span> stash-list [
<span id="L294" class="LineNr">294 </span>  <span class="Constant">local-scope</span>
<span id="L295" class="LineNr">295 </span>  <a href='064list.mu.html#L6'>list</a>:&amp;:<a href='064list.mu.html#L6'>list</a>:num <span class="Special">&lt;-</span> push<span class="Constant"> 1</span>,<span class="Constant"> 0</span>
<span id="L296" class="LineNr">296 </span>  <a href='064list.mu.html#L6'>list</a> <span class="Special">&lt;-</span> push<span class="Constant"> 2</span>, <a href='064list.mu.html#L6'>list</a>
<span id="L297" class="LineNr">297 </span>  <a href='064list.mu.html#L6'>list</a> <span class="Special">&lt;-</span> push<span class="Constant"> 3</span>, <a href='064list.mu.html#L6'>list</a>
<span id="L298" class="LineNr">298 </span>  run [
<span id="L299" class="LineNr">299 </span>  <span class="Conceal">¦</span> stash <span class="Constant">[list:]</span>, <a href='064list.mu.html#L6'>list</a>
<span id="L300" class="LineNr">300 </span>  ]
<span id="L301" class="LineNr">301 </span>  trace-should-contain [
<span id="L302" class="LineNr">302 </span>  <span class="Conceal">¦</span> app: <a href='064list.mu.html#L6'>list</a>:<span class="Constant"> 3</span><span class="muRecipe"> -&gt; </span>2<span class="muRecipe"> -&gt; </span>1
<span id="L303" class="LineNr">303 </span>  ]
<span id="L304" class="LineNr">304 </span>]
<span id="L305" class="LineNr">305 </span>
<span id="L306" class="LineNr">306 </span><span class="muRecipe">def</span> to-text in:&amp;:<a href='064list.mu.html#L6'>list</a>:_elem<span class="muRecipe"> -&gt; </span>result:text [
<span id="L307" class="LineNr">307 </span>  <span class="Constant">local-scope</span>
<span id="L308" class="LineNr">308 </span>  <span class="Constant">load-ingredients</span>
<span id="L309" class="LineNr">309 </span>  buf:&amp;:<a href='061text.mu.html#L126'>buffer</a>:char <span class="Special">&lt;-</span> <a href='061text.mu.html#L131'>new-buffer</a><span class="Constant"> 80</span>
<span id="L310" class="LineNr">310 </span>  buf <span class="Special">&lt;-</span> to-buffer in, buf
<span id="L311" class="LineNr">311 </span>  result <span class="Special">&lt;-</span> <a href='061text.mu.html#L353'>buffer-to-array</a> buf
<span id="L312" class="LineNr">312 </span>]
<span id="L313" class="LineNr">313 </span>
<span id="L314" class="LineNr">314 </span><span class="Comment"># variant of 'to-text' which stops printing after a few elements (and so is robust to cycles)</span>
<span id="L315" class="LineNr">315 </span><span class="muRecipe">def</span> to-text-line in:&amp;:<a href='064list.mu.html#L6'>list</a>:_elem<span class="muRecipe"> -&gt; </span>result:text [
<span id="L316" class="LineNr">316 </span>  <span class="Constant">local-scope</span>
<span id="L317" class="LineNr">317 </span>  <span class="Constant">load-ingredients</span>
<span id="L318" class="LineNr">318 </span>  buf:&amp;:<a href='061text.mu.html#L126'>buffer</a>:char <span class="Special">&lt;-</span> <a href='061text.mu.html#L131'>new-buffer</a><span class="Constant"> 80</span>
<span id="L319" class="LineNr">319 </span>  buf <span class="Special">&lt;-</span> to-buffer in, buf,<span class="Constant"> 6</span>  <span class="Comment"># max elements to display</span>
<span id="L320" class="LineNr">320 </span>  result <span class="Special">&lt;-</span> <a href='061text.mu.html#L353'>buffer-to-array</a> buf
<span id="L321" class="LineNr">321 </span>]
<span id="L322" class="LineNr">322 </span>
<span id="L323" class="LineNr">323 </span><span class="muRecipe">def</span> to-buffer in:&amp;:<a href='064list.mu.html#L6'>list</a>:_elem, buf:&amp;:<a href='061text.mu.html#L126'>buffer</a>:char<span class="muRecipe"> -&gt; </span>buf:&amp;:<a href='061text.mu.html#L126'>buffer</a>:char [
<span id="L324" class="LineNr">324 </span>  <span class="Constant">local-scope</span>
<span id="L325" class="LineNr">325 </span>  <span class="Constant">load-ingredients</span>
<span id="L326" class="LineNr">326 </span>  <span class="Delimiter">{</span>
<span id="L327" class="LineNr">327 </span>  <span class="Conceal">¦</span> <span class="muControl">break-if</span> in
<span id="L328" class="LineNr">328 </span>  <span class="Conceal">¦</span> buf <span class="Special">&lt;-</span> append buf, <span class="Constant">[[]</span>]
<span id="L329" class="LineNr">329 </span>  <span class="Conceal">¦</span> <span class="muControl">return</span>
<span id="L330" class="LineNr">330 </span>  <span class="Delimiter">}</span>
<span id="L331" class="LineNr">331 </span>  <span class="Comment"># append in.value to buf</span>
<span id="L332" class="LineNr">332 </span>  val:_elem <span class="Special">&lt;-</span> get *in, <span class="Constant">value:offset</span>
<span id="L333" class="LineNr">333 </span>  buf <span class="Special">&lt;-</span> append buf, val
<span id="L334" class="LineNr">334 </span>  <span class="Comment"># now prepare next</span>
<span id="L335" class="LineNr">335 </span>  <a href='065duplex_list.mu.html#L29'>next</a>:&amp;:<a href='064list.mu.html#L6'>list</a>:_elem <span class="Special">&lt;-</span> <a href='064list.mu.html#L25'>rest</a> in
<span id="L336" class="LineNr">336 </span>  nextn:num <span class="Special">&lt;-</span> copy <a href='065duplex_list.mu.html#L29'>next</a>
<span id="L337" class="LineNr">337 </span>  <span class="muControl">return-unless</span> <a href='065duplex_list.mu.html#L29'>next</a>
<span id="L338" class="LineNr">338 </span>  buf <span class="Special">&lt;-</span> append buf, <span class="Constant">[ -&gt; ]</span>
<span id="L339" class="LineNr">339 </span>  <span class="Comment"># and recurse</span>
<span id="L340" class="LineNr">340 </span>  remaining:num, optional-ingredient-found?:bool <span class="Special">&lt;-</span> <span class="Constant">next-ingredient</span>
<span id="L341" class="LineNr">341 </span>  <span class="Delimiter">{</span>
<span id="L342" class="LineNr">342 </span>  <span class="Conceal">¦</span> <span class="muControl">break-if</span> optional-ingredient-found?
<span id="L343" class="LineNr">343 </span>  <span class="Conceal">¦</span> <span class="Comment"># unlimited recursion</span>
<span id="L344" class="LineNr">344 </span>  <span class="Conceal">¦</span> buf <span class="Special">&lt;-</span> to-buffer <a href='065duplex_list.mu.html#L29'>next</a>, buf
<span id="L345" class="LineNr">345 </span>  <span class="Conceal">¦</span> <span class="muControl">return</span>
<span id="L346" class="LineNr">346 </span>  <span class="Delimiter">}</span>
<span id="L347" class="LineNr">347 </span>  <span class="Delimiter">{</span>
<span id="L348" class="LineNr">348 </span>  <span class="Conceal">¦</span> <span class="muControl">break-unless</span> remaining
<span id="L349" class="LineNr">349 </span>  <span class="Conceal">¦</span> <span class="Comment"># limited recursion</span>
<span id="L350" class="LineNr">350 </span>  <span class="Conceal">¦</span> remaining <span class="Special">&lt;-</span> subtract remaining,<span class="Constant"> 1</span>
<span id="L351" class="LineNr">351 </span>  <span class="Conceal">¦</span> buf <span class="Special">&lt;-</span> to-buffer <a href='065duplex_list.mu.html#L29'>next</a>, buf, remaining
<span id="L352" class="LineNr">352 </span>  <span class="Conceal">¦</span> <span class="muControl">return</span>
<span id="L353" class="LineNr">353 </span>  <span class="Delimiter">}</span>
<span id="L354" class="LineNr">354 </span>  <span class="Comment"># past recursion depth; insert ellipses and stop</span>
<span id="L355" class="LineNr">355 </span>  append buf, <span class="Constant">[...]</span>
<span id="L356" class="LineNr">356 </span>]
<span id="L357" class="LineNr">357 </span>
<span id="L358" class="LineNr">358 </span><span class="muScenario">scenario</span> stash-empty-list [
<span id="L359" class="LineNr">359 </span>  <span class="Constant">local-scope</span>
<span id="L360" class="LineNr">360 </span>  x:&amp;:<a href='064list.mu.html#L6'>list</a>:num <span class="Special">&lt;-</span> copy<span class="Constant"> 0</span>
<span id="L361" class="LineNr">361 </span>  run [
<span id="L362" class="LineNr">362 </span>  <span class="Conceal">¦</span> stash x
<span id="L363" class="LineNr">363 </span>  ]
<span id="L364" class="LineNr">364 </span>  trace-should-contain [
<span id="L365" class="LineNr">365 </span>  <span class="Conceal">¦</span> app: <span class="Constant">[]</span>
<span id="L366" class="LineNr">366 </span>  ]
<span id="L367" class="LineNr">367 </span>]
</pre>
</body>
</html>
<!-- vim: set foldmethod=manual : -->