RubyGems - facets - Versions diffs - 1.4.0 → 1.4.1 - Mend

facets 1.4.0 → 1.4.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (1260) hide show

data/web/doc/api/more/classes/Units/Converter.html ADDED Viewed

@@ -0,0 +1,808 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!DOCTYPE html
+     PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html>
+  <head>
+    <title>Class: Units::Converter</title>
+    <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
+    <link rel="stylesheet" href="../.././rdoc-style.css" type="text/css" media="screen" />
+    <script language="JavaScript" type="text/javascript">
+    // <![CDATA[
+        function toggleSource( id )
+        {
+          var elem
+          var link
+          if( document.getElementById )
+          {
+            elem = document.getElementById( id )
+            link = document.getElementById( "l_" + id )
+          }
+          else if ( document.all )
+          {
+            elem = eval( "document.all." + id )
+            link = eval( "document.all.l_" + id )
+          }
+          else
+            return false;
+          if( elem.style.display == "block" )
+          {
+            elem.style.display = "none"
+            link.innerHTML = "show source"
+          }
+          else
+          {
+            elem.style.display = "block"
+            link.innerHTML = "hide source"
+          }
+        }
+        function openCode( url )
+        {
+          window.open( url, "SOURCE_CODE", "width=400,height=400,scrollbars=yes" )
+        }
+      // ]]>
+    </script>
+  </head>
+  <body>
+  <table width="100%" border='0' cellpadding='0' cellspacing='0' class='banner'><tr>
+  <td class="file-title"><span class="file-title-prefix">Class</span><br />Units::Converter</td>
+  <td align="right">
+    <table cellspacing=0 cellpadding=2>
+      <tr valign="top">
+        <td>In:</td>
+        <td>
+<a href="../../files/lib/facets/more/units_rb.html">lib/facets/more/units.rb</a>
+        </td>
+      </tr>
+    <tr>
+      <td>Parent:</td>
+      <td>
+        <a href="../Object.html">
+Object
+         </a>
+     </td>
+   </tr>
+         </table>
+        </td>
+        </tr>
+      </table>
+ <!-- banner header -->
+  <div id="bodyContent">
+      <div id="content">
+  <div class="description"><p>
+This class handles all conversions between <a
+href="../Units.html">Units</a>.
+</p>
+<p>
+There are two kinds of <a href="../Units.html">Units</a>; those that are
+not expressed as a function of other <a href="../Units.html">Units</a>
+&#8212;called base units&#8212; and those that are expressed as a function
+of other <a href="../Units.html">Units</a> &#8212;called derived units. The
+former kind is registered without specifying how it depends on other <a
+href="../Units.html">Units</a>, while the latter kind is registered with
+doing so.
+</p>
+<p>
+This class also registers a list of Converters that are generally useable.
+The default <a href="Converter.html">Converter</a> which is used when none
+is specified, can be retrieved with <a
+href="Converter.html#M001195">Converter.current</a>. Converters can be
+registered with <a href="Converter.html#M001197">Converter.register</a>.
+</p>
+<p>
+Converters can be loaded from YAML. This allows Converters to be specified
+in configuration files.
+</p>
+</div>
+  <div class="sectiontitle">Methods</div>
+  <ul>
+  <li><a href="#M001199">clean_eval</a></li>
+  <li><a href="#M001205">conversions</a></li>
+  <li><a href="#M001204">convert_conversion</a></li>
+  <li><a href="#M001196">converter</a></li>
+  <li><a href="#M001206">converters</a></li>
+  <li><a href="#M001195">current</a></li>
+  <li><a href="#M001203">decode_conversion</a></li>
+  <li><a href="#M001202">extract_data</a></li>
+  <li><a href="#M001184">from_yaml</a></li>
+  <li><a href="#M001194">load_yaml</a></li>
+  <li><a href="#M001193">method_missing</a></li>
+  <li><a href="#M001185">new</a></li>
+  <li><a href="#M001197">register</a></li>
+  <li><a href="#M001190">register_binary_unit</a></li>
+  <li><a href="#M001192">register_currency</a></li>
+  <li><a href="#M001191">register_length_unit</a></li>
+  <li><a href="#M001201">register_prefixed_unit</a></li>
+  <li><a href="#M001189">register_si_unit</a></li>
+  <li><a href="#M001188">register_unit</a></li>
+  <li><a href="#M001200">register_unit_internal</a></li>
+  <li><a href="#M001186">registered?</a></li>
+  <li><a href="#M001198">registered_converters</a></li>
+  <li><a href="#M001187">registered_units</a></li>
+  </ul>
+  <div class="sectiontitle">Classes and Modules</div>
+  Class <a href="Converter/ExchangeRate.html" class="link">Units::Converter::ExchangeRate</a><br />
+  <div class="sectiontitle">Constants</div>
+  <table border='0' cellpadding='5'>
+  <tr valign='top'>
+    <td class="attr-name">SI_PREFIXES</td>
+    <td>=</td>
+    <td class="attr-value">{       'yotta' =&gt; {:abbrev =&gt; 'Y',  :multiplier =&gt; 1e24},       'zetta' =&gt; {:abbrev =&gt; 'Z',  :multiplier =&gt; 1e21},       'exa'   =&gt; {:abbrev =&gt; 'E',  :multiplier =&gt; 1e18},       'peta'  =&gt; {:abbrev =&gt; 'P',  :multiplier =&gt; 1e14},       'tera'  =&gt; {:abbrev =&gt; 'T',  :multiplier =&gt; 1e12},       'giga'  =&gt; {:abbrev =&gt; 'G',  :multiplier =&gt; 1e9},       'mega'  =&gt; {:abbrev =&gt; 'M',  :multiplier =&gt; 1e6},       'kilo'  =&gt; {:abbrev =&gt; 'k',  :multiplier =&gt; 1e3},       'hecto' =&gt; {:abbrev =&gt; 'h',  :multiplier =&gt; 1e2},       'deca'  =&gt; {:abbrev =&gt; 'da', :multiplier =&gt; 1e1},       'deci'  =&gt; {:abbrev =&gt; 'd',  :multiplier =&gt; 1e-1},       'centi' =&gt; {:abbrev =&gt; 'c',  :multiplier =&gt; 1e-2},       'milli' =&gt; {:abbrev =&gt; 'm',  :multiplier =&gt; 1e-3},       'micro' =&gt; {:abbrev =&gt; 'u',  :multiplier =&gt; 1e-6},       'nano'  =&gt; {:abbrev =&gt; 'n',  :multiplier =&gt; 1e-9},       'pico'  =&gt; {:abbrev =&gt; 'p',  :multiplier =&gt; 1e-12},       'femto' =&gt; {:abbrev =&gt; 'f',  :multiplier =&gt; 1e-15},       'atto'  =&gt; {:abbrev =&gt; 'a',  :multiplier =&gt; 1e-18},       'zepto' =&gt; {:abbrev =&gt; 'z',  :multiplier =&gt; 1e-21},       'yocto' =&gt; {:abbrev =&gt; 'y',  :multiplier =&gt; 1e-24}</td>
+  </tr>
+  <tr valign='top'>
+    <td>&nbsp;</td>
+    <td colspan="2" class="attr-desc">
+The prefixes used for SI units. See also <a
+href="Converter.html#M001189">Converter#register_si_unit</a>.
+</td>
+  </tr>
+  <tr valign='top'>
+    <td class="attr-name">BINARY_PREFIXES</td>
+    <td>=</td>
+    <td class="attr-value">{       'yotta' =&gt; {:abbrev =&gt; 'Y', :multiplier =&gt; 1024.0 ** 8},       'zetta' =&gt; {:abbrev =&gt; 'Z', :multiplier =&gt; 1024.0 ** 7},       'exa'   =&gt; {:abbrev =&gt; 'E', :multiplier =&gt; 1024.0 ** 6},       'peta'  =&gt; {:abbrev =&gt; 'P', :multiplier =&gt; 1024.0 ** 5},       'tera'  =&gt; {:abbrev =&gt; 'T', :multiplier =&gt; 1024.0 ** 4},       'giga'  =&gt; {:abbrev =&gt; 'G', :multiplier =&gt; 1024.0 ** 3},       'mega'  =&gt; {:abbrev =&gt; 'M', :multiplier =&gt; 1024.0 ** 2},       'kilo'  =&gt; {:abbrev =&gt; 'k', :multiplier =&gt; 1024.0},     }</td>
+  </tr>
+  <tr valign='top'>
+    <td>&nbsp;</td>
+    <td colspan="2" class="attr-desc">
+The prefixes used for binary units. See also <a
+href="Converter.html#M001190">Converter#register_binary_unit</a>.
+</td>
+  </tr>
+  <tr valign='top'>
+    <td class="attr-name">LENGTH_PREFIXES</td>
+    <td>=</td>
+    <td class="attr-value">{       'square_' =&gt; {:abbrev =&gt; 'sq_', :power =&gt; 2},       'cubic_' =&gt; {:abbrev =&gt; 'cu_', :power =&gt; 3}</td>
+  </tr>
+  <tr valign='top'>
+    <td>&nbsp;</td>
+    <td colspan="2" class="attr-desc">
+The prefixes used for length units. See also <a
+href="Converter.html#M001191">Converter#register_length_unit</a>.
+</td>
+  </tr>
+  </table>
+<div class="sectiontitle">Public Class methods</div>
+<div class="method">
+  <div class="title">
+    <a name="M001196"></a><b>converter</b>(name)
+  </div>
+  <div class="description">
+  <p>
+Returns the converter with the given name. This name can be a <a
+href="../Symbol.html">Symbol</a> or a <a href="../String.html">String</a>.
+</p>
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M001196_source')" id="l_M001196_source">show source</a> ]</p>
+  <div id="M001196_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/facets/more/units.rb, line 692</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">converter</span>(<span class="ruby-identifier">name</span>)
+      <span class="ruby-identifier">converters</span>[<span class="ruby-identifier">name</span>.<span class="ruby-identifier">to_sym</span>] <span class="ruby-keyword kw">or</span> <span class="ruby-identifier">raise</span> <span class="ruby-constant">ArgumentError</span>, <span class="ruby-node">&quot;No converter #{name.to_s.dump} found&quot;</span>
+    <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M001195"></a><b>current</b>()
+  </div>
+  <div class="description">
+  <p>
+Returns the current <a href="Converter.html">Converter</a> in the current
+Thread. The default converter is the one returned by
+<tt>converter(:default)</tt>. See also Units#with_converter and <a
+href="Converter.html#M001196">Converter.converter</a>.
+</p>
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M001195_source')" id="l_M001195_source">show source</a> ]</p>
+  <div id="M001195_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/facets/more/units.rb, line 674</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">current</span>
+      <span class="ruby-constant">Thread</span>.<span class="ruby-identifier">current</span>[<span class="ruby-value str">&quot;current_unit_converter&quot;</span>] <span class="ruby-operator">||=</span> <span class="ruby-identifier">converter</span>(<span class="ruby-identifier">:default</span>)
+    <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M001184"></a><b>from_yaml</b>(file)
+  </div>
+  <div class="description">
+  <p>
+Creates a new <a href="Converter.html">Converter</a>, where the data is
+loaded from the file with the given file name.
+</p>
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M001184_source')" id="l_M001184_source">show source</a> ]</p>
+  <div id="M001184_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/facets/more/units.rb, line 519</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">from_yaml</span>(<span class="ruby-identifier">file</span>)
+      <span class="ruby-constant">Units</span><span class="ruby-operator">::</span><span class="ruby-constant">Converter</span>.<span class="ruby-identifier">new</span> {
+        <span class="ruby-identifier">load_yaml</span>(<span class="ruby-identifier">file</span>)
+      }
+    <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M001185"></a><b>new</b>(&amp;blk)
+  </div>
+  <div class="description">
+  <p>
+Creates a new <a href="Converter.html">Converter</a>. If a block is given,
+it is executed in the newly created <a
+href="Converter.html">Converter</a>&#8217;s context.
+</p>
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M001185_source')" id="l_M001185_source">show source</a> ]</p>
+  <div id="M001185_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/facets/more/units.rb, line 527</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">initialize</span>(<span class="ruby-operator">&amp;</span><span class="ruby-identifier">blk</span>)
+      <span class="ruby-ivar">@loaded_yaml</span> = []
+      <span class="ruby-ivar">@conversions</span> = {}
+      <span class="ruby-identifier">instance_eval</span>(<span class="ruby-operator">&amp;</span><span class="ruby-identifier">blk</span>) <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">blk</span>
+    <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M001197"></a><b>register</b>(name, converter)
+  </div>
+  <div class="description">
+  <p>
+Registers the given <a href="Converter.html">Converter</a> under the given
+name. This name can be a <a href="../Symbol.html">Symbol</a> or a <a
+href="../String.html">String</a>.
+</p>
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M001197_source')" id="l_M001197_source">show source</a> ]</p>
+  <div id="M001197_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/facets/more/units.rb, line 698</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">register</span>(<span class="ruby-identifier">name</span>, <span class="ruby-identifier">converter</span>)
+      <span class="ruby-identifier">converters</span>[<span class="ruby-identifier">name</span>.<span class="ruby-identifier">to_sym</span>] = <span class="ruby-identifier">converter</span>
+    <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M001198"></a><b>registered_converters</b>()
+  </div>
+  <div class="description">
+  <p>
+Returns the list of names of registered converters.
+</p>
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M001198_source')" id="l_M001198_source">show source</a> ]</p>
+  <div id="M001198_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/facets/more/units.rb, line 703</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">registered_converters</span>
+      <span class="ruby-identifier">converters</span>.<span class="ruby-identifier">keys</span>
+    <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="sectiontitle">Private Class methods</div>
+<div class="method">
+  <div class="title">
+    <a name="M001206"></a><b>converters</b>()
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M001206_source')" id="l_M001206_source">show source</a> ]</p>
+  <div id="M001206_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/facets/more/units.rb, line 783</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">converters</span>
+      <span class="ruby-ivar">@converters</span> <span class="ruby-operator">||=</span> {}
+    <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="sectiontitle">Public Instance methods</div>
+<div class="method">
+  <div class="title">
+    <a name="M001194"></a><b>load_yaml</b>(file)
+  </div>
+  <div class="description">
+  <p>
+Loads data from the YAML file with the given name. Returns <tt>self</tt>.
+</p>
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M001194_source')" id="l_M001194_source">show source</a> ]</p>
+  <div id="M001194_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/facets/more/units.rb, line 634</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">load_yaml</span>(<span class="ruby-identifier">file</span>)
+      <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">if</span> <span class="ruby-ivar">@loaded_yaml</span>.<span class="ruby-identifier">include?</span> <span class="ruby-identifier">file</span>
+      <span class="ruby-identifier">data</span> = <span class="ruby-constant">YAML</span>.<span class="ruby-identifier">load_file</span>(<span class="ruby-identifier">file</span>)
+      <span class="ruby-ivar">@loaded_yaml</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">file</span>
+      <span class="ruby-identifier">old_service</span> = <span class="ruby-constant">Thread</span>.<span class="ruby-identifier">current</span>[<span class="ruby-value str">'current_currency_exchange_service'</span>]
+      <span class="ruby-identifier">data</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">r</span><span class="ruby-operator">|</span>
+        <span class="ruby-identifier">rule</span> = {}
+        <span class="ruby-identifier">r</span>.<span class="ruby-identifier">each_pair</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">k</span>, <span class="ruby-identifier">v</span><span class="ruby-operator">|</span>
+          <span class="ruby-identifier">rule</span>[<span class="ruby-identifier">k</span>.<span class="ruby-identifier">to_sym</span>] = <span class="ruby-identifier">v</span>
+        <span class="ruby-keyword kw">end</span>
+        <span class="ruby-keyword kw">case</span> <span class="ruby-identifier">rule</span>[<span class="ruby-identifier">:type</span>]
+        <span class="ruby-keyword kw">when</span> <span class="ruby-value str">'import'</span>
+          <span class="ruby-identifier">load_yaml</span>(<span class="ruby-constant">File</span>.<span class="ruby-identifier">join</span>(<span class="ruby-constant">Units</span><span class="ruby-operator">::</span><span class="ruby-constant">Config</span><span class="ruby-operator">::</span><span class="ruby-constant">DATADIR</span>, <span class="ruby-identifier">rule</span>[<span class="ruby-identifier">:file</span>] <span class="ruby-operator">+</span> <span class="ruby-value str">'.yaml'</span>))
+        <span class="ruby-keyword kw">when</span> <span class="ruby-value str">'si'</span>
+          <span class="ruby-identifier">register_si_unit</span>(<span class="ruby-identifier">rule</span>[<span class="ruby-identifier">:name</span>], <span class="ruby-identifier">rule</span>)
+        <span class="ruby-keyword kw">when</span> <span class="ruby-value str">'unit'</span>
+          <span class="ruby-identifier">register_unit</span>(<span class="ruby-identifier">rule</span>[<span class="ruby-identifier">:name</span>], <span class="ruby-identifier">rule</span>)
+        <span class="ruby-keyword kw">when</span> <span class="ruby-value str">'length'</span>
+          <span class="ruby-identifier">register_length_unit</span>(<span class="ruby-identifier">rule</span>[<span class="ruby-identifier">:name</span>], <span class="ruby-identifier">rule</span>)
+        <span class="ruby-keyword kw">when</span> <span class="ruby-value str">'binary'</span>
+          <span class="ruby-identifier">register_binary_unit</span>(<span class="ruby-identifier">rule</span>[<span class="ruby-identifier">:name</span>], <span class="ruby-identifier">rule</span>)
+        <span class="ruby-keyword kw">when</span> <span class="ruby-value str">'currency'</span>
+          <span class="ruby-identifier">register_currency</span>(<span class="ruby-identifier">rule</span>[<span class="ruby-identifier">:name</span>], <span class="ruby-constant">Thread</span>.<span class="ruby-identifier">current</span>[<span class="ruby-value str">'current_currency_exchange_service'</span>])
+        <span class="ruby-keyword kw">when</span> <span class="ruby-value str">'service'</span>
+          <span class="ruby-keyword kw">begin</span>
+            <span class="ruby-constant">Thread</span>.<span class="ruby-identifier">current</span>[<span class="ruby-value str">'current_currency_exchange_service'</span>] = <span class="ruby-constant">Units</span><span class="ruby-operator">::</span><span class="ruby-constant">Converter</span><span class="ruby-operator">::</span><span class="ruby-constant">ExchangeRate</span>.<span class="ruby-identifier">const_get</span>(<span class="ruby-identifier">rule</span>[<span class="ruby-identifier">:name</span>])
+          <span class="ruby-keyword kw">rescue</span> <span class="ruby-constant">NameError</span>
+            <span class="ruby-identifier">raise</span> <span class="ruby-constant">NameError</span>, <span class="ruby-node">&quot;Exchange service not found: #{rule[:name].to_s.dump}&quot;</span>
+          <span class="ruby-keyword kw">end</span>
+        <span class="ruby-keyword kw">else</span>
+          <span class="ruby-identifier">raise</span> <span class="ruby-node">&quot;unknown rule type #{rule[:type].to_s.dump}&quot;</span>
+        <span class="ruby-keyword kw">end</span>
+      <span class="ruby-keyword kw">end</span>
+      <span class="ruby-constant">Thread</span>.<span class="ruby-identifier">current</span>[<span class="ruby-value str">'current_currency_exchange_service'</span>] = <span class="ruby-identifier">old_service</span>
+      <span class="ruby-keyword kw">self</span>
+    <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M001193"></a><b>method_missing</b>(m, *args, &amp;blk)
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M001193_source')" id="l_M001193_source">show source</a> ]</p>
+  <div id="M001193_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/facets/more/units.rb, line 624</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">method_missing</span>(<span class="ruby-identifier">m</span>, <span class="ruby-operator">*</span><span class="ruby-identifier">args</span>, <span class="ruby-operator">&amp;</span><span class="ruby-identifier">blk</span>)
+      <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">registered?</span>(<span class="ruby-identifier">m</span>)
+        <span class="ruby-identifier">raise</span> <span class="ruby-constant">ArgumentError</span>, <span class="ruby-value str">&quot;Wrong number of arguments&quot;</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">args</span>.<span class="ruby-identifier">length</span> <span class="ruby-operator">!=</span> <span class="ruby-value">0</span>
+        <span class="ruby-keyword kw">return</span> <span class="ruby-constant">Units</span><span class="ruby-operator">::</span><span class="ruby-constant">Unit</span>.<span class="ruby-identifier">new</span>({<span class="ruby-identifier">m</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-value">1</span>}, <span class="ruby-keyword kw">self</span>)
+      <span class="ruby-keyword kw">end</span>
+      <span class="ruby-keyword kw">super</span>
+    <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M001190"></a><b>register_binary_unit</b>(unit, data = {})
+  </div>
+  <div class="description">
+  <p>
+Registers a new binary unit. The <a href="Unit.html">Unit</a> and its
+aliases are registered with all available binary prefixes (see
+BINARY_PREFIXES) as well, while the abbreviations are registered with the
+abbreviated version of the prefixes.
+</p>
+<p>
+For the syntax of the options, see <tt><a
+href="Converter.html#M001188">register_unit</a></tt>.
+</p>
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M001190_source')" id="l_M001190_source">show source</a> ]</p>
+  <div id="M001190_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/facets/more/units.rb, line 597</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">register_binary_unit</span>(<span class="ruby-identifier">unit</span>, <span class="ruby-identifier">data</span> = {})
+      <span class="ruby-identifier">register_prefixed_unit</span>(<span class="ruby-identifier">unit</span>, <span class="ruby-constant">BINARY_PREFIXES</span>, <span class="ruby-identifier">data</span>)
+    <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M001192"></a><b>register_currency</b>(curr, service = nil)
+  </div>
+  <div class="description">
+  <p>
+Registers a given currency, with a given servive to find the exchange rate
+between the given currency and a given base currency. The service should be
+a subclass of <a href="Converter/ExchangeRate.html">ExchangeRate</a>. This
+is not strictly necessary, but <a
+href="Converter/ExchangeRate.html">ExchangeRate</a> handles all of the
+magic.
+</p>
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M001192_source')" id="l_M001192_source">show source</a> ]</p>
+  <div id="M001192_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/facets/more/units.rb, line 615</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">register_currency</span>(<span class="ruby-identifier">curr</span>, <span class="ruby-identifier">service</span> = <span class="ruby-keyword kw">nil</span>)
+      <span class="ruby-identifier">service</span> <span class="ruby-operator">||=</span> <span class="ruby-constant">Units</span><span class="ruby-operator">::</span><span class="ruby-constant">Config</span><span class="ruby-operator">::</span><span class="ruby-constant">DEFAULT_CURRENCY_SERVICE</span>
+      <span class="ruby-identifier">register_unit</span>(<span class="ruby-identifier">curr</span>, <span class="ruby-identifier">:equals</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">service</span>.<span class="ruby-identifier">create_conversion</span>(<span class="ruby-identifier">curr</span>, <span class="ruby-keyword kw">self</span>))
+    <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M001191"></a><b>register_length_unit</b>(unit, data = {})
+  </div>
+  <div class="description">
+  <p>
+Registers a new length unit. The <a href="Unit.html">Unit</a> and its
+aliases are registered with all available length prefixes (see
+LENGTH_PREFIXES) as well, while the abbreviations are registered with the
+abbreviated version of the prefixes.
+</p>
+<p>
+For the syntax of the options, see <tt><a
+href="Converter.html#M001188">register_unit</a></tt>.
+</p>
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M001191_source')" id="l_M001191_source">show source</a> ]</p>
+  <div id="M001191_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/facets/more/units.rb, line 607</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">register_length_unit</span>(<span class="ruby-identifier">unit</span>, <span class="ruby-identifier">data</span> = {})
+      <span class="ruby-identifier">register_prefixed_unit</span>(<span class="ruby-identifier">unit</span>, <span class="ruby-constant">LENGTH_PREFIXES</span>, <span class="ruby-identifier">data</span>)
+    <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M001189"></a><b>register_si_unit</b>(unit, data = {})
+  </div>
+  <div class="description">
+  <p>
+Registers a new SI unit. The <a href="Unit.html">Unit</a> and its aliases
+are registered with all available SI prefixes (see SI_PREFIXES) as well,
+while the abbreviations are registered with the abbreviated version of the
+prefixes.
+</p>
+<p>
+For the syntax of the options, see <tt><a
+href="Converter.html#M001188">register_unit</a></tt>.
+</p>
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M001189_source')" id="l_M001189_source">show source</a> ]</p>
+  <div id="M001189_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/facets/more/units.rb, line 587</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">register_si_unit</span>(<span class="ruby-identifier">unit</span>, <span class="ruby-identifier">data</span> = {})
+      <span class="ruby-identifier">register_prefixed_unit</span>(<span class="ruby-identifier">unit</span>, <span class="ruby-constant">SI_PREFIXES</span>, <span class="ruby-identifier">data</span>)
+    <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M001188"></a><b>register_unit</b>(name, data = {})
+  </div>
+  <div class="description">
+  <p>
+Registers a new <a href="Unit.html">Unit</a> with the given name. The
+<tt>data</tt> parameter is a <a href="../Hash.html">Hash</a> with some
+extra parameters (can be Strings or Symbols):
+</p>
+<table>
+<tr><td valign="top"><tt>alias</tt>:</td><td>Specifies possible aliases for the <a href="Unit.html">Unit</a>.
+</td></tr>
+<tr><td valign="top"><tt>abbrev</tt>:</td><td>Specifies possible abbreviations or symbols for the <a
+href="Unit.html">Unit</a>. The differences with aliases is that prefixes
+work differently; see <tt><a
+href="Converter.html#M001189">register_si_unit</a></tt> and <tt><a
+href="Converter.html#M001190">register_binary_unit</a></tt>.
+</td></tr>
+<tr><td valign="top"><tt>equals</tt>:</td><td>If present, specifies how the <a href="Unit.html">Unit</a> depends on other
+<a href="../Units.html">Units</a>. The value for this key can either be a
+<a href="../Hash.html">Hash</a> with <tt>unit</tt> mapping to a <a
+href="Unit.html">Unit</a> and <tt>multiplier</tt> mapping to a numeric
+multiplier, or a <a href="../String.html">String</a> containing the
+multiplier, followed by a space, followed by a representation of the <a
+href="Unit.html">Unit</a> as returned by <a
+href="Unit.html#M001222">Unit#to_s</a>.
+</td></tr>
+</table>
+<p>
+Examples:
+</p>
+<pre>
+  converter.register_unit(:pint, :alias =&gt; :pints, :abbrev =&gt; [:pt, :pts]))
+  converter.register_unit(:quart, 'alias' =&gt; :quarts, :abbrev =&gt; ['qt', :qts], :equals =&gt; '2.0 pt'))
+  converter.register_unit(:gallon, :alias =&gt; :gallons, :abbrev =&gt; :gal, 'equals' =&gt; {:unit =&gt; Unit.new('qt' =&gt; 1, converter), 'multiplier' =&gt; 4.0))
+</pre>
+<p>
+Note that Symbols and Strings are generally exchangeable within this
+library (internally they are converted to Symbols). The number one reason
+for this is that <a href="../String.html">String</a> look better in YAML.
+</p>
+<p>
+See also <tt><a href="Converter.html#M001189">register_si_unit</a></tt>,
+<tt><a href="Converter.html#M001190">register_binary_unit</a></tt>, <tt><a
+href="Converter.html#M001191">register_length_unit</a></tt> and <tt><a
+href="Converter.html#M001192">register_currency</a></tt>.
+</p>
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M001188_source')" id="l_M001188_source">show source</a> ]</p>
+  <div id="M001188_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/facets/more/units.rb, line 569</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">register_unit</span>(<span class="ruby-identifier">name</span>, <span class="ruby-identifier">data</span> = {})
+      <span class="ruby-identifier">unit</span>, <span class="ruby-identifier">aliases</span>, <span class="ruby-identifier">abbrevs</span> = <span class="ruby-identifier">extract_data</span>(<span class="ruby-identifier">name</span>, <span class="ruby-identifier">data</span>, <span class="ruby-identifier">:to_sym</span>)
+      <span class="ruby-identifier">conversion</span> = <span class="ruby-identifier">data</span>[<span class="ruby-identifier">:equals</span>]
+      <span class="ruby-identifier">conversion</span> = <span class="ruby-identifier">decode_conversion</span>(<span class="ruby-identifier">conversion</span>) <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">conversion</span>
+      <span class="ruby-identifier">conversion</span> = <span class="ruby-identifier">convert_conversion</span>(<span class="ruby-identifier">conversion</span>[<span class="ruby-identifier">:unit</span>].<span class="ruby-identifier">units</span>, <span class="ruby-identifier">conversion</span>[<span class="ruby-identifier">:multiplier</span>]) <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">conversion</span>
+      <span class="ruby-identifier">register_unit_internal</span>(<span class="ruby-identifier">unit</span>, <span class="ruby-identifier">conversion</span>)
+      <span class="ruby-identifier">conversion</span> = <span class="ruby-identifier">convert_conversion</span>({<span class="ruby-identifier">unit</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-value">1</span>}, <span class="ruby-value">1</span>) <span class="ruby-keyword kw">if</span> <span class="ruby-keyword kw">not</span> <span class="ruby-identifier">conversion</span>
+      (<span class="ruby-identifier">aliases</span> <span class="ruby-operator">+</span> <span class="ruby-identifier">abbrevs</span>).<span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">u</span><span class="ruby-operator">|</span>
+        <span class="ruby-identifier">register_unit_internal</span>(<span class="ruby-identifier">u</span>, <span class="ruby-identifier">conversion</span>)
+      <span class="ruby-keyword kw">end</span>
+    <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M001186"></a><b>registered?</b>(unit)
+  </div>
+  <div class="description">
+  <p>
+Checks whether the unit with the given name is registered. The name can be
+a symbol or a string.
+</p>
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M001186_source')" id="l_M001186_source">show source</a> ]</p>
+  <div id="M001186_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/facets/more/units.rb, line 535</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">registered?</span>(<span class="ruby-identifier">unit</span>)
+      <span class="ruby-identifier">unit</span> = <span class="ruby-identifier">unit</span>.<span class="ruby-identifier">to_sym</span>
+      <span class="ruby-identifier">conversions</span>(<span class="ruby-identifier">unit</span>) <span class="ruby-operator">!=</span> <span class="ruby-keyword kw">nil</span>
+    <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M001187"></a><b>registered_units</b>()
+  </div>
+  <div class="description">
+  <p>
+Returns the list of registered unit names as symbols.
+</p>
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M001187_source')" id="l_M001187_source">show source</a> ]</p>
+  <div id="M001187_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/facets/more/units.rb, line 541</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">registered_units</span>
+      <span class="ruby-ivar">@conversions</span>.<span class="ruby-identifier">keys</span>
+    <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="sectiontitle">Private Instance methods</div>
+<div class="method">
+  <div class="title">
+    <a name="M001199"></a><b>clean_eval</b>(some_name_noone_uses)
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M001199_source')" id="l_M001199_source">show source</a> ]</p>
+  <div id="M001199_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/facets/more/units.rb, line 709</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">clean_eval</span>(<span class="ruby-identifier">some_name_noone_uses</span>)
+      <span class="ruby-identifier">eval</span> <span class="ruby-identifier">some_name_noone_uses</span>, <span class="ruby-identifier">binding</span>, <span class="ruby-keyword kw">__FILE__</span>, <span class="ruby-keyword kw">__LINE__</span>
+    <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M001205"></a><b>conversions</b>(unit)
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M001205_source')" id="l_M001205_source">show source</a> ]</p>
+  <div id="M001205_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/facets/more/units.rb, line 779</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">conversions</span>(<span class="ruby-identifier">unit</span>)
+      <span class="ruby-ivar">@conversions</span>[<span class="ruby-identifier">unit</span>] <span class="ruby-operator">||</span> (<span class="ruby-identifier">unit</span> <span class="ruby-operator">==</span> ??{<span class="ruby-operator">-</span><span class="ruby-operator">-</span><span class="ruby-identifier">base</span><span class="ruby-operator">-</span><span class="ruby-identifier">currency</span><span class="ruby-operator">-</span><span class="ruby-operator">-</span>} <span class="ruby-operator">?</span> <span class="ruby-identifier">:none</span> <span class="ruby-operator">:</span> <span class="ruby-keyword kw">nil</span>)
+    <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M001204"></a><b>convert_conversion</b>(units, multiplier = nil)
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M001204_source')" id="l_M001204_source">show source</a> ]</p>
+  <div id="M001204_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/facets/more/units.rb, line 765</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">convert_conversion</span>(<span class="ruby-identifier">units</span>, <span class="ruby-identifier">multiplier</span> = <span class="ruby-keyword kw">nil</span>)
+      <span class="ruby-identifier">multiplier</span> <span class="ruby-operator">||=</span> <span class="ruby-value">1</span>
+      <span class="ruby-identifier">base_units</span> = {}
+      <span class="ruby-identifier">other_units</span> = {}
+      <span class="ruby-identifier">units</span>.<span class="ruby-identifier">each_pair</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">u</span>, <span class="ruby-identifier">e</span><span class="ruby-operator">|</span>
+        (<span class="ruby-identifier">conversions</span>(<span class="ruby-identifier">u</span>) <span class="ruby-operator">!=</span> <span class="ruby-identifier">:none</span> <span class="ruby-operator">?</span> <span class="ruby-identifier">other_units</span> <span class="ruby-operator">:</span> <span class="ruby-identifier">base_units</span>)[<span class="ruby-identifier">u</span>] = <span class="ruby-identifier">e</span>
+      <span class="ruby-keyword kw">end</span>
+      <span class="ruby-identifier">result</span> = <span class="ruby-constant">Conversion</span>.<span class="ruby-identifier">new</span>(<span class="ruby-constant">Units</span><span class="ruby-operator">::</span><span class="ruby-constant">Unit</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">base_units</span>, <span class="ruby-keyword kw">self</span>), <span class="ruby-identifier">multiplier</span>)
+      <span class="ruby-identifier">other_units</span>.<span class="ruby-identifier">each_pair</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">u</span>, <span class="ruby-identifier">e</span><span class="ruby-operator">|</span>
+        <span class="ruby-identifier">result</span> <span class="ruby-operator">*=</span> (<span class="ruby-identifier">conversions</span>(<span class="ruby-identifier">u</span>) <span class="ruby-operator">**</span> <span class="ruby-identifier">e</span>)
+      <span class="ruby-keyword kw">end</span>
+      <span class="ruby-identifier">result</span>
+    <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M001203"></a><b>decode_conversion</b>(data)
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M001203_source')" id="l_M001203_source">show source</a> ]</p>
+  <div id="M001203_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/facets/more/units.rb, line 746</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">decode_conversion</span>(<span class="ruby-identifier">data</span>)
+      <span class="ruby-keyword kw">if</span> <span class="ruby-keyword kw">not</span> <span class="ruby-identifier">data</span>.<span class="ruby-identifier">is_a?</span> <span class="ruby-constant">String</span>
+        <span class="ruby-keyword kw">return</span> {<span class="ruby-identifier">:unit</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">data</span>[<span class="ruby-identifier">:unit</span>] <span class="ruby-operator">||</span> <span class="ruby-identifier">data</span>[<span class="ruby-value str">'unit'</span>],
+                <span class="ruby-identifier">:multiplier</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">data</span>[<span class="ruby-identifier">:multiplier</span>] <span class="ruby-operator">||</span> <span class="ruby-identifier">data</span>[<span class="ruby-value str">'multiplier'</span>]}
+      <span class="ruby-keyword kw">end</span>
+      <span class="ruby-identifier">data</span>.<span class="ruby-identifier">rstrip!</span>
+      <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">m</span> = <span class="ruby-regexp re">/^(\d+(\.\d+(?:[eE][-+]?\d+)?)?(?:\s+|$))?(.+)?$/</span>.<span class="ruby-identifier">match</span>(<span class="ruby-identifier">data</span>)
+        <span class="ruby-identifier">unit</span> = <span class="ruby-identifier">m</span>[<span class="ruby-value">3</span>] <span class="ruby-operator">?</span> <span class="ruby-identifier">clean_eval</span>(<span class="ruby-identifier">m</span>[<span class="ruby-value">3</span>].<span class="ruby-identifier">gsub</span>(<span class="ruby-regexp re">/\b([A-Z]\w*|in)\b/</span>, <span class="ruby-value str">'self.\1'</span>)) <span class="ruby-operator">:</span> <span class="ruby-constant">Units</span><span class="ruby-operator">::</span><span class="ruby-constant">Unit</span>.<span class="ruby-identifier">new</span>({}, <span class="ruby-keyword kw">self</span>)
+        <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">m</span>[<span class="ruby-value">1</span>]
+          <span class="ruby-identifier">multiplier</span> = <span class="ruby-identifier">m</span>[<span class="ruby-value">2</span>] <span class="ruby-operator">?</span> <span class="ruby-constant">Float</span>(<span class="ruby-identifier">m</span>[<span class="ruby-value">1</span>]) <span class="ruby-operator">:</span> <span class="ruby-constant">Integer</span>(<span class="ruby-identifier">m</span>[<span class="ruby-value">1</span>])
+          {<span class="ruby-identifier">:unit</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">unit</span>, <span class="ruby-identifier">:multiplier</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">multiplier</span>}
+        <span class="ruby-keyword kw">else</span>
+          {<span class="ruby-identifier">:unit</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">unit</span>}
+        <span class="ruby-keyword kw">end</span>
+      <span class="ruby-keyword kw">else</span>
+        <span class="ruby-identifier">raise</span> <span class="ruby-constant">ArgumentError</span>, <span class="ruby-value str">&quot;Wrong unit string&quot;</span>
+      <span class="ruby-keyword kw">end</span>
+    <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M001202"></a><b>extract_data</b>(unit, data, conv)
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M001202_source')" id="l_M001202_source">show source</a> ]</p>
+  <div id="M001202_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/facets/more/units.rb, line 736</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">extract_data</span>(<span class="ruby-identifier">unit</span>, <span class="ruby-identifier">data</span>, <span class="ruby-identifier">conv</span>)
+      <span class="ruby-identifier">sarray</span> = <span class="ruby-identifier">proc</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">k</span><span class="ruby-operator">|</span>
+        <span class="ruby-identifier">list</span> = <span class="ruby-identifier">data</span>[<span class="ruby-identifier">k</span>] <span class="ruby-operator">||</span> []
+        <span class="ruby-identifier">list</span> = [<span class="ruby-identifier">list</span>] <span class="ruby-keyword kw">if</span> <span class="ruby-keyword kw">not</span> <span class="ruby-identifier">list</span>.<span class="ruby-identifier">is_a?</span> <span class="ruby-constant">Array</span>
+        <span class="ruby-identifier">list</span>.<span class="ruby-identifier">map</span> { <span class="ruby-operator">|</span><span class="ruby-identifier">a</span><span class="ruby-operator">|</span> <span class="ruby-identifier">a</span>.<span class="ruby-identifier">send</span>(<span class="ruby-identifier">conv</span>) }
+      <span class="ruby-keyword kw">end</span>
+      <span class="ruby-identifier">unit</span> = <span class="ruby-identifier">unit</span>.<span class="ruby-identifier">send</span>(<span class="ruby-identifier">conv</span>)
+      <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">unit</span>, <span class="ruby-identifier">sarray</span>[<span class="ruby-identifier">:alias</span>], <span class="ruby-identifier">sarray</span>[<span class="ruby-identifier">:abbrev</span>].<span class="ruby-identifier">select</span> { <span class="ruby-operator">|</span><span class="ruby-identifier">a</span><span class="ruby-operator">|</span> <span class="ruby-identifier">a</span> <span class="ruby-operator">!=</span> <span class="ruby-identifier">unit</span> }
+    <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M001201"></a><b>register_prefixed_unit</b>(unit, prefixes, data = {})
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M001201_source')" id="l_M001201_source">show source</a> ]</p>
+  <div id="M001201_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/facets/more/units.rb, line 718</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">register_prefixed_unit</span>(<span class="ruby-identifier">unit</span>, <span class="ruby-identifier">prefixes</span>, <span class="ruby-identifier">data</span> = {})
+      <span class="ruby-identifier">unit</span>, <span class="ruby-identifier">aliases</span>, <span class="ruby-identifier">abbrevs</span> = <span class="ruby-identifier">extract_data</span>(<span class="ruby-identifier">unit</span>, <span class="ruby-identifier">data</span>, <span class="ruby-identifier">:to_s</span>)
+      <span class="ruby-identifier">register_unit</span>(<span class="ruby-identifier">unit</span>, <span class="ruby-identifier">:equals</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">data</span>[<span class="ruby-identifier">:equals</span>], <span class="ruby-identifier">:alias</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">aliases</span>, <span class="ruby-identifier">:abbrev</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">abbrevs</span>)
+      <span class="ruby-identifier">unit_sym</span> = <span class="ruby-identifier">unit</span>.<span class="ruby-identifier">to_sym</span>
+      <span class="ruby-identifier">prefixes</span>.<span class="ruby-identifier">each_pair</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">pre</span>,<span class="ruby-identifier">info</span><span class="ruby-operator">|</span>
+        <span class="ruby-identifier">abbrev</span> = <span class="ruby-identifier">info</span>[<span class="ruby-identifier">:abbrev</span>]
+        <span class="ruby-identifier">multiplier</span> = <span class="ruby-identifier">info</span>[<span class="ruby-identifier">:multiplier</span>] <span class="ruby-operator">||</span> <span class="ruby-value">1</span>
+        <span class="ruby-identifier">power</span> = <span class="ruby-identifier">info</span>[<span class="ruby-identifier">:power</span>] <span class="ruby-operator">||</span> <span class="ruby-value">1</span>
+        <span class="ruby-identifier">register_unit</span>(<span class="ruby-identifier">pre</span> <span class="ruby-operator">+</span> <span class="ruby-identifier">unit</span>, <span class="ruby-identifier">:equals</span> =<span class="ruby-operator">&gt;</span> {<span class="ruby-identifier">:unit</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-constant">Units</span><span class="ruby-operator">::</span><span class="ruby-constant">Unit</span>.<span class="ruby-identifier">new</span>({<span class="ruby-identifier">unit_sym</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">power</span>}, <span class="ruby-keyword kw">self</span>), <span class="ruby-identifier">:multiplier</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">multiplier</span>})
+        <span class="ruby-identifier">aliases</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">a</span><span class="ruby-operator">|</span>
+          <span class="ruby-identifier">register_unit</span>(<span class="ruby-identifier">pre</span> <span class="ruby-operator">+</span> <span class="ruby-identifier">a</span>, <span class="ruby-identifier">:equals</span> =<span class="ruby-operator">&gt;</span> {<span class="ruby-identifier">:unit</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-constant">Units</span><span class="ruby-operator">::</span><span class="ruby-constant">Unit</span>.<span class="ruby-identifier">new</span>({<span class="ruby-identifier">unit_sym</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">power</span>}, <span class="ruby-keyword kw">self</span>), <span class="ruby-identifier">:multiplier</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">multiplier</span>})
+        <span class="ruby-keyword kw">end</span>
+        <span class="ruby-identifier">abbrevs</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">a</span><span class="ruby-operator">|</span>
+          <span class="ruby-identifier">register_unit</span>(<span class="ruby-identifier">abbrev</span> <span class="ruby-operator">+</span> <span class="ruby-identifier">a</span>, <span class="ruby-identifier">:equals</span> =<span class="ruby-operator">&gt;</span> {<span class="ruby-identifier">:unit</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-constant">Units</span><span class="ruby-operator">::</span><span class="ruby-constant">Unit</span>.<span class="ruby-identifier">new</span>({<span class="ruby-identifier">unit_sym</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">power</span>}, <span class="ruby-keyword kw">self</span>), <span class="ruby-identifier">:multiplier</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">multiplier</span>})
+        <span class="ruby-keyword kw">end</span>
+      <span class="ruby-keyword kw">end</span>
+    <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M001200"></a><b>register_unit_internal</b>(unit, conversion)
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M001200_source')" id="l_M001200_source">show source</a> ]</p>
+  <div id="M001200_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/facets/more/units.rb, line 713</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">register_unit_internal</span>(<span class="ruby-identifier">unit</span>, <span class="ruby-identifier">conversion</span>)
+      <span class="ruby-identifier">raise</span> <span class="ruby-node">&quot;unit #{unit.to_s.dump} already registered with #{self}&quot;</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">registered?</span> <span class="ruby-identifier">unit</span>
+      <span class="ruby-ivar">@conversions</span>[<span class="ruby-identifier">unit</span>] = <span class="ruby-identifier">conversion</span> <span class="ruby-operator">||</span> <span class="ruby-identifier">:none</span>
+    <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+</div>
+  </div>
+    </body>
+</html>