dbmlite3 2.0.0.pre.alpha.6 → 2.0.1

data/doc/Lite3/DBM.html

@@ -6,7 +6,7 @@
 <title>
   Class: Lite3::DBM
   
-    &mdash; Documentation by YARD 0.9.26
+    &mdash; Documentation by YARD 0.9.34
   
 </title>
 
@@ -150,7 +150,7 @@
 
   
     <span class="summary_desc"><div class='inline'>
-<p>Identical to <code>initialize</code> except that if a block is provided, it is evaluated with a new Lite3::DBM which is then closed afterward.</p>
+<p>Identical to <code>new</code> except that if a block is provided, it is evaluated with a new Lite3::DBM which is then closed afterward.</p>
 </div></span>
   
 </li>
@@ -453,7 +453,7 @@
 
   
     <span class="summary_desc"><div class='inline'>
-<p>Behaves like &#39;each&#39; with a block–that is, call it for each key/value pair–but (probably) executes faster.</p>
+<p>Behaves like ‘each’ with a block–that is, call it for each key/value pair–but (probably) executes faster.</p>
 </div></span>
   
 </li>
@@ -579,7 +579,7 @@
 
   
     <span class="summary_desc"><div class='inline'>
-<p>Return a <code>Hash</code> whose keys are the table&#39;s values and whose values are the table&#39;s keys.</p>
+<p>Return a <code>Hash</code> whose keys are the table’s values and whose values are the table’s keys.</p>
 </div></span>
   
 </li>
@@ -982,7 +982,7 @@
 </h3><div class="docstring">
   <div class="discussion">
     
-<p>Identical to <code>initialize</code> except that if a block is provided, it is evaluated with a new Lite3::DBM which is then closed afterward. This is analagous to <code>File.open</code>.</p>
+<p>Identical to <code>new</code> except that if a block is provided, it is evaluated with a new Lite3::DBM which is then closed afterward. This is analagous to <code>File.open</code>. See <code>initialize</code> for an explanation of the arguments and caveats.</p>
 
 
   </div>
@@ -996,7 +996,6 @@
       <pre class="lines">
 
 
-93
 94
 95
 96
@@ -1005,10 +1004,11 @@
 99
 100
 101
-102</pre>
+102
+103</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/internal_lite3/dbm.rb', line 93</span>
+      <pre class="code"><span class="info file"># File 'lib/internal_lite3/dbm.rb', line 94</span>
 
 <span class='kw'>def</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_open'>open</span><span class='lparen'>(</span><span class='id identifier rubyid_filename'>filename</span><span class='comma'>,</span> <span class='id identifier rubyid_tablename'>tablename</span><span class='comma'>,</span> <span class='id identifier rubyid_serializer'>serializer</span> <span class='op'>=</span> <span class='symbol'>:yaml</span><span class='comma'>,</span> <span class='op'>&amp;</span><span class='id identifier rubyid_block'>block</span><span class='rparen'>)</span>
   <span class='id identifier rubyid_instance'>instance</span> <span class='op'>=</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span><span class='lparen'>(</span><span class='id identifier rubyid_filename'>filename</span><span class='comma'>,</span> <span class='id identifier rubyid_tablename'>tablename</span><span class='comma'>,</span> <span class='id identifier rubyid_serializer'>serializer</span><span class='rparen'>)</span>
@@ -1057,12 +1057,12 @@
       <pre class="lines">
 
 
-262
 263
-264</pre>
+264
+265</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/internal_lite3/dbm.rb', line 262</span>
+      <pre class="code"><span class="info file"># File 'lib/internal_lite3/dbm.rb', line 263</span>
 
 <span class='kw'>def</span> <span class='op'>[]</span><span class='lparen'>(</span><span class='id identifier rubyid_key'>key</span><span class='rparen'>)</span>
   <span class='kw'>return</span> <span class='id identifier rubyid_fetch'>fetch</span><span class='lparen'>(</span><span class='id identifier rubyid_key'>key</span><span class='comma'>,</span> <span class='kw'>nil</span><span class='rparen'>)</span>
