HEX
Server: Apache
System: Windows NT MAGNETO-ARM 10.0 build 22000 (Windows 10) AMD64
User: Michel (0)
PHP: 7.4.7
Disabled: NONE
Upload Files
File: C:/Ruby27-x64/share/doc/ruby/html/Random/Formatter.html
<!DOCTYPE html>

<html>
<head>
<meta charset="UTF-8">

<title>module Random::Formatter - RDoc Documentation</title>

<script type="text/javascript">
  var rdoc_rel_prefix = "../";
  var index_rel_prefix = "../";
</script>

<script src="../js/navigation.js" defer></script>
<script src="../js/search.js" defer></script>
<script src="../js/search_index.js" defer></script>
<script src="../js/searcher.js" defer></script>
<script src="../js/darkfish.js" defer></script>

<link href="../css/fonts.css" rel="stylesheet">
<link href="../css/rdoc.css" rel="stylesheet">




<body id="top" role="document" class="module">
<nav role="navigation">
  <div id="project-navigation">
    <div id="home-section" role="region" title="Quick navigation" class="nav-section">
  <h2>
    <a href="../index.html" rel="home">Home</a>
  </h2>

  <div id="table-of-contents-navigation">
    <a href="../table_of_contents.html#pages">Pages</a>
    <a href="../table_of_contents.html#classes">Classes</a>
    <a href="../table_of_contents.html#methods">Methods</a>
  </div>
</div>

    <div id="search-section" role="search" class="project-section initially-hidden">
  <form action="#" method="get" accept-charset="utf-8">
    <div id="search-field-wrapper">
      <input id="search-field" role="combobox" aria-label="Search"
             aria-autocomplete="list" aria-controls="search-results"
             type="text" name="search" placeholder="Search" spellcheck="false"
             title="Type to search, Up and Down to navigate, Enter to load">
    </div>

    <ul id="search-results" aria-label="Search Results"
        aria-busy="false" aria-expanded="false"
        aria-atomic="false" class="initially-hidden"></ul>
  </form>
</div>

  </div>

  

  <div id="class-metadata">
    
    
    
    
    <!-- Method Quickref -->
<div id="method-list-section" class="nav-section">
  <h3>Methods</h3>

  <ul class="link-list" role="directory">
    
    <li ><a href="#method-i-alphanumeric">#alphanumeric</a>
    
    <li ><a href="#method-i-base64">#base64</a>
    
    <li ><a href="#method-i-choose">#choose</a>
    
    <li ><a href="#method-i-gen_random">#gen_random</a>
    
    <li ><a href="#method-i-hex">#hex</a>
    
    <li ><a href="#method-i-rand">#rand</a>
    
    <li ><a href="#method-i-random_bytes">#random_bytes</a>
    
    <li ><a href="#method-i-random_number">#random_number</a>
    
    <li ><a href="#method-i-urlsafe_base64">#urlsafe_base64</a>
    
    <li ><a href="#method-i-uuid">#uuid</a>
    
  </ul>
</div>

  </div>
</nav>

<main role="main" aria-labelledby="module-Random::Formatter">
  <h1 id="module-Random::Formatter" class="module">
    module Random::Formatter
  </h1>

  <section class="description">
    
<p>Format raw random number as <a href="../Random.html"><code>Random</code></a> does</p>

  </section>

  
  <section id="5Buntitled-5D" class="documentation-section">
    

    

    
    <section class="constants-list">
      <header>
        <h3>Constants</h3>
      </header>
      <dl>
      
        <dt id="ALPHANUMERIC">ALPHANUMERIC
        
        <dd>
        
      
      </dl>
    </section>
    

    

    
     <section id="public-instance-5Buntitled-5D-method-details" class="method-section">
       <header>
         <h3>Public Instance Methods</h3>
       </header>

    
      <div id="method-i-alphanumeric" class="method-detail ">
        
        <div class="method-heading">
          <span class="method-name">alphanumeric</span><span
            class="method-args">(n=nil)</span>
          
          <span class="method-click-advice">click to toggle source</span>
          
        </div>
        

        <div class="method-description">
          
          <p>SecureRandom.alphanumeric generates a random alphanumeric string.</p>

