about summary refs log blame commit diff stats
path: root/Manual_tests.md
blob: cde027f9c5b9241d097a54ecec70187fd4b9704a (plain) (tree)
1
2
3
4
5
                                                                            


                                                                              
 













                                                                                                                                    
 


                                                                              
                                                             
 

                                                                                                                                                                                 
                     



                                                                             


                                                                            



                                                                          




                                                                              


                                                                              
 


                                                                              


                                                                             
I care a lot about being able to automatically check _any_ property about my
program before it ever runs. However, some things don't have tests yet, either
because I don't know how to test them or because I've been lazy. I'll at least
record those here.

Startup:
    - terminal log shows unit tests running

Initializing settings:
    - delete app settings, start; window opens running the text editor
    - quit while running the text editor, restart; window opens running the text editor in same position+dimensions
    - quit while editing source (color; no drawings; no selection), restart; window opens editing source in same position+dimensions
    - start out running the text editor, move window, press ctrl+e twice; window is running text editor in same position+dimensions
    - start out editing source, move window, press ctrl+e twice; window is editing source in same position+dimensions
    - no log file; switching to source works

Code loading:
* run love with directory; text editor runs
* run love with zip file; text editor runs

* How the screen looks. Our tests use a level of indirection to check text and
  graphics printed to screen, but not the precise pixels they translate to.
    - where exactly the cursor is drawn to highlight a given character
    - analogously, how a shape precisely looks as you draw it

* start out running the text editor, press ctrl+e to edit source, make a change to the source, press ctrl+e twice to return to the source editor; the change should be preserved.

### Other compromises

Lua is dynamically typed. Tests can't patch over lack of type-checking.

* All strings are UTF-8. Bytes within them are not characters. I try to label
  byte offsets with the suffix `_offset`, and character positions as `_pos`.
  For example, `string.sub` should never use a `_pos` to substring, only an
  `_offset`.

* Some ADT/interface support would be helpful in keeping per-line state in
  sync. Any change to line data should clear line `fragments` and
  `screen_line_starting_pos`.

* Some inputs get processed in love.textinput and some in love.keypressed.
  Several bugs have arisen due to destructive interference between the two for
  some key chord. I wish I could guarantee that the two sets are disjoint. But
  perhaps I'm not thinking about this right.

* Like any high-level language, it's easy to accidentally alias two non-scalar
  variables. I wish there was a way to require copy when assigning.

* I wish I could require pixel coordinates to integers. The editor defensively
  converts input margins to integers.

* My test harness automatically runs `test_*` methods -- but only at the
  top-level. I wish there was a way to raise warnings if someone defines such
  a function inside a dict somewhere.
