struct.ChaChaRng.html 31 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223
  1. <!DOCTYPE html>
  2. <html lang="en">
  3. <head>
  4. <meta charset="utf-8">
  5. <meta name="viewport" content="width=device-width, initial-scale=1.0">
  6. <meta name="generator" content="rustdoc">
  7. <meta name="description" content="API documentation for the Rust `ChaChaRng` struct in crate `rand`.">
  8. <meta name="keywords" content="rust, rustlang, rust-lang, ChaChaRng">
  9. <title>rand::ChaChaRng - Rust</title>
  10. <link rel="stylesheet" type="text/css" href="../normalize.css">
  11. <link rel="stylesheet" type="text/css" href="../rustdoc.css" id="mainThemeStyle">
  12. <link rel="stylesheet" type="text/css" href="../dark.css">
  13. <link rel="stylesheet" type="text/css" href="../main.css" id="themeStyle">
  14. <script src="../storage.js"></script>
  15. <link rel="shortcut icon" href="https://www.rust-lang.org/favicon.ico">
  16. </head>
  17. <body class="rustdoc struct">
  18. <!--[if lte IE 8]>
  19. <div class="warning">
  20. This old browser is unsupported and will most likely display funky
  21. things.
  22. </div>
  23. <![endif]-->
  24. <nav class="sidebar">
  25. <div class="sidebar-menu">&#9776;</div>
  26. <a href='../rand/index.html'><img src='https://www.rust-lang.org/logos/rust-logo-128x128-blk.png' alt='logo' width='100'></a>
  27. <p class='location'>Struct ChaChaRng</p><div class="sidebar-elems"><div class="block items"><a class="sidebar-title" href="#methods">Methods</a><div class="sidebar-links"><a href="#method.new_unseeded">new_unseeded</a><a href="#method.set_counter">set_counter</a></div><a class="sidebar-title" href="#implementations">Trait Implementations</a><div class="sidebar-links"><a href="#impl-Copy">Copy</a><a href="#impl-Clone">Clone</a><a href="#impl-Debug">Debug</a><a href="#impl-Rng">Rng</a><a href="#impl-SeedableRng%3C%26%27a%20%5Bu32%5D%3E">SeedableRng&lt;&amp;&#39;a [u32]&gt;</a><a href="#impl-Rand">Rand</a></div></div><p class='location'><a href='index.html'>rand</a></p><script>window.sidebarCurrent = {name: 'ChaChaRng', ty: 'struct', relpath: ''};</script><script defer src="sidebar-items.js"></script></div>
  28. </nav>
  29. <div class="theme-picker">
  30. <button id="theme-picker" aria-label="Pick another theme!">
  31. <img src="../brush.svg" width="18" alt="Pick another theme!">
  32. </button>
  33. <div id="theme-choices"></div>
  34. </div>
  35. <script src="../theme.js"></script>
  36. <nav class="sub">
  37. <form class="search-form js-only">
  38. <div class="search-container">
  39. <input class="search-input" name="search"
  40. autocomplete="off"
  41. placeholder="Click or press ‘S’ to search, ‘?’ for more options…"
  42. type="search">
  43. </div>
  44. </form>
  45. </nav>
  46. <section id='main' class="content">
  47. <h1 class='fqn'><span class='in-band'>Struct <a href='index.html'>rand</a>::<wbr><a class="struct" href=''>ChaChaRng</a></span><span class='out-of-band'><span id='render-detail'>
  48. <a id="toggle-all-docs" href="javascript:void(0)" title="collapse all docs">
  49. [<span class='inner'>&#x2212;</span>]
  50. </a>
  51. </span><a class='srclink' href='../src/rand/prng/chacha.rs.html#33-37' title='goto source code'>[src]</a></span></h1>
  52. <pre class='rust struct'>pub struct ChaChaRng { /* fields omitted */ }</pre><div class='docblock'><p>A random number generator that uses the ChaCha20 algorithm [1].</p>
  53. <p>The ChaCha algorithm is widely accepted as suitable for
  54. cryptographic purposes, but this implementation has not been
  55. verified as such. Prefer a generator like <code>OsRng</code> that defers to
  56. the operating system for cases that need high security.</p>
  57. <p>[1]: D. J. Bernstein, <a href="http://cr.yp.to/chacha.html"><em>ChaCha, a variant of
  58. Salsa20</em></a></p>
  59. </div>
  60. <h2 id='methods' class='small-section-header'>
  61. Methods<a href='#methods' class='anchor'></a>
  62. </h2>
  63. <h3 id='impl' class='impl'><span class='in-band'><code>impl <a class="struct" href="../rand/struct.ChaChaRng.html" title="struct rand::ChaChaRng">ChaChaRng</a></code><a href='#impl' class='anchor'></a></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/rand/prng/chacha.rs.html#83-186' title='goto source code'>[src]</a></span></h3>
  64. <div class='impl-items'><h4 id='method.new_unseeded' class="method"><span id='new_unseeded.v' class='invisible'><code>pub fn <a href='#method.new_unseeded' class='fnname'>new_unseeded</a>() -&gt; <a class="struct" href="../rand/struct.ChaChaRng.html" title="struct rand::ChaChaRng">ChaChaRng</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/rand/prng/chacha.rs.html#104-108' title='goto source code'>[src]</a></span></h4>
  65. <div class='docblock'><p>Create an ChaCha random number generator using the default
  66. fixed key of 8 zero words.</p>
  67. <h1 id="examples" class="section-header"><a href="#examples">Examples</a></h1>
  68. <pre class="rust rust-example-rendered">
  69. <span class="kw">use</span> <span class="ident">rand</span>::{<span class="ident">Rng</span>, <span class="ident">ChaChaRng</span>};
  70. <span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">ra</span> <span class="op">=</span> <span class="ident">ChaChaRng</span>::<span class="ident">new_unseeded</span>();
  71. <span class="macro">println</span><span class="macro">!</span>(<span class="string">&quot;{:?}&quot;</span>, <span class="ident">ra</span>.<span class="ident">next_u32</span>());
  72. <span class="macro">println</span><span class="macro">!</span>(<span class="string">&quot;{:?}&quot;</span>, <span class="ident">ra</span>.<span class="ident">next_u32</span>());</pre>
  73. <p>Since this equivalent to a RNG with a fixed seed, repeated executions
  74. of an unseeded RNG will produce the same result. This code sample will
  75. consistently produce:</p>
  76. <ul>
  77. <li>2917185654</li>
  78. <li>2419978656</li>
  79. </ul>
  80. </div><h4 id='method.set_counter' class="method"><span id='set_counter.v' class='invisible'><code>pub fn <a href='#method.set_counter' class='fnname'>set_counter</a>(&amp;mut self, counter_low: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u64.html">u64</a>, counter_high: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u64.html">u64</a>)</code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/rand/prng/chacha.rs.html#129-135' title='goto source code'>[src]</a></span></h4>
  81. <div class='docblock'><p>Sets the internal 128-bit ChaCha counter to
  82. a user-provided value. This permits jumping
  83. arbitrarily ahead (or backwards) in the pseudorandom stream.</p>
  84. <p>Since the nonce words are used to extend the counter to 128 bits,
  85. users wishing to obtain the conventional ChaCha pseudorandom stream
  86. associated with a particular nonce can call this function with
  87. arguments <code>0, desired_nonce</code>.</p>
  88. <h1 id="examples-1" class="section-header"><a href="#examples-1">Examples</a></h1>
  89. <pre class="rust rust-example-rendered">
  90. <span class="kw">use</span> <span class="ident">rand</span>::{<span class="ident">Rng</span>, <span class="ident">ChaChaRng</span>};
  91. <span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">ra</span> <span class="op">=</span> <span class="ident">ChaChaRng</span>::<span class="ident">new_unseeded</span>();
  92. <span class="ident">ra</span>.<span class="ident">set_counter</span>(<span class="number">0u64</span>, <span class="number">1234567890u64</span>);
  93. <span class="macro">println</span><span class="macro">!</span>(<span class="string">&quot;{:?}&quot;</span>, <span class="ident">ra</span>.<span class="ident">next_u32</span>());
  94. <span class="macro">println</span><span class="macro">!</span>(<span class="string">&quot;{:?}&quot;</span>, <span class="ident">ra</span>.<span class="ident">next_u32</span>());</pre>
  95. </div></div>
  96. <h2 id='implementations' class='small-section-header'>
  97. Trait Implementations<a href='#implementations' class='anchor'></a>
  98. </h2>
  99. <h3 id='impl-Copy' class='impl'><span class='in-band'><code>impl <a class="trait" href="https://doc.rust-lang.org/nightly/core/marker/trait.Copy.html" title="trait core::marker::Copy">Copy</a> for <a class="struct" href="../rand/struct.ChaChaRng.html" title="struct rand::ChaChaRng">ChaChaRng</a></code><a href='#impl-Copy' class='anchor'></a></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/rand/prng/chacha.rs.html#32' title='goto source code'>[src]</a></span></h3>
  100. <div class='impl-items'></div><h3 id='impl-Clone' class='impl'><span class='in-band'><code>impl <a class="trait" href="https://doc.rust-lang.org/nightly/core/clone/trait.Clone.html" title="trait core::clone::Clone">Clone</a> for <a class="struct" href="../rand/struct.ChaChaRng.html" title="struct rand::ChaChaRng">ChaChaRng</a></code><a href='#impl-Clone' class='anchor'></a></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/rand/prng/chacha.rs.html#32' title='goto source code'>[src]</a></span></h3>
  101. <div class='impl-items'><h4 id='method.clone' class="method"><span id='clone.v' class='invisible'><code>fn <a href='https://doc.rust-lang.org/nightly/core/clone/trait.Clone.html#tymethod.clone' class='fnname'>clone</a>(&amp;self) -&gt; <a class="struct" href="../rand/struct.ChaChaRng.html" title="struct rand::ChaChaRng">ChaChaRng</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/rand/prng/chacha.rs.html#32' title='goto source code'>[src]</a></span></h4>
  102. <div class='docblock'><p>Returns a copy of the value. <a href="https://doc.rust-lang.org/nightly/core/clone/trait.Clone.html#tymethod.clone">Read more</a></p>
  103. </div><h4 id='method.clone_from' class="method"><span id='clone_from.v' class='invisible'><code>fn <a href='https://doc.rust-lang.org/nightly/core/clone/trait.Clone.html#method.clone_from' class='fnname'>clone_from</a>(&amp;mut self, source: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.reference.html">&amp;</a>Self)</code></span><span class='out-of-band'><div class='ghost'></div><div class='since' title='Stable since Rust version 1.0.0'>1.0.0</div><a class='srclink' href='https://doc.rust-lang.org/nightly/src/core/clone.rs.html#112-114' title='goto source code'>[src]</a></span></h4>
  104. <div class='docblock'><p>Performs copy-assignment from <code>source</code>. <a href="https://doc.rust-lang.org/nightly/core/clone/trait.Clone.html#method.clone_from">Read more</a></p>
  105. </div></div><h3 id='impl-Debug' class='impl'><span class='in-band'><code>impl <a class="trait" href="https://doc.rust-lang.org/nightly/core/fmt/trait.Debug.html" title="trait core::fmt::Debug">Debug</a> for <a class="struct" href="../rand/struct.ChaChaRng.html" title="struct rand::ChaChaRng">ChaChaRng</a></code><a href='#impl-Debug' class='anchor'></a></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/rand/prng/chacha.rs.html#32' title='goto source code'>[src]</a></span></h3>
  106. <div class='impl-items'><h4 id='method.fmt' class="method"><span id='fmt.v' class='invisible'><code>fn <a href='https://doc.rust-lang.org/nightly/core/fmt/trait.Debug.html#tymethod.fmt' class='fnname'>fmt</a>(&amp;self, __arg_0: &amp;mut <a class="struct" href="https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html" title="struct core::fmt::Formatter">Formatter</a>) -&gt; <a class="type" href="https://doc.rust-lang.org/nightly/core/fmt/type.Result.html" title="type core::fmt::Result">Result</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/rand/prng/chacha.rs.html#32' title='goto source code'>[src]</a></span></h4>
  107. <div class='docblock'><p>Formats the value using the given formatter. <a href="https://doc.rust-lang.org/nightly/core/fmt/trait.Debug.html#tymethod.fmt">Read more</a></p>
  108. </div></div><h3 id='impl-Rng' class='impl'><span class='in-band'><code>impl <a class="trait" href="../rand/trait.Rng.html" title="trait rand::Rng">Rng</a> for <a class="struct" href="../rand/struct.ChaChaRng.html" title="struct rand::ChaChaRng">ChaChaRng</a></code><a href='#impl-Rng' class='anchor'></a></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/rand/prng/chacha.rs.html#188-199' title='goto source code'>[src]</a></span></h3>
  109. <div class='impl-items'><h4 id='method.next_u32' class="method"><span id='next_u32.v' class='invisible'><code>fn <a href='../rand/trait.Rng.html#tymethod.next_u32' class='fnname'>next_u32</a>(&amp;mut self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/rand/prng/chacha.rs.html#190-198' title='goto source code'>[src]</a></span></h4>
  110. <div class='docblock'><p>Return the next random u32. <a href="../rand/trait.Rng.html#tymethod.next_u32">Read more</a></p>
  111. </div><h4 id='method.next_u64' class="method"><span id='next_u64.v' class='invisible'><code>fn <a href='../rand/trait.Rng.html#method.next_u64' class='fnname'>next_u64</a>(&amp;mut self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u64.html">u64</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/rand/lib.rs.html#353-355' title='goto source code'>[src]</a></span></h4>
  112. <div class='docblock'><p>Return the next random u64. <a href="../rand/trait.Rng.html#method.next_u64">Read more</a></p>
  113. </div><h4 id='method.next_f32' class="method"><span id='next_f32.v' class='invisible'><code>fn <a href='../rand/trait.Rng.html#method.next_f32' class='fnname'>next_f32</a>(&amp;mut self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f32.html">f32</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/rand/lib.rs.html#383-389' title='goto source code'>[src]</a></span></h4>
  114. <div class='docblock'><p>Return the next random f32 selected from the half-open interval <code>[0, 1)</code>. <a href="../rand/trait.Rng.html#method.next_f32">Read more</a></p>
  115. </div><h4 id='method.next_f64' class="method"><span id='next_f64.v' class='invisible'><code>fn <a href='../rand/trait.Rng.html#method.next_f64' class='fnname'>next_f64</a>(&amp;mut self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f64.html">f64</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/rand/lib.rs.html#401-407' title='goto source code'>[src]</a></span></h4>
  116. <div class='docblock'><p>Return the next random f64 selected from the half-open interval <code>[0, 1)</code>. <a href="../rand/trait.Rng.html#method.next_f64">Read more</a></p>
  117. </div><h4 id='method.fill_bytes' class="method"><span id='fill_bytes.v' class='invisible'><code>fn <a href='../rand/trait.Rng.html#method.fill_bytes' class='fnname'>fill_bytes</a>(&amp;mut self, dest: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.slice.html">&amp;mut [</a><a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u8.html">u8</a><a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.slice.html">]</a>)</code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/rand/lib.rs.html#436-458' title='goto source code'>[src]</a></span></h4>
  118. <div class='docblock'><p>Fill <code>dest</code> with random data. <a href="../rand/trait.Rng.html#method.fill_bytes">Read more</a></p>
  119. </div><h4 id='method.gen' class="method"><span id='gen.v' class='invisible'><code>fn <a href='../rand/trait.Rng.html#method.gen' class='fnname'>gen</a>&lt;T:&nbsp;<a class="trait" href="../rand/trait.Rand.html" title="trait rand::Rand">Rand</a>&gt;(&amp;mut self) -&gt; T <span class="where fmt-newline">where<br>&nbsp;&nbsp;&nbsp;&nbsp;Self: <a class="trait" href="https://doc.rust-lang.org/nightly/core/marker/trait.Sized.html" title="trait core::marker::Sized">Sized</a>,&nbsp;</span></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/rand/lib.rs.html#473-475' title='goto source code'>[src]</a></span></h4>
  120. <div class='docblock'><p>Return a random value of a <code>Rand</code> type. <a href="../rand/trait.Rng.html#method.gen">Read more</a></p>
  121. </div><h4 id='method.gen_iter' class="method"><div class="important-traits"><div class='tooltip'>ⓘ<span class='tooltiptext'>Important traits for <a class="struct" href="../rand/struct.Generator.html" title="struct rand::Generator">Generator</a>&lt;'a, T, R&gt;</span></div><div class="content hidden"><h3 class="important">Important traits for <a class="struct" href="../rand/struct.Generator.html" title="struct rand::Generator">Generator</a>&lt;'a, T, R&gt;</h3><code class="content"><span class="where fmt-newline">impl&lt;'a, T:&nbsp;<a class="trait" href="../rand/trait.Rand.html" title="trait rand::Rand">Rand</a>, R:&nbsp;<a class="trait" href="../rand/trait.Rng.html" title="trait rand::Rng">Rng</a>&gt; <a class="trait" href="https://doc.rust-lang.org/nightly/core/iter/iterator/trait.Iterator.html" title="trait core::iter::iterator::Iterator">Iterator</a> for <a class="struct" href="../rand/struct.Generator.html" title="struct rand::Generator">Generator</a>&lt;'a, T, R&gt;</span><span class="where fmt-newline"> type <a href='https://doc.rust-lang.org/nightly/core/iter/iterator/trait.Iterator.html#associatedtype.Item' class="type">Item</a> = T;</span></code></div></div><span id='gen_iter.v' class='invisible'><code>fn <a href='../rand/trait.Rng.html#method.gen_iter' class='fnname'>gen_iter</a>&lt;'a, T:&nbsp;<a class="trait" href="../rand/trait.Rand.html" title="trait rand::Rand">Rand</a>&gt;(&amp;'a mut self) -&gt; <a class="struct" href="../rand/struct.Generator.html" title="struct rand::Generator">Generator</a>&lt;'a, T, Self&gt; <span class="where fmt-newline">where<br>&nbsp;&nbsp;&nbsp;&nbsp;Self: <a class="trait" href="https://doc.rust-lang.org/nightly/core/marker/trait.Sized.html" title="trait core::marker::Sized">Sized</a>,&nbsp;</span></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/rand/lib.rs.html#491-493' title='goto source code'>[src]</a></span></h4>
  122. <div class='docblock'><p>Return an iterator that will yield an infinite number of randomly generated items. <a href="../rand/trait.Rng.html#method.gen_iter">Read more</a></p>
  123. </div><h4 id='method.gen_range' class="method"><span id='gen_range.v' class='invisible'><code>fn <a href='../rand/trait.Rng.html#method.gen_range' class='fnname'>gen_range</a>&lt;T:&nbsp;<a class="trait" href="https://doc.rust-lang.org/nightly/core/cmp/trait.PartialOrd.html" title="trait core::cmp::PartialOrd">PartialOrd</a> + <a class="trait" href="../rand/distributions/range/trait.SampleRange.html" title="trait rand::distributions::range::SampleRange">SampleRange</a>&gt;(&amp;mut self, low: T, high: T) -&gt; T <span class="where fmt-newline">where<br>&nbsp;&nbsp;&nbsp;&nbsp;Self: <a class="trait" href="https://doc.rust-lang.org/nightly/core/marker/trait.Sized.html" title="trait core::marker::Sized">Sized</a>,&nbsp;</span></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/rand/lib.rs.html#518-521' title='goto source code'>[src]</a></span></h4>
  124. <div class='docblock'><p>Generate a random value in the range [<code>low</code>, <code>high</code>). <a href="../rand/trait.Rng.html#method.gen_range">Read more</a></p>
  125. </div><h4 id='method.gen_weighted_bool' class="method"><span id='gen_weighted_bool.v' class='invisible'><code>fn <a href='../rand/trait.Rng.html#method.gen_weighted_bool' class='fnname'>gen_weighted_bool</a>(&amp;mut self, n: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a>) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.bool.html">bool</a> <span class="where fmt-newline">where<br>&nbsp;&nbsp;&nbsp;&nbsp;Self: <a class="trait" href="https://doc.rust-lang.org/nightly/core/marker/trait.Sized.html" title="trait core::marker::Sized">Sized</a>,&nbsp;</span></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/rand/lib.rs.html#533-535' title='goto source code'>[src]</a></span></h4>
  126. <div class='docblock'><p>Return a bool with a 1 in n chance of true <a href="../rand/trait.Rng.html#method.gen_weighted_bool">Read more</a></p>
  127. </div><h4 id='method.gen_ascii_chars' class="method"><div class="important-traits"><div class='tooltip'>ⓘ<span class='tooltiptext'>Important traits for <a class="struct" href="../rand/struct.AsciiGenerator.html" title="struct rand::AsciiGenerator">AsciiGenerator</a>&lt;'a, R&gt;</span></div><div class="content hidden"><h3 class="important">Important traits for <a class="struct" href="../rand/struct.AsciiGenerator.html" title="struct rand::AsciiGenerator">AsciiGenerator</a>&lt;'a, R&gt;</h3><code class="content"><span class="where fmt-newline">impl&lt;'a, R:&nbsp;<a class="trait" href="../rand/trait.Rng.html" title="trait rand::Rng">Rng</a>&gt; <a class="trait" href="https://doc.rust-lang.org/nightly/core/iter/iterator/trait.Iterator.html" title="trait core::iter::iterator::Iterator">Iterator</a> for <a class="struct" href="../rand/struct.AsciiGenerator.html" title="struct rand::AsciiGenerator">AsciiGenerator</a>&lt;'a, R&gt;</span><span class="where fmt-newline"> type <a href='https://doc.rust-lang.org/nightly/core/iter/iterator/trait.Iterator.html#associatedtype.Item' class="type">Item</a> = <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.char.html">char</a>;</span></code></div></div><span id='gen_ascii_chars.v' class='invisible'><code>fn <a href='../rand/trait.Rng.html#method.gen_ascii_chars' class='fnname'>gen_ascii_chars</a>&lt;'a&gt;(&amp;'a mut self) -&gt; <a class="struct" href="../rand/struct.AsciiGenerator.html" title="struct rand::AsciiGenerator">AsciiGenerator</a>&lt;'a, Self&gt; <span class="where fmt-newline">where<br>&nbsp;&nbsp;&nbsp;&nbsp;Self: <a class="trait" href="https://doc.rust-lang.org/nightly/core/marker/trait.Sized.html" title="trait core::marker::Sized">Sized</a>,&nbsp;</span></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/rand/lib.rs.html#547-549' title='goto source code'>[src]</a></span></h4>
  128. <div class='docblock'><p>Return an iterator of random characters from the set A-Z,a-z,0-9. <a href="../rand/trait.Rng.html#method.gen_ascii_chars">Read more</a></p>
  129. </div><h4 id='method.choose' class="method"><span id='choose.v' class='invisible'><code>fn <a href='../rand/trait.Rng.html#method.choose' class='fnname'>choose</a>&lt;'a, T&gt;(&amp;mut self, values: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.slice.html">&amp;'a [T]</a>) -&gt; <a class="enum" href="https://doc.rust-lang.org/nightly/core/option/enum.Option.html" title="enum core::option::Option">Option</a>&lt;<a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.reference.html">&amp;'a </a>T&gt; <span class="where fmt-newline">where<br>&nbsp;&nbsp;&nbsp;&nbsp;Self: <a class="trait" href="https://doc.rust-lang.org/nightly/core/marker/trait.Sized.html" title="trait core::marker::Sized">Sized</a>,&nbsp;</span></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/rand/lib.rs.html#565-571' title='goto source code'>[src]</a></span></h4>
  130. <div class='docblock'><p>Return a random element from <code>values</code>. <a href="../rand/trait.Rng.html#method.choose">Read more</a></p>
  131. </div><h4 id='method.choose_mut' class="method"><span id='choose_mut.v' class='invisible'><code>fn <a href='../rand/trait.Rng.html#method.choose_mut' class='fnname'>choose_mut</a>&lt;'a, T&gt;(&amp;mut self, values: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.slice.html">&amp;'a mut [T]</a>) -&gt; <a class="enum" href="https://doc.rust-lang.org/nightly/core/option/enum.Option.html" title="enum core::option::Option">Option</a>&lt;<a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.reference.html">&amp;'a mut </a>T&gt; <span class="where fmt-newline">where<br>&nbsp;&nbsp;&nbsp;&nbsp;Self: <a class="trait" href="https://doc.rust-lang.org/nightly/core/marker/trait.Sized.html" title="trait core::marker::Sized">Sized</a>,&nbsp;</span></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/rand/lib.rs.html#576-583' title='goto source code'>[src]</a></span></h4>
  132. <div class='docblock'><p>Return a mutable pointer to a random element from <code>values</code>. <a href="../rand/trait.Rng.html#method.choose_mut">Read more</a></p>
  133. </div><h4 id='method.shuffle' class="method"><span id='shuffle.v' class='invisible'><code>fn <a href='../rand/trait.Rng.html#method.shuffle' class='fnname'>shuffle</a>&lt;T&gt;(&amp;mut self, values: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.slice.html">&amp;mut [T]</a>) <span class="where fmt-newline">where<br>&nbsp;&nbsp;&nbsp;&nbsp;Self: <a class="trait" href="https://doc.rust-lang.org/nightly/core/marker/trait.Sized.html" title="trait core::marker::Sized">Sized</a>,&nbsp;</span></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/rand/lib.rs.html#602-610' title='goto source code'>[src]</a></span></h4>
  134. <div class='docblock'><p>Shuffle a mutable slice in place. <a href="../rand/trait.Rng.html#method.shuffle">Read more</a></p>
  135. </div></div><h3 id='impl-SeedableRng%3C%26%27a%20%5Bu32%5D%3E' class='impl'><span class='in-band'><code>impl&lt;'a&gt; <a class="trait" href="../rand/trait.SeedableRng.html" title="trait rand::SeedableRng">SeedableRng</a>&lt;<a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.slice.html">&amp;'a [</a><a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a><a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.slice.html">]</a>&gt; for <a class="struct" href="../rand/struct.ChaChaRng.html" title="struct rand::ChaChaRng">ChaChaRng</a></code><a href='#impl-SeedableRng%3C%26%27a%20%5Bu32%5D%3E' class='anchor'></a></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/rand/prng/chacha.rs.html#201-222' title='goto source code'>[src]</a></span></h3>
  136. <div class='impl-items'><h4 id='method.reseed' class="method"><span id='reseed.v' class='invisible'><code>fn <a href='../rand/trait.SeedableRng.html#tymethod.reseed' class='fnname'>reseed</a>(&amp;mut self, seed: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.slice.html">&amp;'a [</a><a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a><a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.slice.html">]</a>)</code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/rand/prng/chacha.rs.html#203-211' title='goto source code'>[src]</a></span></h4>
  137. <div class='docblock'><p>Reseed an RNG with the given seed. <a href="../rand/trait.SeedableRng.html#tymethod.reseed">Read more</a></p>
  138. </div><h4 id='method.from_seed' class="method"><span id='from_seed.v' class='invisible'><code>fn <a href='../rand/trait.SeedableRng.html#tymethod.from_seed' class='fnname'>from_seed</a>(seed: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.slice.html">&amp;'a [</a><a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a><a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.slice.html">]</a>) -&gt; <a class="struct" href="../rand/struct.ChaChaRng.html" title="struct rand::ChaChaRng">ChaChaRng</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/rand/prng/chacha.rs.html#217-221' title='goto source code'>[src]</a></span></h4>
  139. <div class='docblock'><p>Create a ChaCha generator from a seed,
  140. obtained from a variable-length u32 array.
  141. Only up to 8 words are used; if less than 8
  142. words are used, the remaining are set to zero.</p>
  143. </div></div><h3 id='impl-Rand' class='impl'><span class='in-band'><code>impl <a class="trait" href="../rand/trait.Rand.html" title="trait rand::Rand">Rand</a> for <a class="struct" href="../rand/struct.ChaChaRng.html" title="struct rand::ChaChaRng">ChaChaRng</a></code><a href='#impl-Rand' class='anchor'></a></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/rand/prng/chacha.rs.html#224-232' title='goto source code'>[src]</a></span></h3>
  144. <div class='impl-items'><h4 id='method.rand' class="method"><span id='rand.v' class='invisible'><code>fn <a href='../rand/trait.Rand.html#tymethod.rand' class='fnname'>rand</a>&lt;R:&nbsp;<a class="trait" href="../rand/trait.Rng.html" title="trait rand::Rng">Rng</a>&gt;(other: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.reference.html">&amp;mut </a>R) -&gt; <a class="struct" href="../rand/struct.ChaChaRng.html" title="struct rand::ChaChaRng">ChaChaRng</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/rand/prng/chacha.rs.html#225-231' title='goto source code'>[src]</a></span></h4>
  145. <div class='docblock'><p>Generates a random instance of this type using the specified source of randomness. <a href="../rand/trait.Rand.html#tymethod.rand">Read more</a></p>
  146. </div></div></section>
  147. <section id='search' class="content hidden"></section>
  148. <section class="footer"></section>
  149. <aside id="help" class="hidden">
  150. <div>
  151. <h1 class="hidden">Help</h1>
  152. <div class="shortcuts">
  153. <h2>Keyboard Shortcuts</h2>
  154. <dl>
  155. <dt><kbd>?</kbd></dt>
  156. <dd>Show this help dialog</dd>
  157. <dt><kbd>S</kbd></dt>
  158. <dd>Focus the search field</dd>
  159. <dt><kbd>↑</kbd></dt>
  160. <dd>Move up in search results</dd>
  161. <dt><kbd>↓</kbd></dt>
  162. <dd>Move down in search results</dd>
  163. <dt><kbd>↹</kbd></dt>
  164. <dd>Switch tab</dd>
  165. <dt><kbd>&#9166;</kbd></dt>
  166. <dd>Go to active search result</dd>
  167. <dt><kbd>+</kbd></dt>
  168. <dd>Expand all sections</dd>
  169. <dt><kbd>-</kbd></dt>
  170. <dd>Collapse all sections</dd>
  171. </dl>
  172. </div>
  173. <div class="infos">
  174. <h2>Search Tricks</h2>
  175. <p>
  176. Prefix searches with a type followed by a colon (e.g.
  177. <code>fn:</code>) to restrict the search to a given type.
  178. </p>
  179. <p>
  180. Accepted types are: <code>fn</code>, <code>mod</code>,
  181. <code>struct</code>, <code>enum</code>,
  182. <code>trait</code>, <code>type</code>, <code>macro</code>,
  183. and <code>const</code>.
  184. </p>
  185. <p>
  186. Search functions by type signature (e.g.
  187. <code>vec -> usize</code> or <code>* -> vec</code>)
  188. </p>
  189. </div>
  190. </div>
  191. </aside>
  192. <script>
  193. window.rootPath = "../";
  194. window.currentCrate = "rand";
  195. </script>
  196. <script src="../main.js"></script>
  197. <script defer src="../search-index.js"></script>
  198. </body>
  199. </html>