deploy: 94c065e

Author: AndyGauge

algorithms/randomness.html

@@ -162,38 +162,35 @@ <h1 class="menu-title">Rust Cookbook</h1>
                         <h1 id="generate-random-values"><a class="header" href="#generate-random-values">Generate Random Values</a></h1>
 <h2 id="generate-random-numbers"><a class="header" href="#generate-random-numbers">Generate random numbers</a></h2>
 <p><a href="https://docs.rs/rand/"><img src="https://badge-cache.kominick.com/crates/v/rand.svg?label=rand" alt="rand-badge" /></a> <a href="https://crates.io/categories/science"><img src="https://badge-cache.kominick.com/badge/science--x.svg?style=social" alt="cat-science-badge" /></a></p>
-<p>Generates random numbers with help of random-number
-generator <a href="https://docs.rs/rand/0.9/rand/trait.Rng.html"><code>rand::Rng</code></a> obtained via <a href="https://docs.rs/rand/0.9/rand/trait.Rng.html"><code>rand::rng</code></a>. Each thread has an
-initialized generator. Integers are uniformly distributed over the range of the
-type, and floating point numbers are uniformly distributed from 0 up to but not
+<p>Generates random numbers with help of random-number generator <a href="https://docs.rs/rand/latest/rand/trait.Rng.html"><code>rand::Rng</code></a> obtained via
+<a href="https://docs.rs/rand/latest/rand/fn.rng.html"><code>rand::rng()</code></a>. Each thread has an initialized generator. Integers are uniformly distributed over the
+range of the type, and floating point numbers are uniformly distributed from 0 up to but not
 including 1.</p>
 <pre><pre class="playground"><code class="language-rust edition2018">use rand::Rng;
 
 fn main() {
-    let mut rng = rand::thread_rng();
-    let random_number: u32 = rng.gen();
-    println!("Random number: {}", random_number);
+    let mut rng = rand::rng();
+    let random_number: u32 = rng.random();
+    println!("Random number: {random_number}");
 }</code></pre></pre>
 <h2 id="generate-random-numbers-within-a-range"><a class="header" href="#generate-random-numbers-within-a-range">Generate random numbers within a range</a></h2>
 <p><a href="https://docs.rs/rand/"><img src="https://badge-cache.kominick.com/crates/v/rand.svg?label=rand" alt="rand-badge" /></a> <a href="https://crates.io/categories/science"><img src="https://badge-cache.kominick.com/badge/science--x.svg?style=social" alt="cat-science-badge" /></a></p>
-<p>Generates a random value within half-open <code>[0, 10)</code> range (not including <code>10</code>) with [<code>Rng::gen_range</code>].</p>
+<p>Generates a random value within half-open <code>[0, 10)</code> range (not including <code>10</code>) with <a href="https://docs.rs/rand/latest/rand/trait.Rng.html#method.random_range"><code>Rng::random_range</code></a>.</p>
 <pre><pre class="playground"><code class="language-rust edition2018">use rand::Rng;
 
 fn main() {
     let mut rng = rand::rng();
-    println!("Integer: {}", rng.gen_range(0..10));
-    println!("Float: {}", rng.gen_range(0.0..10.0));
+    println!("Integer: {}", rng.random_range(0..10));
+    println!("Float: {}", rng.random_range(0.0..10.0));
 }</code></pre></pre>