ik Agaram <vc@akkartik.com> 2018-12-04 12:16:17 -0800 committer Kartik Agaram <vc@akkartik.com> 2018-12-04 12:16:17 -0800 4840' href='/akkartik/mu/commit/html/subx/064write-buffered.subx.html?h=hlt&id=a94b60b5cc217f08e4fd6c949e6af590c55a176b'>a94b60b5 ^
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293



                                                                                          
                                          

                                                

                                                                                                      
                                                 

                       

                                                                                           
                    
                                     
                                
                                  
           
                                
                                  
                                                             

                                                                           
                             
                             















                                                                                 
                                                  















                                                                              
                                                                                                                                                 







                                                                                                                                                                                                                            



















                                                                                                                                                                                                        
                                                                               










































                                                                                                                                                                                                                                                                                                                                                                                                  
                                                                                          
                                                                                                               

                                                                                                                                                                                                                                                                                                                                                                                        





















































                                                                                                                                                                                                                                                                                                                                                                                                     
                                                                                           
                                                                                                                         
                                                                                                   

                                                                                                                                                                                                                                                                                                                                                                                         
                                                                                                










































                                                                                                                                                                                                                                                                                                                                                                                         
                                                                                                                         





                                                                                                                                                                                                                                                                                                                                                                                         
                                                                                                                                                                                                                   










                                                                                                                                                                                                                                                                                                                                                                                                                    
                                                                                                                                                                                                                      










                                                                                                                                                                                                                                                                                                                                                                                            


















                                                                                                                                                          



                                     
<!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 - 065write-buffered.subx</title>
<meta name="Generator" content="Vim/8.1">
<meta name="plugin-version" content="vim8.1_v1">
<meta name="syntax" content="none">
<meta name="settings" content="number_lines,use_css,no_foldcolumn,expand_tabs,line_ids,prevent_copy=">
<meta name="colorscheme" content="minimal-light">
<style type="text/css">
<!--
pre { font-family: monospace; color: #000000; background-color: #c6c6c6; }
body { font-size:12pt; font-family: monospace; color: #000000; background-color: #c6c6c6; }
a { color:inherit; }
* { font-size:12pt; font-size: 1em; }
.subxComment { color: #005faf; }
.subxS2Comment { color: #8a8a8a; }
.LineNr { }
.SpecialChar { color: #d70000; }
.subxS1Comment { color: #0000af; }
.subxFunction { color: #af5f00; text-decoration: underline; }
.Normal { color: #000000; background-color: #c6c6c6; padding-bottom: 1px; }
.subxH1Comment { color: #005faf; text-decoration: underline; }
.Constant { color: #008787; }
.subxTest { color: #5f8700; }
-->
</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;
  }
  var 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();'>
<a href='https://github.com/akkartik/mu/blob/master/065write-buffered.subx'>https://github.com/akkartik/mu/blob/master/065write-buffered.subx</a>
<pre id='vimCodeElement'>
<span id="L1" class="LineNr">  1 </span><span class="subxComment"># write-buffered: like 'write', but for a buffered-file</span>
<span id="L2" class="LineNr">  2 </span>
<span id="L3" class="LineNr">  3 </span>== code
<span id="L4" class="LineNr">  4 </span><span class="subxComment">#   instruction                     effective address                                                   register    displacement    immediate</span>
<span id="L5" class="LineNr">  5 </span><span class="subxS1Comment"># . op          subop               mod             rm32          base        index         scale       r32</span>
<span id="L6" class="LineNr">  6 </span><span class="subxS1Comment"># . 1-3 bytes   3 bits              2 bits          3 bits        3 bits      3 bits        2 bits      2 bits      0/1/2/4 bytes   0/1/2/4 bytes</span>
<span id="L7" class="LineNr">  7 </span>
<span id="L8" class="LineNr">  8 </span><span class="subxFunction">write-buffered</span>:  <span class="subxComment"># f : (address buffered-file), msg : (address array byte) -&gt; &lt;void&gt;</span>
<span id="L9" class="LineNr">  9 </span>    <span class="subxComment"># pseudocode:</span>
<span id="L10" class="LineNr"> 10 </span>    <span class="subxComment">#   in = msg-&gt;data</span>
<span id="L11" class="LineNr"> 11 </span>    <span class="subxComment">#   inend = &amp;msg-&gt;data[msg-&gt;length]</span>
<span id="L12" class="LineNr"> 12 </span>    <span class="subxComment">#   while (in &lt; inend)</span>
<span id="L13" class="LineNr"> 13 </span>    <span class="subxComment">#     if f-&gt;write &gt;= f-&gt;length</span>
<span id="L14" class="LineNr"> 14 </span>    <span class="subxComment">#       flush(f)</span>
<span id="L15" class="LineNr"> 15 </span>    <span class="subxComment">#       clear-stream(f)</span>
<span id="L16" class="LineNr"> 16 </span>    <span class="subxComment">#     c = *in</span>
<span id="L17" class="LineNr"> 17 </span>    <span class="subxComment">#     f-&gt;data[f-&gt;write] = c</span>
<span id="L18" class="LineNr"> 18 </span>    <span class="subxComment">#     ++f-&gt;write</span>
<span id="L19" class="LineNr"> 19 </span>    <span class="subxComment">#     ++in</span>
<span id="L20" class="LineNr"> 20 </span>    <span class="subxComment">#</span>
<span id="L21" class="LineNr"> 21 </span>    <span class="subxComment"># registers:</span>
<span id="L22" class="LineNr"> 22 </span>    <span class="subxComment">#   in: ESI</span>
<span id="L23" class="LineNr"> 23 </span>    <span class="subxComment">#   inend: ECX</span>
<span id="L24" class="LineNr"> 24 </span>    <span class="subxComment">#   f: EDI</span>
<span id="L25" class="LineNr"> 25 </span>    <span class="subxComment">#   f-&gt;length: EDX</span>
<span id="L26" class="LineNr"> 26 </span>    <span class="subxComment">#   f-&gt;write: EBX (cached; need to keep in sync)</span>
<span id="L27" class="LineNr"> 27 </span>    <span class="subxComment">#   c: EAX</span>
<span id="L28" class="LineNr"> 28 </span>    <span class="subxComment">#</span>
<span id="L29" class="LineNr"> 29 </span>    <span class="subxS1Comment"># . prolog</span>
<span id="L30" class="LineNr"> 30 </span>    55/push-EBP
<span id="L31" class="LineNr"> 31 </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="L32" class="LineNr"> 32 </span>    <span class="subxS1Comment"># . save registers</span>
<span id="L33" class="LineNr"> 33 </span>    50/push-EAX
<span id="L34" class="LineNr"> 34 </span>    51/push-ECX
<span id="L35" class="LineNr"> 35 </span>    52/push-EDX
<span id="L36" class="LineNr"> 36 </span>    53/push-EBX
<span id="L37" class="LineNr"> 37 </span>    56/push-ESI
<span id="L38" class="LineNr"> 38 </span>    57/push-EDI
<span id="L39" class="LineNr"> 39 </span>    <span class="subxComment"># EAX = msg</span>
<span id="L40" class="LineNr"> 40 </span>    8b/copy                         1/mod/*+disp8   5/rm32/EBP   <span class="Normal"> . </span>         <span class="Normal"> . </span>                        0/r32/EAX   0xc/disp8      <span class="Normal"> . </span>                <span class="subxComment"># copy *(EBP+12) to EAX</span>
<span id="L41" class="LineNr"> 41 </span>    <span class="subxComment"># in/ESI = msg-&gt;data</span>
<span id="L42" class="LineNr"> 42 </span>    8d/copy-address                 1/mod/*+disp8   0/rm32/EAX   <span class="Normal"> . </span>         <span class="Normal"> . </span>           <span class="Normal"> . </span>          6/r32/ESI   4/disp8        <span class="Normal"> . </span>                <span class="subxComment"># copy EAX+4 to ESI</span>
<span id="L43" class="LineNr"> 43 </span>    <span class="subxComment"># inend/ECX = &amp;msg-&gt;data[msg-&gt;length]</span>
<span id="L44" class="LineNr"> 44 </span>    8b/copy                         0/mod/indirect  0/rm32/EAX   <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"># copy *EAX to ECX</span>
<span id="L45" class="LineNr"> 45 </span>    8d/copy-address                 0/mod/indirect  4/rm32/sib    6/base/ESI  1/index/ECX  <span class="Normal"> . </span>          1/r32/ECX  <span class="Normal"> . </span>             <span class="Normal"> . </span>                <span class="subxComment"># copy ESI+ECX to ECX</span>
<span id="L46" class="LineNr"> 46 </span>    <span class="subxComment"># EDI = f</span>
<span id="L47" class="LineNr"> 47 </span>    8b/copy                         1/mod/*+disp8   5/rm32/EBP   <span class="Normal"> . </span>         <span class="Normal"> . </span>                        7/r32/EDI   8/disp8        <span class="Normal"> . </span>                <span class="subxComment"># copy *(EBP+8) to EDI</span>
<span id="L48" class="LineNr"> 48 </span>    <span class="subxComment"># EDX = f-&gt;length</span>
<span id="L49" class="LineNr"> 49 </span>    8b/copy                         1/mod/*+disp8   7/rm32/EDI   <span class="Normal"> . </span>         <span class="Normal"> . </span>           <span class="Normal"> . </span>          2/r32/EDX   0xc/disp8      <span class="Normal"> . </span>                <span class="subxComment"># copy *(EDI+12) to EDX</span>
<span id="L50" class="LineNr"> 50 </span>    <span class="subxComment"># EBX = f-&gt;write</span>
<span id="L51" class="LineNr"> 51 </span>    8b/copy                         1/mod/*+disp8   7/rm32/EDI   <span class="Normal"> . </span>         <span class="Normal"> . </span>           <span class="Normal"> . </span>          3/r32/EBX   4/disp8        <span class="Normal"> . </span>                <span class="subxComment"># copy *(EDI+4) to EBX</span>
<span id="L52" class="LineNr"> 52 </span><span class="Constant">$write-buffered:loop</span>:
<span id="L53" class="LineNr"> 53 </span>    <span class="subxComment"># if (in &gt;= inend) break</span>
<span id="L54" class="LineNr"> 54 </span>    39/compare                      3/mod/direct    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 ESI with ECX</span>
<span id="L55" class="LineNr"> 55 </span>    73/jump-if-greater-or-equal-unsigned  $write-buffered:loop-end/disp8
<span id="L56" class="LineNr"> 56 </span>    <span class="subxComment"># if (f-&gt;write &gt;= f-&gt;length) flush and clear f's stream</span>
<span id="L57" class="LineNr"> 57 </span>    39/compare                      3/mod/direct    3/rm32/EBX   <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"># compare EBX with EDX</span>
<span id="L58" class="LineNr"> 58 </span>    7c/jump-if-lesser  $write-buffered:to-stream/disp8
<span id="L59" class="LineNr"> 59 </span>    <span class="subxS1Comment"># . persist f-&gt;write</span>
<span id="L60" class="LineNr"> 60 </span>    89/copy                         1/mod/*+disp8   7/rm32/EDI   <span class="Normal"> . </span>         <span class="Normal"> . </span>           <span class="Normal"> . </span>          3/r32/EBX   4/disp8        <span class="Normal"> . </span>                <span class="subxComment"># copy EBX to *(EDI+4)</span>
<span id="L61" class="LineNr"> 61 </span>    <span class="subxS1Comment"># . flush(f)</span>
<span id="L62" class="LineNr"> 62 </span>    <span class="subxS2Comment"># . . push args</span>
<span id="L63" class="LineNr"> 63 </span>    57/push-EDI
<span id="L64" class="LineNr"> 64 </span>    <span class="subxS2Comment"># . . call</span>
<span id="L65" class="LineNr"> 65 </span>    e8/call  <a href='064write-byte.subx.html#L79'>flush</a>/disp32
<span id="L66" class="LineNr"> 66 </span>    <span class="subxS2Comment"># . . discard args</span>
<span id="L67" class="LineNr"> 67 </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="L68" class="LineNr"> 68 </span>    <span class="subxS1Comment"># . clear-stream(stream = f+4)</span>
<span id="L69" class="LineNr"> 69 </span>    <span class="subxS2Comment"># . . push args</span>
<span id="L70" class="LineNr"> 70 </span>    8d/copy-address                 1/mod/*+disp8   7/rm32/EDI   <span class="Normal"> . </span>         <span class="Normal"> . </span>           <span class="Normal"> . </span>          0/r32/EAX   4/disp8        <span class="Normal"> . </span>                <span class="subxComment"># copy EDI+4 to EAX</span>
<span id="L71" class="LineNr"> 71 </span>    50/push-EAX
<span id="L72" class="LineNr"> 72 </span>    <span class="subxS2Comment"># . . call</span>
<span id="L73" class="LineNr"> 73 </span>    e8/call  <a href='055stream.subx.html#L17'>clear-stream</a>/disp32
<span id="L74" class="LineNr"> 74 </span>    <span class="subxS2Comment"># . . discard args</span>
<span id="L75" class="LineNr"> 75 </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="L76" class="LineNr"> 76 </span>    <span class="subxS1Comment"># . f-&gt;write must now be 0; update its cache at EBX</span>
<span id="L77" class="LineNr"> 77 </span>    31/xor                          3/mod/direct    3/rm32/EBX   <span class="Normal"> . </span>         <span class="Normal"> . </span>           <span class="Normal"> . </span>          3/r32/EBX  <span class="Normal"> . </span>             <span class="Normal"> . </span>                <span class="subxComment"># clear EBX</span>
<span id="L78" class="LineNr"> 78 </span><span class="Constant">$write-buffered:to-stream</span>:
<span id="L79" class="LineNr"> 79 </span>    <span class="subxComment"># write to stream</span>
<span id="L80" class="LineNr"> 80 </span>    <span class="subxComment"># f-&gt;data[f-&gt;write] = *in</span>
<span id="L81" class="LineNr"> 81 </span>    <span class="subxS1Comment"># . AL = *in</span>
<span id="L82" class="LineNr"> 82 </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="L83" class="LineNr"> 83 </span>    8a/copy-byte                    0/mod/indirect  6/rm32/ESI   <span class="Normal"> . </span>         <span class="Normal"> . </span>           <span class="Normal"> . </span>          0/r32/AL   <span class="Normal"> . </span>             <span class="Normal"> . </span>                <span class="subxComment"># copy byte at *ESI to AL</span>
<span id="L84" class="LineNr"> 84 </span>    <span class="subxS1Comment"># . f-&gt;data[f-&gt;write] = AL</span>
<span id="L85" class="LineNr"> 85 </span>    88/copy-byte                    1/mod/*+disp8   4/rm32/sib    7/base/EDI  3/index/EBX  <span class="Normal"> . </span>          0/r32/AL    0x10/disp8     <span class="Normal"> . </span>                <span class="subxComment"># copy AL to *(EDI+EBX+16)</span>
<span id="L86" class="LineNr"> 86 </span>    <span class="subxComment"># ++f-&gt;write</span>
<span id="L87" class="LineNr"> 87 </span>    43/increment-EBX
<span id="L88" class="LineNr"> 88 </span>    <span class="subxComment"># ++in</span>
<span id="L89" class="LineNr"> 89 </span>    46/increment-ESI
<span id="L90" class="LineNr"> 90 </span>    eb/jump  $write-buffered:loop/disp8
<span id="L91" class="LineNr"> 91 </span><span class="Constant">$write-buffered:loop-end</span>:
<span id="L92" class="LineNr"> 92 </span>    <span class="subxComment"># persist necessary variables from registers</span>
<span id="L93" class="LineNr"> 93 </span>    89/copy                         1/mod/*+disp8   7/rm32/EDI   <span class="Normal"> . </span>         <span class="Normal"> . </span>           <span class="Normal"> . </span>          3/r32/EBX   4/disp8        <span class="Normal"> . </span>                <span class="subxComment"># copy EBX to *(EDI+4)</span>
<span id="L94" class="LineNr"> 94 </span><span class="Constant">$write-buffered:end</span>:
<span id="L95" class="LineNr"> 95 </span>    <span class="subxS1Comment"># . restore registers</span>
<span id="L96" class="LineNr"> 96 </span>    5f/pop-to-EDI
<span id="L97" class="LineNr"> 97 </span>    5e/pop-to-ESI
<span id="L98" class="LineNr"> 98 </span>    5b/pop-to-EBX
<span id="L99" class="LineNr"> 99 </span>    5a/pop-to-EDX
<span id="L100" class="LineNr">100 </span>    59/pop-to-ECX
<span id="L101" class="LineNr">101 </span>    58/pop-to-EAX
<span id="L102" class="LineNr">102 </span>    <span class="subxS1Comment"># . epilog</span>
<span id="L103" class="LineNr">103 </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="L104" class="LineNr">104 </span>    5d/pop-to-EBP
<span id="L105" class="LineNr">105 </span>    c3/return
<span id="L106" class="LineNr">106 </span>
<span id="L107" class="LineNr">107 </span><span class="subxTest">test-write-buffered</span>:
<span id="L108" class="LineNr">108 </span>    <span class="subxH1Comment"># - check that write-buffered writes to the file</span>
<span id="L109" class="LineNr">109 </span>    <span class="subxComment"># setup</span>
<span id="L110" class="LineNr">110 </span>    <span class="subxS1Comment"># . clear-stream(_test-stream)</span>
<span id="L111" class="LineNr">111 </span>    <span class="subxS2Comment"># . . push args</span>
<span id="L112" class="LineNr">112 </span>    68/push  <a href='057write.subx.html#L148'>_test-stream</a>/imm32
<span id="L113" class="LineNr">113 </span>    <span class="subxS2Comment"># . . call</span>
<span id="L114" class="LineNr">114 </span>    e8/call  <a href='055stream.subx.html#L17'>clear-stream</a>/disp32
<span id="L115" class="LineNr">115 </span>    <span class="subxS2Comment"># . . discard args</span>
<span id="L116" class="LineNr">116 </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="L117" class="LineNr">117 </span>    <span class="subxS1Comment"># . clear-stream(_test-buffered-file+4)</span>
<span id="L118" class="LineNr">118 </span>    <span class="subxS2Comment"># . . push args</span>
<span id="L119" class="LineNr">119 </span>    b8/copy-to-EAX  <a href='061read-byte.subx.html#L281'>_test-buffered-file</a>/imm32
<span id="L120" class="LineNr">120 </span>    05/add-to-EAX  4/imm32
<span id="L121" class="LineNr">121 </span>    50/push-EAX
<span id="L122" class="LineNr">122 </span>    <span class="subxS2Comment"># . . call</span>
<span id="L123" class="LineNr">123 </span>    e8/call  <a href='055stream.subx.html#L17'>clear-stream</a>/disp32
<span id="L124" class="LineNr">124 </span>    <span class="subxS2Comment"># . . discard args</span>
<span id="L125" class="LineNr">125 </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="L126" class="LineNr">126 </span>    <span class="subxComment"># write-buffered(_test-buffered-file, &quot;Abc&quot;)</span>
<span id="L127" class="LineNr">127 </span>    <span class="subxS2Comment"># . . push args</span>
<span id="L128" class="LineNr">128 </span>    68/push  <span class="Constant">&quot;Abc&quot;</span>/imm32
<span id="L129" class="LineNr">129 </span>    68/push  <a href='061read-byte.subx.html#L281'>_test-buffered-file</a>/imm32
<span id="L130" class="LineNr">130 </span>    <span class="subxS2Comment"># . . call</span>
<span id="L131" class="LineNr">131 </span>    e8/call  <a href='065write-buffered.subx.html#L8'>write-buffered</a>/disp32
<span id="L132" class="LineNr">132 </span>    <span class="subxS2Comment"># . . discard args</span>
<span id="L133" class="LineNr">133 </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="L134" class="LineNr">134 </span>    <span class="subxComment"># flush(_test-buffered-file)</span>
<span id="L135" class="LineNr">135 </span>    <span class="subxS2Comment"># . . push args</span>
<span id="L136" class="LineNr">136 </span>    68/push  <a href='061read-byte.subx.html#L281'>_test-buffered-file</a>/imm32
<span id="L137" class="LineNr">137 </span>    <span class="subxS2Comment"># . . call</span>
<span id="L138" class="LineNr">138 </span>    e8/call  <a href='064write-byte.subx.html#L79'>flush</a>/disp32
<span id="L139" class="LineNr">139 </span>    <span class="subxS2Comment"># . . discard args</span>
<span id="L140" class="LineNr">140 </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="L141" class="LineNr">141 </span>    <span class="subxComment"># check-stream-equal(_test-stream, &quot;Abc&quot;, msg)</span>
<span id="L142" class="LineNr">142 </span>    <span class="subxS2Comment"># . . push args</span>
<span id="L143" class="LineNr">143 </span>    68/push  <span class="Constant">&quot;F - test-write-buffered-single&quot;</span>/imm32
<span id="L144" class="LineNr">144 </span>    68/push  <span class="Constant">&quot;Abc&quot;</span>/imm32
<span id="L145" class="LineNr">145 </span>    68/push  <a href='057write.subx.html#L148'>_test-stream</a>/imm32
<span id="L146" class="LineNr">146 </span>    <span class="subxS2Comment"># . . call</span>
<span id="L147" class="LineNr">147 </span>    e8/call  <a href='058stream-equal.subx.html#L193'>check-stream-equal</a>/disp32
<span id="L148" class="LineNr">148 </span>    <span class="subxS2Comment"># . . discard args</span>
<span id="L149" class="LineNr">149 </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="L150" class="LineNr">150 </span>    <span class="subxS1Comment"># . end</span>
<span id="L151" class="LineNr">151 </span>    c3/return
<span id="L152" class="LineNr">152 </span>
<span id="L153" class="LineNr">153 </span><span class="subxTest">test-write-buffered-with-intermediate-flush</span>:
<span id="L154" class="LineNr">154 </span>    <span class="subxH1Comment"># - check that write-buffered flushes in the middle if its buffer fills up</span>
<span id="L155" class="LineNr">155 </span>    <span class="subxComment"># setup</span>
<span id="L156" class="LineNr">156 </span>    <span class="subxS1Comment"># . clear-stream(_test-stream)</span>
<span id="L157" class="LineNr">157 </span>    <span class="subxS2Comment"># . . push args</span>
<span id="L158" class="LineNr">158 </span>    68/push  <a href='057write.subx.html#L148'>_test-stream</a>/imm32
<span id="L159" class="LineNr">159 </span>    <span class="subxS2Comment"># . . call</span>
<span id="L160" class="LineNr">160 </span>    e8/call  <a href='055stream.subx.html#L17'>clear-stream</a>/disp32
<span id="L161" class="LineNr">161 </span>    <span class="subxS2Comment"># . . discard args</span>
<span id="L162" class="LineNr">162 </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="L163" class="LineNr">163 </span>    <span class="subxS1Comment"># . clear-stream(_test-buffered-file+4)</span>
<span id="L164" class="LineNr">164 </span>    <span class="subxS2Comment"># . . push args</span>
<span id="L165" class="LineNr">165 </span>    b8/copy-to-EAX  <a href='061read-byte.subx.html#L281'>_test-buffered-file</a>/imm32
<span id="L166" class="LineNr">166 </span>    05/add-to-EAX  4/imm32
<span id="L167" class="LineNr">167 </span>    50/push-EAX
<span id="L168" class="LineNr">168 </span>    <span class="subxS2Comment"># . . call</span>
<span id="L169" class="LineNr">169 </span>    e8/call  <a href='055stream.subx.html#L17'>clear-stream</a>/disp32
<span id="L170" class="LineNr">170 </span>    <span class="subxS2Comment"># . . discard args</span>
<span id="L171" class="LineNr">171 </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="L172" class="LineNr">172 </span>    <span class="subxComment"># _test-stream can hold 8 bytes, but _test-buffered-file can hold only 6.</span>
<span id="L173" class="LineNr">173 </span>    <span class="subxComment"># Try to write 7 bytes.</span>
<span id="L174" class="LineNr">174 </span>    <span class="subxS1Comment"># . write-buffered(_test-buffered-file, &quot;Abcdefg&quot;)</span>
<span id="L175" class="LineNr">175 </span>    <span class="subxS2Comment"># . . push args</span>
<span id="L176" class="LineNr">176 </span>    68/push  <span class="Constant">&quot;Abcdefg&quot;</span>/imm32
<span id="L177" class="LineNr">177 </span>    68/push  <a href='061read-byte.subx.html#L281'>_test-buffered-file</a>/imm32
<span id="L178" class="LineNr">178 </span>    <span class="subxS2Comment"># . . call</span>
<span id="L179" class="LineNr">179 </span>    e8/call  <a href='065write-buffered.subx.html#L8'>write-buffered</a>/disp32
<span id="L180" class="LineNr">180 </span>    <span class="subxS2Comment"># . . discard args</span>
<span id="L181" class="LineNr">181 </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="L182" class="LineNr">182 </span>    <span class="subxComment"># don't flush</span>
<span id="L183" class="LineNr">183 </span>    <span class="subxComment"># 6 bytes should still have gotten to _test-stream</span>
<span id="L184" class="LineNr">184 </span>    <span class="subxS1Comment"># . check-ints-equal(*_test-stream-&gt;write, 6, msg)</span>
<span id="L185" class="LineNr">185 </span>    <span class="subxS2Comment"># . . push args</span>
<span id="L186" class="LineNr">186 </span>    68/push  <span class="Constant">&quot;F - <a href='065write-buffered.subx.html#L153'>test-write-buffered-with-intermediate-flush</a>: flushed data&quot;</span>/imm32
<span id="L187" class="LineNr">187 </span>    68/push  6/imm32
<span id="L188" class="LineNr">188 </span>    <span class="subxS2Comment"># . . push *_test-stream-&gt;write</span>
<span id="L189" class="LineNr">189 </span>    b8/copy-to-EAX  <a href='057write.subx.html#L148'>_test-stream</a>/imm32
<span id="L190" class="LineNr">190 </span>    ff          6/subop/push        0/mod/indirect  0/rm32/EAX   <span class="Normal"> . </span>         <span class="Normal"> . </span>           <span class="Normal"> . </span>         <span class="Normal"> . </span>         <span class="Normal"> . </span>             <span class="Normal"> . </span>                <span class="subxComment"># push *EAX</span>
<span id="L191" class="LineNr">191 </span>    <span class="subxS2Comment"># . . call</span>
<span id="L192" class="LineNr">192 </span>    e8/call  <a href='051test.subx.html#L24'>check-ints-equal</a>/disp32
<span id="L193" class="LineNr">193 </span>    <span class="subxS2Comment"># . . discard args</span>
<span id="L194" class="LineNr">194 </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="L195" class="LineNr">195 </span>    <span class="subxComment"># and 1 byte should still be in _test-buffered-file</span>
<span id="L196" class="LineNr">196 </span>    <span class="subxS1Comment"># . check-ints-equal(*_test-buffered-file-&gt;write, 1, msg)</span>
<span id="L197" class="LineNr">197 </span>    <span class="subxS2Comment"># . . push args</span>
<span id="L198" class="LineNr">198 </span>    68/push  <span class="Constant">&quot;F - <a href='065write-buffered.subx.html#L153'>test-write-buffered-with-intermediate-flush</a>: unflushed bytes&quot;</span>/imm32
<span id="L199" class="LineNr">199 </span>    68/push  1/imm32
<span id="L200" class="LineNr">200 </span>    <span class="subxS2Comment"># . . push *_test-buffered-file-&gt;write</span>
<span id="L201" class="LineNr">201 </span>    b8/copy-to-EAX  <a href='061read-byte.subx.html#L281'>_test-buffered-file</a>/imm32
<span id="L202" class="LineNr">202 </span>    ff          6/subop/push        1/mod/*+disp8   0/rm32/EAX   <span class="Normal"> . </span>         <span class="Normal"> . </span>           <span class="Normal"> . </span>         <span class="Normal"> . </span>          4/disp8        <span class="Normal"> . </span>                <span class="subxComment"># push *(EAX+4)</span>
<span id="L203" class="LineNr">203 </span>    <span class="subxS2Comment"># . . call</span>
<span id="L204" class="LineNr">204 </span>    e8/call  <a href='051test.subx.html#L24'>check-ints-equal</a>/disp32
<span id="L205" class="LineNr">205 </span>    <span class="subxS2Comment"># . . discard args</span>
<span id="L206" class="LineNr">206 </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="L207" class="LineNr">207 </span>    <span class="subxS1Comment"># . end</span>
<span id="L208" class="LineNr">208 </span>    c3/return
<span id="L209" class="LineNr">209 </span>
<span id="L210" class="LineNr">210 </span>== data
<span id="L211" class="LineNr">211 </span>
<span id="L212" class="LineNr">212 </span><span class="subxComment"># The buffered file for standard error.</span>
<span id="L213" class="LineNr">213 </span><span class="SpecialChar">Stderr</span>:
<span id="L214" class="LineNr">214 </span>    <span class="subxComment"># file descriptor or (address stream)</span>
<span id="L215" class="LineNr">215 </span>    2/imm32  <span class="subxComment"># standard error</span>
<span id="L216" class="LineNr">216 </span>    <span class="subxComment"># current write index</span>
<span id="L217" class="LineNr">217 </span>    0/imm32
<span id="L218" class="LineNr">218 </span>    <span class="subxComment"># current read index</span>
<span id="L219" class="LineNr">219 </span>    0/imm32
<span id="L220" class="LineNr">220 </span>    <span class="subxComment"># length</span>
<span id="L221" class="LineNr">221 </span>    8/imm32
<span id="L222" class="LineNr">222 </span>    <span class="subxComment"># data</span>
<span id="L223" class="LineNr">223 </span>    00 00 00 00 00 00 00 00  <span class="subxComment"># 8 bytes</span>
<span id="L224" class="LineNr">224 </span>
<span id="L225" class="LineNr">225 </span><span class="subxComment"># TODO: 8 bytes is too small. We'll need to grow the buffer for efficiency. But</span>
<span id="L226" class="LineNr">226 </span><span class="subxComment"># I don't want to type in 1024 bytes here.</span>
<span id="L227" class="LineNr">227 </span>
<span id="L228" class="LineNr">228 </span><span class="subxS2Comment"># . . vim&#0058;nowrap:textwidth=0</span>
</pre>
</body>
</html>
<!-- vim: set foldmethod=manual : -->