@@ -1106,17 +1106,17 @@
       <pre class="lines">
 
 
-250
 251
 252
 253
 254
 255
 256
-257</pre>
+257
+258</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/internal_lite3/dbm.rb', line 250</span>
+      <pre class="code"><span class="info file"># File 'lib/internal_lite3/dbm.rb', line 251</span>
 
 <span class='kw'>def</span> <span class='op'>[]=</span><span class='lparen'>(</span><span class='id identifier rubyid_key'>key</span><span class='comma'>,</span> <span class='id identifier rubyid_value'>value</span><span class='rparen'>)</span>
   <span class='id identifier rubyid_key'>key</span> <span class='op'>=</span> <span class='id identifier rubyid_check_key'>check_key</span><span class='lparen'>(</span><span class='id identifier rubyid_key'>key</span><span class='rparen'>)</span>
@@ -1157,12 +1157,12 @@
       <pre class="lines">
 
 
-348
-349
-350</pre>
+354
+355
+356</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/internal_lite3/dbm.rb', line 348</span>
+      <pre class="code"><span class="info file"># File 'lib/internal_lite3/dbm.rb', line 354</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_clear'>clear</span>
   <span class='ivar'>@handle</span><span class='period'>.</span><span class='id identifier rubyid_clear_table'>clear_table</span><span class='lparen'>(</span><span class='id identifier rubyid_actual_tbl'>actual_tbl</span><span class='lparen'>(</span><span class='rparen'>)</span><span class='rparen'>)</span>
@@ -1200,13 +1200,13 @@
       <pre class="lines">
 
 
-185
 186
 187
-188</pre>
+188
+189</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/internal_lite3/dbm.rb', line 185</span>
+      <pre class="code"><span class="info file"># File 'lib/internal_lite3/dbm.rb', line 186</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_close'>close</span>
   <span class='ivar'>@handle</span><span class='period'>.</span><span class='id identifier rubyid_delref'>delref</span><span class='lparen'>(</span><span class='kw'>self</span><span class='rparen'>)</span>
@@ -1256,12 +1256,12 @@
       <pre class="lines">
 
 
-192
 193
-194</pre>
+194
+195</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/internal_lite3/dbm.rb', line 192</span>
+      <pre class="code"><span class="info file"># File 'lib/internal_lite3/dbm.rb', line 193</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_closed?'>closed?</span>
   <span class='kw'>return</span> <span class='ivar'>@handle</span><span class='period'>.</span><span class='id identifier rubyid_is_a?'>is_a?</span> <span class='const'>ClosedHandle</span>
@@ -1297,12 +1297,12 @@
       <pre class="lines">
 
 
-434
-435
-436</pre>
+440
+441
+442</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/internal_lite3/dbm.rb', line 434</span>
+      <pre class="code"><span class="info file"># File 'lib/internal_lite3/dbm.rb', line 440</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_delete'>delete</span><span class='lparen'>(</span><span class='id identifier rubyid_key'>key</span><span class='rparen'>)</span>
   <span class='ivar'>@handle</span><span class='period'>.</span><span class='id identifier rubyid_delete'>delete</span><span class='lparen'>(</span><span class='id identifier rubyid_actual_tbl'>actual_tbl</span><span class='lparen'>(</span><span class='rparen'>)</span><span class='comma'>,</span> <span class='id identifier rubyid_key'>key</span><span class='rparen'>)</span>
@@ -1360,14 +1360,14 @@
       <pre class="lines">
 
 
