| 1 | <!DOCTYPE html> <html> <head> <title>ByteIterableBase.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> ByteIterableBase.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">ByteIterable = </span><span class="nx">require</span><span class="p">(</span><span class="s1">'../../ByteIterable.coffee'</span><span class="p">).</span><span class="nx">ByteIterable</span>
|
| 3 | <span class="nv">ByteIterableUtil = </span><span class="nx">require</span><span class="p">(</span><span class="s1">'./ByteIterableUtil.coffee'</span><span class="p">).</span><span class="nx">ByteIterableUtil</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 absract class implements common methods for iterables.</p> </td> <td class="code"> <div class="highlight"><pre><span class="k">class</span> <span class="nx">ByteIterableBase</span> <span class="k">extends</span> <span class="nx">ByteIterable</span></pre></div> </td> </tr> <tr id="section-3"> <td class="docs"> <div class="pilwrap"> <a class="pilcrow" href="#section-3">¶</a> </div> <p>@private</p> </td> <td class="code"> <div class="highlight"><pre> <span class="nv">bytes: </span><span class="kc">undefined</span></pre></div> </td> </tr> <tr id="section-4"> <td class="docs"> <div class="pilwrap"> <a class="pilcrow" href="#section-4">¶</a> </div> <p>@private</p> </td> <td class="code"> <div class="highlight"><pre> <span class="nv">length: </span><span class="kc">undefined</span></pre></div> </td> </tr> <tr id="section-5"> <td class="docs"> <div class="pilwrap"> <a class="pilcrow" href="#section-5">¶</a> </div> <p>@private</p> </td> <td class="code"> <div class="highlight"><pre> <span class="vi">@singleBytes: </span><span class="kc">undefined</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
|
| 4 | Function that returns array of arrays with single bytes from 0 to 255.</p> </td> <td class="code"> <div class="highlight"><pre> <span class="vi">@SINGLE_BYTES: </span><span class="nf">() -></span>
|
| 5 | <span class="k">if</span> <span class="o">!</span><span class="nx">ByteIterableBase</span><span class="p">.</span><span class="nx">singleBytes</span><span class="o">?</span>
|
| 6 | <span class="nv">ByteIterableBase.singleBytes = </span><span class="k">new</span> <span class="nb">Array</span> <span class="mi">256</span>
|
| 7 | <span class="k">for</span> <span class="nx">i</span> <span class="k">in</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">singleBytes</span><span class="p">.</span><span class="nx">length</span> <span class="o">-</span> <span class="mi">1</span><span class="p">]</span>
|
| 8 | <span class="nx">ByteIterableBase</span><span class="p">.</span><span class="nx">singleBytes</span><span class="p">[</span><span class="nx">i</span><span class="p">]</span> <span class="o">=</span> <span class="k">new</span> <span class="nx">Buffer</span><span class="p">([</span><span class="nx">i</span><span class="p">])</span>
|
| 9 | <span class="k">return</span> <span class="nx">ByteIterableBase</span><span class="p">.</span><span class="nx">singleBytes</span></pre></div> </td> </tr> <tr id="section-7"> <td class="docs"> <div class="pilwrap"> <a class="pilcrow" href="#section-7">¶</a> </div> <p>Compares two iterables.</p>
|
| 10 |
|
| 11 | <p>@param o the second iterable.
|
| 12 | @return number (see ByteIterableUtil.compare$ByteIterable$ByteIterable).</p> </td> <td class="code"> <div class="highlight"><pre> <span class="nx">compareTo$ByteIterable</span><span class="nv">$emit: </span><span class="nf">(o) -></span>
|
| 13 | <span class="k">return</span> <span class="nx">ByteIterableUtil</span><span class="p">.</span><span class="nx">compare$ByteIterable$ByteIterable</span> <span class="k">this</span><span class="p">,</span> <span class="nx">o</span></pre></div> </td> </tr> <tr id="section-8"> <td class="docs"> <div class="pilwrap"> <a class="pilcrow" href="#section-8">¶</a> </div> <p>Gets iterator.</p>
|
| 14 |
|
| 15 | <p>@return iterator.</p> </td> <td class="code"> <div class="highlight"><pre> <span class="nv">iterator: </span><span class="nf">() -></span>
|
| 16 | <span class="k">if</span> <span class="p">(</span><span class="nx">@bytes</span> <span class="o">==</span> <span class="kc">null</span><span class="p">)</span>
|
| 17 | <span class="k">return</span> <span class="nx">@getIterator</span><span class="p">()</span>
|
| 18 | <span class="nv">bytes = </span><span class="nx">@bytes</span>
|
| 19 | <span class="nv">length = </span><span class="nx">@length</span>
|
| 20 | <span class="nv">res =</span>
|
| 21 | <span class="nv">i: </span><span class="mi">0</span>
|
| 22 | <span class="nv">hasNext: </span><span class="nf">() -></span>
|
| 23 | <span class="k">return</span> <span class="nx">i</span> <span class="o"><</span> <span class="nx">length</span>
|
| 24 | <span class="nx">next</span><span class="nv">$emit: </span><span class="nf">() -></span>
|
| 25 | <span class="nv">result = </span><span class="nx">bytes</span><span class="p">[</span><span class="nx">i</span><span class="p">]</span>
|
| 26 | <span class="nx">i</span> <span class="o">+=</span> <span class="mi">1</span>
|
| 27 | <span class="k">return</span> <span class="nx">result</span>
|
| 28 | <span class="nx">skip</span><span class="nv">$int: </span><span class="nf">(len) -></span>
|
| 29 | <span class="nv">result = </span> <span class="nb">Math</span><span class="p">.</span><span class="nx">min</span><span class="p">(</span><span class="nx">length</span> <span class="o">-</span> <span class="nx">i</span><span class="p">,</span> <span class="nx">len</span><span class="p">)</span>
|
| 30 | <span class="nx">i</span> <span class="o">+=</span> <span class="nx">result</span>
|
| 31 | <span class="k">return</span> <span class="nx">result</span>
|
| 32 | <span class="k">return</span> <span class="nx">res</span>
|
| 33 |
|
| 34 | <span class="nv">getBytesUnsafe: </span><span class="nf">() -></span>
|
| 35 | <span class="k">if</span> <span class="p">(</span><span class="nx">@bytes</span> <span class="o">==</span> <span class="kc">undefined</span><span class="p">)</span>
|
| 36 | <span class="nx">@fillBytes</span><span class="p">()</span>
|
| 37 | <span class="k">return</span> <span class="nx">@bytes</span>
|
| 38 |
|
| 39 | <span class="nv">getLength: </span><span class="nf">() -></span>
|
| 40 | <span class="k">if</span> <span class="p">(</span><span class="nx">@length</span> <span class="o">==</span> <span class="kc">undefined</span><span class="p">)</span>
|
| 41 | <span class="nx">@fillBytes</span><span class="p">()</span>
|
| 42 | <span class="k">return</span> <span class="nx">@length</span></pre></div> </td> </tr> <tr id="section-9"> <td class="docs"> <div class="pilwrap"> <a class="pilcrow" href="#section-9">¶</a> </div> <p>Compares two iterables.</p>
|
| 43 |
|
| 44 | <p>@param obj any object.
|
| 45 | @return true if objects are equal and false otherwise.</p> </td> <td class="code"> <div class="highlight"><pre> <span class="nx">equals</span><span class="nv">$Object: </span><span class="nf">(obj) -></span>
|
| 46 | <span class="k">return</span> <span class="nx">obj</span> <span class="k">instanceof</span> <span class="nx">ByteIterable</span> <span class="o">&&</span> <span class="nx">@compareTo</span><span class="p">(</span><span class="nx">obj</span><span class="p">)</span> <span class="o">==</span> <span class="mi">0</span></pre></div> </td> </tr> <tr id="section-10"> <td class="docs"> <div class="pilwrap"> <a class="pilcrow" href="#section-10">¶</a> </div> <p>For tests.</p>
|
| 47 |
|
| 48 | <p>@return hascode that contains all the bytes.</p> </td> <td class="code"> <div class="highlight"><pre> <span class="nv">hashCode: </span><span class="nf">() -></span>
|
| 49 | <span class="nv">a = </span><span class="nx">@getBytesUnsafe</span><span class="p">()</span>
|
| 50 | <span class="k">if</span> <span class="o">!</span><span class="p">(</span><span class="nx">a</span><span class="o">?</span><span class="p">)</span>
|
| 51 | <span class="k">return</span> <span class="mi">0</span>
|
| 52 | <span class="nv">result = </span><span class="mi">1</span>
|
| 53 | <span class="nv">length = </span><span class="nx">@getLength</span><span class="p">()</span>
|
| 54 | <span class="k">for</span> <span class="nx">i</span> <span class="k">in</span> <span class="p">[</span><span class="mi">0</span><span class="p">..</span><span class="nx">length</span> <span class="o">-</span> <span class="mi">1</span><span class="p">]</span>
|
| 55 | <span class="nv">result = </span><span class="mi">31</span> <span class="o">*</span> <span class="nx">result</span> <span class="o">+</span> <span class="nx">a</span><span class="p">[</span><span class="nx">i</span><span class="p">]</span>
|
| 56 | <span class="k">return</span> <span class="nx">result</span>
|
| 57 |
|
| 58 | <span class="nv">toString: </span><span class="nf">() -></span>
|
| 59 | <span class="nv">a = </span><span class="nx">@getBytesUnsafe</span><span class="p">()</span>
|
| 60 | <span class="k">if</span> <span class="p">(</span><span class="nx">a</span> <span class="o">==</span> <span class="kc">undefined</span><span class="p">)</span>
|
| 61 | <span class="k">return</span> <span class="s2">"null"</span>
|
| 62 | <span class="nv">length = </span><span class="nx">@getLength</span><span class="p">()</span>
|
| 63 | <span class="k">if</span> <span class="p">(</span><span class="nx">length</span> <span class="o"><=</span> <span class="mi">0</span> <span class="o">||</span> <span class="nx">length</span> <span class="o">==</span> <span class="kc">undefined</span><span class="p">)</span>
|
| 64 | <span class="k">return</span> <span class="s2">"[]"</span>
|
| 65 | <span class="nv">s = </span><span class="s1">'['</span>
|
| 66 | <span class="nv">i = </span><span class="mi">0</span>
|
| 67 | <span class="k">while</span> <span class="kc">true</span>
|
| 68 | <span class="nx">s</span> <span class="o">+=</span> <span class="nx">a</span><span class="p">[</span><span class="nx">i</span><span class="o">++</span><span class="p">]</span>
|
| 69 | <span class="k">if</span> <span class="nx">i</span> <span class="o">==</span> <span class="nx">length</span>
|
| 70 | <span class="k">return</span> <span class="nx">s</span> <span class="o">+</span> <span class="s1">']'</span>
|
| 71 | <span class="nx">s</span> <span class="o">+=</span> <span class="s1">', '</span></pre></div> </td> </tr> <tr id="section-11"> <td class="docs"> <div class="pilwrap"> <a class="pilcrow" href="#section-11">¶</a> </div> <p>All five functions below fill bytes of the some ByteIterable to this
|
| 72 | ByteIterable or to LightOutputStream.</p> </td> <td class="code"> <div class="highlight"><pre> <span class="nv">fillBytes: </span><span class="nf">() -></span>
|
| 73 | <span class="nx">@fillBytes$ByteIterator</span> <span class="nx">@getIterator</span><span class="p">()</span></pre></div> </td> </tr> <tr id="section-12"> <td class="docs"> <div class="pilwrap"> <a class="pilcrow" href="#section-12">¶</a> </div> <p>@param bi ByteIterable that is written to stream.
|
| 74 | @param output stream.</p> </td> <td class="code"> <div class="highlight"><pre> <span class="nx">@fillBytes$ByteIterable</span><span class="nv">$LightOutputStream: </span><span class="nf">(bi, output) -></span>
|
| 75 | <span class="nv">it = </span><span class="nx">bi</span><span class="p">.</span><span class="nx">iterator</span><span class="p">()</span>
|
| 76 | <span class="k">if</span> <span class="nx">it</span><span class="p">.</span><span class="nx">hasNext$emit</span><span class="p">()</span>
|
| 77 | <span class="nx">ByteIterableBase</span><span class="p">.</span><span class="nx">fillBytes$ByteIterator$LightOutpustStream</span> <span class="nx">it</span><span class="p">,</span> <span class="nx">output</span></pre></div> </td> </tr> <tr id="section-13"> <td class="docs"> <div class="pilwrap"> <a class="pilcrow" href="#section-13">¶</a> </div> <p>@param bi ByteIterator of data that is written to stream.
|
| 78 | @param output stream.</p> </td> <td class="code"> <div class="highlight"><pre> <span class="nx">@fillBytes$ByteIterator</span><span class="nv">$LightOutputStream: </span><span class="nf">(it, output) -></span>
|
| 79 | <span class="k">while</span> <span class="nx">it</span><span class="p">.</span><span class="nx">hasNext$emit</span><span class="p">()</span>
|
| 80 | <span class="nx">output</span><span class="p">.</span><span class="nx">writeFast$int</span> <span class="nx">it</span><span class="p">.</span><span class="nx">next$emit</span><span class="p">()</span></pre></div> </td> </tr> <tr id="section-14"> <td class="docs"> <div class="pilwrap"> <a class="pilcrow" href="#section-14">¶</a> </div> <p>@param bi ByteIterator of data that is written to this ByteIterable.</p> </td> <td class="code"> <div class="highlight"><pre> <span class="nx">fillBytes</span><span class="nv">$ByteIterator: </span><span class="nf">(it) -></span>
|
| 81 | <span class="k">if</span> <span class="p">(</span><span class="o">!</span><span class="nx">it</span><span class="p">.</span><span class="nx">hasNext$emit</span><span class="p">())</span>
|
| 82 | <span class="vi">@bytes = </span><span class="nx">ByteIterableBase</span><span class="p">.</span><span class="nx">EMPTY</span><span class="p">.</span><span class="nx">getBytesUnsafe</span><span class="p">()</span>
|
| 83 | <span class="vi">@length = </span><span class="mi">0</span>
|
| 84 | <span class="k">else</span>
|
| 85 | <span class="nx">@fillBytes$int$ByteIterator</span> <span class="nx">it</span><span class="p">.</span><span class="nx">next$emit</span><span class="p">(),</span> <span class="nx">it</span></pre></div> </td> </tr> <tr id="section-15"> <td class="docs"> <div class="pilwrap"> <a class="pilcrow" href="#section-15">¶</a> </div> <p>@param firstByte the first value to be written.
|
| 86 | @param bi ByteIterator of data that is written to this ByteIterable.</p> </td> <td class="code"> <div class="highlight"><pre> <span class="nx">fillBytes$int</span><span class="nv">$ByteIterator: </span><span class="nf">(firstByte, it) -></span>
|
| 87 | <span class="k">if</span> <span class="o">!</span><span class="p">(</span><span class="nx">it</span><span class="p">.</span><span class="nx">hasNext$emit</span><span class="p">())</span>
|
| 88 | <span class="vi">@bytes = </span><span class="nx">ByteIterableBase</span><span class="p">.</span><span class="nx">SINGLE_BYTES</span><span class="p">()[</span><span class="nx">firstByte</span> <span class="o">&</span> <span class="mh">0xff</span><span class="p">]</span>
|
| 89 | <span class="vi">@length = </span><span class="mi">1</span>
|
| 90 | <span class="k">else</span>
|
| 91 | <span class="nv">output = </span><span class="p">(</span><span class="nx">require</span> <span class="s1">'./LightOutputStream.coffee'</span><span class="p">).</span><span class="nx">LightOutputStream</span><span class="p">.</span><span class="nx">create</span><span class="p">()</span>
|
| 92 | <span class="nx">output</span><span class="p">.</span><span class="nx">writeFast$int</span> <span class="nx">firstByte</span>
|
| 93 | <span class="nx">ByteIterableBase</span><span class="p">.</span><span class="nx">fillBytes$ByteIterator$LightOutputStream</span> <span class="nx">it</span><span class="p">,</span> <span class="nx">output</span>
|
| 94 | <span class="vi">@bytes = </span><span class="nx">output</span><span class="p">.</span><span class="nx">getBufferBytes</span><span class="p">()</span>
|
| 95 | <span class="vi">@length = </span><span class="nx">output</span><span class="p">.</span><span class="nx">getBufferLength</span><span class="p">()</span>
|
| 96 |
|
| 97 | <span class="nv">exports.ByteIterableBase = </span><span class="nx">ByteIterableBase</span>
|
| 98 |
|
| 99 | </pre></div> </td> </tr> </tbody> </table> </div> </body> </html> |
| \ | No newline at end of file |