trait.Float.html 142 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046
  1. <!DOCTYPE html>
  2. <html lang="en">
  3. <head>
  4. <meta charset="utf-8">
  5. <meta name="viewport" content="width=device-width, initial-scale=1.0">
  6. <meta name="generator" content="rustdoc">
  7. <meta name="description" content="API documentation for the Rust `Float` trait in crate `num_traits`.">
  8. <meta name="keywords" content="rust, rustlang, rust-lang, Float">
  9. <title>num_traits::Float - Rust</title>
  10. <link rel="stylesheet" type="text/css" href="../normalize.css">
  11. <link rel="stylesheet" type="text/css" href="../rustdoc.css" id="mainThemeStyle">
  12. <link rel="stylesheet" type="text/css" href="../dark.css">
  13. <link rel="stylesheet" type="text/css" href="../main.css" id="themeStyle">
  14. <script src="../storage.js"></script>
  15. </head>
  16. <body class="rustdoc trait">
  17. <!--[if lte IE 8]>
  18. <div class="warning">
  19. This old browser is unsupported and will most likely display funky
  20. things.
  21. </div>
  22. <![endif]-->
  23. <nav class="sidebar">
  24. <div class="sidebar-menu">&#9776;</div>
  25. <p class='location'>Trait Float</p><div class="sidebar-elems"><div class="block items"><a class="sidebar-title" href="#required-methods">Required Methods</a><div class="sidebar-links"><a href="#tymethod.nan">nan</a><a href="#tymethod.infinity">infinity</a><a href="#tymethod.neg_infinity">neg_infinity</a><a href="#tymethod.neg_zero">neg_zero</a><a href="#tymethod.min_value">min_value</a><a href="#tymethod.min_positive_value">min_positive_value</a><a href="#tymethod.max_value">max_value</a><a href="#tymethod.is_nan">is_nan</a><a href="#tymethod.is_infinite">is_infinite</a><a href="#tymethod.is_finite">is_finite</a><a href="#tymethod.is_normal">is_normal</a><a href="#tymethod.classify">classify</a><a href="#tymethod.floor">floor</a><a href="#tymethod.ceil">ceil</a><a href="#tymethod.round">round</a><a href="#tymethod.trunc">trunc</a><a href="#tymethod.fract">fract</a><a href="#tymethod.abs">abs</a><a href="#tymethod.signum">signum</a><a href="#tymethod.is_sign_positive">is_sign_positive</a><a href="#tymethod.is_sign_negative">is_sign_negative</a><a href="#tymethod.mul_add">mul_add</a><a href="#tymethod.recip">recip</a><a href="#tymethod.powi">powi</a><a href="#tymethod.powf">powf</a><a href="#tymethod.sqrt">sqrt</a><a href="#tymethod.exp">exp</a><a href="#tymethod.exp2">exp2</a><a href="#tymethod.ln">ln</a><a href="#tymethod.log">log</a><a href="#tymethod.log2">log2</a><a href="#tymethod.log10">log10</a><a href="#tymethod.max">max</a><a href="#tymethod.min">min</a><a href="#tymethod.abs_sub">abs_sub</a><a href="#tymethod.cbrt">cbrt</a><a href="#tymethod.hypot">hypot</a><a href="#tymethod.sin">sin</a><a href="#tymethod.cos">cos</a><a href="#tymethod.tan">tan</a><a href="#tymethod.asin">asin</a><a href="#tymethod.acos">acos</a><a href="#tymethod.atan">atan</a><a href="#tymethod.atan2">atan2</a><a href="#tymethod.sin_cos">sin_cos</a><a href="#tymethod.exp_m1">exp_m1</a><a href="#tymethod.ln_1p">ln_1p</a><a href="#tymethod.sinh">sinh</a><a href="#tymethod.cosh">cosh</a><a href="#tymethod.tanh">tanh</a><a href="#tymethod.asinh">asinh</a><a href="#tymethod.acosh">acosh</a><a href="#tymethod.atanh">atanh</a><a href="#tymethod.integer_decode">integer_decode</a></div><a class="sidebar-title" href="#provided-methods">Provided Methods</a><div class="sidebar-links"><a href="#method.epsilon">epsilon</a><a href="#method.to_degrees">to_degrees</a><a href="#method.to_radians">to_radians</a></div><a class="sidebar-title" href="#foreign-impls">Implementations on Foreign Types</a><div class="sidebar-links"><a href="#impl-Float">f64</a><a href="#impl-Float">f32</a></div><a class="sidebar-title" href="#implementors">Implementors</a></div><p class='location'><a href='index.html'>num_traits</a></p><script>window.sidebarCurrent = {name: 'Float', ty: 'trait', relpath: ''};</script><script defer src="sidebar-items.js"></script></div>
  26. </nav>
  27. <div class="theme-picker">
  28. <button id="theme-picker" aria-label="Pick another theme!">
  29. <img src="../brush.svg" width="18" alt="Pick another theme!">
  30. </button>
  31. <div id="theme-choices"></div>
  32. </div>
  33. <script src="../theme.js"></script>
  34. <nav class="sub">
  35. <form class="search-form js-only">
  36. <div class="search-container">
  37. <input class="search-input" name="search"
  38. autocomplete="off"
  39. placeholder="Click or press ‘S’ to search, ‘?’ for more options…"
  40. type="search">
  41. </div>
  42. </form>
  43. </nav>
  44. <section id='main' class="content">
  45. <h1 class='fqn'><span class='in-band'>Trait <a href='index.html'>num_traits</a>::<wbr><a class="trait" href=''>Float</a></span><span class='out-of-band'><span id='render-detail'>
  46. <a id="toggle-all-docs" href="javascript:void(0)" title="collapse all docs">
  47. [<span class='inner'>&#x2212;</span>]
  48. </a>
  49. </span><a class='srclink' href='../src/num_traits/float.rs.html#885-1794' title='goto source code'>[src]</a></span></h1>
  50. <pre class='rust trait'>pub trait Float: <a class="trait" href="../num_traits/cast/trait.NumCast.html" title="trait num_traits::cast::NumCast">NumCast</a> + <a class="trait" href="../num_traits/trait.Num.html" title="trait num_traits::Num">Num</a> + <a class="trait" href="https://doc.rust-lang.org/nightly/core/marker/trait.Copy.html" title="trait core::marker::Copy">Copy</a> + <a class="trait" href="https://doc.rust-lang.org/nightly/core/ops/arith/trait.Neg.html" title="trait core::ops::arith::Neg">Neg</a>&lt;Output = Self&gt; + <a class="trait" href="https://doc.rust-lang.org/nightly/core/cmp/trait.PartialOrd.html" title="trait core::cmp::PartialOrd">PartialOrd</a>&lt;Self&gt; {
  51. fn <a href='#tymethod.nan' class='fnname'>nan</a>() -&gt; Self;
  52. <div class='item-spacer'></div> fn <a href='#tymethod.infinity' class='fnname'>infinity</a>() -&gt; Self;
  53. <div class='item-spacer'></div> fn <a href='#tymethod.neg_infinity' class='fnname'>neg_infinity</a>() -&gt; Self;
  54. <div class='item-spacer'></div> fn <a href='#tymethod.neg_zero' class='fnname'>neg_zero</a>() -&gt; Self;
  55. <div class='item-spacer'></div> fn <a href='#tymethod.min_value' class='fnname'>min_value</a>() -&gt; Self;
  56. <div class='item-spacer'></div> fn <a href='#tymethod.min_positive_value' class='fnname'>min_positive_value</a>() -&gt; Self;
  57. <div class='item-spacer'></div> fn <a href='#tymethod.max_value' class='fnname'>max_value</a>() -&gt; Self;
  58. <div class='item-spacer'></div> fn <a href='#tymethod.is_nan' class='fnname'>is_nan</a>(self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.bool.html">bool</a>;
  59. <div class='item-spacer'></div> fn <a href='#tymethod.is_infinite' class='fnname'>is_infinite</a>(self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.bool.html">bool</a>;
  60. <div class='item-spacer'></div> fn <a href='#tymethod.is_finite' class='fnname'>is_finite</a>(self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.bool.html">bool</a>;
  61. <div class='item-spacer'></div> fn <a href='#tymethod.is_normal' class='fnname'>is_normal</a>(self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.bool.html">bool</a>;
  62. <div class='item-spacer'></div> fn <a href='#tymethod.classify' class='fnname'>classify</a>(self) -&gt; <a class="enum" href="https://doc.rust-lang.org/nightly/core/num/enum.FpCategory.html" title="enum core::num::FpCategory">FpCategory</a>;
  63. <div class='item-spacer'></div> fn <a href='#tymethod.floor' class='fnname'>floor</a>(self) -&gt; Self;
  64. <div class='item-spacer'></div> fn <a href='#tymethod.ceil' class='fnname'>ceil</a>(self) -&gt; Self;
  65. <div class='item-spacer'></div> fn <a href='#tymethod.round' class='fnname'>round</a>(self) -&gt; Self;
  66. <div class='item-spacer'></div> fn <a href='#tymethod.trunc' class='fnname'>trunc</a>(self) -&gt; Self;
  67. <div class='item-spacer'></div> fn <a href='#tymethod.fract' class='fnname'>fract</a>(self) -&gt; Self;
  68. <div class='item-spacer'></div> fn <a href='#tymethod.abs' class='fnname'>abs</a>(self) -&gt; Self;
  69. <div class='item-spacer'></div> fn <a href='#tymethod.signum' class='fnname'>signum</a>(self) -&gt; Self;
  70. <div class='item-spacer'></div> fn <a href='#tymethod.is_sign_positive' class='fnname'>is_sign_positive</a>(self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.bool.html">bool</a>;
  71. <div class='item-spacer'></div> fn <a href='#tymethod.is_sign_negative' class='fnname'>is_sign_negative</a>(self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.bool.html">bool</a>;
  72. <div class='item-spacer'></div> fn <a href='#tymethod.mul_add' class='fnname'>mul_add</a>(self, a: Self, b: Self) -&gt; Self;
  73. <div class='item-spacer'></div> fn <a href='#tymethod.recip' class='fnname'>recip</a>(self) -&gt; Self;
  74. <div class='item-spacer'></div> fn <a href='#tymethod.powi' class='fnname'>powi</a>(self, n: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.i32.html">i32</a>) -&gt; Self;
  75. <div class='item-spacer'></div> fn <a href='#tymethod.powf' class='fnname'>powf</a>(self, n: Self) -&gt; Self;
  76. <div class='item-spacer'></div> fn <a href='#tymethod.sqrt' class='fnname'>sqrt</a>(self) -&gt; Self;
  77. <div class='item-spacer'></div> fn <a href='#tymethod.exp' class='fnname'>exp</a>(self) -&gt; Self;
  78. <div class='item-spacer'></div> fn <a href='#tymethod.exp2' class='fnname'>exp2</a>(self) -&gt; Self;
  79. <div class='item-spacer'></div> fn <a href='#tymethod.ln' class='fnname'>ln</a>(self) -&gt; Self;
  80. <div class='item-spacer'></div> fn <a href='#tymethod.log' class='fnname'>log</a>(self, base: Self) -&gt; Self;
  81. <div class='item-spacer'></div> fn <a href='#tymethod.log2' class='fnname'>log2</a>(self) -&gt; Self;
  82. <div class='item-spacer'></div> fn <a href='#tymethod.log10' class='fnname'>log10</a>(self) -&gt; Self;
  83. <div class='item-spacer'></div> fn <a href='#tymethod.max' class='fnname'>max</a>(self, other: Self) -&gt; Self;
  84. <div class='item-spacer'></div> fn <a href='#tymethod.min' class='fnname'>min</a>(self, other: Self) -&gt; Self;
  85. <div class='item-spacer'></div> fn <a href='#tymethod.abs_sub' class='fnname'>abs_sub</a>(self, other: Self) -&gt; Self;
  86. <div class='item-spacer'></div> fn <a href='#tymethod.cbrt' class='fnname'>cbrt</a>(self) -&gt; Self;
  87. <div class='item-spacer'></div> fn <a href='#tymethod.hypot' class='fnname'>hypot</a>(self, other: Self) -&gt; Self;
  88. <div class='item-spacer'></div> fn <a href='#tymethod.sin' class='fnname'>sin</a>(self) -&gt; Self;
  89. <div class='item-spacer'></div> fn <a href='#tymethod.cos' class='fnname'>cos</a>(self) -&gt; Self;
  90. <div class='item-spacer'></div> fn <a href='#tymethod.tan' class='fnname'>tan</a>(self) -&gt; Self;
  91. <div class='item-spacer'></div> fn <a href='#tymethod.asin' class='fnname'>asin</a>(self) -&gt; Self;
  92. <div class='item-spacer'></div> fn <a href='#tymethod.acos' class='fnname'>acos</a>(self) -&gt; Self;
  93. <div class='item-spacer'></div> fn <a href='#tymethod.atan' class='fnname'>atan</a>(self) -&gt; Self;
  94. <div class='item-spacer'></div> fn <a href='#tymethod.atan2' class='fnname'>atan2</a>(self, other: Self) -&gt; Self;
  95. <div class='item-spacer'></div> fn <a href='#tymethod.sin_cos' class='fnname'>sin_cos</a>(self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.tuple.html">(</a>Self, Self<a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.tuple.html">)</a>;
  96. <div class='item-spacer'></div> fn <a href='#tymethod.exp_m1' class='fnname'>exp_m1</a>(self) -&gt; Self;
  97. <div class='item-spacer'></div> fn <a href='#tymethod.ln_1p' class='fnname'>ln_1p</a>(self) -&gt; Self;
  98. <div class='item-spacer'></div> fn <a href='#tymethod.sinh' class='fnname'>sinh</a>(self) -&gt; Self;
  99. <div class='item-spacer'></div> fn <a href='#tymethod.cosh' class='fnname'>cosh</a>(self) -&gt; Self;
  100. <div class='item-spacer'></div> fn <a href='#tymethod.tanh' class='fnname'>tanh</a>(self) -&gt; Self;
  101. <div class='item-spacer'></div> fn <a href='#tymethod.asinh' class='fnname'>asinh</a>(self) -&gt; Self;
  102. <div class='item-spacer'></div> fn <a href='#tymethod.acosh' class='fnname'>acosh</a>(self) -&gt; Self;
  103. <div class='item-spacer'></div> fn <a href='#tymethod.atanh' class='fnname'>atanh</a>(self) -&gt; Self;
  104. <div class='item-spacer'></div> fn <a href='#tymethod.integer_decode' class='fnname'>integer_decode</a>(self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.tuple.html">(</a><a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u64.html">u64</a>, <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.i16.html">i16</a>, <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.i8.html">i8</a><a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.tuple.html">)</a>;
  105. fn <a href='#method.epsilon' class='fnname'>epsilon</a>() -&gt; Self { ... }
  106. <div class='item-spacer'></div> fn <a href='#method.to_degrees' class='fnname'>to_degrees</a>(self) -&gt; Self { ... }
  107. <div class='item-spacer'></div> fn <a href='#method.to_radians' class='fnname'>to_radians</a>(self) -&gt; Self { ... }
  108. }</pre><div class='docblock'><p>Generic trait for floating point numbers</p>
  109. <p>This trait is only available with the <code>std</code> feature.</p>
  110. </div>
  111. <h2 id='required-methods' class='small-section-header'>
  112. Required Methods<a href='#required-methods' class='anchor'></a>
  113. </h2>
  114. <div class='methods'>
  115. <h3 id='tymethod.nan' class='method'><span id='nan.v' class='invisible'><code>fn <a href='#tymethod.nan' class='fnname'>nan</a>() -&gt; Self</code></span></h3><div class='docblock'><p>Returns the <code>NaN</code> value.</p>
  116. <pre class="rust rust-example-rendered">
  117. <span class="kw">use</span> <span class="ident">num_traits</span>::<span class="ident">Float</span>;
  118. <span class="kw">let</span> <span class="ident">nan</span>: <span class="ident">f32</span> <span class="op">=</span> <span class="ident">Float</span>::<span class="ident">nan</span>();
  119. <span class="macro">assert</span><span class="macro">!</span>(<span class="ident">nan</span>.<span class="ident">is_nan</span>());</pre>
  120. </div><h3 id='tymethod.infinity' class='method'><span id='infinity.v' class='invisible'><code>fn <a href='#tymethod.infinity' class='fnname'>infinity</a>() -&gt; Self</code></span></h3><div class='docblock'><p>Returns the infinite value.</p>
  121. <pre class="rust rust-example-rendered">
  122. <span class="kw">use</span> <span class="ident">num_traits</span>::<span class="ident">Float</span>;
  123. <span class="kw">use</span> <span class="ident">std</span>::<span class="ident">f32</span>;
  124. <span class="kw">let</span> <span class="ident">infinity</span>: <span class="ident">f32</span> <span class="op">=</span> <span class="ident">Float</span>::<span class="ident">infinity</span>();
  125. <span class="macro">assert</span><span class="macro">!</span>(<span class="ident">infinity</span>.<span class="ident">is_infinite</span>());
  126. <span class="macro">assert</span><span class="macro">!</span>(<span class="op">!</span><span class="ident">infinity</span>.<span class="ident">is_finite</span>());
  127. <span class="macro">assert</span><span class="macro">!</span>(<span class="ident">infinity</span> <span class="op">&gt;</span> <span class="ident">f32</span>::<span class="ident">MAX</span>);</pre>
  128. </div><h3 id='tymethod.neg_infinity' class='method'><span id='neg_infinity.v' class='invisible'><code>fn <a href='#tymethod.neg_infinity' class='fnname'>neg_infinity</a>() -&gt; Self</code></span></h3><div class='docblock'><p>Returns the negative infinite value.</p>
  129. <pre class="rust rust-example-rendered">
  130. <span class="kw">use</span> <span class="ident">num_traits</span>::<span class="ident">Float</span>;
  131. <span class="kw">use</span> <span class="ident">std</span>::<span class="ident">f32</span>;
  132. <span class="kw">let</span> <span class="ident">neg_infinity</span>: <span class="ident">f32</span> <span class="op">=</span> <span class="ident">Float</span>::<span class="ident">neg_infinity</span>();
  133. <span class="macro">assert</span><span class="macro">!</span>(<span class="ident">neg_infinity</span>.<span class="ident">is_infinite</span>());
  134. <span class="macro">assert</span><span class="macro">!</span>(<span class="op">!</span><span class="ident">neg_infinity</span>.<span class="ident">is_finite</span>());
  135. <span class="macro">assert</span><span class="macro">!</span>(<span class="ident">neg_infinity</span> <span class="op">&lt;</span> <span class="ident">f32</span>::<span class="ident">MIN</span>);</pre>
  136. </div><h3 id='tymethod.neg_zero' class='method'><span id='neg_zero.v' class='invisible'><code>fn <a href='#tymethod.neg_zero' class='fnname'>neg_zero</a>() -&gt; Self</code></span></h3><div class='docblock'><p>Returns <code>-0.0</code>.</p>
  137. <pre class="rust rust-example-rendered">
  138. <span class="kw">use</span> <span class="ident">num_traits</span>::{<span class="ident">Zero</span>, <span class="ident">Float</span>};
  139. <span class="kw">let</span> <span class="ident">inf</span>: <span class="ident">f32</span> <span class="op">=</span> <span class="ident">Float</span>::<span class="ident">infinity</span>();
  140. <span class="kw">let</span> <span class="ident">zero</span>: <span class="ident">f32</span> <span class="op">=</span> <span class="ident">Zero</span>::<span class="ident">zero</span>();
  141. <span class="kw">let</span> <span class="ident">neg_zero</span>: <span class="ident">f32</span> <span class="op">=</span> <span class="ident">Float</span>::<span class="ident">neg_zero</span>();
  142. <span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">zero</span>, <span class="ident">neg_zero</span>);
  143. <span class="macro">assert_eq</span><span class="macro">!</span>(<span class="number">7.0f32</span><span class="op">/</span><span class="ident">inf</span>, <span class="ident">zero</span>);
  144. <span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">zero</span> <span class="op">*</span> <span class="number">10.0</span>, <span class="ident">zero</span>);</pre>
  145. </div><h3 id='tymethod.min_value' class='method'><span id='min_value.v' class='invisible'><code>fn <a href='#tymethod.min_value' class='fnname'>min_value</a>() -&gt; Self</code></span></h3><div class='docblock'><p>Returns the smallest finite value that this type can represent.</p>
  146. <pre class="rust rust-example-rendered">
  147. <span class="kw">use</span> <span class="ident">num_traits</span>::<span class="ident">Float</span>;
  148. <span class="kw">use</span> <span class="ident">std</span>::<span class="ident">f64</span>;
  149. <span class="kw">let</span> <span class="ident">x</span>: <span class="ident">f64</span> <span class="op">=</span> <span class="ident">Float</span>::<span class="ident">min_value</span>();
  150. <span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">x</span>, <span class="ident">f64</span>::<span class="ident">MIN</span>);</pre>
  151. </div><h3 id='tymethod.min_positive_value' class='method'><span id='min_positive_value.v' class='invisible'><code>fn <a href='#tymethod.min_positive_value' class='fnname'>min_positive_value</a>() -&gt; Self</code></span></h3><div class='docblock'><p>Returns the smallest positive, normalized value that this type can represent.</p>
  152. <pre class="rust rust-example-rendered">
  153. <span class="kw">use</span> <span class="ident">num_traits</span>::<span class="ident">Float</span>;
  154. <span class="kw">use</span> <span class="ident">std</span>::<span class="ident">f64</span>;
  155. <span class="kw">let</span> <span class="ident">x</span>: <span class="ident">f64</span> <span class="op">=</span> <span class="ident">Float</span>::<span class="ident">min_positive_value</span>();
  156. <span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">x</span>, <span class="ident">f64</span>::<span class="ident">MIN_POSITIVE</span>);</pre>
  157. </div><h3 id='tymethod.max_value' class='method'><span id='max_value.v' class='invisible'><code>fn <a href='#tymethod.max_value' class='fnname'>max_value</a>() -&gt; Self</code></span></h3><div class='docblock'><p>Returns the largest finite value that this type can represent.</p>
  158. <pre class="rust rust-example-rendered">
  159. <span class="kw">use</span> <span class="ident">num_traits</span>::<span class="ident">Float</span>;
  160. <span class="kw">use</span> <span class="ident">std</span>::<span class="ident">f64</span>;
  161. <span class="kw">let</span> <span class="ident">x</span>: <span class="ident">f64</span> <span class="op">=</span> <span class="ident">Float</span>::<span class="ident">max_value</span>();
  162. <span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">x</span>, <span class="ident">f64</span>::<span class="ident">MAX</span>);</pre>
  163. </div><h3 id='tymethod.is_nan' class='method'><span id='is_nan.v' class='invisible'><code>fn <a href='#tymethod.is_nan' class='fnname'>is_nan</a>(self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.bool.html">bool</a></code></span></h3><div class='docblock'><p>Returns <code>true</code> if this value is <code>NaN</code> and false otherwise.</p>
  164. <pre class="rust rust-example-rendered">
  165. <span class="kw">use</span> <span class="ident">num_traits</span>::<span class="ident">Float</span>;
  166. <span class="kw">use</span> <span class="ident">std</span>::<span class="ident">f64</span>;
  167. <span class="kw">let</span> <span class="ident">nan</span> <span class="op">=</span> <span class="ident">f64</span>::<span class="ident">NAN</span>;
  168. <span class="kw">let</span> <span class="ident">f</span> <span class="op">=</span> <span class="number">7.0</span>;
  169. <span class="macro">assert</span><span class="macro">!</span>(<span class="ident">nan</span>.<span class="ident">is_nan</span>());
  170. <span class="macro">assert</span><span class="macro">!</span>(<span class="op">!</span><span class="ident">f</span>.<span class="ident">is_nan</span>());</pre>
  171. </div><h3 id='tymethod.is_infinite' class='method'><span id='is_infinite.v' class='invisible'><code>fn <a href='#tymethod.is_infinite' class='fnname'>is_infinite</a>(self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.bool.html">bool</a></code></span></h3><div class='docblock'><p>Returns <code>true</code> if this value is positive infinity or negative infinity and
  172. false otherwise.</p>
  173. <pre class="rust rust-example-rendered">
  174. <span class="kw">use</span> <span class="ident">num_traits</span>::<span class="ident">Float</span>;
  175. <span class="kw">use</span> <span class="ident">std</span>::<span class="ident">f32</span>;
  176. <span class="kw">let</span> <span class="ident">f</span> <span class="op">=</span> <span class="number">7.0f32</span>;
  177. <span class="kw">let</span> <span class="ident">inf</span>: <span class="ident">f32</span> <span class="op">=</span> <span class="ident">Float</span>::<span class="ident">infinity</span>();
  178. <span class="kw">let</span> <span class="ident">neg_inf</span>: <span class="ident">f32</span> <span class="op">=</span> <span class="ident">Float</span>::<span class="ident">neg_infinity</span>();
  179. <span class="kw">let</span> <span class="ident">nan</span>: <span class="ident">f32</span> <span class="op">=</span> <span class="ident">f32</span>::<span class="ident">NAN</span>;
  180. <span class="macro">assert</span><span class="macro">!</span>(<span class="op">!</span><span class="ident">f</span>.<span class="ident">is_infinite</span>());
  181. <span class="macro">assert</span><span class="macro">!</span>(<span class="op">!</span><span class="ident">nan</span>.<span class="ident">is_infinite</span>());
  182. <span class="macro">assert</span><span class="macro">!</span>(<span class="ident">inf</span>.<span class="ident">is_infinite</span>());
  183. <span class="macro">assert</span><span class="macro">!</span>(<span class="ident">neg_inf</span>.<span class="ident">is_infinite</span>());</pre>
  184. </div><h3 id='tymethod.is_finite' class='method'><span id='is_finite.v' class='invisible'><code>fn <a href='#tymethod.is_finite' class='fnname'>is_finite</a>(self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.bool.html">bool</a></code></span></h3><div class='docblock'><p>Returns <code>true</code> if this number is neither infinite nor <code>NaN</code>.</p>
  185. <pre class="rust rust-example-rendered">
  186. <span class="kw">use</span> <span class="ident">num_traits</span>::<span class="ident">Float</span>;
  187. <span class="kw">use</span> <span class="ident">std</span>::<span class="ident">f32</span>;
  188. <span class="kw">let</span> <span class="ident">f</span> <span class="op">=</span> <span class="number">7.0f32</span>;
  189. <span class="kw">let</span> <span class="ident">inf</span>: <span class="ident">f32</span> <span class="op">=</span> <span class="ident">Float</span>::<span class="ident">infinity</span>();
  190. <span class="kw">let</span> <span class="ident">neg_inf</span>: <span class="ident">f32</span> <span class="op">=</span> <span class="ident">Float</span>::<span class="ident">neg_infinity</span>();
  191. <span class="kw">let</span> <span class="ident">nan</span>: <span class="ident">f32</span> <span class="op">=</span> <span class="ident">f32</span>::<span class="ident">NAN</span>;
  192. <span class="macro">assert</span><span class="macro">!</span>(<span class="ident">f</span>.<span class="ident">is_finite</span>());
  193. <span class="macro">assert</span><span class="macro">!</span>(<span class="op">!</span><span class="ident">nan</span>.<span class="ident">is_finite</span>());
  194. <span class="macro">assert</span><span class="macro">!</span>(<span class="op">!</span><span class="ident">inf</span>.<span class="ident">is_finite</span>());
  195. <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>());</pre>
  196. </div><h3 id='tymethod.is_normal' class='method'><span id='is_normal.v' class='invisible'><code>fn <a href='#tymethod.is_normal' class='fnname'>is_normal</a>(self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.bool.html">bool</a></code></span></h3><div class='docblock'><p>Returns <code>true</code> if the number is neither zero, infinite,
  197. <a href="http://en.wikipedia.org/wiki/Denormal_number">subnormal</a>, or <code>NaN</code>.</p>
  198. <pre class="rust rust-example-rendered">
  199. <span class="kw">use</span> <span class="ident">num_traits</span>::<span class="ident">Float</span>;
  200. <span class="kw">use</span> <span class="ident">std</span>::<span class="ident">f32</span>;
  201. <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>
  202. <span class="kw">let</span> <span class="ident">max</span> <span class="op">=</span> <span class="ident">f32</span>::<span class="ident">MAX</span>;
  203. <span class="kw">let</span> <span class="ident">lower_than_min</span> <span class="op">=</span> <span class="number">1.0e-40_f32</span>;
  204. <span class="kw">let</span> <span class="ident">zero</span> <span class="op">=</span> <span class="number">0.0f32</span>;
  205. <span class="macro">assert</span><span class="macro">!</span>(<span class="ident">min</span>.<span class="ident">is_normal</span>());
  206. <span class="macro">assert</span><span class="macro">!</span>(<span class="ident">max</span>.<span class="ident">is_normal</span>());
  207. <span class="macro">assert</span><span class="macro">!</span>(<span class="op">!</span><span class="ident">zero</span>.<span class="ident">is_normal</span>());
  208. <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>());
  209. <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>());
  210. <span class="comment">// Values between `0` and `min` are Subnormal.</span>
  211. <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>());</pre>
  212. </div><h3 id='tymethod.classify' class='method'><span id='classify.v' class='invisible'><code>fn <a href='#tymethod.classify' class='fnname'>classify</a>(self) -&gt; <a class="enum" href="https://doc.rust-lang.org/nightly/core/num/enum.FpCategory.html" title="enum core::num::FpCategory">FpCategory</a></code></span></h3><div class='docblock'><p>Returns the floating point category of the number. If only one property
  213. is going to be tested, it is generally faster to use the specific
  214. predicate instead.</p>
  215. <pre class="rust rust-example-rendered">
  216. <span class="kw">use</span> <span class="ident">num_traits</span>::<span class="ident">Float</span>;
  217. <span class="kw">use</span> <span class="ident">std</span>::<span class="ident">num</span>::<span class="ident">FpCategory</span>;
  218. <span class="kw">use</span> <span class="ident">std</span>::<span class="ident">f32</span>;
  219. <span class="kw">let</span> <span class="ident">num</span> <span class="op">=</span> <span class="number">12.4f32</span>;
  220. <span class="kw">let</span> <span class="ident">inf</span> <span class="op">=</span> <span class="ident">f32</span>::<span class="ident">INFINITY</span>;
  221. <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>);
  222. <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>);</pre>
  223. </div><h3 id='tymethod.floor' class='method'><span id='floor.v' class='invisible'><code>fn <a href='#tymethod.floor' class='fnname'>floor</a>(self) -&gt; Self</code></span></h3><div class='docblock'><p>Returns the largest integer less than or equal to a number.</p>
  224. <pre class="rust rust-example-rendered">
  225. <span class="kw">use</span> <span class="ident">num_traits</span>::<span class="ident">Float</span>;
  226. <span class="kw">let</span> <span class="ident">f</span> <span class="op">=</span> <span class="number">3.99</span>;
  227. <span class="kw">let</span> <span class="ident">g</span> <span class="op">=</span> <span class="number">3.0</span>;
  228. <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>);
  229. <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>);</pre>
  230. </div><h3 id='tymethod.ceil' class='method'><span id='ceil.v' class='invisible'><code>fn <a href='#tymethod.ceil' class='fnname'>ceil</a>(self) -&gt; Self</code></span></h3><div class='docblock'><p>Returns the smallest integer greater than or equal to a number.</p>
  231. <pre class="rust rust-example-rendered">
  232. <span class="kw">use</span> <span class="ident">num_traits</span>::<span class="ident">Float</span>;
  233. <span class="kw">let</span> <span class="ident">f</span> <span class="op">=</span> <span class="number">3.01</span>;
  234. <span class="kw">let</span> <span class="ident">g</span> <span class="op">=</span> <span class="number">4.0</span>;
  235. <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>);
  236. <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>);</pre>
  237. </div><h3 id='tymethod.round' class='method'><span id='round.v' class='invisible'><code>fn <a href='#tymethod.round' class='fnname'>round</a>(self) -&gt; Self</code></span></h3><div class='docblock'><p>Returns the nearest integer to a number. Round half-way cases away from
  238. <code>0.0</code>.</p>
  239. <pre class="rust rust-example-rendered">
  240. <span class="kw">use</span> <span class="ident">num_traits</span>::<span class="ident">Float</span>;
  241. <span class="kw">let</span> <span class="ident">f</span> <span class="op">=</span> <span class="number">3.3</span>;
  242. <span class="kw">let</span> <span class="ident">g</span> <span class="op">=</span> <span class="op">-</span><span class="number">3.3</span>;
  243. <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>);
  244. <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>);</pre>
  245. </div><h3 id='tymethod.trunc' class='method'><span id='trunc.v' class='invisible'><code>fn <a href='#tymethod.trunc' class='fnname'>trunc</a>(self) -&gt; Self</code></span></h3><div class='docblock'><p>Return the integer part of a number.</p>
  246. <pre class="rust rust-example-rendered">
  247. <span class="kw">use</span> <span class="ident">num_traits</span>::<span class="ident">Float</span>;
  248. <span class="kw">let</span> <span class="ident">f</span> <span class="op">=</span> <span class="number">3.3</span>;
  249. <span class="kw">let</span> <span class="ident">g</span> <span class="op">=</span> <span class="op">-</span><span class="number">3.7</span>;
  250. <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>);
  251. <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>);</pre>
  252. </div><h3 id='tymethod.fract' class='method'><span id='fract.v' class='invisible'><code>fn <a href='#tymethod.fract' class='fnname'>fract</a>(self) -&gt; Self</code></span></h3><div class='docblock'><p>Returns the fractional part of a number.</p>
  253. <pre class="rust rust-example-rendered">
  254. <span class="kw">use</span> <span class="ident">num_traits</span>::<span class="ident">Float</span>;
  255. <span class="kw">let</span> <span class="ident">x</span> <span class="op">=</span> <span class="number">3.5</span>;
  256. <span class="kw">let</span> <span class="ident">y</span> <span class="op">=</span> <span class="op">-</span><span class="number">3.5</span>;
  257. <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>();
  258. <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>();
  259. <span class="macro">assert</span><span class="macro">!</span>(<span class="ident">abs_difference_x</span> <span class="op">&lt;</span> <span class="number">1e-10</span>);
  260. <span class="macro">assert</span><span class="macro">!</span>(<span class="ident">abs_difference_y</span> <span class="op">&lt;</span> <span class="number">1e-10</span>);</pre>
  261. </div><h3 id='tymethod.abs' class='method'><span id='abs.v' class='invisible'><code>fn <a href='#tymethod.abs' class='fnname'>abs</a>(self) -&gt; Self</code></span></h3><div class='docblock'><p>Computes the absolute value of <code>self</code>. Returns <code>Float::nan()</code> if the
  262. number is <code>Float::nan()</code>.</p>
  263. <pre class="rust rust-example-rendered">
  264. <span class="kw">use</span> <span class="ident">num_traits</span>::<span class="ident">Float</span>;
  265. <span class="kw">use</span> <span class="ident">std</span>::<span class="ident">f64</span>;
  266. <span class="kw">let</span> <span class="ident">x</span> <span class="op">=</span> <span class="number">3.5</span>;
  267. <span class="kw">let</span> <span class="ident">y</span> <span class="op">=</span> <span class="op">-</span><span class="number">3.5</span>;
  268. <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>();
  269. <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>();
  270. <span class="macro">assert</span><span class="macro">!</span>(<span class="ident">abs_difference_x</span> <span class="op">&lt;</span> <span class="number">1e-10</span>);
  271. <span class="macro">assert</span><span class="macro">!</span>(<span class="ident">abs_difference_y</span> <span class="op">&lt;</span> <span class="number">1e-10</span>);
  272. <span class="macro">assert</span><span class="macro">!</span>(<span class="ident">f64</span>::<span class="ident">NAN</span>.<span class="ident">abs</span>().<span class="ident">is_nan</span>());</pre>
  273. </div><h3 id='tymethod.signum' class='method'><span id='signum.v' class='invisible'><code>fn <a href='#tymethod.signum' class='fnname'>signum</a>(self) -&gt; Self</code></span></h3><div class='docblock'><p>Returns a number that represents the sign of <code>self</code>.</p>
  274. <ul>
  275. <li><code>1.0</code> if the number is positive, <code>+0.0</code> or <code>Float::infinity()</code></li>
  276. <li><code>-1.0</code> if the number is negative, <code>-0.0</code> or <code>Float::neg_infinity()</code></li>
  277. <li><code>Float::nan()</code> if the number is <code>Float::nan()</code></li>
  278. </ul>
  279. <pre class="rust rust-example-rendered">
  280. <span class="kw">use</span> <span class="ident">num_traits</span>::<span class="ident">Float</span>;
  281. <span class="kw">use</span> <span class="ident">std</span>::<span class="ident">f64</span>;
  282. <span class="kw">let</span> <span class="ident">f</span> <span class="op">=</span> <span class="number">3.5</span>;
  283. <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>);
  284. <span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">f64</span>::<span class="ident">NEG_INFINITY</span>.<span class="ident">signum</span>(), <span class="op">-</span><span class="number">1.0</span>);
  285. <span class="macro">assert</span><span class="macro">!</span>(<span class="ident">f64</span>::<span class="ident">NAN</span>.<span class="ident">signum</span>().<span class="ident">is_nan</span>());</pre>
  286. </div><h3 id='tymethod.is_sign_positive' class='method'><span id='is_sign_positive.v' class='invisible'><code>fn <a href='#tymethod.is_sign_positive' class='fnname'>is_sign_positive</a>(self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.bool.html">bool</a></code></span></h3><div class='docblock'><p>Returns <code>true</code> if <code>self</code> is positive, including <code>+0.0</code>,
  287. <code>Float::infinity()</code>, and since Rust 1.20 also <code>Float::nan()</code>.</p>
  288. <pre class="rust rust-example-rendered">
  289. <span class="kw">use</span> <span class="ident">num_traits</span>::<span class="ident">Float</span>;
  290. <span class="kw">use</span> <span class="ident">std</span>::<span class="ident">f64</span>;
  291. <span class="kw">let</span> <span class="ident">neg_nan</span>: <span class="ident">f64</span> <span class="op">=</span> <span class="op">-</span><span class="ident">f64</span>::<span class="ident">NAN</span>;
  292. <span class="kw">let</span> <span class="ident">f</span> <span class="op">=</span> <span class="number">7.0</span>;
  293. <span class="kw">let</span> <span class="ident">g</span> <span class="op">=</span> <span class="op">-</span><span class="number">7.0</span>;
  294. <span class="macro">assert</span><span class="macro">!</span>(<span class="ident">f</span>.<span class="ident">is_sign_positive</span>());
  295. <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>());
  296. <span class="macro">assert</span><span class="macro">!</span>(<span class="op">!</span><span class="ident">neg_nan</span>.<span class="ident">is_sign_positive</span>());</pre>
  297. </div><h3 id='tymethod.is_sign_negative' class='method'><span id='is_sign_negative.v' class='invisible'><code>fn <a href='#tymethod.is_sign_negative' class='fnname'>is_sign_negative</a>(self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.bool.html">bool</a></code></span></h3><div class='docblock'><p>Returns <code>true</code> if <code>self</code> is negative, including <code>-0.0</code>,
  298. <code>Float::neg_infinity()</code>, and since Rust 1.20 also <code>-Float::nan()</code>.</p>
  299. <pre class="rust rust-example-rendered">
  300. <span class="kw">use</span> <span class="ident">num_traits</span>::<span class="ident">Float</span>;
  301. <span class="kw">use</span> <span class="ident">std</span>::<span class="ident">f64</span>;
  302. <span class="kw">let</span> <span class="ident">nan</span>: <span class="ident">f64</span> <span class="op">=</span> <span class="ident">f64</span>::<span class="ident">NAN</span>;
  303. <span class="kw">let</span> <span class="ident">f</span> <span class="op">=</span> <span class="number">7.0</span>;
  304. <span class="kw">let</span> <span class="ident">g</span> <span class="op">=</span> <span class="op">-</span><span class="number">7.0</span>;
  305. <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>());
  306. <span class="macro">assert</span><span class="macro">!</span>(<span class="ident">g</span>.<span class="ident">is_sign_negative</span>());
  307. <span class="macro">assert</span><span class="macro">!</span>(<span class="op">!</span><span class="ident">nan</span>.<span class="ident">is_sign_negative</span>());</pre>
  308. </div><h3 id='tymethod.mul_add' class='method'><span id='mul_add.v' class='invisible'><code>fn <a href='#tymethod.mul_add' class='fnname'>mul_add</a>(self, a: Self, b: Self) -&gt; Self</code></span></h3><div class='docblock'><p>Fused multiply-add. Computes <code>(self * a) + b</code> with only one rounding
  309. error. This produces a more accurate result with better performance than
  310. a separate multiplication operation followed by an add.</p>
  311. <pre class="rust rust-example-rendered">
  312. <span class="kw">use</span> <span class="ident">num_traits</span>::<span class="ident">Float</span>;
  313. <span class="kw">let</span> <span class="ident">m</span> <span class="op">=</span> <span class="number">10.0</span>;
  314. <span class="kw">let</span> <span class="ident">x</span> <span class="op">=</span> <span class="number">4.0</span>;
  315. <span class="kw">let</span> <span class="ident">b</span> <span class="op">=</span> <span class="number">60.0</span>;
  316. <span class="comment">// 100.0</span>
  317. <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>();
  318. <span class="macro">assert</span><span class="macro">!</span>(<span class="ident">abs_difference</span> <span class="op">&lt;</span> <span class="number">1e-10</span>);</pre>
  319. </div><h3 id='tymethod.recip' class='method'><span id='recip.v' class='invisible'><code>fn <a href='#tymethod.recip' class='fnname'>recip</a>(self) -&gt; Self</code></span></h3><div class='docblock'><p>Take the reciprocal (inverse) of a number, <code>1/x</code>.</p>
  320. <pre class="rust rust-example-rendered">
  321. <span class="kw">use</span> <span class="ident">num_traits</span>::<span class="ident">Float</span>;
  322. <span class="kw">let</span> <span class="ident">x</span> <span class="op">=</span> <span class="number">2.0</span>;
  323. <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>();
  324. <span class="macro">assert</span><span class="macro">!</span>(<span class="ident">abs_difference</span> <span class="op">&lt;</span> <span class="number">1e-10</span>);</pre>
  325. </div><h3 id='tymethod.powi' class='method'><span id='powi.v' class='invisible'><code>fn <a href='#tymethod.powi' class='fnname'>powi</a>(self, n: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.i32.html">i32</a>) -&gt; Self</code></span></h3><div class='docblock'><p>Raise a number to an integer power.</p>
  326. <p>Using this function is generally faster than using <code>powf</code></p>
  327. <pre class="rust rust-example-rendered">
  328. <span class="kw">use</span> <span class="ident">num_traits</span>::<span class="ident">Float</span>;
  329. <span class="kw">let</span> <span class="ident">x</span> <span class="op">=</span> <span class="number">2.0</span>;
  330. <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>();
  331. <span class="macro">assert</span><span class="macro">!</span>(<span class="ident">abs_difference</span> <span class="op">&lt;</span> <span class="number">1e-10</span>);</pre>
  332. </div><h3 id='tymethod.powf' class='method'><span id='powf.v' class='invisible'><code>fn <a href='#tymethod.powf' class='fnname'>powf</a>(self, n: Self) -&gt; Self</code></span></h3><div class='docblock'><p>Raise a number to a floating point power.</p>
  333. <pre class="rust rust-example-rendered">
  334. <span class="kw">use</span> <span class="ident">num_traits</span>::<span class="ident">Float</span>;
  335. <span class="kw">let</span> <span class="ident">x</span> <span class="op">=</span> <span class="number">2.0</span>;
  336. <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>();
  337. <span class="macro">assert</span><span class="macro">!</span>(<span class="ident">abs_difference</span> <span class="op">&lt;</span> <span class="number">1e-10</span>);</pre>
  338. </div><h3 id='tymethod.sqrt' class='method'><span id='sqrt.v' class='invisible'><code>fn <a href='#tymethod.sqrt' class='fnname'>sqrt</a>(self) -&gt; Self</code></span></h3><div class='docblock'><p>Take the square root of a number.</p>
  339. <p>Returns NaN if <code>self</code> is a negative number.</p>
  340. <pre class="rust rust-example-rendered">
  341. <span class="kw">use</span> <span class="ident">num_traits</span>::<span class="ident">Float</span>;
  342. <span class="kw">let</span> <span class="ident">positive</span> <span class="op">=</span> <span class="number">4.0</span>;
  343. <span class="kw">let</span> <span class="ident">negative</span> <span class="op">=</span> <span class="op">-</span><span class="number">4.0</span>;
  344. <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>();
  345. <span class="macro">assert</span><span class="macro">!</span>(<span class="ident">abs_difference</span> <span class="op">&lt;</span> <span class="number">1e-10</span>);
  346. <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>());</pre>
  347. </div><h3 id='tymethod.exp' class='method'><span id='exp.v' class='invisible'><code>fn <a href='#tymethod.exp' class='fnname'>exp</a>(self) -&gt; Self</code></span></h3><div class='docblock'><p>Returns <code>e^(self)</code>, (the exponential function).</p>
  348. <pre class="rust rust-example-rendered">
  349. <span class="kw">use</span> <span class="ident">num_traits</span>::<span class="ident">Float</span>;
  350. <span class="kw">let</span> <span class="ident">one</span> <span class="op">=</span> <span class="number">1.0</span>;
  351. <span class="comment">// e^1</span>
  352. <span class="kw">let</span> <span class="ident">e</span> <span class="op">=</span> <span class="ident">one</span>.<span class="ident">exp</span>();
  353. <span class="comment">// ln(e) - 1 == 0</span>
  354. <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>();
  355. <span class="macro">assert</span><span class="macro">!</span>(<span class="ident">abs_difference</span> <span class="op">&lt;</span> <span class="number">1e-10</span>);</pre>
  356. </div><h3 id='tymethod.exp2' class='method'><span id='exp2.v' class='invisible'><code>fn <a href='#tymethod.exp2' class='fnname'>exp2</a>(self) -&gt; Self</code></span></h3><div class='docblock'><p>Returns <code>2^(self)</code>.</p>
  357. <pre class="rust rust-example-rendered">
  358. <span class="kw">use</span> <span class="ident">num_traits</span>::<span class="ident">Float</span>;
  359. <span class="kw">let</span> <span class="ident">f</span> <span class="op">=</span> <span class="number">2.0</span>;
  360. <span class="comment">// 2^2 - 4 == 0</span>
  361. <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>();
  362. <span class="macro">assert</span><span class="macro">!</span>(<span class="ident">abs_difference</span> <span class="op">&lt;</span> <span class="number">1e-10</span>);</pre>
  363. </div><h3 id='tymethod.ln' class='method'><span id='ln.v' class='invisible'><code>fn <a href='#tymethod.ln' class='fnname'>ln</a>(self) -&gt; Self</code></span></h3><div class='docblock'><p>Returns the natural logarithm of the number.</p>
  364. <pre class="rust rust-example-rendered">
  365. <span class="kw">use</span> <span class="ident">num_traits</span>::<span class="ident">Float</span>;
  366. <span class="kw">let</span> <span class="ident">one</span> <span class="op">=</span> <span class="number">1.0</span>;
  367. <span class="comment">// e^1</span>
  368. <span class="kw">let</span> <span class="ident">e</span> <span class="op">=</span> <span class="ident">one</span>.<span class="ident">exp</span>();
  369. <span class="comment">// ln(e) - 1 == 0</span>
  370. <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>();
  371. <span class="macro">assert</span><span class="macro">!</span>(<span class="ident">abs_difference</span> <span class="op">&lt;</span> <span class="number">1e-10</span>);</pre>
  372. </div><h3 id='tymethod.log' class='method'><span id='log.v' class='invisible'><code>fn <a href='#tymethod.log' class='fnname'>log</a>(self, base: Self) -&gt; Self</code></span></h3><div class='docblock'><p>Returns the logarithm of the number with respect to an arbitrary base.</p>
  373. <pre class="rust rust-example-rendered">
  374. <span class="kw">use</span> <span class="ident">num_traits</span>::<span class="ident">Float</span>;
  375. <span class="kw">let</span> <span class="ident">ten</span> <span class="op">=</span> <span class="number">10.0</span>;
  376. <span class="kw">let</span> <span class="ident">two</span> <span class="op">=</span> <span class="number">2.0</span>;
  377. <span class="comment">// log10(10) - 1 == 0</span>
  378. <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>();
  379. <span class="comment">// log2(2) - 1 == 0</span>
  380. <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>();
  381. <span class="macro">assert</span><span class="macro">!</span>(<span class="ident">abs_difference_10</span> <span class="op">&lt;</span> <span class="number">1e-10</span>);
  382. <span class="macro">assert</span><span class="macro">!</span>(<span class="ident">abs_difference_2</span> <span class="op">&lt;</span> <span class="number">1e-10</span>);</pre>
  383. </div><h3 id='tymethod.log2' class='method'><span id='log2.v' class='invisible'><code>fn <a href='#tymethod.log2' class='fnname'>log2</a>(self) -&gt; Self</code></span></h3><div class='docblock'><p>Returns the base 2 logarithm of the number.</p>
  384. <pre class="rust rust-example-rendered">
  385. <span class="kw">use</span> <span class="ident">num_traits</span>::<span class="ident">Float</span>;
  386. <span class="kw">let</span> <span class="ident">two</span> <span class="op">=</span> <span class="number">2.0</span>;
  387. <span class="comment">// log2(2) - 1 == 0</span>
  388. <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>();
  389. <span class="macro">assert</span><span class="macro">!</span>(<span class="ident">abs_difference</span> <span class="op">&lt;</span> <span class="number">1e-10</span>);</pre>
  390. </div><h3 id='tymethod.log10' class='method'><span id='log10.v' class='invisible'><code>fn <a href='#tymethod.log10' class='fnname'>log10</a>(self) -&gt; Self</code></span></h3><div class='docblock'><p>Returns the base 10 logarithm of the number.</p>
  391. <pre class="rust rust-example-rendered">
  392. <span class="kw">use</span> <span class="ident">num_traits</span>::<span class="ident">Float</span>;
  393. <span class="kw">let</span> <span class="ident">ten</span> <span class="op">=</span> <span class="number">10.0</span>;
  394. <span class="comment">// log10(10) - 1 == 0</span>
  395. <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>();
  396. <span class="macro">assert</span><span class="macro">!</span>(<span class="ident">abs_difference</span> <span class="op">&lt;</span> <span class="number">1e-10</span>);</pre>
  397. </div><h3 id='tymethod.max' class='method'><span id='max.v' class='invisible'><code>fn <a href='#tymethod.max' class='fnname'>max</a>(self, other: Self) -&gt; Self</code></span></h3><div class='docblock'><p>Returns the maximum of the two numbers.</p>
  398. <pre class="rust rust-example-rendered">
  399. <span class="kw">use</span> <span class="ident">num_traits</span>::<span class="ident">Float</span>;
  400. <span class="kw">let</span> <span class="ident">x</span> <span class="op">=</span> <span class="number">1.0</span>;
  401. <span class="kw">let</span> <span class="ident">y</span> <span class="op">=</span> <span class="number">2.0</span>;
  402. <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>);</pre>
  403. </div><h3 id='tymethod.min' class='method'><span id='min.v' class='invisible'><code>fn <a href='#tymethod.min' class='fnname'>min</a>(self, other: Self) -&gt; Self</code></span></h3><div class='docblock'><p>Returns the minimum of the two numbers.</p>
  404. <pre class="rust rust-example-rendered">
  405. <span class="kw">use</span> <span class="ident">num_traits</span>::<span class="ident">Float</span>;
  406. <span class="kw">let</span> <span class="ident">x</span> <span class="op">=</span> <span class="number">1.0</span>;
  407. <span class="kw">let</span> <span class="ident">y</span> <span class="op">=</span> <span class="number">2.0</span>;
  408. <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>);</pre>
  409. </div><h3 id='tymethod.abs_sub' class='method'><span id='abs_sub.v' class='invisible'><code>fn <a href='#tymethod.abs_sub' class='fnname'>abs_sub</a>(self, other: Self) -&gt; Self</code></span></h3><div class='docblock'><p>The positive difference of two numbers.</p>
  410. <ul>
  411. <li>If <code>self &lt;= other</code>: <code>0:0</code></li>
  412. <li>Else: <code>self - other</code></li>
  413. </ul>
  414. <pre class="rust rust-example-rendered">
  415. <span class="kw">use</span> <span class="ident">num_traits</span>::<span class="ident">Float</span>;
  416. <span class="kw">let</span> <span class="ident">x</span> <span class="op">=</span> <span class="number">3.0</span>;
  417. <span class="kw">let</span> <span class="ident">y</span> <span class="op">=</span> <span class="op">-</span><span class="number">3.0</span>;
  418. <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>();
  419. <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>();
  420. <span class="macro">assert</span><span class="macro">!</span>(<span class="ident">abs_difference_x</span> <span class="op">&lt;</span> <span class="number">1e-10</span>);
  421. <span class="macro">assert</span><span class="macro">!</span>(<span class="ident">abs_difference_y</span> <span class="op">&lt;</span> <span class="number">1e-10</span>);</pre>
  422. </div><h3 id='tymethod.cbrt' class='method'><span id='cbrt.v' class='invisible'><code>fn <a href='#tymethod.cbrt' class='fnname'>cbrt</a>(self) -&gt; Self</code></span></h3><div class='docblock'><p>Take the cubic root of a number.</p>
  423. <pre class="rust rust-example-rendered">
  424. <span class="kw">use</span> <span class="ident">num_traits</span>::<span class="ident">Float</span>;
  425. <span class="kw">let</span> <span class="ident">x</span> <span class="op">=</span> <span class="number">8.0</span>;
  426. <span class="comment">// x^(1/3) - 2 == 0</span>
  427. <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>();
  428. <span class="macro">assert</span><span class="macro">!</span>(<span class="ident">abs_difference</span> <span class="op">&lt;</span> <span class="number">1e-10</span>);</pre>
  429. </div><h3 id='tymethod.hypot' class='method'><span id='hypot.v' class='invisible'><code>fn <a href='#tymethod.hypot' class='fnname'>hypot</a>(self, other: Self) -&gt; Self</code></span></h3><div class='docblock'><p>Calculate the length of the hypotenuse of a right-angle triangle given
  430. legs of length <code>x</code> and <code>y</code>.</p>
  431. <pre class="rust rust-example-rendered">
  432. <span class="kw">use</span> <span class="ident">num_traits</span>::<span class="ident">Float</span>;
  433. <span class="kw">let</span> <span class="ident">x</span> <span class="op">=</span> <span class="number">2.0</span>;
  434. <span class="kw">let</span> <span class="ident">y</span> <span class="op">=</span> <span class="number">3.0</span>;
  435. <span class="comment">// sqrt(x^2 + y^2)</span>
  436. <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>();
  437. <span class="macro">assert</span><span class="macro">!</span>(<span class="ident">abs_difference</span> <span class="op">&lt;</span> <span class="number">1e-10</span>);</pre>
  438. </div><h3 id='tymethod.sin' class='method'><span id='sin.v' class='invisible'><code>fn <a href='#tymethod.sin' class='fnname'>sin</a>(self) -&gt; Self</code></span></h3><div class='docblock'><p>Computes the sine of a number (in radians).</p>
  439. <pre class="rust rust-example-rendered">
  440. <span class="kw">use</span> <span class="ident">num_traits</span>::<span class="ident">Float</span>;
  441. <span class="kw">use</span> <span class="ident">std</span>::<span class="ident">f64</span>;
  442. <span class="kw">let</span> <span class="ident">x</span> <span class="op">=</span> <span class="ident">f64</span>::<span class="ident">consts</span>::<span class="ident">PI</span><span class="op">/</span><span class="number">2.0</span>;
  443. <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>();
  444. <span class="macro">assert</span><span class="macro">!</span>(<span class="ident">abs_difference</span> <span class="op">&lt;</span> <span class="number">1e-10</span>);</pre>
  445. </div><h3 id='tymethod.cos' class='method'><span id='cos.v' class='invisible'><code>fn <a href='#tymethod.cos' class='fnname'>cos</a>(self) -&gt; Self</code></span></h3><div class='docblock'><p>Computes the cosine of a number (in radians).</p>
  446. <pre class="rust rust-example-rendered">
  447. <span class="kw">use</span> <span class="ident">num_traits</span>::<span class="ident">Float</span>;
  448. <span class="kw">use</span> <span class="ident">std</span>::<span class="ident">f64</span>;
  449. <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">f64</span>::<span class="ident">consts</span>::<span class="ident">PI</span>;
  450. <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>();
  451. <span class="macro">assert</span><span class="macro">!</span>(<span class="ident">abs_difference</span> <span class="op">&lt;</span> <span class="number">1e-10</span>);</pre>
  452. </div><h3 id='tymethod.tan' class='method'><span id='tan.v' class='invisible'><code>fn <a href='#tymethod.tan' class='fnname'>tan</a>(self) -&gt; Self</code></span></h3><div class='docblock'><p>Computes the tangent of a number (in radians).</p>
  453. <pre class="rust rust-example-rendered">
  454. <span class="kw">use</span> <span class="ident">num_traits</span>::<span class="ident">Float</span>;
  455. <span class="kw">use</span> <span class="ident">std</span>::<span class="ident">f64</span>;
  456. <span class="kw">let</span> <span class="ident">x</span> <span class="op">=</span> <span class="ident">f64</span>::<span class="ident">consts</span>::<span class="ident">PI</span><span class="op">/</span><span class="number">4.0</span>;
  457. <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>();
  458. <span class="macro">assert</span><span class="macro">!</span>(<span class="ident">abs_difference</span> <span class="op">&lt;</span> <span class="number">1e-14</span>);</pre>
  459. </div><h3 id='tymethod.asin' class='method'><span id='asin.v' class='invisible'><code>fn <a href='#tymethod.asin' class='fnname'>asin</a>(self) -&gt; Self</code></span></h3><div class='docblock'><p>Computes the arcsine of a number. Return value is in radians in
  460. the range [-pi/2, pi/2] or NaN if the number is outside the range
  461. [-1, 1].</p>
  462. <pre class="rust rust-example-rendered">
  463. <span class="kw">use</span> <span class="ident">num_traits</span>::<span class="ident">Float</span>;
  464. <span class="kw">use</span> <span class="ident">std</span>::<span class="ident">f64</span>;
  465. <span class="kw">let</span> <span class="ident">f</span> <span class="op">=</span> <span class="ident">f64</span>::<span class="ident">consts</span>::<span class="ident">PI</span> <span class="op">/</span> <span class="number">2.0</span>;
  466. <span class="comment">// asin(sin(pi/2))</span>
  467. <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">f64</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>();
  468. <span class="macro">assert</span><span class="macro">!</span>(<span class="ident">abs_difference</span> <span class="op">&lt;</span> <span class="number">1e-10</span>);</pre>
  469. </div><h3 id='tymethod.acos' class='method'><span id='acos.v' class='invisible'><code>fn <a href='#tymethod.acos' class='fnname'>acos</a>(self) -&gt; Self</code></span></h3><div class='docblock'><p>Computes the arccosine of a number. Return value is in radians in
  470. the range [0, pi] or NaN if the number is outside the range
  471. [-1, 1].</p>
  472. <pre class="rust rust-example-rendered">
  473. <span class="kw">use</span> <span class="ident">num_traits</span>::<span class="ident">Float</span>;
  474. <span class="kw">use</span> <span class="ident">std</span>::<span class="ident">f64</span>;
  475. <span class="kw">let</span> <span class="ident">f</span> <span class="op">=</span> <span class="ident">f64</span>::<span class="ident">consts</span>::<span class="ident">PI</span> <span class="op">/</span> <span class="number">4.0</span>;
  476. <span class="comment">// acos(cos(pi/4))</span>
  477. <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">f64</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>();
  478. <span class="macro">assert</span><span class="macro">!</span>(<span class="ident">abs_difference</span> <span class="op">&lt;</span> <span class="number">1e-10</span>);</pre>
  479. </div><h3 id='tymethod.atan' class='method'><span id='atan.v' class='invisible'><code>fn <a href='#tymethod.atan' class='fnname'>atan</a>(self) -&gt; Self</code></span></h3><div class='docblock'><p>Computes the arctangent of a number. Return value is in radians in the
  480. range [-pi/2, pi/2];</p>
  481. <pre class="rust rust-example-rendered">
  482. <span class="kw">use</span> <span class="ident">num_traits</span>::<span class="ident">Float</span>;
  483. <span class="kw">let</span> <span class="ident">f</span> <span class="op">=</span> <span class="number">1.0</span>;
  484. <span class="comment">// atan(tan(1))</span>
  485. <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>();
  486. <span class="macro">assert</span><span class="macro">!</span>(<span class="ident">abs_difference</span> <span class="op">&lt;</span> <span class="number">1e-10</span>);</pre>
  487. </div><h3 id='tymethod.atan2' class='method'><span id='atan2.v' class='invisible'><code>fn <a href='#tymethod.atan2' class='fnname'>atan2</a>(self, other: Self) -&gt; Self</code></span></h3><div class='docblock'><p>Computes the four quadrant arctangent of <code>self</code> (<code>y</code>) and <code>other</code> (<code>x</code>).</p>
  488. <ul>
  489. <li><code>x = 0</code>, <code>y = 0</code>: <code>0</code></li>
  490. <li><code>x &gt;= 0</code>: <code>arctan(y/x)</code> -&gt; <code>[-pi/2, pi/2]</code></li>
  491. <li><code>y &gt;= 0</code>: <code>arctan(y/x) + pi</code> -&gt; <code>(pi/2, pi]</code></li>
  492. <li><code>y &lt; 0</code>: <code>arctan(y/x) - pi</code> -&gt; <code>(-pi, -pi/2)</code></li>
  493. </ul>
  494. <pre class="rust rust-example-rendered">
  495. <span class="kw">use</span> <span class="ident">num_traits</span>::<span class="ident">Float</span>;
  496. <span class="kw">use</span> <span class="ident">std</span>::<span class="ident">f64</span>;
  497. <span class="kw">let</span> <span class="ident">pi</span> <span class="op">=</span> <span class="ident">f64</span>::<span class="ident">consts</span>::<span class="ident">PI</span>;
  498. <span class="comment">// All angles from horizontal right (+x)</span>
  499. <span class="comment">// 45 deg counter-clockwise</span>
  500. <span class="kw">let</span> <span class="ident">x1</span> <span class="op">=</span> <span class="number">3.0</span>;
  501. <span class="kw">let</span> <span class="ident">y1</span> <span class="op">=</span> <span class="op">-</span><span class="number">3.0</span>;
  502. <span class="comment">// 135 deg clockwise</span>
  503. <span class="kw">let</span> <span class="ident">x2</span> <span class="op">=</span> <span class="op">-</span><span class="number">3.0</span>;
  504. <span class="kw">let</span> <span class="ident">y2</span> <span class="op">=</span> <span class="number">3.0</span>;
  505. <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>();
  506. <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>();
  507. <span class="macro">assert</span><span class="macro">!</span>(<span class="ident">abs_difference_1</span> <span class="op">&lt;</span> <span class="number">1e-10</span>);
  508. <span class="macro">assert</span><span class="macro">!</span>(<span class="ident">abs_difference_2</span> <span class="op">&lt;</span> <span class="number">1e-10</span>);</pre>
  509. </div><h3 id='tymethod.sin_cos' class='method'><span id='sin_cos.v' class='invisible'><code>fn <a href='#tymethod.sin_cos' class='fnname'>sin_cos</a>(self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.tuple.html">(</a>Self, Self<a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.tuple.html">)</a></code></span></h3><div class='docblock'><p>Simultaneously computes the sine and cosine of the number, <code>x</code>. Returns
  510. <code>(sin(x), cos(x))</code>.</p>
  511. <pre class="rust rust-example-rendered">
  512. <span class="kw">use</span> <span class="ident">num_traits</span>::<span class="ident">Float</span>;
  513. <span class="kw">use</span> <span class="ident">std</span>::<span class="ident">f64</span>;
  514. <span class="kw">let</span> <span class="ident">x</span> <span class="op">=</span> <span class="ident">f64</span>::<span class="ident">consts</span>::<span class="ident">PI</span><span class="op">/</span><span class="number">4.0</span>;
  515. <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>();
  516. <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>();
  517. <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>();
  518. <span class="macro">assert</span><span class="macro">!</span>(<span class="ident">abs_difference_0</span> <span class="op">&lt;</span> <span class="number">1e-10</span>);
  519. <span class="macro">assert</span><span class="macro">!</span>(<span class="ident">abs_difference_0</span> <span class="op">&lt;</span> <span class="number">1e-10</span>);</pre>
  520. </div><h3 id='tymethod.exp_m1' class='method'><span id='exp_m1.v' class='invisible'><code>fn <a href='#tymethod.exp_m1' class='fnname'>exp_m1</a>(self) -&gt; Self</code></span></h3><div class='docblock'><p>Returns <code>e^(self) - 1</code> in a way that is accurate even if the
  521. number is close to zero.</p>
  522. <pre class="rust rust-example-rendered">
  523. <span class="kw">use</span> <span class="ident">num_traits</span>::<span class="ident">Float</span>;
  524. <span class="kw">let</span> <span class="ident">x</span> <span class="op">=</span> <span class="number">7.0</span>;
  525. <span class="comment">// e^(ln(7)) - 1</span>
  526. <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">6.0</span>).<span class="ident">abs</span>();
  527. <span class="macro">assert</span><span class="macro">!</span>(<span class="ident">abs_difference</span> <span class="op">&lt;</span> <span class="number">1e-10</span>);</pre>
  528. </div><h3 id='tymethod.ln_1p' class='method'><span id='ln_1p.v' class='invisible'><code>fn <a href='#tymethod.ln_1p' class='fnname'>ln_1p</a>(self) -&gt; Self</code></span></h3><div class='docblock'><p>Returns <code>ln(1+n)</code> (natural logarithm) more accurately than if
  529. the operations were performed separately.</p>
  530. <pre class="rust rust-example-rendered">
  531. <span class="kw">use</span> <span class="ident">num_traits</span>::<span class="ident">Float</span>;
  532. <span class="kw">use</span> <span class="ident">std</span>::<span class="ident">f64</span>;
  533. <span class="kw">let</span> <span class="ident">x</span> <span class="op">=</span> <span class="ident">f64</span>::<span class="ident">consts</span>::<span class="ident">E</span> <span class="op">-</span> <span class="number">1.0</span>;
  534. <span class="comment">// ln(1 + (e - 1)) == ln(e) == 1</span>
  535. <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>();
  536. <span class="macro">assert</span><span class="macro">!</span>(<span class="ident">abs_difference</span> <span class="op">&lt;</span> <span class="number">1e-10</span>);</pre>
  537. </div><h3 id='tymethod.sinh' class='method'><span id='sinh.v' class='invisible'><code>fn <a href='#tymethod.sinh' class='fnname'>sinh</a>(self) -&gt; Self</code></span></h3><div class='docblock'><p>Hyperbolic sine function.</p>
  538. <pre class="rust rust-example-rendered">
  539. <span class="kw">use</span> <span class="ident">num_traits</span>::<span class="ident">Float</span>;
  540. <span class="kw">use</span> <span class="ident">std</span>::<span class="ident">f64</span>;
  541. <span class="kw">let</span> <span class="ident">e</span> <span class="op">=</span> <span class="ident">f64</span>::<span class="ident">consts</span>::<span class="ident">E</span>;
  542. <span class="kw">let</span> <span class="ident">x</span> <span class="op">=</span> <span class="number">1.0</span>;
  543. <span class="kw">let</span> <span class="ident">f</span> <span class="op">=</span> <span class="ident">x</span>.<span class="ident">sinh</span>();
  544. <span class="comment">// Solving sinh() at 1 gives `(e^2-1)/(2e)`</span>
  545. <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>);
  546. <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>();
  547. <span class="macro">assert</span><span class="macro">!</span>(<span class="ident">abs_difference</span> <span class="op">&lt;</span> <span class="number">1e-10</span>);</pre>
  548. </div><h3 id='tymethod.cosh' class='method'><span id='cosh.v' class='invisible'><code>fn <a href='#tymethod.cosh' class='fnname'>cosh</a>(self) -&gt; Self</code></span></h3><div class='docblock'><p>Hyperbolic cosine function.</p>
  549. <pre class="rust rust-example-rendered">
  550. <span class="kw">use</span> <span class="ident">num_traits</span>::<span class="ident">Float</span>;
  551. <span class="kw">use</span> <span class="ident">std</span>::<span class="ident">f64</span>;
  552. <span class="kw">let</span> <span class="ident">e</span> <span class="op">=</span> <span class="ident">f64</span>::<span class="ident">consts</span>::<span class="ident">E</span>;
  553. <span class="kw">let</span> <span class="ident">x</span> <span class="op">=</span> <span class="number">1.0</span>;
  554. <span class="kw">let</span> <span class="ident">f</span> <span class="op">=</span> <span class="ident">x</span>.<span class="ident">cosh</span>();
  555. <span class="comment">// Solving cosh() at 1 gives this result</span>
  556. <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>);
  557. <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>();
  558. <span class="comment">// Same result</span>
  559. <span class="macro">assert</span><span class="macro">!</span>(<span class="ident">abs_difference</span> <span class="op">&lt;</span> <span class="number">1.0e-10</span>);</pre>
  560. </div><h3 id='tymethod.tanh' class='method'><span id='tanh.v' class='invisible'><code>fn <a href='#tymethod.tanh' class='fnname'>tanh</a>(self) -&gt; Self</code></span></h3><div class='docblock'><p>Hyperbolic tangent function.</p>
  561. <pre class="rust rust-example-rendered">
  562. <span class="kw">use</span> <span class="ident">num_traits</span>::<span class="ident">Float</span>;
  563. <span class="kw">use</span> <span class="ident">std</span>::<span class="ident">f64</span>;
  564. <span class="kw">let</span> <span class="ident">e</span> <span class="op">=</span> <span class="ident">f64</span>::<span class="ident">consts</span>::<span class="ident">E</span>;
  565. <span class="kw">let</span> <span class="ident">x</span> <span class="op">=</span> <span class="number">1.0</span>;
  566. <span class="kw">let</span> <span class="ident">f</span> <span class="op">=</span> <span class="ident">x</span>.<span class="ident">tanh</span>();
  567. <span class="comment">// Solving tanh() at 1 gives `(1 - e^(-2))/(1 + e^(-2))`</span>
  568. <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>));
  569. <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>();
  570. <span class="macro">assert</span><span class="macro">!</span>(<span class="ident">abs_difference</span> <span class="op">&lt;</span> <span class="number">1.0e-10</span>);</pre>
  571. </div><h3 id='tymethod.asinh' class='method'><span id='asinh.v' class='invisible'><code>fn <a href='#tymethod.asinh' class='fnname'>asinh</a>(self) -&gt; Self</code></span></h3><div class='docblock'><p>Inverse hyperbolic sine function.</p>
  572. <pre class="rust rust-example-rendered">
  573. <span class="kw">use</span> <span class="ident">num_traits</span>::<span class="ident">Float</span>;
  574. <span class="kw">let</span> <span class="ident">x</span> <span class="op">=</span> <span class="number">1.0</span>;
  575. <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>();
  576. <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>();
  577. <span class="macro">assert</span><span class="macro">!</span>(<span class="ident">abs_difference</span> <span class="op">&lt;</span> <span class="number">1.0e-10</span>);</pre>
  578. </div><h3 id='tymethod.acosh' class='method'><span id='acosh.v' class='invisible'><code>fn <a href='#tymethod.acosh' class='fnname'>acosh</a>(self) -&gt; Self</code></span></h3><div class='docblock'><p>Inverse hyperbolic cosine function.</p>
  579. <pre class="rust rust-example-rendered">
  580. <span class="kw">use</span> <span class="ident">num_traits</span>::<span class="ident">Float</span>;
  581. <span class="kw">let</span> <span class="ident">x</span> <span class="op">=</span> <span class="number">1.0</span>;
  582. <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>();
  583. <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>();
  584. <span class="macro">assert</span><span class="macro">!</span>(<span class="ident">abs_difference</span> <span class="op">&lt;</span> <span class="number">1.0e-10</span>);</pre>
  585. </div><h3 id='tymethod.atanh' class='method'><span id='atanh.v' class='invisible'><code>fn <a href='#tymethod.atanh' class='fnname'>atanh</a>(self) -&gt; Self</code></span></h3><div class='docblock'><p>Inverse hyperbolic tangent function.</p>
  586. <pre class="rust rust-example-rendered">
  587. <span class="kw">use</span> <span class="ident">num_traits</span>::<span class="ident">Float</span>;
  588. <span class="kw">use</span> <span class="ident">std</span>::<span class="ident">f64</span>;
  589. <span class="kw">let</span> <span class="ident">e</span> <span class="op">=</span> <span class="ident">f64</span>::<span class="ident">consts</span>::<span class="ident">E</span>;
  590. <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>();
  591. <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>();
  592. <span class="macro">assert</span><span class="macro">!</span>(<span class="ident">abs_difference</span> <span class="op">&lt;</span> <span class="number">1.0e-10</span>);</pre>
  593. </div><h3 id='tymethod.integer_decode' class='method'><span id='integer_decode.v' class='invisible'><code>fn <a href='#tymethod.integer_decode' class='fnname'>integer_decode</a>(self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.tuple.html">(</a><a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u64.html">u64</a>, <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.i16.html">i16</a>, <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.i8.html">i8</a><a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.tuple.html">)</a></code></span></h3><div class='docblock'><p>Returns the mantissa, base 2 exponent, and sign as integers, respectively.
  594. The original number can be recovered by <code>sign * mantissa * 2 ^ exponent</code>.</p>
  595. <pre class="rust rust-example-rendered">
  596. <span class="kw">use</span> <span class="ident">num_traits</span>::<span class="ident">Float</span>;
  597. <span class="kw">let</span> <span class="ident">num</span> <span class="op">=</span> <span class="number">2.0f32</span>;
  598. <span class="comment">// (8388608, -22, 1)</span>
  599. <span class="kw">let</span> (<span class="ident">mantissa</span>, <span class="ident">exponent</span>, <span class="ident">sign</span>) <span class="op">=</span> <span class="ident">Float</span>::<span class="ident">integer_decode</span>(<span class="ident">num</span>);
  600. <span class="kw">let</span> <span class="ident">sign_f</span> <span class="op">=</span> <span class="ident">sign</span> <span class="kw">as</span> <span class="ident">f32</span>;
  601. <span class="kw">let</span> <span class="ident">mantissa_f</span> <span class="op">=</span> <span class="ident">mantissa</span> <span class="kw">as</span> <span class="ident">f32</span>;
  602. <span class="kw">let</span> <span class="ident">exponent_f</span> <span class="op">=</span> <span class="ident">num</span>.<span class="ident">powf</span>(<span class="ident">exponent</span> <span class="kw">as</span> <span class="ident">f32</span>);
  603. <span class="comment">// 1 * 8388608 * 2^(-22) == 2</span>
  604. <span class="kw">let</span> <span class="ident">abs_difference</span> <span class="op">=</span> (<span class="ident">sign_f</span> <span class="op">*</span> <span class="ident">mantissa_f</span> <span class="op">*</span> <span class="ident">exponent_f</span> <span class="op">-</span> <span class="ident">num</span>).<span class="ident">abs</span>();
  605. <span class="macro">assert</span><span class="macro">!</span>(<span class="ident">abs_difference</span> <span class="op">&lt;</span> <span class="number">1e-10</span>);</pre>
  606. </div></div>
  607. <h2 id='provided-methods' class='small-section-header'>
  608. Provided Methods<a href='#provided-methods' class='anchor'></a>
  609. </h2>
  610. <div class='methods'>
  611. <h3 id='method.epsilon' class='method'><span id='epsilon.v' class='invisible'><code>fn <a href='#method.epsilon' class='fnname'>epsilon</a>() -&gt; Self</code></span></h3><div class='docblock'><p>Returns epsilon, a small positive value.</p>
  612. <pre class="rust rust-example-rendered">
  613. <span class="kw">use</span> <span class="ident">num_traits</span>::<span class="ident">Float</span>;
  614. <span class="kw">use</span> <span class="ident">std</span>::<span class="ident">f64</span>;
  615. <span class="kw">let</span> <span class="ident">x</span>: <span class="ident">f64</span> <span class="op">=</span> <span class="ident">Float</span>::<span class="ident">epsilon</span>();
  616. <span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">x</span>, <span class="ident">f64</span>::<span class="ident">EPSILON</span>);</pre>
  617. <h1 id="panics" class="section-header"><a href="#panics">Panics</a></h1>
  618. <p>The default implementation will panic if <code>f32::EPSILON</code> cannot
  619. be cast to <code>Self</code>.</p>
  620. </div><h3 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) -&gt; Self</code></span></h3><div class='docblock'><p>Converts radians to degrees.</p>
  621. <pre class="rust rust-example-rendered">
  622. <span class="kw">use</span> <span class="ident">std</span>::<span class="ident">f64</span>::<span class="ident">consts</span>;
  623. <span class="kw">let</span> <span class="ident">angle</span> <span class="op">=</span> <span class="ident">consts</span>::<span class="ident">PI</span>;
  624. <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>();
  625. <span class="macro">assert</span><span class="macro">!</span>(<span class="ident">abs_difference</span> <span class="op">&lt;</span> <span class="number">1e-10</span>);</pre>
  626. </div><h3 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) -&gt; Self</code></span></h3><div class='docblock'><p>Converts degrees to radians.</p>
  627. <pre class="rust rust-example-rendered">
  628. <span class="kw">use</span> <span class="ident">std</span>::<span class="ident">f64</span>::<span class="ident">consts</span>;
  629. <span class="kw">let</span> <span class="ident">angle</span> <span class="op">=</span> <span class="number">180.0_f64</span>;
  630. <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>();
  631. <span class="macro">assert</span><span class="macro">!</span>(<span class="ident">abs_difference</span> <span class="op">&lt;</span> <span class="number">1e-10</span>);</pre>
  632. </div></div>
  633. <h2 id='foreign-impls' class='small-section-header'>
  634. Implementations on Foreign Types<a href='#foreign-impls' class='anchor'></a>
  635. </h2>
  636. <h3 id='impl-Float' class='impl'><span class='in-band'><code>impl <a class="trait" href="../num_traits/float/trait.Float.html" title="trait num_traits::float::Float">Float</a> for <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f64.html">f64</a></code><a href='#impl-Float' class='anchor'></a></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/float.rs.html#1799-1871' title='goto source code'>[src]</a></span></h3>
  637. <span class='docblock autohide'><div class='impl-items'><h4 id='method.nan' class="method"><span id='nan.v-1' class='invisible'><code>fn <a href='#method.nan' class='fnname'>nan</a>() -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f64.html">f64</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/macros.rs.html#33-35' title='goto source code'>[src]</a></span></h4>
  638. <h4 id='method.infinity' class="method"><span id='infinity.v-1' class='invisible'><code>fn <a href='#method.infinity' class='fnname'>infinity</a>() -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f64.html">f64</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/macros.rs.html#33-35' title='goto source code'>[src]</a></span></h4>
  639. <h4 id='method.neg_infinity' class="method"><span id='neg_infinity.v-1' class='invisible'><code>fn <a href='#method.neg_infinity' class='fnname'>neg_infinity</a>() -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f64.html">f64</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/macros.rs.html#33-35' title='goto source code'>[src]</a></span></h4>
  640. <h4 id='method.neg_zero' class="method"><span id='neg_zero.v-1' class='invisible'><code>fn <a href='#method.neg_zero' class='fnname'>neg_zero</a>() -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f64.html">f64</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/macros.rs.html#33-35' title='goto source code'>[src]</a></span></h4>
  641. <h4 id='method.min_value' class="method"><span id='min_value.v-1' class='invisible'><code>fn <a href='#method.min_value' class='fnname'>min_value</a>() -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f64.html">f64</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/macros.rs.html#33-35' title='goto source code'>[src]</a></span></h4>
  642. <h4 id='method.min_positive_value' class="method"><span id='min_positive_value.v-1' class='invisible'><code>fn <a href='#method.min_positive_value' class='fnname'>min_positive_value</a>() -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f64.html">f64</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/macros.rs.html#33-35' title='goto source code'>[src]</a></span></h4>
  643. <h4 id='method.epsilon-1' class="method"><span id='epsilon.v-1' class='invisible'><code>fn <a href='#method.epsilon' class='fnname'>epsilon</a>() -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f64.html">f64</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/macros.rs.html#33-35' title='goto source code'>[src]</a></span></h4>
  644. <h4 id='method.max_value' class="method"><span id='max_value.v-1' class='invisible'><code>fn <a href='#method.max_value' class='fnname'>max_value</a>() -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f64.html">f64</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/macros.rs.html#33-35' title='goto source code'>[src]</a></span></h4>
  645. <h4 id='method.abs_sub' class="method"><span id='abs_sub.v-1' class='invisible'><code>fn <a href='#method.abs_sub' class='fnname'>abs_sub</a>(self, other: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f64.html">f64</a>) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f64.html">f64</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/float.rs.html#1813-1815' title='goto source code'>[src]</a></span></h4>
  646. <h4 id='method.integer_decode' class="method"><span id='integer_decode.v-1' class='invisible'><code>fn <a href='#method.integer_decode' class='fnname'>integer_decode</a>(self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.tuple.html">(</a><a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u64.html">u64</a>, <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.i16.html">i16</a>, <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.i8.html">i8</a><a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.tuple.html">)</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/float.rs.html#1818-1820' title='goto source code'>[src]</a></span></h4>
  647. <h4 id='method.is_nan' class="method"><span id='is_nan.v-1' class='invisible'><code>fn <a href='#method.is_nan' class='fnname'>is_nan</a>(self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.bool.html">bool</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/macros.rs.html#9-11' title='goto source code'>[src]</a></span></h4>
  648. <h4 id='method.is_infinite' class="method"><span id='is_infinite.v-1' class='invisible'><code>fn <a href='#method.is_infinite' class='fnname'>is_infinite</a>(self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.bool.html">bool</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/macros.rs.html#9-11' title='goto source code'>[src]</a></span></h4>
  649. <h4 id='method.is_finite' class="method"><span id='is_finite.v-1' class='invisible'><code>fn <a href='#method.is_finite' class='fnname'>is_finite</a>(self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.bool.html">bool</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/macros.rs.html#9-11' title='goto source code'>[src]</a></span></h4>
  650. <h4 id='method.is_normal' class="method"><span id='is_normal.v-1' class='invisible'><code>fn <a href='#method.is_normal' class='fnname'>is_normal</a>(self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.bool.html">bool</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/macros.rs.html#9-11' title='goto source code'>[src]</a></span></h4>
  651. <h4 id='method.classify' class="method"><span id='classify.v-1' class='invisible'><code>fn <a href='#method.classify' class='fnname'>classify</a>(self) -&gt; <a class="enum" href="https://doc.rust-lang.org/nightly/core/num/enum.FpCategory.html" title="enum core::num::FpCategory">FpCategory</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/macros.rs.html#9-11' title='goto source code'>[src]</a></span></h4>
  652. <h4 id='method.floor' class="method"><span id='floor.v-1' class='invisible'><code>fn <a href='#method.floor' class='fnname'>floor</a>(self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f64.html">f64</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/macros.rs.html#9-11' title='goto source code'>[src]</a></span></h4>
  653. <h4 id='method.ceil' class="method"><span id='ceil.v-1' class='invisible'><code>fn <a href='#method.ceil' class='fnname'>ceil</a>(self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f64.html">f64</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/macros.rs.html#9-11' title='goto source code'>[src]</a></span></h4>
  654. <h4 id='method.round' class="method"><span id='round.v-1' class='invisible'><code>fn <a href='#method.round' class='fnname'>round</a>(self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f64.html">f64</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/macros.rs.html#9-11' title='goto source code'>[src]</a></span></h4>
  655. <h4 id='method.trunc' class="method"><span id='trunc.v-1' class='invisible'><code>fn <a href='#method.trunc' class='fnname'>trunc</a>(self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f64.html">f64</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/macros.rs.html#9-11' title='goto source code'>[src]</a></span></h4>
  656. <h4 id='method.fract' class="method"><span id='fract.v-1' class='invisible'><code>fn <a href='#method.fract' class='fnname'>fract</a>(self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f64.html">f64</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/macros.rs.html#9-11' title='goto source code'>[src]</a></span></h4>
  657. <h4 id='method.abs' class="method"><span id='abs.v-1' class='invisible'><code>fn <a href='#method.abs' class='fnname'>abs</a>(self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f64.html">f64</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/macros.rs.html#9-11' title='goto source code'>[src]</a></span></h4>
  658. <h4 id='method.signum' class="method"><span id='signum.v-1' class='invisible'><code>fn <a href='#method.signum' class='fnname'>signum</a>(self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f64.html">f64</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/macros.rs.html#9-11' title='goto source code'>[src]</a></span></h4>
  659. <h4 id='method.is_sign_positive' class="method"><span id='is_sign_positive.v-1' class='invisible'><code>fn <a href='#method.is_sign_positive' class='fnname'>is_sign_positive</a>(self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.bool.html">bool</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/macros.rs.html#9-11' title='goto source code'>[src]</a></span></h4>
  660. <h4 id='method.is_sign_negative' class="method"><span id='is_sign_negative.v-1' class='invisible'><code>fn <a href='#method.is_sign_negative' class='fnname'>is_sign_negative</a>(self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.bool.html">bool</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/macros.rs.html#9-11' title='goto source code'>[src]</a></span></h4>
  661. <h4 id='method.mul_add' class="method"><span id='mul_add.v-1' class='invisible'><code>fn <a href='#method.mul_add' class='fnname'>mul_add</a>(self, a: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f64.html">f64</a>, b: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f64.html">f64</a>) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f64.html">f64</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/macros.rs.html#9-11' title='goto source code'>[src]</a></span></h4>
  662. <h4 id='method.recip' class="method"><span id='recip.v-1' class='invisible'><code>fn <a href='#method.recip' class='fnname'>recip</a>(self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f64.html">f64</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/macros.rs.html#9-11' title='goto source code'>[src]</a></span></h4>
  663. <h4 id='method.powi' class="method"><span id='powi.v-1' class='invisible'><code>fn <a href='#method.powi' class='fnname'>powi</a>(self, n: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.i32.html">i32</a>) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f64.html">f64</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/macros.rs.html#9-11' title='goto source code'>[src]</a></span></h4>
  664. <h4 id='method.powf' class="method"><span id='powf.v-1' class='invisible'><code>fn <a href='#method.powf' class='fnname'>powf</a>(self, n: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f64.html">f64</a>) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f64.html">f64</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/macros.rs.html#9-11' title='goto source code'>[src]</a></span></h4>
  665. <h4 id='method.sqrt' class="method"><span id='sqrt.v-1' class='invisible'><code>fn <a href='#method.sqrt' class='fnname'>sqrt</a>(self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f64.html">f64</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/macros.rs.html#9-11' title='goto source code'>[src]</a></span></h4>
  666. <h4 id='method.exp' class="method"><span id='exp.v-1' class='invisible'><code>fn <a href='#method.exp' class='fnname'>exp</a>(self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f64.html">f64</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/macros.rs.html#9-11' title='goto source code'>[src]</a></span></h4>
  667. <h4 id='method.exp2' class="method"><span id='exp2.v-1' class='invisible'><code>fn <a href='#method.exp2' class='fnname'>exp2</a>(self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f64.html">f64</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/macros.rs.html#9-11' title='goto source code'>[src]</a></span></h4>
  668. <h4 id='method.ln' class="method"><span id='ln.v-1' class='invisible'><code>fn <a href='#method.ln' class='fnname'>ln</a>(self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f64.html">f64</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/macros.rs.html#9-11' title='goto source code'>[src]</a></span></h4>
  669. <h4 id='method.log' class="method"><span id='log.v-1' class='invisible'><code>fn <a href='#method.log' class='fnname'>log</a>(self, base: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f64.html">f64</a>) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f64.html">f64</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/macros.rs.html#9-11' title='goto source code'>[src]</a></span></h4>
  670. <h4 id='method.log2' class="method"><span id='log2.v-1' class='invisible'><code>fn <a href='#method.log2' class='fnname'>log2</a>(self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f64.html">f64</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/macros.rs.html#9-11' title='goto source code'>[src]</a></span></h4>
  671. <h4 id='method.log10' class="method"><span id='log10.v-1' class='invisible'><code>fn <a href='#method.log10' class='fnname'>log10</a>(self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f64.html">f64</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/macros.rs.html#9-11' title='goto source code'>[src]</a></span></h4>
  672. <h4 id='method.to_degrees-1' class="method"><span id='to_degrees.v-1' class='invisible'><code>fn <a href='#method.to_degrees' class='fnname'>to_degrees</a>(self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f64.html">f64</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/macros.rs.html#9-11' title='goto source code'>[src]</a></span></h4>
  673. <h4 id='method.to_radians-1' class="method"><span id='to_radians.v-1' class='invisible'><code>fn <a href='#method.to_radians' class='fnname'>to_radians</a>(self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f64.html">f64</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/macros.rs.html#9-11' title='goto source code'>[src]</a></span></h4>
  674. <h4 id='method.max' class="method"><span id='max.v-1' class='invisible'><code>fn <a href='#method.max' class='fnname'>max</a>(self, other: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f64.html">f64</a>) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f64.html">f64</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/macros.rs.html#9-11' title='goto source code'>[src]</a></span></h4>
  675. <h4 id='method.min' class="method"><span id='min.v-1' class='invisible'><code>fn <a href='#method.min' class='fnname'>min</a>(self, other: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f64.html">f64</a>) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f64.html">f64</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/macros.rs.html#9-11' title='goto source code'>[src]</a></span></h4>
  676. <h4 id='method.cbrt' class="method"><span id='cbrt.v-1' class='invisible'><code>fn <a href='#method.cbrt' class='fnname'>cbrt</a>(self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f64.html">f64</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/macros.rs.html#9-11' title='goto source code'>[src]</a></span></h4>
  677. <h4 id='method.hypot' class="method"><span id='hypot.v-1' class='invisible'><code>fn <a href='#method.hypot' class='fnname'>hypot</a>(self, other: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f64.html">f64</a>) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f64.html">f64</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/macros.rs.html#9-11' title='goto source code'>[src]</a></span></h4>
  678. <h4 id='method.sin' class="method"><span id='sin.v-1' class='invisible'><code>fn <a href='#method.sin' class='fnname'>sin</a>(self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f64.html">f64</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/macros.rs.html#9-11' title='goto source code'>[src]</a></span></h4>
  679. <h4 id='method.cos' class="method"><span id='cos.v-1' class='invisible'><code>fn <a href='#method.cos' class='fnname'>cos</a>(self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f64.html">f64</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/macros.rs.html#9-11' title='goto source code'>[src]</a></span></h4>
  680. <h4 id='method.tan' class="method"><span id='tan.v-1' class='invisible'><code>fn <a href='#method.tan' class='fnname'>tan</a>(self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f64.html">f64</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/macros.rs.html#9-11' title='goto source code'>[src]</a></span></h4>
  681. <h4 id='method.asin' class="method"><span id='asin.v-1' class='invisible'><code>fn <a href='#method.asin' class='fnname'>asin</a>(self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f64.html">f64</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/macros.rs.html#9-11' title='goto source code'>[src]</a></span></h4>
  682. <h4 id='method.acos' class="method"><span id='acos.v-1' class='invisible'><code>fn <a href='#method.acos' class='fnname'>acos</a>(self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f64.html">f64</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/macros.rs.html#9-11' title='goto source code'>[src]</a></span></h4>
  683. <h4 id='method.atan' class="method"><span id='atan.v-1' class='invisible'><code>fn <a href='#method.atan' class='fnname'>atan</a>(self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f64.html">f64</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/macros.rs.html#9-11' title='goto source code'>[src]</a></span></h4>
  684. <h4 id='method.atan2' class="method"><span id='atan2.v-1' class='invisible'><code>fn <a href='#method.atan2' class='fnname'>atan2</a>(self, other: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f64.html">f64</a>) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f64.html">f64</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/macros.rs.html#9-11' title='goto source code'>[src]</a></span></h4>
  685. <h4 id='method.sin_cos' class="method"><span id='sin_cos.v-1' class='invisible'><code>fn <a href='#method.sin_cos' class='fnname'>sin_cos</a>(self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.tuple.html">(</a><a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f64.html">f64</a>, <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f64.html">f64</a><a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.tuple.html">)</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/macros.rs.html#9-11' title='goto source code'>[src]</a></span></h4>
  686. <h4 id='method.exp_m1' class="method"><span id='exp_m1.v-1' class='invisible'><code>fn <a href='#method.exp_m1' class='fnname'>exp_m1</a>(self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f64.html">f64</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/macros.rs.html#9-11' title='goto source code'>[src]</a></span></h4>
  687. <h4 id='method.ln_1p' class="method"><span id='ln_1p.v-1' class='invisible'><code>fn <a href='#method.ln_1p' class='fnname'>ln_1p</a>(self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f64.html">f64</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/macros.rs.html#9-11' title='goto source code'>[src]</a></span></h4>
  688. <h4 id='method.sinh' class="method"><span id='sinh.v-1' class='invisible'><code>fn <a href='#method.sinh' class='fnname'>sinh</a>(self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f64.html">f64</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/macros.rs.html#9-11' title='goto source code'>[src]</a></span></h4>
  689. <h4 id='method.cosh' class="method"><span id='cosh.v-1' class='invisible'><code>fn <a href='#method.cosh' class='fnname'>cosh</a>(self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f64.html">f64</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/macros.rs.html#9-11' title='goto source code'>[src]</a></span></h4>
  690. <h4 id='method.tanh' class="method"><span id='tanh.v-1' class='invisible'><code>fn <a href='#method.tanh' class='fnname'>tanh</a>(self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f64.html">f64</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/macros.rs.html#9-11' title='goto source code'>[src]</a></span></h4>
  691. <h4 id='method.asinh' class="method"><span id='asinh.v-1' class='invisible'><code>fn <a href='#method.asinh' class='fnname'>asinh</a>(self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f64.html">f64</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/macros.rs.html#9-11' title='goto source code'>[src]</a></span></h4>
  692. <h4 id='method.acosh' class="method"><span id='acosh.v-1' class='invisible'><code>fn <a href='#method.acosh' class='fnname'>acosh</a>(self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f64.html">f64</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/macros.rs.html#9-11' title='goto source code'>[src]</a></span></h4>
  693. <h4 id='method.atanh' class="method"><span id='atanh.v-1' class='invisible'><code>fn <a href='#method.atanh' class='fnname'>atanh</a>(self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f64.html">f64</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/macros.rs.html#9-11' title='goto source code'>[src]</a></span></h4>
  694. </div></span><h3 id='impl-Float-1' class='impl'><span class='in-band'><code>impl <a class="trait" href="../num_traits/float/trait.Float.html" title="trait num_traits::float::Float">Float</a> for <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f32.html">f32</a></code><a href='#impl-Float-1' class='anchor'></a></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/float.rs.html#1799-1871' title='goto source code'>[src]</a></span></h3>
  695. <span class='docblock autohide'><div class='impl-items'><h4 id='method.nan-1' class="method"><span id='nan.v-2' class='invisible'><code>fn <a href='#method.nan' class='fnname'>nan</a>() -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f32.html">f32</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/macros.rs.html#33-35' title='goto source code'>[src]</a></span></h4>
  696. <h4 id='method.infinity-1' class="method"><span id='infinity.v-2' class='invisible'><code>fn <a href='#method.infinity' class='fnname'>infinity</a>() -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f32.html">f32</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/macros.rs.html#33-35' title='goto source code'>[src]</a></span></h4>
  697. <h4 id='method.neg_infinity-1' class="method"><span id='neg_infinity.v-2' class='invisible'><code>fn <a href='#method.neg_infinity' class='fnname'>neg_infinity</a>() -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f32.html">f32</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/macros.rs.html#33-35' title='goto source code'>[src]</a></span></h4>
  698. <h4 id='method.neg_zero-1' class="method"><span id='neg_zero.v-2' class='invisible'><code>fn <a href='#method.neg_zero' class='fnname'>neg_zero</a>() -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f32.html">f32</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/macros.rs.html#33-35' title='goto source code'>[src]</a></span></h4>
  699. <h4 id='method.min_value-1' class="method"><span id='min_value.v-2' class='invisible'><code>fn <a href='#method.min_value' class='fnname'>min_value</a>() -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f32.html">f32</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/macros.rs.html#33-35' title='goto source code'>[src]</a></span></h4>
  700. <h4 id='method.min_positive_value-1' class="method"><span id='min_positive_value.v-2' class='invisible'><code>fn <a href='#method.min_positive_value' class='fnname'>min_positive_value</a>() -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f32.html">f32</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/macros.rs.html#33-35' title='goto source code'>[src]</a></span></h4>
  701. <h4 id='method.epsilon-2' class="method"><span id='epsilon.v-2' class='invisible'><code>fn <a href='#method.epsilon' class='fnname'>epsilon</a>() -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f32.html">f32</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/macros.rs.html#33-35' title='goto source code'>[src]</a></span></h4>
  702. <h4 id='method.max_value-1' class="method"><span id='max_value.v-2' class='invisible'><code>fn <a href='#method.max_value' class='fnname'>max_value</a>() -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f32.html">f32</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/macros.rs.html#33-35' title='goto source code'>[src]</a></span></h4>
  703. <h4 id='method.abs_sub-1' class="method"><span id='abs_sub.v-2' class='invisible'><code>fn <a href='#method.abs_sub' class='fnname'>abs_sub</a>(self, other: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f32.html">f32</a>) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f32.html">f32</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/float.rs.html#1813-1815' title='goto source code'>[src]</a></span></h4>
  704. <h4 id='method.integer_decode-1' class="method"><span id='integer_decode.v-2' class='invisible'><code>fn <a href='#method.integer_decode' class='fnname'>integer_decode</a>(self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.tuple.html">(</a><a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u64.html">u64</a>, <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.i16.html">i16</a>, <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.i8.html">i8</a><a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.tuple.html">)</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/float.rs.html#1818-1820' title='goto source code'>[src]</a></span></h4>
  705. <h4 id='method.is_nan-1' class="method"><span id='is_nan.v-2' class='invisible'><code>fn <a href='#method.is_nan' class='fnname'>is_nan</a>(self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.bool.html">bool</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/macros.rs.html#9-11' title='goto source code'>[src]</a></span></h4>
  706. <h4 id='method.is_infinite-1' class="method"><span id='is_infinite.v-2' class='invisible'><code>fn <a href='#method.is_infinite' class='fnname'>is_infinite</a>(self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.bool.html">bool</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/macros.rs.html#9-11' title='goto source code'>[src]</a></span></h4>
  707. <h4 id='method.is_finite-1' class="method"><span id='is_finite.v-2' class='invisible'><code>fn <a href='#method.is_finite' class='fnname'>is_finite</a>(self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.bool.html">bool</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/macros.rs.html#9-11' title='goto source code'>[src]</a></span></h4>
  708. <h4 id='method.is_normal-1' class="method"><span id='is_normal.v-2' class='invisible'><code>fn <a href='#method.is_normal' class='fnname'>is_normal</a>(self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.bool.html">bool</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/macros.rs.html#9-11' title='goto source code'>[src]</a></span></h4>
  709. <h4 id='method.classify-1' class="method"><span id='classify.v-2' class='invisible'><code>fn <a href='#method.classify' class='fnname'>classify</a>(self) -&gt; <a class="enum" href="https://doc.rust-lang.org/nightly/core/num/enum.FpCategory.html" title="enum core::num::FpCategory">FpCategory</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/macros.rs.html#9-11' title='goto source code'>[src]</a></span></h4>
  710. <h4 id='method.floor-1' class="method"><span id='floor.v-2' class='invisible'><code>fn <a href='#method.floor' class='fnname'>floor</a>(self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f32.html">f32</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/macros.rs.html#9-11' title='goto source code'>[src]</a></span></h4>
  711. <h4 id='method.ceil-1' class="method"><span id='ceil.v-2' class='invisible'><code>fn <a href='#method.ceil' class='fnname'>ceil</a>(self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f32.html">f32</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/macros.rs.html#9-11' title='goto source code'>[src]</a></span></h4>
  712. <h4 id='method.round-1' class="method"><span id='round.v-2' class='invisible'><code>fn <a href='#method.round' class='fnname'>round</a>(self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f32.html">f32</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/macros.rs.html#9-11' title='goto source code'>[src]</a></span></h4>
  713. <h4 id='method.trunc-1' class="method"><span id='trunc.v-2' class='invisible'><code>fn <a href='#method.trunc' class='fnname'>trunc</a>(self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f32.html">f32</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/macros.rs.html#9-11' title='goto source code'>[src]</a></span></h4>
  714. <h4 id='method.fract-1' class="method"><span id='fract.v-2' class='invisible'><code>fn <a href='#method.fract' class='fnname'>fract</a>(self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f32.html">f32</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/macros.rs.html#9-11' title='goto source code'>[src]</a></span></h4>
  715. <h4 id='method.abs-1' class="method"><span id='abs.v-2' class='invisible'><code>fn <a href='#method.abs' class='fnname'>abs</a>(self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f32.html">f32</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/macros.rs.html#9-11' title='goto source code'>[src]</a></span></h4>
  716. <h4 id='method.signum-1' class="method"><span id='signum.v-2' class='invisible'><code>fn <a href='#method.signum' class='fnname'>signum</a>(self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f32.html">f32</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/macros.rs.html#9-11' title='goto source code'>[src]</a></span></h4>
  717. <h4 id='method.is_sign_positive-1' class="method"><span id='is_sign_positive.v-2' class='invisible'><code>fn <a href='#method.is_sign_positive' class='fnname'>is_sign_positive</a>(self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.bool.html">bool</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/macros.rs.html#9-11' title='goto source code'>[src]</a></span></h4>
  718. <h4 id='method.is_sign_negative-1' class="method"><span id='is_sign_negative.v-2' class='invisible'><code>fn <a href='#method.is_sign_negative' class='fnname'>is_sign_negative</a>(self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.bool.html">bool</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/macros.rs.html#9-11' title='goto source code'>[src]</a></span></h4>
  719. <h4 id='method.mul_add-1' class="method"><span id='mul_add.v-2' class='invisible'><code>fn <a href='#method.mul_add' class='fnname'>mul_add</a>(self, a: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f32.html">f32</a>, b: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f32.html">f32</a>) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f32.html">f32</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/macros.rs.html#9-11' title='goto source code'>[src]</a></span></h4>
  720. <h4 id='method.recip-1' class="method"><span id='recip.v-2' class='invisible'><code>fn <a href='#method.recip' class='fnname'>recip</a>(self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f32.html">f32</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/macros.rs.html#9-11' title='goto source code'>[src]</a></span></h4>
  721. <h4 id='method.powi-1' class="method"><span id='powi.v-2' class='invisible'><code>fn <a href='#method.powi' class='fnname'>powi</a>(self, n: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.i32.html">i32</a>) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f32.html">f32</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/macros.rs.html#9-11' title='goto source code'>[src]</a></span></h4>
  722. <h4 id='method.powf-1' class="method"><span id='powf.v-2' class='invisible'><code>fn <a href='#method.powf' class='fnname'>powf</a>(self, n: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f32.html">f32</a>) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f32.html">f32</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/macros.rs.html#9-11' title='goto source code'>[src]</a></span></h4>
  723. <h4 id='method.sqrt-1' class="method"><span id='sqrt.v-2' class='invisible'><code>fn <a href='#method.sqrt' class='fnname'>sqrt</a>(self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f32.html">f32</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/macros.rs.html#9-11' title='goto source code'>[src]</a></span></h4>
  724. <h4 id='method.exp-1' class="method"><span id='exp.v-2' class='invisible'><code>fn <a href='#method.exp' class='fnname'>exp</a>(self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f32.html">f32</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/macros.rs.html#9-11' title='goto source code'>[src]</a></span></h4>
  725. <h4 id='method.exp2-1' class="method"><span id='exp2.v-2' class='invisible'><code>fn <a href='#method.exp2' class='fnname'>exp2</a>(self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f32.html">f32</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/macros.rs.html#9-11' title='goto source code'>[src]</a></span></h4>
  726. <h4 id='method.ln-1' class="method"><span id='ln.v-2' class='invisible'><code>fn <a href='#method.ln' class='fnname'>ln</a>(self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f32.html">f32</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/macros.rs.html#9-11' title='goto source code'>[src]</a></span></h4>
  727. <h4 id='method.log-1' class="method"><span id='log.v-2' class='invisible'><code>fn <a href='#method.log' class='fnname'>log</a>(self, base: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f32.html">f32</a>) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f32.html">f32</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/macros.rs.html#9-11' title='goto source code'>[src]</a></span></h4>
  728. <h4 id='method.log2-1' class="method"><span id='log2.v-2' class='invisible'><code>fn <a href='#method.log2' class='fnname'>log2</a>(self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f32.html">f32</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/macros.rs.html#9-11' title='goto source code'>[src]</a></span></h4>
  729. <h4 id='method.log10-1' class="method"><span id='log10.v-2' class='invisible'><code>fn <a href='#method.log10' class='fnname'>log10</a>(self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f32.html">f32</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/macros.rs.html#9-11' title='goto source code'>[src]</a></span></h4>
  730. <h4 id='method.to_degrees-2' class="method"><span id='to_degrees.v-2' class='invisible'><code>fn <a href='#method.to_degrees' class='fnname'>to_degrees</a>(self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f32.html">f32</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/macros.rs.html#9-11' title='goto source code'>[src]</a></span></h4>
  731. <h4 id='method.to_radians-2' class="method"><span id='to_radians.v-2' class='invisible'><code>fn <a href='#method.to_radians' class='fnname'>to_radians</a>(self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f32.html">f32</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/macros.rs.html#9-11' title='goto source code'>[src]</a></span></h4>
  732. <h4 id='method.max-1' class="method"><span id='max.v-2' class='invisible'><code>fn <a href='#method.max' class='fnname'>max</a>(self, other: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f32.html">f32</a>) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f32.html">f32</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/macros.rs.html#9-11' title='goto source code'>[src]</a></span></h4>
  733. <h4 id='method.min-1' class="method"><span id='min.v-2' class='invisible'><code>fn <a href='#method.min' class='fnname'>min</a>(self, other: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f32.html">f32</a>) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f32.html">f32</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/macros.rs.html#9-11' title='goto source code'>[src]</a></span></h4>
  734. <h4 id='method.cbrt-1' class="method"><span id='cbrt.v-2' class='invisible'><code>fn <a href='#method.cbrt' class='fnname'>cbrt</a>(self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f32.html">f32</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/macros.rs.html#9-11' title='goto source code'>[src]</a></span></h4>
  735. <h4 id='method.hypot-1' class="method"><span id='hypot.v-2' class='invisible'><code>fn <a href='#method.hypot' class='fnname'>hypot</a>(self, other: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f32.html">f32</a>) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f32.html">f32</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/macros.rs.html#9-11' title='goto source code'>[src]</a></span></h4>
  736. <h4 id='method.sin-1' class="method"><span id='sin.v-2' class='invisible'><code>fn <a href='#method.sin' class='fnname'>sin</a>(self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f32.html">f32</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/macros.rs.html#9-11' title='goto source code'>[src]</a></span></h4>
  737. <h4 id='method.cos-1' class="method"><span id='cos.v-2' class='invisible'><code>fn <a href='#method.cos' class='fnname'>cos</a>(self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f32.html">f32</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/macros.rs.html#9-11' title='goto source code'>[src]</a></span></h4>
  738. <h4 id='method.tan-1' class="method"><span id='tan.v-2' class='invisible'><code>fn <a href='#method.tan' class='fnname'>tan</a>(self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f32.html">f32</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/macros.rs.html#9-11' title='goto source code'>[src]</a></span></h4>
  739. <h4 id='method.asin-1' class="method"><span id='asin.v-2' class='invisible'><code>fn <a href='#method.asin' class='fnname'>asin</a>(self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f32.html">f32</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/macros.rs.html#9-11' title='goto source code'>[src]</a></span></h4>
  740. <h4 id='method.acos-1' class="method"><span id='acos.v-2' class='invisible'><code>fn <a href='#method.acos' class='fnname'>acos</a>(self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f32.html">f32</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/macros.rs.html#9-11' title='goto source code'>[src]</a></span></h4>
  741. <h4 id='method.atan-1' class="method"><span id='atan.v-2' class='invisible'><code>fn <a href='#method.atan' class='fnname'>atan</a>(self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f32.html">f32</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/macros.rs.html#9-11' title='goto source code'>[src]</a></span></h4>
  742. <h4 id='method.atan2-1' class="method"><span id='atan2.v-2' class='invisible'><code>fn <a href='#method.atan2' class='fnname'>atan2</a>(self, other: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f32.html">f32</a>) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f32.html">f32</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/macros.rs.html#9-11' title='goto source code'>[src]</a></span></h4>
  743. <h4 id='method.sin_cos-1' class="method"><span id='sin_cos.v-2' class='invisible'><code>fn <a href='#method.sin_cos' class='fnname'>sin_cos</a>(self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.tuple.html">(</a><a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f32.html">f32</a>, <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f32.html">f32</a><a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.tuple.html">)</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/macros.rs.html#9-11' title='goto source code'>[src]</a></span></h4>
  744. <h4 id='method.exp_m1-1' class="method"><span id='exp_m1.v-2' class='invisible'><code>fn <a href='#method.exp_m1' class='fnname'>exp_m1</a>(self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f32.html">f32</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/macros.rs.html#9-11' title='goto source code'>[src]</a></span></h4>
  745. <h4 id='method.ln_1p-1' class="method"><span id='ln_1p.v-2' class='invisible'><code>fn <a href='#method.ln_1p' class='fnname'>ln_1p</a>(self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f32.html">f32</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/macros.rs.html#9-11' title='goto source code'>[src]</a></span></h4>
  746. <h4 id='method.sinh-1' class="method"><span id='sinh.v-2' class='invisible'><code>fn <a href='#method.sinh' class='fnname'>sinh</a>(self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f32.html">f32</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/macros.rs.html#9-11' title='goto source code'>[src]</a></span></h4>
  747. <h4 id='method.cosh-1' class="method"><span id='cosh.v-2' class='invisible'><code>fn <a href='#method.cosh' class='fnname'>cosh</a>(self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f32.html">f32</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/macros.rs.html#9-11' title='goto source code'>[src]</a></span></h4>
  748. <h4 id='method.tanh-1' class="method"><span id='tanh.v-2' class='invisible'><code>fn <a href='#method.tanh' class='fnname'>tanh</a>(self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f32.html">f32</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/macros.rs.html#9-11' title='goto source code'>[src]</a></span></h4>
  749. <h4 id='method.asinh-1' class="method"><span id='asinh.v-2' class='invisible'><code>fn <a href='#method.asinh' class='fnname'>asinh</a>(self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f32.html">f32</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/macros.rs.html#9-11' title='goto source code'>[src]</a></span></h4>
  750. <h4 id='method.acosh-1' class="method"><span id='acosh.v-2' class='invisible'><code>fn <a href='#method.acosh' class='fnname'>acosh</a>(self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f32.html">f32</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/macros.rs.html#9-11' title='goto source code'>[src]</a></span></h4>
  751. <h4 id='method.atanh-1' class="method"><span id='atanh.v-2' class='invisible'><code>fn <a href='#method.atanh' class='fnname'>atanh</a>(self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.f32.html">f32</a></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/macros.rs.html#9-11' title='goto source code'>[src]</a></span></h4>
  752. </div></span>
  753. <h2 id='implementors' class='small-section-header'>
  754. Implementors<a href='#implementors' class='anchor'></a>
  755. </h2>
  756. <ul class='item-list' id='implementors-list'>
  757. </ul><script type="text/javascript" async
  758. src="../implementors/num_traits/float/trait.Float.js">
  759. </script></section>
  760. <section id='search' class="content hidden"></section>
  761. <section class="footer"></section>
  762. <aside id="help" class="hidden">
  763. <div>
  764. <h1 class="hidden">Help</h1>
  765. <div class="shortcuts">
  766. <h2>Keyboard Shortcuts</h2>
  767. <dl>
  768. <dt><kbd>?</kbd></dt>
  769. <dd>Show this help dialog</dd>
  770. <dt><kbd>S</kbd></dt>
  771. <dd>Focus the search field</dd>
  772. <dt><kbd>↑</kbd></dt>
  773. <dd>Move up in search results</dd>
  774. <dt><kbd>↓</kbd></dt>
  775. <dd>Move down in search results</dd>
  776. <dt><kbd>↹</kbd></dt>
  777. <dd>Switch tab</dd>
  778. <dt><kbd>&#9166;</kbd></dt>
  779. <dd>Go to active search result</dd>
  780. <dt><kbd>+</kbd></dt>
  781. <dd>Expand all sections</dd>
  782. <dt><kbd>-</kbd></dt>
  783. <dd>Collapse all sections</dd>
  784. </dl>
  785. </div>
  786. <div class="infos">
  787. <h2>Search Tricks</h2>
  788. <p>
  789. Prefix searches with a type followed by a colon (e.g.
  790. <code>fn:</code>) to restrict the search to a given type.
  791. </p>
  792. <p>
  793. Accepted types are: <code>fn</code>, <code>mod</code>,
  794. <code>struct</code>, <code>enum</code>,
  795. <code>trait</code>, <code>type</code>, <code>macro</code>,
  796. and <code>const</code>.
  797. </p>
  798. <p>
  799. Search functions by type signature (e.g.
  800. <code>vec -> usize</code> or <code>* -> vec</code>)
  801. </p>
  802. </div>
  803. </div>
  804. </aside>
  805. <script>
  806. window.rootPath = "../";
  807. window.currentCrate = "num_traits";
  808. </script>
  809. <script src="../main.js"></script>
  810. <script defer src="../search-index.js"></script>
  811. </body>
  812. </html>