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

facets 2.5.2 → 2.6.0

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

Files changed (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>