diff options
Diffstat (limited to 'html/subx/071read-line.subx.html')
| -rw-r--r-- | html/subx/071read-line.subx.html | 173 |
1 files changed, 172 insertions, 1 deletions
diff --git a/html/subx/071read-line.subx.html b/html/subx/071read-line.subx.html index c407529b..4168a5a8 100644 --- a/html/subx/071read-line.subx.html +++ b/html/subx/071read-line.subx.html @@ -277,7 +277,178 @@ if ('onhashchange' in window) { <span id="L217" class="LineNr">217 </span> <span class="subxComment"># end</span> <span id="L218" class="LineNr">218 </span> c3/return <span id="L219" class="LineNr">219 </span> -<span id="L220" class="LineNr">220 </span><span class="subxS2Comment"># . . vim:nowrap:textwidth=0</span> +<span id="L220" class="LineNr">220 </span><span class="subxComment"># read bytes from 'f' until (and including) a newline and store them into 's'</span> +<span id="L221" class="LineNr">221 </span><span class="subxComment"># 's' fails to grow if and only if no data found</span> +<span id="L222" class="LineNr">222 </span><span class="subxComment"># just abort if 's' is too small</span> +<span id="L223" class="LineNr">223 </span><span class="subxFunction">read-line</span>: <span class="subxComment"># f : (address stream), s : (address stream byte) -> <void></span> +<span id="L224" class="LineNr">224 </span> <span class="subxComment"># pseudocode:</span> +<span id="L225" class="LineNr">225 </span> <span class="subxComment"># while true</span> +<span id="L226" class="LineNr">226 </span> <span class="subxComment"># if (s->write >= s->length) abort</span> +<span id="L227" class="LineNr">227 </span> <span class="subxComment"># if (f->read >= f->write) break</span> +<span id="L228" class="LineNr">228 </span> <span class="subxComment"># AL = f->data[f->read]</span> +<span id="L229" class="LineNr">229 </span> <span class="subxComment"># s->data[s->write] = AL</span> +<span id="L230" class="LineNr">230 </span> <span class="subxComment"># ++f->read</span> +<span id="L231" class="LineNr">231 </span> <span class="subxComment"># ++s->write</span> +<span id="L232" class="LineNr">232 </span> <span class="subxComment"># if (AL == '\n') break</span> +<span id="L233" class="LineNr">233 </span> <span class="subxS1Comment"># . prolog</span> +<span id="L234" class="LineNr">234 </span> 55/push-EBP +<span id="L235" class="LineNr">235 </span> 89/copy 3/mod/direct 5/rm32/EBP <span class="Normal"> . </span> <span class="Normal"> . </span> <span class="Normal"> . </span> 4/r32/ESP <span class="Normal"> . </span> <span class="Normal"> . </span> <span class="subxComment"># copy ESP to EBP</span> +<span id="L236" class="LineNr">236 </span> <span class="subxS1Comment"># . save registers</span> +<span id="L237" class="LineNr">237 </span> 50/push-EAX +<span id="L238" class="LineNr">238 </span> 51/push-ECX +<span id="L239" class="LineNr">239 </span> 52/push-EDX +<span id="L240" class="LineNr">240 </span> 56/push-ESI +<span id="L241" class="LineNr">241 </span> 57/push-EDI +<span id="L242" class="LineNr">242 </span> <span class="subxComment"># ESI = f</span> +<span id="L243" class="LineNr">243 </span> 8b/copy 1/mod/*+disp8 5/rm32/EBP <span class="Normal"> . </span> <span class="Normal"> . </span> <span class="Normal"> . </span> 6/r32/ESI 8/disp8 <span class="Normal"> . </span> <span class="subxComment"># copy *(EBP+8) to ESI</span> +<span id="L244" class="LineNr">244 </span> <span class="subxComment"># ECX = f->read</span> +<span id="L245" class="LineNr">245 </span> 8b/copy 1/mod/*+disp8 6/rm32/ESI <span class="Normal"> . </span> <span class="Normal"> . </span> <span class="Normal"> . </span> 1/r32/ECX 4/disp8 <span class="Normal"> . </span> <span class="subxComment"># copy *(ESI+4) to ECX</span> +<span id="L246" class="LineNr">246 </span> <span class="subxComment"># EDI = s</span> +<span id="L247" class="LineNr">247 </span> 8b/copy 1/mod/*+disp8 5/rm32/EBP <span class="Normal"> . </span> <span class="Normal"> . </span> <span class="Normal"> . </span> 7/r32/EDI 0xc/disp8 <span class="Normal"> . </span> <span class="subxComment"># copy *(EBP+12) to EDI</span> +<span id="L248" class="LineNr">248 </span> <span class="subxComment"># EDX = s->write</span> +<span id="L249" class="LineNr">249 </span> 8b/copy 0/mod/indirect 7/rm32/EDI <span class="Normal"> . </span> <span class="Normal"> . </span> <span class="Normal"> . </span> 2/r32/EDX <span class="Normal"> . </span> <span class="Normal"> . </span> <span class="subxComment"># copy *EDI to EDX</span> +<span id="L250" class="LineNr">250 </span><span class="Constant">$read-line:loop</span>: +<span id="L251" class="LineNr">251 </span> <span class="subxComment"># if (s->write >= s->length) abort</span> +<span id="L252" class="LineNr">252 </span> 3b/compare 1/mod/*+disp8 7/rm32/EDI <span class="Normal"> . </span> <span class="Normal"> . </span> <span class="Normal"> . </span> 2/r32/EDX 8/disp8 <span class="Normal"> . </span> <span class="subxComment"># compare EDX with *(EDI+8)</span> +<span id="L253" class="LineNr">253 </span> 0f 8d/jump-if-greater-or-equal $read-line:abort/disp32 +<span id="L254" class="LineNr">254 </span> <span class="subxComment"># if (f->read >= f->write) break</span> +<span id="L255" class="LineNr">255 </span> 3b/compare 0/mod/indirect 6/rm32/ESI <span class="Normal"> . </span> <span class="Normal"> . </span> <span class="Normal"> . </span> 1/r32/ECX <span class="Normal"> . </span> <span class="Normal"> . </span> <span class="subxComment"># compare ECX with *ESI</span> +<span id="L256" class="LineNr">256 </span> 7d/jump-if-greater-or-equal $read-line:end/disp8 +<span id="L257" class="LineNr">257 </span> <span class="subxComment"># AL = f->data[f->read]</span> +<span id="L258" class="LineNr">258 </span> 31/xor 3/mod/direct 0/rm32/EAX <span class="Normal"> . </span> <span class="Normal"> . </span> <span class="Normal"> . </span> 0/r32/EAX <span class="Normal"> . </span> <span class="Normal"> . </span> <span class="subxComment"># clear EAX</span> +<span id="L259" class="LineNr">259 </span> 8a/copy-byte 1/mod/*+disp8 4/rm32/sib 6/base/ESI 1/index/ECX <span class="Normal"> . </span> 0/r32/AL 0xc/disp8 <span class="Normal"> . </span> <span class="subxComment"># copy byte at *(ESI+ECX+12) to AL</span> +<span id="L260" class="LineNr">260 </span> <span class="subxComment"># s->data[s->write] = AL</span> +<span id="L261" class="LineNr">261 </span> 88/copy-byte 1/mod/*+disp8 4/rm32/sib 7/base/EDI 2/index/EDX <span class="Normal"> . </span> 0/r32/AL 0xc/disp8 <span class="Normal"> . </span> <span class="subxComment"># copy AL to *(EDI+EDX+12)</span> +<span id="L262" class="LineNr">262 </span> <span class="subxComment"># ++f->read</span> +<span id="L263" class="LineNr">263 </span> 41/increment-ECX +<span id="L264" class="LineNr">264 </span> <span class="subxComment"># ++s->write</span> +<span id="L265" class="LineNr">265 </span> 42/increment-EDX +<span id="L266" class="LineNr">266 </span> <span class="subxComment"># if (AL == '\n') return</span> +<span id="L267" class="LineNr">267 </span> 3d/compare-EAX-and 0xa/imm32 +<span id="L268" class="LineNr">268 </span> 0f 85/jump-if-not-equal $read-line:loop/disp32 +<span id="L269" class="LineNr">269 </span><span class="Constant">$read-line:end</span>: +<span id="L270" class="LineNr">270 </span> <span class="subxComment"># save f->read</span> +<span id="L271" class="LineNr">271 </span> 89/copy 1/mod/*+disp8 6/rm32/ESI <span class="Normal"> . </span> <span class="Normal"> . </span> <span class="Normal"> . </span> 1/r32/ECX 4/disp8 <span class="Normal"> . </span> <span class="subxComment"># copy ECX to *(ESI+4)</span> +<span id="L272" class="LineNr">272 </span> <span class="subxComment"># save s->write</span> +<span id="L273" class="LineNr">273 </span> 89/copy 0/mod/indirect 7/rm32/EDI <span class="Normal"> . </span> <span class="Normal"> . </span> <span class="Normal"> . </span> 2/r32/EDX <span class="Normal"> . </span> <span class="Normal"> . </span> <span class="subxComment"># copy EDX to *EDI</span> +<span id="L274" class="LineNr">274 </span> <span class="subxS1Comment"># . restore registers</span> +<span id="L275" class="LineNr">275 </span> 5f/pop-to-EDI +<span id="L276" class="LineNr">276 </span> 5e/pop-to-ESI +<span id="L277" class="LineNr">277 </span> 5a/pop-to-EDX +<span id="L278" class="LineNr">278 </span> 59/pop-to-ECX +<span id="L279" class="LineNr">279 </span> 58/pop-to-EAX +<span id="L280" class="LineNr">280 </span> <span class="subxS1Comment"># . epilog</span> +<span id="L281" class="LineNr">281 </span> 89/copy 3/mod/direct 4/rm32/ESP <span class="Normal"> . </span> <span class="Normal"> . </span> <span class="Normal"> . </span> 5/r32/EBP <span class="Normal"> . </span> <span class="Normal"> . </span> <span class="subxComment"># copy EBP to ESP</span> +<span id="L282" class="LineNr">282 </span> 5d/pop-to-EBP +<span id="L283" class="LineNr">283 </span> c3/return +<span id="L284" class="LineNr">284 </span> +<span id="L285" class="LineNr">285 </span><span class="Constant">$read-line:abort</span>: +<span id="L286" class="LineNr">286 </span> <span class="subxS1Comment"># . _write(2/stderr, error)</span> +<span id="L287" class="LineNr">287 </span> <span class="subxS2Comment"># . . push args</span> +<span id="L288" class="LineNr">288 </span> 68/push <span class="Constant">"read-line: line too long\n"</span>/imm32 +<span id="L289" class="LineNr">289 </span> 68/push 2/imm32/stderr +<span id="L290" class="LineNr">290 </span> <span class="subxS2Comment"># . . call</span> +<span id="L291" class="LineNr">291 </span> e8/call <a href='050_write.subx.html#L14'>_write</a>/disp32 +<span id="L292" class="LineNr">292 </span> <span class="subxS2Comment"># . . discard args</span> +<span id="L293" class="LineNr">293 </span> 81 0/subop/add 3/mod/direct 4/rm32/ESP <span class="Normal"> . </span> <span class="Normal"> . </span> <span class="Normal"> . </span> <span class="Normal"> . </span> <span class="Normal"> . </span> 8/imm32 <span class="subxComment"># add to ESP</span> +<span id="L294" class="LineNr">294 </span> <span class="subxS1Comment"># . syscall(exit, 1)</span> +<span id="L295" class="LineNr">295 </span> bb/copy-to-EBX 1/imm32 +<span id="L296" class="LineNr">296 </span> b8/copy-to-EAX 1/imm32/exit +<span id="L297" class="LineNr">297 </span> cd/syscall 0x80/imm8 +<span id="L298" class="LineNr">298 </span> <span class="subxComment"># never gets here</span> +<span id="L299" class="LineNr">299 </span> +<span id="L300" class="LineNr">300 </span><span class="subxTest">test-read-line</span>: +<span id="L301" class="LineNr">301 </span> <span class="subxH1Comment"># - check that read-line stops at a newline</span> +<span id="L302" class="LineNr">302 </span> <span class="subxComment"># setup</span> +<span id="L303" class="LineNr">303 </span> <span class="subxS1Comment"># . clear-stream(_test-stream)</span> +<span id="L304" class="LineNr">304 </span> <span class="subxS2Comment"># . . push args</span> +<span id="L305" class="LineNr">305 </span> 68/push <a href='057write.subx.html#L148'>_test-stream</a>/imm32 +<span id="L306" class="LineNr">306 </span> <span class="subxS2Comment"># . . call</span> +<span id="L307" class="LineNr">307 </span> e8/call <a href='055stream.subx.html#L17'>clear-stream</a>/disp32 +<span id="L308" class="LineNr">308 </span> <span class="subxS2Comment"># . . discard args</span> +<span id="L309" class="LineNr">309 </span> 81 0/subop/add 3/mod/direct 4/rm32/ESP <span class="Normal"> . </span> <span class="Normal"> . </span> <span class="Normal"> . </span> <span class="Normal"> . </span> <span class="Normal"> . </span> 4/imm32 <span class="subxComment"># add to ESP</span> +<span id="L310" class="LineNr">310 </span> <span class="subxS1Comment"># . clear-stream(_test-tmp-stream)</span> +<span id="L311" class="LineNr">311 </span> <span class="subxS2Comment"># . . push args</span> +<span id="L312" class="LineNr">312 </span> 68/push <a href='060read.subx.html#L430'>_test-tmp-stream</a>/imm32 +<span id="L313" class="LineNr">313 </span> <span class="subxS2Comment"># . . call</span> +<span id="L314" class="LineNr">314 </span> e8/call <a href='055stream.subx.html#L17'>clear-stream</a>/disp32 +<span id="L315" class="LineNr">315 </span> <span class="subxS2Comment"># . . discard args</span> +<span id="L316" class="LineNr">316 </span> 81 0/subop/add 3/mod/direct 4/rm32/ESP <span class="Normal"> . </span> <span class="Normal"> . </span> <span class="Normal"> . </span> <span class="Normal"> . </span> <span class="Normal"> . </span> 4/imm32 <span class="subxComment"># add to ESP</span> +<span id="L317" class="LineNr">317 </span> <span class="subxComment"># write(_test-stream, "ab\ncd")</span> +<span id="L318" class="LineNr">318 </span> <span class="subxS2Comment"># . . push args</span> +<span id="L319" class="LineNr">319 </span> 68/push <span class="Constant">"ab\ncd"</span>/imm32 +<span id="L320" class="LineNr">320 </span> 68/push <a href='057write.subx.html#L148'>_test-stream</a>/imm32 +<span id="L321" class="LineNr">321 </span> <span class="subxS2Comment"># . . call</span> +<span id="L322" class="LineNr">322 </span> e8/call <a href='057write.subx.html#L24'>write</a>/disp32 +<span id="L323" class="LineNr">323 </span> <span class="subxS2Comment"># . . discard args</span> +<span id="L324" class="LineNr">324 </span> 81 0/subop/add 3/mod/direct 4/rm32/ESP <span class="Normal"> . </span> <span class="Normal"> . </span> <span class="Normal"> . </span> <span class="Normal"> . </span> <span class="Normal"> . </span> 8/imm32 <span class="subxComment"># add to ESP</span> +<span id="L325" class="LineNr">325 </span> <span class="subxComment"># read a line from _test-stream into _test-tmp-stream</span> +<span id="L326" class="LineNr">326 </span> <span class="subxS1Comment"># . EAX = read-line(_test-stream, _test-tmp-stream)</span> +<span id="L327" class="LineNr">327 </span> <span class="subxS2Comment"># . . push args</span> +<span id="L328" class="LineNr">328 </span> 68/push <a href='060read.subx.html#L430'>_test-tmp-stream</a>/imm32 +<span id="L329" class="LineNr">329 </span> 68/push <a href='057write.subx.html#L148'>_test-stream</a>/imm32 +<span id="L330" class="LineNr">330 </span> <span class="subxS2Comment"># . . call</span> +<span id="L331" class="LineNr">331 </span> e8/call <a href='071read-line.subx.html#L223'>read-line</a>/disp32 +<span id="L332" class="LineNr">332 </span> <span class="subxS2Comment"># . . discard args</span> +<span id="L333" class="LineNr">333 </span> 81 0/subop/add 3/mod/direct 4/rm32/ESP <span class="Normal"> . </span> <span class="Normal"> . </span> <span class="Normal"> . </span> <span class="Normal"> . </span> <span class="Normal"> . </span> 8/imm32 <span class="subxComment"># add to ESP</span> +<span id="L334" class="LineNr">334 </span> <span class="subxComment"># check-next-stream-line-equal(_test-tmp-stream, "ab", msg)</span> +<span id="L335" class="LineNr">335 </span> <span class="subxS2Comment"># . . push args</span> +<span id="L336" class="LineNr">336 </span> 68/push <span class="Constant">"F - test-read-line"</span>/imm32 +<span id="L337" class="LineNr">337 </span> 68/push <span class="Constant">"ab"</span>/imm32 +<span id="L338" class="LineNr">338 </span> 68/push <a href='060read.subx.html#L430'>_test-tmp-stream</a>/imm32 +<span id="L339" class="LineNr">339 </span> <span class="subxS2Comment"># . . call</span> +<span id="L340" class="LineNr">340 </span> e8/call <a href='058stream-equal.subx.html#L563'>check-next-stream-line-equal</a>/disp32 +<span id="L341" class="LineNr">341 </span> <span class="subxS2Comment"># . . discard args</span> +<span id="L342" class="LineNr">342 </span> 81 0/subop/add 3/mod/direct 4/rm32/ESP <span class="Normal"> . </span> <span class="Normal"> . </span> <span class="Normal"> . </span> <span class="Normal"> . </span> <span class="Normal"> . </span> 0xc/imm32 <span class="subxComment"># add to ESP</span> +<span id="L343" class="LineNr">343 </span> <span class="subxComment"># end</span> +<span id="L344" class="LineNr">344 </span> c3/return +<span id="L345" class="LineNr">345 </span> +<span id="L346" class="LineNr">346 </span><span class="subxTest">test-read-line-reads-final-line-until-Eof</span>: +<span id="L347" class="LineNr">347 </span> <span class="subxComment"># setup</span> +<span id="L348" class="LineNr">348 </span> <span class="subxS1Comment"># . clear-stream(_test-stream)</span> +<span id="L349" class="LineNr">349 </span> <span class="subxS2Comment"># . . push args</span> +<span id="L350" class="LineNr">350 </span> 68/push <a href='057write.subx.html#L148'>_test-stream</a>/imm32 +<span id="L351" class="LineNr">351 </span> <span class="subxS2Comment"># . . call</span> +<span id="L352" class="LineNr">352 </span> e8/call <a href='055stream.subx.html#L17'>clear-stream</a>/disp32 +<span id="L353" class="LineNr">353 </span> <span class="subxS2Comment"># . . discard args</span> +<span id="L354" class="LineNr">354 </span> 81 0/subop/add 3/mod/direct 4/rm32/ESP <span class="Normal"> . </span> <span class="Normal"> . </span> <span class="Normal"> . </span> <span class="Normal"> . </span> <span class="Normal"> . </span> 4/imm32 <span class="subxComment"># add to ESP</span> +<span id="L355" class="LineNr">355 </span> <span class="subxS1Comment"># . clear-stream(_test-tmp-stream)</span> +<span id="L356" class="LineNr">356 </span> <span class="subxS2Comment"># . . push args</span> +<span id="L357" class="LineNr">357 </span> 68/push <a href='060read.subx.html#L430'>_test-tmp-stream</a>/imm32 +<span id="L358" class="LineNr">358 </span> <span class="subxS2Comment"># . . call</span> +<span id="L359" class="LineNr">359 </span> e8/call <a href='055stream.subx.html#L17'>clear-stream</a>/disp32 +<span id="L360" class="LineNr">360 </span> <span class="subxS2Comment"># . . discard args</span> +<span id="L361" class="LineNr">361 </span> 81 0/subop/add 3/mod/direct 4/rm32/ESP <span class="Normal"> . </span> <span class="Normal"> . </span> <span class="Normal"> . </span> <span class="Normal"> . </span> <span class="Normal"> . </span> 4/imm32 <span class="subxComment"># add to ESP</span> +<span id="L362" class="LineNr">362 </span> <span class="subxComment"># write(_test-stream, "cd")</span> +<span id="L363" class="LineNr">363 </span> <span class="subxS2Comment"># . . push args</span> +<span id="L364" class="LineNr">364 </span> 68/push <span class="Constant">"cd"</span>/imm32 +<span id="L365" class="LineNr">365 </span> 68/push <a href='057write.subx.html#L148'>_test-stream</a>/imm32 +<span id="L366" class="LineNr">366 </span> <span class="subxS2Comment"># . . call</span> +<span id="L367" class="LineNr">367 </span> e8/call <a href='057write.subx.html#L24'>write</a>/disp32 +<span id="L368" class="LineNr">368 </span> <span class="subxS2Comment"># . . discard args</span> +<span id="L369" class="LineNr">369 </span> 81 0/subop/add 3/mod/direct 4/rm32/ESP <span class="Normal"> . </span> <span class="Normal"> . </span> <span class="Normal"> . </span> <span class="Normal"> . </span> <span class="Normal"> . </span> 8/imm32 <span class="subxComment"># add to ESP</span> +<span id="L370" class="LineNr">370 </span> <span class="subxComment"># read a line from _test-stream into _test-tmp-stream</span> +<span id="L371" class="LineNr">371 </span> <span class="subxS1Comment"># . EAX = read-line(_test-stream, _test-tmp-stream)</span> +<span id="L372" class="LineNr">372 </span> <span class="subxS2Comment"># . . push args</span> +<span id="L373" class="LineNr">373 </span> 68/push <a href='060read.subx.html#L430'>_test-tmp-stream</a>/imm32 +<span id="L374" class="LineNr">374 </span> 68/push <a href='057write.subx.html#L148'>_test-stream</a>/imm32 +<span id="L375" class="LineNr">375 </span> <span class="subxS2Comment"># . . call</span> +<span id="L376" class="LineNr">376 </span> e8/call <a href='071read-line.subx.html#L223'>read-line</a>/disp32 +<span id="L377" class="LineNr">377 </span> <span class="subxS2Comment"># . . discard args</span> +<span id="L378" class="LineNr">378 </span> 81 0/subop/add 3/mod/direct 4/rm32/ESP <span class="Normal"> . </span> <span class="Normal"> . </span> <span class="Normal"> . </span> <span class="Normal"> . </span> <span class="Normal"> . </span> 8/imm32 <span class="subxComment"># add to ESP</span> +<span id="L379" class="LineNr">379 </span> <span class="subxComment"># check-stream-equal(_test-tmp-stream, "cd", msg)</span> +<span id="L380" class="LineNr">380 </span> <span class="subxS2Comment"># . . push args</span> +<span id="L381" class="LineNr">381 </span> 68/push <span class="Constant">"F - test-read-line-reads-final-line-until-Eof"</span>/imm32 +<span id="L382" class="LineNr">382 </span> 68/push <span class="Constant">"cd"</span>/imm32 +<span id="L383" class="LineNr">383 </span> 68/push <a href='060read.subx.html#L430'>_test-tmp-stream</a>/imm32 +<span id="L384" class="LineNr">384 </span> <span class="subxS2Comment"># . . call</span> +<span id="L385" class="LineNr">385 </span> e8/call <a href='058stream-equal.subx.html#L193'>check-stream-equal</a>/disp32 +<span id="L386" class="LineNr">386 </span> <span class="subxS2Comment"># . . discard args</span> +<span id="L387" class="LineNr">387 </span> 81 0/subop/add 3/mod/direct 4/rm32/ESP <span class="Normal"> . </span> <span class="Normal"> . </span> <span class="Normal"> . </span> <span class="Normal"> . </span> <span class="Normal"> . </span> 0xc/imm32 <span class="subxComment"># add to ESP</span> +<span id="L388" class="LineNr">388 </span> <span class="subxComment"># end</span> +<span id="L389" class="LineNr">389 </span> c3/return +<span id="L390" class="LineNr">390 </span> +<span id="L391" class="LineNr">391 </span><span class="subxS2Comment"># . . vim:nowrap:textwidth=0</span> </pre> </body> </html> |