<p>The argument <em>n</em> specifies the length, in characters, of the alphanumeric string to be generated.</p>

<p>If <em>n</em> is not specified or is nil, 16 is assumed. It may be larger in the future.</p>

<p>The result may contain A-Z, a-z and 0-9.</p>

<pre class="ruby"><span class="ruby-identifier">require</span> <span class="ruby-string">&#39;securerandom&#39;</span>

<span class="ruby-constant">SecureRandom</span>.<span class="ruby-identifier">alphanumeric</span>     <span class="ruby-comment">#=&gt; &quot;2BuBuLf3WfSKyQbR&quot;</span>
<span class="ruby-constant">SecureRandom</span>.<span class="ruby-identifier">alphanumeric</span>(<span class="ruby-value">10</span>) <span class="ruby-comment">#=&gt; &quot;i6K93NdqiH&quot;</span>
</pre>

<p>If a secure random number generator is not available, <code>NotImplementedError</code> is raised.</p>
          
          

          
          <div class="method-source-code" id="alphanumeric-source">
            <pre><span class="ruby-comment"># File lib/securerandom.rb, line 326</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">alphanumeric</span>(<span class="ruby-identifier">n</span>=<span class="ruby-keyword">nil</span>)
  <span class="ruby-identifier">n</span> = <span class="ruby-value">16</span> <span class="ruby-keyword">if</span> <span class="ruby-identifier">n</span>.<span class="ruby-identifier">nil?</span>
  <span class="ruby-identifier">choose</span>(<span class="ruby-constant">ALPHANUMERIC</span>, <span class="ruby-identifier">n</span>)
<span class="ruby-keyword">end</span></pre>
          </div>
          
        </div>

        

        
      </div>

    
      <div id="method-i-base64" class="method-detail ">
        
        <div class="method-heading">
          <span class="method-name">base64</span><span
            class="method-args">(n=nil)</span>
          
          <span class="method-click-advice">click to toggle source</span>
          
        </div>
        

        <div class="method-description">
          
          <p>SecureRandom.base64 generates a random base64 string.</p>

<p>The argument <em>n</em> specifies the length, in bytes, of the random number to be generated. The length of the result string is about 4/3 of <em>n</em>.</p>

<p>If <em>n</em> is not specified or is nil, 16 is assumed. It may be larger in the future.</p>

<p>The result may contain A-Z, a-z, 0-9, “+”, “/” and “=”.</p>

<pre class="ruby"><span class="ruby-identifier">require</span> <span class="ruby-string">&#39;securerandom&#39;</span>

<span class="ruby-constant">SecureRandom</span>.<span class="ruby-identifier">base64</span> <span class="ruby-comment">#=&gt; &quot;/2BuBuLf3+WfSKyQbRcc/A==&quot;</span>
<span class="ruby-constant">SecureRandom</span>.<span class="ruby-identifier">base64</span> <span class="ruby-comment">#=&gt; &quot;6BbW0pxO0YENxn38HMUbcQ==&quot;</span>
</pre>

<p>If a secure random number generator is not available, <code>NotImplementedError</code> is raised.</p>

<p>See RFC 3548 for the definition of base64.</p>
          
          

          
          <div class="method-source-code" id="base64-source">
            <pre><span class="ruby-comment"># File lib/securerandom.rb, line 197</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">base64</span>(<span class="ruby-identifier">n</span>=<span class="ruby-keyword">nil</span>)
  [<span class="ruby-identifier">random_bytes</span>(<span class="ruby-identifier">n</span>)].<span class="ruby-identifier">pack</span>(<span class="ruby-string">&quot;m0&quot;</span>)
<span class="ruby-keyword">end</span></pre>
          </div>
          
        </div>

        

        
      </div>

    
      <div id="method-i-hex" class="method-detail ">
        
        <div class="method-heading">
          <span class="method-name">hex</span><span
            class="method-args">(n=nil)</span>
          
          <span class="method-click-advice">click to toggle source</span>
          
        </div>
        

        <div class="method-description">
          
          <p>SecureRandom.hex generates a random hexadecimal string.</p>