-<p>[<code>Uniform</code>] can obtain values with <a href="https://en.wikipedia.org/wiki/Uniform_distribution_(continuous)">uniform distribution</a>.
-This has the same effect, but may be faster when repeatedly generating numbers
-in the same range.</p>
-<pre><pre class="playground"><code class="language-rust edition2018">use rand::Rng;
-use rand_distr::{Distribution, Uniform};
+<p><a href="https://docs.rs/rand_distr/latest/rand_distr/struct.Uniform.html"><code>Uniform</code></a> can obtain values with <a href="https://en.wikipedia.org/wiki/Uniform_distribution_(continuous)">uniform distribution</a>. This has the same effect, but may be
+faster when repeatedly generating numbers in the same range.</p>
+<pre><pre class="playground"><code class="language-rust edition2018">use rand_distr::{Distribution, Uniform};
 
 fn main() {
     let mut rng = rand::rng();
-    let die = Uniform::new_inclusive(1, 6)
-        .expect("Failed to create uniform distribution: invalid range");
+    let die =
+        Uniform::new_inclusive(1, 6).expect("Failed to create uniform distribution: invalid range");
 
     loop {
         let throw = die.sample(&amp;mut rng);
@@ -205,23 +202,18 @@ <h2 id="generate-random-numbers-within-a-range"><a class="header" href="#generat
 }</code></pre></pre>
 <h2 id="generate-random-numbers-with-given-distribution"><a class="header" href="#generate-random-numbers-with-given-distribution">Generate random numbers with given distribution</a></h2>
 <p><a href="https://docs.rs/rand_distr/"><img src="https://badge-cache.kominick.com/crates/v/rand_distr.svg?label=rand_distr" alt="rand_distr-badge" /></a> <a href="https://crates.io/categories/science"><img src="https://badge-cache.kominick.com/badge/science--x.svg?style=social" alt="cat-science-badge" /></a></p>
-<p>By default, random numbers in the <code>rand</code> crate have
-<a href="https://en.wikipedia.org/wiki/Uniform_distribution_(continuous)">uniform distribution</a>. The <a href="https://docs.rs/rand_distr/*/rand_distr/index.html"><code>rand_distr</code></a> crate provides
-other kinds of distributions. To use them, you instantiate
-a distribution, then sample from that distribution using
-<a href="https://docs.rs/rand/0.9/rand/distr/trait.Distribution.html#tymethod.sample"><code>Distribution::sample</code></a> with help of a random-number
-generator <a href="https://docs.rs/rand/0.9/rand/trait.Rng.html"><code>rand::Rng</code></a>.</p>
-<p>The <a href="https://docs.rs/rand_distr/*/rand_distr/index.html">distributions available are documented here</a>.
-An example using the <a href="https://docs.rs/rand_distr/*/rand_distr/struct.Normal.html"><code>Normal</code></a> distribution is shown below.</p>
-<pre><pre class="playground"><code class="language-rust edition2018">use rand::Rng;
-use rand_distr::{Distribution, LogNormal, Normal};
+<p>By default, random numbers in the <code>rand</code> crate have <a href="https://en.wikipedia.org/wiki/Uniform_distribution_(continuous)">uniform distribution</a>. The <a href="https://docs.rs/rand_distr/*/rand_distr/index.html"><code>rand_distr</code></a> crate
+provides other kinds of distributions. To use them, you instantiate a distribution, then sample from
+that distribution using <a href="https://docs.rs/rand/0.9/rand/distr/trait.Distribution.html#tymethod.sample"><code>Distribution::sample</code></a> with help of a random-number generator
+<a href="https://docs.rs/rand/latest/rand/trait.Rng.html"><code>rand::Rng</code></a>.</p>
+<p>The <a href="https://docs.rs/rand_distr/*/rand_distr/index.html">distributions available are documented here</a>. An example using the
+<a href="https://docs.rs/rand_distr/*/rand_distr/struct.Normal.html"><code>Normal</code></a> distribution is shown below.</p>
+<pre><pre class="playground"><code class="language-rust edition2018">use rand_distr::{Distribution, LogNormal, Normal};
 
 fn main() {
     let mut rng = rand::rng();
-    let normal = Normal::new(2.0, 3.0)
-        .expect("Failed to create normal distribution");
-    let log_normal = LogNormal::new(1.0, 0.5)
-        .expect("Failed to create log-normal distribution");
+    let normal = Normal::new(2.0, 3.0).expect("Failed to create normal distribution");
+    let log_normal = LogNormal::new(1.0, 0.5).expect("Failed to create log-normal distribution");
 
     let v = normal.sample(&amp;mut rng);
     println!("{} is from a N(2, 9) distribution", v);
@@ -230,9 +222,10 @@ <h2 id="generate-random-numbers-with-given-distribution"><a class="header" href=
 }</code></pre></pre>
 <h2 id="generate-random-values-of-a-custom-type"><a class="header" href="#generate-random-values-of-a-custom-type">Generate random values of a custom type</a></h2>
 <p><a href="https://docs.rs/rand/"><img src="https://badge-cache.kominick.com/crates/v/rand.svg?label=rand" alt="rand-badge" /></a> <a href="https://crates.io/categories/science"><img src="https://badge-cache.kominick.com/badge/science--x.svg?style=social" alt="cat-science-badge" /></a></p>
-<p>Randomly generates a tuple <code>(i32, bool, f64)</code> and variable of user defined type <code>Point</code>.
-Implements the [<code>Distribution</code>] trait on type Point for [<code>Standard</code>] in order to allow random generation.</p>
-<pre><pre class="playground"><code class="language-rust edition2018">use rand::Rng;
+<p>Randomly generates a tuple <code>(i32, bool, f64)</code> and variable of user defined type <code>Point</code>. Implements
+the <a href="https://docs.rs/rand/latest/rand/distr/trait.Distribution.html"><code>Distribution</code></a> trait on type Point for <a href="https://docs.rs/rand/latest/rand/distr/struct.Standard.html"><code>Standard</code></a> in order to allow random generation.</p>
+<pre><pre class="playground"><code class="language-rust edition2018">#![allow(dead_code)]
+use rand::Rng;
 
 #[derive(Debug)]
 struct Point {
@@ -258,29 +251,25 @@ <h2 id="generate-random-values-of-a-custom-type"><a class="header" href="#genera
 }</code></pre></pre>
 <h2 id="create-random-passwords-from-a-set-of-alphanumeric-characters"><a class="header" href="#create-random-passwords-from-a-set-of-alphanumeric-characters">Create random passwords from a set of alphanumeric characters</a></h2>
 <p><a href="https://docs.rs/rand/"><img src="https://badge-cache.kominick.com/crates/v/rand.svg?label=rand" alt="rand-badge" /></a> <a href="https://crates.io/categories/os"><img src="https://badge-cache.kominick.com/badge/OS--x.svg?style=social" alt="cat-os-badge" /></a></p>
-<p>Randomly generates a string of given length ASCII characters in the range <code>A-Z, a-z, 0-9</code>, with <a href="https://docs.rs/rand/0.9/rand/distr/struct.Alphanumeric.html"><code>Alphanumeric</code></a> sample.</p>
+<p>Randomly generates a string of given length ASCII characters in the range <code>A-Z, a-z, 0-9</code>, with
+<a href="https://docs.rs/rand/0.9/rand/distr/struct.Alphanumeric.html"><code>Alphanumeric</code></a> sample.</p>
 <pre><pre class="playground"><code class="language-rust edition2018">use rand::Rng;
+use rand_distr::Alphanumeric;
 
 fn main() {
-    const CHARSET: &amp;[u8] = b"ABCDEFGHIJKLMNOPQRSTUVWXYZ\
-                            abcdefghijklmnopqrstuvwxyz\
-                            0123456789";
     const PASSWORD_LEN: usize = 30;
     let mut rng = rand::rng();
 
     let password: String = (0..PASSWORD_LEN)
-        .map(|_| {
-            let idx = rng.random_range(0..CHARSET.len());
-            CHARSET[idx] as char
-        })
+        .map(|_| rng.sample(Alphanumeric) as char)
         .collect();
 
-    println!("{}", password);
+    println!("{password}");
 }</code></pre></pre>
 <h2 id="create-random-passwords-from-a-set-of-user-defined-characters"><a class="header" href="#create-random-passwords-from-a-set-of-user-defined-characters">Create random passwords from a set of user-defined characters</a></h2>
 <p><a href="https://docs.rs/rand/"><img src="https://badge-cache.kominick.com/crates/v/rand.svg?label=rand" alt="rand-badge" /></a> <a href="https://crates.io/categories/os"><img src="https://badge-cache.kominick.com/badge/OS--x.svg?style=social" alt="cat-os-badge" /></a></p>
-<p>Randomly generates a string of given length ASCII characters with custom
-user-defined bytestring, with <a href="https://docs.rs/rand/0.9/rand/trait.Rng.html#method.gen_range"><code>gen_range</code></a>.</p>
+<p>Randomly generates a string of given length ASCII characters with custom user-defined bytestring,
+with <a href="https://docs.rs/rand/latest/rand/trait.Rng.html#method.random_range"><code>random_range</code></a>.</p>
 <pre><pre class="playground"><code class="language-rust edition2018">use rand::Rng;
 
 const CHARSET: &amp;[u8] = b"ABCDEFGHIJKLMNOPQRSTUVWXYZ\
@@ -293,12 +282,12 @@ <h2 id="create-random-passwords-from-a-set-of-user-defined-characters"><a class=
 
     let password: String = (0..PASSWORD_LEN)
         .map(|_| {
-            let idx = rng.gen_range(0..CHARSET.len());
+            let idx = rng.random_range(0..CHARSET.len());
             char::from(CHARSET[idx])
         })
         .collect();
 
-    println!("{:?}", password);
+    println!("{password}");
 }</code></pre></pre>
 <!--
 Links, in a few categories. Follow the existing structure.