<!DOCTYPE html> <html lang="en"> <head> <meta charset="utf-8"> <meta name="viewport" content="width=device-width, initial-scale=1.0"> <meta name="generator" content="rustdoc"> <meta name="description" content="API documentation for the Rust `f32` primitive in crate `std`."> <meta name="keywords" content="rust, rustlang, rust-lang, f32"> <title>f32 - Rust</title> <link rel="stylesheet" type="text/css" href="../normalize.css"> <link rel="stylesheet" type="text/css" href="../rustdoc.css"> <link rel="stylesheet" type="text/css" href="../main.css"> <link rel="shortcut icon" href="https://doc.rust-lang.org/favicon.ico"> </head> <body class="rustdoc primitive"> <!--[if lte IE 8]> <div class="warning"> This old browser is unsupported and will most likely display funky things. </div> <![endif]--> <nav class="sidebar"> <a href='../std/index.html'><img src='https://www.rust-lang.org/logos/rust-logo-128x128-blk-v2.png' alt='logo' width='100'></a> <p class='location'>Primitive Type f32</p><div class="block items"><ul><li><a href="#methods">Methods</a></li><li><a href="#implementations">Trait Implementations</a></li></ul></div><p class='location'><a href='index.html'>std</a></p><script>window.sidebarCurrent = {name: 'f32', ty: 'primitive', relpath: ''};</script><script defer src="sidebar-items.js"></script> </nav> <nav class="sub"> <form class="search-form js-only"> <div class="search-container"> <input class="search-input" name="search" autocomplete="off" placeholder="Click or press ‘S’ to search, ‘?’ for more options…" type="search"> </div> </form> </nav> <section id='main' class="content"> <h1 class='fqn'><span class='in-band'>Primitive Type <a class="primitive" href=''>f32</a></span><span class='out-of-band'><span class='since' title='Stable since Rust version 1.0.0'>1.0.0</span><span id='render-detail'> <a id="toggle-all-docs" href="javascript:void(0)" title="collapse all docs"> [<span class='inner'>−</span>] </a> </span></span></h1> <div class='docblock'><p>The 32-bit floating point type.</p> <p><em><a href="f32/index.html">See also the <code>std::f32</code> module</a>.</em></p> </div><h2 id='methods'>Methods</h2><h3 class='impl'><span class='in-band'><code>impl <a class="primitive" href="primitive.f32.html">f32</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/std/f32.rs.html#129-1156' title='goto source code'>[src]</a></span></h3> <div class='impl-items'><h4 id='method.is_nan' class="method"><span id='is_nan.v' class='invisible'><code>fn <a href='#method.is_nan' class='fnname'>is_nan</a>(self) -> <a class="primitive" href="primitive.bool.html">bool</a></code></span></h4> <div class='docblock'><p>Returns <code>true</code> if this value is <code>NaN</code> and false otherwise.</p> <pre class="rust rust-example-rendered"> <span class="kw">use</span> <span class="ident">std</span>::<span class="ident">f32</span>; <span class="kw">let</span> <span class="ident">nan</span> <span class="op">=</span> <span class="ident">f32</span>::<span class="ident">NAN</span>; <span class="kw">let</span> <span class="ident">f</span> <span class="op">=</span> <span class="number">7.0_f32</span>; <span class="macro">assert</span><span class="macro">!</span>(<span class="ident">nan</span>.<span class="ident">is_nan</span>()); <span class="macro">assert</span><span class="macro">!</span>(<span class="op">!</span><span class="ident">f</span>.<span class="ident">is_nan</span>());<a class="test-arrow" target="_blank" href="https://play.rust-lang.org/?code=fn%20main()%20%7B%0Ause%20std%3A%3Af32%3B%0A%0Alet%20nan%20%3D%20f32%3A%3ANAN%3B%0Alet%20f%20%3D%207.0_f32%3B%0A%0Aassert!(nan.is_nan())%3B%0Aassert!(!f.is_nan())%3B%0A%7D">Run</a></pre> </div><h4 id='method.is_infinite' class="method"><span id='is_infinite.v' class='invisible'><code>fn <a href='#method.is_infinite' class='fnname'>is_infinite</a>(self) -> <a class="primitive" href="primitive.bool.html">bool</a></code></span></h4> <div class='docblock'><p>Returns <code>true</code> if this value is positive infinity or negative infinity and false otherwise.</p> <pre class="rust rust-example-rendered"> <span class="kw">use</span> <span class="ident">std</span>::<span class="ident">f32</span>; <span class="kw">let</span> <span class="ident">f</span> <span class="op">=</span> <span class="number">7.0f32</span>; <span class="kw">let</span> <span class="ident">inf</span> <span class="op">=</span> <span class="ident">f32</span>::<span class="ident">INFINITY</span>; <span class="kw">let</span> <span class="ident">neg_inf</span> <span class="op">=</span> <span class="ident">f32</span>::<span class="ident">NEG_INFINITY</span>; <span class="kw">let</span> <span class="ident">nan</span> <span class="op">=</span> <span class="ident">f32</span>::<span class="ident">NAN</span>; <span class="macro">assert</span><span class="macro">!</span>(<span class="op">!</span><span class="ident">f</span>.<span class="ident">is_infinite</span>()); <span class="macro">assert</span><span class="macro">!</span>(<span class="op">!</span><span class="ident">nan</span>.<span class="ident">is_infinite</span>()); <span class="macro">assert</span><span class="macro">!</span>(<span class="ident">inf</span>.<span class="ident">is_infinite</span>()); <span class="macro">assert</span><span class="macro">!</span>(<span class="ident">neg_inf</span>.<span class="ident">is_infinite</span>());<a class="test-arrow" target="_blank" href="https://play.rust-lang.org/?code=fn%20main()%20%7B%0Ause%20std%3A%3Af32%3B%0A%0Alet%20f%20%3D%207.0f32%3B%0Alet%20inf%20%3D%20f32%3A%3AINFINITY%3B%0Alet%20neg_inf%20%3D%20f32%3A%3ANEG_INFINITY%3B%0Alet%20nan%20%3D%20f32%3A%3ANAN%3B%0A%0Aassert!(!f.is_infinite())%3B%0Aassert!(!nan.is_infinite())%3B%0A%0Aassert!(inf.is_infinite())%3B%0Aassert!(neg_inf.is_infinite())%3B%0A%7D">Run</a></pre> </div><h4 id='method.is_finite' class="method"><span id='is_finite.v' class='invisible'><code>fn <a href='#method.is_finite' class='fnname'>is_finite</a>(self) -> <a class="primitive" href="primitive.bool.html">bool</a></code></span></h4> <div class='docblock'><p>Returns <code>true</code> if this number is neither infinite nor <code>NaN</code>.</p> <pre class="rust rust-example-rendered"> <span class="kw">use</span> <span class="ident">std</span>::<span class="ident">f32</span>; <span class="kw">let</span> <span class="ident">f</span> <span class="op">=</span> <span class="number">7.0f32</span>; <span class="kw">let</span> <span class="ident">inf</span> <span class="op">=</span> <span class="ident">f32</span>::<span class="ident">INFINITY</span>; <span class="kw">let</span> <span class="ident">neg_inf</span> <span class="op">=</span> <span class="ident">f32</span>::<span class="ident">NEG_INFINITY</span>; <span class="kw">let</span> <span class="ident">nan</span> <span class="op">=</span> <span class="ident">f32</span>::<span class="ident">NAN</span>; <span class="macro">assert</span><span class="macro">!</span>(<span class="ident">f</span>.<span class="ident">is_finite</span>()); <span class="macro">assert</span><span class="macro">!</span>(<span class="op">!</span><span class="ident">nan</span>.<span class="ident">is_finite</span>()); <span class="macro">assert</span><span class="macro">!</span>(<span class="op">!</span><span class="ident">inf</span>.<span class="ident">is_finite</span>()); <span class="macro">assert</span><span class="macro">!</span>(<span class="op">!</span><span class="ident">neg_inf</span>.<span class="ident">is_finite</span>());<a class="test-arrow" target="_blank" href="https://play.rust-lang.org/?code=fn%20main()%20%7B%0Ause%20std%3A%3Af32%3B%0A%0Alet%20f%20%3D%207.0f32%3B%0Alet%20inf%20%3D%20f32%3A%3AINFINITY%3B%0Alet%20neg_inf%20%3D%20f32%3A%3ANEG_INFINITY%3B%0Alet%20nan%20%3D%20f32%3A%3ANAN%3B%0A%0Aassert!(f.is_finite())%3B%0A%0Aassert!(!nan.is_finite())%3B%0Aassert!(!inf.is_finite())%3B%0Aassert!(!neg_inf.is_finite())%3B%0A%7D">Run</a></pre> </div><h4 id='method.is_normal' class="method"><span id='is_normal.v' class='invisible'><code>fn <a href='#method.is_normal' class='fnname'>is_normal</a>(self) -> <a class="primitive" href="primitive.bool.html">bool</a></code></span></h4> <div class='docblock'><p>Returns <code>true</code> if the number is neither zero, infinite, <a href="https://en.wikipedia.org/wiki/Denormal_number">subnormal</a>, or <code>NaN</code>.</p> <pre class="rust rust-example-rendered"> <span class="kw">use</span> <span class="ident">std</span>::<span class="ident">f32</span>; <span class="kw">let</span> <span class="ident">min</span> <span class="op">=</span> <span class="ident">f32</span>::<span class="ident">MIN_POSITIVE</span>; <span class="comment">// 1.17549435e-38f32</span> <span class="kw">let</span> <span class="ident">max</span> <span class="op">=</span> <span class="ident">f32</span>::<span class="ident">MAX</span>; <span class="kw">let</span> <span class="ident">lower_than_min</span> <span class="op">=</span> <span class="number">1.0e-40_f32</span>; <span class="kw">let</span> <span class="ident">zero</span> <span class="op">=</span> <span class="number">0.0_f32</span>; <span class="macro">assert</span><span class="macro">!</span>(<span class="ident">min</span>.<span class="ident">is_normal</span>()); <span class="macro">assert</span><span class="macro">!</span>(<span class="ident">max</span>.<span class="ident">is_normal</span>()); <span class="macro">assert</span><span class="macro">!</span>(<span class="op">!</span><span class="ident">zero</span>.<span class="ident">is_normal</span>()); <span class="macro">assert</span><span class="macro">!</span>(<span class="op">!</span><span class="ident">f32</span>::<span class="ident">NAN</span>.<span class="ident">is_normal</span>()); <span class="macro">assert</span><span class="macro">!</span>(<span class="op">!</span><span class="ident">f32</span>::<span class="ident">INFINITY</span>.<span class="ident">is_normal</span>()); <span class="comment">// Values between `0` and `min` are Subnormal.</span> <span class="macro">assert</span><span class="macro">!</span>(<span class="op">!</span><span class="ident">lower_than_min</span>.<span class="ident">is_normal</span>());<a class="test-arrow" target="_blank" href="https://play.rust-lang.org/?code=fn%20main()%20%7B%0Ause%20std%3A%3Af32%3B%0A%0Alet%20min%20%3D%20f32%3A%3AMIN_POSITIVE%3B%20%2F%2F%201.17549435e-38f32%0Alet%20max%20%3D%20f32%3A%3AMAX%3B%0Alet%20lower_than_min%20%3D%201.0e-40_f32%3B%0Alet%20zero%20%3D%200.0_f32%3B%0A%0Aassert!(min.is_normal())%3B%0Aassert!(max.is_normal())%3B%0A%0Aassert!(!zero.is_normal())%3B%0Aassert!(!f32%3A%3ANAN.is_normal())%3B%0Aassert!(!f32%3A%3AINFINITY.is_normal())%3B%0A%2F%2F%20Values%20between%20%600%60%20and%20%60min%60%20are%20Subnormal.%0Aassert!(!lower_than_min.is_normal())%3B%0A%7D">Run</a></pre> </div><h4 id='method.classify' class="method"><span id='classify.v' class='invisible'><code>fn <a href='#method.classify' class='fnname'>classify</a>(self) -> <a class="enum" href="../std/num/enum.FpCategory.html" title="enum std::num::FpCategory">FpCategory</a></code></span></h4> <div class='docblock'><p>Returns the floating point category of the number. If only one property is going to be tested, it is generally faster to use the specific predicate instead.</p> <pre class="rust rust-example-rendered"> <span class="kw">use</span> <span class="ident">std</span>::<span class="ident">num</span>::<span class="ident">FpCategory</span>; <span class="kw">use</span> <span class="ident">std</span>::<span class="ident">f32</span>; <span class="kw">let</span> <span class="ident">num</span> <span class="op">=</span> <span class="number">12.4_f32</span>; <span class="kw">let</span> <span class="ident">inf</span> <span class="op">=</span> <span class="ident">f32</span>::<span class="ident">INFINITY</span>; <span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">num</span>.<span class="ident">classify</span>(), <span class="ident">FpCategory</span>::<span class="ident">Normal</span>); <span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">inf</span>.<span class="ident">classify</span>(), <span class="ident">FpCategory</span>::<span class="ident">Infinite</span>);<a class="test-arrow" target="_blank" href="https://play.rust-lang.org/?code=fn%20main()%20%7B%0Ause%20std%3A%3Anum%3A%3AFpCategory%3B%0Ause%20std%3A%3Af32%3B%0A%0Alet%20num%20%3D%2012.4_f32%3B%0Alet%20inf%20%3D%20f32%3A%3AINFINITY%3B%0A%0Aassert_eq!(num.classify()%2C%20FpCategory%3A%3ANormal)%3B%0Aassert_eq!(inf.classify()%2C%20FpCategory%3A%3AInfinite)%3B%0A%7D">Run</a></pre> </div><h4 id='method.floor' class="method"><span id='floor.v' class='invisible'><code>fn <a href='#method.floor' class='fnname'>floor</a>(self) -> <a class="primitive" href="primitive.f32.html">f32</a></code></span></h4> <div class='docblock'><p>Returns the largest integer less than or equal to a number.</p> <pre class="rust rust-example-rendered"> <span class="kw">let</span> <span class="ident">f</span> <span class="op">=</span> <span class="number">3.99_f32</span>; <span class="kw">let</span> <span class="ident">g</span> <span class="op">=</span> <span class="number">3.0_f32</span>; <span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">f</span>.<span class="ident">floor</span>(), <span class="number">3.0</span>); <span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">g</span>.<span class="ident">floor</span>(), <span class="number">3.0</span>);<a class="test-arrow" target="_blank" href="https://play.rust-lang.org/?code=fn%20main()%20%7B%0Alet%20f%20%3D%203.99_f32%3B%0Alet%20g%20%3D%203.0_f32%3B%0A%0Aassert_eq!(f.floor()%2C%203.0)%3B%0Aassert_eq!(g.floor()%2C%203.0)%3B%0A%7D">Run</a></pre> </div><h4 id='method.ceil' class="method"><span id='ceil.v' class='invisible'><code>fn <a href='#method.ceil' class='fnname'>ceil</a>(self) -> <a class="primitive" href="primitive.f32.html">f32</a></code></span></h4> <div class='docblock'><p>Returns the smallest integer greater than or equal to a number.</p> <pre class="rust rust-example-rendered"> <span class="kw">let</span> <span class="ident">f</span> <span class="op">=</span> <span class="number">3.01_f32</span>; <span class="kw">let</span> <span class="ident">g</span> <span class="op">=</span> <span class="number">4.0_f32</span>; <span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">f</span>.<span class="ident">ceil</span>(), <span class="number">4.0</span>); <span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">g</span>.<span class="ident">ceil</span>(), <span class="number">4.0</span>);<a class="test-arrow" target="_blank" href="https://play.rust-lang.org/?code=fn%20main()%20%7B%0Alet%20f%20%3D%203.01_f32%3B%0Alet%20g%20%3D%204.0_f32%3B%0A%0Aassert_eq!(f.ceil()%2C%204.0)%3B%0Aassert_eq!(g.ceil()%2C%204.0)%3B%0A%7D">Run</a></pre> </div><h4 id='method.round' class="method"><span id='round.v' class='invisible'><code>fn <a href='#method.round' class='fnname'>round</a>(self) -> <a class="primitive" href="primitive.f32.html">f32</a></code></span></h4> <div class='docblock'><p>Returns the nearest integer to a number. Round half-way cases away from <code>0.0</code>.</p> <pre class="rust rust-example-rendered"> <span class="kw">let</span> <span class="ident">f</span> <span class="op">=</span> <span class="number">3.3_f32</span>; <span class="kw">let</span> <span class="ident">g</span> <span class="op">=</span> <span class="op">-</span><span class="number">3.3_f32</span>; <span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">f</span>.<span class="ident">round</span>(), <span class="number">3.0</span>); <span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">g</span>.<span class="ident">round</span>(), <span class="op">-</span><span class="number">3.0</span>);<a class="test-arrow" target="_blank" href="https://play.rust-lang.org/?code=fn%20main()%20%7B%0Alet%20f%20%3D%203.3_f32%3B%0Alet%20g%20%3D%20-3.3_f32%3B%0A%0Aassert_eq!(f.round()%2C%203.0)%3B%0Aassert_eq!(g.round()%2C%20-3.0)%3B%0A%7D">Run</a></pre> </div><h4 id='method.trunc' class="method"><span id='trunc.v' class='invisible'><code>fn <a href='#method.trunc' class='fnname'>trunc</a>(self) -> <a class="primitive" href="primitive.f32.html">f32</a></code></span></h4> <div class='docblock'><p>Returns the integer part of a number.</p> <pre class="rust rust-example-rendered"> <span class="kw">let</span> <span class="ident">f</span> <span class="op">=</span> <span class="number">3.3_f32</span>; <span class="kw">let</span> <span class="ident">g</span> <span class="op">=</span> <span class="op">-</span><span class="number">3.7_f32</span>; <span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">f</span>.<span class="ident">trunc</span>(), <span class="number">3.0</span>); <span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">g</span>.<span class="ident">trunc</span>(), <span class="op">-</span><span class="number">3.0</span>);<a class="test-arrow" target="_blank" href="https://play.rust-lang.org/?code=fn%20main()%20%7B%0Alet%20f%20%3D%203.3_f32%3B%0Alet%20g%20%3D%20-3.7_f32%3B%0A%0Aassert_eq!(f.trunc()%2C%203.0)%3B%0Aassert_eq!(g.trunc()%2C%20-3.0)%3B%0A%7D">Run</a></pre> </div><h4 id='method.fract' class="method"><span id='fract.v' class='invisible'><code>fn <a href='#method.fract' class='fnname'>fract</a>(self) -> <a class="primitive" href="primitive.f32.html">f32</a></code></span></h4> <div class='docblock'><p>Returns the fractional part of a number.</p> <pre class="rust rust-example-rendered"> <span class="kw">use</span> <span class="ident">std</span>::<span class="ident">f32</span>; <span class="kw">let</span> <span class="ident">x</span> <span class="op">=</span> <span class="number">3.5_f32</span>; <span class="kw">let</span> <span class="ident">y</span> <span class="op">=</span> <span class="op">-</span><span class="number">3.5_f32</span>; <span class="kw">let</span> <span class="ident">abs_difference_x</span> <span class="op">=</span> (<span class="ident">x</span>.<span class="ident">fract</span>() <span class="op">-</span> <span class="number">0.5</span>).<span class="ident">abs</span>(); <span class="kw">let</span> <span class="ident">abs_difference_y</span> <span class="op">=</span> (<span class="ident">y</span>.<span class="ident">fract</span>() <span class="op">-</span> (<span class="op">-</span><span class="number">0.5</span>)).<span class="ident">abs</span>(); <span class="macro">assert</span><span class="macro">!</span>(<span class="ident">abs_difference_x</span> <span class="op"><=</span> <span class="ident">f32</span>::<span class="ident">EPSILON</span>); <span class="macro">assert</span><span class="macro">!</span>(<span class="ident">abs_difference_y</span> <span class="op"><=</span> <span class="ident">f32</span>::<span class="ident">EPSILON</span>);<a class="test-arrow" target="_blank" href="https://play.rust-lang.org/?code=fn%20main()%20%7B%0Ause%20std%3A%3Af32%3B%0A%0Alet%20x%20%3D%203.5_f32%3B%0Alet%20y%20%3D%20-3.5_f32%3B%0Alet%20abs_difference_x%20%3D%20(x.fract()%20-%200.5).abs()%3B%0Alet%20abs_difference_y%20%3D%20(y.fract()%20-%20(-0.5)).abs()%3B%0A%0Aassert!(abs_difference_x%20%3C%3D%20f32%3A%3AEPSILON)%3B%0Aassert!(abs_difference_y%20%3C%3D%20f32%3A%3AEPSILON)%3B%0A%7D">Run</a></pre> </div><h4 id='method.abs' class="method"><span id='abs.v' class='invisible'><code>fn <a href='#method.abs' class='fnname'>abs</a>(self) -> <a class="primitive" href="primitive.f32.html">f32</a></code></span></h4> <div class='docblock'><p>Computes the absolute value of <code>self</code>. Returns <code>NAN</code> if the number is <code>NAN</code>.</p> <pre class="rust rust-example-rendered"> <span class="kw">use</span> <span class="ident">std</span>::<span class="ident">f32</span>; <span class="kw">let</span> <span class="ident">x</span> <span class="op">=</span> <span class="number">3.5_f32</span>; <span class="kw">let</span> <span class="ident">y</span> <span class="op">=</span> <span class="op">-</span><span class="number">3.5_f32</span>; <span class="kw">let</span> <span class="ident">abs_difference_x</span> <span class="op">=</span> (<span class="ident">x</span>.<span class="ident">abs</span>() <span class="op">-</span> <span class="ident">x</span>).<span class="ident">abs</span>(); <span class="kw">let</span> <span class="ident">abs_difference_y</span> <span class="op">=</span> (<span class="ident">y</span>.<span class="ident">abs</span>() <span class="op">-</span> (<span class="op">-</span><span class="ident">y</span>)).<span class="ident">abs</span>(); <span class="macro">assert</span><span class="macro">!</span>(<span class="ident">abs_difference_x</span> <span class="op"><=</span> <span class="ident">f32</span>::<span class="ident">EPSILON</span>); <span class="macro">assert</span><span class="macro">!</span>(<span class="ident">abs_difference_y</span> <span class="op"><=</span> <span class="ident">f32</span>::<span class="ident">EPSILON</span>); <span class="macro">assert</span><span class="macro">!</span>(<span class="ident">f32</span>::<span class="ident">NAN</span>.<span class="ident">abs</span>().<span class="ident">is_nan</span>());<a class="test-arrow" target="_blank" href="https://play.rust-lang.org/?code=fn%20main()%20%7B%0Ause%20std%3A%3Af32%3B%0A%0Alet%20x%20%3D%203.5_f32%3B%0Alet%20y%20%3D%20-3.5_f32%3B%0A%0Alet%20abs_difference_x%20%3D%20(x.abs()%20-%20x).abs()%3B%0Alet%20abs_difference_y%20%3D%20(y.abs()%20-%20(-y)).abs()%3B%0A%0Aassert!(abs_difference_x%20%3C%3D%20f32%3A%3AEPSILON)%3B%0Aassert!(abs_difference_y%20%3C%3D%20f32%3A%3AEPSILON)%3B%0A%0Aassert!(f32%3A%3ANAN.abs().is_nan())%3B%0A%7D">Run</a></pre> </div><h4 id='method.signum' class="method"><span id='signum.v' class='invisible'><code>fn <a href='#method.signum' class='fnname'>signum</a>(self) -> <a class="primitive" href="primitive.f32.html">f32</a></code></span></h4> <div class='docblock'><p>Returns a number that represents the sign of <code>self</code>.</p> <ul> <li><code>1.0</code> if the number is positive, <code>+0.0</code> or <code>INFINITY</code></li> <li><code>-1.0</code> if the number is negative, <code>-0.0</code> or <code>NEG_INFINITY</code></li> <li><code>NAN</code> if the number is <code>NAN</code></li> </ul> <pre class="rust rust-example-rendered"> <span class="kw">use</span> <span class="ident">std</span>::<span class="ident">f32</span>; <span class="kw">let</span> <span class="ident">f</span> <span class="op">=</span> <span class="number">3.5_f32</span>; <span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">f</span>.<span class="ident">signum</span>(), <span class="number">1.0</span>); <span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">f32</span>::<span class="ident">NEG_INFINITY</span>.<span class="ident">signum</span>(), <span class="op">-</span><span class="number">1.0</span>); <span class="macro">assert</span><span class="macro">!</span>(<span class="ident">f32</span>::<span class="ident">NAN</span>.<span class="ident">signum</span>().<span class="ident">is_nan</span>());<a class="test-arrow" target="_blank" href="https://play.rust-lang.org/?code=fn%20main()%20%7B%0Ause%20std%3A%3Af32%3B%0A%0Alet%20f%20%3D%203.5_f32%3B%0A%0Aassert_eq!(f.signum()%2C%201.0)%3B%0Aassert_eq!(f32%3A%3ANEG_INFINITY.signum()%2C%20-1.0)%3B%0A%0Aassert!(f32%3A%3ANAN.signum().is_nan())%3B%0A%7D">Run</a></pre> </div><h4 id='method.is_sign_positive' class="method"><span id='is_sign_positive.v' class='invisible'><code>fn <a href='#method.is_sign_positive' class='fnname'>is_sign_positive</a>(self) -> <a class="primitive" href="primitive.bool.html">bool</a></code></span></h4> <div class='docblock'><p>Returns <code>true</code> if <code>self</code>'s sign bit is positive, including <code>+0.0</code> and <code>INFINITY</code>.</p> <pre class="rust rust-example-rendered"> <span class="kw">use</span> <span class="ident">std</span>::<span class="ident">f32</span>; <span class="kw">let</span> <span class="ident">nan</span> <span class="op">=</span> <span class="ident">f32</span>::<span class="ident">NAN</span>; <span class="kw">let</span> <span class="ident">f</span> <span class="op">=</span> <span class="number">7.0_f32</span>; <span class="kw">let</span> <span class="ident">g</span> <span class="op">=</span> <span class="op">-</span><span class="number">7.0_f32</span>; <span class="macro">assert</span><span class="macro">!</span>(<span class="ident">f</span>.<span class="ident">is_sign_positive</span>()); <span class="macro">assert</span><span class="macro">!</span>(<span class="op">!</span><span class="ident">g</span>.<span class="ident">is_sign_positive</span>()); <span class="comment">// Requires both tests to determine if is `NaN`</span> <span class="macro">assert</span><span class="macro">!</span>(<span class="op">!</span><span class="ident">nan</span>.<span class="ident">is_sign_positive</span>() <span class="op">&&</span> <span class="op">!</span><span class="ident">nan</span>.<span class="ident">is_sign_negative</span>());<a class="test-arrow" target="_blank" href="https://play.rust-lang.org/?code=fn%20main()%20%7B%0Ause%20std%3A%3Af32%3B%0A%0Alet%20nan%20%3D%20f32%3A%3ANAN%3B%0Alet%20f%20%3D%207.0_f32%3B%0Alet%20g%20%3D%20-7.0_f32%3B%0A%0Aassert!(f.is_sign_positive())%3B%0Aassert!(!g.is_sign_positive())%3B%0A%2F%2F%20Requires%20both%20tests%20to%20determine%20if%20is%20%60NaN%60%0Aassert!(!nan.is_sign_positive()%20%26%26%20!nan.is_sign_negative())%3B%0A%7D">Run</a></pre> </div><h4 id='method.is_sign_negative' class="method"><span id='is_sign_negative.v' class='invisible'><code>fn <a href='#method.is_sign_negative' class='fnname'>is_sign_negative</a>(self) -> <a class="primitive" href="primitive.bool.html">bool</a></code></span></h4> <div class='docblock'><p>Returns <code>true</code> if <code>self</code>'s sign is negative, including <code>-0.0</code> and <code>NEG_INFINITY</code>.</p> <pre class="rust rust-example-rendered"> <span class="kw">use</span> <span class="ident">std</span>::<span class="ident">f32</span>; <span class="kw">let</span> <span class="ident">nan</span> <span class="op">=</span> <span class="ident">f32</span>::<span class="ident">NAN</span>; <span class="kw">let</span> <span class="ident">f</span> <span class="op">=</span> <span class="number">7.0f32</span>; <span class="kw">let</span> <span class="ident">g</span> <span class="op">=</span> <span class="op">-</span><span class="number">7.0f32</span>; <span class="macro">assert</span><span class="macro">!</span>(<span class="op">!</span><span class="ident">f</span>.<span class="ident">is_sign_negative</span>()); <span class="macro">assert</span><span class="macro">!</span>(<span class="ident">g</span>.<span class="ident">is_sign_negative</span>()); <span class="comment">// Requires both tests to determine if is `NaN`.</span> <span class="macro">assert</span><span class="macro">!</span>(<span class="op">!</span><span class="ident">nan</span>.<span class="ident">is_sign_positive</span>() <span class="op">&&</span> <span class="op">!</span><span class="ident">nan</span>.<span class="ident">is_sign_negative</span>());<a class="test-arrow" target="_blank" href="https://play.rust-lang.org/?code=fn%20main()%20%7B%0Ause%20std%3A%3Af32%3B%0A%0Alet%20nan%20%3D%20f32%3A%3ANAN%3B%0Alet%20f%20%3D%207.0f32%3B%0Alet%20g%20%3D%20-7.0f32%3B%0A%0Aassert!(!f.is_sign_negative())%3B%0Aassert!(g.is_sign_negative())%3B%0A%2F%2F%20Requires%20both%20tests%20to%20determine%20if%20is%20%60NaN%60.%0Aassert!(!nan.is_sign_positive()%20%26%26%20!nan.is_sign_negative())%3B%0A%7D">Run</a></pre> </div><h4 id='method.mul_add' class="method"><span id='mul_add.v' class='invisible'><code>fn <a href='#method.mul_add' class='fnname'>mul_add</a>(self, a: <a class="primitive" href="primitive.f32.html">f32</a>, b: <a class="primitive" href="primitive.f32.html">f32</a>) -> <a class="primitive" href="primitive.f32.html">f32</a></code></span></h4> <div class='docblock'><p>Fused multiply-add. Computes <code>(self * a) + b</code> with only one rounding error. This produces a more accurate result with better performance than a separate multiplication operation followed by an add.</p> <pre class="rust rust-example-rendered"> <span class="kw">use</span> <span class="ident">std</span>::<span class="ident">f32</span>; <span class="kw">let</span> <span class="ident">m</span> <span class="op">=</span> <span class="number">10.0_f32</span>; <span class="kw">let</span> <span class="ident">x</span> <span class="op">=</span> <span class="number">4.0_f32</span>; <span class="kw">let</span> <span class="ident">b</span> <span class="op">=</span> <span class="number">60.0_f32</span>; <span class="comment">// 100.0</span> <span class="kw">let</span> <span class="ident">abs_difference</span> <span class="op">=</span> (<span class="ident">m</span>.<span class="ident">mul_add</span>(<span class="ident">x</span>, <span class="ident">b</span>) <span class="op">-</span> (<span class="ident">m</span><span class="kw-2">*</span><span class="ident">x</span> <span class="op">+</span> <span class="ident">b</span>)).<span class="ident">abs</span>(); <span class="macro">assert</span><span class="macro">!</span>(<span class="ident">abs_difference</span> <span class="op"><=</span> <span class="ident">f32</span>::<span class="ident">EPSILON</span>);<a class="test-arrow" target="_blank" href="https://play.rust-lang.org/?code=fn%20main()%20%7B%0Ause%20std%3A%3Af32%3B%0A%0Alet%20m%20%3D%2010.0_f32%3B%0Alet%20x%20%3D%204.0_f32%3B%0Alet%20b%20%3D%2060.0_f32%3B%0A%0A%2F%2F%20100.0%0Alet%20abs_difference%20%3D%20(m.mul_add(x%2C%20b)%20-%20(m*x%20%2B%20b)).abs()%3B%0A%0Aassert!(abs_difference%20%3C%3D%20f32%3A%3AEPSILON)%3B%0A%7D">Run</a></pre> </div><h4 id='method.recip' class="method"><span id='recip.v' class='invisible'><code>fn <a href='#method.recip' class='fnname'>recip</a>(self) -> <a class="primitive" href="primitive.f32.html">f32</a></code></span></h4> <div class='docblock'><p>Takes the reciprocal (inverse) of a number, <code>1/x</code>.</p> <pre class="rust rust-example-rendered"> <span class="kw">use</span> <span class="ident">std</span>::<span class="ident">f32</span>; <span class="kw">let</span> <span class="ident">x</span> <span class="op">=</span> <span class="number">2.0_f32</span>; <span class="kw">let</span> <span class="ident">abs_difference</span> <span class="op">=</span> (<span class="ident">x</span>.<span class="ident">recip</span>() <span class="op">-</span> (<span class="number">1.0</span><span class="op">/</span><span class="ident">x</span>)).<span class="ident">abs</span>(); <span class="macro">assert</span><span class="macro">!</span>(<span class="ident">abs_difference</span> <span class="op"><=</span> <span class="ident">f32</span>::<span class="ident">EPSILON</span>);<a class="test-arrow" target="_blank" href="https://play.rust-lang.org/?code=fn%20main()%20%7B%0Ause%20std%3A%3Af32%3B%0A%0Alet%20x%20%3D%202.0_f32%3B%0Alet%20abs_difference%20%3D%20(x.recip()%20-%20(1.0%2Fx)).abs()%3B%0A%0Aassert!(abs_difference%20%3C%3D%20f32%3A%3AEPSILON)%3B%0A%7D">Run</a></pre> </div><h4 id='method.powi' class="method"><span id='powi.v' class='invisible'><code>fn <a href='#method.powi' class='fnname'>powi</a>(self, n: <a class="primitive" href="primitive.i32.html">i32</a>) -> <a class="primitive" href="primitive.f32.html">f32</a></code></span></h4> <div class='docblock'><p>Raises a number to an integer power.</p> <p>Using this function is generally faster than using <code>powf</code></p> <pre class="rust rust-example-rendered"> <span class="kw">use</span> <span class="ident">std</span>::<span class="ident">f32</span>; <span class="kw">let</span> <span class="ident">x</span> <span class="op">=</span> <span class="number">2.0_f32</span>; <span class="kw">let</span> <span class="ident">abs_difference</span> <span class="op">=</span> (<span class="ident">x</span>.<span class="ident">powi</span>(<span class="number">2</span>) <span class="op">-</span> <span class="ident">x</span><span class="kw-2">*</span><span class="ident">x</span>).<span class="ident">abs</span>(); <span class="macro">assert</span><span class="macro">!</span>(<span class="ident">abs_difference</span> <span class="op"><=</span> <span class="ident">f32</span>::<span class="ident">EPSILON</span>);<a class="test-arrow" target="_blank" href="https://play.rust-lang.org/?code=fn%20main()%20%7B%0Ause%20std%3A%3Af32%3B%0A%0Alet%20x%20%3D%202.0_f32%3B%0Alet%20abs_difference%20%3D%20(x.powi(2)%20-%20x*x).abs()%3B%0A%0Aassert!(abs_difference%20%3C%3D%20f32%3A%3AEPSILON)%3B%0A%7D">Run</a></pre> </div><h4 id='method.powf' class="method"><span id='powf.v' class='invisible'><code>fn <a href='#method.powf' class='fnname'>powf</a>(self, n: <a class="primitive" href="primitive.f32.html">f32</a>) -> <a class="primitive" href="primitive.f32.html">f32</a></code></span></h4> <div class='docblock'><p>Raises a number to a floating point power.</p> <pre class="rust rust-example-rendered"> <span class="kw">use</span> <span class="ident">std</span>::<span class="ident">f32</span>; <span class="kw">let</span> <span class="ident">x</span> <span class="op">=</span> <span class="number">2.0_f32</span>; <span class="kw">let</span> <span class="ident">abs_difference</span> <span class="op">=</span> (<span class="ident">x</span>.<span class="ident">powf</span>(<span class="number">2.0</span>) <span class="op">-</span> <span class="ident">x</span><span class="kw-2">*</span><span class="ident">x</span>).<span class="ident">abs</span>(); <span class="macro">assert</span><span class="macro">!</span>(<span class="ident">abs_difference</span> <span class="op"><=</span> <span class="ident">f32</span>::<span class="ident">EPSILON</span>);<a class="test-arrow" target="_blank" href="https://play.rust-lang.org/?code=fn%20main()%20%7B%0Ause%20std%3A%3Af32%3B%0A%0Alet%20x%20%3D%202.0_f32%3B%0Alet%20abs_difference%20%3D%20(x.powf(2.0)%20-%20x*x).abs()%3B%0A%0Aassert!(abs_difference%20%3C%3D%20f32%3A%3AEPSILON)%3B%0A%7D">Run</a></pre> </div><h4 id='method.sqrt' class="method"><span id='sqrt.v' class='invisible'><code>fn <a href='#method.sqrt' class='fnname'>sqrt</a>(self) -> <a class="primitive" href="primitive.f32.html">f32</a></code></span></h4> <div class='docblock'><p>Takes the square root of a number.</p> <p>Returns NaN if <code>self</code> is a negative number.</p> <pre class="rust rust-example-rendered"> <span class="kw">use</span> <span class="ident">std</span>::<span class="ident">f32</span>; <span class="kw">let</span> <span class="ident">positive</span> <span class="op">=</span> <span class="number">4.0_f32</span>; <span class="kw">let</span> <span class="ident">negative</span> <span class="op">=</span> <span class="op">-</span><span class="number">4.0_f32</span>; <span class="kw">let</span> <span class="ident">abs_difference</span> <span class="op">=</span> (<span class="ident">positive</span>.<span class="ident">sqrt</span>() <span class="op">-</span> <span class="number">2.0</span>).<span class="ident">abs</span>(); <span class="macro">assert</span><span class="macro">!</span>(<span class="ident">abs_difference</span> <span class="op"><=</span> <span class="ident">f32</span>::<span class="ident">EPSILON</span>); <span class="macro">assert</span><span class="macro">!</span>(<span class="ident">negative</span>.<span class="ident">sqrt</span>().<span class="ident">is_nan</span>());<a class="test-arrow" target="_blank" href="https://play.rust-lang.org/?code=fn%20main()%20%7B%0Ause%20std%3A%3Af32%3B%0A%0Alet%20positive%20%3D%204.0_f32%3B%0Alet%20negative%20%3D%20-4.0_f32%3B%0A%0Alet%20abs_difference%20%3D%20(positive.sqrt()%20-%202.0).abs()%3B%0A%0Aassert!(abs_difference%20%3C%3D%20f32%3A%3AEPSILON)%3B%0Aassert!(negative.sqrt().is_nan())%3B%0A%7D">Run</a></pre> </div><h4 id='method.exp' class="method"><span id='exp.v' class='invisible'><code>fn <a href='#method.exp' class='fnname'>exp</a>(self) -> <a class="primitive" href="primitive.f32.html">f32</a></code></span></h4> <div class='docblock'><p>Returns <code>e^(self)</code>, (the exponential function).</p> <pre class="rust rust-example-rendered"> <span class="kw">use</span> <span class="ident">std</span>::<span class="ident">f32</span>; <span class="kw">let</span> <span class="ident">one</span> <span class="op">=</span> <span class="number">1.0f32</span>; <span class="comment">// e^1</span> <span class="kw">let</span> <span class="ident">e</span> <span class="op">=</span> <span class="ident">one</span>.<span class="ident">exp</span>(); <span class="comment">// ln(e) - 1 == 0</span> <span class="kw">let</span> <span class="ident">abs_difference</span> <span class="op">=</span> (<span class="ident">e</span>.<span class="ident">ln</span>() <span class="op">-</span> <span class="number">1.0</span>).<span class="ident">abs</span>(); <span class="macro">assert</span><span class="macro">!</span>(<span class="ident">abs_difference</span> <span class="op"><=</span> <span class="ident">f32</span>::<span class="ident">EPSILON</span>);<a class="test-arrow" target="_blank" href="https://play.rust-lang.org/?code=fn%20main()%20%7B%0Ause%20std%3A%3Af32%3B%0A%0Alet%20one%20%3D%201.0f32%3B%0A%2F%2F%20e%5E1%0Alet%20e%20%3D%20one.exp()%3B%0A%0A%2F%2F%20ln(e)%20-%201%20%3D%3D%200%0Alet%20abs_difference%20%3D%20(e.ln()%20-%201.0).abs()%3B%0A%0Aassert!(abs_difference%20%3C%3D%20f32%3A%3AEPSILON)%3B%0A%7D">Run</a></pre> </div><h4 id='method.exp2' class="method"><span id='exp2.v' class='invisible'><code>fn <a href='#method.exp2' class='fnname'>exp2</a>(self) -> <a class="primitive" href="primitive.f32.html">f32</a></code></span></h4> <div class='docblock'><p>Returns <code>2^(self)</code>.</p> <pre class="rust rust-example-rendered"> <span class="kw">use</span> <span class="ident">std</span>::<span class="ident">f32</span>; <span class="kw">let</span> <span class="ident">f</span> <span class="op">=</span> <span class="number">2.0f32</span>; <span class="comment">// 2^2 - 4 == 0</span> <span class="kw">let</span> <span class="ident">abs_difference</span> <span class="op">=</span> (<span class="ident">f</span>.<span class="ident">exp2</span>() <span class="op">-</span> <span class="number">4.0</span>).<span class="ident">abs</span>(); <span class="macro">assert</span><span class="macro">!</span>(<span class="ident">abs_difference</span> <span class="op"><=</span> <span class="ident">f32</span>::<span class="ident">EPSILON</span>);<a class="test-arrow" target="_blank" href="https://play.rust-lang.org/?code=fn%20main()%20%7B%0Ause%20std%3A%3Af32%3B%0A%0Alet%20f%20%3D%202.0f32%3B%0A%0A%2F%2F%202%5E2%20-%204%20%3D%3D%200%0Alet%20abs_difference%20%3D%20(f.exp2()%20-%204.0).abs()%3B%0A%0Aassert!(abs_difference%20%3C%3D%20f32%3A%3AEPSILON)%3B%0A%7D">Run</a></pre> </div><h4 id='method.ln' class="method"><span id='ln.v' class='invisible'><code>fn <a href='#method.ln' class='fnname'>ln</a>(self) -> <a class="primitive" href="primitive.f32.html">f32</a></code></span></h4> <div class='docblock'><p>Returns the natural logarithm of the number.</p> <pre class="rust rust-example-rendered"> <span class="kw">use</span> <span class="ident">std</span>::<span class="ident">f32</span>; <span class="kw">let</span> <span class="ident">one</span> <span class="op">=</span> <span class="number">1.0f32</span>; <span class="comment">// e^1</span> <span class="kw">let</span> <span class="ident">e</span> <span class="op">=</span> <span class="ident">one</span>.<span class="ident">exp</span>(); <span class="comment">// ln(e) - 1 == 0</span> <span class="kw">let</span> <span class="ident">abs_difference</span> <span class="op">=</span> (<span class="ident">e</span>.<span class="ident">ln</span>() <span class="op">-</span> <span class="number">1.0</span>).<span class="ident">abs</span>(); <span class="macro">assert</span><span class="macro">!</span>(<span class="ident">abs_difference</span> <span class="op"><=</span> <span class="ident">f32</span>::<span class="ident">EPSILON</span>);<a class="test-arrow" target="_blank" href="https://play.rust-lang.org/?code=fn%20main()%20%7B%0Ause%20std%3A%3Af32%3B%0A%0Alet%20one%20%3D%201.0f32%3B%0A%2F%2F%20e%5E1%0Alet%20e%20%3D%20one.exp()%3B%0A%0A%2F%2F%20ln(e)%20-%201%20%3D%3D%200%0Alet%20abs_difference%20%3D%20(e.ln()%20-%201.0).abs()%3B%0A%0Aassert!(abs_difference%20%3C%3D%20f32%3A%3AEPSILON)%3B%0A%7D">Run</a></pre> </div><h4 id='method.log' class="method"><span id='log.v' class='invisible'><code>fn <a href='#method.log' class='fnname'>log</a>(self, base: <a class="primitive" href="primitive.f32.html">f32</a>) -> <a class="primitive" href="primitive.f32.html">f32</a></code></span></h4> <div class='docblock'><p>Returns the logarithm of the number with respect to an arbitrary base.</p> <pre class="rust rust-example-rendered"> <span class="kw">use</span> <span class="ident">std</span>::<span class="ident">f32</span>; <span class="kw">let</span> <span class="ident">ten</span> <span class="op">=</span> <span class="number">10.0f32</span>; <span class="kw">let</span> <span class="ident">two</span> <span class="op">=</span> <span class="number">2.0f32</span>; <span class="comment">// log10(10) - 1 == 0</span> <span class="kw">let</span> <span class="ident">abs_difference_10</span> <span class="op">=</span> (<span class="ident">ten</span>.<span class="ident">log</span>(<span class="number">10.0</span>) <span class="op">-</span> <span class="number">1.0</span>).<span class="ident">abs</span>(); <span class="comment">// log2(2) - 1 == 0</span> <span class="kw">let</span> <span class="ident">abs_difference_2</span> <span class="op">=</span> (<span class="ident">two</span>.<span class="ident">log</span>(<span class="number">2.0</span>) <span class="op">-</span> <span class="number">1.0</span>).<span class="ident">abs</span>(); <span class="macro">assert</span><span class="macro">!</span>(<span class="ident">abs_difference_10</span> <span class="op"><=</span> <span class="ident">f32</span>::<span class="ident">EPSILON</span>); <span class="macro">assert</span><span class="macro">!</span>(<span class="ident">abs_difference_2</span> <span class="op"><=</span> <span class="ident">f32</span>::<span class="ident">EPSILON</span>);<a class="test-arrow" target="_blank" href="https://play.rust-lang.org/?code=fn%20main()%20%7B%0Ause%20std%3A%3Af32%3B%0A%0Alet%20ten%20%3D%2010.0f32%3B%0Alet%20two%20%3D%202.0f32%3B%0A%0A%2F%2F%20log10(10)%20-%201%20%3D%3D%200%0Alet%20abs_difference_10%20%3D%20(ten.log(10.0)%20-%201.0).abs()%3B%0A%0A%2F%2F%20log2(2)%20-%201%20%3D%3D%200%0Alet%20abs_difference_2%20%3D%20(two.log(2.0)%20-%201.0).abs()%3B%0A%0Aassert!(abs_difference_10%20%3C%3D%20f32%3A%3AEPSILON)%3B%0Aassert!(abs_difference_2%20%3C%3D%20f32%3A%3AEPSILON)%3B%0A%7D">Run</a></pre> </div><h4 id='method.log2' class="method"><span id='log2.v' class='invisible'><code>fn <a href='#method.log2' class='fnname'>log2</a>(self) -> <a class="primitive" href="primitive.f32.html">f32</a></code></span></h4> <div class='docblock'><p>Returns the base 2 logarithm of the number.</p> <pre class="rust rust-example-rendered"> <span class="kw">use</span> <span class="ident">std</span>::<span class="ident">f32</span>; <span class="kw">let</span> <span class="ident">two</span> <span class="op">=</span> <span class="number">2.0f32</span>; <span class="comment">// log2(2) - 1 == 0</span> <span class="kw">let</span> <span class="ident">abs_difference</span> <span class="op">=</span> (<span class="ident">two</span>.<span class="ident">log2</span>() <span class="op">-</span> <span class="number">1.0</span>).<span class="ident">abs</span>(); <span class="macro">assert</span><span class="macro">!</span>(<span class="ident">abs_difference</span> <span class="op"><=</span> <span class="ident">f32</span>::<span class="ident">EPSILON</span>);<a class="test-arrow" target="_blank" href="https://play.rust-lang.org/?code=fn%20main()%20%7B%0Ause%20std%3A%3Af32%3B%0A%0Alet%20two%20%3D%202.0f32%3B%0A%0A%2F%2F%20log2(2)%20-%201%20%3D%3D%200%0Alet%20abs_difference%20%3D%20(two.log2()%20-%201.0).abs()%3B%0A%0Aassert!(abs_difference%20%3C%3D%20f32%3A%3AEPSILON)%3B%0A%7D">Run</a></pre> </div><h4 id='method.log10' class="method"><span id='log10.v' class='invisible'><code>fn <a href='#method.log10' class='fnname'>log10</a>(self) -> <a class="primitive" href="primitive.f32.html">f32</a></code></span></h4> <div class='docblock'><p>Returns the base 10 logarithm of the number.</p> <pre class="rust rust-example-rendered"> <span class="kw">use</span> <span class="ident">std</span>::<span class="ident">f32</span>; <span class="kw">let</span> <span class="ident">ten</span> <span class="op">=</span> <span class="number">10.0f32</span>; <span class="comment">// log10(10) - 1 == 0</span> <span class="kw">let</span> <span class="ident">abs_difference</span> <span class="op">=</span> (<span class="ident">ten</span>.<span class="ident">log10</span>() <span class="op">-</span> <span class="number">1.0</span>).<span class="ident">abs</span>(); <span class="macro">assert</span><span class="macro">!</span>(<span class="ident">abs_difference</span> <span class="op"><=</span> <span class="ident">f32</span>::<span class="ident">EPSILON</span>);<a class="test-arrow" target="_blank" href="https://play.rust-lang.org/?code=fn%20main()%20%7B%0Ause%20std%3A%3Af32%3B%0A%0Alet%20ten%20%3D%2010.0f32%3B%0A%0A%2F%2F%20log10(10)%20-%201%20%3D%3D%200%0Alet%20abs_difference%20%3D%20(ten.log10()%20-%201.0).abs()%3B%0A%0Aassert!(abs_difference%20%3C%3D%20f32%3A%3AEPSILON)%3B%0A%7D">Run</a></pre> </div><h4 id='method.to_degrees' class="method"><span id='to_degrees.v' class='invisible'><code>fn <a href='#method.to_degrees' class='fnname'>to_degrees</a>(self) -> <a class="primitive" href="primitive.f32.html">f32</a></code><div class='since' title='Stable since Rust version 1.7.0'>1.7.0</div></span></h4> <div class='docblock'><p>Converts radians to degrees.</p> <pre class="rust rust-example-rendered"> <span class="kw">use</span> <span class="ident">std</span>::<span class="ident">f32</span>::{<span class="self">self</span>, <span class="ident">consts</span>}; <span class="kw">let</span> <span class="ident">angle</span> <span class="op">=</span> <span class="ident">consts</span>::<span class="ident">PI</span>; <span class="kw">let</span> <span class="ident">abs_difference</span> <span class="op">=</span> (<span class="ident">angle</span>.<span class="ident">to_degrees</span>() <span class="op">-</span> <span class="number">180.0</span>).<span class="ident">abs</span>(); <span class="macro">assert</span><span class="macro">!</span>(<span class="ident">abs_difference</span> <span class="op"><=</span> <span class="ident">f32</span>::<span class="ident">EPSILON</span>);<a class="test-arrow" target="_blank" href="https://play.rust-lang.org/?code=fn%20main()%20%7B%0Ause%20std%3A%3Af32%3A%3A%7Bself%2C%20consts%7D%3B%0A%0Alet%20angle%20%3D%20consts%3A%3API%3B%0A%0Alet%20abs_difference%20%3D%20(angle.to_degrees()%20-%20180.0).abs()%3B%0A%0Aassert!(abs_difference%20%3C%3D%20f32%3A%3AEPSILON)%3B%0A%7D">Run</a></pre> </div><h4 id='method.to_radians' class="method"><span id='to_radians.v' class='invisible'><code>fn <a href='#method.to_radians' class='fnname'>to_radians</a>(self) -> <a class="primitive" href="primitive.f32.html">f32</a></code><div class='since' title='Stable since Rust version 1.7.0'>1.7.0</div></span></h4> <div class='docblock'><p>Converts degrees to radians.</p> <pre class="rust rust-example-rendered"> <span class="kw">use</span> <span class="ident">std</span>::<span class="ident">f32</span>::{<span class="self">self</span>, <span class="ident">consts</span>}; <span class="kw">let</span> <span class="ident">angle</span> <span class="op">=</span> <span class="number">180.0f32</span>; <span class="kw">let</span> <span class="ident">abs_difference</span> <span class="op">=</span> (<span class="ident">angle</span>.<span class="ident">to_radians</span>() <span class="op">-</span> <span class="ident">consts</span>::<span class="ident">PI</span>).<span class="ident">abs</span>(); <span class="macro">assert</span><span class="macro">!</span>(<span class="ident">abs_difference</span> <span class="op"><=</span> <span class="ident">f32</span>::<span class="ident">EPSILON</span>);<a class="test-arrow" target="_blank" href="https://play.rust-lang.org/?code=fn%20main()%20%7B%0Ause%20std%3A%3Af32%3A%3A%7Bself%2C%20consts%7D%3B%0A%0Alet%20angle%20%3D%20180.0f32%3B%0A%0Alet%20abs_difference%20%3D%20(angle.to_radians()%20-%20consts%3A%3API).abs()%3B%0A%0Aassert!(abs_difference%20%3C%3D%20f32%3A%3AEPSILON)%3B%0A%7D">Run</a></pre> </div><h4 id='method.max' class="method"><span id='max.v' class='invisible'><code>fn <a href='#method.max' class='fnname'>max</a>(self, other: <a class="primitive" href="primitive.f32.html">f32</a>) -> <a class="primitive" href="primitive.f32.html">f32</a></code></span></h4> <div class='docblock'><p>Returns the maximum of the two numbers.</p> <pre class="rust rust-example-rendered"> <span class="kw">let</span> <span class="ident">x</span> <span class="op">=</span> <span class="number">1.0f32</span>; <span class="kw">let</span> <span class="ident">y</span> <span class="op">=</span> <span class="number">2.0f32</span>; <span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">x</span>.<span class="ident">max</span>(<span class="ident">y</span>), <span class="ident">y</span>);<a class="test-arrow" target="_blank" href="https://play.rust-lang.org/?code=fn%20main()%20%7B%0Alet%20x%20%3D%201.0f32%3B%0Alet%20y%20%3D%202.0f32%3B%0A%0Aassert_eq!(x.max(y)%2C%20y)%3B%0A%7D">Run</a></pre> <p>If one of the arguments is NaN, then the other argument is returned.</p> </div><h4 id='method.min' class="method"><span id='min.v' class='invisible'><code>fn <a href='#method.min' class='fnname'>min</a>(self, other: <a class="primitive" href="primitive.f32.html">f32</a>) -> <a class="primitive" href="primitive.f32.html">f32</a></code></span></h4> <div class='docblock'><p>Returns the minimum of the two numbers.</p> <pre class="rust rust-example-rendered"> <span class="kw">let</span> <span class="ident">x</span> <span class="op">=</span> <span class="number">1.0f32</span>; <span class="kw">let</span> <span class="ident">y</span> <span class="op">=</span> <span class="number">2.0f32</span>; <span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">x</span>.<span class="ident">min</span>(<span class="ident">y</span>), <span class="ident">x</span>);<a class="test-arrow" target="_blank" href="https://play.rust-lang.org/?code=fn%20main()%20%7B%0Alet%20x%20%3D%201.0f32%3B%0Alet%20y%20%3D%202.0f32%3B%0A%0Aassert_eq!(x.min(y)%2C%20x)%3B%0A%7D">Run</a></pre> <p>If one of the arguments is NaN, then the other argument is returned.</p> </div><h4 id='method.abs_sub' class="method"><span id='abs_sub.v' class='invisible'><code>fn <a href='#method.abs_sub' class='fnname'>abs_sub</a>(self, other: <a class="primitive" href="primitive.f32.html">f32</a>) -> <a class="primitive" href="primitive.f32.html">f32</a></code></span></h4> <div class='stability'><div class='stab deprecated'>Deprecated since 1.10.0<p>: you probably meant <code>(self - other).abs()</code>: this operation is <code>(self - other).max(0.0)</code> (also known as <code>fdimf</code> in C). If you truly need the positive difference, consider using that expression or the C function <code>fdimf</code>, depending on how you wish to handle NaN (please consider filing an issue describing your use-case too).</p> </div></div><div class='docblock'><p>The positive difference of two numbers.</p> <ul> <li>If <code>self <= other</code>: <code>0:0</code></li> <li>Else: <code>self - other</code></li> </ul> <pre class="rust rust-example-rendered"> <span class="kw">use</span> <span class="ident">std</span>::<span class="ident">f32</span>; <span class="kw">let</span> <span class="ident">x</span> <span class="op">=</span> <span class="number">3.0f32</span>; <span class="kw">let</span> <span class="ident">y</span> <span class="op">=</span> <span class="op">-</span><span class="number">3.0f32</span>; <span class="kw">let</span> <span class="ident">abs_difference_x</span> <span class="op">=</span> (<span class="ident">x</span>.<span class="ident">abs_sub</span>(<span class="number">1.0</span>) <span class="op">-</span> <span class="number">2.0</span>).<span class="ident">abs</span>(); <span class="kw">let</span> <span class="ident">abs_difference_y</span> <span class="op">=</span> (<span class="ident">y</span>.<span class="ident">abs_sub</span>(<span class="number">1.0</span>) <span class="op">-</span> <span class="number">0.0</span>).<span class="ident">abs</span>(); <span class="macro">assert</span><span class="macro">!</span>(<span class="ident">abs_difference_x</span> <span class="op"><=</span> <span class="ident">f32</span>::<span class="ident">EPSILON</span>); <span class="macro">assert</span><span class="macro">!</span>(<span class="ident">abs_difference_y</span> <span class="op"><=</span> <span class="ident">f32</span>::<span class="ident">EPSILON</span>);<a class="test-arrow" target="_blank" href="https://play.rust-lang.org/?code=fn%20main()%20%7B%0Ause%20std%3A%3Af32%3B%0A%0Alet%20x%20%3D%203.0f32%3B%0Alet%20y%20%3D%20-3.0f32%3B%0A%0Alet%20abs_difference_x%20%3D%20(x.abs_sub(1.0)%20-%202.0).abs()%3B%0Alet%20abs_difference_y%20%3D%20(y.abs_sub(1.0)%20-%200.0).abs()%3B%0A%0Aassert!(abs_difference_x%20%3C%3D%20f32%3A%3AEPSILON)%3B%0Aassert!(abs_difference_y%20%3C%3D%20f32%3A%3AEPSILON)%3B%0A%7D">Run</a></pre> </div><h4 id='method.cbrt' class="method"><span id='cbrt.v' class='invisible'><code>fn <a href='#method.cbrt' class='fnname'>cbrt</a>(self) -> <a class="primitive" href="primitive.f32.html">f32</a></code></span></h4> <div class='docblock'><p>Takes the cubic root of a number.</p> <pre class="rust rust-example-rendered"> <span class="kw">use</span> <span class="ident">std</span>::<span class="ident">f32</span>; <span class="kw">let</span> <span class="ident">x</span> <span class="op">=</span> <span class="number">8.0f32</span>; <span class="comment">// x^(1/3) - 2 == 0</span> <span class="kw">let</span> <span class="ident">abs_difference</span> <span class="op">=</span> (<span class="ident">x</span>.<span class="ident">cbrt</span>() <span class="op">-</span> <span class="number">2.0</span>).<span class="ident">abs</span>(); <span class="macro">assert</span><span class="macro">!</span>(<span class="ident">abs_difference</span> <span class="op"><=</span> <span class="ident">f32</span>::<span class="ident">EPSILON</span>);<a class="test-arrow" target="_blank" href="https://play.rust-lang.org/?code=fn%20main()%20%7B%0Ause%20std%3A%3Af32%3B%0A%0Alet%20x%20%3D%208.0f32%3B%0A%0A%2F%2F%20x%5E(1%2F3)%20-%202%20%3D%3D%200%0Alet%20abs_difference%20%3D%20(x.cbrt()%20-%202.0).abs()%3B%0A%0Aassert!(abs_difference%20%3C%3D%20f32%3A%3AEPSILON)%3B%0A%7D">Run</a></pre> </div><h4 id='method.hypot' class="method"><span id='hypot.v' class='invisible'><code>fn <a href='#method.hypot' class='fnname'>hypot</a>(self, other: <a class="primitive" href="primitive.f32.html">f32</a>) -> <a class="primitive" href="primitive.f32.html">f32</a></code></span></h4> <div class='docblock'><p>Calculates the length of the hypotenuse of a right-angle triangle given legs of length <code>x</code> and <code>y</code>.</p> <pre class="rust rust-example-rendered"> <span class="kw">use</span> <span class="ident">std</span>::<span class="ident">f32</span>; <span class="kw">let</span> <span class="ident">x</span> <span class="op">=</span> <span class="number">2.0f32</span>; <span class="kw">let</span> <span class="ident">y</span> <span class="op">=</span> <span class="number">3.0f32</span>; <span class="comment">// sqrt(x^2 + y^2)</span> <span class="kw">let</span> <span class="ident">abs_difference</span> <span class="op">=</span> (<span class="ident">x</span>.<span class="ident">hypot</span>(<span class="ident">y</span>) <span class="op">-</span> (<span class="ident">x</span>.<span class="ident">powi</span>(<span class="number">2</span>) <span class="op">+</span> <span class="ident">y</span>.<span class="ident">powi</span>(<span class="number">2</span>)).<span class="ident">sqrt</span>()).<span class="ident">abs</span>(); <span class="macro">assert</span><span class="macro">!</span>(<span class="ident">abs_difference</span> <span class="op"><=</span> <span class="ident">f32</span>::<span class="ident">EPSILON</span>);<a class="test-arrow" target="_blank" href="https://play.rust-lang.org/?code=fn%20main()%20%7B%0Ause%20std%3A%3Af32%3B%0A%0Alet%20x%20%3D%202.0f32%3B%0Alet%20y%20%3D%203.0f32%3B%0A%0A%2F%2F%20sqrt(x%5E2%20%2B%20y%5E2)%0Alet%20abs_difference%20%3D%20(x.hypot(y)%20-%20(x.powi(2)%20%2B%20y.powi(2)).sqrt()).abs()%3B%0A%0Aassert!(abs_difference%20%3C%3D%20f32%3A%3AEPSILON)%3B%0A%7D">Run</a></pre> </div><h4 id='method.sin' class="method"><span id='sin.v' class='invisible'><code>fn <a href='#method.sin' class='fnname'>sin</a>(self) -> <a class="primitive" href="primitive.f32.html">f32</a></code></span></h4> <div class='docblock'><p>Computes the sine of a number (in radians).</p> <pre class="rust rust-example-rendered"> <span class="kw">use</span> <span class="ident">std</span>::<span class="ident">f32</span>; <span class="kw">let</span> <span class="ident">x</span> <span class="op">=</span> <span class="ident">f32</span>::<span class="ident">consts</span>::<span class="ident">PI</span><span class="op">/</span><span class="number">2.0</span>; <span class="kw">let</span> <span class="ident">abs_difference</span> <span class="op">=</span> (<span class="ident">x</span>.<span class="ident">sin</span>() <span class="op">-</span> <span class="number">1.0</span>).<span class="ident">abs</span>(); <span class="macro">assert</span><span class="macro">!</span>(<span class="ident">abs_difference</span> <span class="op"><=</span> <span class="ident">f32</span>::<span class="ident">EPSILON</span>);<a class="test-arrow" target="_blank" href="https://play.rust-lang.org/?code=fn%20main()%20%7B%0Ause%20std%3A%3Af32%3B%0A%0Alet%20x%20%3D%20f32%3A%3Aconsts%3A%3API%2F2.0%3B%0A%0Alet%20abs_difference%20%3D%20(x.sin()%20-%201.0).abs()%3B%0A%0Aassert!(abs_difference%20%3C%3D%20f32%3A%3AEPSILON)%3B%0A%7D">Run</a></pre> </div><h4 id='method.cos' class="method"><span id='cos.v' class='invisible'><code>fn <a href='#method.cos' class='fnname'>cos</a>(self) -> <a class="primitive" href="primitive.f32.html">f32</a></code></span></h4> <div class='docblock'><p>Computes the cosine of a number (in radians).</p> <pre class="rust rust-example-rendered"> <span class="kw">use</span> <span class="ident">std</span>::<span class="ident">f32</span>; <span class="kw">let</span> <span class="ident">x</span> <span class="op">=</span> <span class="number">2.0</span><span class="kw-2">*</span><span class="ident">f32</span>::<span class="ident">consts</span>::<span class="ident">PI</span>; <span class="kw">let</span> <span class="ident">abs_difference</span> <span class="op">=</span> (<span class="ident">x</span>.<span class="ident">cos</span>() <span class="op">-</span> <span class="number">1.0</span>).<span class="ident">abs</span>(); <span class="macro">assert</span><span class="macro">!</span>(<span class="ident">abs_difference</span> <span class="op"><=</span> <span class="ident">f32</span>::<span class="ident">EPSILON</span>);<a class="test-arrow" target="_blank" href="https://play.rust-lang.org/?code=fn%20main()%20%7B%0Ause%20std%3A%3Af32%3B%0A%0Alet%20x%20%3D%202.0*f32%3A%3Aconsts%3A%3API%3B%0A%0Alet%20abs_difference%20%3D%20(x.cos()%20-%201.0).abs()%3B%0A%0Aassert!(abs_difference%20%3C%3D%20f32%3A%3AEPSILON)%3B%0A%7D">Run</a></pre> </div><h4 id='method.tan' class="method"><span id='tan.v' class='invisible'><code>fn <a href='#method.tan' class='fnname'>tan</a>(self) -> <a class="primitive" href="primitive.f32.html">f32</a></code></span></h4> <div class='docblock'><p>Computes the tangent of a number (in radians).</p> <pre class="rust rust-example-rendered"> <span class="kw">use</span> <span class="ident">std</span>::<span class="ident">f32</span>; <span class="kw">let</span> <span class="ident">x</span> <span class="op">=</span> <span class="ident">f32</span>::<span class="ident">consts</span>::<span class="ident">PI</span> <span class="op">/</span> <span class="number">4.0</span>; <span class="kw">let</span> <span class="ident">abs_difference</span> <span class="op">=</span> (<span class="ident">x</span>.<span class="ident">tan</span>() <span class="op">-</span> <span class="number">1.0</span>).<span class="ident">abs</span>(); <span class="macro">assert</span><span class="macro">!</span>(<span class="ident">abs_difference</span> <span class="op"><=</span> <span class="ident">f32</span>::<span class="ident">EPSILON</span>);<a class="test-arrow" target="_blank" href="https://play.rust-lang.org/?code=fn%20main()%20%7B%0Ause%20std%3A%3Af32%3B%0A%0Alet%20x%20%3D%20f32%3A%3Aconsts%3A%3API%20%2F%204.0%3B%0Alet%20abs_difference%20%3D%20(x.tan()%20-%201.0).abs()%3B%0A%0Aassert!(abs_difference%20%3C%3D%20f32%3A%3AEPSILON)%3B%0A%7D">Run</a></pre> </div><h4 id='method.asin' class="method"><span id='asin.v' class='invisible'><code>fn <a href='#method.asin' class='fnname'>asin</a>(self) -> <a class="primitive" href="primitive.f32.html">f32</a></code></span></h4> <div class='docblock'><p>Computes the arcsine of a number. Return value is in radians in the range [-pi/2, pi/2] or NaN if the number is outside the range [-1, 1].</p> <pre class="rust rust-example-rendered"> <span class="kw">use</span> <span class="ident">std</span>::<span class="ident">f32</span>; <span class="kw">let</span> <span class="ident">f</span> <span class="op">=</span> <span class="ident">f32</span>::<span class="ident">consts</span>::<span class="ident">PI</span> <span class="op">/</span> <span class="number">2.0</span>; <span class="comment">// asin(sin(pi/2))</span> <span class="kw">let</span> <span class="ident">abs_difference</span> <span class="op">=</span> (<span class="ident">f</span>.<span class="ident">sin</span>().<span class="ident">asin</span>() <span class="op">-</span> <span class="ident">f32</span>::<span class="ident">consts</span>::<span class="ident">PI</span> <span class="op">/</span> <span class="number">2.0</span>).<span class="ident">abs</span>(); <span class="macro">assert</span><span class="macro">!</span>(<span class="ident">abs_difference</span> <span class="op"><=</span> <span class="ident">f32</span>::<span class="ident">EPSILON</span>);<a class="test-arrow" target="_blank" href="https://play.rust-lang.org/?code=fn%20main()%20%7B%0Ause%20std%3A%3Af32%3B%0A%0Alet%20f%20%3D%20f32%3A%3Aconsts%3A%3API%20%2F%202.0%3B%0A%0A%2F%2F%20asin(sin(pi%2F2))%0Alet%20abs_difference%20%3D%20(f.sin().asin()%20-%20f32%3A%3Aconsts%3A%3API%20%2F%202.0).abs()%3B%0A%0Aassert!(abs_difference%20%3C%3D%20f32%3A%3AEPSILON)%3B%0A%7D">Run</a></pre> </div><h4 id='method.acos' class="method"><span id='acos.v' class='invisible'><code>fn <a href='#method.acos' class='fnname'>acos</a>(self) -> <a class="primitive" href="primitive.f32.html">f32</a></code></span></h4> <div class='docblock'><p>Computes the arccosine of a number. Return value is in radians in the range [0, pi] or NaN if the number is outside the range [-1, 1].</p> <pre class="rust rust-example-rendered"> <span class="kw">use</span> <span class="ident">std</span>::<span class="ident">f32</span>; <span class="kw">let</span> <span class="ident">f</span> <span class="op">=</span> <span class="ident">f32</span>::<span class="ident">consts</span>::<span class="ident">PI</span> <span class="op">/</span> <span class="number">4.0</span>; <span class="comment">// acos(cos(pi/4))</span> <span class="kw">let</span> <span class="ident">abs_difference</span> <span class="op">=</span> (<span class="ident">f</span>.<span class="ident">cos</span>().<span class="ident">acos</span>() <span class="op">-</span> <span class="ident">f32</span>::<span class="ident">consts</span>::<span class="ident">PI</span> <span class="op">/</span> <span class="number">4.0</span>).<span class="ident">abs</span>(); <span class="macro">assert</span><span class="macro">!</span>(<span class="ident">abs_difference</span> <span class="op"><=</span> <span class="ident">f32</span>::<span class="ident">EPSILON</span>);<a class="test-arrow" target="_blank" href="https://play.rust-lang.org/?code=fn%20main()%20%7B%0Ause%20std%3A%3Af32%3B%0A%0Alet%20f%20%3D%20f32%3A%3Aconsts%3A%3API%20%2F%204.0%3B%0A%0A%2F%2F%20acos(cos(pi%2F4))%0Alet%20abs_difference%20%3D%20(f.cos().acos()%20-%20f32%3A%3Aconsts%3A%3API%20%2F%204.0).abs()%3B%0A%0Aassert!(abs_difference%20%3C%3D%20f32%3A%3AEPSILON)%3B%0A%7D">Run</a></pre> </div><h4 id='method.atan' class="method"><span id='atan.v' class='invisible'><code>fn <a href='#method.atan' class='fnname'>atan</a>(self) -> <a class="primitive" href="primitive.f32.html">f32</a></code></span></h4> <div class='docblock'><p>Computes the arctangent of a number. Return value is in radians in the range [-pi/2, pi/2];</p> <pre class="rust rust-example-rendered"> <span class="kw">use</span> <span class="ident">std</span>::<span class="ident">f32</span>; <span class="kw">let</span> <span class="ident">f</span> <span class="op">=</span> <span class="number">1.0f32</span>; <span class="comment">// atan(tan(1))</span> <span class="kw">let</span> <span class="ident">abs_difference</span> <span class="op">=</span> (<span class="ident">f</span>.<span class="ident">tan</span>().<span class="ident">atan</span>() <span class="op">-</span> <span class="number">1.0</span>).<span class="ident">abs</span>(); <span class="macro">assert</span><span class="macro">!</span>(<span class="ident">abs_difference</span> <span class="op"><=</span> <span class="ident">f32</span>::<span class="ident">EPSILON</span>);<a class="test-arrow" target="_blank" href="https://play.rust-lang.org/?code=fn%20main()%20%7B%0Ause%20std%3A%3Af32%3B%0A%0Alet%20f%20%3D%201.0f32%3B%0A%0A%2F%2F%20atan(tan(1))%0Alet%20abs_difference%20%3D%20(f.tan().atan()%20-%201.0).abs()%3B%0A%0Aassert!(abs_difference%20%3C%3D%20f32%3A%3AEPSILON)%3B%0A%7D">Run</a></pre> </div><h4 id='method.atan2' class="method"><span id='atan2.v' class='invisible'><code>fn <a href='#method.atan2' class='fnname'>atan2</a>(self, other: <a class="primitive" href="primitive.f32.html">f32</a>) -> <a class="primitive" href="primitive.f32.html">f32</a></code></span></h4> <div class='docblock'><p>Computes the four quadrant arctangent of <code>self</code> (<code>y</code>) and <code>other</code> (<code>x</code>).</p> <ul> <li><code>x = 0</code>, <code>y = 0</code>: <code>0</code></li> <li><code>x >= 0</code>: <code>arctan(y/x)</code> -> <code>[-pi/2, pi/2]</code></li> <li><code>y >= 0</code>: <code>arctan(y/x) + pi</code> -> <code>(pi/2, pi]</code></li> <li><code>y < 0</code>: <code>arctan(y/x) - pi</code> -> <code>(-pi, -pi/2)</code></li> </ul> <pre class="rust rust-example-rendered"> <span class="kw">use</span> <span class="ident">std</span>::<span class="ident">f32</span>; <span class="kw">let</span> <span class="ident">pi</span> <span class="op">=</span> <span class="ident">f32</span>::<span class="ident">consts</span>::<span class="ident">PI</span>; <span class="comment">// All angles from horizontal right (+x)</span> <span class="comment">// 45 deg counter-clockwise</span> <span class="kw">let</span> <span class="ident">x1</span> <span class="op">=</span> <span class="number">3.0f32</span>; <span class="kw">let</span> <span class="ident">y1</span> <span class="op">=</span> <span class="op">-</span><span class="number">3.0f32</span>; <span class="comment">// 135 deg clockwise</span> <span class="kw">let</span> <span class="ident">x2</span> <span class="op">=</span> <span class="op">-</span><span class="number">3.0f32</span>; <span class="kw">let</span> <span class="ident">y2</span> <span class="op">=</span> <span class="number">3.0f32</span>; <span class="kw">let</span> <span class="ident">abs_difference_1</span> <span class="op">=</span> (<span class="ident">y1</span>.<span class="ident">atan2</span>(<span class="ident">x1</span>) <span class="op">-</span> (<span class="op">-</span><span class="ident">pi</span><span class="op">/</span><span class="number">4.0</span>)).<span class="ident">abs</span>(); <span class="kw">let</span> <span class="ident">abs_difference_2</span> <span class="op">=</span> (<span class="ident">y2</span>.<span class="ident">atan2</span>(<span class="ident">x2</span>) <span class="op">-</span> <span class="number">3.0</span><span class="kw-2">*</span><span class="ident">pi</span><span class="op">/</span><span class="number">4.0</span>).<span class="ident">abs</span>(); <span class="macro">assert</span><span class="macro">!</span>(<span class="ident">abs_difference_1</span> <span class="op"><=</span> <span class="ident">f32</span>::<span class="ident">EPSILON</span>); <span class="macro">assert</span><span class="macro">!</span>(<span class="ident">abs_difference_2</span> <span class="op"><=</span> <span class="ident">f32</span>::<span class="ident">EPSILON</span>);<a class="test-arrow" target="_blank" href="https://play.rust-lang.org/?code=fn%20main()%20%7B%0Ause%20std%3A%3Af32%3B%0A%0Alet%20pi%20%3D%20f32%3A%3Aconsts%3A%3API%3B%0A%2F%2F%20All%20angles%20from%20horizontal%20right%20(%2Bx)%0A%2F%2F%2045%20deg%20counter-clockwise%0Alet%20x1%20%3D%203.0f32%3B%0Alet%20y1%20%3D%20-3.0f32%3B%0A%0A%2F%2F%20135%20deg%20clockwise%0Alet%20x2%20%3D%20-3.0f32%3B%0Alet%20y2%20%3D%203.0f32%3B%0A%0Alet%20abs_difference_1%20%3D%20(y1.atan2(x1)%20-%20(-pi%2F4.0)).abs()%3B%0Alet%20abs_difference_2%20%3D%20(y2.atan2(x2)%20-%203.0*pi%2F4.0).abs()%3B%0A%0Aassert!(abs_difference_1%20%3C%3D%20f32%3A%3AEPSILON)%3B%0Aassert!(abs_difference_2%20%3C%3D%20f32%3A%3AEPSILON)%3B%0A%7D">Run</a></pre> </div><h4 id='method.sin_cos' class="method"><span id='sin_cos.v' class='invisible'><code>fn <a href='#method.sin_cos' class='fnname'>sin_cos</a>(self) -> <a class="primitive" href="primitive.tuple.html">(</a><a class="primitive" href="primitive.f32.html">f32</a>, <a class="primitive" href="primitive.f32.html">f32</a><a class="primitive" href="primitive.tuple.html">)</a></code></span></h4> <div class='docblock'><p>Simultaneously computes the sine and cosine of the number, <code>x</code>. Returns <code>(sin(x), cos(x))</code>.</p> <pre class="rust rust-example-rendered"> <span class="kw">use</span> <span class="ident">std</span>::<span class="ident">f32</span>; <span class="kw">let</span> <span class="ident">x</span> <span class="op">=</span> <span class="ident">f32</span>::<span class="ident">consts</span>::<span class="ident">PI</span><span class="op">/</span><span class="number">4.0</span>; <span class="kw">let</span> <span class="ident">f</span> <span class="op">=</span> <span class="ident">x</span>.<span class="ident">sin_cos</span>(); <span class="kw">let</span> <span class="ident">abs_difference_0</span> <span class="op">=</span> (<span class="ident">f</span>.<span class="number">0</span> <span class="op">-</span> <span class="ident">x</span>.<span class="ident">sin</span>()).<span class="ident">abs</span>(); <span class="kw">let</span> <span class="ident">abs_difference_1</span> <span class="op">=</span> (<span class="ident">f</span>.<span class="number">1</span> <span class="op">-</span> <span class="ident">x</span>.<span class="ident">cos</span>()).<span class="ident">abs</span>(); <span class="macro">assert</span><span class="macro">!</span>(<span class="ident">abs_difference_0</span> <span class="op"><=</span> <span class="ident">f32</span>::<span class="ident">EPSILON</span>); <span class="macro">assert</span><span class="macro">!</span>(<span class="ident">abs_difference_1</span> <span class="op"><=</span> <span class="ident">f32</span>::<span class="ident">EPSILON</span>);<a class="test-arrow" target="_blank" href="https://play.rust-lang.org/?code=fn%20main()%20%7B%0Ause%20std%3A%3Af32%3B%0A%0Alet%20x%20%3D%20f32%3A%3Aconsts%3A%3API%2F4.0%3B%0Alet%20f%20%3D%20x.sin_cos()%3B%0A%0Alet%20abs_difference_0%20%3D%20(f.0%20-%20x.sin()).abs()%3B%0Alet%20abs_difference_1%20%3D%20(f.1%20-%20x.cos()).abs()%3B%0A%0Aassert!(abs_difference_0%20%3C%3D%20f32%3A%3AEPSILON)%3B%0Aassert!(abs_difference_1%20%3C%3D%20f32%3A%3AEPSILON)%3B%0A%7D">Run</a></pre> </div><h4 id='method.exp_m1' class="method"><span id='exp_m1.v' class='invisible'><code>fn <a href='#method.exp_m1' class='fnname'>exp_m1</a>(self) -> <a class="primitive" href="primitive.f32.html">f32</a></code></span></h4> <div class='docblock'><p>Returns <code>e^(self) - 1</code> in a way that is accurate even if the number is close to zero.</p> <pre class="rust rust-example-rendered"> <span class="kw">use</span> <span class="ident">std</span>::<span class="ident">f32</span>; <span class="kw">let</span> <span class="ident">x</span> <span class="op">=</span> <span class="number">6.0f32</span>; <span class="comment">// e^(ln(6)) - 1</span> <span class="kw">let</span> <span class="ident">abs_difference</span> <span class="op">=</span> (<span class="ident">x</span>.<span class="ident">ln</span>().<span class="ident">exp_m1</span>() <span class="op">-</span> <span class="number">5.0</span>).<span class="ident">abs</span>(); <span class="macro">assert</span><span class="macro">!</span>(<span class="ident">abs_difference</span> <span class="op"><=</span> <span class="ident">f32</span>::<span class="ident">EPSILON</span>);<a class="test-arrow" target="_blank" href="https://play.rust-lang.org/?code=fn%20main()%20%7B%0Ause%20std%3A%3Af32%3B%0A%0Alet%20x%20%3D%206.0f32%3B%0A%0A%2F%2F%20e%5E(ln(6))%20-%201%0Alet%20abs_difference%20%3D%20(x.ln().exp_m1()%20-%205.0).abs()%3B%0A%0Aassert!(abs_difference%20%3C%3D%20f32%3A%3AEPSILON)%3B%0A%7D">Run</a></pre> </div><h4 id='method.ln_1p' class="method"><span id='ln_1p.v' class='invisible'><code>fn <a href='#method.ln_1p' class='fnname'>ln_1p</a>(self) -> <a class="primitive" href="primitive.f32.html">f32</a></code></span></h4> <div class='docblock'><p>Returns <code>ln(1+n)</code> (natural logarithm) more accurately than if the operations were performed separately.</p> <pre class="rust rust-example-rendered"> <span class="kw">use</span> <span class="ident">std</span>::<span class="ident">f32</span>; <span class="kw">let</span> <span class="ident">x</span> <span class="op">=</span> <span class="ident">f32</span>::<span class="ident">consts</span>::<span class="ident">E</span> <span class="op">-</span> <span class="number">1.0</span>; <span class="comment">// ln(1 + (e - 1)) == ln(e) == 1</span> <span class="kw">let</span> <span class="ident">abs_difference</span> <span class="op">=</span> (<span class="ident">x</span>.<span class="ident">ln_1p</span>() <span class="op">-</span> <span class="number">1.0</span>).<span class="ident">abs</span>(); <span class="macro">assert</span><span class="macro">!</span>(<span class="ident">abs_difference</span> <span class="op"><=</span> <span class="ident">f32</span>::<span class="ident">EPSILON</span>);<a class="test-arrow" target="_blank" href="https://play.rust-lang.org/?code=fn%20main()%20%7B%0Ause%20std%3A%3Af32%3B%0A%0Alet%20x%20%3D%20f32%3A%3Aconsts%3A%3AE%20-%201.0%3B%0A%0A%2F%2F%20ln(1%20%2B%20(e%20-%201))%20%3D%3D%20ln(e)%20%3D%3D%201%0Alet%20abs_difference%20%3D%20(x.ln_1p()%20-%201.0).abs()%3B%0A%0Aassert!(abs_difference%20%3C%3D%20f32%3A%3AEPSILON)%3B%0A%7D">Run</a></pre> </div><h4 id='method.sinh' class="method"><span id='sinh.v' class='invisible'><code>fn <a href='#method.sinh' class='fnname'>sinh</a>(self) -> <a class="primitive" href="primitive.f32.html">f32</a></code></span></h4> <div class='docblock'><p>Hyperbolic sine function.</p> <pre class="rust rust-example-rendered"> <span class="kw">use</span> <span class="ident">std</span>::<span class="ident">f32</span>; <span class="kw">let</span> <span class="ident">e</span> <span class="op">=</span> <span class="ident">f32</span>::<span class="ident">consts</span>::<span class="ident">E</span>; <span class="kw">let</span> <span class="ident">x</span> <span class="op">=</span> <span class="number">1.0f32</span>; <span class="kw">let</span> <span class="ident">f</span> <span class="op">=</span> <span class="ident">x</span>.<span class="ident">sinh</span>(); <span class="comment">// Solving sinh() at 1 gives `(e^2-1)/(2e)`</span> <span class="kw">let</span> <span class="ident">g</span> <span class="op">=</span> (<span class="ident">e</span><span class="kw-2">*</span><span class="ident">e</span> <span class="op">-</span> <span class="number">1.0</span>)<span class="op">/</span>(<span class="number">2.0</span><span class="kw-2">*</span><span class="ident">e</span>); <span class="kw">let</span> <span class="ident">abs_difference</span> <span class="op">=</span> (<span class="ident">f</span> <span class="op">-</span> <span class="ident">g</span>).<span class="ident">abs</span>(); <span class="macro">assert</span><span class="macro">!</span>(<span class="ident">abs_difference</span> <span class="op"><=</span> <span class="ident">f32</span>::<span class="ident">EPSILON</span>);<a class="test-arrow" target="_blank" href="https://play.rust-lang.org/?code=fn%20main()%20%7B%0Ause%20std%3A%3Af32%3B%0A%0Alet%20e%20%3D%20f32%3A%3Aconsts%3A%3AE%3B%0Alet%20x%20%3D%201.0f32%3B%0A%0Alet%20f%20%3D%20x.sinh()%3B%0A%2F%2F%20Solving%20sinh()%20at%201%20gives%20%60(e%5E2-1)%2F(2e)%60%0Alet%20g%20%3D%20(e*e%20-%201.0)%2F(2.0*e)%3B%0Alet%20abs_difference%20%3D%20(f%20-%20g).abs()%3B%0A%0Aassert!(abs_difference%20%3C%3D%20f32%3A%3AEPSILON)%3B%0A%7D">Run</a></pre> </div><h4 id='method.cosh' class="method"><span id='cosh.v' class='invisible'><code>fn <a href='#method.cosh' class='fnname'>cosh</a>(self) -> <a class="primitive" href="primitive.f32.html">f32</a></code></span></h4> <div class='docblock'><p>Hyperbolic cosine function.</p> <pre class="rust rust-example-rendered"> <span class="kw">use</span> <span class="ident">std</span>::<span class="ident">f32</span>; <span class="kw">let</span> <span class="ident">e</span> <span class="op">=</span> <span class="ident">f32</span>::<span class="ident">consts</span>::<span class="ident">E</span>; <span class="kw">let</span> <span class="ident">x</span> <span class="op">=</span> <span class="number">1.0f32</span>; <span class="kw">let</span> <span class="ident">f</span> <span class="op">=</span> <span class="ident">x</span>.<span class="ident">cosh</span>(); <span class="comment">// Solving cosh() at 1 gives this result</span> <span class="kw">let</span> <span class="ident">g</span> <span class="op">=</span> (<span class="ident">e</span><span class="kw-2">*</span><span class="ident">e</span> <span class="op">+</span> <span class="number">1.0</span>)<span class="op">/</span>(<span class="number">2.0</span><span class="kw-2">*</span><span class="ident">e</span>); <span class="kw">let</span> <span class="ident">abs_difference</span> <span class="op">=</span> (<span class="ident">f</span> <span class="op">-</span> <span class="ident">g</span>).<span class="ident">abs</span>(); <span class="comment">// Same result</span> <span class="macro">assert</span><span class="macro">!</span>(<span class="ident">abs_difference</span> <span class="op"><=</span> <span class="ident">f32</span>::<span class="ident">EPSILON</span>);<a class="test-arrow" target="_blank" href="https://play.rust-lang.org/?code=fn%20main()%20%7B%0Ause%20std%3A%3Af32%3B%0A%0Alet%20e%20%3D%20f32%3A%3Aconsts%3A%3AE%3B%0Alet%20x%20%3D%201.0f32%3B%0Alet%20f%20%3D%20x.cosh()%3B%0A%2F%2F%20Solving%20cosh()%20at%201%20gives%20this%20result%0Alet%20g%20%3D%20(e*e%20%2B%201.0)%2F(2.0*e)%3B%0Alet%20abs_difference%20%3D%20(f%20-%20g).abs()%3B%0A%0A%2F%2F%20Same%20result%0Aassert!(abs_difference%20%3C%3D%20f32%3A%3AEPSILON)%3B%0A%7D">Run</a></pre> </div><h4 id='method.tanh' class="method"><span id='tanh.v' class='invisible'><code>fn <a href='#method.tanh' class='fnname'>tanh</a>(self) -> <a class="primitive" href="primitive.f32.html">f32</a></code></span></h4> <div class='docblock'><p>Hyperbolic tangent function.</p> <pre class="rust rust-example-rendered"> <span class="kw">use</span> <span class="ident">std</span>::<span class="ident">f32</span>; <span class="kw">let</span> <span class="ident">e</span> <span class="op">=</span> <span class="ident">f32</span>::<span class="ident">consts</span>::<span class="ident">E</span>; <span class="kw">let</span> <span class="ident">x</span> <span class="op">=</span> <span class="number">1.0f32</span>; <span class="kw">let</span> <span class="ident">f</span> <span class="op">=</span> <span class="ident">x</span>.<span class="ident">tanh</span>(); <span class="comment">// Solving tanh() at 1 gives `(1 - e^(-2))/(1 + e^(-2))`</span> <span class="kw">let</span> <span class="ident">g</span> <span class="op">=</span> (<span class="number">1.0</span> <span class="op">-</span> <span class="ident">e</span>.<span class="ident">powi</span>(<span class="op">-</span><span class="number">2</span>))<span class="op">/</span>(<span class="number">1.0</span> <span class="op">+</span> <span class="ident">e</span>.<span class="ident">powi</span>(<span class="op">-</span><span class="number">2</span>)); <span class="kw">let</span> <span class="ident">abs_difference</span> <span class="op">=</span> (<span class="ident">f</span> <span class="op">-</span> <span class="ident">g</span>).<span class="ident">abs</span>(); <span class="macro">assert</span><span class="macro">!</span>(<span class="ident">abs_difference</span> <span class="op"><=</span> <span class="ident">f32</span>::<span class="ident">EPSILON</span>);<a class="test-arrow" target="_blank" href="https://play.rust-lang.org/?code=fn%20main()%20%7B%0Ause%20std%3A%3Af32%3B%0A%0Alet%20e%20%3D%20f32%3A%3Aconsts%3A%3AE%3B%0Alet%20x%20%3D%201.0f32%3B%0A%0Alet%20f%20%3D%20x.tanh()%3B%0A%2F%2F%20Solving%20tanh()%20at%201%20gives%20%60(1%20-%20e%5E(-2))%2F(1%20%2B%20e%5E(-2))%60%0Alet%20g%20%3D%20(1.0%20-%20e.powi(-2))%2F(1.0%20%2B%20e.powi(-2))%3B%0Alet%20abs_difference%20%3D%20(f%20-%20g).abs()%3B%0A%0Aassert!(abs_difference%20%3C%3D%20f32%3A%3AEPSILON)%3B%0A%7D">Run</a></pre> </div><h4 id='method.asinh' class="method"><span id='asinh.v' class='invisible'><code>fn <a href='#method.asinh' class='fnname'>asinh</a>(self) -> <a class="primitive" href="primitive.f32.html">f32</a></code></span></h4> <div class='docblock'><p>Inverse hyperbolic sine function.</p> <pre class="rust rust-example-rendered"> <span class="kw">use</span> <span class="ident">std</span>::<span class="ident">f32</span>; <span class="kw">let</span> <span class="ident">x</span> <span class="op">=</span> <span class="number">1.0f32</span>; <span class="kw">let</span> <span class="ident">f</span> <span class="op">=</span> <span class="ident">x</span>.<span class="ident">sinh</span>().<span class="ident">asinh</span>(); <span class="kw">let</span> <span class="ident">abs_difference</span> <span class="op">=</span> (<span class="ident">f</span> <span class="op">-</span> <span class="ident">x</span>).<span class="ident">abs</span>(); <span class="macro">assert</span><span class="macro">!</span>(<span class="ident">abs_difference</span> <span class="op"><=</span> <span class="ident">f32</span>::<span class="ident">EPSILON</span>);<a class="test-arrow" target="_blank" href="https://play.rust-lang.org/?code=fn%20main()%20%7B%0Ause%20std%3A%3Af32%3B%0A%0Alet%20x%20%3D%201.0f32%3B%0Alet%20f%20%3D%20x.sinh().asinh()%3B%0A%0Alet%20abs_difference%20%3D%20(f%20-%20x).abs()%3B%0A%0Aassert!(abs_difference%20%3C%3D%20f32%3A%3AEPSILON)%3B%0A%7D">Run</a></pre> </div><h4 id='method.acosh' class="method"><span id='acosh.v' class='invisible'><code>fn <a href='#method.acosh' class='fnname'>acosh</a>(self) -> <a class="primitive" href="primitive.f32.html">f32</a></code></span></h4> <div class='docblock'><p>Inverse hyperbolic cosine function.</p> <pre class="rust rust-example-rendered"> <span class="kw">use</span> <span class="ident">std</span>::<span class="ident">f32</span>; <span class="kw">let</span> <span class="ident">x</span> <span class="op">=</span> <span class="number">1.0f32</span>; <span class="kw">let</span> <span class="ident">f</span> <span class="op">=</span> <span class="ident">x</span>.<span class="ident">cosh</span>().<span class="ident">acosh</span>(); <span class="kw">let</span> <span class="ident">abs_difference</span> <span class="op">=</span> (<span class="ident">f</span> <span class="op">-</span> <span class="ident">x</span>).<span class="ident">abs</span>(); <span class="macro">assert</span><span class="macro">!</span>(<span class="ident">abs_difference</span> <span class="op"><=</span> <span class="ident">f32</span>::<span class="ident">EPSILON</span>);<a class="test-arrow" target="_blank" href="https://play.rust-lang.org/?code=fn%20main()%20%7B%0Ause%20std%3A%3Af32%3B%0A%0Alet%20x%20%3D%201.0f32%3B%0Alet%20f%20%3D%20x.cosh().acosh()%3B%0A%0Alet%20abs_difference%20%3D%20(f%20-%20x).abs()%3B%0A%0Aassert!(abs_difference%20%3C%3D%20f32%3A%3AEPSILON)%3B%0A%7D">Run</a></pre> </div><h4 id='method.atanh' class="method"><span id='atanh.v' class='invisible'><code>fn <a href='#method.atanh' class='fnname'>atanh</a>(self) -> <a class="primitive" href="primitive.f32.html">f32</a></code></span></h4> <div class='docblock'><p>Inverse hyperbolic tangent function.</p> <pre class="rust rust-example-rendered"> <span class="kw">use</span> <span class="ident">std</span>::<span class="ident">f32</span>; <span class="kw">let</span> <span class="ident">e</span> <span class="op">=</span> <span class="ident">f32</span>::<span class="ident">consts</span>::<span class="ident">E</span>; <span class="kw">let</span> <span class="ident">f</span> <span class="op">=</span> <span class="ident">e</span>.<span class="ident">tanh</span>().<span class="ident">atanh</span>(); <span class="kw">let</span> <span class="ident">abs_difference</span> <span class="op">=</span> (<span class="ident">f</span> <span class="op">-</span> <span class="ident">e</span>).<span class="ident">abs</span>(); <span class="macro">assert</span><span class="macro">!</span>(<span class="ident">abs_difference</span> <span class="op"><=</span> <span class="number">1e-5</span>);<a class="test-arrow" target="_blank" href="https://play.rust-lang.org/?code=fn%20main()%20%7B%0Ause%20std%3A%3Af32%3B%0A%0Alet%20e%20%3D%20f32%3A%3Aconsts%3A%3AE%3B%0Alet%20f%20%3D%20e.tanh().atanh()%3B%0A%0Alet%20abs_difference%20%3D%20(f%20-%20e).abs()%3B%0A%0Aassert!(abs_difference%20%3C%3D%201e-5)%3B%0A%7D">Run</a></pre> </div><h4 id='method.to_bits' class="method"><span id='to_bits.v' class='invisible'><code>fn <a href='#method.to_bits' class='fnname'>to_bits</a>(self) -> <a class="primitive" href="primitive.u32.html">u32</a></code></span></h4> <div class='stability'><div class='stab unstable'><details><summary><span class=microscope>🔬</span> This is a nightly-only experimental API. (<code>float_bits_conv </code><a href="https://github.com/rust-lang/rust/issues/40470">#40470</a>)</summary><p>recently added</p> </details></div></div><div class='docblock'><p>Raw transmutation to <code>u32</code>.</p> <p>Converts the <code>f32</code> into its raw memory representation, similar to the <code>transmute</code> function.</p> <p>Note that this function is distinct from casting.</p> <h1 id='examples' class='section-header'><a href='#examples'>Examples</a></h1> <pre class="rust rust-example-rendered"> <span class="attribute">#<span class="op">!</span>[<span class="ident">feature</span>(<span class="ident">float_bits_conv</span>)]</span> <span class="macro">assert_ne</span><span class="macro">!</span>((<span class="number">1f32</span>).<span class="ident">to_bits</span>(), <span class="number">1f32</span> <span class="kw">as</span> <span class="ident">u32</span>); <span class="comment">// to_bits() is not casting!</span> <span class="macro">assert_eq</span><span class="macro">!</span>((<span class="number">12.5f32</span>).<span class="ident">to_bits</span>(), <span class="number">0x41480000</span>); <a class="test-arrow" target="_blank" href="https://play.rust-lang.org/?code=%23!%5Bfeature(float_bits_conv)%5D%0Afn%20main()%20%7B%0Aassert_ne!((1f32).to_bits()%2C%201f32%20as%20u32)%3B%20%2F%2F%20to_bits()%20is%20not%20casting!%0Aassert_eq!((12.5f32).to_bits()%2C%200x41480000)%3B%0A%7D&version=nightly">Run</a></pre> </div><h4 id='method.from_bits' class="method"><span id='from_bits.v' class='invisible'><code>fn <a href='#method.from_bits' class='fnname'>from_bits</a>(v: <a class="primitive" href="primitive.u32.html">u32</a>) -> Self</code></span></h4> <div class='stability'><div class='stab unstable'><details><summary><span class=microscope>🔬</span> This is a nightly-only experimental API. (<code>float_bits_conv </code><a href="https://github.com/rust-lang/rust/issues/40470">#40470</a>)</summary><p>recently added</p> </details></div></div><div class='docblock'><p>Raw transmutation from <code>u32</code>.</p> <p>Converts the given <code>u32</code> containing the float's raw memory representation into the <code>f32</code> type, similar to the <code>transmute</code> function.</p> <p>There is only one difference to a bare <code>transmute</code>: Due to the implications onto Rust's safety promises being uncertain, if the representation of a signaling NaN "sNaN" float is passed to the function, the implementation is allowed to return a quiet NaN instead.</p> <p>Note that this function is distinct from casting.</p> <h1 id='examples-1' class='section-header'><a href='#examples-1'>Examples</a></h1> <pre class="rust rust-example-rendered"> <span class="attribute">#<span class="op">!</span>[<span class="ident">feature</span>(<span class="ident">float_bits_conv</span>)]</span> <span class="kw">use</span> <span class="ident">std</span>::<span class="ident">f32</span>; <span class="kw">let</span> <span class="ident">v</span> <span class="op">=</span> <span class="ident">f32</span>::<span class="ident">from_bits</span>(<span class="number">0x41480000</span>); <span class="kw">let</span> <span class="ident">difference</span> <span class="op">=</span> (<span class="ident">v</span> <span class="op">-</span> <span class="number">12.5</span>).<span class="ident">abs</span>(); <span class="macro">assert</span><span class="macro">!</span>(<span class="ident">difference</span> <span class="op"><=</span> <span class="number">1e-5</span>); <span class="comment">// Example for a signaling NaN value:</span> <span class="kw">let</span> <span class="ident">snan</span> <span class="op">=</span> <span class="number">0x7F800001</span>; <span class="macro">assert_ne</span><span class="macro">!</span>(<span class="ident">f32</span>::<span class="ident">from_bits</span>(<span class="ident">snan</span>).<span class="ident">to_bits</span>(), <span class="ident">snan</span>);<a class="test-arrow" target="_blank" href="https://play.rust-lang.org/?code=%23!%5Bfeature(float_bits_conv)%5D%0Afn%20main()%20%7B%0Ause%20std%3A%3Af32%3B%0Alet%20v%20%3D%20f32%3A%3Afrom_bits(0x41480000)%3B%0Alet%20difference%20%3D%20(v%20-%2012.5).abs()%3B%0Aassert!(difference%20%3C%3D%201e-5)%3B%0A%2F%2F%20Example%20for%20a%20signaling%20NaN%20value%3A%0Alet%20snan%20%3D%200x7F800001%3B%0Aassert_ne!(f32%3A%3Afrom_bits(snan).to_bits()%2C%20snan)%3B%0A%7D&version=nightly">Run</a></pre> </div></div><h2 id='implementations'>Trait Implementations</h2><h3 class='impl'><span class='in-band'><code>impl<'a> <a class="trait" href="../std/ops/trait.Sub.html" title="trait std::ops::Sub">Sub</a><<a class="primitive" href="primitive.f32.html">f32</a>> for &'a <a class="primitive" href="primitive.f32.html">f32</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/core/internal_macros.rs.html#41-48' title='goto source code'>[src]</a></span></h3> <div class='impl-items'><h4 id='associatedtype.Output' class="type"><span id='Output.t' class='invisible'><code>type <a href='../std/ops/trait.Sub.html#associatedtype.Output' class="type">Output</a> = <<a class="primitive" href="primitive.f32.html">f32</a> as <a class="trait" href="../std/ops/trait.Sub.html" title="trait std::ops::Sub">Sub</a><<a class="primitive" href="primitive.f32.html">f32</a>>>::<a class="trait" href="../std/ops/trait.Sub.html" title="trait std::ops::Sub">Output</a></code></span></h4> <div class='docblock'><p>The resulting type after applying the <code>-</code> operator</p> </div><h4 id='method.sub' class="method"><span id='sub.v' class='invisible'><code>fn <a href='../std/ops/trait.Sub.html#tymethod.sub' class='fnname'>sub</a>(self, other: <a class="primitive" href="primitive.f32.html">f32</a>) -> <<a class="primitive" href="primitive.f32.html">f32</a> as <a class="trait" href="../std/ops/trait.Sub.html" title="trait std::ops::Sub">Sub</a><<a class="primitive" href="primitive.f32.html">f32</a>>>::<a class="trait" href="../std/ops/trait.Sub.html" title="trait std::ops::Sub">Output</a></code></span></h4> <div class='docblock'><p>The method for the <code>-</code> operator</p> </div></div><h3 class='impl'><span class='in-band'><code>impl<'a> <a class="trait" href="../std/ops/trait.Sub.html" title="trait std::ops::Sub">Sub</a><&'a <a class="primitive" href="primitive.f32.html">f32</a>> for <a class="primitive" href="primitive.f32.html">f32</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/core/internal_macros.rs.html#51-58' title='goto source code'>[src]</a></span></h3> <div class='impl-items'><h4 id='associatedtype.Output-1' class="type"><span id='Output.t-1' class='invisible'><code>type <a href='../std/ops/trait.Sub.html#associatedtype.Output' class="type">Output</a> = <<a class="primitive" href="primitive.f32.html">f32</a> as <a class="trait" href="../std/ops/trait.Sub.html" title="trait std::ops::Sub">Sub</a><<a class="primitive" href="primitive.f32.html">f32</a>>>::<a class="trait" href="../std/ops/trait.Sub.html" title="trait std::ops::Sub">Output</a></code></span></h4> <div class='docblock'><p>The resulting type after applying the <code>-</code> operator</p> </div><h4 id='method.sub-1' class="method"><span id='sub.v-1' class='invisible'><code>fn <a href='../std/ops/trait.Sub.html#tymethod.sub' class='fnname'>sub</a>(self, other: &'a <a class="primitive" href="primitive.f32.html">f32</a>) -> <<a class="primitive" href="primitive.f32.html">f32</a> as <a class="trait" href="../std/ops/trait.Sub.html" title="trait std::ops::Sub">Sub</a><<a class="primitive" href="primitive.f32.html">f32</a>>>::<a class="trait" href="../std/ops/trait.Sub.html" title="trait std::ops::Sub">Output</a></code></span></h4> <div class='docblock'><p>The method for the <code>-</code> operator</p> </div></div><h3 class='impl'><span class='in-band'><code>impl<'a, 'b> <a class="trait" href="../std/ops/trait.Sub.html" title="trait std::ops::Sub">Sub</a><&'a <a class="primitive" href="primitive.f32.html">f32</a>> for &'b <a class="primitive" href="primitive.f32.html">f32</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/core/internal_macros.rs.html#61-68' title='goto source code'>[src]</a></span></h3> <div class='impl-items'><h4 id='associatedtype.Output-2' class="type"><span id='Output.t-2' class='invisible'><code>type <a href='../std/ops/trait.Sub.html#associatedtype.Output' class="type">Output</a> = <<a class="primitive" href="primitive.f32.html">f32</a> as <a class="trait" href="../std/ops/trait.Sub.html" title="trait std::ops::Sub">Sub</a><<a class="primitive" href="primitive.f32.html">f32</a>>>::<a class="trait" href="../std/ops/trait.Sub.html" title="trait std::ops::Sub">Output</a></code></span></h4> <div class='docblock'><p>The resulting type after applying the <code>-</code> operator</p> </div><h4 id='method.sub-2' class="method"><span id='sub.v-2' class='invisible'><code>fn <a href='../std/ops/trait.Sub.html#tymethod.sub' class='fnname'>sub</a>(self, other: &'a <a class="primitive" href="primitive.f32.html">f32</a>) -> <<a class="primitive" href="primitive.f32.html">f32</a> as <a class="trait" href="../std/ops/trait.Sub.html" title="trait std::ops::Sub">Sub</a><<a class="primitive" href="primitive.f32.html">f32</a>>>::<a class="trait" href="../std/ops/trait.Sub.html" title="trait std::ops::Sub">Output</a></code></span></h4> <div class='docblock'><p>The method for the <code>-</code> operator</p> </div></div><h3 class='impl'><span class='in-band'><code>impl <a class="trait" href="../std/ops/trait.Sub.html" title="trait std::ops::Sub">Sub</a><<a class="primitive" href="primitive.f32.html">f32</a>> for <a class="primitive" href="primitive.f32.html">f32</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/core/ops.rs.html#413-419' title='goto source code'>[src]</a></span></h3> <div class='impl-items'><h4 id='associatedtype.Output-3' class="type"><span id='Output.t-3' class='invisible'><code>type <a href='../std/ops/trait.Sub.html#associatedtype.Output' class="type">Output</a> = <a class="primitive" href="primitive.f32.html">f32</a></code></span></h4> <div class='docblock'><p>The resulting type after applying the <code>-</code> operator</p> </div><h4 id='method.sub-3' class="method"><span id='sub.v-3' class='invisible'><code>fn <a href='../std/ops/trait.Sub.html#tymethod.sub' class='fnname'>sub</a>(self, other: <a class="primitive" href="primitive.f32.html">f32</a>) -> <a class="primitive" href="primitive.f32.html">f32</a></code></span></h4> <div class='docblock'><p>The method for the <code>-</code> operator</p> </div></div><h3 class='impl'><span class='in-band'><code>impl <a class="trait" href="../std/str/trait.FromStr.html" title="trait std::str::FromStr">FromStr</a> for <a class="primitive" href="primitive.f32.html">f32</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/core/num/dec2flt/mod.rs.html#112-144' title='goto source code'>[src]</a></span></h3> <div class='impl-items'><h4 id='associatedtype.Err' class="type"><span id='Err.t' class='invisible'><code>type <a href='../std/str/trait.FromStr.html#associatedtype.Err' class="type">Err</a> = <a class="struct" href="../std/num/struct.ParseFloatError.html" title="struct std::num::ParseFloatError">ParseFloatError</a></code></span></h4> <div class='docblock'><p>The associated error which can be returned from parsing.</p> </div><h4 id='method.from_str' class="method"><span id='from_str.v' class='invisible'><code>fn <a href='../std/str/trait.FromStr.html#tymethod.from_str' class='fnname'>from_str</a>(src: &<a class="primitive" href="primitive.str.html">str</a>) -> <a class="enum" href="../std/result/enum.Result.html" title="enum std::result::Result">Result</a><<a class="primitive" href="primitive.f32.html">f32</a>, <a class="struct" href="../std/num/struct.ParseFloatError.html" title="struct std::num::ParseFloatError">ParseFloatError</a>></code></span></h4> <div class='docblock'><p>Converts a string in base 10 to a float. Accepts an optional decimal exponent.</p> <p>This function accepts strings such as</p> <ul> <li>'3.14'</li> <li>'-3.14'</li> <li>'2.5E10', or equivalently, '2.5e10'</li> <li>'2.5E-10'</li> <li>'.' (understood as 0)</li> <li>'5.'</li> <li>'.5', or, equivalently, '0.5'</li> <li>'inf', '-inf', 'NaN'</li> </ul> <p>Leading and trailing whitespace represent an error.</p> <h1 id='arguments' class='section-header'><a href='#arguments'>Arguments</a></h1> <ul> <li>src - A string</li> </ul> <h1 id='return-value' class='section-header'><a href='#return-value'>Return value</a></h1> <p><code>Err(ParseFloatError)</code> if the string did not represent a valid number. Otherwise, <code>Ok(n)</code> where <code>n</code> is the floating-point number represented by <code>src</code>.</p> </div></div><h3 class='impl'><span class='in-band'><code>impl <a class="trait" href="../std/fmt/trait.UpperExp.html" title="trait std::fmt::UpperExp">UpperExp</a> for <a class="primitive" href="primitive.f32.html">f32</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/core/fmt/float.rs.html#147-151' title='goto source code'>[src]</a></span></h3> <div class='impl-items'><h4 id='method.fmt' class="method"><span id='fmt.v' class='invisible'><code>fn <a href='../std/fmt/trait.UpperExp.html#tymethod.fmt' class='fnname'>fmt</a>(&self, fmt: &mut <a class="struct" href="../std/fmt/struct.Formatter.html" title="struct std::fmt::Formatter">Formatter</a>) -> <a class="enum" href="../std/result/enum.Result.html" title="enum std::result::Result">Result</a><<a class="primitive" href="primitive.tuple.html">()</a>, <a class="struct" href="../std/fmt/struct.Error.html" title="struct std::fmt::Error">Error</a>></code></span></h4> <div class='docblock'><p>Formats the value using the given formatter.</p> </div></div><h3 class='impl'><span class='in-band'><code>impl <a class="trait" href="../std/convert/trait.From.html" title="trait std::convert::From">From</a><<a class="primitive" href="primitive.u8.html">u8</a>> for <a class="primitive" href="primitive.f32.html">f32</a></code></span><span class='out-of-band'><div class='ghost'></div><div class='since' title='Stable since Rust version 1.6.0'>1.6.0</div><a class='srclink' href='../src/core/num/mod.rs.html#2687-2692' title='goto source code'>[src]</a></span></h3> <div class='impl-items'><h4 id='method.from' class="method"><span id='from.v' class='invisible'><code>fn <a href='../std/convert/trait.From.html#tymethod.from' class='fnname'>from</a>(small: <a class="primitive" href="primitive.u8.html">u8</a>) -> <a class="primitive" href="primitive.f32.html">f32</a></code></span></h4> <div class='docblock'><p>Performs the conversion.</p> </div></div><h3 class='impl'><span class='in-band'><code>impl <a class="trait" href="../std/convert/trait.From.html" title="trait std::convert::From">From</a><<a class="primitive" href="primitive.i8.html">i8</a>> for <a class="primitive" href="primitive.f32.html">f32</a></code></span><span class='out-of-band'><div class='ghost'></div><div class='since' title='Stable since Rust version 1.6.0'>1.6.0</div><a class='srclink' href='../src/core/num/mod.rs.html#2687-2692' title='goto source code'>[src]</a></span></h3> <div class='impl-items'><h4 id='method.from-1' class="method"><span id='from.v-1' class='invisible'><code>fn <a href='../std/convert/trait.From.html#tymethod.from' class='fnname'>from</a>(small: <a class="primitive" href="primitive.i8.html">i8</a>) -> <a class="primitive" href="primitive.f32.html">f32</a></code></span></h4> <div class='docblock'><p>Performs the conversion.</p> </div></div><h3 class='impl'><span class='in-band'><code>impl <a class="trait" href="../std/convert/trait.From.html" title="trait std::convert::From">From</a><<a class="primitive" href="primitive.u16.html">u16</a>> for <a class="primitive" href="primitive.f32.html">f32</a></code></span><span class='out-of-band'><div class='ghost'></div><div class='since' title='Stable since Rust version 1.6.0'>1.6.0</div><a class='srclink' href='../src/core/num/mod.rs.html#2687-2692' title='goto source code'>[src]</a></span></h3> <div class='impl-items'><h4 id='method.from-2' class="method"><span id='from.v-2' class='invisible'><code>fn <a href='../std/convert/trait.From.html#tymethod.from' class='fnname'>from</a>(small: <a class="primitive" href="primitive.u16.html">u16</a>) -> <a class="primitive" href="primitive.f32.html">f32</a></code></span></h4> <div class='docblock'><p>Performs the conversion.</p> </div></div><h3 class='impl'><span class='in-band'><code>impl <a class="trait" href="../std/convert/trait.From.html" title="trait std::convert::From">From</a><<a class="primitive" href="primitive.i16.html">i16</a>> for <a class="primitive" href="primitive.f32.html">f32</a></code></span><span class='out-of-band'><div class='ghost'></div><div class='since' title='Stable since Rust version 1.6.0'>1.6.0</div><a class='srclink' href='../src/core/num/mod.rs.html#2687-2692' title='goto source code'>[src]</a></span></h3> <div class='impl-items'><h4 id='method.from-3' class="method"><span id='from.v-3' class='invisible'><code>fn <a href='../std/convert/trait.From.html#tymethod.from' class='fnname'>from</a>(small: <a class="primitive" href="primitive.i16.html">i16</a>) -> <a class="primitive" href="primitive.f32.html">f32</a></code></span></h4> <div class='docblock'><p>Performs the conversion.</p> </div></div><h3 class='impl'><span class='in-band'><code>impl<'a> <a class="trait" href="../std/ops/trait.Rem.html" title="trait std::ops::Rem">Rem</a><<a class="primitive" href="primitive.f32.html">f32</a>> for &'a <a class="primitive" href="primitive.f32.html">f32</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/core/internal_macros.rs.html#41-48' title='goto source code'>[src]</a></span></h3> <div class='impl-items'><h4 id='associatedtype.Output-4' class="type"><span id='Output.t-4' class='invisible'><code>type <a href='../std/ops/trait.Rem.html#associatedtype.Output' class="type">Output</a> = <<a class="primitive" href="primitive.f32.html">f32</a> as <a class="trait" href="../std/ops/trait.Rem.html" title="trait std::ops::Rem">Rem</a><<a class="primitive" href="primitive.f32.html">f32</a>>>::<a class="trait" href="../std/ops/trait.Rem.html" title="trait std::ops::Rem">Output</a></code></span></h4> <div class='docblock'><p>The resulting type after applying the <code>%</code> operator</p> </div><h4 id='method.rem' class="method"><span id='rem.v' class='invisible'><code>fn <a href='../std/ops/trait.Rem.html#tymethod.rem' class='fnname'>rem</a>(self, other: <a class="primitive" href="primitive.f32.html">f32</a>) -> <<a class="primitive" href="primitive.f32.html">f32</a> as <a class="trait" href="../std/ops/trait.Rem.html" title="trait std::ops::Rem">Rem</a><<a class="primitive" href="primitive.f32.html">f32</a>>>::<a class="trait" href="../std/ops/trait.Rem.html" title="trait std::ops::Rem">Output</a></code></span></h4> <div class='docblock'><p>The method for the <code>%</code> operator</p> </div></div><h3 class='impl'><span class='in-band'><code>impl <a class="trait" href="../std/ops/trait.Rem.html" title="trait std::ops::Rem">Rem</a><<a class="primitive" href="primitive.f32.html">f32</a>> for <a class="primitive" href="primitive.f32.html">f32</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/core/ops.rs.html#764-769' title='goto source code'>[src]</a></span></h3> <div class='impl-items'><h4 id='associatedtype.Output-5' class="type"><span id='Output.t-5' class='invisible'><code>type <a href='../std/ops/trait.Rem.html#associatedtype.Output' class="type">Output</a> = <a class="primitive" href="primitive.f32.html">f32</a></code></span></h4> <div class='docblock'><p>The resulting type after applying the <code>%</code> operator</p> </div><h4 id='method.rem-1' class="method"><span id='rem.v-1' class='invisible'><code>fn <a href='../std/ops/trait.Rem.html#tymethod.rem' class='fnname'>rem</a>(self, other: <a class="primitive" href="primitive.f32.html">f32</a>) -> <a class="primitive" href="primitive.f32.html">f32</a></code></span></h4> <div class='docblock'><p>The method for the <code>%</code> operator</p> </div></div><h3 class='impl'><span class='in-band'><code>impl<'a, 'b> <a class="trait" href="../std/ops/trait.Rem.html" title="trait std::ops::Rem">Rem</a><&'a <a class="primitive" href="primitive.f32.html">f32</a>> for &'b <a class="primitive" href="primitive.f32.html">f32</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/core/internal_macros.rs.html#61-68' title='goto source code'>[src]</a></span></h3> <div class='impl-items'><h4 id='associatedtype.Output-6' class="type"><span id='Output.t-6' class='invisible'><code>type <a href='../std/ops/trait.Rem.html#associatedtype.Output' class="type">Output</a> = <<a class="primitive" href="primitive.f32.html">f32</a> as <a class="trait" href="../std/ops/trait.Rem.html" title="trait std::ops::Rem">Rem</a><<a class="primitive" href="primitive.f32.html">f32</a>>>::<a class="trait" href="../std/ops/trait.Rem.html" title="trait std::ops::Rem">Output</a></code></span></h4> <div class='docblock'><p>The resulting type after applying the <code>%</code> operator</p> </div><h4 id='method.rem-2' class="method"><span id='rem.v-2' class='invisible'><code>fn <a href='../std/ops/trait.Rem.html#tymethod.rem' class='fnname'>rem</a>(self, other: &'a <a class="primitive" href="primitive.f32.html">f32</a>) -> <<a class="primitive" href="primitive.f32.html">f32</a> as <a class="trait" href="../std/ops/trait.Rem.html" title="trait std::ops::Rem">Rem</a><<a class="primitive" href="primitive.f32.html">f32</a>>>::<a class="trait" href="../std/ops/trait.Rem.html" title="trait std::ops::Rem">Output</a></code></span></h4> <div class='docblock'><p>The method for the <code>%</code> operator</p> </div></div><h3 class='impl'><span class='in-band'><code>impl<'a> <a class="trait" href="../std/ops/trait.Rem.html" title="trait std::ops::Rem">Rem</a><&'a <a class="primitive" href="primitive.f32.html">f32</a>> for <a class="primitive" href="primitive.f32.html">f32</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/core/internal_macros.rs.html#51-58' title='goto source code'>[src]</a></span></h3> <div class='impl-items'><h4 id='associatedtype.Output-7' class="type"><span id='Output.t-7' class='invisible'><code>type <a href='../std/ops/trait.Rem.html#associatedtype.Output' class="type">Output</a> = <<a class="primitive" href="primitive.f32.html">f32</a> as <a class="trait" href="../std/ops/trait.Rem.html" title="trait std::ops::Rem">Rem</a><<a class="primitive" href="primitive.f32.html">f32</a>>>::<a class="trait" href="../std/ops/trait.Rem.html" title="trait std::ops::Rem">Output</a></code></span></h4> <div class='docblock'><p>The resulting type after applying the <code>%</code> operator</p> </div><h4 id='method.rem-3' class="method"><span id='rem.v-3' class='invisible'><code>fn <a href='../std/ops/trait.Rem.html#tymethod.rem' class='fnname'>rem</a>(self, other: &'a <a class="primitive" href="primitive.f32.html">f32</a>) -> <<a class="primitive" href="primitive.f32.html">f32</a> as <a class="trait" href="../std/ops/trait.Rem.html" title="trait std::ops::Rem">Rem</a><<a class="primitive" href="primitive.f32.html">f32</a>>>::<a class="trait" href="../std/ops/trait.Rem.html" title="trait std::ops::Rem">Output</a></code></span></h4> <div class='docblock'><p>The method for the <code>%</code> operator</p> </div></div><h3 class='impl'><span class='in-band'><code>impl <a class="trait" href="../std/ops/trait.RemAssign.html" title="trait std::ops::RemAssign">RemAssign</a><<a class="primitive" href="primitive.f32.html">f32</a>> for <a class="primitive" href="primitive.f32.html">f32</a></code></span><span class='out-of-band'><div class='ghost'></div><div class='since' title='Stable since Rust version 1.8.0'>1.8.0</div><a class='srclink' href='../src/core/ops.rs.html#1619-1622' title='goto source code'>[src]</a></span></h3> <div class='impl-items'><h4 id='method.rem_assign' class="method"><span id='rem_assign.v' class='invisible'><code>fn <a href='../std/ops/trait.RemAssign.html#tymethod.rem_assign' class='fnname'>rem_assign</a>(&mut self, other: <a class="primitive" href="primitive.f32.html">f32</a>)</code></span></h4> <div class='docblock'><p>The method for the <code>%=</code> operator</p> </div></div><h3 class='impl'><span class='in-band'><code>impl <a class="trait" href="../std/ops/trait.MulAssign.html" title="trait std::ops::MulAssign">MulAssign</a><<a class="primitive" href="primitive.f32.html">f32</a>> for <a class="primitive" href="primitive.f32.html">f32</a></code></span><span class='out-of-band'><div class='ghost'></div><div class='since' title='Stable since Rust version 1.8.0'>1.8.0</div><a class='srclink' href='../src/core/ops.rs.html#1528-1532' title='goto source code'>[src]</a></span></h3> <div class='impl-items'><h4 id='method.mul_assign' class="method"><span id='mul_assign.v' class='invisible'><code>fn <a href='../std/ops/trait.MulAssign.html#tymethod.mul_assign' class='fnname'>mul_assign</a>(&mut self, other: <a class="primitive" href="primitive.f32.html">f32</a>)</code></span></h4> <div class='docblock'><p>The method for the <code>*=</code> operator</p> </div></div><h3 class='impl'><span class='in-band'><code>impl <a class="trait" href="../std/ops/trait.AddAssign.html" title="trait std::ops::AddAssign">AddAssign</a><<a class="primitive" href="primitive.f32.html">f32</a>> for <a class="primitive" href="primitive.f32.html">f32</a></code></span><span class='out-of-band'><div class='ghost'></div><div class='since' title='Stable since Rust version 1.8.0'>1.8.0</div><a class='srclink' href='../src/core/ops.rs.html#1425-1429' title='goto source code'>[src]</a></span></h3> <div class='impl-items'><h4 id='method.add_assign' class="method"><span id='add_assign.v' class='invisible'><code>fn <a href='../std/ops/trait.AddAssign.html#tymethod.add_assign' class='fnname'>add_assign</a>(&mut self, other: <a class="primitive" href="primitive.f32.html">f32</a>)</code></span></h4> <div class='docblock'><p>The method for the <code>+=</code> operator</p> </div></div><h3 class='impl'><span class='in-band'><code>impl <a class="trait" href="../std/default/trait.Default.html" title="trait std::default::Default">Default</a> for <a class="primitive" href="primitive.f32.html">f32</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/core/default.rs.html#131-134' title='goto source code'>[src]</a></span></h3> <div class='impl-items'><h4 id='method.default' class="method"><span id='default.v' class='invisible'><code>fn <a href='../std/default/trait.Default.html#tymethod.default' class='fnname'>default</a>() -> <a class="primitive" href="primitive.f32.html">f32</a></code></span></h4> <div class='docblock'><p>Returns the "default value" for a type. <a href="../std/default/trait.Default.html#tymethod.default">Read more</a></p> </div></div><h3 class='impl'><span class='in-band'><code>impl <a class="trait" href="../std/ops/trait.Div.html" title="trait std::ops::Div">Div</a><<a class="primitive" href="primitive.f32.html">f32</a>> for <a class="primitive" href="primitive.f32.html">f32</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/core/ops.rs.html#683-688' title='goto source code'>[src]</a></span></h3> <div class='impl-items'><h4 id='associatedtype.Output-8' class="type"><span id='Output.t-8' class='invisible'><code>type <a href='../std/ops/trait.Div.html#associatedtype.Output' class="type">Output</a> = <a class="primitive" href="primitive.f32.html">f32</a></code></span></h4> <div class='docblock'><p>The resulting type after applying the <code>/</code> operator</p> </div><h4 id='method.div' class="method"><span id='div.v' class='invisible'><code>fn <a href='../std/ops/trait.Div.html#tymethod.div' class='fnname'>div</a>(self, other: <a class="primitive" href="primitive.f32.html">f32</a>) -> <a class="primitive" href="primitive.f32.html">f32</a></code></span></h4> <div class='docblock'><p>The method for the <code>/</code> operator</p> </div></div><h3 class='impl'><span class='in-band'><code>impl<'a, 'b> <a class="trait" href="../std/ops/trait.Div.html" title="trait std::ops::Div">Div</a><&'a <a class="primitive" href="primitive.f32.html">f32</a>> for &'b <a class="primitive" href="primitive.f32.html">f32</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/core/internal_macros.rs.html#61-68' title='goto source code'>[src]</a></span></h3> <div class='impl-items'><h4 id='associatedtype.Output-9' class="type"><span id='Output.t-9' class='invisible'><code>type <a href='../std/ops/trait.Div.html#associatedtype.Output' class="type">Output</a> = <<a class="primitive" href="primitive.f32.html">f32</a> as <a class="trait" href="../std/ops/trait.Div.html" title="trait std::ops::Div">Div</a><<a class="primitive" href="primitive.f32.html">f32</a>>>::<a class="trait" href="../std/ops/trait.Div.html" title="trait std::ops::Div">Output</a></code></span></h4> <div class='docblock'><p>The resulting type after applying the <code>/</code> operator</p> </div><h4 id='method.div-1' class="method"><span id='div.v-1' class='invisible'><code>fn <a href='../std/ops/trait.Div.html#tymethod.div' class='fnname'>div</a>(self, other: &'a <a class="primitive" href="primitive.f32.html">f32</a>) -> <<a class="primitive" href="primitive.f32.html">f32</a> as <a class="trait" href="../std/ops/trait.Div.html" title="trait std::ops::Div">Div</a><<a class="primitive" href="primitive.f32.html">f32</a>>>::<a class="trait" href="../std/ops/trait.Div.html" title="trait std::ops::Div">Output</a></code></span></h4> <div class='docblock'><p>The method for the <code>/</code> operator</p> </div></div><h3 class='impl'><span class='in-band'><code>impl<'a> <a class="trait" href="../std/ops/trait.Div.html" title="trait std::ops::Div">Div</a><<a class="primitive" href="primitive.f32.html">f32</a>> for &'a <a class="primitive" href="primitive.f32.html">f32</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/core/internal_macros.rs.html#41-48' title='goto source code'>[src]</a></span></h3> <div class='impl-items'><h4 id='associatedtype.Output-10' class="type"><span id='Output.t-10' class='invisible'><code>type <a href='../std/ops/trait.Div.html#associatedtype.Output' class="type">Output</a> = <<a class="primitive" href="primitive.f32.html">f32</a> as <a class="trait" href="../std/ops/trait.Div.html" title="trait std::ops::Div">Div</a><<a class="primitive" href="primitive.f32.html">f32</a>>>::<a class="trait" href="../std/ops/trait.Div.html" title="trait std::ops::Div">Output</a></code></span></h4> <div class='docblock'><p>The resulting type after applying the <code>/</code> operator</p> </div><h4 id='method.div-2' class="method"><span id='div.v-2' class='invisible'><code>fn <a href='../std/ops/trait.Div.html#tymethod.div' class='fnname'>div</a>(self, other: <a class="primitive" href="primitive.f32.html">f32</a>) -> <<a class="primitive" href="primitive.f32.html">f32</a> as <a class="trait" href="../std/ops/trait.Div.html" title="trait std::ops::Div">Div</a><<a class="primitive" href="primitive.f32.html">f32</a>>>::<a class="trait" href="../std/ops/trait.Div.html" title="trait std::ops::Div">Output</a></code></span></h4> <div class='docblock'><p>The method for the <code>/</code> operator</p> </div></div><h3 class='impl'><span class='in-band'><code>impl<'a> <a class="trait" href="../std/ops/trait.Div.html" title="trait std::ops::Div">Div</a><&'a <a class="primitive" href="primitive.f32.html">f32</a>> for <a class="primitive" href="primitive.f32.html">f32</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/core/internal_macros.rs.html#51-58' title='goto source code'>[src]</a></span></h3> <div class='impl-items'><h4 id='associatedtype.Output-11' class="type"><span id='Output.t-11' class='invisible'><code>type <a href='../std/ops/trait.Div.html#associatedtype.Output' class="type">Output</a> = <<a class="primitive" href="primitive.f32.html">f32</a> as <a class="trait" href="../std/ops/trait.Div.html" title="trait std::ops::Div">Div</a><<a class="primitive" href="primitive.f32.html">f32</a>>>::<a class="trait" href="../std/ops/trait.Div.html" title="trait std::ops::Div">Output</a></code></span></h4> <div class='docblock'><p>The resulting type after applying the <code>/</code> operator</p> </div><h4 id='method.div-3' class="method"><span id='div.v-3' class='invisible'><code>fn <a href='../std/ops/trait.Div.html#tymethod.div' class='fnname'>div</a>(self, other: &'a <a class="primitive" href="primitive.f32.html">f32</a>) -> <<a class="primitive" href="primitive.f32.html">f32</a> as <a class="trait" href="../std/ops/trait.Div.html" title="trait std::ops::Div">Div</a><<a class="primitive" href="primitive.f32.html">f32</a>>>::<a class="trait" href="../std/ops/trait.Div.html" title="trait std::ops::Div">Output</a></code></span></h4> <div class='docblock'><p>The method for the <code>/</code> operator</p> </div></div><h3 class='impl'><span class='in-band'><code>impl <a class="trait" href="../std/ops/trait.Add.html" title="trait std::ops::Add">Add</a><<a class="primitive" href="primitive.f32.html">f32</a>> for <a class="primitive" href="primitive.f32.html">f32</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/core/ops.rs.html#339-345' title='goto source code'>[src]</a></span></h3> <div class='impl-items'><h4 id='associatedtype.Output-12' class="type"><span id='Output.t-12' class='invisible'><code>type <a href='../std/ops/trait.Add.html#associatedtype.Output' class="type">Output</a> = <a class="primitive" href="primitive.f32.html">f32</a></code></span></h4> <div class='docblock'><p>The resulting type after applying the <code>+</code> operator</p> </div><h4 id='method.add' class="method"><span id='add.v' class='invisible'><code>fn <a href='../std/ops/trait.Add.html#tymethod.add' class='fnname'>add</a>(self, other: <a class="primitive" href="primitive.f32.html">f32</a>) -> <a class="primitive" href="primitive.f32.html">f32</a></code></span></h4> <div class='docblock'><p>The method for the <code>+</code> operator</p> </div></div><h3 class='impl'><span class='in-band'><code>impl<'a> <a class="trait" href="../std/ops/trait.Add.html" title="trait std::ops::Add">Add</a><&'a <a class="primitive" href="primitive.f32.html">f32</a>> for <a class="primitive" href="primitive.f32.html">f32</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/core/internal_macros.rs.html#51-58' title='goto source code'>[src]</a></span></h3> <div class='impl-items'><h4 id='associatedtype.Output-13' class="type"><span id='Output.t-13' class='invisible'><code>type <a href='../std/ops/trait.Add.html#associatedtype.Output' class="type">Output</a> = <<a class="primitive" href="primitive.f32.html">f32</a> as <a class="trait" href="../std/ops/trait.Add.html" title="trait std::ops::Add">Add</a><<a class="primitive" href="primitive.f32.html">f32</a>>>::<a class="trait" href="../std/ops/trait.Add.html" title="trait std::ops::Add">Output</a></code></span></h4> <div class='docblock'><p>The resulting type after applying the <code>+</code> operator</p> </div><h4 id='method.add-1' class="method"><span id='add.v-1' class='invisible'><code>fn <a href='../std/ops/trait.Add.html#tymethod.add' class='fnname'>add</a>(self, other: &'a <a class="primitive" href="primitive.f32.html">f32</a>) -> <<a class="primitive" href="primitive.f32.html">f32</a> as <a class="trait" href="../std/ops/trait.Add.html" title="trait std::ops::Add">Add</a><<a class="primitive" href="primitive.f32.html">f32</a>>>::<a class="trait" href="../std/ops/trait.Add.html" title="trait std::ops::Add">Output</a></code></span></h4> <div class='docblock'><p>The method for the <code>+</code> operator</p> </div></div><h3 class='impl'><span class='in-band'><code>impl<'a> <a class="trait" href="../std/ops/trait.Add.html" title="trait std::ops::Add">Add</a><<a class="primitive" href="primitive.f32.html">f32</a>> for &'a <a class="primitive" href="primitive.f32.html">f32</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/core/internal_macros.rs.html#41-48' title='goto source code'>[src]</a></span></h3> <div class='impl-items'><h4 id='associatedtype.Output-14' class="type"><span id='Output.t-14' class='invisible'><code>type <a href='../std/ops/trait.Add.html#associatedtype.Output' class="type">Output</a> = <<a class="primitive" href="primitive.f32.html">f32</a> as <a class="trait" href="../std/ops/trait.Add.html" title="trait std::ops::Add">Add</a><<a class="primitive" href="primitive.f32.html">f32</a>>>::<a class="trait" href="../std/ops/trait.Add.html" title="trait std::ops::Add">Output</a></code></span></h4> <div class='docblock'><p>The resulting type after applying the <code>+</code> operator</p> </div><h4 id='method.add-2' class="method"><span id='add.v-2' class='invisible'><code>fn <a href='../std/ops/trait.Add.html#tymethod.add' class='fnname'>add</a>(self, other: <a class="primitive" href="primitive.f32.html">f32</a>) -> <<a class="primitive" href="primitive.f32.html">f32</a> as <a class="trait" href="../std/ops/trait.Add.html" title="trait std::ops::Add">Add</a><<a class="primitive" href="primitive.f32.html">f32</a>>>::<a class="trait" href="../std/ops/trait.Add.html" title="trait std::ops::Add">Output</a></code></span></h4> <div class='docblock'><p>The method for the <code>+</code> operator</p> </div></div><h3 class='impl'><span class='in-band'><code>impl<'a, 'b> <a class="trait" href="../std/ops/trait.Add.html" title="trait std::ops::Add">Add</a><&'a <a class="primitive" href="primitive.f32.html">f32</a>> for &'b <a class="primitive" href="primitive.f32.html">f32</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/core/internal_macros.rs.html#61-68' title='goto source code'>[src]</a></span></h3> <div class='impl-items'><h4 id='associatedtype.Output-15' class="type"><span id='Output.t-15' class='invisible'><code>type <a href='../std/ops/trait.Add.html#associatedtype.Output' class="type">Output</a> = <<a class="primitive" href="primitive.f32.html">f32</a> as <a class="trait" href="../std/ops/trait.Add.html" title="trait std::ops::Add">Add</a><<a class="primitive" href="primitive.f32.html">f32</a>>>::<a class="trait" href="../std/ops/trait.Add.html" title="trait std::ops::Add">Output</a></code></span></h4> <div class='docblock'><p>The resulting type after applying the <code>+</code> operator</p> </div><h4 id='method.add-3' class="method"><span id='add.v-3' class='invisible'><code>fn <a href='../std/ops/trait.Add.html#tymethod.add' class='fnname'>add</a>(self, other: &'a <a class="primitive" href="primitive.f32.html">f32</a>) -> <<a class="primitive" href="primitive.f32.html">f32</a> as <a class="trait" href="../std/ops/trait.Add.html" title="trait std::ops::Add">Add</a><<a class="primitive" href="primitive.f32.html">f32</a>>>::<a class="trait" href="../std/ops/trait.Add.html" title="trait std::ops::Add">Output</a></code></span></h4> <div class='docblock'><p>The method for the <code>+</code> operator</p> </div></div><h3 class='impl'><span class='in-band'><code>impl <a class="trait" href="../std/fmt/trait.Debug.html" title="trait std::fmt::Debug">Debug</a> for <a class="primitive" href="primitive.f32.html">f32</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/core/fmt/float.rs.html#126-130' title='goto source code'>[src]</a></span></h3> <div class='impl-items'><h4 id='method.fmt-1' class="method"><span id='fmt.v-1' class='invisible'><code>fn <a href='../std/fmt/trait.Debug.html#tymethod.fmt' class='fnname'>fmt</a>(&self, fmt: &mut <a class="struct" href="../std/fmt/struct.Formatter.html" title="struct std::fmt::Formatter">Formatter</a>) -> <a class="enum" href="../std/result/enum.Result.html" title="enum std::result::Result">Result</a><<a class="primitive" href="primitive.tuple.html">()</a>, <a class="struct" href="../std/fmt/struct.Error.html" title="struct std::fmt::Error">Error</a>></code></span></h4> <div class='docblock'><p>Formats the value using the given formatter.</p> </div></div><h3 class='impl'><span class='in-band'><code>impl <a class="trait" href="../std/iter/trait.Sum.html" title="trait std::iter::Sum">Sum</a><<a class="primitive" href="primitive.f32.html">f32</a>> for <a class="primitive" href="primitive.f32.html">f32</a></code></span><span class='out-of-band'><div class='ghost'></div><div class='since' title='Stable since Rust version 1.12.0'>1.12.0</div><a class='srclink' href='../src/core/iter/traits.rs.html#706-710' title='goto source code'>[src]</a></span></h3> <div class='impl-items'><h4 id='method.sum' class="method"><span id='sum.v' class='invisible'><code>fn <a href='../std/iter/trait.Sum.html#tymethod.sum' class='fnname'>sum</a><I>(iter: I) -> <a class="primitive" href="primitive.f32.html">f32</a> <span class="where fmt-newline">where<br> I: <a class="trait" href="../std/iter/trait.Iterator.html" title="trait std::iter::Iterator">Iterator</a><Item = <a class="primitive" href="primitive.f32.html">f32</a>>, </span></code></span></h4> <div class='docblock'><p>Method which takes an iterator and generates <code>Self</code> from the elements by "summing up" the items. <a href="../std/iter/trait.Sum.html#tymethod.sum">Read more</a></p> </div></div><h3 class='impl'><span class='in-band'><code>impl<'a> <a class="trait" href="../std/iter/trait.Sum.html" title="trait std::iter::Sum">Sum</a><&'a <a class="primitive" href="primitive.f32.html">f32</a>> for <a class="primitive" href="primitive.f32.html">f32</a></code></span><span class='out-of-band'><div class='ghost'></div><div class='since' title='Stable since Rust version 1.12.0'>1.12.0</div><a class='srclink' href='../src/core/iter/traits.rs.html#720-724' title='goto source code'>[src]</a></span></h3> <div class='impl-items'><h4 id='method.sum-1' class="method"><span id='sum.v-1' class='invisible'><code>fn <a href='../std/iter/trait.Sum.html#tymethod.sum' class='fnname'>sum</a><I>(iter: I) -> <a class="primitive" href="primitive.f32.html">f32</a> <span class="where fmt-newline">where<br> I: <a class="trait" href="../std/iter/trait.Iterator.html" title="trait std::iter::Iterator">Iterator</a><Item = &'a <a class="primitive" href="primitive.f32.html">f32</a>>, </span></code></span></h4> <div class='docblock'><p>Method which takes an iterator and generates <code>Self</code> from the elements by "summing up" the items. <a href="../std/iter/trait.Sum.html#tymethod.sum">Read more</a></p> </div></div><h3 class='impl'><span class='in-band'><code>impl<'a> <a class="trait" href="../std/ops/trait.Mul.html" title="trait std::ops::Mul">Mul</a><<a class="primitive" href="primitive.f32.html">f32</a>> for &'a <a class="primitive" href="primitive.f32.html">f32</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/core/internal_macros.rs.html#41-48' title='goto source code'>[src]</a></span></h3> <div class='impl-items'><h4 id='associatedtype.Output-16' class="type"><span id='Output.t-16' class='invisible'><code>type <a href='../std/ops/trait.Mul.html#associatedtype.Output' class="type">Output</a> = <<a class="primitive" href="primitive.f32.html">f32</a> as <a class="trait" href="../std/ops/trait.Mul.html" title="trait std::ops::Mul">Mul</a><<a class="primitive" href="primitive.f32.html">f32</a>>>::<a class="trait" href="../std/ops/trait.Mul.html" title="trait std::ops::Mul">Output</a></code></span></h4> <div class='docblock'><p>The resulting type after applying the <code>*</code> operator</p> </div><h4 id='method.mul' class="method"><span id='mul.v' class='invisible'><code>fn <a href='../std/ops/trait.Mul.html#tymethod.mul' class='fnname'>mul</a>(self, other: <a class="primitive" href="primitive.f32.html">f32</a>) -> <<a class="primitive" href="primitive.f32.html">f32</a> as <a class="trait" href="../std/ops/trait.Mul.html" title="trait std::ops::Mul">Mul</a><<a class="primitive" href="primitive.f32.html">f32</a>>>::<a class="trait" href="../std/ops/trait.Mul.html" title="trait std::ops::Mul">Output</a></code></span></h4> <div class='docblock'><p>The method for the <code>*</code> operator</p> </div></div><h3 class='impl'><span class='in-band'><code>impl <a class="trait" href="../std/ops/trait.Mul.html" title="trait std::ops::Mul">Mul</a><<a class="primitive" href="primitive.f32.html">f32</a>> for <a class="primitive" href="primitive.f32.html">f32</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/core/ops.rs.html#536-542' title='goto source code'>[src]</a></span></h3> <div class='impl-items'><h4 id='associatedtype.Output-17' class="type"><span id='Output.t-17' class='invisible'><code>type <a href='../std/ops/trait.Mul.html#associatedtype.Output' class="type">Output</a> = <a class="primitive" href="primitive.f32.html">f32</a></code></span></h4> <div class='docblock'><p>The resulting type after applying the <code>*</code> operator</p> </div><h4 id='method.mul-1' class="method"><span id='mul.v-1' class='invisible'><code>fn <a href='../std/ops/trait.Mul.html#tymethod.mul' class='fnname'>mul</a>(self, other: <a class="primitive" href="primitive.f32.html">f32</a>) -> <a class="primitive" href="primitive.f32.html">f32</a></code></span></h4> <div class='docblock'><p>The method for the <code>*</code> operator</p> </div></div><h3 class='impl'><span class='in-band'><code>impl<'a, 'b> <a class="trait" href="../std/ops/trait.Mul.html" title="trait std::ops::Mul">Mul</a><&'a <a class="primitive" href="primitive.f32.html">f32</a>> for &'b <a class="primitive" href="primitive.f32.html">f32</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/core/internal_macros.rs.html#61-68' title='goto source code'>[src]</a></span></h3> <div class='impl-items'><h4 id='associatedtype.Output-18' class="type"><span id='Output.t-18' class='invisible'><code>type <a href='../std/ops/trait.Mul.html#associatedtype.Output' class="type">Output</a> = <<a class="primitive" href="primitive.f32.html">f32</a> as <a class="trait" href="../std/ops/trait.Mul.html" title="trait std::ops::Mul">Mul</a><<a class="primitive" href="primitive.f32.html">f32</a>>>::<a class="trait" href="../std/ops/trait.Mul.html" title="trait std::ops::Mul">Output</a></code></span></h4> <div class='docblock'><p>The resulting type after applying the <code>*</code> operator</p> </div><h4 id='method.mul-2' class="method"><span id='mul.v-2' class='invisible'><code>fn <a href='../std/ops/trait.Mul.html#tymethod.mul' class='fnname'>mul</a>(self, other: &'a <a class="primitive" href="primitive.f32.html">f32</a>) -> <<a class="primitive" href="primitive.f32.html">f32</a> as <a class="trait" href="../std/ops/trait.Mul.html" title="trait std::ops::Mul">Mul</a><<a class="primitive" href="primitive.f32.html">f32</a>>>::<a class="trait" href="../std/ops/trait.Mul.html" title="trait std::ops::Mul">Output</a></code></span></h4> <div class='docblock'><p>The method for the <code>*</code> operator</p> </div></div><h3 class='impl'><span class='in-band'><code>impl<'a> <a class="trait" href="../std/ops/trait.Mul.html" title="trait std::ops::Mul">Mul</a><&'a <a class="primitive" href="primitive.f32.html">f32</a>> for <a class="primitive" href="primitive.f32.html">f32</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/core/internal_macros.rs.html#51-58' title='goto source code'>[src]</a></span></h3> <div class='impl-items'><h4 id='associatedtype.Output-19' class="type"><span id='Output.t-19' class='invisible'><code>type <a href='../std/ops/trait.Mul.html#associatedtype.Output' class="type">Output</a> = <<a class="primitive" href="primitive.f32.html">f32</a> as <a class="trait" href="../std/ops/trait.Mul.html" title="trait std::ops::Mul">Mul</a><<a class="primitive" href="primitive.f32.html">f32</a>>>::<a class="trait" href="../std/ops/trait.Mul.html" title="trait std::ops::Mul">Output</a></code></span></h4> <div class='docblock'><p>The resulting type after applying the <code>*</code> operator</p> </div><h4 id='method.mul-3' class="method"><span id='mul.v-3' class='invisible'><code>fn <a href='../std/ops/trait.Mul.html#tymethod.mul' class='fnname'>mul</a>(self, other: &'a <a class="primitive" href="primitive.f32.html">f32</a>) -> <<a class="primitive" href="primitive.f32.html">f32</a> as <a class="trait" href="../std/ops/trait.Mul.html" title="trait std::ops::Mul">Mul</a><<a class="primitive" href="primitive.f32.html">f32</a>>>::<a class="trait" href="../std/ops/trait.Mul.html" title="trait std::ops::Mul">Output</a></code></span></h4> <div class='docblock'><p>The method for the <code>*</code> operator</p> </div></div><h3 class='impl'><span class='in-band'><code>impl <a class="trait" href="../std/ops/trait.DivAssign.html" title="trait std::ops::DivAssign">DivAssign</a><<a class="primitive" href="primitive.f32.html">f32</a>> for <a class="primitive" href="primitive.f32.html">f32</a></code></span><span class='out-of-band'><div class='ghost'></div><div class='since' title='Stable since Rust version 1.8.0'>1.8.0</div><a class='srclink' href='../src/core/ops.rs.html#1574-1577' title='goto source code'>[src]</a></span></h3> <div class='impl-items'><h4 id='method.div_assign' class="method"><span id='div_assign.v' class='invisible'><code>fn <a href='../std/ops/trait.DivAssign.html#tymethod.div_assign' class='fnname'>div_assign</a>(&mut self, other: <a class="primitive" href="primitive.f32.html">f32</a>)</code></span></h4> <div class='docblock'><p>The method for the <code>/=</code> operator</p> </div></div><h3 class='impl'><span class='in-band'><code>impl <a class="trait" href="../std/ops/trait.SubAssign.html" title="trait std::ops::SubAssign">SubAssign</a><<a class="primitive" href="primitive.f32.html">f32</a>> for <a class="primitive" href="primitive.f32.html">f32</a></code></span><span class='out-of-band'><div class='ghost'></div><div class='since' title='Stable since Rust version 1.8.0'>1.8.0</div><a class='srclink' href='../src/core/ops.rs.html#1482-1486' title='goto source code'>[src]</a></span></h3> <div class='impl-items'><h4 id='method.sub_assign' class="method"><span id='sub_assign.v' class='invisible'><code>fn <a href='../std/ops/trait.SubAssign.html#tymethod.sub_assign' class='fnname'>sub_assign</a>(&mut self, other: <a class="primitive" href="primitive.f32.html">f32</a>)</code></span></h4> <div class='docblock'><p>The method for the <code>-=</code> operator</p> </div></div><h3 class='impl'><span class='in-band'><code>impl <a class="trait" href="../std/cmp/trait.PartialEq.html" title="trait std::cmp::PartialEq">PartialEq</a><<a class="primitive" href="primitive.f32.html">f32</a>> for <a class="primitive" href="primitive.f32.html">f32</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/core/cmp.rs.html#719-724' title='goto source code'>[src]</a></span></h3> <div class='impl-items'><h4 id='method.eq' class="method"><span id='eq.v' class='invisible'><code>fn <a href='../std/cmp/trait.PartialEq.html#tymethod.eq' class='fnname'>eq</a>(&self, other: &<a class="primitive" href="primitive.f32.html">f32</a>) -> <a class="primitive" href="primitive.bool.html">bool</a></code></span></h4> <div class='docblock'><p>This method tests for <code>self</code> and <code>other</code> values to be equal, and is used by <code>==</code>. <a href="../std/cmp/trait.PartialEq.html#tymethod.eq">Read more</a></p> </div><h4 id='method.ne' class="method"><span id='ne.v' class='invisible'><code>fn <a href='../std/cmp/trait.PartialEq.html#method.ne' class='fnname'>ne</a>(&self, other: &<a class="primitive" href="primitive.f32.html">f32</a>) -> <a class="primitive" href="primitive.bool.html">bool</a></code></span></h4> <div class='docblock'><p>This method tests for <code>!=</code>.</p> </div></div><h3 class='impl'><span class='in-band'><code>impl <a class="trait" href="../std/fmt/trait.LowerExp.html" title="trait std::fmt::LowerExp">LowerExp</a> for <a class="primitive" href="primitive.f32.html">f32</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/core/fmt/float.rs.html#140-144' title='goto source code'>[src]</a></span></h3> <div class='impl-items'><h4 id='method.fmt-2' class="method"><span id='fmt.v-2' class='invisible'><code>fn <a href='../std/fmt/trait.LowerExp.html#tymethod.fmt' class='fnname'>fmt</a>(&self, fmt: &mut <a class="struct" href="../std/fmt/struct.Formatter.html" title="struct std::fmt::Formatter">Formatter</a>) -> <a class="enum" href="../std/result/enum.Result.html" title="enum std::result::Result">Result</a><<a class="primitive" href="primitive.tuple.html">()</a>, <a class="struct" href="../std/fmt/struct.Error.html" title="struct std::fmt::Error">Error</a>></code></span></h4> <div class='docblock'><p>Formats the value using the given formatter.</p> </div></div><h3 class='impl'><span class='in-band'><code>impl <a class="trait" href="../std/fmt/trait.Display.html" title="trait std::fmt::Display">Display</a> for <a class="primitive" href="primitive.f32.html">f32</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/core/fmt/float.rs.html#133-137' title='goto source code'>[src]</a></span></h3> <div class='impl-items'><h4 id='method.fmt-3' class="method"><span id='fmt.v-3' class='invisible'><code>fn <a href='../std/fmt/trait.Display.html#tymethod.fmt' class='fnname'>fmt</a>(&self, fmt: &mut <a class="struct" href="../std/fmt/struct.Formatter.html" title="struct std::fmt::Formatter">Formatter</a>) -> <a class="enum" href="../std/result/enum.Result.html" title="enum std::result::Result">Result</a><<a class="primitive" href="primitive.tuple.html">()</a>, <a class="struct" href="../std/fmt/struct.Error.html" title="struct std::fmt::Error">Error</a>></code></span></h4> <div class='docblock'><p>Formats the value using the given formatter. <a href="../std/fmt/trait.Display.html#tymethod.fmt">Read more</a></p> </div></div><h3 class='impl'><span class='in-band'><code>impl <a class="trait" href="../std/clone/trait.Clone.html" title="trait std::clone::Clone">Clone</a> for <a class="primitive" href="primitive.f32.html">f32</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/core/clone.rs.html#143-147' title='goto source code'>[src]</a></span></h3> <div class='impl-items'><h4 id='method.clone' class="method"><span id='clone.v' class='invisible'><code>fn <a href='../std/clone/trait.Clone.html#tymethod.clone' class='fnname'>clone</a>(&self) -> <a class="primitive" href="primitive.f32.html">f32</a></code></span></h4> <div class='docblock'><p>Returns a deep copy of the value.</p> </div><h4 id='method.clone_from' class="method"><span id='clone_from.v' class='invisible'><code>fn <a href='../std/clone/trait.Clone.html#method.clone_from' class='fnname'>clone_from</a>(&mut self, source: &Self)</code></span></h4> <div class='docblock'><p>Performs copy-assignment from <code>source</code>. <a href="../std/clone/trait.Clone.html#method.clone_from">Read more</a></p> </div></div><h3 class='impl'><span class='in-band'><code>impl <a class="trait" href="../std/cmp/trait.PartialOrd.html" title="trait std::cmp::PartialOrd">PartialOrd</a><<a class="primitive" href="primitive.f32.html">f32</a>> for <a class="primitive" href="primitive.f32.html">f32</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/core/cmp.rs.html#752-770' title='goto source code'>[src]</a></span></h3> <div class='impl-items'><h4 id='method.partial_cmp' class="method"><span id='partial_cmp.v' class='invisible'><code>fn <a href='../std/cmp/trait.PartialOrd.html#tymethod.partial_cmp' class='fnname'>partial_cmp</a>(&self, other: &<a class="primitive" href="primitive.f32.html">f32</a>) -> <a class="enum" href="../std/option/enum.Option.html" title="enum std::option::Option">Option</a><<a class="enum" href="../std/cmp/enum.Ordering.html" title="enum std::cmp::Ordering">Ordering</a>></code></span></h4> <div class='docblock'><p>This method returns an ordering between <code>self</code> and <code>other</code> values if one exists. <a href="../std/cmp/trait.PartialOrd.html#tymethod.partial_cmp">Read more</a></p> </div><h4 id='method.lt' class="method"><span id='lt.v' class='invisible'><code>fn <a href='../std/cmp/trait.PartialOrd.html#method.lt' class='fnname'>lt</a>(&self, other: &<a class="primitive" href="primitive.f32.html">f32</a>) -> <a class="primitive" href="primitive.bool.html">bool</a></code></span></h4> <div class='docblock'><p>This method tests less than (for <code>self</code> and <code>other</code>) and is used by the <code><</code> operator. <a href="../std/cmp/trait.PartialOrd.html#method.lt">Read more</a></p> </div><h4 id='method.le' class="method"><span id='le.v' class='invisible'><code>fn <a href='../std/cmp/trait.PartialOrd.html#method.le' class='fnname'>le</a>(&self, other: &<a class="primitive" href="primitive.f32.html">f32</a>) -> <a class="primitive" href="primitive.bool.html">bool</a></code></span></h4> <div class='docblock'><p>This method tests less than or equal to (for <code>self</code> and <code>other</code>) and is used by the <code><=</code> operator. <a href="../std/cmp/trait.PartialOrd.html#method.le">Read more</a></p> </div><h4 id='method.ge' class="method"><span id='ge.v' class='invisible'><code>fn <a href='../std/cmp/trait.PartialOrd.html#method.ge' class='fnname'>ge</a>(&self, other: &<a class="primitive" href="primitive.f32.html">f32</a>) -> <a class="primitive" href="primitive.bool.html">bool</a></code></span></h4> <div class='docblock'><p>This method tests greater than or equal to (for <code>self</code> and <code>other</code>) and is used by the <code>>=</code> operator. <a href="../std/cmp/trait.PartialOrd.html#method.ge">Read more</a></p> </div><h4 id='method.gt' class="method"><span id='gt.v' class='invisible'><code>fn <a href='../std/cmp/trait.PartialOrd.html#method.gt' class='fnname'>gt</a>(&self, other: &<a class="primitive" href="primitive.f32.html">f32</a>) -> <a class="primitive" href="primitive.bool.html">bool</a></code></span></h4> <div class='docblock'><p>This method tests greater than (for <code>self</code> and <code>other</code>) and is used by the <code>></code> operator. <a href="../std/cmp/trait.PartialOrd.html#method.gt">Read more</a></p> </div></div><h3 class='impl'><span class='in-band'><code>impl <a class="trait" href="../std/iter/trait.Product.html" title="trait std::iter::Product">Product</a><<a class="primitive" href="primitive.f32.html">f32</a>> for <a class="primitive" href="primitive.f32.html">f32</a></code></span><span class='out-of-band'><div class='ghost'></div><div class='since' title='Stable since Rust version 1.12.0'>1.12.0</div><a class='srclink' href='../src/core/iter/traits.rs.html#713-717' title='goto source code'>[src]</a></span></h3> <div class='impl-items'><h4 id='method.product' class="method"><span id='product.v' class='invisible'><code>fn <a href='../std/iter/trait.Product.html#tymethod.product' class='fnname'>product</a><I>(iter: I) -> <a class="primitive" href="primitive.f32.html">f32</a> <span class="where fmt-newline">where<br> I: <a class="trait" href="../std/iter/trait.Iterator.html" title="trait std::iter::Iterator">Iterator</a><Item = <a class="primitive" href="primitive.f32.html">f32</a>>, </span></code></span></h4> <div class='docblock'><p>Method which takes an iterator and generates <code>Self</code> from the elements by multiplying the items. <a href="../std/iter/trait.Product.html#tymethod.product">Read more</a></p> </div></div><h3 class='impl'><span class='in-band'><code>impl<'a> <a class="trait" href="../std/iter/trait.Product.html" title="trait std::iter::Product">Product</a><&'a <a class="primitive" href="primitive.f32.html">f32</a>> for <a class="primitive" href="primitive.f32.html">f32</a></code></span><span class='out-of-band'><div class='ghost'></div><div class='since' title='Stable since Rust version 1.12.0'>1.12.0</div><a class='srclink' href='../src/core/iter/traits.rs.html#727-731' title='goto source code'>[src]</a></span></h3> <div class='impl-items'><h4 id='method.product-1' class="method"><span id='product.v-1' class='invisible'><code>fn <a href='../std/iter/trait.Product.html#tymethod.product' class='fnname'>product</a><I>(iter: I) -> <a class="primitive" href="primitive.f32.html">f32</a> <span class="where fmt-newline">where<br> I: <a class="trait" href="../std/iter/trait.Iterator.html" title="trait std::iter::Iterator">Iterator</a><Item = &'a <a class="primitive" href="primitive.f32.html">f32</a>>, </span></code></span></h4> <div class='docblock'><p>Method which takes an iterator and generates <code>Self</code> from the elements by multiplying the items. <a href="../std/iter/trait.Product.html#tymethod.product">Read more</a></p> </div></div><h3 class='impl'><span class='in-band'><code>impl<'a> <a class="trait" href="../std/ops/trait.Neg.html" title="trait std::ops::Neg">Neg</a> for &'a <a class="primitive" href="primitive.f32.html">f32</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/core/internal_macros.rs.html#21-28' title='goto source code'>[src]</a></span></h3> <div class='impl-items'><h4 id='associatedtype.Output-20' class="type"><span id='Output.t-20' class='invisible'><code>type <a href='../std/ops/trait.Neg.html#associatedtype.Output' class="type">Output</a> = <<a class="primitive" href="primitive.f32.html">f32</a> as <a class="trait" href="../std/ops/trait.Neg.html" title="trait std::ops::Neg">Neg</a>>::<a class="trait" href="../std/ops/trait.Neg.html" title="trait std::ops::Neg">Output</a></code></span></h4> <div class='docblock'><p>The resulting type after applying the <code>-</code> operator</p> </div><h4 id='method.neg' class="method"><span id='neg.v' class='invisible'><code>fn <a href='../std/ops/trait.Neg.html#tymethod.neg' class='fnname'>neg</a>(self) -> <<a class="primitive" href="primitive.f32.html">f32</a> as <a class="trait" href="../std/ops/trait.Neg.html" title="trait std::ops::Neg">Neg</a>>::<a class="trait" href="../std/ops/trait.Neg.html" title="trait std::ops::Neg">Output</a></code></span></h4> <div class='docblock'><p>The method for the unary <code>-</code> operator</p> </div></div><h3 class='impl'><span class='in-band'><code>impl <a class="trait" href="../std/ops/trait.Neg.html" title="trait std::ops::Neg">Neg</a> for <a class="primitive" href="primitive.f32.html">f32</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/core/ops.rs.html#830-836' title='goto source code'>[src]</a></span></h3> <div class='impl-items'><h4 id='associatedtype.Output-21' class="type"><span id='Output.t-21' class='invisible'><code>type <a href='../std/ops/trait.Neg.html#associatedtype.Output' class="type">Output</a> = <a class="primitive" href="primitive.f32.html">f32</a></code></span></h4> <div class='docblock'><p>The resulting type after applying the <code>-</code> operator</p> </div><h4 id='method.neg-1' class="method"><span id='neg.v-1' class='invisible'><code>fn <a href='../std/ops/trait.Neg.html#tymethod.neg' class='fnname'>neg</a>(self) -> <a class="primitive" href="primitive.f32.html">f32</a></code></span></h4> <div class='docblock'><p>The method for the unary <code>-</code> operator</p> </div></div></section> <section id='search' class="content hidden"></section> <section class="footer"></section> <aside id="help" class="hidden"> <div> <h1 class="hidden">Help</h1> <div class="shortcuts"> <h2>Keyboard Shortcuts</h2> <dl> <dt>?</dt> <dd>Show this help dialog</dd> <dt>S</dt> <dd>Focus the search field</dd> <dt>⇤</dt> <dd>Move up in search results</dd> <dt>⇥</dt> <dd>Move down in search results</dd> <dt>⏎</dt> <dd>Go to active search result</dd> <dt>+</dt> <dd>Collapse/expand all sections</dd> </dl> </div> <div class="infos"> <h2>Search Tricks</h2> <p> Prefix searches with a type followed by a colon (e.g. <code>fn:</code>) to restrict the search to a given type. </p> <p> Accepted types are: <code>fn</code>, <code>mod</code>, <code>struct</code>, <code>enum</code>, <code>trait</code>, <code>type</code>, <code>macro</code>, and <code>const</code>. </p> <p> Search functions by type signature (e.g. <code>vec -> usize</code> or <code>* -> vec</code>) </p> </div> </div> </aside> <script> window.rootPath = "../"; window.currentCrate = "std"; </script> <script src="../main.js"></script> <script defer src="../search-index.js"></script> </body> </html>