<p>The argument <em>n</em> specifies the length, in bytes, of the random number to be generated. The length of the resulting hexadecimal string is twice of <em>n</em>.</p>

<p>If <em>n</em> is not specified or is nil, 16 is assumed. It may be larger in the future.</p>

<p>The result may contain 0-9 and a-f.</p>

<pre class="ruby"><span class="ruby-identifier">require</span> <span class="ruby-string">&#39;securerandom&#39;</span>

<span class="ruby-constant">SecureRandom</span>.<span class="ruby-identifier">hex</span> <span class="ruby-comment">#=&gt; &quot;eb693ec8252cd630102fd0d0fb7c3485&quot;</span>
<span class="ruby-constant">SecureRandom</span>.<span class="ruby-identifier">hex</span> <span class="ruby-comment">#=&gt; &quot;91dc3bfb4de5b11d029d376634589b61&quot;</span>
</pre>

<p>If a secure random number generator is not available, <code>NotImplementedError</code> is raised.</p>
          
          

          
          <div class="method-source-code" id="hex-source">
            <pre><span class="ruby-comment"># File lib/securerandom.rb, line 174</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">hex</span>(<span class="ruby-identifier">n</span>=<span class="ruby-keyword">nil</span>)
  <span class="ruby-identifier">random_bytes</span>(<span class="ruby-identifier">n</span>).<span class="ruby-identifier">unpack</span>(<span class="ruby-string">&quot;H*&quot;</span>)[<span class="ruby-value">0</span>]
<span class="ruby-keyword">end</span></pre>
          </div>
          
        </div>

        

        
      </div>

    
      <div id="method-i-rand" class="method-detail ">
        
        
        <div class="method-heading">
          <span class="method-callseq">
            random_number      &rarr; float
          </span>
          
          <span class="method-click-advice">click to toggle source</span>
          
        </div>
        
        <div class="method-heading">
          <span class="method-callseq">
            random_number(max) &rarr; number
          </span>
          
        </div>
        
        <div class="method-heading">
          <span class="method-callseq">
            rand               &rarr; float
          </span>
          
        </div>
        
        <div class="method-heading">
          <span class="method-callseq">
            rand(max)          &rarr; number
          </span>
          
        </div>
        
        

        <div class="method-description">
          
          <p>Generates formatted random number from raw random bytes. See <a href="../Random.html#method-i-rand"><code>Random#rand</code></a>.</p>
          
          

          
          <div class="method-source-code" id="rand-source">
            <pre>static VALUE
rand_random_number(int argc, VALUE *argv, VALUE obj)
{
    rb_random_t *rnd = try_get_rnd(obj);
    VALUE v = rand_random(argc, argv, obj, rnd);
    if (NIL_P(v)) v = rand_random(0, 0, obj, rnd);
    else if (!v) invalid_argument(argv[0]);
    return v;
}</pre>
          </div>
          
        </div>

        

        
      </div>

    
      <div id="method-i-random_bytes" class="method-detail ">
        
        <div class="method-heading">
          <span class="method-name">random_bytes</span><span
            class="method-args">(n=nil)</span>
          
          <span class="method-click-advice">click to toggle source</span>
          
        </div>
        

        <div class="method-description">
          
          <p>SecureRandom.random_bytes generates a random binary string.</p>

<p>The argument <em>n</em> specifies the length of the result string.</p>

<p>If <em>n</em> is not specified or is nil, 16 is assumed. It may be larger in future.</p>

<p>The result may contain any byte: “x00” - “xff”.</p>

<pre class="ruby"><span class="ruby-identifier">require</span> <span class="ruby-string">&#39;securerandom&#39;</span>