-442
-443
-444
-445
-446</pre>
+448
+449
+450
+451
+452</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/internal_lite3/dbm.rb', line 442</span>
+      <pre class="code"><span class="info file"># File 'lib/internal_lite3/dbm.rb', line 448</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_delete_if'>delete_if</span><span class='lparen'>(</span><span class='op'>&amp;</span><span class='id identifier rubyid_block'>block</span><span class='rparen'>)</span>
   <span class='id identifier rubyid_transaction'>transaction</span> <span class='lbrace'>{</span>
@@ -1431,14 +1431,14 @@
       <pre class="lines">
 
 
-386
-387
-388
-389
-390</pre>
+392
+393
+394
+395
+396</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/internal_lite3/dbm.rb', line 386</span>
+      <pre class="code"><span class="info file"># File 'lib/internal_lite3/dbm.rb', line 392</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_each'>each</span><span class='lparen'>(</span><span class='op'>&amp;</span><span class='id identifier rubyid_block'>block</span><span class='rparen'>)</span>
   <span class='kw'>return</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_to_enum'>to_enum</span><span class='lparen'>(</span><span class='symbol'>:nt_each</span><span class='rparen'>)</span> <span class='kw'>unless</span> <span class='id identifier rubyid_block'>block</span>
@@ -1494,13 +1494,13 @@
       <pre class="lines">
 
 
-409
-410
-411
-412</pre>
+415
+416
+417
+418</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/internal_lite3/dbm.rb', line 409</span>
+      <pre class="code"><span class="info file"># File 'lib/internal_lite3/dbm.rb', line 415</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_each_key'>each_key</span><span class='lparen'>(</span><span class='op'>&amp;</span><span class='id identifier rubyid_block'>block</span><span class='rparen'>)</span>
   <span class='kw'>return</span> <span class='const'>Enumerator</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span><span class='lbrace'>{</span><span class='op'>|</span><span class='id identifier rubyid_y'>y</span><span class='op'>|</span> <span class='id identifier rubyid_nt_each'>nt_each</span><span class='lbrace'>{</span> <span class='op'>|</span><span class='id identifier rubyid_k'>k</span><span class='comma'>,</span><span class='id identifier rubyid_v'>v</span><span class='op'>|</span> <span class='id identifier rubyid_y'>y</span> <span class='op'>&lt;&lt;</span> <span class='id identifier rubyid_k'>k</span>  <span class='rbrace'>}</span> <span class='rbrace'>}</span> <span class='kw'>unless</span> <span class='id identifier rubyid_block'>block</span>
@@ -1555,13 +1555,13 @@
       <pre class="lines">
 
 
-418
-419
-420
-421</pre>
+424
+425
+426
+427</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/internal_lite3/dbm.rb', line 418</span>
+      <pre class="code"><span class="info file"># File 'lib/internal_lite3/dbm.rb', line 424</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_each_value'>each_value</span><span class='lparen'>(</span><span class='op'>&amp;</span><span class='id identifier rubyid_block'>block</span><span class='rparen'>)</span>
   <span class='kw'>return</span> <span class='const'>Enumerator</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span><span class='lbrace'>{</span><span class='op'>|</span><span class='id identifier rubyid_y'>y</span><span class='op'>|</span> <span class='id identifier rubyid_nt_each'>nt_each</span><span class='lbrace'>{</span> <span class='op'>|</span><span class='id identifier rubyid_k'>k</span><span class='comma'>,</span><span class='id identifier rubyid_v'>v</span><span class='op'>|</span> <span class='id identifier rubyid_y'>y</span> <span class='op'>&lt;&lt;</span> <span class='id identifier rubyid_v'>v</span>  <span class='rbrace'>}</span> <span class='rbrace'>}</span> <span class='kw'>unless</span> <span class='id identifier rubyid_block'>block</span>
@@ -1611,12 +1611,12 @@
       <pre class="lines">
 
 
-456
-457
-458</pre>
+462
+463
+464</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/internal_lite3/dbm.rb', line 456</span>
+      <pre class="code"><span class="info file"># File 'lib/internal_lite3/dbm.rb', line 462</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_empty?'>empty?</span>
   <span class='kw'>return</span> <span class='id identifier rubyid_size'>size</span> <span class='op'>==</span> <span class='int'>0</span>
@@ -1638,11 +1638,11 @@
 </h3><div class="docstring">
   <div class="discussion">
     
-<p>Behaves like &#39;each&#39; with a block–that is, call it for each key/value pair–but (probably) executes faster.</p>
+<p>Behaves like ‘each’ with a block–that is, call it for each key/value pair–but (probably) executes faster.</p>
 
 <p>The downside is that there is no guarantee of reentrance or safety. The block <em>MUST NOT</em> access the database in any way. In addition, no guarantee is made about element order.</p>
 
-<p>(You might be able to infer some ways to safely bend the rules by seeing what the underlying database libraries allow, but your code won&#39;t be future-proof if you do that.)</p>
+<p>(You might be able to infer some ways to safely bend the rules by seeing what the underlying database libraries allow, but your code won’t be future-proof if you do that.)</p>
 
 
   </div>
@@ -1674,16 +1674,16 @@
       <pre class="lines">
 
 
-365
-366
-367
-368
-369
-370
-371</pre>
+371
+372
+373
+374
+375
+376
+377</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/internal_lite3/dbm.rb', line 365</span>
+      <pre class="code"><span class="info file"># File 'lib/internal_lite3/dbm.rb', line 371</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_fast_each'>fast_each</span><span class='lparen'>(</span><span class='op'>&amp;</span><span class='id identifier rubyid_block'>block</span><span class='rparen'>)</span>
   <span class='id identifier rubyid_transaction'>transaction</span> <span class='lbrace'>{</span>
@@ -1713,11 +1713,9 @@
 
 <p><code>key</code> <strong>must</strong> be a String or a Symbol; Symbols are transparently converted to Strings.</p>
 
-<p>If it is not present and a block is given, evaluate the block with the key as its argument and return that.</p>
-
-<p>If no block was given either but one extra parameter was given, that value is returned instead.</p>
+<p>If it is not present and a block is given, evaluate the block with the key as its argument and return that. If no block was given either but one extra parameter was given, that value is returned instead. Finally, if none of these was given, it throws an <code>IndexError</code> exception.</p>
 
-<p>Finally, if none of these was given, it throws an <code>IndexError</code> exception.</p>
+<p>All database accesses occur within a transaction, so it is safe to consider <code>fetch</code> atomic. This includes evaluating a block argument.</p>
 
 <p>It is an error if <code>fetch</code> is called with more than two arguments.</p>
 
@@ -1764,8 +1762,6 @@
       <pre class="lines">
 
 
-283
-284
 285
 286
 287
@@ -1789,10 +1785,16 @@
 305
 306
 307
-308</pre>
+308
+309
+310
+311
+312
+313
+314</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/internal_lite3/dbm.rb', line 283</span>
+      <pre class="code"><span class="info file"># File 'lib/internal_lite3/dbm.rb', line 285</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_fetch'>fetch</span><span class='lparen'>(</span><span class='id identifier rubyid_key'>key</span><span class='comma'>,</span> <span class='op'>*</span><span class='id identifier rubyid_args'>args</span><span class='comma'>,</span> <span class='op'>&amp;</span><span class='id identifier rubyid_default_block'>default_block</span><span class='rparen'>)</span>
 
@@ -1805,17 +1807,21 @@
   <span class='comment'># Retrieve the value
 </span>  <span class='id identifier rubyid_key'>key</span> <span class='op'>=</span> <span class='id identifier rubyid_check_key'>check_key</span><span class='lparen'>(</span><span class='id identifier rubyid_key'>key</span><span class='rparen'>)</span>
 
-  <span class='comment'># Return the value if found.  (nil will always mean the entry
-</span>  <span class='comment'># isn&#39;t present because values are encoded in strings.)
-</span>  <span class='id identifier rubyid_value'>value</span> <span class='op'>=</span> <span class='ivar'>@handle</span><span class='period'>.</span><span class='id identifier rubyid_lookup'>lookup</span><span class='lparen'>(</span><span class='id identifier rubyid_actual_tbl'>actual_tbl</span><span class='lparen'>(</span><span class='rparen'>)</span><span class='comma'>,</span> <span class='id identifier rubyid_key'>key</span><span class='rparen'>)</span>
-  <span class='kw'>return</span> <span class='ivar'>@valdec</span><span class='period'>.</span><span class='id identifier rubyid_call'>call</span><span class='lparen'>(</span><span class='id identifier rubyid_value'>value</span><span class='rparen'>)</span> <span class='kw'>if</span> <span class='id identifier rubyid_value'>value</span>
+  <span class='comment'># We do the lookup-and-maybe-replace in a transaction so that
+</span>  <span class='comment'># it&#39;s atomic.
+</span>  <span class='id identifier rubyid_transaction'>transaction</span> <span class='kw'>do</span>
+    <span class='comment'># Return the value if found.  (nil will always mean the entry
+</span>    <span class='comment'># isn&#39;t present because values are encoded in strings.)
+</span>    <span class='id identifier rubyid_value'>value</span> <span class='op'>=</span> <span class='ivar'>@handle</span><span class='period'>.</span><span class='id identifier rubyid_lookup'>lookup</span><span class='lparen'>(</span><span class='id identifier rubyid_actual_tbl'>actual_tbl</span><span class='lparen'>(</span><span class='rparen'>)</span><span class='comma'>,</span> <span class='id identifier rubyid_key'>key</span><span class='rparen'>)</span>
+    <span class='kw'>return</span> <span class='ivar'>@valdec</span><span class='period'>.</span><span class='id identifier rubyid_call'>call</span><span class='lparen'>(</span><span class='id identifier rubyid_value'>value</span><span class='rparen'>)</span> <span class='kw'>if</span> <span class='id identifier rubyid_value'>value</span>
 
-  <span class='comment'># Not found.  If a block was given, evaluate it and return its
-</span>  <span class='comment'># result.
-</span>  <span class='kw'>return</span> <span class='id identifier rubyid_default_block'>default_block</span><span class='period'>.</span><span class='id identifier rubyid_call'>call</span><span class='lparen'>(</span><span class='id identifier rubyid_key'>key</span><span class='rparen'>)</span> <span class='kw'>if</span> <span class='id identifier rubyid_default_block'>default_block</span>
+    <span class='comment'># Not found.  If a block was given, evaluate it and return its
+</span>    <span class='comment'># result.
+</span>    <span class='kw'>return</span> <span class='id identifier rubyid_default_block'>default_block</span><span class='period'>.</span><span class='id identifier rubyid_call'>call</span><span class='lparen'>(</span><span class='id identifier rubyid_key'>key</span><span class='rparen'>)</span> <span class='kw'>if</span> <span class='id identifier rubyid_default_block'>default_block</span>
 
-  <span class='comment'># Next, see if we have a default value we can return
-</span>  <span class='kw'>return</span> <span class='id identifier rubyid_args'>args</span><span class='lbracket'>[</span><span class='int'>0</span><span class='rbracket'>]</span> <span class='kw'>if</span> <span class='id identifier rubyid_args'>args</span><span class='period'>.</span><span class='id identifier rubyid_size'>size</span> <span class='op'>&gt;</span> <span class='int'>0</span>
+    <span class='comment'># Next, see if we have a default value we can return
+</span>    <span class='kw'>return</span> <span class='id identifier rubyid_args'>args</span><span class='lbracket'>[</span><span class='int'>0</span><span class='rbracket'>]</span> <span class='kw'>if</span> <span class='id identifier rubyid_args'>args</span><span class='period'>.</span><span class='id identifier rubyid_size'>size</span> <span class='op'>&gt;</span> <span class='int'>0</span>
+  <span class='kw'>end</span>
 
   <span class='comment'># And if all else fails, raise an IndexError.
 </span>  <span class='id identifier rubyid_raise'>raise</span> <span class='const'>IndexError</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>key &#39;</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_key'>key</span><span class='embexpr_end'>}</span><span class='tstring_content'>&#39; not found.</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span>
@@ -1868,14 +1874,14 @@
       <pre class="lines">
 
 
-338
-339
-340
-341
-342</pre>
+344
+345
+346
+347
+348</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/internal_lite3/dbm.rb', line 338</span>
+      <pre class="code"><span class="info file"># File 'lib/internal_lite3/dbm.rb', line 344</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_has_key?'>has_key?</span><span class='lparen'>(</span><span class='id identifier rubyid_key'>key</span><span class='rparen'>)</span>
   <span class='kw'>return</span> <span class='kw'>false</span> <span class='kw'>unless</span> <span class='id identifier rubyid_key'>key</span><span class='period'>.</span><span class='id identifier rubyid_class'>class</span> <span class='op'>==</span> <span class='const'>String</span> <span class='op'>||</span> <span class='id identifier rubyid_key'>key</span><span class='period'>.</span><span class='id identifier rubyid_class'>class</span> <span class='op'>==</span> <span class='const'>Symbol</span>
@@ -1932,13 +1938,13 @@
       <pre class="lines">
 
 
-499
-500
-501
-502</pre>
+505
+506
+507
+508</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/internal_lite3/dbm.rb', line 499</span>
+      <pre class="code"><span class="info file"># File 'lib/internal_lite3/dbm.rb', line 505</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_has_value?'>has_value?</span><span class='lparen'>(</span><span class='id identifier rubyid_val'>val</span><span class='rparen'>)</span>
   <span class='id identifier rubyid_fast_each'>fast_each</span><span class='lbrace'>{</span><span class='op'>|</span><span class='id identifier rubyid_k'>k</span><span class='comma'>,</span><span class='id identifier rubyid_v'>v</span><span class='op'>|</span> <span class='kw'>return</span> <span class='kw'>true</span> <span class='kw'>if</span> <span class='id identifier rubyid_v'>v</span> <span class='op'>==</span> <span class='id identifier rubyid_val'>val</span> <span class='rbrace'>}</span>
@@ -1961,7 +1967,7 @@
 </h3><div class="docstring">
   <div class="discussion">
     
-<p>Return a <code>Hash</code> whose keys are the table&#39;s values and whose values are the table&#39;s keys.</p>
+<p>Return a <code>Hash</code> whose keys are the table’s values and whose values are the table’s keys.</p>
 
 <p><strong>WARNING:</strong> it is possible for tables to be significantly larger than available RAM; in that case, this will likely crash your program.</p>
 
@@ -1977,14 +1983,14 @@
       <pre class="lines">
 
 
-511
-512
-513
-514
-515</pre>
+517
+518
+519
+520
+521</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/internal_lite3/dbm.rb', line 511</span>
+      <pre class="code"><span class="info file"># File 'lib/internal_lite3/dbm.rb', line 517</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_invert'>invert</span>
   <span class='id identifier rubyid_result'>result</span> <span class='op'>=</span> <span class='lbrace'>{</span><span class='rbrace'>}</span>
@@ -2024,14 +2030,14 @@
       <pre class="lines">
 
 
-320
-321
-322
-323
-324</pre>
+326
+327
+328
+329
+330</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/internal_lite3/dbm.rb', line 320</span>
+      <pre class="code"><span class="info file"># File 'lib/internal_lite3/dbm.rb', line 326</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_keys'>keys</span>
   <span class='id identifier rubyid_keys'>keys</span> <span class='op'>=</span> <span class='lbracket'>[</span><span class='rbracket'>]</span>
@@ -2055,7 +2061,7 @@
 </h3><div class="docstring">
   <div class="discussion">
     
-<p>Remove the first key/value pair from <code>self</code> and return it. “First” is defined by <code>self</code>&#39;s row order, which is the order of insertion as determined by SQLite3.</p>
+<p>Remove the first key/value pair from <code>self</code> and return it. “First” is defined by <code>self</code>‘s row order, which is the order of insertion as determined by SQLite3.</p>
 
 
   </div>
@@ -2069,19 +2075,19 @@
       <pre class="lines">
 
 
-520
-521
-522
-523
-524
-525
 526
 527
 528
-529</pre>
+529
+530
+531
+532
+533
+534
+535</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/internal_lite3/dbm.rb', line 520</span>
+      <pre class="code"><span class="info file"># File 'lib/internal_lite3/dbm.rb', line 526</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_shift'>shift</span>
   <span class='id identifier rubyid_transaction'>transaction</span> <span class='lbrace'>{</span>
@@ -2128,12 +2134,12 @@
       <pre class="lines">
 
 
-450
-451
-452</pre>
+456
+457
+458</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/internal_lite3/dbm.rb', line 450</span>
+      <pre class="code"><span class="info file"># File 'lib/internal_lite3/dbm.rb', line 456</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_size'>size</span>
   <span class='kw'>return</span> <span class='ivar'>@handle</span><span class='period'>.</span><span class='id identifier rubyid_get_size'>get_size</span><span class='lparen'>(</span><span class='id identifier rubyid_actual_tbl'>actual_tbl</span><span class='lparen'>(</span><span class='rparen'>)</span><span class='rparen'>)</span>
@@ -2171,14 +2177,14 @@
       <pre class="lines">
 
 
-484
-485
-486
-487
-488</pre>
+490
+491
+492
+493
+494</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/internal_lite3/dbm.rb', line 484</span>
+      <pre class="code"><span class="info file"># File 'lib/internal_lite3/dbm.rb', line 490</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_to_a'>to_a</span>
   <span class='id identifier rubyid_result'>result</span> <span class='op'>=</span> <span class='lbracket'>[</span><span class='rbracket'>]</span>
@@ -2218,14 +2224,14 @@
       <pre class="lines">
 
 
-471
-472
-473
-474
-475</pre>
+477
+478
+479
+480
+481</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/internal_lite3/dbm.rb', line 471</span>
+      <pre class="code"><span class="info file"># File 'lib/internal_lite3/dbm.rb', line 477</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_to_hash'>to_hash</span>
   <span class='id identifier rubyid_result'>result</span> <span class='op'>=</span> <span class='lbrace'>{</span><span class='rbrace'>}</span>
@@ -2256,14 +2262,14 @@
       <pre class="lines">
 
 
-170
 171
 172
 173
-174</pre>
+174
+175</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/internal_lite3/dbm.rb', line 170</span>
+      <pre class="code"><span class="info file"># File 'lib/internal_lite3/dbm.rb', line 171</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_to_s'>to_s</span>
   <span class='id identifier rubyid_openstr'>openstr</span> <span class='op'>=</span> <span class='id identifier rubyid_closed?'>closed?</span> <span class='op'>?</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>CLOSED</span><span class='tstring_end'>&#39;</span></span> <span class='op'>:</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>OPEN</span><span class='tstring_end'>&#39;</span></span>
@@ -2287,11 +2293,11 @@
 </h3><div class="docstring">
   <div class="discussion">
     
-<p>Begins a transaction, evaluates the given block and then ends the transaction. If no error occurred (i.e. an exception was thrown), the transaction is committed; otherwise, it is rolled back. Returns the block&#39;s result.</p>
+<p>Begins a transaction, evaluates the given block and then ends the transaction. If no error occurred (i.e. an exception was thrown), the transaction is committed; otherwise, it is rolled back. Returns the block’s result.</p>
 
-<p>It is safe to call <code>DBM.transaction</code> within another <code>DBM.transaction</code> block&#39;s call chain because <code>DBM</code> will not start a new transaction on a database handle that already has one in progress. (It may be possible to trick <code>DBM</code> into trying via fibers or other flow control trickery; don&#39;t do that.)</p>
+<p>It is safe to call <code>DBM.transaction</code> within another <code>DBM.transaction</code> block’s call chain because <code>DBM</code> will not start a new transaction on a database handle that already has one in progress. (It may be possible to trick <code>DBM</code> into trying via fibers or other flow control trickery; don’t do that.)</p>
 
-<p>Note that it&#39;s probably not a good idea to assume too much about the precise semantics; I can&#39;t guarantee that the underlying library(es) won&#39;t change or be replaced outright.</p>
+<p>Note that it’s probably not a good idea to assume too much about the precise semantics; I can’t guarantee that the underlying library(es) won’t change or be replaced outright.</p>
 
 <p>That being said, at present, this is simply a wrapper around <code>Sequel::Database.transaction</code> with the default options and so is subject to the quirks therein. In version 1.0.0, transactions were always executed in <code>:deferred</code> mode via the <code>sqlite3</code> gem.</p>
 
@@ -2330,7 +2336,7 @@
       
         &mdash;
         <div class='inline'>
-<p>Returns the block&#39;s result.</p>
+<p>Returns the block’s result.</p>
 </div>
       
     </li>
@@ -2343,12 +2349,12 @@
       <pre class="lines">
 
 
-228
 229
-230</pre>
+230
+231</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/internal_lite3/dbm.rb', line 228</span>
+      <pre class="code"><span class="info file"># File 'lib/internal_lite3/dbm.rb', line 229</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_transaction'>transaction</span><span class='lparen'>(</span><span class='op'>&amp;</span><span class='id identifier rubyid_block'>block</span><span class='rparen'>)</span>
   <span class='kw'>return</span> <span class='ivar'>@handle</span><span class='period'>.</span><span class='id identifier rubyid_transaction'>transaction</span> <span class='lbrace'>{</span> <span class='id identifier rubyid_block'>block</span><span class='period'>.</span><span class='id identifier rubyid_call'>call</span><span class='lparen'>(</span><span class='kw'>self</span><span class='rparen'>)</span> <span class='rbrace'>}</span>
@@ -2397,12 +2403,12 @@
       <pre class="lines">
 
 
-233
 234
-235</pre>
+235
+236</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/internal_lite3/dbm.rb', line 233</span>
+      <pre class="code"><span class="info file"># File 'lib/internal_lite3/dbm.rb', line 234</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_transaction_active?'>transaction_active?</span>
   <span class='kw'>return</span> <span class='ivar'>@handle</span><span class='period'>.</span><span class='id identifier rubyid_transaction_active?'>transaction_active?</span>
@@ -2438,14 +2444,14 @@
       <pre class="lines">
 
 
-426
-427
-428
-429
-430</pre>
+432
+433
+434
+435
+436</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/internal_lite3/dbm.rb', line 426</span>
+      <pre class="code"><span class="info file"># File 'lib/internal_lite3/dbm.rb', line 432</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_update'>update</span><span class='lparen'>(</span><span class='id identifier rubyid_hash'>hash</span><span class='rparen'>)</span>
   <span class='id identifier rubyid_transaction'>transaction</span> <span class='lbrace'>{</span>
@@ -2485,14 +2491,14 @@
       <pre class="lines">
 
 
-330
-331
-332
-333
-334</pre>
+336
+337
+338
+339
+340</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/internal_lite3/dbm.rb', line 330</span>
+      <pre class="code"><span class="info file"># File 'lib/internal_lite3/dbm.rb', line 336</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_values'>values</span>
   <span class='id identifier rubyid_values'>values</span> <span class='op'>=</span> <span class='lbracket'>[</span><span class='rbracket'>]</span>
@@ -2530,12 +2536,12 @@
       <pre class="lines">
 
 
-312
-313
-314</pre>
+318
+319
+320</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/internal_lite3/dbm.rb', line 312</span>
+      <pre class="code"><span class="info file"># File 'lib/internal_lite3/dbm.rb', line 318</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_values_at'>values_at</span><span class='lparen'>(</span><span class='op'>*</span><span class='id identifier rubyid_keys'>keys</span><span class='rparen'>)</span>
   <span class='kw'>return</span> <span class='id identifier rubyid_keys'>keys</span><span class='period'>.</span><span class='id identifier rubyid_map'>map</span><span class='lbrace'>{</span><span class='op'>|</span><span class='id identifier rubyid_k'>k</span><span class='op'>|</span> <span class='kw'>self</span><span class='lbracket'>[</span><span class='id identifier rubyid_k'>k</span><span class='rbracket'>]</span><span class='rbrace'>}</span>
@@ -2550,9 +2556,9 @@
 </div>
 
       <div id="footer">
-  Generated on Wed Mar  8 13:02:55 2023 by
-  <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
-  0.9.26 (ruby-3.0.1).
+  Generated on Sat Mar 30 16:15:43 2024 by
+  <a href="https://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
+  0.9.34 (ruby-3.2.1).
 </div>
 
     </div>