1 | <!DOCTYPE html> <html> <head> <title>ArrayByteIterable.coffee</title> <meta http-equiv="content-type" content="text/html; charset=UTF-8"> <link rel="stylesheet" media="all" href="docco.css" /> </head> <body> <div id="container"> <div id="background"></div> <div id="jump_to"> Jump To … <div id="jump_wrapper"> <div id="jump_page"> <a class="source" href="ByteIterable.html"> ByteIterable.coffee </a> <a class="source" href="ByteIterator.html"> ByteIterator.coffee </a> <a class="source" href="ArrayByteIterable.html"> ArrayByteIterable.coffee </a> <a class="source" href="ByteIterableBase.html"> ByteIterableBase.coffee </a> <a class="source" href="ByteIterableUtil.html"> ByteIterableUtil.coffee </a> <a class="source" href="LightOutputStream.html"> LightOutputStream.coffee </a> <a class="source" href="StoreConfiguration.html"> StoreConfiguration.coffee </a> <a class="source" href="Reader.html"> Reader.coffee </a> <a class="source" href="Writer.html"> Writer.coffee </a> <a class="source" href="List.html"> List.coffee </a> <a class="source" href="ListNode.html"> ListNode.coffee </a> <a class="source" href="Cursor.html"> Cursor.coffee </a> <a class="source" href="DatabaseRoot.html"> DatabaseRoot.coffee </a> <a class="source" href="Environment.html"> Environment.coffee </a> <a class="source" href="EnvironmentConfig.html"> EnvironmentConfig.coffee </a> <a class="source" href="Store.html"> Store.coffee </a> <a class="source" href="Transaction.html"> Transaction.coffee </a> <a class="source" href="Addr64.html"> Addr64.coffee </a> <a class="source" href="DataIterator.html"> DataIterator.coffee </a> <a class="source" href="Log.html"> Log.coffee </a> <a class="source" href="LogCache.html"> LogCache.coffee </a> <a class="source" href="LogConfig.html"> LogConfig.coffee </a> <a class="source" href="LogUtil.html"> LogUtil.coffee </a> <a class="source" href="Loggable.html"> Loggable.coffee </a> <a class="source" href="LoggableFactory.html"> LoggableFactory.coffee </a> <a class="source" href="LoggableIterator.html"> LoggableIterator.coffee </a> <a class="source" href="LoggableToWrite.html"> LoggableToWrite.coffee </a> <a class="source" href="NullLoggable.html"> NullLoggable.coffee </a> <a class="source" href="RandomAccessByteIterable.html"> RandomAccessByteIterable.coffee </a> <a class="source" href="RandomAccessLoggable.html"> RandomAccessLoggable.coffee </a> <a class="source" href="RandomAccessLoggableIterator.html"> RandomAccessLoggableIterator.coffee </a> <a class="source" href="StackList.html"> StackList.coffee </a> <a class="source" href="CompoundByteIterable.html"> CompoundByteIterable.coffee </a> <a class="source" href="CompoundByteIteratorBase.html"> CompoundByteIteratorBase.coffee </a> <a class="source" href="CompressedUnsignedLongByteIterable.html"> CompressedUnsignedLongByteIterable.coffee </a> <a class="source" href="FixedLengthByteIterable.html"> FixedLengthByteIterable.coffee </a> </div> </div> </div> <table cellpadding="0" cellspacing="0"> <thead> <tr> <th class="docs"> <h1> ArrayByteIterable.coffee </h1> </th> <th class="code"> </th> </tr> </thead> <tbody> <tr id="section-1"> <td class="docs"> <div class="pilwrap"> <a class="pilcrow" href="#section-1">¶</a> </div> </td> <td class="code"> <div class="highlight"><pre><span class="nv">fs = </span><span class="nx">require</span> <span class="s1">'fs'</span>
|
2 | <span class="nv">ByteIterableBase = </span><span class="p">(</span><span class="nx">require</span> <span class="s1">'./ByteIterableBase.coffee'</span><span class="p">).</span><span class="nx">ByteIterableBase</span>
|
3 | <span class="nv">ByteIterator = </span><span class="p">(</span><span class="nx">require</span> <span class="s1">'../../ByteIterator.coffee'</span><span class="p">).</span><span class="nx">ByteIterator</span>
|
4 | <span class="nv">UnsupportedOperationError =</span>
|
5 | <span class="p">(</span><span class="nx">require</span> <span class="s1">'../../../errors/UnsupportedOperationError.coffee'</span><span class="p">).</span>
|
6 | <span class="nx">UnsupportedOperationError</span></pre></div> </td> </tr> <tr id="section-2"> <td class="docs"> <div class="pilwrap"> <a class="pilcrow" href="#section-2">¶</a> </div> <p>This class allows working with Buffer as iterable.</p> </td> <td class="code"> <div class="highlight"><pre><span class="k">class</span> <span class="nx">ArrayByteIterable</span> <span class="k">extends</span> <span class="nx">ByteIterableBase</span></pre></div> </td> </tr> <tr id="section-3"> <td class="docs"> <div class="pilwrap"> <a class="pilcrow" href="#section-3">¶</a> </div> <p>Constructor.</p>
|
7 |
|
8 | <p>@param bytes the Buffer with data.
|
9 | @param length the length of Buffer or it's part.</p> </td> <td class="code"> <div class="highlight"><pre> <span class="nx">@create$Buffer</span><span class="nv">$int: </span><span class="nf">(bytes, length, o) -></span>
|
10 | <span class="k">if</span> <span class="o">!</span><span class="nx">o</span><span class="o">?</span> <span class="k">then</span> <span class="nv">o = </span><span class="k">new</span> <span class="nx">ArrayByteIterable</span><span class="p">()</span>
|
11 | <span class="k">if</span> <span class="nx">length</span> <span class="o">==</span> <span class="mi">0</span>
|
12 | <span class="nx">o</span><span class="p">.</span><span class="nx">fillBytes$ByteIterator</span> <span class="nx">ByteIterableBase</span><span class="p">.</span><span class="nx">EMPTY_ITERATOR</span>
|
13 | <span class="k">else</span>
|
14 | <span class="k">if</span> <span class="nx">length</span> <span class="o">==</span> <span class="mi">1</span>
|
15 | <span class="nx">o</span><span class="p">.</span><span class="nx">fillBytes$int$ByteIterator</span> <span class="nx">bytes</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span> <span class="nx">ByteIterableBase</span><span class="p">.</span><span class="nx">EMPTY_ITERATOR</span>
|
16 | <span class="k">else</span>
|
17 | <span class="nv">o.bytes = </span><span class="nx">bytes</span>
|
18 | <span class="nv">o.length = </span><span class="nx">length</span>
|
19 | <span class="k">return</span> <span class="nx">o</span></pre></div> </td> </tr> <tr id="section-4"> <td class="docs"> <div class="pilwrap"> <a class="pilcrow" href="#section-4">¶</a> </div> <p>Constructor.</p>
|
20 |
|
21 | <p>@param bytes the Buffer with data.</p> </td> <td class="code"> <div class="highlight"><pre> <span class="nx">@create</span><span class="nv">$Buffer: </span><span class="nf">(bytes, o) -></span>
|
22 | <span class="k">return</span> <span class="nx">ArrayByteIterable</span><span class="p">.</span><span class="nx">create$Buffer$int</span> <span class="nx">bytes</span><span class="p">,</span> <span class="nx">bytes</span><span class="p">.</span><span class="nx">length</span><span class="p">,</span> <span class="nx">o</span></pre></div> </td> </tr> <tr id="section-5"> <td class="docs"> <div class="pilwrap"> <a class="pilcrow" href="#section-5">¶</a> </div> <p>This class implements iterator for this iterable.</p> </td> <td class="code"> <div class="highlight"><pre> <span class="k">class</span> <span class="nx">Iterator</span> <span class="k">extends</span> <span class="nx">ByteIterator</span></pre></div> </td> </tr> <tr id="section-6"> <td class="docs"> <div class="pilwrap"> <a class="pilcrow" href="#section-6">¶</a> </div> <p>@private</p> </td> <td class="code"> <div class="highlight"><pre> <span class="nv">offs: </span><span class="kc">undefined</span></pre></div> </td> </tr> <tr id="section-7"> <td class="docs"> <div class="pilwrap"> <a class="pilcrow" href="#section-7">¶</a> </div> <p>@private</p> </td> <td class="code"> <div class="highlight"><pre> <span class="nv">obj: </span><span class="kc">undefined</span></pre></div> </td> </tr> <tr id="section-8"> <td class="docs"> <div class="pilwrap"> <a class="pilcrow" href="#section-8">¶</a> </div> <p>Constructor.</p>
|
23 |
|
24 | <p>@param offset.
|
25 | @param obj the object which this iterator is created inside (to get
|
26 | access to it's properties).</p> </td> <td class="code"> <div class="highlight"><pre> <span class="nx">@create</span><span class="nv">$int: </span><span class="p">(</span><span class="nx">offset</span><span class="p">,</span> <span class="nx">obj</span><span class="p">,</span> <span class="nx">o</span><span class="p">)</span> <span class="o">=></span>
|
27 | <span class="k">if</span> <span class="o">!</span><span class="nx">o</span><span class="o">?</span> <span class="k">then</span> <span class="nv">o = </span><span class="k">new</span> <span class="nx">Iterator</span><span class="p">()</span>
|
28 | <span class="nv">o.offs = </span><span class="nx">offset</span>
|
29 | <span class="nv">o.obj = </span><span class="nx">obj</span>
|
30 | <span class="k">return</span> <span class="nx">o</span>
|
31 |
|
32 | <span class="nx">hasNext</span><span class="nv">$emit: </span><span class="p">()</span> <span class="o">=></span>
|
33 | <span class="k">return</span> <span class="nx">@offs</span> <span class="o"><</span> <span class="nx">@obj</span><span class="p">.</span><span class="nx">length</span>
|
34 |
|
35 | <span class="nx">next</span><span class="nv">$emit: </span><span class="p">()</span> <span class="o">=></span>
|
36 | <span class="nv">offset = </span><span class="nx">@offs</span>
|
37 | <span class="nv">result = </span><span class="nx">@obj</span><span class="p">.</span><span class="nx">bytes</span><span class="p">[</span><span class="nx">offset</span><span class="p">]</span>
|
38 | <span class="vi">@offs = </span><span class="nx">offset</span> <span class="o">+</span> <span class="mi">1</span>
|
39 | <span class="k">return</span> <span class="nx">result</span>
|
40 |
|
41 | <span class="nx">skip</span><span class="nv">$int: </span><span class="p">(</span><span class="nx">length</span><span class="p">)</span> <span class="o">=></span>
|
42 | <span class="nv">result = </span><span class="nb">Math</span><span class="p">.</span><span class="nx">min</span> <span class="nx">length</span><span class="p">,</span> <span class="nx">@obj</span><span class="p">.</span><span class="nx">length</span> <span class="o">-</span> <span class="nx">@offs</span>
|
43 | <span class="nx">@offs</span> <span class="o">+=</span> <span class="nx">result</span>
|
44 | <span class="k">return</span> <span class="nx">result</span>
|
45 |
|
46 | <span class="nv">getOffset: </span><span class="nf">() -></span>
|
47 | <span class="k">return</span> <span class="nx">@offs</span></pre></div> </td> </tr> <tr id="section-9"> <td class="docs"> <div class="pilwrap"> <a class="pilcrow" href="#section-9">¶</a> </div> <p>@private
|
48 | This class implements empty array iterable (analogue of zero).</p> </td> <td class="code"> <div class="highlight"><pre> <span class="k">class</span> <span class="nx">EmptyIterable</span> <span class="k">extends</span> <span class="nx">ArrayByteIterable</span></pre></div> </td> </tr> <tr id="section-10"> <td class="docs"> <div class="pilwrap"> <a class="pilcrow" href="#section-10">¶</a> </div> <p>@private</p> </td> <td class="code"> <div class="highlight"><pre> <span class="nv">ITERATOR: </span><span class="kc">undefined</span></pre></div> </td> </tr> <tr id="section-11"> <td class="docs"> <div class="pilwrap"> <a class="pilcrow" href="#section-11">¶</a> </div> <p>@private</p> </td> <td class="code"> <div class="highlight"><pre> <span class="nv">obj: </span><span class="kc">undefined</span></pre></div> </td> </tr> <tr id="section-12"> <td class="docs"> <div class="pilwrap"> <a class="pilcrow" href="#section-12">¶</a> </div> <p>Constructor.</p>
|
49 |
|
50 | <p>@param obj the object which this iterator is created inside (to get
|
51 | access to it's properties).</p> </td> <td class="code"> <div class="highlight"><pre> <span class="vi">@create: </span><span class="nf">(obj, o) -></span>
|
52 | <span class="k">if</span> <span class="o">!</span><span class="nx">o</span><span class="o">?</span> <span class="k">then</span> <span class="nv">o = </span><span class="k">new</span> <span class="nx">EmptyIterable</span><span class="p">()</span>
|
53 | <span class="nv">o = </span><span class="nx">EmptyIterable</span><span class="p">.</span><span class="nx">create$Buffer$int</span> <span class="k">new</span> <span class="nx">Buffer</span><span class="p">(</span><span class="mi">0</span><span class="p">),</span> <span class="mi">0</span><span class="p">,</span> <span class="nx">o</span>
|
54 | <span class="nv">o.obj = </span><span class="nx">obj</span>
|
55 | <span class="nv">o.ITERATOR = </span><span class="nx">Iterator</span><span class="p">.</span><span class="nx">create$int</span> <span class="mi">0</span><span class="p">,</span> <span class="nx">o</span>
|
56 | <span class="k">return</span> <span class="nx">o</span>
|
57 |
|
58 | <span class="nv">getIterator: </span><span class="nf">() -></span>
|
59 | <span class="k">return</span> <span class="nx">@ITERATOR</span>
|
60 |
|
61 | <span class="nx">setBytes</span><span class="nv">$Buffer: </span><span class="nf">(bytes) -></span>
|
62 | <span class="k">throw</span> <span class="k">new</span> <span class="nx">UnsupportedOperationError</span><span class="p">()</span>
|
63 |
|
64 | <span class="vi">@EMPTY: </span><span class="nx">EmptyIterable</span><span class="p">.</span><span class="nx">create</span><span class="p">()</span></pre></div> </td> </tr> <tr id="section-13"> <td class="docs"> <div class="pilwrap"> <a class="pilcrow" href="#section-13">¶</a> </div> <p>Constructor.</p>
|
65 |
|
66 | <p>@param bi another ByteIterable that will be used as a prototype for new one.</p> </td> <td class="code"> <div class="highlight"><pre> <span class="nx">@create</span><span class="nv">$ByteIterable: </span><span class="nf">(bi, o) -></span>
|
67 | <span class="k">if</span> <span class="o">!</span><span class="nx">o</span><span class="o">?</span> <span class="k">then</span> <span class="nv">o = </span><span class="k">new</span> <span class="nx">ArrayByteIterable</span><span class="p">()</span>
|
68 | <span class="nv">length = </span><span class="nx">bi</span><span class="p">.</span><span class="nx">getLength</span><span class="p">()</span>
|
69 | <span class="k">if</span> <span class="nx">length</span> <span class="o">==</span> <span class="mi">0</span>
|
70 | <span class="nx">o</span><span class="p">.</span><span class="nx">fillBytes$ByteIterator</span> <span class="nx">ByteIterableBase</span><span class="p">.</span><span class="nx">EMPTY_ITERATOR</span>
|
71 | <span class="k">else</span>
|
72 | <span class="nv">bytes = </span><span class="nx">bi</span><span class="p">.</span><span class="nx">getBytesUnsafe</span><span class="p">()</span>
|
73 | <span class="k">if</span> <span class="nx">length</span> <span class="o">==</span> <span class="mi">1</span>
|
74 | <span class="nx">o</span><span class="p">.</span><span class="nx">fillBytes$int$ByteIterator</span> <span class="nx">bytes</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span> <span class="nx">ByteIterableBase</span><span class="p">.</span><span class="nx">EMPTY_ITERATOR</span>
|
75 | <span class="k">else</span>
|
76 | <span class="nv">o.length = </span><span class="nx">length</span>
|
77 | <span class="nv">o.bytes = </span><span class="nx">bytes</span>
|
78 | <span class="k">return</span> <span class="nx">o</span></pre></div> </td> </tr> <tr id="section-14"> <td class="docs"> <div class="pilwrap"> <a class="pilcrow" href="#section-14">¶</a> </div> <p>Constructor.</p>
|
79 |
|
80 | <p>@param it ByteIterator of data.</p> </td> <td class="code"> <div class="highlight"><pre> <span class="nx">@create</span><span class="nv">$ByteIterator: </span><span class="nf">(it, o) -></span>
|
81 | <span class="k">if</span> <span class="o">!</span><span class="nx">o</span><span class="o">?</span> <span class="k">then</span> <span class="nv">o = </span><span class="k">new</span> <span class="nx">ArrayByteIterable</span><span class="p">()</span>
|
82 | <span class="nx">o</span><span class="p">.</span><span class="nx">fillBytes$ByteIterator</span> <span class="nx">it</span>
|
83 | <span class="k">return</span> <span class="nx">o</span></pre></div> </td> </tr> <tr id="section-15"> <td class="docs"> <div class="pilwrap"> <a class="pilcrow" href="#section-15">¶</a> </div> <p>Constructor.</p>
|
84 |
|
85 | <p>@param firstByte.
|
86 | @param bi another ByteIterable that will be used as a prototype for new one.</p> </td> <td class="code"> <div class="highlight"><pre> <span class="nx">@create$int</span><span class="nv">$ByteIterable: </span><span class="nf">(firstByte, bi, o) -></span>
|
87 | <span class="k">if</span> <span class="o">!</span><span class="nx">o</span><span class="o">?</span> <span class="k">then</span> <span class="nv">o = </span><span class="k">new</span> <span class="nx">ArrayByteIterable</span><span class="p">()</span>
|
88 | <span class="nx">o</span><span class="p">.</span><span class="nx">fillBytes$int$ByteIterator</span> <span class="nx">firstByte</span><span class="p">,</span> <span class="nx">bi</span><span class="p">.</span><span class="nx">iterator</span><span class="p">()</span>
|
89 | <span class="k">return</span> <span class="nx">o</span></pre></div> </td> </tr> <tr id="section-16"> <td class="docs"> <div class="pilwrap"> <a class="pilcrow" href="#section-16">¶</a> </div> <p>Constructor.</p>
|
90 |
|
91 | <p>@param firstByte.
|
92 | @param it ByteIterator of data.</p> </td> <td class="code"> <div class="highlight"><pre> <span class="nx">@create$int</span><span class="nv">$ByteIterator: </span><span class="nf">(firstByte, it, o) -></span>
|
93 | <span class="k">if</span> <span class="o">!</span><span class="nx">o</span><span class="o">?</span> <span class="k">then</span> <span class="nv">o = </span><span class="k">new</span> <span class="nx">ArrayByteIterable</span><span class="p">()</span>
|
94 | <span class="nx">o</span><span class="p">.</span><span class="nx">fillBytes$int$ByteIterator</span> <span class="nx">firstByte</span><span class="p">,</span> <span class="nx">it</span>
|
95 | <span class="k">return</span> <span class="nx">o</span>
|
96 |
|
97 | <span class="nv">iterator: </span><span class="nf">() -></span>
|
98 | <span class="k">return</span> <span class="nx">@getIterator</span><span class="p">()</span>
|
99 |
|
100 | <span class="nx">iterator</span><span class="nv">$int: </span><span class="nf">(offset) -></span>
|
101 | <span class="k">return</span> <span class="nx">Iterator</span><span class="p">.</span><span class="nx">create$int</span> <span class="nx">offset</span><span class="p">,</span> <span class="k">this</span>
|
102 |
|
103 | <span class="nx">setBytes</span><span class="nv">$Buffer: </span><span class="nf">(bytes) -></span>
|
104 | <span class="vi">@bytes = </span><span class="nx">bytes</span>
|
105 | <span class="vi">@length = </span><span class="nx">bytes</span><span class="p">.</span><span class="nx">length</span>
|
106 |
|
107 | <span class="nv">getBytesUnsafe: </span><span class="nf">() -></span>
|
108 | <span class="k">return</span> <span class="nx">@bytes</span></pre></div> </td> </tr> <tr id="section-17"> <td class="docs"> <div class="pilwrap"> <a class="pilcrow" href="#section-17">¶</a> </div> <p>TODO this method is never used in exodus. What can I do with it?</p> </td> <td class="code"> <div class="highlight"><pre> <span class="nx">writeTo</span><span class="nv">$ByteArrayOutputStream: </span><span class="nf">(output) -></span>
|
109 | <span class="nx">output</span><span class="p">.</span><span class="nx">write</span> <span class="nx">@bytes</span><span class="p">,</span> <span class="mi">0</span><span class="p">,</span> <span class="nx">@length</span>
|
110 |
|
111 | <span class="vi">@getEmptyIterator: </span><span class="nf">() -></span>
|
112 | <span class="k">return</span> <span class="nx">@EMPTY</span><span class="p">.</span><span class="nx">ITERATOR</span></pre></div> </td> </tr> <tr id="section-18"> <td class="docs"> <div class="pilwrap"> <a class="pilcrow" href="#section-18">¶</a> </div> <p>@protected</p> </td> <td class="code"> <div class="highlight"><pre> <span class="nv">getIterator: </span><span class="nf">() -></span>
|
113 | <span class="k">return</span> <span class="nx">Iterator</span><span class="p">.</span><span class="nx">create$int</span> <span class="mi">0</span><span class="p">,</span> <span class="k">this</span></pre></div> </td> </tr> <tr id="section-19"> <td class="docs"> <div class="pilwrap"> <a class="pilcrow" href="#section-19">¶</a> </div> <p>@protected</p> </td> <td class="code"> <div class="highlight"><pre> <span class="nv">fillBytes: </span><span class="nf">() -></span></pre></div> </td> </tr> <tr id="section-20"> <td class="docs"> <div class="pilwrap"> <a class="pilcrow" href="#section-20">¶</a> </div> <p>do nothing</p> </td> <td class="code"> <div class="highlight"><pre><span class="nv">exports.ArrayByteIterable = </span><span class="nx">ArrayByteIterable</span>
|
114 |
|
115 | </pre></div> </td> </tr> </tbody> </table> </div> </body> </html> |
\ | No newline at end of file |