<span class="ruby-constant">SecureRandom</span>.<span class="ruby-identifier">random_bytes</span> <span class="ruby-comment">#=&gt; &quot;\xD8\\\xE0\xF4\r\xB2\xFC*WM\xFF\x83\x18\xF45\xB6&quot;</span>
<span class="ruby-constant">SecureRandom</span>.<span class="ruby-identifier">random_bytes</span> <span class="ruby-comment">#=&gt; &quot;m\xDC\xFC/\a\x00Uf\xB2\xB2P\xBD\xFF6S\x97&quot;</span>
</pre>

<p>If a secure random number generator is not available, <code>NotImplementedError</code> is raised.</p>
          
          

          
          <div class="method-source-code" id="random_bytes-source">
            <pre><span class="ruby-comment"># File lib/securerandom.rb, line 152</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">random_bytes</span>(<span class="ruby-identifier">n</span>=<span class="ruby-keyword">nil</span>)
  <span class="ruby-identifier">n</span> = <span class="ruby-identifier">n</span> <span class="ruby-operator">?</span> <span class="ruby-identifier">n</span>.<span class="ruby-identifier">to_int</span> <span class="ruby-operator">:</span> <span class="ruby-value">16</span>
  <span class="ruby-identifier">gen_random</span>(<span class="ruby-identifier">n</span>)
<span class="ruby-keyword">end</span></pre>
          </div>
          
        </div>

        

        
      </div>

    
      <div id="method-i-random_number" class="method-detail ">
        
        
        <div class="method-heading">
          <span class="method-callseq">
            random_number      &rarr; float
          </span>
          
          <span class="method-click-advice">click to toggle source</span>
          
        </div>
        
        <div class="method-heading">
          <span class="method-callseq">
            random_number(max) &rarr; number
          </span>
          
        </div>
        
        

        <div class="method-description">
          
          <p>Generates formatted random number from raw random bytes. See <a href="../Random.html#method-i-rand"><code>Random#rand</code></a>.</p>
          
          

          
          <div class="method-source-code" id="random_number-source">
            <pre>static VALUE
rand_random_number(int argc, VALUE *argv, VALUE obj)
{
    rb_random_t *rnd = try_get_rnd(obj);
    VALUE v = rand_random(argc, argv, obj, rnd);
    if (NIL_P(v)) v = rand_random(0, 0, obj, rnd);
    else if (!v) invalid_argument(argv[0]);
    return v;
}</pre>
          </div>
          
        </div>

        

        
      </div>

    
      <div id="method-i-urlsafe_base64" class="method-detail ">
        
        <div class="method-heading">
          <span class="method-name">urlsafe_base64</span><span
            class="method-args">(n=nil, padding=false)</span>
          
          <span class="method-click-advice">click to toggle source</span>
          
        </div>
        

        <div class="method-description">
          
          <p>SecureRandom.urlsafe_base64 generates a random URL-safe base64 string.</p>

<p>The argument <em>n</em> specifies the length, in bytes, of the random number to be generated. The length of the result string is about 4/3 of <em>n</em>.</p>

<p>If <em>n</em> is not specified or is nil, 16 is assumed. It may be larger in the future.</p>

<p>The boolean argument <em>padding</em> specifies the padding. If it is false or nil, padding is not generated. Otherwise padding is generated. By default, padding is not generated because “=” may be used as a URL delimiter.</p>

<p>The result may contain A-Z, a-z, 0-9, “-” and “_”. “=” is also used if <em>padding</em> is true.</p>

<pre class="ruby"><span class="ruby-identifier">require</span> <span class="ruby-string">&#39;securerandom&#39;</span>

<span class="ruby-constant">SecureRandom</span>.<span class="ruby-identifier">urlsafe_base64</span> <span class="ruby-comment">#=&gt; &quot;b4GOKm4pOYU_-BOXcrUGDg&quot;</span>
<span class="ruby-constant">SecureRandom</span>.<span class="ruby-identifier">urlsafe_base64</span> <span class="ruby-comment">#=&gt; &quot;UZLdOkzop70Ddx-IJR0ABg&quot;</span>

