diff options
Diffstat (limited to 'html/apps/mulisp.subx.html')
| -rw-r--r-- | html/apps/mulisp.subx.html | 229 |
1 files changed, 132 insertions, 97 deletions
diff --git a/html/apps/mulisp.subx.html b/html/apps/mulisp.subx.html index e3c08251..7976b071 100644 --- a/html/apps/mulisp.subx.html +++ b/html/apps/mulisp.subx.html @@ -92,103 +92,138 @@ if ('onhashchange' in window) { <span id="L35" class="LineNr"> 35 </span> b8/copy-to-eax 1/imm32/exit <span id="L36" class="LineNr"> 36 </span> cd/syscall 0x80/imm8 <span id="L37" class="LineNr"> 37 </span> -<span id="L38" class="LineNr"> 38 </span><span class="subxComment"># type cell = nil | num | char | symbol | pair | array | stream</span> -<span id="L39" class="LineNr"> 39 </span><span class="subxComment"># tag: 0 1 2 3 4 5 6</span> -<span id="L40" class="LineNr"> 40 </span><span class="subxComment"># numbers start with a digit and are always in hex</span> -<span id="L41" class="LineNr"> 41 </span><span class="subxComment"># characters start with a backslash</span> -<span id="L42" class="LineNr"> 42 </span><span class="subxComment"># pairs start with '('</span> -<span id="L43" class="LineNr"> 43 </span><span class="subxComment"># arrays start with '['</span> -<span id="L44" class="LineNr"> 44 </span><span class="subxComment"># symbols start with anything else but quote, backquote, unquote or splice</span> -<span id="L45" class="LineNr"> 45 </span> -<span id="L46" class="LineNr"> 46 </span><span class="subxFunction">repl</span>: <span class="subxComment"># in : (address buffered-file), out : (address buffered-file) -> <void></span> -<span id="L47" class="LineNr"> 47 </span> <span class="subxS1Comment"># . prolog</span> -<span id="L48" class="LineNr"> 48 </span> 55/push-ebp -<span id="L49" class="LineNr"> 49 </span> 89/<- %ebp 4/r32/esp -<span id="L50" class="LineNr"> 50 </span> <span class="subxS1Comment"># . save registers</span> -<span id="L51" class="LineNr"> 51 </span> 50/push-eax -<span id="L52" class="LineNr"> 52 </span><span class="Constant">$repl:loop</span>: -<span id="L53" class="LineNr"> 53 </span> (lisp-read <span class="SpecialChar"><a href='../061read-byte.subx.html#L14'>Stdin</a></span>) <span class="subxComment"># => eax : (address cell)</span> -<span id="L54" class="LineNr"> 54 </span> <span class="subxComment"># if (eax == 0) break</span> -<span id="L55" class="LineNr"> 55 </span> 3d/compare-eax-and 0/imm32 -<span id="L56" class="LineNr"> 56 </span> 74/jump-if-equal $repl:end/disp8 -<span id="L57" class="LineNr"> 57 </span> <span class="subxComment">#</span> -<span id="L58" class="LineNr"> 58 </span> (lisp-eval %eax) <span class="subxComment"># => eax : (address cell)</span> -<span id="L59" class="LineNr"> 59 </span> (lisp-print <span class="SpecialChar"><a href='../064write-byte.subx.html#L10'>Stdout</a></span> %eax) -<span id="L60" class="LineNr"> 60 </span> <span class="subxComment"># loop</span> -<span id="L61" class="LineNr"> 61 </span> eb/jump $repl:loop/disp8 -<span id="L62" class="LineNr"> 62 </span><span class="Constant">$repl:end</span>: -<span id="L63" class="LineNr"> 63 </span> <span class="subxS1Comment"># . restore registers</span> -<span id="L64" class="LineNr"> 64 </span> 58/pop-to-eax -<span id="L65" class="LineNr"> 65 </span> <span class="subxS1Comment"># . epilog</span> -<span id="L66" class="LineNr"> 66 </span> 89/<- %esp 5/r32/ebp -<span id="L67" class="LineNr"> 67 </span> 5d/pop-to-ebp -<span id="L68" class="LineNr"> 68 </span> c3/return -<span id="L69" class="LineNr"> 69 </span> -<span id="L70" class="LineNr"> 70 </span><span class="subxFunction">lisp-read</span>: <span class="subxComment"># in : (address buffered-file) -> eax : (address cell)</span> -<span id="L71" class="LineNr"> 71 </span> <span class="subxS1Comment"># . prolog</span> -<span id="L72" class="LineNr"> 72 </span> 55/push-ebp -<span id="L73" class="LineNr"> 73 </span> 89/<- %ebp 4/r32/esp -<span id="L74" class="LineNr"> 74 </span> <span class="subxS1Comment"># . save registers</span> -<span id="L75" class="LineNr"> 75 </span> <span class="subxComment"># var s/ecx : (address stream) = new-stream(512)</span> -<span id="L76" class="LineNr"> 76 </span> 81 5/subop/subtract %esp 0x200/imm32 -<span id="L77" class="LineNr"> 77 </span> 68/push 0x200/imm32/size -<span id="L78" class="LineNr"> 78 </span> 68/push 0/imm32/read -<span id="L79" class="LineNr"> 79 </span> 68/push 0/imm32/write -<span id="L80" class="LineNr"> 80 </span> 89/<- %ecx 4/r32/esp -<span id="L81" class="LineNr"> 81 </span> <span class="subxComment">#</span> -<span id="L82" class="LineNr"> 82 </span> (clear-stream %ecx) -<span id="L83" class="LineNr"> 83 </span> (read-line-buffered *(ebp+8) %ecx) -<span id="L84" class="LineNr"> 84 </span> <span class="subxComment"># if (s->write == 0) return null</span> -<span id="L85" class="LineNr"> 85 </span> 81 7/subop/compare *ecx 0/imm32 -<span id="L86" class="LineNr"> 86 </span> 75/jump-if-not-equal $lisp-read:loop/disp8 -<span id="L87" class="LineNr"> 87 </span> b8/copy-to-eax 0/imm32/eof -<span id="L88" class="LineNr"> 88 </span> eb/jump $lisp-read:end/disp8 -<span id="L89" class="LineNr"> 89 </span><span class="Constant">$lisp-read:loop</span>: -<span id="L90" class="LineNr"> 90 </span> <span class="subxComment"># return s</span> -<span id="L91" class="LineNr"> 91 </span> 89/<- %eax 1/r32/ecx -<span id="L92" class="LineNr"> 92 </span><span class="Constant">$lisp-read:end</span>: -<span id="L93" class="LineNr"> 93 </span> <span class="subxS1Comment"># . reclaim locals</span> -<span id="L94" class="LineNr"> 94 </span> 81 0/subop/add %esp 0x20c/imm32 -<span id="L95" class="LineNr"> 95 </span> <span class="subxS1Comment"># . restore registers</span> -<span id="L96" class="LineNr"> 96 </span> <span class="subxS1Comment"># . epilog</span> -<span id="L97" class="LineNr"> 97 </span> 89/<- %esp 5/r32/ebp -<span id="L98" class="LineNr"> 98 </span> 5d/pop-to-ebp -<span id="L99" class="LineNr"> 99 </span> c3/return -<span id="L100" class="LineNr">100 </span> -<span id="L101" class="LineNr">101 </span><span class="subxFunction">lisp-eval</span>: <span class="subxComment"># in : (address cell) -> eax : (address cell)</span> -<span id="L102" class="LineNr">102 </span> <span class="subxS1Comment"># . prolog</span> -<span id="L103" class="LineNr">103 </span> 55/push-ebp -<span id="L104" class="LineNr">104 </span> 89/<- %ebp 4/r32/esp -<span id="L105" class="LineNr">105 </span> <span class="subxS1Comment"># . save registers</span> -<span id="L106" class="LineNr">106 </span> 8b/-> *(ebp+8) 0/r32/eax -<span id="L107" class="LineNr">107 </span><span class="Constant">$lisp-eval:end</span>: -<span id="L108" class="LineNr">108 </span> <span class="subxS1Comment"># . restore registers</span> -<span id="L109" class="LineNr">109 </span> <span class="subxS1Comment"># . epilog</span> -<span id="L110" class="LineNr">110 </span> 89/<- %esp 5/r32/ebp -<span id="L111" class="LineNr">111 </span> 5d/pop-to-ebp -<span id="L112" class="LineNr">112 </span> c3/return -<span id="L113" class="LineNr">113 </span> -<span id="L114" class="LineNr">114 </span><span class="subxFunction">lisp-print</span>: <span class="subxComment"># out : (address buffered-file), x : (address cell)</span> -<span id="L115" class="LineNr">115 </span> <span class="subxS1Comment"># . prolog</span> -<span id="L116" class="LineNr">116 </span> 55/push-ebp -<span id="L117" class="LineNr">117 </span> 89/<- %ebp 4/r32/esp -<span id="L118" class="LineNr">118 </span> <span class="subxS1Comment"># . save registers</span> -<span id="L119" class="LineNr">119 </span> <span class="subxComment"># write(x)</span> -<span id="L120" class="LineNr">120 </span> (write-buffered <span class="SpecialChar"><a href='../064write-byte.subx.html#L10'>Stdout</a></span> <span class="Constant">"=> "</span>) -<span id="L121" class="LineNr">121 </span> (write-stream-data <span class="SpecialChar"><a href='../064write-byte.subx.html#L10'>Stdout</a></span> *(ebp+0xc)) -<span id="L122" class="LineNr">122 </span> (flush <span class="SpecialChar"><a href='../064write-byte.subx.html#L10'>Stdout</a></span>) -<span id="L123" class="LineNr">123 </span><span class="Constant">$lisp-print:end</span>: -<span id="L124" class="LineNr">124 </span> <span class="subxS1Comment"># . restore registers</span> -<span id="L125" class="LineNr">125 </span> <span class="subxS1Comment"># . epilog</span> -<span id="L126" class="LineNr">126 </span> 89/<- %esp 5/r32/ebp -<span id="L127" class="LineNr">127 </span> 5d/pop-to-ebp -<span id="L128" class="LineNr">128 </span> c3/return -<span id="L129" class="LineNr">129 </span> -<span id="L130" class="LineNr">130 </span>== data -<span id="L131" class="LineNr">131 </span> -<span id="L132" class="LineNr">132 </span><span class="SpecialChar">Nil</span>: -<span id="L133" class="LineNr">133 </span> 0/imm32/tag -<span id="L134" class="LineNr">134 </span> 0/imm32/data +<span id="L38" class="LineNr"> 38 </span><span class="subxComment"># Data structures</span> +<span id="L39" class="LineNr"> 39 </span><span class="subxComment">#</span> +<span id="L40" class="LineNr"> 40 </span><span class="subxComment"># Lisp is dynamically typed. Values always carry around knowledge of their</span> +<span id="L41" class="LineNr"> 41 </span><span class="subxComment"># type.</span> +<span id="L42" class="LineNr"> 42 </span><span class="subxComment">#</span> +<span id="L43" class="LineNr"> 43 </span><span class="subxComment"># There's several types of types in the description below, so we need a</span> +<span id="L44" class="LineNr"> 44 </span><span class="subxComment"># glossary and notational convention to disambiguate:</span> +<span id="L45" class="LineNr"> 45 </span><span class="subxComment"># lisp type: what Lisp code can see. Looks how you type it at the prompt.</span> +<span id="L46" class="LineNr"> 46 </span><span class="subxComment"># nil num char string symbol pair array</span> +<span id="L47" class="LineNr"> 47 </span><span class="subxComment"># type tag: the numeric code for a lisp type. All caps.</span> +<span id="L48" class="LineNr"> 48 </span><span class="subxComment"># NIL NUM CHAR STRING SYMBOL PAIR ARRAY</span> +<span id="L49" class="LineNr"> 49 </span><span class="subxComment"># memory type: a type specifying memory layout at the SubX level. Starts</span> +<span id="L50" class="LineNr"> 50 </span><span class="subxComment"># with a '$'.</span> +<span id="L51" class="LineNr"> 51 </span><span class="subxComment"># $int $array $(address _)</span> +<span id="L52" class="LineNr"> 52 </span><span class="subxComment">#</span> +<span id="L53" class="LineNr"> 53 </span><span class="subxComment"># Lisp values are represented in memory by the _cell_ data structure. A cell</span> +<span id="L54" class="LineNr"> 54 </span><span class="subxComment"># is 12 bytes long:</span> +<span id="L55" class="LineNr"> 55 </span><span class="subxComment"># tag: $int (4 bytes; we're not concerned about wasting space)</span> +<span id="L56" class="LineNr"> 56 </span><span class="subxComment"># data: 8 bytes whose contents and meaning depend on tag</span> +<span id="L57" class="LineNr"> 57 </span><span class="subxComment">#</span> +<span id="L58" class="LineNr"> 58 </span><span class="subxComment"># What values of the different Lisp types look like in memory:</span> +<span id="L59" class="LineNr"> 59 </span><span class="subxComment"># - nil: cell{ tag: 0/NIL, data: 0 0 }</span> +<span id="L60" class="LineNr"> 60 </span><span class="subxComment"># - num: cell{ tag: 1/NUM, data: $int 0 }</span> +<span id="L61" class="LineNr"> 61 </span><span class="subxComment"># data contains the number</span> +<span id="L62" class="LineNr"> 62 </span><span class="subxComment"># - char: cell{ tag: 2/CHAR, data: $int 0 }</span> +<span id="L63" class="LineNr"> 63 </span><span class="subxComment"># data contains the utf-8 code of the character (no compound glyphs, no</span> +<span id="L64" class="LineNr"> 64 </span><span class="subxComment"># modifiers, etc., etc.)</span> +<span id="L65" class="LineNr"> 65 </span><span class="subxComment"># - string: cell{ tag: 3/STRING, data: $(address array byte)</span> +<span id="L66" class="LineNr"> 66 </span><span class="subxComment"># data contains an (address array byte) containing the string in utf-8</span> +<span id="L67" class="LineNr"> 67 </span><span class="subxComment"># - symbol: cell{ tag: 4/SYMBOL, data: $(address array byte) 0 }</span> +<span id="L68" class="LineNr"> 68 </span><span class="subxComment"># data contains an (address array byte) containing the name of the symbol in utf-8</span> +<span id="L69" class="LineNr"> 69 </span><span class="subxComment"># alternatively, data could contain an index into the table of interned symbols</span> +<span id="L70" class="LineNr"> 70 </span><span class="subxComment"># - pair: cell{ tag: 5/PAIR, data: $(address cell) $(address cell) }</span> +<span id="L71" class="LineNr"> 71 </span><span class="subxComment"># data contains pointers to car and cdr</span> +<span id="L72" class="LineNr"> 72 </span><span class="subxComment"># - array: cell{ tag: 6/ARRAY, data: $tag $(address array data)</span> +<span id="L73" class="LineNr"> 73 </span><span class="subxComment"># data contains a pointer to an array of 8-byte data fields and the common</span> +<span id="L74" class="LineNr"> 74 </span><span class="subxComment"># tag for them all</span> +<span id="L75" class="LineNr"> 75 </span> +<span id="L76" class="LineNr"> 76 </span><span class="subxFunction">repl</span>: <span class="subxComment"># in : (address buffered-file), out : (address buffered-file) -> <void></span> +<span id="L77" class="LineNr"> 77 </span> <span class="subxS1Comment"># . prolog</span> +<span id="L78" class="LineNr"> 78 </span> 55/push-ebp +<span id="L79" class="LineNr"> 79 </span> 89/<- %ebp 4/r32/esp +<span id="L80" class="LineNr"> 80 </span> <span class="subxS1Comment"># . save registers</span> +<span id="L81" class="LineNr"> 81 </span> 50/push-eax +<span id="L82" class="LineNr"> 82 </span><span class="Constant">$repl:loop</span>: +<span id="L83" class="LineNr"> 83 </span> (lisp-read <span class="SpecialChar"><a href='../061read-byte.subx.html#L14'>Stdin</a></span>) <span class="subxComment"># => eax : (address cell)</span> +<span id="L84" class="LineNr"> 84 </span> <span class="subxComment"># if (eax == 0) break</span> +<span id="L85" class="LineNr"> 85 </span> 3d/compare-eax-and 0/imm32 +<span id="L86" class="LineNr"> 86 </span> 74/jump-if-equal $repl:end/disp8 +<span id="L87" class="LineNr"> 87 </span> <span class="subxComment">#</span> +<span id="L88" class="LineNr"> 88 </span> (lisp-eval %eax) <span class="subxComment"># => eax : (address cell)</span> +<span id="L89" class="LineNr"> 89 </span> (lisp-print <span class="SpecialChar"><a href='../064write-byte.subx.html#L10'>Stdout</a></span> %eax) +<span id="L90" class="LineNr"> 90 </span> <span class="subxComment"># loop</span> +<span id="L91" class="LineNr"> 91 </span> eb/jump $repl:loop/disp8 +<span id="L92" class="LineNr"> 92 </span><span class="Constant">$repl:end</span>: +<span id="L93" class="LineNr"> 93 </span> <span class="subxS1Comment"># . restore registers</span> +<span id="L94" class="LineNr"> 94 </span> 58/pop-to-eax +<span id="L95" class="LineNr"> 95 </span> <span class="subxS1Comment"># . epilog</span> +<span id="L96" class="LineNr"> 96 </span> 89/<- %esp 5/r32/ebp +<span id="L97" class="LineNr"> 97 </span> 5d/pop-to-ebp +<span id="L98" class="LineNr"> 98 </span> c3/return +<span id="L99" class="LineNr"> 99 </span> +<span id="L100" class="LineNr">100 </span><span class="subxComment"># numbers start with a digit and are always in hex</span> +<span id="L101" class="LineNr">101 </span><span class="subxComment"># characters start with a backslash</span> +<span id="L102" class="LineNr">102 </span><span class="subxComment"># pairs start with '('</span> +<span id="L103" class="LineNr">103 </span><span class="subxComment"># arrays start with '['</span> +<span id="L104" class="LineNr">104 </span><span class="subxComment"># symbols start with anything else but quote, backquote, unquote or splice</span> +<span id="L105" class="LineNr">105 </span><span class="subxFunction">lisp-read</span>: <span class="subxComment"># in : (address buffered-file) -> eax : (address cell)</span> +<span id="L106" class="LineNr">106 </span> <span class="subxS1Comment"># . prolog</span> +<span id="L107" class="LineNr">107 </span> 55/push-ebp +<span id="L108" class="LineNr">108 </span> 89/<- %ebp 4/r32/esp +<span id="L109" class="LineNr">109 </span> <span class="subxS1Comment"># . save registers</span> +<span id="L110" class="LineNr">110 </span> <span class="subxComment"># var s/ecx : (address stream) = new-stream(512)</span> +<span id="L111" class="LineNr">111 </span> 81 5/subop/subtract %esp 0x200/imm32 +<span id="L112" class="LineNr">112 </span> 68/push 0x200/imm32/size +<span id="L113" class="LineNr">113 </span> 68/push 0/imm32/read +<span id="L114" class="LineNr">114 </span> 68/push 0/imm32/write +<span id="L115" class="LineNr">115 </span> 89/<- %ecx 4/r32/esp +<span id="L116" class="LineNr">116 </span> <span class="subxComment">#</span> +<span id="L117" class="LineNr">117 </span> (clear-stream %ecx) +<span id="L118" class="LineNr">118 </span> (read-line-buffered *(ebp+8) %ecx) +<span id="L119" class="LineNr">119 </span> <span class="subxComment"># if (s->write == 0) return null</span> +<span id="L120" class="LineNr">120 </span> 81 7/subop/compare *ecx 0/imm32 +<span id="L121" class="LineNr">121 </span> 75/jump-if-not-equal $lisp-read:loop/disp8 +<span id="L122" class="LineNr">122 </span> b8/copy-to-eax 0/imm32/eof +<span id="L123" class="LineNr">123 </span> eb/jump $lisp-read:end/disp8 +<span id="L124" class="LineNr">124 </span><span class="Constant">$lisp-read:loop</span>: +<span id="L125" class="LineNr">125 </span> <span class="subxComment"># return s</span> +<span id="L126" class="LineNr">126 </span> 89/<- %eax 1/r32/ecx +<span id="L127" class="LineNr">127 </span><span class="Constant">$lisp-read:end</span>: +<span id="L128" class="LineNr">128 </span> <span class="subxS1Comment"># . reclaim locals</span> +<span id="L129" class="LineNr">129 </span> 81 0/subop/add %esp 0x20c/imm32 +<span id="L130" class="LineNr">130 </span> <span class="subxS1Comment"># . restore registers</span> +<span id="L131" class="LineNr">131 </span> <span class="subxS1Comment"># . epilog</span> +<span id="L132" class="LineNr">132 </span> 89/<- %esp 5/r32/ebp +<span id="L133" class="LineNr">133 </span> 5d/pop-to-ebp +<span id="L134" class="LineNr">134 </span> c3/return +<span id="L135" class="LineNr">135 </span> +<span id="L136" class="LineNr">136 </span><span class="subxFunction">lisp-eval</span>: <span class="subxComment"># in : (address cell) -> eax : (address cell)</span> +<span id="L137" class="LineNr">137 </span> <span class="subxS1Comment"># . prolog</span> +<span id="L138" class="LineNr">138 </span> 55/push-ebp +<span id="L139" class="LineNr">139 </span> 89/<- %ebp 4/r32/esp +<span id="L140" class="LineNr">140 </span> <span class="subxS1Comment"># . save registers</span> +<span id="L141" class="LineNr">141 </span> 8b/-> *(ebp+8) 0/r32/eax +<span id="L142" class="LineNr">142 </span><span class="Constant">$lisp-eval:end</span>: +<span id="L143" class="LineNr">143 </span> <span class="subxS1Comment"># . restore registers</span> +<span id="L144" class="LineNr">144 </span> <span class="subxS1Comment"># . epilog</span> +<span id="L145" class="LineNr">145 </span> 89/<- %esp 5/r32/ebp +<span id="L146" class="LineNr">146 </span> 5d/pop-to-ebp +<span id="L147" class="LineNr">147 </span> c3/return +<span id="L148" class="LineNr">148 </span> +<span id="L149" class="LineNr">149 </span><span class="subxFunction">lisp-print</span>: <span class="subxComment"># out : (address buffered-file), x : (address cell)</span> +<span id="L150" class="LineNr">150 </span> <span class="subxS1Comment"># . prolog</span> +<span id="L151" class="LineNr">151 </span> 55/push-ebp +<span id="L152" class="LineNr">152 </span> 89/<- %ebp 4/r32/esp +<span id="L153" class="LineNr">153 </span> <span class="subxS1Comment"># . save registers</span> +<span id="L154" class="LineNr">154 </span> <span class="subxComment"># write(x)</span> +<span id="L155" class="LineNr">155 </span> (write-buffered <span class="SpecialChar"><a href='../064write-byte.subx.html#L10'>Stdout</a></span> <span class="Constant">"=> "</span>) +<span id="L156" class="LineNr">156 </span> (write-stream-data <span class="SpecialChar"><a href='../064write-byte.subx.html#L10'>Stdout</a></span> *(ebp+0xc)) +<span id="L157" class="LineNr">157 </span> (flush <span class="SpecialChar"><a href='../064write-byte.subx.html#L10'>Stdout</a></span>) +<span id="L158" class="LineNr">158 </span><span class="Constant">$lisp-print:end</span>: +<span id="L159" class="LineNr">159 </span> <span class="subxS1Comment"># . restore registers</span> +<span id="L160" class="LineNr">160 </span> <span class="subxS1Comment"># . epilog</span> +<span id="L161" class="LineNr">161 </span> 89/<- %esp 5/r32/ebp +<span id="L162" class="LineNr">162 </span> 5d/pop-to-ebp +<span id="L163" class="LineNr">163 </span> c3/return +<span id="L164" class="LineNr">164 </span> +<span id="L165" class="LineNr">165 </span>== data +<span id="L166" class="LineNr">166 </span> +<span id="L167" class="LineNr">167 </span><span class="SpecialChar">Nil</span>: +<span id="L168" class="LineNr">168 </span> 0/imm32/tag +<span id="L169" class="LineNr">169 </span> 0/imm32/data </pre> </body> </html> |