UNPKG

22.9 kBHTMLView Raw
1<!DOCTYPE html> <html> <head> <title>CompressedUnsignedLongByteIterable.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 &hellip; <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> CompressedUnsignedLongByteIterable.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">&#182;</a> </div> </td> <td class="code"> <div class="highlight"><pre><span class="nv">fs = </span><span class="nx">require</span> <span class="s1">&#39;fs&#39;</span>
2<span class="nv">Addr64 = </span><span class="p">(</span><span class="nx">require</span> <span class="s1">&#39;../Addr64.coffee&#39;</span><span class="p">).</span><span class="nx">Addr64</span>
3<span class="nv">LogUtil = </span><span class="p">(</span><span class="nx">require</span> <span class="s1">&#39;../LogUtil.coffee&#39;</span><span class="p">).</span><span class="nx">LogUtil</span>
4<span class="nv">ByteIterableBase =</span>
5 <span class="p">(</span><span class="nx">require</span> <span class="s1">&#39;../../database/impl/iterate/ByteIterableBase.coffee&#39;</span><span class="p">).</span><span class="nx">ByteIterableBase</span>
6<span class="nv">IllegalArgumentError =</span>
7 <span class="p">(</span><span class="nx">require</span> <span class="s1">&#39;../../errors/IllegalArgumentError.coffee&#39;</span><span class="p">).</span><span class="nx">IllegalArgumentError</span>
8<span class="nv">EventEmitter = </span><span class="p">(</span><span class="nx">require</span> <span class="s1">&#39;events&#39;</span><span class="p">).</span><span class="nx">EventEmitter</span></pre></div> </td> </tr> <tr id="section-2"> <td class="docs"> <div class="pilwrap"> <a class="pilcrow" href="#section-2">&#182;</a> </div> <p>TODO there is some cache in exodus - what is it for?</p> </td> <td class="code"> <div class="highlight"><pre></pre></div> </td> </tr> <tr id="section-3"> <td class="docs"> <div class="pilwrap"> <a class="pilcrow" href="#section-3">&#182;</a> </div> <p>This class is used for compressed reading and writing of numbers using
9iterators.</p> </td> <td class="code"> <div class="highlight"><pre><span class="k">class</span> <span class="nx">CompressedUnsignedLongByteIterable</span> <span class="k">extends</span> <span class="nx">ByteIterableBase</span></pre></div> </td> </tr> <tr id="section-4"> <td class="docs"> <div class="pilwrap"> <a class="pilcrow" href="#section-4">&#182;</a> </div> <p>@private</p> </td> <td class="code"> <div class="highlight"><pre> <span class="nv">MAX_DIGIT_NUMBER: </span><span class="mi">10</span></pre></div> </td> </tr> <tr id="section-5"> <td class="docs"> <div class="pilwrap"> <a class="pilcrow" href="#section-5">&#182;</a> </div> <p>@private</p> </td> <td class="code"> <div class="highlight"><pre> <span class="nv">l: </span><span class="kc">undefined</span>
10
11 <span class="vi">@EMITTER = </span><span class="k">new</span> <span class="nx">EventEmitter</span><span class="p">()</span>
12 <span class="nx">@EMITTER</span><span class="p">.</span><span class="nx">setMaxListeners</span> <span class="mi">0</span></pre></div> </td> </tr> <tr id="section-6"> <td class="docs"> <div class="pilwrap"> <a class="pilcrow" href="#section-6">&#182;</a> </div> <p>Constructor.</p> </td> <td class="code"> <div class="highlight"><pre> <span class="vi">@create: </span><span class="nf">(o) -&gt;</span>
13 <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">CompressedUnsignedLongByteIterable</span>
14 <span class="k">return</span> <span class="nx">o</span></pre></div> </td> </tr> <tr id="section-7"> <td class="docs"> <div class="pilwrap"> <a class="pilcrow" href="#section-7">&#182;</a> </div> <p>Constructor.</p>
15
16<p>@param l.</p> </td> <td class="code"> <div class="highlight"><pre> <span class="nx">@create</span><span class="nv">$int: </span><span class="nf">(l, o) -&gt;</span>
17 <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">CompressedUnsignedLongByteIterable</span>
18 <span class="k">if</span> <span class="p">(</span><span class="nx">l</span> <span class="o">&lt;</span> <span class="mi">0</span><span class="p">)</span>
19 <span class="k">throw</span> <span class="k">new</span> <span class="nx">IllegalArgumentError</span><span class="p">(</span><span class="nx">l</span><span class="p">.</span><span class="nx">toString</span><span class="p">())</span>
20 <span class="nv">o.l = </span><span class="nx">l</span>
21 <span class="k">return</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">&#182;</a> </div> <p>Gets new iterable.</p>
22
23<p>@param l number.
24@return new iterable.</p> </td> <td class="code"> <div class="highlight"><pre> <span class="nx">@getIterable</span><span class="nv">$int: </span><span class="nf">(l) -&gt;</span>
25 <span class="k">return</span> <span class="nx">CompressedUnsignedLongByteIterable</span><span class="p">.</span><span class="nx">create$int</span> <span class="nx">l</span></pre></div> </td> </tr> <tr id="section-9"> <td class="docs"> <div class="pilwrap"> <a class="pilcrow" href="#section-9">&#182;</a> </div> <p>Calculates the compressed number length.</p>
26
27<p>@param l number.
28@return number length.</p> </td> <td class="code"> <div class="highlight"><pre> <span class="nx">@getCompressedSize</span><span class="nv">$int: </span><span class="nf">(l) -&gt;</span>
29 <span class="nv">ll = </span><span class="nx">l</span>
30 <span class="nx">ll</span> <span class="o">&gt;&gt;&gt;=</span> <span class="mi">7</span>
31 <span class="nv">result = </span><span class="mi">1</span>
32 <span class="k">while</span> <span class="nx">ll</span> <span class="o">&gt;</span> <span class="mi">0</span>
33 <span class="nx">result</span> <span class="o">+=</span> <span class="mi">1</span>
34 <span class="nx">ll</span> <span class="o">&gt;&gt;&gt;=</span> <span class="mi">7</span>
35 <span class="k">return</span> <span class="nx">result</span></pre></div> </td> </tr> <tr id="section-10"> <td class="docs"> <div class="pilwrap"> <a class="pilcrow" href="#section-10">&#182;</a> </div> <p>Writes compressed number to stream.</p>
36
37<p>@param l number.
38@param stream the stream to write number in.</p>
39
40<p>@return reference to the same stream (just for tests!).</p> </td> <td class="code"> <div class="highlight"><pre> <span class="nx">@fillBytes$int</span><span class="nv">$LightOutputStream: </span><span class="nf">(l, stream) -&gt;</span>
41 <span class="k">if</span> <span class="p">(</span><span class="nx">l</span> <span class="o">&lt;</span> <span class="mi">0</span><span class="p">)</span>
42 <span class="k">throw</span> <span class="k">new</span> <span class="nx">IllegalArgumentError</span><span class="p">(</span><span class="nx">l</span><span class="p">.</span><span class="nx">toString</span><span class="p">())</span>
43 <span class="nv">ll = </span><span class="nx">l</span>
44 <span class="k">while</span> <span class="kc">true</span>
45 <span class="nv">b = </span><span class="nx">ll</span> <span class="o">&amp;</span> <span class="mh">0x7f</span>
46 <span class="k">if</span> <span class="p">((</span><span class="nx">ll</span> <span class="o">&gt;&gt;&gt;=</span> <span class="mi">7</span><span class="p">)</span> <span class="o">==</span> <span class="mi">0</span><span class="p">)</span>
47 <span class="nx">stream</span><span class="p">.</span><span class="nx">writeFast$int</span> <span class="nx">b</span> <span class="o">|</span> <span class="mh">0x80</span>
48 <span class="k">break</span>
49 <span class="nx">stream</span><span class="p">.</span><span class="nx">writeFast$int</span> <span class="nx">b</span>
50 <span class="k">return</span> <span class="nx">stream</span></pre></div> </td> </tr> <tr id="section-11"> <td class="docs"> <div class="pilwrap"> <a class="pilcrow" href="#section-11">&#182;</a> </div> <p>Reads int from iterable. Method contains corruption check: if we have
51already read MAX<em>DIGIT</em>NUMBER and continue reading, it means that info
52is not a number.</p>
53
54<p>@param iterable the iterable to read data from.
55@return number if it could be read without events, and undefined otherwise.
56If undefined, the 'getInt' event is emitted with number or undefined
57if it can't be read.</p> </td> <td class="code"> <div class="highlight"><pre> <span class="nx">@getInt$ByteIterable</span><span class="nv">$emit: </span><span class="nf">(iterable) -&gt;</span>
58 <span class="nx">CompressedUnsignedLongByteIterable</span><span class="p">.</span>
59 <span class="nx">getInt$ByteIterator$emit</span> <span class="nx">iterable</span><span class="p">.</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">&#182;</a> </div> <p>Reads int from iterable. Method contains corruption check: if we have
60already read MAX<em>DIGIT</em>NUMBER and continue reading, it means that info
61is not a number.</p>
62
63<p>@param iterator the iterator to the place to read data from.
64@return number if it could be read without events, and undefined otherwise.
65If undefined, the 'getInt' event is emitted with number or undefined
66if it can't be read.</p> </td> <td class="code"> <div class="highlight"><pre> <span class="nx">@getInt$ByteIterator</span><span class="nv">$emit: </span><span class="nf">(iterator) -&gt;</span>
67 <span class="nv">num = </span><span class="mi">0</span>
68 <span class="nv">ll = </span><span class="mi">0</span>
69 <span class="nv">shift = </span><span class="mi">0</span>
70 <span class="nv">valueIsRead = </span><span class="kc">false</span>
71 <span class="nv">emitGetInt = </span><span class="kc">true</span>
72 <span class="nv">oldIt = </span><span class="nx">iterator</span><span class="p">.</span><span class="nx">copy</span><span class="p">()</span>
73 <span class="nx">iterator</span><span class="p">.</span><span class="nx">removeAllListeners</span><span class="p">()</span>
74 <span class="k">if</span> <span class="nx">oldIt</span><span class="p">.</span><span class="nx">addr</span> <span class="o">!=</span> <span class="kc">undefined</span>
75 <span class="nv">addrString = </span><span class="nx">Addr64</span><span class="p">.</span><span class="nx">addr64ToString$Addr64$int</span><span class="p">(</span><span class="nx">oldIt</span><span class="p">.</span><span class="nx">addr</span><span class="p">,</span>
76 <span class="nx">LogUtil</span><span class="p">.</span><span class="nx">LOG_NAME_BASE</span><span class="p">)</span>
77 <span class="nv">emit = </span><span class="kc">false</span>
78 <span class="nv">onGetNext = </span><span class="p">(</span><span class="nx">v</span><span class="p">)</span> <span class="o">=&gt;</span>
79 <span class="k">if</span> <span class="nx">v</span> <span class="o">!=</span> <span class="kc">undefined</span>
80 <span class="k">if</span> <span class="nx">num</span> <span class="o">&gt;</span> <span class="nx">@MAX_DIGIT_NUMBER</span>
81 <span class="nx">CompressedUnsignedLongByteIterable</span><span class="p">.</span><span class="nx">EMITTER</span><span class="p">.</span><span class="nx">emit</span> <span class="s1">&#39;getInt&#39;</span> <span class="o">+</span> <span class="nx">addrString</span><span class="p">,</span>
82 <span class="kc">undefined</span><span class="p">,</span> <span class="nx">iterator</span>
83 <span class="k">return</span> <span class="kc">undefined</span>
84 <span class="nx">ll</span> <span class="o">+=</span> <span class="p">((</span><span class="nx">v</span> <span class="o">&amp;</span> <span class="mh">0x7f</span><span class="p">)</span> <span class="o">&lt;&lt;</span> <span class="nx">shift</span><span class="p">)</span>
85 <span class="k">if</span> <span class="p">(</span><span class="nx">v</span> <span class="o">&amp;</span> <span class="mh">0x80</span><span class="p">)</span> <span class="o">!=</span> <span class="mi">0</span>
86 <span class="nx">iterator</span><span class="p">.</span><span class="nx">removeAllListeners</span> <span class="s1">&#39;next&#39;</span>
87 <span class="k">if</span> <span class="nx">emit</span>
88 <span class="nx">CompressedUnsignedLongByteIterable</span><span class="p">.</span><span class="nx">EMITTER</span><span class="p">.</span><span class="nx">emit</span> <span class="s1">&#39;getInt&#39;</span> <span class="o">+</span>
89 <span class="nx">addrString</span><span class="p">,</span> <span class="nx">ll</span><span class="p">,</span> <span class="nx">iterator</span>
90 <span class="k">return</span> <span class="kc">undefined</span>
91 <span class="k">return</span> <span class="nx">ll</span>
92 <span class="nx">shift</span> <span class="o">+=</span> <span class="mi">7</span>
93 <span class="nx">num</span> <span class="o">+=</span> <span class="mi">1</span>
94 <span class="nx">onGetNext</span> <span class="nx">iterator</span><span class="p">.</span><span class="nx">next$emit</span><span class="p">()</span>
95 <span class="nx">iterator</span><span class="p">.</span><span class="kc">on</span> <span class="s1">&#39;next&#39;</span><span class="p">,</span> <span class="p">(</span><span class="nx">v</span><span class="p">)</span> <span class="o">=&gt;</span>
96 <span class="nv">emit = </span><span class="kc">true</span>
97 <span class="nx">onGetNext</span> <span class="nx">v</span>
98 <span class="nx">onGetNext</span> <span class="nx">iterator</span><span class="p">.</span><span class="nx">next$emit</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">&#182;</a> </div> <p>This methods are the same as getInt. Used for compatibility.</p> </td> <td class="code"> <div class="highlight"><pre> <span class="nx">@getLong$ByteIterable</span><span class="nv">$emit: </span><span class="nf">(iterable) -&gt;</span>
99 <span class="nx">CompressedUnsignedLongByteIterable</span><span class="p">.</span>
100 <span class="nx">getInt$ByteIterator$emit</span> <span class="nx">iterable</span><span class="p">.</span><span class="nx">getIterator</span><span class="p">()</span>
101
102 <span class="nx">@getLong$ByteIterator</span><span class="nv">$emit: </span><span class="nf">(iterator) -&gt;</span>
103 <span class="nx">CompressedUnsignedLongByteIterable</span><span class="p">.</span>
104 <span class="nx">getInt$ByteIterator$emit</span> <span class="nx">iterator</span>
105
106<span class="nv">exports.CompressedUnsignedLongByteIterable = </span><span class="nx">CompressedUnsignedLongByteIterable</span>
107
108</pre></div> </td> </tr> </tbody> </table> </div> </body> </html>
\No newline at end of file