RubyGems - facets - Versions diffs - 2.5.2 → 2.6.0 - Mend

facets 2.5.2 → 2.6.0

Files changed (677) hide show

data/doc/rdoc/core/classes/Stackable.html DELETED

@@ -1,262 +0,0 @@
-<?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>Module: Stackable</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 = "+"
-          }
-          else
-          {
-            elem.style.display = "block"
-            link.innerHTML = "-"
-          }
-        }
-        function openCode( url )
-        {
-          window.open( url, "SOURCE_CODE", "resizable=yes,scrollbars=yes,toolbar=no,status=no,height=480,width=750" ).focus();
-        }
-      // ]]>
-    </script>
-  </head>
-  <body>
-  <table width="100%" border='0' cellpadding='0' cellspacing='0' class='banner'><tr>
-  <td class="file-title"><span class="file-title-prefix">Module</span><br />Stackable</td>
-  <td align="right">
-    <table cellspacing="0" cellpadding="2">
-      <tr valign="top">
-        <td>In:</td>
-        <td>
-<a href="../files/lib/core/facets/stackable_rb.html">lib/core/facets/stackable.rb</a>
-        </td>
-      </tr>
-         </table>
-        </td>
-        </tr>
-      </table>
- <!-- banner header -->
-  <div id="bodyContent">
-      <div id="content">
-  <div class="description"><h1><a href="Stackable.html">Stackable</a></h1>
-<p>
-<a href="Stackable.html">Stackable</a> mixin provides <a
-href="Stackable.html#M000353">pop</a>, <a
-href="Stackable.html#M000354">push</a>, <a
-href="Stackable.html#M000355">pull</a>, etc. It depends on slice, splice
-and insert.
-</p>
-</div>
-  <div class="sectiontitle">Methods</div>
-  <span style="padding-right: 5px;"><a href="#M000359">peek</a></span>
-  <span style="padding-right: 5px;"><a href="#M000357">poke</a></span>
-  <span style="padding-right: 5px;"><a href="#M000353">pop</a></span>
-  <span style="padding-right: 5px;"><a href="#M000355">pull</a></span>
-  <span style="padding-right: 5px;"><a href="#M000354">push</a></span>
-  <span style="padding-right: 5px;"><a href="#M000356">shift</a></span>
-  <span style="padding-right: 5px;"><a href="#M000358">unshift</a></span>
-<div class="sectiontitle">Public Instance methods</div>
-<div class="method">
-  <div class="title">
-    <a name="M000359"></a><b>peek</b>()
-  </div>
-  <div class="description">
-  <p>
-Peek at the top of the stack.
-</p>
-<pre>
-  a = [1, 2, 3]
-  a.peek          #=&gt; 3
-  a               #=&gt; [1, 2, 3]
-</pre>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000359_source')" id="l_M000359_source">+</a> ]</p>
-  <div id="M000359_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/stackable.rb, line 81</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">peek</span>
-    <span class="ruby-identifier">slice</span>(<span class="ruby-value">-1</span>)
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000357"></a><b>poke</b>(x)
-  </div>
-  <div class="description">
-  <p>
-Poke item onto the stack.
-</p>
-<pre>
-  a = [2, 3]
-  a.poke(1)       #=&gt; [1, 2, 3]
-  TODO: Better name (besides unshift)?
-</pre>
-  </div>
-<div class="aka">
-  This method is also aliased as
-  <a href="Stackable.html#M000358">unshift</a>
-</div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000357_source')" id="l_M000357_source">+</a> ]</p>
-  <div id="M000357_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/stackable.rb, line 69</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">poke</span>(<span class="ruby-identifier">x</span>)
-    <span class="ruby-identifier">insert</span>(<span class="ruby-value">0</span>,<span class="ruby-identifier">x</span>)
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000353"></a><b>pop</b>()
-  </div>
-  <div class="description">
-  <p>
-Pop item off stack.
-</p>
-<pre>
-  a = [1, 2, 3]
-  a.pop           #=&gt; 3
-  a               #=&gt; [1, 2]
-</pre>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000353_source')" id="l_M000353_source">+</a> ]</p>
-  <div id="M000353_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/stackable.rb, line 37</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">pop</span>
-    <span class="ruby-identifier">splice</span>(<span class="ruby-value">-1</span>)
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000355"></a><b>pull</b>()
-  </div>
-  <div class="description">
-  <p>
-Pull item off the stack.
-</p>
-<pre>
-  a = [1, 2, 3]
-  a.pull          #=&gt; 1
-  a               #=&gt; [2, 3]
-</pre>
-  </div>
-<div class="aka">
-  This method is also aliased as
-  <a href="Stackable.html#M000356">shift</a>
-</div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000355_source')" id="l_M000355_source">+</a> ]</p>
-  <div id="M000355_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/stackable.rb, line 56</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">pull</span>
-    <span class="ruby-identifier">slice</span>(<span class="ruby-value">0</span>)
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000354"></a><b>push</b>(x)
-  </div>
-  <div class="description">
-  <p>
-Push item onto the stack.
-</p>
-<pre>
-  a = [1, 2]
-  a.push(3)       #=&gt; [1, 2, 3]
-</pre>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000354_source')" id="l_M000354_source">+</a> ]</p>
-  <div id="M000354_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/stackable.rb, line 46</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">push</span>(<span class="ruby-identifier">x</span>)
-    <span class="ruby-identifier">insert</span>(<span class="ruby-value">-1</span>,<span class="ruby-identifier">x</span>)
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000356"></a><b>shift</b>()
-  </div>
-  <div class="description">
-  <p>
-Alias for <a href="Stackable.html#M000355">pull</a>
-</p>
-  </div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000358"></a><b>unshift</b>(x)
-  </div>
-  <div class="description">
-  <p>
-Alias for <a href="Stackable.html#M000357">poke</a>
-</p>
-  </div>
-</div>
-</div>
-  </div>
-    </body>
-</html>

data/doc/rdoc/core/classes/String.html DELETED