<span class="ruby-constant">SecureRandom</span>.<span class="ruby-identifier">urlsafe_base64</span>(<span class="ruby-keyword">nil</span>, <span class="ruby-keyword">true</span>) <span class="ruby-comment">#=&gt; &quot;i0XQ-7gglIsHGV2_BNPrdQ==&quot;</span>
<span class="ruby-constant">SecureRandom</span>.<span class="ruby-identifier">urlsafe_base64</span>(<span class="ruby-keyword">nil</span>, <span class="ruby-keyword">true</span>) <span class="ruby-comment">#=&gt; &quot;-M8rLhr7JEpJlqFGUMmOxg==&quot;</span>
</pre>

<p>If a secure random number generator is not available, <code>NotImplementedError</code> is raised.</p>

<p>See RFC 3548 for the definition of URL-safe base64.</p>
          
          

          
          <div class="method-source-code" id="urlsafe_base64-source">
            <pre><span class="ruby-comment"># File lib/securerandom.rb, line 229</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">urlsafe_base64</span>(<span class="ruby-identifier">n</span>=<span class="ruby-keyword">nil</span>, <span class="ruby-identifier">padding</span>=<span class="ruby-keyword">false</span>)
  <span class="ruby-identifier">s</span> = [<span class="ruby-identifier">random_bytes</span>(<span class="ruby-identifier">n</span>)].<span class="ruby-identifier">pack</span>(<span class="ruby-string">&quot;m0&quot;</span>)
  <span class="ruby-identifier">s</span>.<span class="ruby-identifier">tr!</span>(<span class="ruby-string">&quot;+/&quot;</span>, <span class="ruby-string">&quot;-_&quot;</span>)
  <span class="ruby-identifier">s</span>.<span class="ruby-identifier">delete!</span>(<span class="ruby-string">&quot;=&quot;</span>) <span class="ruby-keyword">unless</span> <span class="ruby-identifier">padding</span>
  <span class="ruby-identifier">s</span>
<span class="ruby-keyword">end</span></pre>
          </div>
          
        </div>

        

        
      </div>

    
      <div id="method-i-uuid" class="method-detail ">
        
        <div class="method-heading">
          <span class="method-name">uuid</span><span
            class="method-args">()</span>
          
          <span class="method-click-advice">click to toggle source</span>
          
        </div>
        

        <div class="method-description">
          
          <p>SecureRandom.uuid generates a random v4 UUID (Universally Unique IDentifier).</p>

<pre class="ruby"><span class="ruby-identifier">require</span> <span class="ruby-string">&#39;securerandom&#39;</span>

<span class="ruby-constant">SecureRandom</span>.<span class="ruby-identifier">uuid</span> <span class="ruby-comment">#=&gt; &quot;2d931510-d99f-494a-8c67-87feb05e1594&quot;</span>
<span class="ruby-constant">SecureRandom</span>.<span class="ruby-identifier">uuid</span> <span class="ruby-comment">#=&gt; &quot;bad85eb9-0713-4da7-8d36-07a8e4b00eab&quot;</span>
<span class="ruby-constant">SecureRandom</span>.<span class="ruby-identifier">uuid</span> <span class="ruby-comment">#=&gt; &quot;62936e70-1815-439b-bf89-8492855a7e6b&quot;</span>
</pre>

<p>The version 4 UUID is purely random (except the version). It doesn&#39;t contain meaningful information such as MAC addresses, timestamps, etc.</p>

<p>The result contains 122 random bits (15.25 random bytes).</p>

<p>See RFC 4122 for details of UUID.</p>
          
          

          
          <div class="method-source-code" id="uuid-source">
            <pre><span class="ruby-comment"># File lib/securerandom.rb, line 251</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">uuid</span>
  <span class="ruby-identifier">ary</span> = <span class="ruby-identifier">random_bytes</span>(<span class="ruby-value">16</span>).<span class="ruby-identifier">unpack</span>(<span class="ruby-string">&quot;NnnnnN&quot;</span>)
  <span class="ruby-identifier">ary</span>[<span class="ruby-value">2</span>] = (<span class="ruby-identifier">ary</span>[<span class="ruby-value">2</span>] <span class="ruby-operator">&amp;</span> <span class="ruby-value">0x0fff</span>) <span class="ruby-operator">|</span> <span class="ruby-value">0x4000</span>
  <span class="ruby-identifier">ary</span>[<span class="ruby-value">3</span>] = (<span class="ruby-identifier">ary</span>[<span class="ruby-value">3</span>] <span class="ruby-operator">&amp;</span> <span class="ruby-value">0x3fff</span>) <span class="ruby-operator">|</span> <span class="ruby-value">0x8000</span>
  <span class="ruby-string">&quot;%08x-%04x-%04x-%04x-%04x%08x&quot;</span> <span class="ruby-operator">%</span> <span class="ruby-identifier">ary</span>