@@ -1,2332 +0,0 @@
-<?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: String</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 = "+"
-          }
-          else
-          {
-            elem.style.display = "block"
-            link.innerHTML = "-"
-          }
-        }
-        function openCode( url )
-        {
-          window.open( url, "SOURCE_CODE", "resizable=yes,scrollbars=yes,toolbar=no,status=no,height=480,width=750" ).focus();
-        }
-      // ]]>
-    </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 />String</td>
-  <td align="right">
-    <table cellspacing="0" cellpadding="2">
-      <tr valign="top">
-        <td>In:</td>
-        <td>
-<a href="../files/lib/core/facets/boolean_rb.html">lib/core/facets/boolean.rb</a>
-<a href="../files/lib/core/facets/comparable/cmp_rb.html">lib/core/facets/comparable/cmp.rb</a>
-<a href="../files/lib/core/facets/string/shatter_rb.html">lib/core/facets/string/shatter.rb</a>
-<a href="../files/lib/core/facets/string/file_rb.html">lib/core/facets/string/file.rb</a>
-<a href="../files/lib/core/facets/string/to_re_rb.html">lib/core/facets/string/to_re.rb</a>
-<a href="../files/lib/core/facets/string/fold_rb.html">lib/core/facets/string/fold.rb</a>
-<a href="../files/lib/core/facets/string/start_with_rb.html">lib/core/facets/string/start_with.rb</a>
-<a href="../files/lib/core/facets/string/camelcase_rb.html">lib/core/facets/string/camelcase.rb</a>
-<a href="../files/lib/core/facets/string/lines_rb.html">lib/core/facets/string/lines.rb</a>
-<a href="../files/lib/core/facets/string/modulize_rb.html">lib/core/facets/string/modulize.rb</a>
-<a href="../files/lib/core/facets/string/word_wrap_rb.html">lib/core/facets/string/word_wrap.rb</a>
-<a href="../files/lib/core/facets/string/align_rb.html">lib/core/facets/string/align.rb</a>
-<a href="../files/lib/core/facets/string/tab_rb.html">lib/core/facets/string/tab.rb</a>
-<a href="../files/lib/core/facets/string/methodize_rb.html">lib/core/facets/string/methodize.rb</a>
-<a href="../files/lib/core/facets/string/op_sub_rb.html">lib/core/facets/string/op_sub.rb</a>
-<a href="../files/lib/core/facets/string/compress_lines_rb.html">lib/core/facets/string/compress_lines.rb</a>
-<a href="../files/lib/core/facets/string/range_rb.html">lib/core/facets/string/range.rb</a>
-<a href="../files/lib/core/facets/string/snakecase_rb.html">lib/core/facets/string/snakecase.rb</a>
-<a href="../files/lib/core/facets/string/each_char_rb.html">lib/core/facets/string/each_char.rb</a>
-<a href="../files/lib/core/facets/string/divide_rb.html">lib/core/facets/string/divide.rb</a>
-<a href="../files/lib/core/facets/string/margin_rb.html">lib/core/facets/string/margin.rb</a>
-<a href="../files/lib/core/facets/string/mscan_rb.html">lib/core/facets/string/mscan.rb</a>
-<a href="../files/lib/core/facets/string/capitalized_rb.html">lib/core/facets/string/capitalized.rb</a>
-<a href="../files/lib/core/facets/string/expand_tab_rb.html">lib/core/facets/string/expand_tab.rb</a>
-<a href="../files/lib/core/facets/string/natcmp_rb.html">lib/core/facets/string/natcmp.rb</a>
-<a href="../files/lib/core/facets/string/variablize_rb.html">lib/core/facets/string/variablize.rb</a>
-<a href="../files/lib/core/facets/string/bytes_rb.html">lib/core/facets/string/bytes.rb</a>
-<a href="../files/lib/core/facets/string/pathize_rb.html">lib/core/facets/string/pathize.rb</a>
-<a href="../files/lib/core/facets/string/indent_rb.html">lib/core/facets/string/indent.rb</a>
-<a href="../files/lib/core/facets/string/titlecase_rb.html">lib/core/facets/string/titlecase.rb</a>
-<a href="../files/lib/core/facets/string/tabto_rb.html">lib/core/facets/string/tabto.rb</a>
-<a href="../files/lib/core/facets/string/words_rb.html">lib/core/facets/string/words.rb</a>
-<a href="../files/lib/core/facets/string/interpolate_rb.html">lib/core/facets/string/interpolate.rb</a>
-<a href="../files/lib/core/facets/string/cleave_rb.html">lib/core/facets/string/cleave.rb</a>
-<a href="../files/lib/core/facets/string/line_wrap_rb.html">lib/core/facets/string/line_wrap.rb</a>
-<a href="../files/lib/core/facets/string/bracket_rb.html">lib/core/facets/string/bracket.rb</a>
-<a href="../files/lib/core/facets/string/chars_rb.html">lib/core/facets/string/chars.rb</a>
-<a href="../files/lib/core/facets/string/chomp_rb.html">lib/core/facets/string/chomp.rb</a>
-<a href="../files/lib/core/facets/string/splice_rb.html">lib/core/facets/string/splice.rb</a>
-<a href="../files/lib/core/facets/string/rewrite_rb.html">lib/core/facets/string/rewrite.rb</a>
-<a href="../files/lib/core/facets/string/nchar_rb.html">lib/core/facets/string/nchar.rb</a>
-<a href="../files/lib/core/facets/string/xor_rb.html">lib/core/facets/string/xor.rb</a>
-<a href="../files/lib/core/facets/string/each_word_rb.html">lib/core/facets/string/each_word.rb</a>
-<a href="../files/lib/core/facets/blank_rb.html">lib/core/facets/blank.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="sectiontitle">Methods</div>
-  <span style="padding-right: 5px;"><a href="#M000289">-</a></span>
-  <span style="padding-right: 5px;"><a href="#M000329">^</a></span>
-  <span style="padding-right: 5px;"><a href="#M000283">align</a></span>
-  <span style="padding-right: 5px;"><a href="#M000286">align_center</a></span>
-  <span style="padding-right: 5px;"><a href="#M000285">align_left</a></span>
-  <span style="padding-right: 5px;"><a href="#M000284">align_right</a></span>
-  <span style="padding-right: 5px;"><a href="#M000331">blank?</a></span>
-  <span style="padding-right: 5px;"><a href="#M000317">bracket</a></span>
-  <span style="padding-right: 5px;"><a href="#M000318">bracket!</a></span>
-  <span style="padding-right: 5px;"><a href="#M000307">bytes</a></span>
-  <span style="padding-right: 5px;"><a href="#M000278">camelcase</a></span>
-  <span style="padding-right: 5px;"><a href="#M000300">capitalized?</a></span>
-  <span style="padding-right: 5px;"><a href="#M000323">chars</a></span>
-  <span style="padding-right: 5px;"><a href="#M000315">cleave</a></span>
-  <span style="padding-right: 5px;"><a href="#M000270">cmp</a></span>
-  <span style="padding-right: 5px;"><a href="#M000290">compress_lines</a></span>
-  <span style="padding-right: 5px;"><a href="#M000322">dequote</a></span>
-  <span style="padding-right: 5px;"><a href="#M000297">divide</a></span>
-  <span style="padding-right: 5px;"><a href="#M000301">downcase?</a></span>
-  <span style="padding-right: 5px;"><a href="#M000296">each_char</a></span>
-  <span style="padding-right: 5px;"><a href="#M000330">each_word</a></span>
-  <span style="padding-right: 5px;"><a href="#M000277">end_with?</a></span>
-  <span style="padding-right: 5px;"><a href="#M000303">expand_tab</a></span>
-  <span style="padding-right: 5px;"><a href="#M000304">expand_tabs</a></span>
-  <span style="padding-right: 5px;"><a href="#M000272">file</a></span>
-  <span style="padding-right: 5px;"><a href="#M000275">fold</a></span>
-  <span style="padding-right: 5px;"><a href="#M000309">indent</a></span>
-  <span style="padding-right: 5px;"><a href="#M000294">index_all</a></span>
-  <span style="padding-right: 5px;"><a href="#M000314">interpolate</a></span>
-  <span style="padding-right: 5px;"><a href="#M000324">lchomp</a></span>
-  <span style="padding-right: 5px;"><a href="#M000325">lchomp!</a></span>
-  <span style="padding-right: 5px;"><a href="#M000316">line_wrap</a></span>
-  <span style="padding-right: 5px;"><a href="#M000279">lines</a></span>
-  <span style="padding-right: 5px;"><a href="#M000298">margin</a></span>
-  <span style="padding-right: 5px;"><a href="#M000288">methodize</a></span>
-  <span style="padding-right: 5px;"><a href="#M000280">modulize</a></span>
-  <span style="padding-right: 5px;"><a href="#M000299">mscan</a></span>
-  <span style="padding-right: 5px;"><a href="#M000305">natcmp</a></span>
-  <span style="padding-right: 5px;"><a href="#M000328">nchar</a></span>
-  <span style="padding-right: 5px;"><a href="#M000310">outdent</a></span>
-  <span style="padding-right: 5px;"><a href="#M000308">pathize</a></span>
-  <span style="padding-right: 5px;"><a href="#M000321">quote</a></span>
-  <span style="padding-right: 5px;"><a href="#M000291">range</a></span>
-  <span style="padding-right: 5px;"><a href="#M000292">range_all</a></span>
-  <span style="padding-right: 5px;"><a href="#M000293">range_of_line</a></span>
-  <span style="padding-right: 5px;"><a href="#M000327">rewrite</a></span>
-  <span style="padding-right: 5px;"><a href="#M000271">shatter</a></span>
-  <span style="padding-right: 5px;"><a href="#M000295">snakecase</a></span>
-  <span style="padding-right: 5px;"><a href="#M000326">splice</a></span>
-  <span style="padding-right: 5px;"><a href="#M000276">start_with?</a></span>
-  <span style="padding-right: 5px;"><a href="#M000287">tab</a></span>
-  <span style="padding-right: 5px;"><a href="#M000312">tabto</a></span>
-  <span style="padding-right: 5px;"><a href="#M000311">titlecase</a></span>
-  <span style="padding-right: 5px;"><a href="#M000269">to_b</a></span>
-  <span style="padding-right: 5px;"><a href="#M000273">to_re</a></span>
-  <span style="padding-right: 5px;"><a href="#M000274">to_rx</a></span>
-  <span style="padding-right: 5px;"><a href="#M000319">unbracket</a></span>
-  <span style="padding-right: 5px;"><a href="#M000320">unbracket!</a></span>
-  <span style="padding-right: 5px;"><a href="#M000302">upcase?</a></span>
-  <span style="padding-right: 5px;"><a href="#M000306">variablize</a></span>
-  <span style="padding-right: 5px;"><a href="#M000281">word_wrap</a></span>
-  <span style="padding-right: 5px;"><a href="#M000282">word_wrap!</a></span>
-  <span style="padding-right: 5px;"><a href="#M000313">words</a></span>
-  <div class="sectiontitle">Constants</div>
-  <table border='0' cellpadding='5'>
-  <tr valign='top'>
-    <td class="attr-name">BRA2KET</td>
-    <td>=</td>
-    <td class="attr-value">{ '['=&gt;']', '('=&gt;')', '{'=&gt;'}', '&lt;'=&gt;'&gt;' }</td>
-  </tr>
-  </table>
-<div class="sectiontitle">Public Class methods</div>
-<div class="method">
-  <div class="title">
-    <a name="M000314"></a><b>interpolate</b>(&amp;str)
-  </div>
-  <div class="description">
-  <p>
-Interpolate. Provides a means of extenally using Ruby string interpolation
-mechinism.
-</p>
-<pre>
-  try = &quot;hello&quot;
-  str = &quot;\#{try}!!!&quot;
-  String.interpolate{ str }    #=&gt; &quot;hello!!!&quot;
-  NOTE: The block neccessary in order to get
-        then binding of the caller.
-</pre>
-<p>
-CREDIT: Trans
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000314_source')" id="l_M000314_source">+</a> ]</p>
-  <div id="M000314_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/string/interpolate.rb, line 15</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">interpolate</span>(<span class="ruby-operator">&amp;</span><span class="ruby-identifier">str</span>)
-    <span class="ruby-identifier">eval</span> <span class="ruby-node">&quot;%{#{str.call}}&quot;</span>, <span class="ruby-identifier">str</span>.<span class="ruby-identifier">binding</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="M000289"></a><b>-</b>(pattern)
-  </div>
-  <div class="description">
-  <p>
-Removes occurances of a string or regexp.
-</p>
-<pre>
-  &quot;HELLO HELLO&quot; - &quot;LL&quot;    #=&gt; &quot;HEO HEO&quot;
-</pre>
-<p>
-CREDIT: Benjamin David Oakes
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000289_source')" id="l_M000289_source">+</a> ]</p>
-  <div id="M000289_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/string/op_sub.rb, line 9</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-operator">-</span>(<span class="ruby-identifier">pattern</span>)
-    <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">gsub</span>(<span class="ruby-identifier">pattern</span>, <span class="ruby-value str">''</span>)
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000329"></a><b>^</b>(aString)
-  </div>
-  <div class="description">
-  <p>
-Binary XOR of two strings.
-</p>
-<pre>
-  puts &quot;\000\000\001\001&quot; ^ &quot;\000\001\000\001&quot;
-  puts  &quot;\003\003\003&quot; ^ &quot;\000\001\002&quot;
-</pre>
-<p>
-<em>produces</em>
-</p>
-<pre>
-  &quot;\000\001\001\000&quot;
-  &quot;\003\002\001&quot;
-</pre>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000329_source')" id="l_M000329_source">+</a> ]</p>
-  <div id="M000329_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/string/xor.rb, line 13</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-operator">^</span>(<span class="ruby-identifier">aString</span>)
-    <span class="ruby-identifier">a</span> = <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">unpack</span>(<span class="ruby-value str">'C'</span><span class="ruby-operator">*</span>(<span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">length</span>))
-    <span class="ruby-identifier">b</span> = <span class="ruby-identifier">aString</span>.<span class="ruby-identifier">unpack</span>(<span class="ruby-value str">'C'</span><span class="ruby-operator">*</span>(<span class="ruby-identifier">aString</span>.<span class="ruby-identifier">length</span>))
-    <span class="ruby-keyword kw">if</span> (<span class="ruby-identifier">b</span>.<span class="ruby-identifier">length</span> <span class="ruby-operator">&lt;</span> <span class="ruby-identifier">a</span>.<span class="ruby-identifier">length</span>)
-      (<span class="ruby-identifier">a</span>.<span class="ruby-identifier">length</span> <span class="ruby-operator">-</span> <span class="ruby-identifier">b</span>.<span class="ruby-identifier">length</span>).<span class="ruby-identifier">times</span> { <span class="ruby-identifier">b</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-value">0</span> }
-    <span class="ruby-keyword kw">end</span>
-    <span class="ruby-identifier">xor</span> = <span class="ruby-value str">&quot;&quot;</span>
-    <span class="ruby-value">0</span>.<span class="ruby-identifier">upto</span>(<span class="ruby-identifier">a</span>.<span class="ruby-identifier">length</span><span class="ruby-operator">-</span><span class="ruby-value">1</span>) { <span class="ruby-operator">|</span><span class="ruby-identifier">pos</span><span class="ruby-operator">|</span>
-      <span class="ruby-identifier">x</span> = <span class="ruby-identifier">a</span>[<span class="ruby-identifier">pos</span>] <span class="ruby-operator">^</span> <span class="ruby-identifier">b</span>[<span class="ruby-identifier">pos</span>]
-      <span class="ruby-identifier">xor</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">x</span>.<span class="ruby-identifier">chr</span>()
-    }
-    <span class="ruby-keyword kw">return</span>(<span class="ruby-identifier">xor</span>)
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000283"></a><b>align</b>(direction, n, sep=&quot;\n&quot;, c=' ')
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000283_source')" id="l_M000283_source">+</a> ]</p>
-  <div id="M000283_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/string/align.rb, line 3</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">align</span>(<span class="ruby-identifier">direction</span>, <span class="ruby-identifier">n</span>, <span class="ruby-identifier">sep</span>=<span class="ruby-value str">&quot;\n&quot;</span>, <span class="ruby-identifier">c</span>=<span class="ruby-value str">' '</span>)
-    <span class="ruby-keyword kw">case</span> <span class="ruby-identifier">direction</span>
-    <span class="ruby-keyword kw">when</span> <span class="ruby-identifier">:right</span>
-      <span class="ruby-identifier">align_right</span>(<span class="ruby-identifier">n</span>, <span class="ruby-identifier">sep</span>=<span class="ruby-value str">&quot;\n&quot;</span>, <span class="ruby-identifier">c</span>=<span class="ruby-value str">' '</span>)
-    <span class="ruby-keyword kw">when</span> <span class="ruby-identifier">:left</span>
-      <span class="ruby-identifier">align_left</span>(<span class="ruby-identifier">n</span>, <span class="ruby-identifier">sep</span>=<span class="ruby-value str">&quot;\n&quot;</span>, <span class="ruby-identifier">c</span>=<span class="ruby-value str">' '</span>)
-    <span class="ruby-keyword kw">when</span> <span class="ruby-identifier">:center</span>
-      <span class="ruby-identifier">align_center</span>(<span class="ruby-identifier">n</span>, <span class="ruby-identifier">sep</span>=<span class="ruby-value str">&quot;\n&quot;</span>, <span class="ruby-identifier">c</span>=<span class="ruby-value str">' '</span>)
-    <span class="ruby-keyword kw">else</span>
-      <span class="ruby-identifier">raise</span> <span class="ruby-constant">ArgumentError</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="M000286"></a><b>align_center</b>(n, sep=&quot;\n&quot;, c=' ')
-  </div>
-  <div class="description">
-  <p>
-Centers each line of a string.
-</p>
-<p>
-The default alignment separation is a new line (&quot;\n&quot;). This can
-be changed as can be the padding string which defaults to a single space
-(&#8217; &#8217;).
-</p>
-<pre>
-  s = &lt;&lt;-EOS
-    This is a test
-    and
-    so on
-  EOS
-  puts s.align_center(14)
-</pre>
-<p>
-<em>produces</em>
-</p>
-<pre>
-  This is a test
-       and
-      so on
-</pre>
-<p>
-CREDIT: Trans
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000286_source')" id="l_M000286_source">+</a> ]</p>
-  <div id="M000286_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/string/align.rb, line 98</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">align_center</span>(<span class="ruby-identifier">n</span>, <span class="ruby-identifier">sep</span>=<span class="ruby-value str">&quot;\n&quot;</span>, <span class="ruby-identifier">c</span>=<span class="ruby-value str">' '</span>)
-    <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">center</span>(<span class="ruby-identifier">n</span>.<span class="ruby-identifier">to_i</span>,<span class="ruby-identifier">c</span>.<span class="ruby-identifier">to_s</span>) <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">sep</span><span class="ruby-operator">==</span><span class="ruby-keyword kw">nil</span>
-    <span class="ruby-identifier">q</span> = <span class="ruby-identifier">split</span>(<span class="ruby-identifier">sep</span>.<span class="ruby-identifier">to_s</span>).<span class="ruby-identifier">collect</span> { <span class="ruby-operator">|</span><span class="ruby-identifier">line</span><span class="ruby-operator">|</span>
-      <span class="ruby-identifier">line</span>.<span class="ruby-identifier">center</span>(<span class="ruby-identifier">n</span>.<span class="ruby-identifier">to_i</span>,<span class="ruby-identifier">c</span>.<span class="ruby-identifier">to_s</span>)
-    }
-    <span class="ruby-identifier">q</span>.<span class="ruby-identifier">join</span>(<span class="ruby-identifier">sep</span>.<span class="ruby-identifier">to_s</span>)
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000285"></a><b>align_left</b>(n, sep=&quot;\n&quot;, c=' ')
-  </div>
-  <div class="description">
-  <p>
-Align a string to the left.
-</p>
-<p>
-The default alignment separation is a new line (&quot;\n&quot;). This can
-be changed as can be the padding string which defaults to a single space
-(&#8217; &#8217;).
-</p>
-<pre>
-  s = &lt;&lt;-EOS
-  This is a test
-    and
-    so on
-  EOS
-  puts s.align_left(20, &quot;\n&quot;, '.')
-</pre>
-<p>
-<em>produces</em>
-</p>
-<pre>
-  This is a test......
-  and.................
-  so on...............
-</pre>
-<p>
-CREDIT: Trans
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000285_source')" id="l_M000285_source">+</a> ]</p>
-  <div id="M000285_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/string/align.rb, line 68</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">align_left</span>(<span class="ruby-identifier">n</span>, <span class="ruby-identifier">sep</span>=<span class="ruby-value str">&quot;\n&quot;</span>, <span class="ruby-identifier">c</span>=<span class="ruby-value str">' '</span>)
-    <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">ljust</span>(<span class="ruby-identifier">n</span>.<span class="ruby-identifier">to_i</span>,<span class="ruby-identifier">c</span>.<span class="ruby-identifier">to_s</span>) <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">sep</span><span class="ruby-operator">==</span><span class="ruby-keyword kw">nil</span>
-    <span class="ruby-identifier">q</span> = <span class="ruby-identifier">split</span>(<span class="ruby-identifier">sep</span>.<span class="ruby-identifier">to_s</span>).<span class="ruby-identifier">map</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">line</span><span class="ruby-operator">|</span>
-      <span class="ruby-identifier">line</span>.<span class="ruby-identifier">strip</span>.<span class="ruby-identifier">ljust</span>(<span class="ruby-identifier">n</span>.<span class="ruby-identifier">to_i</span>,<span class="ruby-identifier">c</span>.<span class="ruby-identifier">to_s</span>)
-    <span class="ruby-keyword kw">end</span>
-    <span class="ruby-identifier">q</span>.<span class="ruby-identifier">join</span>(<span class="ruby-identifier">sep</span>.<span class="ruby-identifier">to_s</span>)
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000284"></a><b>align_right</b>(n, sep=&quot;\n&quot;, c=' ')
-  </div>
-  <div class="description">
-  <p>
-Align a string to the right.
-</p>
-<p>
-The default alignment separation is a new line (&quot;\n&quot;). This can
-be changed as can be the padding string which defaults to a single space
-(&#8217; &#8217;).
-</p>
-<pre>
-  s = &lt;&lt;-EOS
-  This is a test
-    and
-    so on
-  EOS
-  puts s.align_right(14)
-</pre>
-<p>
-<em>produces</em>
-</p>
-<pre>
-  This is a test
-             and
-           so on
-</pre>
-<p>
-CREDIT: Trans
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000284_source')" id="l_M000284_source">+</a> ]</p>
-  <div id="M000284_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/string/align.rb, line 38</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">align_right</span>(<span class="ruby-identifier">n</span>, <span class="ruby-identifier">sep</span>=<span class="ruby-value str">&quot;\n&quot;</span>, <span class="ruby-identifier">c</span>=<span class="ruby-value str">' '</span>)
-    <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">rjust</span>(<span class="ruby-identifier">n</span>.<span class="ruby-identifier">to_i</span>,<span class="ruby-identifier">c</span>.<span class="ruby-identifier">to_s</span>) <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">sep</span><span class="ruby-operator">==</span><span class="ruby-keyword kw">nil</span>
-    <span class="ruby-identifier">q</span> = <span class="ruby-identifier">split</span>(<span class="ruby-identifier">sep</span>.<span class="ruby-identifier">to_s</span>).<span class="ruby-identifier">map</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">line</span><span class="ruby-operator">|</span>
-      <span class="ruby-identifier">line</span>.<span class="ruby-identifier">rjust</span>(<span class="ruby-identifier">n</span>.<span class="ruby-identifier">to_i</span>,<span class="ruby-identifier">c</span>.<span class="ruby-identifier">to_s</span>)
-    <span class="ruby-keyword kw">end</span>
-    <span class="ruby-identifier">q</span>.<span class="ruby-identifier">join</span>(<span class="ruby-identifier">sep</span>.<span class="ruby-identifier">to_s</span>)
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000331"></a><b>blank?</b>()
-  </div>
-  <div class="description">
-  <p>
-Is this string just whitespace?
-</p>
-<pre>
-  &quot;abc&quot;.blank?  #=&gt; false
-  &quot;   &quot;.blank?  #=&gt; true
-</pre>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000331_source')" id="l_M000331_source">+</a> ]</p>
-  <div id="M000331_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/blank.rb, line 50</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">blank?</span>
-    <span class="ruby-keyword kw">self</span> <span class="ruby-operator">!~</span> <span class="ruby-regexp re">/\S/</span>
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000317"></a><b>bracket</b>(bra, ket=nil)
-  </div>
-  <div class="description">
-  <p>
-Return a new string embraced by given brakets. If only one <a
-href="String.html#M000317">bracket</a> char is given it will be placed on
-either side.
-</p>
-<pre>
-  &quot;wrap me&quot;.bracket('{')        #=&gt; &quot;{wrap me}&quot;
-  &quot;wrap me&quot;.bracket('--','!')   #=&gt; &quot;--wrap me!&quot;
-</pre>
-<p>
-CREDIT: Trans
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000317_source')" id="l_M000317_source">+</a> ]</p>
-  <div id="M000317_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/string/bracket.rb, line 14</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">bracket</span>(<span class="ruby-identifier">bra</span>, <span class="ruby-identifier">ket</span>=<span class="ruby-keyword kw">nil</span>)
-    <span class="ruby-comment cmt">#ket = String.bra2ket[$&amp;] if ! ket &amp;&amp; /^[\[({&lt;]$/ =~ bra</span>
-    <span class="ruby-identifier">ket</span> = <span class="ruby-constant">BRA2KET</span>[<span class="ruby-identifier">bra</span>] <span class="ruby-keyword kw">unless</span> <span class="ruby-identifier">ket</span>
-    <span class="ruby-node">&quot;#{bra}#{self}#{ket ? ket : bra}&quot;</span>
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000318"></a><b>bracket!</b>(bra, ket=nil)
-  </div>
-  <div class="description">
-  <p>
-Inplace version of braket.
-</p>
-<p>
-CREDIT: Trans
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000318_source')" id="l_M000318_source">+</a> ]</p>
-  <div id="M000318_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/string/bracket.rb, line 24</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">bracket!</span>(<span class="ruby-identifier">bra</span>, <span class="ruby-identifier">ket</span>=<span class="ruby-keyword kw">nil</span>)
-    <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">replace</span>(<span class="ruby-identifier">bracket</span>(<span class="ruby-identifier">bra</span>, <span class="ruby-identifier">ket</span>))
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000307"></a><b>bytes</b>()
-  </div>
-  <div class="description">
-  <p>
-Upacks string into <a href="String.html#M000307">bytes</a>.
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000307_source')" id="l_M000307_source">+</a> ]</p>
-  <div id="M000307_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/string/bytes.rb, line 8</span>
-    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">bytes</span>
-      <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">unpack</span>(<span class="ruby-value str">'C*'</span>)
-    <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000278"></a><b>camelcase</b>(upcase_first_letter=true)
-  </div>
-  <div class="description">
-  <p>
-Converts a string to <a href="String.html#M000278">camelcase</a>.
-</p>
-<p>
-By default <a href="String.html#M000278">camelcase</a> convert to
-UpperCamelCase, If an argument is set to <tt>false</tt>, then <a
-href="String.html#M000278">camelcase</a> will produce lowerCamelCase.
-</p>
-<p>
-<tt><a href="String.html#M000278">camelcase</a></tt> also converts
-&#8217;/&#8217; to &#8217;::&#8217; which is useful for converting paths to
-namespaces.
-</p>
-<p>
-Examples
-</p>
-<pre>
-  &quot;camel_case&quot;.camelcase                    #=&gt; &quot;CamelCase&quot;
-  &quot;camel/case&quot;.camelcase                    #=&gt; &quot;Camel::Case&quot;
-  &quot;camel_case&quot;.camelcase(false)             #=&gt; &quot;camelCase&quot;
-</pre>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000278_source')" id="l_M000278_source">+</a> ]</p>
-  <div id="M000278_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/string/camelcase.rb, line 16</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">camelcase</span>(<span class="ruby-identifier">upcase_first_letter</span>=<span class="ruby-keyword kw">true</span>)
-    <span class="ruby-identifier">up</span> = <span class="ruby-identifier">upcase_first_letter</span>
-    <span class="ruby-identifier">str</span> = <span class="ruby-identifier">dup</span>
-    <span class="ruby-identifier">str</span>.<span class="ruby-identifier">gsub!</span>(<span class="ruby-regexp re">/\/(.?)/</span>){ <span class="ruby-node">&quot;::#{$1.upcase}&quot;</span> }  <span class="ruby-comment cmt"># NOT SO SURE ABOUT THIS</span>
-    <span class="ruby-identifier">str</span>.<span class="ruby-identifier">gsub!</span>(<span class="ruby-regexp re">/(?:_+|-+)([a-z])/</span>){ <span class="ruby-identifier">$1</span>.<span class="ruby-identifier">upcase</span> }
-    <span class="ruby-identifier">str</span>.<span class="ruby-identifier">gsub!</span>(<span class="ruby-regexp re">/(\A|\s)([a-z])/</span>){ <span class="ruby-identifier">$1</span> <span class="ruby-operator">+</span> <span class="ruby-identifier">$2</span>.<span class="ruby-identifier">upcase</span> } <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">up</span>
-    <span class="ruby-identifier">str</span>
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000300"></a><b>capitalized?</b>()
-  </div>
-  <div class="description">
-  <p>
-Return true if the string is capitalized, otherwise false.
-</p>
-<pre>
-  &quot;THIS&quot;.capitalized?  #=&gt; true
-  &quot;This&quot;.capitalized?  #=&gt; true
-  &quot;this&quot;.capitalized?  #=&gt; false
-</pre>
-<p>
-CREDIT: Phil Tomson
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000300_source')" id="l_M000300_source">+</a> ]</p>
-  <div id="M000300_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/string/capitalized.rb, line 11</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">capitalized?</span>
-    <span class="ruby-keyword kw">self</span> <span class="ruby-operator">=~</span> <span class="ruby-regexp re">/^[A-Z]/</span>
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000323"></a><b>chars</b>()
-  </div>
-  <div class="description">
-  <p>
-Returns an array of characters.
-</p>
-<pre>
-  &quot;abc&quot;.chars  #=&gt; [&quot;a&quot;,&quot;b&quot;,&quot;c&quot;]
-</pre>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000323_source')" id="l_M000323_source">+</a> ]</p>
-  <div id="M000323_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/string/chars.rb, line 9</span>
-    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">chars</span>
-      <span class="ruby-identifier">split</span>(<span class="ruby-regexp re">//</span>)
-    <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000315"></a><b>cleave</b>(threshold=nil, len=nil)
-  </div>
-  <div class="description">
-  <p>
-Cleave a string. Break a string in two parts at the nearest whitespace.
-</p>
-<p>
-CREDIT: Trans
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000315_source')" id="l_M000315_source">+</a> ]</p>
-  <div id="M000315_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/string/cleave.rb, line 8</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">cleave</span>(<span class="ruby-identifier">threshold</span>=<span class="ruby-keyword kw">nil</span>, <span class="ruby-identifier">len</span>=<span class="ruby-keyword kw">nil</span>)
-    <span class="ruby-identifier">l</span> = (<span class="ruby-identifier">len</span> <span class="ruby-operator">||</span> <span class="ruby-identifier">size</span> <span class="ruby-operator">/</span> <span class="ruby-value">2</span>)
-    <span class="ruby-identifier">t</span> = <span class="ruby-identifier">threshold</span> <span class="ruby-operator">||</span> <span class="ruby-identifier">size</span>
-    <span class="ruby-identifier">h1</span> = <span class="ruby-keyword kw">self</span>[<span class="ruby-value">0</span><span class="ruby-operator">...</span><span class="ruby-identifier">l</span>]
-    <span class="ruby-identifier">h2</span> = <span class="ruby-keyword kw">self</span>[<span class="ruby-identifier">l</span><span class="ruby-operator">..</span><span class="ruby-value">-1</span>]
-    <span class="ruby-identifier">i1</span> = <span class="ruby-identifier">h1</span>.<span class="ruby-identifier">rindex</span>(<span class="ruby-regexp re">/\s/</span>) <span class="ruby-operator">||</span> <span class="ruby-value">0</span>
-    <span class="ruby-identifier">d1</span> = (<span class="ruby-identifier">i1</span> <span class="ruby-operator">-</span> <span class="ruby-identifier">l</span>).<span class="ruby-identifier">abs</span>
-    <span class="ruby-identifier">d2</span> = <span class="ruby-identifier">h2</span>.<span class="ruby-identifier">index</span>(<span class="ruby-regexp re">/\s/</span>) <span class="ruby-operator">||</span> <span class="ruby-identifier">l</span>
-    <span class="ruby-identifier">i2</span> = <span class="ruby-identifier">d2</span> <span class="ruby-operator">+</span> <span class="ruby-identifier">l</span>
-    <span class="ruby-identifier">d1</span> = (<span class="ruby-identifier">i1</span><span class="ruby-operator">-</span><span class="ruby-identifier">l</span>).<span class="ruby-identifier">abs</span>
-    <span class="ruby-identifier">d2</span> = (<span class="ruby-identifier">i2</span><span class="ruby-operator">-</span><span class="ruby-identifier">l</span>).<span class="ruby-identifier">abs</span>
-    <span class="ruby-keyword kw">if</span> [<span class="ruby-identifier">d1</span>, <span class="ruby-identifier">d2</span>].<span class="ruby-identifier">min</span> <span class="ruby-operator">&gt;</span> <span class="ruby-identifier">t</span>
-      <span class="ruby-identifier">i</span> = <span class="ruby-identifier">t</span>
-    <span class="ruby-keyword kw">elsif</span> <span class="ruby-identifier">d1</span> <span class="ruby-operator">&lt;</span> <span class="ruby-identifier">d2</span>
-      <span class="ruby-identifier">i</span> = <span class="ruby-identifier">i1</span>
-    <span class="ruby-keyword kw">else</span>
-      <span class="ruby-identifier">i</span> = <span class="ruby-identifier">i2</span>
-    <span class="ruby-keyword kw">end</span>
-    <span class="ruby-comment cmt">#dup.insert(l, &quot;\n&quot;).gsub(/^\s+|\s+$/, '')</span>
-    <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">self</span>[<span class="ruby-value">0</span><span class="ruby-operator">..</span><span class="ruby-identifier">i</span>].<span class="ruby-identifier">to_s</span>.<span class="ruby-identifier">strip</span>, <span class="ruby-keyword kw">self</span>[<span class="ruby-identifier">i</span><span class="ruby-operator">+</span><span class="ruby-value">1</span><span class="ruby-operator">..</span><span class="ruby-value">-1</span>].<span class="ruby-identifier">to_s</span>.<span class="ruby-identifier">strip</span>
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000270"></a><b>cmp</b>(other)
-  </div>
-  <div class="description">
-  <p>
-Compare method that takes length into account. Unlike #&lt;=&gt;, this is
-compatible with succ.
-</p>
-<pre>
-  &quot;abc&quot;.cmp(&quot;abc&quot;)   #=&gt;  0
-  &quot;abcd&quot;.cmp(&quot;abc&quot;)  #=&gt;  1
-  &quot;abc&quot;.cmp(&quot;abcd&quot;)  #=&gt; -1
-  &quot;xyz&quot;.cmp(&quot;abc&quot;)   #=&gt;  1
-</pre>
-<p>
-CREDIT: Peter Vanbroekhoven
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000270_source')" id="l_M000270_source">+</a> ]</p>
-  <div id="M000270_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/comparable/cmp.rb, line 31</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">cmp</span>(<span class="ruby-identifier">other</span>)
-    <span class="ruby-keyword kw">return</span> <span class="ruby-value">-1</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">length</span> <span class="ruby-operator">&lt;</span> <span class="ruby-identifier">other</span>.<span class="ruby-identifier">length</span>
-    <span class="ruby-keyword kw">return</span> <span class="ruby-value">1</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">length</span> <span class="ruby-operator">&gt;</span> <span class="ruby-identifier">other</span>.<span class="ruby-identifier">length</span>
-    <span class="ruby-keyword kw">self</span> <span class="ruby-operator">&lt;=&gt;</span> <span class="ruby-identifier">other</span>  <span class="ruby-comment cmt"># alphabetic compare</span>
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000290"></a><b>compress_lines</b>(spaced = true)
-  </div>
-  <div class="description">
-  <p>
-Matches any whitespace (including newline) and replaces with a single space
-</p>
-<p>
-@example
-</p>
-<pre>
-  &lt;&lt;-QUERY.compress_lines
-    SELECT name
-    FROM users
-  QUERY
-  =&gt; &quot;SELECT name FROM users&quot;
-</pre>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000290_source')" id="l_M000290_source">+</a> ]</p>
-  <div id="M000290_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/string/compress_lines.rb, line 12</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">compress_lines</span>(<span class="ruby-identifier">spaced</span> = <span class="ruby-keyword kw">true</span>)
-    <span class="ruby-identifier">split</span>(<span class="ruby-identifier">$/</span>).<span class="ruby-identifier">map</span> { <span class="ruby-operator">|</span><span class="ruby-identifier">line</span><span class="ruby-operator">|</span> <span class="ruby-identifier">line</span>.<span class="ruby-identifier">strip</span> }.<span class="ruby-identifier">join</span>(<span class="ruby-identifier">spaced</span> <span class="ruby-value">? </span><span class="ruby-value str">' '</span> <span class="ruby-operator">:</span> <span class="ruby-value str">''</span>)
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000322"></a><b>dequote</b>()
-  </div>
-  <div class="description">
-  <p>
-Remove quotes from string.
-</p>
-<pre>
-  &quot;'hi'&quot;.dequite    #=&gt; &quot;hi&quot;
-</pre>
-<p>
-CREDIT: Trans
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000322_source')" id="l_M000322_source">+</a> ]</p>
-  <div id="M000322_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/string/bracket.rb, line 88</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">dequote</span>
-    <span class="ruby-identifier">s</span> = <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">dup</span>
-    <span class="ruby-keyword kw">case</span> <span class="ruby-keyword kw">self</span>[<span class="ruby-value">0</span>,<span class="ruby-value">1</span>]
-    <span class="ruby-keyword kw">when</span> <span class="ruby-value str">&quot;'&quot;</span>, <span class="ruby-value str">'&quot;'</span>, <span class="ruby-value str">'`'</span>
-      <span class="ruby-identifier">s</span>[<span class="ruby-value">0</span>] = <span class="ruby-value str">''</span>
-    <span class="ruby-keyword kw">end</span>
-    <span class="ruby-keyword kw">case</span> <span class="ruby-keyword kw">self</span>[<span class="ruby-value">-1</span>,<span class="ruby-value">1</span>]
-    <span class="ruby-keyword kw">when</span> <span class="ruby-value str">&quot;'&quot;</span>, <span class="ruby-value str">'&quot;'</span>, <span class="ruby-value str">'`'</span>
-      <span class="ruby-identifier">s</span>[<span class="ruby-value">-1</span>] = <span class="ruby-value str">''</span>
-    <span class="ruby-keyword kw">end</span>
-    <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">s</span>
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000297"></a><b>divide</b>( re )
-  </div>
-  <div class="description">
-  <p>
-Breaks a string up into an array based on a regular expression. Similar to
-scan, but includes the matches.
-</p>
-<pre>
-  s = &quot;&lt;p&gt;This&lt;b&gt;is&lt;/b&gt;a test.&lt;/p&gt;&quot;
-  s.divide( /\&lt;.*?\&gt;/ )
-</pre>
-<p>
-<em>produces</em>
-</p>
-<pre>
-  [&quot;&lt;p&gt;This&quot;, &quot;&lt;b&gt;is&quot;, &quot;&lt;/b&gt;a test.&quot;, &quot;&lt;/p&gt;&quot;]
-</pre>
-<p>
-CREDIT: Trans
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000297_source')" id="l_M000297_source">+</a> ]</p>
-  <div id="M000297_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/string/divide.rb, line 15</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">divide</span>( <span class="ruby-identifier">re</span> )
-    <span class="ruby-identifier">re2</span> = <span class="ruby-node">/#{re}.*?(?=#{re}|\Z)/</span>
-    <span class="ruby-identifier">scan</span>(<span class="ruby-identifier">re2</span>) <span class="ruby-comment cmt">#{re}(?=#{re})/)</span>
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000301"></a><b>downcase?</b>()
-  </div>
-  <div class="description">
-  <p>
-Return true if the string is lowercase (downcase), otherwise false.
-</p>
-<pre>
-  &quot;THIS&quot;.downcase?  #=&gt; false
-  &quot;This&quot;.downcase?  #=&gt; false
-  &quot;this&quot;.downcase?  #=&gt; true
-</pre>
-<p>
-CREDIT: Phil Tomson
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000301_source')" id="l_M000301_source">+</a> ]</p>
-  <div id="M000301_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/string/capitalized.rb, line 23</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">downcase?</span>
-    <span class="ruby-identifier">downcase</span> <span class="ruby-operator">==</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="M000296"></a><b>each_char</b>() {|scanner.scan(char || break)| ...}
-  </div>
-  <div class="description">
-  <p>
-Yields a single-character string for each character in the string. When
-$KCODE = &#8216;UTF8&#8217;, multi-byte characters are yielded
-appropriately.
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000296_source')" id="l_M000296_source">+</a> ]</p>
-  <div id="M000296_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/string/each_char.rb, line 22</span>
-    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">each_char</span>
-      <span class="ruby-identifier">scanner</span>, <span class="ruby-identifier">char</span> = <span class="ruby-constant">StringScanner</span>.<span class="ruby-identifier">new</span>(<span class="ruby-keyword kw">self</span>), <span class="ruby-regexp re">/./</span><span class="ruby-identifier">mu</span>
-      <span class="ruby-identifier">loop</span> { <span class="ruby-keyword kw">yield</span>(<span class="ruby-identifier">scanner</span>.<span class="ruby-identifier">scan</span>(<span class="ruby-identifier">char</span>) <span class="ruby-operator">||</span> <span class="ruby-keyword kw">break</span>) }
-    <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000330"></a><b>each_word</b>(&amp;block)
-  </div>
-  <div class="description">
-  <p>
-Iterate through each word of a string.
-</p>
-<pre>
-  &quot;a string&quot;.each_word { |word, range| ... }
-</pre>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000330_source')" id="l_M000330_source">+</a> ]</p>
-  <div id="M000330_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/string/each_word.rb, line 9</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">each_word</span>(<span class="ruby-operator">&amp;</span><span class="ruby-identifier">block</span>)
-    <span class="ruby-identifier">words</span>.<span class="ruby-identifier">each</span>(<span class="ruby-operator">&amp;</span><span class="ruby-identifier">block</span>)
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000277"></a><b>end_with?</b>(suffix)
-  </div>
-  <div class="description">
-  <p>
-Does a string end with the given suffix?
-</p>
-<pre>
-  &quot;hello&quot;.ends_with?(&quot;lo&quot;)    #=&gt; true
-  &quot;hello&quot;.ends_with?(&quot;to&quot;)    #=&gt; false
-</pre>
-<p>
-CREDIT: Lucas Carlson, Blaine Cook
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000277_source')" id="l_M000277_source">+</a> ]</p>
-  <div id="M000277_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/string/start_with.rb, line 23</span>
-    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">end_with?</span>(<span class="ruby-identifier">suffix</span>)
-      <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">rindex</span>(<span class="ruby-identifier">suffix</span>) <span class="ruby-operator">==</span> <span class="ruby-identifier">size</span> <span class="ruby-operator">-</span> <span class="ruby-identifier">suffix</span>.<span class="ruby-identifier">size</span>
-    <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000303"></a><b>expand_tab</b>(n=8)
-  </div>
-  <div class="description">
-  <p>
-Expands tabs to <tt>n</tt> spaces. Non-destructive. If <tt>n</tt> is 0,
-then tabs are simply removed. Raises an exception if <tt>n</tt> is
-negative.
-</p>
-<pre>
-  &quot;\t\tHey&quot;.expand_tab(2)  #=&gt; &quot;    Hey&quot;
-</pre>
-<p>
-Thanks to GGaramuno for a more efficient algorithm. Very nice.
-</p>
-<p>
-CREDIT: Gavin Sinclair, Noah Gibbs, GGaramuno
-</p>
-  </div>
-<div class="aka">
-  This method is also aliased as
-  <a href="String.html#M000304">expand_tabs</a>
-</div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000303_source')" id="l_M000303_source">+</a> ]</p>
-  <div id="M000303_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/string/expand_tab.rb, line 13</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">expand_tab</span>(<span class="ruby-identifier">n</span>=<span class="ruby-value">8</span>)
-    <span class="ruby-identifier">n</span> = <span class="ruby-identifier">n</span>.<span class="ruby-identifier">to_int</span>
-    <span class="ruby-identifier">raise</span> <span class="ruby-constant">ArgumentError</span>, <span class="ruby-value str">&quot;n must be &gt;= 0&quot;</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">n</span> <span class="ruby-operator">&lt;</span> <span class="ruby-value">0</span>
-    <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">gsub</span>(<span class="ruby-regexp re">/\t/</span>, <span class="ruby-value str">&quot;&quot;</span>) <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">n</span> <span class="ruby-operator">==</span> <span class="ruby-value">0</span>
-    <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">gsub</span>(<span class="ruby-regexp re">/\t/</span>, <span class="ruby-value str">&quot; &quot;</span>) <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">n</span> <span class="ruby-operator">==</span> <span class="ruby-value">1</span>
-    <span class="ruby-identifier">str</span> = <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">dup</span>
-    <span class="ruby-keyword kw">while</span>
-      <span class="ruby-identifier">str</span>.<span class="ruby-identifier">gsub!</span>(<span class="ruby-regexp re">/^([^\t\n]*)(\t+)/</span>) { <span class="ruby-operator">|</span><span class="ruby-identifier">f</span><span class="ruby-operator">|</span>
-        <span class="ruby-identifier">val</span> = ( <span class="ruby-identifier">n</span> <span class="ruby-operator">*</span> <span class="ruby-identifier">$2</span>.<span class="ruby-identifier">size</span> <span class="ruby-operator">-</span> (<span class="ruby-identifier">$1</span>.<span class="ruby-identifier">size</span> <span class="ruby-operator">%</span> <span class="ruby-identifier">n</span>) )
-        <span class="ruby-identifier">$1</span> <span class="ruby-operator">&lt;&lt;</span> (<span class="ruby-value str">' '</span> <span class="ruby-operator">*</span> <span class="ruby-identifier">val</span>)
-      }
-    <span class="ruby-keyword kw">end</span>
-    <span class="ruby-identifier">str</span>
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000304"></a><b>expand_tabs</b>(n=8)
-  </div>
-  <div class="description">
-  <p>
-Alias for <a href="String.html#M000303">expand_tab</a>
-</p>
-  </div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000272"></a><b>file</b>()
-  </div>
-  <div class="description">
-  <p>
-Use fluent notation for making <a href="String.html#M000272">file</a>
-directives.
-</p>
-<pre>
-   '~/trans/Desktop/notes.txt'.file.mtime
-</pre>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000272_source')" id="l_M000272_source">+</a> ]</p>
-  <div id="M000272_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/string/file.rb, line 9</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">file</span>
-    <span class="ruby-identifier">f</span> = <span class="ruby-keyword kw">self</span>
-    <span class="ruby-constant">Functor</span>.<span class="ruby-identifier">new</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">op</span>, <span class="ruby-operator">*</span><span class="ruby-identifier">a</span><span class="ruby-operator">|</span>
-      <span class="ruby-constant">File</span>.<span class="ruby-identifier">send</span>(<span class="ruby-identifier">op</span>, <span class="ruby-identifier">f</span>, <span class="ruby-operator">*</span><span class="ruby-identifier">a</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="M000275"></a><b>fold</b>(ignore_indented=false)
-  </div>
-  <div class="description">
-  <p>
-Returns a new string with all new <a href="String.html#M000279">lines</a>
-removed from adjacent <a href="String.html#M000279">lines</a> of text.
-</p>
-<pre>
-  s = &quot;This is\na test.\n\nIt clumps\nlines of text.&quot;
-  s.fold
-</pre>
-<p>
-<em>produces</em>
-</p>
-<pre>
-  &quot;This is a test.\n\nIt clumps lines of text. &quot;
-</pre>
-<p>
-One arguable flaw with this, that might need a fix: if the given string
-ends in a newline, it is replaced with a single space.
-</p>
-<p>
-CREDIT: Trans
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000275_source')" id="l_M000275_source">+</a> ]</p>
-  <div id="M000275_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/string/fold.rb, line 19</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">fold</span>(<span class="ruby-identifier">ignore_indented</span>=<span class="ruby-keyword kw">false</span>)
-    <span class="ruby-identifier">ns</span> = <span class="ruby-value str">''</span>
-    <span class="ruby-identifier">i</span> = <span class="ruby-value">0</span>
-    <span class="ruby-identifier">br</span> = <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">scan</span>(<span class="ruby-regexp re">/(\n\s*\n|\Z)/</span><span class="ruby-identifier">m</span>) <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">m</span><span class="ruby-operator">|</span>
-      <span class="ruby-identifier">b</span> = <span class="ruby-identifier">$~</span>.<span class="ruby-identifier">begin</span>(<span class="ruby-value">1</span>)
-      <span class="ruby-identifier">e</span> = <span class="ruby-identifier">$~</span>.<span class="ruby-identifier">end</span>(<span class="ruby-value">1</span>)
-      <span class="ruby-identifier">nl</span> = <span class="ruby-identifier">$&amp;</span>
-      <span class="ruby-identifier">tx</span> = <span class="ruby-identifier">slice</span>(<span class="ruby-identifier">i</span><span class="ruby-operator">...</span><span class="ruby-identifier">b</span>)
-      <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">ignore_indented</span> <span class="ruby-keyword kw">and</span> <span class="ruby-identifier">slice</span>(<span class="ruby-identifier">i</span><span class="ruby-operator">...</span><span class="ruby-identifier">b</span>) <span class="ruby-operator">=~</span> <span class="ruby-regexp re">/^[ ]+/</span>
-        <span class="ruby-identifier">ns</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">tx</span>
-      <span class="ruby-keyword kw">else</span>
-        <span class="ruby-identifier">ns</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">tx</span>.<span class="ruby-identifier">gsub</span>(<span class="ruby-regexp re">/[ ]*\n+/</span>,<span class="ruby-value str">' '</span>)
-      <span class="ruby-keyword kw">end</span>
-      <span class="ruby-identifier">ns</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">nl</span>
-      <span class="ruby-identifier">i</span> = <span class="ruby-identifier">e</span>
-    <span class="ruby-keyword kw">end</span>
-    <span class="ruby-identifier">ns</span>
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000309"></a><b>indent</b>(n)
-  </div>
-  <div class="description">
-  <p>
-Indent left or right by n spaces. (This used to be called <a
-href="String.html#M000287">tab</a> and aliased as <a
-href="String.html#M000309">indent</a>.)
-</p>
-<p>
-CREDIT: Gavin Sinclair, Trans
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000309_source')" id="l_M000309_source">+</a> ]</p>
-  <div id="M000309_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/string/indent.rb, line 8</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">indent</span>(<span class="ruby-identifier">n</span>)
-    <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">n</span> <span class="ruby-operator">&gt;=</span> <span class="ruby-value">0</span>
-      <span class="ruby-identifier">gsub</span>(<span class="ruby-regexp re">/^/</span>, <span class="ruby-value str">' '</span> <span class="ruby-operator">*</span> <span class="ruby-identifier">n</span>)
-    <span class="ruby-keyword kw">else</span>
-      <span class="ruby-identifier">gsub</span>(<span class="ruby-node">/^ {0,#{-n}}/</span>, <span class="ruby-value str">&quot;&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="M000294"></a><b>index_all</b>(s, reuse=false)
-  </div>
-  <div class="description">
-  <p>
-Like index but returns an array of all index locations. The reuse flag
-allows the trailing portion of a match to be reused for subsquent matches.
-</p>
-<pre>
-  &quot;abcabcabc&quot;.index_all('a')  #=&gt; [0,3,6]
-  &quot;bbb&quot;.index_all('bb', false)  #=&gt; [0]
-  &quot;bbb&quot;.index_all('bb', true)   #=&gt; [0,1]
-</pre>
-<p>
-TODO: Culd probably be defined for <a href="Indexable.html">Indexable</a>
-in general too.
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000294_source')" id="l_M000294_source">+</a> ]</p>
-  <div id="M000294_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/string/range.rb, line 66</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">index_all</span>(<span class="ruby-identifier">s</span>, <span class="ruby-identifier">reuse</span>=<span class="ruby-keyword kw">false</span>)
-    <span class="ruby-identifier">s</span> = <span class="ruby-constant">Regexp</span>.<span class="ruby-identifier">new</span>(<span class="ruby-constant">Regexp</span>.<span class="ruby-identifier">escape</span>(<span class="ruby-identifier">s</span>)) <span class="ruby-keyword kw">unless</span> <span class="ruby-constant">Regexp</span><span class="ruby-operator">===</span><span class="ruby-identifier">s</span>
-    <span class="ruby-identifier">ia</span> = []; <span class="ruby-identifier">i</span> = <span class="ruby-value">0</span>
-    <span class="ruby-keyword kw">while</span> (<span class="ruby-identifier">i</span> = <span class="ruby-identifier">index</span>(<span class="ruby-identifier">s</span>,<span class="ruby-identifier">i</span>))
-      <span class="ruby-identifier">ia</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">i</span>
-      <span class="ruby-identifier">i</span> <span class="ruby-operator">+=</span> (<span class="ruby-identifier">reuse</span> <span class="ruby-value">? </span><span class="ruby-value">1</span> <span class="ruby-operator">:</span> <span class="ruby-identifier">$~</span>[<span class="ruby-value">0</span>].<span class="ruby-identifier">size</span>)
-    <span class="ruby-keyword kw">end</span>
-    <span class="ruby-identifier">ia</span>
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000324"></a><b>lchomp</b>(match)
-  </div>
-  <div class="description">
-  <p>
-Left chomp.
-</p>
-<pre>
-  &quot;help&quot;.lchomp(&quot;h&quot;)  #=&gt; &quot;elp&quot;
-  &quot;help&quot;.lchomp(&quot;k&quot;)  #=&gt; &quot;help&quot;
-</pre>
-<p>
-CREDIT: Trans
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000324_source')" id="l_M000324_source">+</a> ]</p>
-  <div id="M000324_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/string/chomp.rb, line 10</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">lchomp</span>(<span class="ruby-identifier">match</span>)
-    <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">index</span>(<span class="ruby-identifier">match</span>) <span class="ruby-operator">==</span> <span class="ruby-value">0</span>
-      <span class="ruby-keyword kw">self</span>[<span class="ruby-identifier">match</span>.<span class="ruby-identifier">size</span><span class="ruby-operator">..</span><span class="ruby-value">-1</span>]
-    <span class="ruby-keyword kw">else</span>
-      <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">dup</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="M000325"></a><b>lchomp!</b>(match)
-  </div>
-  <div class="description">
-  <p>
-In-place left chomp.
-</p>
-<pre>
-  &quot;help&quot;.lchomp(&quot;h&quot;)  #=&gt; &quot;elp&quot;
-  &quot;help&quot;.lchomp(&quot;k&quot;)  #=&gt; &quot;help&quot;
-</pre>
-<p>
-CREDIT: Trans
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000325_source')" id="l_M000325_source">+</a> ]</p>
-  <div id="M000325_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/string/chomp.rb, line 25</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">lchomp!</span>(<span class="ruby-identifier">match</span>)
-    <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">index</span>(<span class="ruby-identifier">match</span>) <span class="ruby-operator">==</span> <span class="ruby-value">0</span>
-      <span class="ruby-keyword kw">self</span>[<span class="ruby-value">0</span><span class="ruby-operator">...</span><span class="ruby-identifier">match</span>.<span class="ruby-identifier">size</span>] = <span class="ruby-value str">''</span>
-      <span class="ruby-keyword kw">self</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="M000316"></a><b>line_wrap</b>(width, tabs=4)
-  </div>
-  <div class="description">
-  <p>
-Line wrap at width.
-</p>
-<pre>
-  puts &quot;1234567890&quot;.line_wrap(5)
-</pre>
-<p>
-<em>produces</em>
-</p>
-<pre>
-  12345
-  67890
-</pre>
-<p>
-CREDIT: Trans
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000316_source')" id="l_M000316_source">+</a> ]</p>
-  <div id="M000316_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/string/line_wrap.rb, line 14</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">line_wrap</span>(<span class="ruby-identifier">width</span>, <span class="ruby-identifier">tabs</span>=<span class="ruby-value">4</span>)
-    <span class="ruby-identifier">s</span> = <span class="ruby-identifier">gsub</span>(<span class="ruby-regexp re">/\t/</span>,<span class="ruby-value str">' '</span> <span class="ruby-operator">*</span> <span class="ruby-identifier">tabs</span>) <span class="ruby-comment cmt"># tabs default to 4 spaces</span>
-    <span class="ruby-identifier">s</span> = <span class="ruby-identifier">s</span>.<span class="ruby-identifier">gsub</span>(<span class="ruby-regexp re">/\n/</span>,<span class="ruby-value str">' '</span>)
-    <span class="ruby-identifier">r</span> = <span class="ruby-identifier">s</span>.<span class="ruby-identifier">scan</span>( <span class="ruby-node">/.{1,#{width}}/</span> )
-    <span class="ruby-identifier">r</span>.<span class="ruby-identifier">join</span>(<span class="ruby-value str">&quot;\n&quot;</span>) <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-value str">&quot;\n&quot;</span>
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000279"></a><b>lines</b>()
-  </div>
-  <div class="description">
-  <p>
-Returns an array of characters.
-</p>
-<pre>
-  &quot;abc\n123&quot;.lines  #=&gt; [&quot;abc&quot;,&quot;123&quot;]
-</pre>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000279_source')" id="l_M000279_source">+</a> ]</p>
-  <div id="M000279_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/string/lines.rb, line 9</span>
-    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">lines</span>
-      <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">split</span>(<span class="ruby-regexp re">/\n/</span>)
-    <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000298"></a><b>margin</b>(n=0)
-  </div>
-  <div class="description">
-  <p>
-Provides a <a href="String.html#M000298">margin</a> controlled string.
-</p>
-<pre>
-  x = %Q{
-        | This
-        |   is
-        |     margin controlled!
-        }.margin
-</pre>
-<p>
-NOTE: This may still need a bit of tweaking.
-</p>
-<p>
-CREDIT: Trans
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000298_source')" id="l_M000298_source">+</a> ]</p>
-  <div id="M000298_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/string/margin.rb, line 16</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">margin</span>(<span class="ruby-identifier">n</span>=<span class="ruby-value">0</span>)
-    <span class="ruby-comment cmt">#d = /\A.*\n\s*(.)/.match( self )[1]</span>
-    <span class="ruby-comment cmt">#d = /\A\s*(.)/.match( self)[1] unless d</span>
-    <span class="ruby-identifier">d</span> = ((<span class="ruby-regexp re">/\A.*\n\s*(.)/</span>.<span class="ruby-identifier">match</span>(<span class="ruby-keyword kw">self</span>)) <span class="ruby-operator">||</span>
-        (<span class="ruby-regexp re">/\A\s*(.)/</span>.<span class="ruby-identifier">match</span>(<span class="ruby-keyword kw">self</span>)))[<span class="ruby-value">1</span>]
-    <span class="ruby-keyword kw">return</span> <span class="ruby-value str">''</span> <span class="ruby-keyword kw">unless</span> <span class="ruby-identifier">d</span>
-    <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">n</span> <span class="ruby-operator">==</span> <span class="ruby-value">0</span>
-      <span class="ruby-identifier">gsub</span>(<span class="ruby-regexp re">/\n\s*\Z/</span>,<span class="ruby-value str">''</span>).<span class="ruby-identifier">gsub</span>(<span class="ruby-node">/^\s*[#{d}]/</span>, <span class="ruby-value str">''</span>)
-    <span class="ruby-keyword kw">else</span>
-      <span class="ruby-identifier">gsub</span>(<span class="ruby-regexp re">/\n\s*\Z/</span>,<span class="ruby-value str">''</span>).<span class="ruby-identifier">gsub</span>(<span class="ruby-node">/^\s*[#{d}]/</span>, <span class="ruby-value str">' '</span> <span class="ruby-operator">*</span> <span class="ruby-identifier">n</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="M000288"></a><b>methodize</b>()
-  </div>
-  <div class="description">
-  <p>
-Translate a (class or module) name to a suitable method name.
-</p>
-<pre>
-  My::CoolClass.name.methodize =&gt; &quot;my__cool_class&quot;
-</pre>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000288_source')" id="l_M000288_source">+</a> ]</p>
-  <div id="M000288_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/string/methodize.rb, line 7</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">methodize</span>
-    <span class="ruby-identifier">gsub</span>(<span class="ruby-regexp re">/([A-Z]+)([A-Z])/</span>,<span class="ruby-value str">'\1_\2'</span>).
-    <span class="ruby-identifier">gsub</span>(<span class="ruby-regexp re">/([a-z])([A-Z])/</span>,<span class="ruby-value str">'\1_\2'</span>).
-    <span class="ruby-identifier">gsub</span>(<span class="ruby-value str">'/'</span> ,<span class="ruby-value str">'__'</span>).
-    <span class="ruby-identifier">gsub</span>(<span class="ruby-value str">'::'</span>,<span class="ruby-value str">'__'</span>).
-    <span class="ruby-identifier">downcase</span>
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000280"></a><b>modulize</b>()
-  </div>
-  <div class="description">
-  <p>
-Converts a string to module name representation.
-</p>
-<p>
-This is essentially <a href="String.html#M000278">camelcase</a>. It also
-converts &#8217;/&#8217; to &#8217;::&#8217; which is useful for converting
-paths to namespaces.
-</p>
-<p>
-Examples
-</p>
-<pre>
-  &quot;method_name&quot;.modulize    #=&gt; &quot;MethodName&quot;
-  &quot;method/name&quot;.modulize    #=&gt; &quot;Method::Name&quot;
-</pre>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000280_source')" id="l_M000280_source">+</a> ]</p>
-  <div id="M000280_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/string/modulize.rb, line 13</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">modulize</span>
-    <span class="ruby-identifier">gsub</span>(<span class="ruby-value str">'__'</span>,<span class="ruby-value str">'/'</span>).
-    <span class="ruby-identifier">gsub</span>(<span class="ruby-regexp re">/\/(.?)/</span>){ <span class="ruby-node">&quot;::#{$1.upcase}&quot;</span> }.
-    <span class="ruby-identifier">gsub</span>(<span class="ruby-regexp re">/(?:_+|-+)([a-z])/</span>){ <span class="ruby-identifier">$1</span>.<span class="ruby-identifier">upcase</span> }.
-    <span class="ruby-identifier">gsub</span>(<span class="ruby-regexp re">/(\A|\s)([a-z])/</span>){ <span class="ruby-identifier">$1</span> <span class="ruby-operator">+</span> <span class="ruby-identifier">$2</span>.<span class="ruby-identifier">upcase</span> }
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000299"></a><b>mscan</b>(re) {|| ...}
-  </div>
-  <div class="description">
-  <p>
-Like scan but returns <a href="MatchData.html">MatchData</a> ($~) rather
-then matched string ($&amp;).
-</p>
-<p>
-CREDIT: Trans
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000299_source')" id="l_M000299_source">+</a> ]</p>
-  <div id="M000299_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/string/mscan.rb, line 8</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">mscan</span>(<span class="ruby-identifier">re</span>) <span class="ruby-comment cmt">#:yield:</span>
-    <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">block_given?</span>
-      <span class="ruby-identifier">scan</span>(<span class="ruby-identifier">re</span>) { <span class="ruby-keyword kw">yield</span>(<span class="ruby-identifier">$~</span>) }
-    <span class="ruby-keyword kw">else</span>
-      <span class="ruby-identifier">m</span> = []
-      <span class="ruby-identifier">scan</span>(<span class="ruby-identifier">re</span>) { <span class="ruby-identifier">m</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">$~</span> }
-      <span class="ruby-identifier">m</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="M000305"></a><b>natcmp</b>(str2, caseInsensitive=false)
-  </div>
-  <div class="description">
-  <p>
-&#8216;Natural order&#8217; comparison of strings, e.g.
-</p>
-<pre>
-  &quot;my_prog_v1.1.0&quot; &lt; &quot;my_prog_v1.2.0&quot; &lt; &quot;my_prog_v1.10.0&quot;
-</pre>
-<p>
-which does not follow alphabetically. A secondary parameter, if set to
-<em>true</em>, makes the comparison case insensitive.
-</p>
-<pre>
-  &quot;Hello.10&quot;.natcmp(&quot;Hello.1&quot;)  #=&gt; -1
-  TODO: Invert case flag?
-</pre>
-<p>
-CREDIT: Alan Davies, Martin Pool
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000305_source')" id="l_M000305_source">+</a> ]</p>
-  <div id="M000305_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/string/natcmp.rb, line 46</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">natcmp</span>(<span class="ruby-identifier">str2</span>, <span class="ruby-identifier">caseInsensitive</span>=<span class="ruby-keyword kw">false</span>)
-    <span class="ruby-identifier">str1</span> = <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">dup</span>
-    <span class="ruby-identifier">str2</span> = <span class="ruby-identifier">str2</span>.<span class="ruby-identifier">dup</span>
-    <span class="ruby-identifier">compareExpression</span> = <span class="ruby-regexp re">/^(\D*)(\d*)(.*)$/</span>
-    <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">caseInsensitive</span>
-      <span class="ruby-identifier">str1</span>.<span class="ruby-identifier">downcase!</span>
-      <span class="ruby-identifier">str2</span>.<span class="ruby-identifier">downcase!</span>
-    <span class="ruby-keyword kw">end</span>
-    <span class="ruby-comment cmt"># remove all whitespace</span>
-    <span class="ruby-identifier">str1</span>.<span class="ruby-identifier">gsub!</span>(<span class="ruby-regexp re">/\s*/</span>, <span class="ruby-value str">''</span>)
-    <span class="ruby-identifier">str2</span>.<span class="ruby-identifier">gsub!</span>(<span class="ruby-regexp re">/\s*/</span>, <span class="ruby-value str">''</span>)
-    <span class="ruby-keyword kw">while</span> (<span class="ruby-identifier">str1</span>.<span class="ruby-identifier">length</span> <span class="ruby-operator">&gt;</span> <span class="ruby-value">0</span>) <span class="ruby-keyword kw">or</span> (<span class="ruby-identifier">str2</span>.<span class="ruby-identifier">length</span> <span class="ruby-operator">&gt;</span> <span class="ruby-value">0</span>) <span class="ruby-keyword kw">do</span>
-      <span class="ruby-comment cmt"># Extract non-digits, digits and rest of string</span>
-      <span class="ruby-identifier">str1</span> <span class="ruby-operator">=~</span> <span class="ruby-identifier">compareExpression</span>
-      <span class="ruby-identifier">chars1</span>, <span class="ruby-identifier">num1</span>, <span class="ruby-identifier">str1</span> = <span class="ruby-identifier">$1</span>.<span class="ruby-identifier">dup</span>, <span class="ruby-identifier">$2</span>.<span class="ruby-identifier">dup</span>, <span class="ruby-identifier">$3</span>.<span class="ruby-identifier">dup</span>
-      <span class="ruby-identifier">str2</span> <span class="ruby-operator">=~</span> <span class="ruby-identifier">compareExpression</span>
-      <span class="ruby-identifier">chars2</span>, <span class="ruby-identifier">num2</span>, <span class="ruby-identifier">str2</span> = <span class="ruby-identifier">$1</span>.<span class="ruby-identifier">dup</span>, <span class="ruby-identifier">$2</span>.<span class="ruby-identifier">dup</span>, <span class="ruby-identifier">$3</span>.<span class="ruby-identifier">dup</span>
-      <span class="ruby-comment cmt"># Compare the non-digits</span>
-      <span class="ruby-keyword kw">case</span> (<span class="ruby-identifier">chars1</span> <span class="ruby-operator">&lt;=&gt;</span> <span class="ruby-identifier">chars2</span>)
-        <span class="ruby-keyword kw">when</span> <span class="ruby-value">0</span> <span class="ruby-comment cmt"># Non-digits are the same, compare the digits...</span>
-          <span class="ruby-comment cmt"># If either number begins with a zero, then compare alphabetically,</span>
-          <span class="ruby-comment cmt"># otherwise compare numerically</span>
-          <span class="ruby-keyword kw">if</span> (<span class="ruby-identifier">num1</span>[<span class="ruby-value">0</span>] <span class="ruby-operator">!=</span> <span class="ruby-value">48</span>) <span class="ruby-keyword kw">and</span> (<span class="ruby-identifier">num2</span>[<span class="ruby-value">0</span>] <span class="ruby-operator">!=</span> <span class="ruby-value">48</span>)
-            <span class="ruby-identifier">num1</span>, <span class="ruby-identifier">num2</span> = <span class="ruby-identifier">num1</span>.<span class="ruby-identifier">to_i</span>, <span class="ruby-identifier">num2</span>.<span class="ruby-identifier">to_i</span>
-          <span class="ruby-keyword kw">end</span>
-          <span class="ruby-keyword kw">case</span> (<span class="ruby-identifier">num1</span> <span class="ruby-operator">&lt;=&gt;</span> <span class="ruby-identifier">num2</span>)
-            <span class="ruby-keyword kw">when</span> <span class="ruby-value">-1</span> <span class="ruby-keyword kw">then</span> <span class="ruby-keyword kw">return</span> <span class="ruby-value">-1</span>
-            <span class="ruby-keyword kw">when</span> <span class="ruby-value">1</span> <span class="ruby-keyword kw">then</span> <span class="ruby-keyword kw">return</span> <span class="ruby-value">1</span>
-          <span class="ruby-keyword kw">end</span>
-        <span class="ruby-keyword kw">when</span> <span class="ruby-value">-1</span> <span class="ruby-keyword kw">then</span> <span class="ruby-keyword kw">return</span> <span class="ruby-value">-1</span>
-        <span class="ruby-keyword kw">when</span> <span class="ruby-value">1</span> <span class="ruby-keyword kw">then</span> <span class="ruby-keyword kw">return</span> <span class="ruby-value">1</span>
-      <span class="ruby-keyword kw">end</span> <span class="ruby-comment cmt"># case</span>
-    <span class="ruby-keyword kw">end</span> <span class="ruby-comment cmt"># while</span>
-    <span class="ruby-comment cmt"># strings are naturally equal.</span>
-    <span class="ruby-keyword kw">return</span> <span class="ruby-value">0</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="M000328"></a><b>nchar</b>(n, replacement=nil)
-  </div>
-  <div class="description">
-  <p>
-Returns <em>n</em> characters of the string. If <em>n</em> is positive the
-characters are from the beginning of the string. If <em>n</em> is negative
-from the end of the string.
-</p>
-<p>
-Alternatively a replacement string can be given, which will replace the
-<em>n</em> characters.
-</p>
-<pre>
-   str = &quot;this is text&quot;
-   str.nchar(4)            #=&gt; &quot;this&quot;
-   str.nchar(4, 'that')    #=&gt; &quot;that&quot;
-   str                     #=&gt; &quot;that is text&quot;
-</pre>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000328_source')" id="l_M000328_source">+</a> ]</p>
-  <div id="M000328_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/string/nchar.rb, line 15</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">nchar</span>(<span class="ruby-identifier">n</span>, <span class="ruby-identifier">replacement</span>=<span class="ruby-keyword kw">nil</span>)
-    <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">replacement</span>
-      <span class="ruby-identifier">s</span> = <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">dup</span>
-      <span class="ruby-identifier">n</span> <span class="ruby-operator">&gt;</span> <span class="ruby-value">0</span> <span class="ruby-operator">?</span> (<span class="ruby-identifier">s</span>[<span class="ruby-value">0</span><span class="ruby-operator">...</span><span class="ruby-identifier">n</span>] = <span class="ruby-identifier">replacement</span>) <span class="ruby-operator">:</span> (<span class="ruby-identifier">s</span>[<span class="ruby-identifier">n</span><span class="ruby-operator">..</span><span class="ruby-value">-1</span>] = <span class="ruby-identifier">replacement</span>)
-      <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">s</span>
-    <span class="ruby-keyword kw">else</span>
-      <span class="ruby-identifier">n</span> <span class="ruby-operator">&gt;</span> <span class="ruby-value">0</span> <span class="ruby-operator">?</span> <span class="ruby-keyword kw">self</span>[<span class="ruby-value">0</span><span class="ruby-operator">...</span><span class="ruby-identifier">n</span>] <span class="ruby-operator">:</span> <span class="ruby-keyword kw">self</span>[<span class="ruby-identifier">n</span><span class="ruby-operator">..</span><span class="ruby-value">-1</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="M000310"></a><b>outdent</b>(n)
-  </div>
-  <div class="description">
-  <p>
-Outdent just indents a negative number of spaces.
-</p>
-<p>
-CREDIT: Noah Gibbs
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000310_source')" id="l_M000310_source">+</a> ]</p>
-  <div id="M000310_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/string/indent.rb, line 20</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">outdent</span>(<span class="ruby-identifier">n</span>)
-    <span class="ruby-identifier">indent</span>(<span class="ruby-operator">-</span><span class="ruby-identifier">n</span>)
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000308"></a><b>pathize</b>()
-  </div>
-  <div class="description">
-  <p>
-Converts a (class or module) name to a unix path.
-</p>
-<pre>
-  My::CoolClass.name.pathize  #=&gt; &quot;my/cool_class&quot;
-</pre>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000308_source')" id="l_M000308_source">+</a> ]</p>
-  <div id="M000308_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/string/pathize.rb, line 7</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">pathize</span>
-    <span class="ruby-identifier">gsub</span>(<span class="ruby-regexp re">/([A-Z]+)([A-Z])/</span>,<span class="ruby-value str">'\1_\2'</span>).
-    <span class="ruby-identifier">gsub</span>(<span class="ruby-regexp re">/([a-z])([A-Z])/</span>,<span class="ruby-value str">'\1_\2'</span>).
-    <span class="ruby-identifier">gsub</span>(<span class="ruby-value str">'__'</span>,<span class="ruby-value str">'/'</span>).
-    <span class="ruby-identifier">gsub</span>(<span class="ruby-value str">'::'</span>,<span class="ruby-value str">'/'</span>).
-    <span class="ruby-identifier">downcase</span>
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000321"></a><b>quote</b>(type=:s)
-  </div>
-  <div class="description">
-  <p>
-Return a new string embraced by given quotes. If no quotes are specified,
-then assumes single quotes.
-</p>
-<pre>
-  &quot;quote me&quot;.quote     #=&gt; &quot;'quote me'&quot;
-  &quot;quote me&quot;.quote(2)  #=&gt; &quot;\&quot;quote me\&quot;&quot;
-</pre>
-<p>
-CREDIT: Trans
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000321_source')" id="l_M000321_source">+</a> ]</p>
-  <div id="M000321_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/string/bracket.rb, line 69</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">quote</span>(<span class="ruby-identifier">type</span>=<span class="ruby-identifier">:s</span>)
-    <span class="ruby-keyword kw">case</span> <span class="ruby-identifier">type</span>.<span class="ruby-identifier">to_s</span>.<span class="ruby-identifier">downcase</span>
-    <span class="ruby-keyword kw">when</span> <span class="ruby-value str">'s'</span>, <span class="ruby-value str">'single'</span>
-      <span class="ruby-identifier">bracket</span>(<span class="ruby-value str">&quot;'&quot;</span>)
-    <span class="ruby-keyword kw">when</span> <span class="ruby-value str">'d'</span>, <span class="ruby-value str">'double'</span>
-      <span class="ruby-identifier">bracket</span>(<span class="ruby-value str">'&quot;'</span>)
-    <span class="ruby-keyword kw">when</span> <span class="ruby-value str">'b'</span>, <span class="ruby-value str">'back'</span>
-      <span class="ruby-identifier">bracket</span>(<span class="ruby-value str">'`'</span>)
-    <span class="ruby-keyword kw">else</span>
-      <span class="ruby-identifier">bracket</span>(<span class="ruby-value str">&quot;'&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="M000291"></a><b>range</b>(s, offset=0)
-  </div>
-  <div class="description">
-  <p>
-Like index but returns a <a href="Range.html">Range</a>.
-</p>
-<pre>
-  &quot;This is a test!&quot;.range('test')  #=&gt; 10..13
-</pre>
-<p>
-CREDIT: Trans
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000291_source')" id="l_M000291_source">+</a> ]</p>
-  <div id="M000291_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/string/range.rb, line 9</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">range</span>(<span class="ruby-identifier">s</span>, <span class="ruby-identifier">offset</span>=<span class="ruby-value">0</span>)
-    <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">index</span>(<span class="ruby-identifier">s</span>, <span class="ruby-identifier">offset</span>)
-      <span class="ruby-keyword kw">return</span> (<span class="ruby-identifier">$~</span>.<span class="ruby-identifier">begin</span>(<span class="ruby-value">0</span>))<span class="ruby-operator">..</span>(<span class="ruby-identifier">$~</span>.<span class="ruby-identifier">end</span>(<span class="ruby-value">0</span>)<span class="ruby-operator">-</span><span class="ruby-value">1</span>)
-    <span class="ruby-keyword kw">end</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="M000292"></a><b>range_all</b>(s, reuse=false)
-  </div>
-  <div class="description">
-  <p>
-Like <a href="String.html#M000294">index_all</a> but returns an array of
-Ranges.
-</p>
-<pre>
-  &quot;abc123abc123&quot;.range_all('abc')  #=&gt; [0..2, 6..8]
-  TODO: Add offset, perhaps ?
-</pre>
-<p>
-CREDIT: Trans
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000292_source')" id="l_M000292_source">+</a> ]</p>
-  <div id="M000292_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/string/range.rb, line 24</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">range_all</span>(<span class="ruby-identifier">s</span>, <span class="ruby-identifier">reuse</span>=<span class="ruby-keyword kw">false</span>)
-    <span class="ruby-identifier">r</span> = []; <span class="ruby-identifier">i</span> = <span class="ruby-value">0</span>
-    <span class="ruby-keyword kw">while</span> <span class="ruby-identifier">i</span> <span class="ruby-operator">&lt;</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">length</span>
-      <span class="ruby-identifier">rng</span> = <span class="ruby-identifier">range</span>(<span class="ruby-identifier">s</span>, <span class="ruby-identifier">i</span>)
-      <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">rng</span>
-        <span class="ruby-identifier">r</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">rng</span>
-        <span class="ruby-identifier">i</span> <span class="ruby-operator">+=</span> <span class="ruby-identifier">reuse</span> <span class="ruby-value">? </span><span class="ruby-value">1</span> <span class="ruby-operator">:</span> <span class="ruby-identifier">rng</span>.<span class="ruby-identifier">end</span> <span class="ruby-operator">+</span> <span class="ruby-value">1</span>
-      <span class="ruby-keyword kw">else</span>
-        <span class="ruby-keyword kw">break</span>
-      <span class="ruby-keyword kw">end</span>
-    <span class="ruby-keyword kw">end</span>
-    <span class="ruby-identifier">r</span>.<span class="ruby-identifier">uniq</span>
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000293"></a><b>range_of_line</b>()
-  </div>
-  <div class="description">
-  <p>
-Returns an array of ranges mapping the characters per line.
-</p>
-<pre>
-  &quot;this\nis\na\ntest&quot;.range_of_line
-  #=&gt; [0..4, 5..7, 8..9, 10..13]
-</pre>
-<p>
-CREDIT: Trans
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000293_source')" id="l_M000293_source">+</a> ]</p>
-  <div id="M000293_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/string/range.rb, line 46</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">range_of_line</span>
-    <span class="ruby-identifier">offset</span>=<span class="ruby-value">0</span>; <span class="ruby-identifier">charmap</span> = []
-    <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">line</span><span class="ruby-operator">|</span>
-      <span class="ruby-identifier">charmap</span> <span class="ruby-operator">&lt;&lt;</span> (<span class="ruby-identifier">offset</span><span class="ruby-operator">..</span>(<span class="ruby-identifier">offset</span> <span class="ruby-operator">+</span> <span class="ruby-identifier">line</span>.<span class="ruby-identifier">length</span> <span class="ruby-operator">-</span> <span class="ruby-value">1</span>))
-      <span class="ruby-identifier">offset</span> <span class="ruby-operator">+=</span> <span class="ruby-identifier">line</span>.<span class="ruby-identifier">length</span>
-    <span class="ruby-keyword kw">end</span>
-    <span class="ruby-identifier">charmap</span>
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000327"></a><b>rewrite</b>(rules)
-  </div>
-  <div class="description">
-  <p>
-Apply a set of rules (regular expression matches) to the string.
-</p>
-<h3>Requirements:</h3>
-<p>
-The rules must be applied in order! So we cannot use a hash because the
-ordering is not guaranteed! we use an array instead.
-</p>
-<h3>Input:</h3>
-<p>
-The array containing rule-pairs (match, write).
-</p>
-<h3>Output:</h3>
-<p>
-The rewritten string.
-</p>
-<p>
-CREDIT: George Moschovitis
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000327_source')" id="l_M000327_source">+</a> ]</p>
-  <div id="M000327_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/string/rewrite.rb, line 18</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">rewrite</span>(<span class="ruby-identifier">rules</span>)
-    <span class="ruby-identifier">raise</span> <span class="ruby-constant">ArgumentError</span>.<span class="ruby-identifier">new</span>(<span class="ruby-value str">'The rules parameter is nil'</span>) <span class="ruby-keyword kw">unless</span> <span class="ruby-identifier">rules</span>
-    <span class="ruby-identifier">rewritten_string</span> = <span class="ruby-identifier">dup</span>
-    <span class="ruby-identifier">rules</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">match</span>,<span class="ruby-identifier">write</span><span class="ruby-operator">|</span>
-      <span class="ruby-identifier">rewritten_string</span>.<span class="ruby-identifier">gsub!</span>(<span class="ruby-identifier">match</span>,<span class="ruby-identifier">write</span>)
-    <span class="ruby-keyword kw">end</span>
-    <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">rewritten_string</span>
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000271"></a><b>shatter</b>( re )
-  </div>
-  <div class="description">
-  <p>
-Breaks a string up into an array based on a regular expression. Similar to
-scan, but includes the matches.
-</p>
-<pre>
-  s = &quot;&lt;p&gt;This&lt;b&gt;is&lt;/b&gt;a test.&lt;/p&gt;&quot;
-  s.shatter( /\&lt;.*?\&gt;/ )
-</pre>
-<p>
-<em>produces</em>
-</p>
-<pre>
-  [&quot;&lt;p&gt;&quot;, &quot;This&quot;, &quot;&lt;b&gt;&quot;, &quot;is&quot;, &quot;&lt;/b&gt;&quot;, &quot;a test.&quot;, &quot;&lt;/p&gt;&quot;]
-</pre>
-<p>
-CREDIT: Trans
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000271_source')" id="l_M000271_source">+</a> ]</p>
-  <div id="M000271_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/string/shatter.rb, line 15</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">shatter</span>( <span class="ruby-identifier">re</span> )
-    <span class="ruby-identifier">r</span> = <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">gsub</span>( <span class="ruby-identifier">re</span> ){ <span class="ruby-operator">|</span><span class="ruby-identifier">s</span><span class="ruby-operator">|</span> <span class="ruby-value str">&quot;\1&quot;</span> <span class="ruby-operator">+</span> <span class="ruby-identifier">s</span> <span class="ruby-operator">+</span> <span class="ruby-value str">&quot;\1&quot;</span> }
-    <span class="ruby-keyword kw">while</span> <span class="ruby-identifier">r</span>[<span class="ruby-value">0</span>,<span class="ruby-value">1</span>] <span class="ruby-operator">==</span> <span class="ruby-value str">&quot;\1&quot;</span> ; <span class="ruby-identifier">r</span>[<span class="ruby-value">0</span>] = <span class="ruby-value str">''</span> ; <span class="ruby-keyword kw">end</span>
-    <span class="ruby-keyword kw">while</span> <span class="ruby-identifier">r</span>[<span class="ruby-value">-1</span>,<span class="ruby-value">1</span>] <span class="ruby-operator">==</span> <span class="ruby-value str">&quot;\1&quot;</span> ; <span class="ruby-identifier">r</span>[<span class="ruby-value">-1</span>] = <span class="ruby-value str">''</span> ; <span class="ruby-keyword kw">end</span>
-    <span class="ruby-identifier">r</span>.<span class="ruby-identifier">split</span>(<span class="ruby-value str">&quot;\1&quot;</span>)
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000295"></a><b>snakecase</b>()
-  </div>
-  <div class="description">
-  <p>
-The reverse of <tt><a href="String.html#M000278">camelcase</a></tt>. Makes
-an underscored of a <a href="String.html#M000278">camelcase</a> string.
-</p>
-<p>
-Changes &#8217;::&#8217; to &#8217;/&#8217; to convert namespaces to paths.
-</p>
-<p>
-Examples
-</p>
-<pre>
-  &quot;SnakeCase&quot;.snakecase           #=&gt; &quot;snake_case&quot;
-  &quot;Snake-Case&quot;.snakecase          #=&gt; &quot;snake_case&quot;
-  &quot;SnakeCase::Errors&quot;.underscore  #=&gt; &quot;snake_case/errors&quot;
-</pre>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000295_source')" id="l_M000295_source">+</a> ]</p>
-  <div id="M000295_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/string/snakecase.rb, line 12</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">snakecase</span>
-    <span class="ruby-identifier">gsub</span>(<span class="ruby-regexp re">/::/</span>, <span class="ruby-value str">'/'</span>).  <span class="ruby-comment cmt"># NOT SO SURE ABOUT THIS -T</span>
-    <span class="ruby-identifier">gsub</span>(<span class="ruby-regexp re">/([A-Z]+)([A-Z][a-z])/</span>,<span class="ruby-value str">'\1_\2'</span>).
-    <span class="ruby-identifier">gsub</span>(<span class="ruby-regexp re">/([a-z\d])([A-Z])/</span>,<span class="ruby-value str">'\1_\2'</span>).
-    <span class="ruby-identifier">tr</span>(<span class="ruby-value str">&quot;-&quot;</span>, <span class="ruby-value str">&quot;_&quot;</span>).
-    <span class="ruby-identifier">downcase</span>
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000326"></a><b>splice</b>(idx, sub=nil)
-  </div>
-  <div class="description">
-  <p>
-This is basically the same as store, but it acts like slice! when given
-only one argument.
-</p>
-<p>
-Essentlay slice, but writes rather than reads.
-</p>
-<pre>
-  a = &quot;HELLO&quot;
-  a.splice(&quot;X&quot;, 1)
-  a                #=&gt; &quot;HXLLO&quot;
-  a = &quot;HELLO&quot;
-  a.splice(1)    #=&gt; &quot;E&quot;
-  a              #=&gt; &quot;HLLO&quot;
-</pre>
-<p>
-CREDIT: Trans
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000326_source')" id="l_M000326_source">+</a> ]</p>
-  <div id="M000326_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/string/splice.rb, line 20</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">splice</span>(<span class="ruby-identifier">idx</span>, <span class="ruby-identifier">sub</span>=<span class="ruby-keyword kw">nil</span>)
-    <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">sub</span>
-      <span class="ruby-identifier">store</span>(<span class="ruby-identifier">idx</span>, <span class="ruby-identifier">sub</span>)
-    <span class="ruby-keyword kw">else</span>
-      <span class="ruby-keyword kw">case</span> <span class="ruby-identifier">idx</span>
-      <span class="ruby-keyword kw">when</span> <span class="ruby-constant">Range</span>
-        <span class="ruby-identifier">slice!</span>(<span class="ruby-identifier">idx</span>)
-      <span class="ruby-keyword kw">else</span>
-        <span class="ruby-identifier">slice!</span>(<span class="ruby-identifier">idx</span>,<span class="ruby-value">1</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="M000276"></a><b>start_with?</b>(prefix)
-  </div>
-  <div class="description">
-  <p>
-Does a string start with the given prefix.
-</p>
-<pre>
-  &quot;hello&quot;.starts_with?(&quot;he&quot;)    #=&gt; true
-  &quot;hello&quot;.starts_with?(&quot;to&quot;)    #=&gt; false
-</pre>
-<p>
-CREDIT: Lucas Carlson, Blaine Cook
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000276_source')" id="l_M000276_source">+</a> ]</p>
-  <div id="M000276_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/string/start_with.rb, line 12</span>
-    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">start_with?</span>(<span class="ruby-identifier">prefix</span>)
-      <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">index</span>(<span class="ruby-identifier">prefix</span>) <span class="ruby-operator">==</span> <span class="ruby-value">0</span>
-    <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000287"></a><b>tab</b>(n)
-  </div>
-  <div class="description">
-  <p>
-Aligns each line n spaces.
-</p>
-<p>
-CREDIT: Gavin Sinclair
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000287_source')" id="l_M000287_source">+</a> ]</p>
-  <div id="M000287_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/string/tab.rb, line 12</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">tab</span>(<span class="ruby-identifier">n</span>)
-    <span class="ruby-identifier">gsub</span>(<span class="ruby-regexp re">/^ */</span>, <span class="ruby-value str">' '</span> <span class="ruby-operator">*</span> <span class="ruby-identifier">n</span>)
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000312"></a><b>tabto</b>(n)
-  </div>
-  <div class="description">
-  <p>
-Preserves relative tabbing. The first non-empty line ends up with n spaces
-before nonspace.
-</p>
-<p>
-CREDIT: Gavin Sinclair
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000312_source')" id="l_M000312_source">+</a> ]</p>
-  <div id="M000312_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/string/tabto.rb, line 10</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">tabto</span>(<span class="ruby-identifier">n</span>)
-    <span class="ruby-keyword kw">if</span> <span class="ruby-keyword kw">self</span> <span class="ruby-operator">=~</span> <span class="ruby-regexp re">/^( *)\S/</span>
-      <span class="ruby-identifier">indent</span>(<span class="ruby-identifier">n</span> <span class="ruby-operator">-</span> <span class="ruby-identifier">$1</span>.<span class="ruby-identifier">length</span>)
-    <span class="ruby-keyword kw">else</span>
-      <span class="ruby-keyword kw">self</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="M000311"></a><b>titlecase</b>()
-  </div>
-  <div class="description">
-  <p>
-Title case.
-</p>
-<pre>
-  &quot;this is a string&quot;.titlecase
-  =&gt; &quot;This Is A String&quot;
-</pre>
-<p>
-CREDIT: Eliazar Parra
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000311_source')" id="l_M000311_source">+</a> ]</p>
-  <div id="M000311_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/string/titlecase.rb, line 10</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">titlecase</span>
-    <span class="ruby-identifier">gsub</span>(<span class="ruby-regexp re">/\b\w/</span>){<span class="ruby-identifier">$&amp;</span>.<span class="ruby-identifier">upcase</span>}
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000269"></a><b>to_b</b>()
-  </div>
-  <div class="description">
-  <p>
-Interpret common affirmative string meanings as true, otherwise false.
-Balnk sapce and case are ignored. The following strings that will return
-true:
-</p>
-<pre>
-  &lt;tt&gt;true&lt;/tt&gt;,&lt;tt&gt;yes&lt;/tt&gt;,&lt;tt&gt;on&lt;/tt&gt;,&lt;tt&gt;t&lt;/tt&gt;,&lt;tt&gt;1&lt;/tt&gt;,&lt;tt&gt;y&lt;/tt&gt;,&lt;tt&gt;==&lt;/tt&gt;
-</pre>
-<p>
-Examples:
-</p>
-<pre>
-  &quot;true&quot;.to_b   #=&gt; true
-  &quot;yes&quot;.to_b    #=&gt; true
-  &quot;no&quot;.to_b     #=&gt; false
-  &quot;123&quot;.to_b    #=&gt; false
-</pre>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000269_source')" id="l_M000269_source">+</a> ]</p>
-  <div id="M000269_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/boolean.rb, line 43</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">to_b</span>
-    <span class="ruby-keyword kw">case</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">downcase</span>.<span class="ruby-identifier">strip</span>
-    <span class="ruby-keyword kw">when</span> <span class="ruby-value str">'true'</span>, <span class="ruby-value str">'yes'</span>, <span class="ruby-value str">'on'</span>, <span class="ruby-value str">'t'</span>, <span class="ruby-value str">'1'</span>, <span class="ruby-value str">'y'</span>, <span class="ruby-value str">'=='</span>
-      <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">true</span>
-    <span class="ruby-keyword kw">when</span> <span class="ruby-value str">'nil'</span>, <span class="ruby-value str">'null'</span>
-      <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">nil</span>
-    <span class="ruby-keyword kw">else</span>
-      <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">false</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="M000273"></a><b>to_re</b>(esc=false)
-  </div>
-  <div class="description">
-  <p>
-Turns a string into a regular expression.
-</p>
-<pre>
-  &quot;a?&quot;.to_re  #=&gt; /a?/
-</pre>
-<p>
-CREDIT: Trans
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000273_source')" id="l_M000273_source">+</a> ]</p>
-  <div id="M000273_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/string/to_re.rb, line 9</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">to_re</span>(<span class="ruby-identifier">esc</span>=<span class="ruby-keyword kw">false</span>)
-    <span class="ruby-constant">Regexp</span>.<span class="ruby-identifier">new</span>((<span class="ruby-identifier">esc</span> <span class="ruby-value">? </span><span class="ruby-constant">Regexp</span>.<span class="ruby-identifier">escape</span>(<span class="ruby-keyword kw">self</span>) <span class="ruby-operator">:</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="M000274"></a><b>to_rx</b>(esc=true)
-  </div>
-  <div class="description">
-  <p>
-Turns a string into a regular expression. By default it will escape all
-characters. Use <tt>false</tt> argument to turn off escaping.
-</p>
-<pre>
-  &quot;[&quot;.to_rx  #=&gt; /\[/
-</pre>
-<p>
-CREDIT: Trans
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000274_source')" id="l_M000274_source">+</a> ]</p>
-  <div id="M000274_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/string/to_re.rb, line 21</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">to_rx</span>(<span class="ruby-identifier">esc</span>=<span class="ruby-keyword kw">true</span>)
-    <span class="ruby-constant">Regexp</span>.<span class="ruby-identifier">new</span>((<span class="ruby-identifier">esc</span> <span class="ruby-value">? </span><span class="ruby-constant">Regexp</span>.<span class="ruby-identifier">escape</span>(<span class="ruby-keyword kw">self</span>) <span class="ruby-operator">:</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="M000319"></a><b>unbracket</b>(bra=nil, ket=nil)
-  </div>
-  <div class="description">
-  <p>
-Return a new string embraced by given brakets. If only one <a
-href="String.html#M000317">bracket</a> char is given it will be placed on
-either side.
-</p>
-<pre>
-  &quot;{unwrap me}&quot;.debracket('{')        #=&gt; &quot;unwrap me&quot;
-  &quot;--unwrap me!&quot;.debracket('--','!')  #=&gt; &quot;unwrap me!&quot;
-</pre>
-<p>
-CREDIT: Trans
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000319_source')" id="l_M000319_source">+</a> ]</p>
-  <div id="M000319_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/string/bracket.rb, line 37</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">unbracket</span>(<span class="ruby-identifier">bra</span>=<span class="ruby-keyword kw">nil</span>, <span class="ruby-identifier">ket</span>=<span class="ruby-keyword kw">nil</span>)
-    <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">bra</span>
-      <span class="ruby-identifier">ket</span> = <span class="ruby-constant">BRA2KET</span>[<span class="ruby-identifier">bra</span>] <span class="ruby-keyword kw">unless</span> <span class="ruby-identifier">ket</span>
-      <span class="ruby-identifier">ket</span> = <span class="ruby-identifier">ket</span> <span class="ruby-value">? </span><span class="ruby-identifier">ket</span> <span class="ruby-operator">:</span> <span class="ruby-identifier">bra</span>
-      <span class="ruby-identifier">s</span> = <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">dup</span>
-      <span class="ruby-identifier">s</span>.<span class="ruby-identifier">gsub!</span>(<span class="ruby-node">%r[^#{Regexp.escape(bra)}]</span>, <span class="ruby-value str">''</span>)
-      <span class="ruby-identifier">s</span>.<span class="ruby-identifier">gsub!</span>(<span class="ruby-node">%r[#{Regexp.escape(ket)}$]</span>, <span class="ruby-value str">''</span>)
-      <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">s</span>
-    <span class="ruby-keyword kw">else</span>
-      <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">m</span> = <span class="ruby-constant">BRA2KET</span>[ <span class="ruby-keyword kw">self</span>[<span class="ruby-value">0</span>,<span class="ruby-value">1</span>] ]
-        <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">slice</span>(<span class="ruby-value">1</span><span class="ruby-operator">...</span><span class="ruby-value">-1</span>) <span class="ruby-keyword kw">if</span> <span class="ruby-keyword kw">self</span>[<span class="ruby-value">-1</span>,<span class="ruby-value">1</span>]  <span class="ruby-operator">==</span> <span class="ruby-identifier">m</span>
-      <span class="ruby-keyword kw">end</span>
-    <span class="ruby-keyword kw">end</span>
-    <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">dup</span>  <span class="ruby-comment cmt"># if nothing else</span>
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000320"></a><b>unbracket!</b>(bra=nil, ket=nil)
-  </div>
-  <div class="description">
-  <p>
-Inplace version of debraket.
-</p>
-<p>
-CREDIT: Trans
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000320_source')" id="l_M000320_source">+</a> ]</p>
-  <div id="M000320_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/string/bracket.rb, line 57</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">unbracket!</span>(<span class="ruby-identifier">bra</span>=<span class="ruby-keyword kw">nil</span>, <span class="ruby-identifier">ket</span>=<span class="ruby-keyword kw">nil</span>)
-    <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">replace</span>( <span class="ruby-identifier">unbracket</span>(<span class="ruby-identifier">bra</span>, <span class="ruby-identifier">ket</span>) )
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000302"></a><b>upcase?</b>()
-  </div>
-  <div class="description">
-  <p>
-Is the string upcase/uppercase?
-</p>
-<pre>
-  &quot;THIS&quot;.upcase?  #=&gt; true
-  &quot;This&quot;.upcase?  #=&gt; false
-  &quot;this&quot;.upcase?  #=&gt; false
-</pre>
-<p>
-CREDIT: Phil Tomson
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000302_source')" id="l_M000302_source">+</a> ]</p>
-  <div id="M000302_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/string/capitalized.rb, line 38</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">upcase?</span>
-    <span class="ruby-identifier">upcase</span> <span class="ruby-operator">==</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="M000306"></a><b>variablize</b>()
-  </div>
-  <div class="description">
-  <p>
-Prepend an &quot;@&quot; to the beginning of a string to make a instance
-variable name. This also replaces non-valid characters with underscores.
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000306_source')" id="l_M000306_source">+</a> ]</p>
-  <div id="M000306_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/string/variablize.rb, line 7</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">variablize</span>
-    <span class="ruby-identifier">v</span> = <span class="ruby-identifier">gsub</span>(<span class="ruby-regexp re">/\W/</span>, <span class="ruby-value str">'_'</span>)
-    <span class="ruby-node">&quot;@#{v}&quot;</span>
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000281"></a><b>word_wrap</b>( col_width=80 )
-  </div>
-  <div class="description">
-  <p>
-Word wrap a string not exceeding max width.
-</p>
-<pre>
-  puts &quot;this is a test&quot;.word_wrap(4)
-</pre>
-<p>
-<em>produces</em>
-</p>
-<pre>
-  this
-  is a
-  test
-</pre>
-<p>
-This is basic implementation of word wrap, but smart enough to suffice for
-most use cases.
-</p>
-<p>
-CREDIT: Gavin Kistner, Dayne Broderson
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000281_source')" id="l_M000281_source">+</a> ]</p>
-  <div id="M000281_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/string/word_wrap.rb, line 18</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">word_wrap</span>( <span class="ruby-identifier">col_width</span>=<span class="ruby-value">80</span> )
-    <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">dup</span>.<span class="ruby-identifier">word_wrap!</span>( <span class="ruby-identifier">col_width</span> )
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000282"></a><b>word_wrap!</b>( col_width=80 )
-  </div>
-  <div class="description">
-  <p>
-As with <a href="String.html#M000281">word_wrap</a>, but modifies the
-string in place.
-</p>
-<p>
-CREDIT: Gavin Kistner, Dayne Broderson
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000282_source')" id="l_M000282_source">+</a> ]</p>
-  <div id="M000282_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/string/word_wrap.rb, line 26</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">word_wrap!</span>( <span class="ruby-identifier">col_width</span>=<span class="ruby-value">80</span> )
-    <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">gsub!</span>( <span class="ruby-node">/(\S{#{col_width}})(?=\S)/</span>, <span class="ruby-value str">'\1 '</span> )
-    <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">gsub!</span>( <span class="ruby-node">/(.{1,#{col_width}})(?:\s+|$)/</span>, <span class="ruby-value str">&quot;\\1\n&quot;</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="M000313"></a><b>words</b>()
-  </div>
-  <div class="description">
-  <p>
-Returns an array of characters.
-</p>
-<pre>
-  &quot;abc 123&quot;.words  #=&gt; [&quot;abc&quot;,&quot;123&quot;]
-</pre>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000313_source')" id="l_M000313_source">+</a> ]</p>
-  <div id="M000313_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/string/words.rb, line 7</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">words</span>
-    <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">split</span>(<span class="ruby-regexp re">/\s+/</span>)
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-</div>
-  </div>
-    </body>
-</html>