<span class="ruby-keyword">end</span></pre>
          </div>
          
        </div>

        

        
      </div>

    
    </section>
  
     <section id="private-instance-5Buntitled-5D-method-details" class="method-section">
       <header>
         <h3>Private Instance Methods</h3>
       </header>

    
      <div id="method-i-choose" class="method-detail ">
        
        <div class="method-heading">
          <span class="method-name">choose</span><span
            class="method-args">(source, n)</span>
          
          <span class="method-click-advice">click to toggle source</span>
          
        </div>
        

        <div class="method-description">
          
          <p>SecureRandom.choose generates a string that randomly draws from a source array of characters.</p>

<p>The argument <em>source</em> specifies the array of characters from which to generate the string. The argument <em>n</em> specifies the length, in characters, of the string to be generated.</p>

<p>The result may contain whatever characters are in the source array.</p>

<pre class="ruby"><span class="ruby-identifier">require</span> <span class="ruby-string">&#39;securerandom&#39;</span>

<span class="ruby-constant">SecureRandom</span>.<span class="ruby-identifier">choose</span>([<span class="ruby-operator">*</span><span class="ruby-string">&#39;l&#39;</span><span class="ruby-operator">..</span><span class="ruby-string">&#39;r&#39;</span>], <span class="ruby-value">16</span>) <span class="ruby-comment">#=&gt; &quot;lmrqpoonmmlqlron&quot;</span>
<span class="ruby-constant">SecureRandom</span>.<span class="ruby-identifier">choose</span>([<span class="ruby-operator">*</span><span class="ruby-string">&#39;0&#39;</span><span class="ruby-operator">..</span><span class="ruby-string">&#39;9&#39;</span>], <span class="ruby-value">5</span>)  <span class="ruby-comment">#=&gt; &quot;27309&quot;</span>
</pre>

<p>If a secure random number generator is not available, <code>NotImplementedError</code> is raised.</p>
          
          

          
          <div class="method-source-code" id="choose-source">
            <pre><span class="ruby-comment"># File lib/securerandom.rb, line 279</span>
        <span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">choose</span>(<span class="ruby-identifier">source</span>, <span class="ruby-identifier">n</span>)
  <span class="ruby-identifier">size</span> = <span class="ruby-identifier">source</span>.<span class="ruby-identifier">size</span>
  <span class="ruby-identifier">m</span> = <span class="ruby-value">1</span>
  <span class="ruby-identifier">limit</span> = <span class="ruby-identifier">size</span>
  <span class="ruby-keyword">while</span> <span class="ruby-identifier">limit</span> <span class="ruby-operator">*</span> <span class="ruby-identifier">size</span> <span class="ruby-operator">&lt;=</span> <span class="ruby-value">0x100000000</span>
    <span class="ruby-identifier">limit</span> <span class="ruby-operator">*=</span> <span class="ruby-identifier">size</span>
    <span class="ruby-identifier">m</span> <span class="ruby-operator">+=</span> <span class="ruby-value">1</span>
  <span class="ruby-keyword">end</span>
  <span class="ruby-identifier">result</span> = <span class="ruby-string">&#39;&#39;</span>.<span class="ruby-identifier">dup</span>
  <span class="ruby-keyword">while</span> <span class="ruby-identifier">m</span> <span class="ruby-operator">&lt;=</span> <span class="ruby-identifier">n</span>
    <span class="ruby-identifier">rs</span> = <span class="ruby-identifier">random_number</span>(<span class="ruby-identifier">limit</span>)
    <span class="ruby-identifier">is</span> = <span class="ruby-identifier">rs</span>.<span class="ruby-identifier">digits</span>(<span class="ruby-identifier">size</span>)
    (<span class="ruby-identifier">m</span><span class="ruby-operator">-</span><span class="ruby-identifier">is</span>.<span class="ruby-identifier">length</span>).<span class="ruby-identifier">times</span> { <span class="ruby-identifier">is</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-value">0</span> }
    <span class="ruby-identifier">result</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">source</span>.<span class="ruby-identifier">values_at</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">is</span>).<span class="ruby-identifier">join</span>(<span class="ruby-string">&#39;&#39;</span>)
    <span class="ruby-identifier">n</span> <span class="ruby-operator">-=</span> <span class="ruby-identifier">m</span>
  <span class="ruby-keyword">end</span>
  <span class="ruby-keyword">if</span> <span class="ruby-value">0</span> <span class="ruby-operator">&lt;</span> <span class="ruby-identifier">n</span>
    <span class="ruby-identifier">rs</span> = <span class="ruby-identifier">random_number</span>(<span class="ruby-identifier">limit</span>)
    <span class="ruby-identifier">is</span> = <span class="ruby-identifier">rs</span>.<span class="ruby-identifier">digits</span>(<span class="ruby-identifier">size</span>)
    <span class="ruby-keyword">if</span> <span class="ruby-identifier">is</span>.<span class="ruby-identifier">length</span> <span class="ruby-operator">&lt;</span> <span class="ruby-identifier">n</span>
      (<span class="ruby-identifier">n</span><span class="ruby-operator">-</span><span class="ruby-identifier">is</span>.<span class="ruby-identifier">length</span>).<span class="ruby-identifier">times</span> { <span class="ruby-identifier">is</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-value">0</span> }
    <span class="ruby-keyword">else</span>
      <span class="ruby-identifier">is</span>.<span class="ruby-identifier">pop</span> <span class="ruby-keyword">while</span> <span class="ruby-identifier">n</span> <span class="ruby-operator">&lt;</span> <span class="ruby-identifier">is</span>.<span class="ruby-identifier">length</span>
    <span class="ruby-keyword">end</span>
    <span class="ruby-identifier">result</span>.<span class="ruby-identifier">concat</span> <span class="ruby-identifier">source</span>.<span class="ruby-identifier">values_at</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">is</span>).<span class="ruby-identifier">join</span>(<span class="ruby-string">&#39;&#39;</span>)
  <span class="ruby-keyword">end</span>
  <span class="ruby-identifier">result</span>
<span class="ruby-keyword">end</span></pre>
          </div>
          
        </div>

        

        
      </div>

    
      <div id="method-i-gen_random" class="method-detail ">
        
        <div class="method-heading">
          <span class="method-name">gen_random</span><span
            class="method-args">(n)</span>
          
          <span class="method-click-advice">click to toggle source</span>
          
        </div>
        

        <div class="method-description">
          
          
          
          

          
          <div class="method-source-code" id="gen_random-source">
            <pre><span class="ruby-comment"># File lib/securerandom.rb, line 258</span>
        <span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">gen_random</span>(<span class="ruby-identifier">n</span>)
  <span class="ruby-keyword">self</span>.<span class="ruby-identifier">bytes</span>(<span class="ruby-identifier">n</span>)
<span class="ruby-keyword">end</span></pre>
          </div>
          
        </div>

        

        
      </div>

    
    </section>
  
  </section>

</main>


<footer id="validator-badges" role="contentinfo">
  <p><a href="https://validator.w3.org/check/referer">Validate</a>
  <p>Generated by <a href="https://ruby.github.io/rdoc/">RDoc</a> 6.2.1.1.
  <p>Based on <a href="http://deveiate.org/projects/Darkfish-RDoc/">Darkfish</a> by <a href="http://deveiate.org">Michael Granger</a>.
</footer>