real.rs.html 82 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483148414851486148714881489149014911492149314941495149614971498149915001501150215031504150515061507150815091510151115121513151415151516151715181519152015211522152315241525152615271528152915301531153215331534153515361537153815391540154115421543154415451546154715481549155015511552155315541555155615571558155915601561156215631564156515661567156815691570157115721573157415751576157715781579158015811582158315841585158615871588158915901591159215931594159515961597159815991600160116021603160416051606160716081609161016111612161316141615161616171618161916201621162216231624162516261627162816291630163116321633163416351636163716381639164016411642164316441645164616471648164916501651165216531654165516561657165816591660166116621663166416651666166716681669167016711672167316741675167616771678167916801681168216831684168516861687168816891690169116921693169416951696169716981699170017011702170317041705170617071708170917101711171217131714171517161717171817191720172117221723172417251726172717281729173017311732173317341735173617371738173917401741174217431744174517461747174817491750175117521753175417551756175717581759176017611762176317641765176617671768176917701771177217731774177517761777177817791780178117821783178417851786178717881789179017911792179317941795
  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="Source to the Rust file `/Users/travis/.cargo/registry/src/github.com-1ecc6299db9ec823/num-traits-0.2.2/src/real.rs`.">
  8. <meta name="keywords" content="rust, rustlang, rust-lang">
  9. <title>real.rs.html -- source</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 source">
  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. </nav>
  26. <div class="theme-picker">
  27. <button id="theme-picker" aria-label="Pick another theme!">
  28. <img src="../../brush.svg" width="18" alt="Pick another theme!">
  29. </button>
  30. <div id="theme-choices"></div>
  31. </div>
  32. <script src="../../theme.js"></script>
  33. <nav class="sub">
  34. <form class="search-form js-only">
  35. <div class="search-container">
  36. <input class="search-input" name="search"
  37. autocomplete="off"
  38. placeholder="Click or press ‘S’ to search, ‘?’ for more options…"
  39. type="search">
  40. </div>
  41. </form>
  42. </nav>
  43. <section id='main' class="content"><pre class="line-numbers"><span id="1"> 1</span>
  44. <span id="2"> 2</span>
  45. <span id="3"> 3</span>
  46. <span id="4"> 4</span>
  47. <span id="5"> 5</span>
  48. <span id="6"> 6</span>
  49. <span id="7"> 7</span>
  50. <span id="8"> 8</span>
  51. <span id="9"> 9</span>
  52. <span id="10"> 10</span>
  53. <span id="11"> 11</span>
  54. <span id="12"> 12</span>
  55. <span id="13"> 13</span>
  56. <span id="14"> 14</span>
  57. <span id="15"> 15</span>
  58. <span id="16"> 16</span>
  59. <span id="17"> 17</span>
  60. <span id="18"> 18</span>
  61. <span id="19"> 19</span>
  62. <span id="20"> 20</span>
  63. <span id="21"> 21</span>
  64. <span id="22"> 22</span>
  65. <span id="23"> 23</span>
  66. <span id="24"> 24</span>
  67. <span id="25"> 25</span>
  68. <span id="26"> 26</span>
  69. <span id="27"> 27</span>
  70. <span id="28"> 28</span>
  71. <span id="29"> 29</span>
  72. <span id="30"> 30</span>
  73. <span id="31"> 31</span>
  74. <span id="32"> 32</span>
  75. <span id="33"> 33</span>
  76. <span id="34"> 34</span>
  77. <span id="35"> 35</span>
  78. <span id="36"> 36</span>
  79. <span id="37"> 37</span>
  80. <span id="38"> 38</span>
  81. <span id="39"> 39</span>
  82. <span id="40"> 40</span>
  83. <span id="41"> 41</span>
  84. <span id="42"> 42</span>
  85. <span id="43"> 43</span>
  86. <span id="44"> 44</span>
  87. <span id="45"> 45</span>
  88. <span id="46"> 46</span>
  89. <span id="47"> 47</span>
  90. <span id="48"> 48</span>
  91. <span id="49"> 49</span>
  92. <span id="50"> 50</span>
  93. <span id="51"> 51</span>
  94. <span id="52"> 52</span>
  95. <span id="53"> 53</span>
  96. <span id="54"> 54</span>
  97. <span id="55"> 55</span>
  98. <span id="56"> 56</span>
  99. <span id="57"> 57</span>
  100. <span id="58"> 58</span>
  101. <span id="59"> 59</span>
  102. <span id="60"> 60</span>
  103. <span id="61"> 61</span>
  104. <span id="62"> 62</span>
  105. <span id="63"> 63</span>
  106. <span id="64"> 64</span>
  107. <span id="65"> 65</span>
  108. <span id="66"> 66</span>
  109. <span id="67"> 67</span>
  110. <span id="68"> 68</span>
  111. <span id="69"> 69</span>
  112. <span id="70"> 70</span>
  113. <span id="71"> 71</span>
  114. <span id="72"> 72</span>
  115. <span id="73"> 73</span>
  116. <span id="74"> 74</span>
  117. <span id="75"> 75</span>
  118. <span id="76"> 76</span>
  119. <span id="77"> 77</span>
  120. <span id="78"> 78</span>
  121. <span id="79"> 79</span>
  122. <span id="80"> 80</span>
  123. <span id="81"> 81</span>
  124. <span id="82"> 82</span>
  125. <span id="83"> 83</span>
  126. <span id="84"> 84</span>
  127. <span id="85"> 85</span>
  128. <span id="86"> 86</span>
  129. <span id="87"> 87</span>
  130. <span id="88"> 88</span>
  131. <span id="89"> 89</span>
  132. <span id="90"> 90</span>
  133. <span id="91"> 91</span>
  134. <span id="92"> 92</span>
  135. <span id="93"> 93</span>
  136. <span id="94"> 94</span>
  137. <span id="95"> 95</span>
  138. <span id="96"> 96</span>
  139. <span id="97"> 97</span>
  140. <span id="98"> 98</span>
  141. <span id="99"> 99</span>
  142. <span id="100">100</span>
  143. <span id="101">101</span>
  144. <span id="102">102</span>
  145. <span id="103">103</span>
  146. <span id="104">104</span>
  147. <span id="105">105</span>
  148. <span id="106">106</span>
  149. <span id="107">107</span>
  150. <span id="108">108</span>
  151. <span id="109">109</span>
  152. <span id="110">110</span>
  153. <span id="111">111</span>
  154. <span id="112">112</span>
  155. <span id="113">113</span>
  156. <span id="114">114</span>
  157. <span id="115">115</span>
  158. <span id="116">116</span>
  159. <span id="117">117</span>
  160. <span id="118">118</span>
  161. <span id="119">119</span>
  162. <span id="120">120</span>
  163. <span id="121">121</span>
  164. <span id="122">122</span>
  165. <span id="123">123</span>
  166. <span id="124">124</span>
  167. <span id="125">125</span>
  168. <span id="126">126</span>
  169. <span id="127">127</span>
  170. <span id="128">128</span>
  171. <span id="129">129</span>
  172. <span id="130">130</span>
  173. <span id="131">131</span>
  174. <span id="132">132</span>
  175. <span id="133">133</span>
  176. <span id="134">134</span>
  177. <span id="135">135</span>
  178. <span id="136">136</span>
  179. <span id="137">137</span>
  180. <span id="138">138</span>
  181. <span id="139">139</span>
  182. <span id="140">140</span>
  183. <span id="141">141</span>
  184. <span id="142">142</span>
  185. <span id="143">143</span>
  186. <span id="144">144</span>
  187. <span id="145">145</span>
  188. <span id="146">146</span>
  189. <span id="147">147</span>
  190. <span id="148">148</span>
  191. <span id="149">149</span>
  192. <span id="150">150</span>
  193. <span id="151">151</span>
  194. <span id="152">152</span>
  195. <span id="153">153</span>
  196. <span id="154">154</span>
  197. <span id="155">155</span>
  198. <span id="156">156</span>
  199. <span id="157">157</span>
  200. <span id="158">158</span>
  201. <span id="159">159</span>
  202. <span id="160">160</span>
  203. <span id="161">161</span>
  204. <span id="162">162</span>
  205. <span id="163">163</span>
  206. <span id="164">164</span>
  207. <span id="165">165</span>
  208. <span id="166">166</span>
  209. <span id="167">167</span>
  210. <span id="168">168</span>
  211. <span id="169">169</span>
  212. <span id="170">170</span>
  213. <span id="171">171</span>
  214. <span id="172">172</span>
  215. <span id="173">173</span>
  216. <span id="174">174</span>
  217. <span id="175">175</span>
  218. <span id="176">176</span>
  219. <span id="177">177</span>
  220. <span id="178">178</span>
  221. <span id="179">179</span>
  222. <span id="180">180</span>
  223. <span id="181">181</span>
  224. <span id="182">182</span>
  225. <span id="183">183</span>
  226. <span id="184">184</span>
  227. <span id="185">185</span>
  228. <span id="186">186</span>
  229. <span id="187">187</span>
  230. <span id="188">188</span>
  231. <span id="189">189</span>
  232. <span id="190">190</span>
  233. <span id="191">191</span>
  234. <span id="192">192</span>
  235. <span id="193">193</span>
  236. <span id="194">194</span>
  237. <span id="195">195</span>
  238. <span id="196">196</span>
  239. <span id="197">197</span>
  240. <span id="198">198</span>
  241. <span id="199">199</span>
  242. <span id="200">200</span>
  243. <span id="201">201</span>
  244. <span id="202">202</span>
  245. <span id="203">203</span>
  246. <span id="204">204</span>
  247. <span id="205">205</span>
  248. <span id="206">206</span>
  249. <span id="207">207</span>
  250. <span id="208">208</span>
  251. <span id="209">209</span>
  252. <span id="210">210</span>
  253. <span id="211">211</span>
  254. <span id="212">212</span>
  255. <span id="213">213</span>
  256. <span id="214">214</span>
  257. <span id="215">215</span>
  258. <span id="216">216</span>
  259. <span id="217">217</span>
  260. <span id="218">218</span>
  261. <span id="219">219</span>
  262. <span id="220">220</span>
  263. <span id="221">221</span>
  264. <span id="222">222</span>
  265. <span id="223">223</span>
  266. <span id="224">224</span>
  267. <span id="225">225</span>
  268. <span id="226">226</span>
  269. <span id="227">227</span>
  270. <span id="228">228</span>
  271. <span id="229">229</span>
  272. <span id="230">230</span>
  273. <span id="231">231</span>
  274. <span id="232">232</span>
  275. <span id="233">233</span>
  276. <span id="234">234</span>
  277. <span id="235">235</span>
  278. <span id="236">236</span>
  279. <span id="237">237</span>
  280. <span id="238">238</span>
  281. <span id="239">239</span>
  282. <span id="240">240</span>
  283. <span id="241">241</span>
  284. <span id="242">242</span>
  285. <span id="243">243</span>
  286. <span id="244">244</span>
  287. <span id="245">245</span>
  288. <span id="246">246</span>
  289. <span id="247">247</span>
  290. <span id="248">248</span>
  291. <span id="249">249</span>
  292. <span id="250">250</span>
  293. <span id="251">251</span>
  294. <span id="252">252</span>
  295. <span id="253">253</span>
  296. <span id="254">254</span>
  297. <span id="255">255</span>
  298. <span id="256">256</span>
  299. <span id="257">257</span>
  300. <span id="258">258</span>
  301. <span id="259">259</span>
  302. <span id="260">260</span>
  303. <span id="261">261</span>
  304. <span id="262">262</span>
  305. <span id="263">263</span>
  306. <span id="264">264</span>
  307. <span id="265">265</span>
  308. <span id="266">266</span>
  309. <span id="267">267</span>
  310. <span id="268">268</span>
  311. <span id="269">269</span>
  312. <span id="270">270</span>
  313. <span id="271">271</span>
  314. <span id="272">272</span>
  315. <span id="273">273</span>
  316. <span id="274">274</span>
  317. <span id="275">275</span>
  318. <span id="276">276</span>
  319. <span id="277">277</span>
  320. <span id="278">278</span>
  321. <span id="279">279</span>
  322. <span id="280">280</span>
  323. <span id="281">281</span>
  324. <span id="282">282</span>
  325. <span id="283">283</span>
  326. <span id="284">284</span>
  327. <span id="285">285</span>
  328. <span id="286">286</span>
  329. <span id="287">287</span>
  330. <span id="288">288</span>
  331. <span id="289">289</span>
  332. <span id="290">290</span>
  333. <span id="291">291</span>
  334. <span id="292">292</span>
  335. <span id="293">293</span>
  336. <span id="294">294</span>
  337. <span id="295">295</span>
  338. <span id="296">296</span>
  339. <span id="297">297</span>
  340. <span id="298">298</span>
  341. <span id="299">299</span>
  342. <span id="300">300</span>
  343. <span id="301">301</span>
  344. <span id="302">302</span>
  345. <span id="303">303</span>
  346. <span id="304">304</span>
  347. <span id="305">305</span>
  348. <span id="306">306</span>
  349. <span id="307">307</span>
  350. <span id="308">308</span>
  351. <span id="309">309</span>
  352. <span id="310">310</span>
  353. <span id="311">311</span>
  354. <span id="312">312</span>
  355. <span id="313">313</span>
  356. <span id="314">314</span>
  357. <span id="315">315</span>
  358. <span id="316">316</span>
  359. <span id="317">317</span>
  360. <span id="318">318</span>
  361. <span id="319">319</span>
  362. <span id="320">320</span>
  363. <span id="321">321</span>
  364. <span id="322">322</span>
  365. <span id="323">323</span>
  366. <span id="324">324</span>
  367. <span id="325">325</span>
  368. <span id="326">326</span>
  369. <span id="327">327</span>
  370. <span id="328">328</span>
  371. <span id="329">329</span>
  372. <span id="330">330</span>
  373. <span id="331">331</span>
  374. <span id="332">332</span>
  375. <span id="333">333</span>
  376. <span id="334">334</span>
  377. <span id="335">335</span>
  378. <span id="336">336</span>
  379. <span id="337">337</span>
  380. <span id="338">338</span>
  381. <span id="339">339</span>
  382. <span id="340">340</span>
  383. <span id="341">341</span>
  384. <span id="342">342</span>
  385. <span id="343">343</span>
  386. <span id="344">344</span>
  387. <span id="345">345</span>
  388. <span id="346">346</span>
  389. <span id="347">347</span>
  390. <span id="348">348</span>
  391. <span id="349">349</span>
  392. <span id="350">350</span>
  393. <span id="351">351</span>
  394. <span id="352">352</span>
  395. <span id="353">353</span>
  396. <span id="354">354</span>
  397. <span id="355">355</span>
  398. <span id="356">356</span>
  399. <span id="357">357</span>
  400. <span id="358">358</span>
  401. <span id="359">359</span>
  402. <span id="360">360</span>
  403. <span id="361">361</span>
  404. <span id="362">362</span>
  405. <span id="363">363</span>
  406. <span id="364">364</span>
  407. <span id="365">365</span>
  408. <span id="366">366</span>
  409. <span id="367">367</span>
  410. <span id="368">368</span>
  411. <span id="369">369</span>
  412. <span id="370">370</span>
  413. <span id="371">371</span>
  414. <span id="372">372</span>
  415. <span id="373">373</span>
  416. <span id="374">374</span>
  417. <span id="375">375</span>
  418. <span id="376">376</span>
  419. <span id="377">377</span>
  420. <span id="378">378</span>
  421. <span id="379">379</span>
  422. <span id="380">380</span>
  423. <span id="381">381</span>
  424. <span id="382">382</span>
  425. <span id="383">383</span>
  426. <span id="384">384</span>
  427. <span id="385">385</span>
  428. <span id="386">386</span>
  429. <span id="387">387</span>
  430. <span id="388">388</span>
  431. <span id="389">389</span>
  432. <span id="390">390</span>
  433. <span id="391">391</span>
  434. <span id="392">392</span>
  435. <span id="393">393</span>
  436. <span id="394">394</span>
  437. <span id="395">395</span>
  438. <span id="396">396</span>
  439. <span id="397">397</span>
  440. <span id="398">398</span>
  441. <span id="399">399</span>
  442. <span id="400">400</span>
  443. <span id="401">401</span>
  444. <span id="402">402</span>
  445. <span id="403">403</span>
  446. <span id="404">404</span>
  447. <span id="405">405</span>
  448. <span id="406">406</span>
  449. <span id="407">407</span>
  450. <span id="408">408</span>
  451. <span id="409">409</span>
  452. <span id="410">410</span>
  453. <span id="411">411</span>
  454. <span id="412">412</span>
  455. <span id="413">413</span>
  456. <span id="414">414</span>
  457. <span id="415">415</span>
  458. <span id="416">416</span>
  459. <span id="417">417</span>
  460. <span id="418">418</span>
  461. <span id="419">419</span>
  462. <span id="420">420</span>
  463. <span id="421">421</span>
  464. <span id="422">422</span>
  465. <span id="423">423</span>
  466. <span id="424">424</span>
  467. <span id="425">425</span>
  468. <span id="426">426</span>
  469. <span id="427">427</span>
  470. <span id="428">428</span>
  471. <span id="429">429</span>
  472. <span id="430">430</span>
  473. <span id="431">431</span>
  474. <span id="432">432</span>
  475. <span id="433">433</span>
  476. <span id="434">434</span>
  477. <span id="435">435</span>
  478. <span id="436">436</span>
  479. <span id="437">437</span>
  480. <span id="438">438</span>
  481. <span id="439">439</span>
  482. <span id="440">440</span>
  483. <span id="441">441</span>
  484. <span id="442">442</span>
  485. <span id="443">443</span>
  486. <span id="444">444</span>
  487. <span id="445">445</span>
  488. <span id="446">446</span>
  489. <span id="447">447</span>
  490. <span id="448">448</span>
  491. <span id="449">449</span>
  492. <span id="450">450</span>
  493. <span id="451">451</span>
  494. <span id="452">452</span>
  495. <span id="453">453</span>
  496. <span id="454">454</span>
  497. <span id="455">455</span>
  498. <span id="456">456</span>
  499. <span id="457">457</span>
  500. <span id="458">458</span>
  501. <span id="459">459</span>
  502. <span id="460">460</span>
  503. <span id="461">461</span>
  504. <span id="462">462</span>
  505. <span id="463">463</span>
  506. <span id="464">464</span>
  507. <span id="465">465</span>
  508. <span id="466">466</span>
  509. <span id="467">467</span>
  510. <span id="468">468</span>
  511. <span id="469">469</span>
  512. <span id="470">470</span>
  513. <span id="471">471</span>
  514. <span id="472">472</span>
  515. <span id="473">473</span>
  516. <span id="474">474</span>
  517. <span id="475">475</span>
  518. <span id="476">476</span>
  519. <span id="477">477</span>
  520. <span id="478">478</span>
  521. <span id="479">479</span>
  522. <span id="480">480</span>
  523. <span id="481">481</span>
  524. <span id="482">482</span>
  525. <span id="483">483</span>
  526. <span id="484">484</span>
  527. <span id="485">485</span>
  528. <span id="486">486</span>
  529. <span id="487">487</span>
  530. <span id="488">488</span>
  531. <span id="489">489</span>
  532. <span id="490">490</span>
  533. <span id="491">491</span>
  534. <span id="492">492</span>
  535. <span id="493">493</span>
  536. <span id="494">494</span>
  537. <span id="495">495</span>
  538. <span id="496">496</span>
  539. <span id="497">497</span>
  540. <span id="498">498</span>
  541. <span id="499">499</span>
  542. <span id="500">500</span>
  543. <span id="501">501</span>
  544. <span id="502">502</span>
  545. <span id="503">503</span>
  546. <span id="504">504</span>
  547. <span id="505">505</span>
  548. <span id="506">506</span>
  549. <span id="507">507</span>
  550. <span id="508">508</span>
  551. <span id="509">509</span>
  552. <span id="510">510</span>
  553. <span id="511">511</span>
  554. <span id="512">512</span>
  555. <span id="513">513</span>
  556. <span id="514">514</span>
  557. <span id="515">515</span>
  558. <span id="516">516</span>
  559. <span id="517">517</span>
  560. <span id="518">518</span>
  561. <span id="519">519</span>
  562. <span id="520">520</span>
  563. <span id="521">521</span>
  564. <span id="522">522</span>
  565. <span id="523">523</span>
  566. <span id="524">524</span>
  567. <span id="525">525</span>
  568. <span id="526">526</span>
  569. <span id="527">527</span>
  570. <span id="528">528</span>
  571. <span id="529">529</span>
  572. <span id="530">530</span>
  573. <span id="531">531</span>
  574. <span id="532">532</span>
  575. <span id="533">533</span>
  576. <span id="534">534</span>
  577. <span id="535">535</span>
  578. <span id="536">536</span>
  579. <span id="537">537</span>
  580. <span id="538">538</span>
  581. <span id="539">539</span>
  582. <span id="540">540</span>
  583. <span id="541">541</span>
  584. <span id="542">542</span>
  585. <span id="543">543</span>
  586. <span id="544">544</span>
  587. <span id="545">545</span>
  588. <span id="546">546</span>
  589. <span id="547">547</span>
  590. <span id="548">548</span>
  591. <span id="549">549</span>
  592. <span id="550">550</span>
  593. <span id="551">551</span>
  594. <span id="552">552</span>
  595. <span id="553">553</span>
  596. <span id="554">554</span>
  597. <span id="555">555</span>
  598. <span id="556">556</span>
  599. <span id="557">557</span>
  600. <span id="558">558</span>
  601. <span id="559">559</span>
  602. <span id="560">560</span>
  603. <span id="561">561</span>
  604. <span id="562">562</span>
  605. <span id="563">563</span>
  606. <span id="564">564</span>
  607. <span id="565">565</span>
  608. <span id="566">566</span>
  609. <span id="567">567</span>
  610. <span id="568">568</span>
  611. <span id="569">569</span>
  612. <span id="570">570</span>
  613. <span id="571">571</span>
  614. <span id="572">572</span>
  615. <span id="573">573</span>
  616. <span id="574">574</span>
  617. <span id="575">575</span>
  618. <span id="576">576</span>
  619. <span id="577">577</span>
  620. <span id="578">578</span>
  621. <span id="579">579</span>
  622. <span id="580">580</span>
  623. <span id="581">581</span>
  624. <span id="582">582</span>
  625. <span id="583">583</span>
  626. <span id="584">584</span>
  627. <span id="585">585</span>
  628. <span id="586">586</span>
  629. <span id="587">587</span>
  630. <span id="588">588</span>
  631. <span id="589">589</span>
  632. <span id="590">590</span>
  633. <span id="591">591</span>
  634. <span id="592">592</span>
  635. <span id="593">593</span>
  636. <span id="594">594</span>
  637. <span id="595">595</span>
  638. <span id="596">596</span>
  639. <span id="597">597</span>
  640. <span id="598">598</span>
  641. <span id="599">599</span>
  642. <span id="600">600</span>
  643. <span id="601">601</span>
  644. <span id="602">602</span>
  645. <span id="603">603</span>
  646. <span id="604">604</span>
  647. <span id="605">605</span>
  648. <span id="606">606</span>
  649. <span id="607">607</span>
  650. <span id="608">608</span>
  651. <span id="609">609</span>
  652. <span id="610">610</span>
  653. <span id="611">611</span>
  654. <span id="612">612</span>
  655. <span id="613">613</span>
  656. <span id="614">614</span>
  657. <span id="615">615</span>
  658. <span id="616">616</span>
  659. <span id="617">617</span>
  660. <span id="618">618</span>
  661. <span id="619">619</span>
  662. <span id="620">620</span>
  663. <span id="621">621</span>
  664. <span id="622">622</span>
  665. <span id="623">623</span>
  666. <span id="624">624</span>
  667. <span id="625">625</span>
  668. <span id="626">626</span>
  669. <span id="627">627</span>
  670. <span id="628">628</span>
  671. <span id="629">629</span>
  672. <span id="630">630</span>
  673. <span id="631">631</span>
  674. <span id="632">632</span>
  675. <span id="633">633</span>
  676. <span id="634">634</span>
  677. <span id="635">635</span>
  678. <span id="636">636</span>
  679. <span id="637">637</span>
  680. <span id="638">638</span>
  681. <span id="639">639</span>
  682. <span id="640">640</span>
  683. <span id="641">641</span>
  684. <span id="642">642</span>
  685. <span id="643">643</span>
  686. <span id="644">644</span>
  687. <span id="645">645</span>
  688. <span id="646">646</span>
  689. <span id="647">647</span>
  690. <span id="648">648</span>
  691. <span id="649">649</span>
  692. <span id="650">650</span>
  693. <span id="651">651</span>
  694. <span id="652">652</span>
  695. <span id="653">653</span>
  696. <span id="654">654</span>
  697. <span id="655">655</span>
  698. <span id="656">656</span>
  699. <span id="657">657</span>
  700. <span id="658">658</span>
  701. <span id="659">659</span>
  702. <span id="660">660</span>
  703. <span id="661">661</span>
  704. <span id="662">662</span>
  705. <span id="663">663</span>
  706. <span id="664">664</span>
  707. <span id="665">665</span>
  708. <span id="666">666</span>
  709. <span id="667">667</span>
  710. <span id="668">668</span>
  711. <span id="669">669</span>
  712. <span id="670">670</span>
  713. <span id="671">671</span>
  714. <span id="672">672</span>
  715. <span id="673">673</span>
  716. <span id="674">674</span>
  717. <span id="675">675</span>
  718. <span id="676">676</span>
  719. <span id="677">677</span>
  720. <span id="678">678</span>
  721. <span id="679">679</span>
  722. <span id="680">680</span>
  723. <span id="681">681</span>
  724. <span id="682">682</span>
  725. <span id="683">683</span>
  726. <span id="684">684</span>
  727. <span id="685">685</span>
  728. <span id="686">686</span>
  729. <span id="687">687</span>
  730. <span id="688">688</span>
  731. <span id="689">689</span>
  732. <span id="690">690</span>
  733. <span id="691">691</span>
  734. <span id="692">692</span>
  735. <span id="693">693</span>
  736. <span id="694">694</span>
  737. <span id="695">695</span>
  738. <span id="696">696</span>
  739. <span id="697">697</span>
  740. <span id="698">698</span>
  741. <span id="699">699</span>
  742. <span id="700">700</span>
  743. <span id="701">701</span>
  744. <span id="702">702</span>
  745. <span id="703">703</span>
  746. <span id="704">704</span>
  747. <span id="705">705</span>
  748. <span id="706">706</span>
  749. <span id="707">707</span>
  750. <span id="708">708</span>
  751. <span id="709">709</span>
  752. <span id="710">710</span>
  753. <span id="711">711</span>
  754. <span id="712">712</span>
  755. <span id="713">713</span>
  756. <span id="714">714</span>
  757. <span id="715">715</span>
  758. <span id="716">716</span>
  759. <span id="717">717</span>
  760. <span id="718">718</span>
  761. <span id="719">719</span>
  762. <span id="720">720</span>
  763. <span id="721">721</span>
  764. <span id="722">722</span>
  765. <span id="723">723</span>
  766. <span id="724">724</span>
  767. <span id="725">725</span>
  768. <span id="726">726</span>
  769. <span id="727">727</span>
  770. <span id="728">728</span>
  771. <span id="729">729</span>
  772. <span id="730">730</span>
  773. <span id="731">731</span>
  774. <span id="732">732</span>
  775. <span id="733">733</span>
  776. <span id="734">734</span>
  777. <span id="735">735</span>
  778. <span id="736">736</span>
  779. <span id="737">737</span>
  780. <span id="738">738</span>
  781. <span id="739">739</span>
  782. <span id="740">740</span>
  783. <span id="741">741</span>
  784. <span id="742">742</span>
  785. <span id="743">743</span>
  786. <span id="744">744</span>
  787. <span id="745">745</span>
  788. <span id="746">746</span>
  789. <span id="747">747</span>
  790. <span id="748">748</span>
  791. <span id="749">749</span>
  792. <span id="750">750</span>
  793. <span id="751">751</span>
  794. <span id="752">752</span>
  795. <span id="753">753</span>
  796. <span id="754">754</span>
  797. <span id="755">755</span>
  798. <span id="756">756</span>
  799. <span id="757">757</span>
  800. <span id="758">758</span>
  801. <span id="759">759</span>
  802. <span id="760">760</span>
  803. <span id="761">761</span>
  804. <span id="762">762</span>
  805. <span id="763">763</span>
  806. <span id="764">764</span>
  807. <span id="765">765</span>
  808. <span id="766">766</span>
  809. <span id="767">767</span>
  810. <span id="768">768</span>
  811. <span id="769">769</span>
  812. <span id="770">770</span>
  813. <span id="771">771</span>
  814. <span id="772">772</span>
  815. <span id="773">773</span>
  816. <span id="774">774</span>
  817. <span id="775">775</span>
  818. <span id="776">776</span>
  819. <span id="777">777</span>
  820. <span id="778">778</span>
  821. <span id="779">779</span>
  822. <span id="780">780</span>
  823. <span id="781">781</span>
  824. <span id="782">782</span>
  825. <span id="783">783</span>
  826. <span id="784">784</span>
  827. <span id="785">785</span>
  828. <span id="786">786</span>
  829. <span id="787">787</span>
  830. <span id="788">788</span>
  831. <span id="789">789</span>
  832. <span id="790">790</span>
  833. <span id="791">791</span>
  834. <span id="792">792</span>
  835. <span id="793">793</span>
  836. <span id="794">794</span>
  837. <span id="795">795</span>
  838. <span id="796">796</span>
  839. <span id="797">797</span>
  840. <span id="798">798</span>
  841. <span id="799">799</span>
  842. <span id="800">800</span>
  843. <span id="801">801</span>
  844. <span id="802">802</span>
  845. <span id="803">803</span>
  846. <span id="804">804</span>
  847. <span id="805">805</span>
  848. <span id="806">806</span>
  849. <span id="807">807</span>
  850. <span id="808">808</span>
  851. <span id="809">809</span>
  852. <span id="810">810</span>
  853. <span id="811">811</span>
  854. <span id="812">812</span>
  855. <span id="813">813</span>
  856. <span id="814">814</span>
  857. <span id="815">815</span>
  858. <span id="816">816</span>
  859. <span id="817">817</span>
  860. <span id="818">818</span>
  861. <span id="819">819</span>
  862. <span id="820">820</span>
  863. <span id="821">821</span>
  864. <span id="822">822</span>
  865. <span id="823">823</span>
  866. <span id="824">824</span>
  867. <span id="825">825</span>
  868. <span id="826">826</span>
  869. <span id="827">827</span>
  870. <span id="828">828</span>
  871. <span id="829">829</span>
  872. <span id="830">830</span>
  873. <span id="831">831</span>
  874. <span id="832">832</span>
  875. <span id="833">833</span>
  876. <span id="834">834</span>
  877. <span id="835">835</span>
  878. <span id="836">836</span>
  879. </pre><pre class="rust ">
  880. <span class="kw">use</span> <span class="ident">std</span>::<span class="ident">ops</span>::<span class="ident">Neg</span>;
  881. <span class="kw">use</span> {<span class="ident">Num</span>, <span class="ident">NumCast</span>, <span class="ident">Float</span>};
  882. <span class="comment">// NOTE: These doctests have the same issue as those in src/float.rs.</span>
  883. <span class="comment">// They&#39;re testing the inherent methods directly, and not those of `Real`.</span>
  884. <span class="doccomment">/// A trait for real number types that do not necessarily have</span>
  885. <span class="doccomment">/// floating-point-specific characteristics such as NaN and infinity.</span>
  886. <span class="doccomment">///</span>
  887. <span class="doccomment">/// See [this Wikipedia article](https://en.wikipedia.org/wiki/Real_data_type)</span>
  888. <span class="doccomment">/// for a list of data types that could meaningfully implement this trait.</span>
  889. <span class="doccomment">///</span>
  890. <span class="doccomment">/// This trait is only available with the `std` feature.</span>
  891. <span class="kw">pub</span> <span class="kw">trait</span> <span class="ident">Real</span>
  892. : <span class="ident">Num</span>
  893. <span class="op">+</span> <span class="ident">Copy</span>
  894. <span class="op">+</span> <span class="ident">NumCast</span>
  895. <span class="op">+</span> <span class="ident">PartialOrd</span>
  896. <span class="op">+</span> <span class="ident">Neg</span><span class="op">&lt;</span><span class="ident">Output</span> <span class="op">=</span> <span class="self">Self</span><span class="op">&gt;</span>
  897. {
  898. <span class="doccomment">/// Returns the smallest finite value that this type can represent.</span>
  899. <span class="doccomment">///</span>
  900. <span class="doccomment">/// ```</span>
  901. <span class="doccomment">/// use num_traits::real::Real;</span>
  902. <span class="doccomment">/// use std::f64;</span>
  903. <span class="doccomment">///</span>
  904. <span class="doccomment">/// let x: f64 = Real::min_value();</span>
  905. <span class="doccomment">///</span>
  906. <span class="doccomment">/// assert_eq!(x, f64::MIN);</span>
  907. <span class="doccomment">/// ```</span>
  908. <span class="kw">fn</span> <span class="ident">min_value</span>() <span class="op">-&gt;</span> <span class="self">Self</span>;
  909. <span class="doccomment">/// Returns the smallest positive, normalized value that this type can represent.</span>
  910. <span class="doccomment">///</span>
  911. <span class="doccomment">/// ```</span>
  912. <span class="doccomment">/// use num_traits::real::Real;</span>
  913. <span class="doccomment">/// use std::f64;</span>
  914. <span class="doccomment">///</span>
  915. <span class="doccomment">/// let x: f64 = Real::min_positive_value();</span>
  916. <span class="doccomment">///</span>
  917. <span class="doccomment">/// assert_eq!(x, f64::MIN_POSITIVE);</span>
  918. <span class="doccomment">/// ```</span>
  919. <span class="kw">fn</span> <span class="ident">min_positive_value</span>() <span class="op">-&gt;</span> <span class="self">Self</span>;
  920. <span class="doccomment">/// Returns epsilon, a small positive value.</span>
  921. <span class="doccomment">///</span>
  922. <span class="doccomment">/// ```</span>
  923. <span class="doccomment">/// use num_traits::real::Real;</span>
  924. <span class="doccomment">/// use std::f64;</span>
  925. <span class="doccomment">///</span>
  926. <span class="doccomment">/// let x: f64 = Real::epsilon();</span>
  927. <span class="doccomment">///</span>
  928. <span class="doccomment">/// assert_eq!(x, f64::EPSILON);</span>
  929. <span class="doccomment">/// ```</span>
  930. <span class="doccomment">///</span>
  931. <span class="doccomment">/// # Panics</span>
  932. <span class="doccomment">///</span>
  933. <span class="doccomment">/// The default implementation will panic if `f32::EPSILON` cannot</span>
  934. <span class="doccomment">/// be cast to `Self`.</span>
  935. <span class="kw">fn</span> <span class="ident">epsilon</span>() <span class="op">-&gt;</span> <span class="self">Self</span>;
  936. <span class="doccomment">/// Returns the largest finite value that this type can represent.</span>
  937. <span class="doccomment">///</span>
  938. <span class="doccomment">/// ```</span>
  939. <span class="doccomment">/// use num_traits::real::Real;</span>
  940. <span class="doccomment">/// use std::f64;</span>
  941. <span class="doccomment">///</span>
  942. <span class="doccomment">/// let x: f64 = Real::max_value();</span>
  943. <span class="doccomment">/// assert_eq!(x, f64::MAX);</span>
  944. <span class="doccomment">/// ```</span>
  945. <span class="kw">fn</span> <span class="ident">max_value</span>() <span class="op">-&gt;</span> <span class="self">Self</span>;
  946. <span class="doccomment">/// Returns the largest integer less than or equal to a number.</span>
  947. <span class="doccomment">///</span>
  948. <span class="doccomment">/// ```</span>
  949. <span class="doccomment">/// use num_traits::real::Real;</span>
  950. <span class="doccomment">///</span>
  951. <span class="doccomment">/// let f = 3.99;</span>
  952. <span class="doccomment">/// let g = 3.0;</span>
  953. <span class="doccomment">///</span>
  954. <span class="doccomment">/// assert_eq!(f.floor(), 3.0);</span>
  955. <span class="doccomment">/// assert_eq!(g.floor(), 3.0);</span>
  956. <span class="doccomment">/// ```</span>
  957. <span class="kw">fn</span> <span class="ident">floor</span>(<span class="self">self</span>) <span class="op">-&gt;</span> <span class="self">Self</span>;
  958. <span class="doccomment">/// Returns the smallest integer greater than or equal to a number.</span>
  959. <span class="doccomment">///</span>
  960. <span class="doccomment">/// ```</span>
  961. <span class="doccomment">/// use num_traits::real::Real;</span>
  962. <span class="doccomment">///</span>
  963. <span class="doccomment">/// let f = 3.01;</span>
  964. <span class="doccomment">/// let g = 4.0;</span>
  965. <span class="doccomment">///</span>
  966. <span class="doccomment">/// assert_eq!(f.ceil(), 4.0);</span>
  967. <span class="doccomment">/// assert_eq!(g.ceil(), 4.0);</span>
  968. <span class="doccomment">/// ```</span>
  969. <span class="kw">fn</span> <span class="ident">ceil</span>(<span class="self">self</span>) <span class="op">-&gt;</span> <span class="self">Self</span>;
  970. <span class="doccomment">/// Returns the nearest integer to a number. Round half-way cases away from</span>
  971. <span class="doccomment">/// `0.0`.</span>
  972. <span class="doccomment">///</span>
  973. <span class="doccomment">/// ```</span>
  974. <span class="doccomment">/// use num_traits::real::Real;</span>
  975. <span class="doccomment">///</span>
  976. <span class="doccomment">/// let f = 3.3;</span>
  977. <span class="doccomment">/// let g = -3.3;</span>
  978. <span class="doccomment">///</span>
  979. <span class="doccomment">/// assert_eq!(f.round(), 3.0);</span>
  980. <span class="doccomment">/// assert_eq!(g.round(), -3.0);</span>
  981. <span class="doccomment">/// ```</span>
  982. <span class="kw">fn</span> <span class="ident">round</span>(<span class="self">self</span>) <span class="op">-&gt;</span> <span class="self">Self</span>;
  983. <span class="doccomment">/// Return the integer part of a number.</span>
  984. <span class="doccomment">///</span>
  985. <span class="doccomment">/// ```</span>
  986. <span class="doccomment">/// use num_traits::real::Real;</span>
  987. <span class="doccomment">///</span>
  988. <span class="doccomment">/// let f = 3.3;</span>
  989. <span class="doccomment">/// let g = -3.7;</span>
  990. <span class="doccomment">///</span>
  991. <span class="doccomment">/// assert_eq!(f.trunc(), 3.0);</span>
  992. <span class="doccomment">/// assert_eq!(g.trunc(), -3.0);</span>
  993. <span class="doccomment">/// ```</span>
  994. <span class="kw">fn</span> <span class="ident">trunc</span>(<span class="self">self</span>) <span class="op">-&gt;</span> <span class="self">Self</span>;
  995. <span class="doccomment">/// Returns the fractional part of a number.</span>
  996. <span class="doccomment">///</span>
  997. <span class="doccomment">/// ```</span>
  998. <span class="doccomment">/// use num_traits::real::Real;</span>
  999. <span class="doccomment">///</span>
  1000. <span class="doccomment">/// let x = 3.5;</span>
  1001. <span class="doccomment">/// let y = -3.5;</span>
  1002. <span class="doccomment">/// let abs_difference_x = (x.fract() - 0.5).abs();</span>
  1003. <span class="doccomment">/// let abs_difference_y = (y.fract() - (-0.5)).abs();</span>
  1004. <span class="doccomment">///</span>
  1005. <span class="doccomment">/// assert!(abs_difference_x &lt; 1e-10);</span>
  1006. <span class="doccomment">/// assert!(abs_difference_y &lt; 1e-10);</span>
  1007. <span class="doccomment">/// ```</span>
  1008. <span class="kw">fn</span> <span class="ident">fract</span>(<span class="self">self</span>) <span class="op">-&gt;</span> <span class="self">Self</span>;
  1009. <span class="doccomment">/// Computes the absolute value of `self`. Returns `Float::nan()` if the</span>
  1010. <span class="doccomment">/// number is `Float::nan()`.</span>
  1011. <span class="doccomment">///</span>
  1012. <span class="doccomment">/// ```</span>
  1013. <span class="doccomment">/// use num_traits::real::Real;</span>
  1014. <span class="doccomment">/// use std::f64;</span>
  1015. <span class="doccomment">///</span>
  1016. <span class="doccomment">/// let x = 3.5;</span>
  1017. <span class="doccomment">/// let y = -3.5;</span>
  1018. <span class="doccomment">///</span>
  1019. <span class="doccomment">/// let abs_difference_x = (x.abs() - x).abs();</span>
  1020. <span class="doccomment">/// let abs_difference_y = (y.abs() - (-y)).abs();</span>
  1021. <span class="doccomment">///</span>
  1022. <span class="doccomment">/// assert!(abs_difference_x &lt; 1e-10);</span>
  1023. <span class="doccomment">/// assert!(abs_difference_y &lt; 1e-10);</span>
  1024. <span class="doccomment">///</span>
  1025. <span class="doccomment">/// assert!(::num_traits::Float::is_nan(f64::NAN.abs()));</span>
  1026. <span class="doccomment">/// ```</span>
  1027. <span class="kw">fn</span> <span class="ident">abs</span>(<span class="self">self</span>) <span class="op">-&gt;</span> <span class="self">Self</span>;
  1028. <span class="doccomment">/// Returns a number that represents the sign of `self`.</span>
  1029. <span class="doccomment">///</span>
  1030. <span class="doccomment">/// - `1.0` if the number is positive, `+0.0` or `Float::infinity()`</span>
  1031. <span class="doccomment">/// - `-1.0` if the number is negative, `-0.0` or `Float::neg_infinity()`</span>
  1032. <span class="doccomment">/// - `Float::nan()` if the number is `Float::nan()`</span>
  1033. <span class="doccomment">///</span>
  1034. <span class="doccomment">/// ```</span>
  1035. <span class="doccomment">/// use num_traits::real::Real;</span>
  1036. <span class="doccomment">/// use std::f64;</span>
  1037. <span class="doccomment">///</span>
  1038. <span class="doccomment">/// let f = 3.5;</span>
  1039. <span class="doccomment">///</span>
  1040. <span class="doccomment">/// assert_eq!(f.signum(), 1.0);</span>
  1041. <span class="doccomment">/// assert_eq!(f64::NEG_INFINITY.signum(), -1.0);</span>
  1042. <span class="doccomment">///</span>
  1043. <span class="doccomment">/// assert!(f64::NAN.signum().is_nan());</span>
  1044. <span class="doccomment">/// ```</span>
  1045. <span class="kw">fn</span> <span class="ident">signum</span>(<span class="self">self</span>) <span class="op">-&gt;</span> <span class="self">Self</span>;
  1046. <span class="doccomment">/// Returns `true` if `self` is positive, including `+0.0`,</span>
  1047. <span class="doccomment">/// `Float::infinity()`, and with newer versions of Rust `f64::NAN`.</span>
  1048. <span class="doccomment">///</span>
  1049. <span class="doccomment">/// ```</span>
  1050. <span class="doccomment">/// use num_traits::real::Real;</span>
  1051. <span class="doccomment">/// use std::f64;</span>
  1052. <span class="doccomment">///</span>
  1053. <span class="doccomment">/// let neg_nan: f64 = -f64::NAN;</span>
  1054. <span class="doccomment">///</span>
  1055. <span class="doccomment">/// let f = 7.0;</span>
  1056. <span class="doccomment">/// let g = -7.0;</span>
  1057. <span class="doccomment">///</span>
  1058. <span class="doccomment">/// assert!(f.is_sign_positive());</span>
  1059. <span class="doccomment">/// assert!(!g.is_sign_positive());</span>
  1060. <span class="doccomment">/// assert!(!neg_nan.is_sign_positive());</span>
  1061. <span class="doccomment">/// ```</span>
  1062. <span class="kw">fn</span> <span class="ident">is_sign_positive</span>(<span class="self">self</span>) <span class="op">-&gt;</span> <span class="ident">bool</span>;
  1063. <span class="doccomment">/// Returns `true` if `self` is negative, including `-0.0`,</span>
  1064. <span class="doccomment">/// `Float::neg_infinity()`, and with newer versions of Rust `-f64::NAN`.</span>
  1065. <span class="doccomment">///</span>
  1066. <span class="doccomment">/// ```</span>
  1067. <span class="doccomment">/// use num_traits::real::Real;</span>
  1068. <span class="doccomment">/// use std::f64;</span>
  1069. <span class="doccomment">///</span>
  1070. <span class="doccomment">/// let nan: f64 = f64::NAN;</span>
  1071. <span class="doccomment">///</span>
  1072. <span class="doccomment">/// let f = 7.0;</span>
  1073. <span class="doccomment">/// let g = -7.0;</span>
  1074. <span class="doccomment">///</span>
  1075. <span class="doccomment">/// assert!(!f.is_sign_negative());</span>
  1076. <span class="doccomment">/// assert!(g.is_sign_negative());</span>
  1077. <span class="doccomment">/// assert!(!nan.is_sign_negative());</span>
  1078. <span class="doccomment">/// ```</span>
  1079. <span class="kw">fn</span> <span class="ident">is_sign_negative</span>(<span class="self">self</span>) <span class="op">-&gt;</span> <span class="ident">bool</span>;
  1080. <span class="doccomment">/// Fused multiply-add. Computes `(self * a) + b` with only one rounding</span>
  1081. <span class="doccomment">/// error. This produces a more accurate result with better performance than</span>
  1082. <span class="doccomment">/// a separate multiplication operation followed by an add.</span>
  1083. <span class="doccomment">///</span>
  1084. <span class="doccomment">/// ```</span>
  1085. <span class="doccomment">/// use num_traits::real::Real;</span>
  1086. <span class="doccomment">///</span>
  1087. <span class="doccomment">/// let m = 10.0;</span>
  1088. <span class="doccomment">/// let x = 4.0;</span>
  1089. <span class="doccomment">/// let b = 60.0;</span>
  1090. <span class="doccomment">///</span>
  1091. <span class="doccomment">/// // 100.0</span>
  1092. <span class="doccomment">/// let abs_difference = (m.mul_add(x, b) - (m*x + b)).abs();</span>
  1093. <span class="doccomment">///</span>
  1094. <span class="doccomment">/// assert!(abs_difference &lt; 1e-10);</span>
  1095. <span class="doccomment">/// ```</span>
  1096. <span class="kw">fn</span> <span class="ident">mul_add</span>(<span class="self">self</span>, <span class="ident">a</span>: <span class="self">Self</span>, <span class="ident">b</span>: <span class="self">Self</span>) <span class="op">-&gt;</span> <span class="self">Self</span>;
  1097. <span class="doccomment">/// Take the reciprocal (inverse) of a number, `1/x`.</span>
  1098. <span class="doccomment">///</span>
  1099. <span class="doccomment">/// ```</span>
  1100. <span class="doccomment">/// use num_traits::real::Real;</span>
  1101. <span class="doccomment">///</span>
  1102. <span class="doccomment">/// let x = 2.0;</span>
  1103. <span class="doccomment">/// let abs_difference = (x.recip() - (1.0/x)).abs();</span>
  1104. <span class="doccomment">///</span>
  1105. <span class="doccomment">/// assert!(abs_difference &lt; 1e-10);</span>
  1106. <span class="doccomment">/// ```</span>
  1107. <span class="kw">fn</span> <span class="ident">recip</span>(<span class="self">self</span>) <span class="op">-&gt;</span> <span class="self">Self</span>;
  1108. <span class="doccomment">/// Raise a number to an integer power.</span>
  1109. <span class="doccomment">///</span>
  1110. <span class="doccomment">/// Using this function is generally faster than using `powf`</span>
  1111. <span class="doccomment">///</span>
  1112. <span class="doccomment">/// ```</span>
  1113. <span class="doccomment">/// use num_traits::real::Real;</span>
  1114. <span class="doccomment">///</span>
  1115. <span class="doccomment">/// let x = 2.0;</span>
  1116. <span class="doccomment">/// let abs_difference = (x.powi(2) - x*x).abs();</span>
  1117. <span class="doccomment">///</span>
  1118. <span class="doccomment">/// assert!(abs_difference &lt; 1e-10);</span>
  1119. <span class="doccomment">/// ```</span>
  1120. <span class="kw">fn</span> <span class="ident">powi</span>(<span class="self">self</span>, <span class="ident">n</span>: <span class="ident">i32</span>) <span class="op">-&gt;</span> <span class="self">Self</span>;
  1121. <span class="doccomment">/// Raise a number to a real number power.</span>
  1122. <span class="doccomment">///</span>
  1123. <span class="doccomment">/// ```</span>
  1124. <span class="doccomment">/// use num_traits::real::Real;</span>
  1125. <span class="doccomment">///</span>
  1126. <span class="doccomment">/// let x = 2.0;</span>
  1127. <span class="doccomment">/// let abs_difference = (x.powf(2.0) - x*x).abs();</span>
  1128. <span class="doccomment">///</span>
  1129. <span class="doccomment">/// assert!(abs_difference &lt; 1e-10);</span>
  1130. <span class="doccomment">/// ```</span>
  1131. <span class="kw">fn</span> <span class="ident">powf</span>(<span class="self">self</span>, <span class="ident">n</span>: <span class="self">Self</span>) <span class="op">-&gt;</span> <span class="self">Self</span>;
  1132. <span class="doccomment">/// Take the square root of a number.</span>
  1133. <span class="doccomment">///</span>
  1134. <span class="doccomment">/// Returns NaN if `self` is a negative floating-point number. </span>
  1135. <span class="doccomment">///</span>
  1136. <span class="doccomment">/// # Panics</span>
  1137. <span class="doccomment">///</span>
  1138. <span class="doccomment">/// If the implementing type doesn&#39;t support NaN, this method should panic if `self &lt; 0`.</span>
  1139. <span class="doccomment">///</span>
  1140. <span class="doccomment">/// ```</span>
  1141. <span class="doccomment">/// use num_traits::real::Real;</span>
  1142. <span class="doccomment">///</span>
  1143. <span class="doccomment">/// let positive = 4.0;</span>
  1144. <span class="doccomment">/// let negative = -4.0;</span>
  1145. <span class="doccomment">///</span>
  1146. <span class="doccomment">/// let abs_difference = (positive.sqrt() - 2.0).abs();</span>
  1147. <span class="doccomment">///</span>
  1148. <span class="doccomment">/// assert!(abs_difference &lt; 1e-10);</span>
  1149. <span class="doccomment">/// assert!(::num_traits::Float::is_nan(negative.sqrt()));</span>
  1150. <span class="doccomment">/// ```</span>
  1151. <span class="kw">fn</span> <span class="ident">sqrt</span>(<span class="self">self</span>) <span class="op">-&gt;</span> <span class="self">Self</span>;
  1152. <span class="doccomment">/// Returns `e^(self)`, (the exponential function).</span>
  1153. <span class="doccomment">///</span>
  1154. <span class="doccomment">/// ```</span>
  1155. <span class="doccomment">/// use num_traits::real::Real;</span>
  1156. <span class="doccomment">///</span>
  1157. <span class="doccomment">/// let one = 1.0;</span>
  1158. <span class="doccomment">/// // e^1</span>
  1159. <span class="doccomment">/// let e = one.exp();</span>
  1160. <span class="doccomment">///</span>
  1161. <span class="doccomment">/// // ln(e) - 1 == 0</span>
  1162. <span class="doccomment">/// let abs_difference = (e.ln() - 1.0).abs();</span>
  1163. <span class="doccomment">///</span>
  1164. <span class="doccomment">/// assert!(abs_difference &lt; 1e-10);</span>
  1165. <span class="doccomment">/// ```</span>
  1166. <span class="kw">fn</span> <span class="ident">exp</span>(<span class="self">self</span>) <span class="op">-&gt;</span> <span class="self">Self</span>;
  1167. <span class="doccomment">/// Returns `2^(self)`.</span>
  1168. <span class="doccomment">///</span>
  1169. <span class="doccomment">/// ```</span>
  1170. <span class="doccomment">/// use num_traits::real::Real;</span>
  1171. <span class="doccomment">///</span>
  1172. <span class="doccomment">/// let f = 2.0;</span>
  1173. <span class="doccomment">///</span>
  1174. <span class="doccomment">/// // 2^2 - 4 == 0</span>
  1175. <span class="doccomment">/// let abs_difference = (f.exp2() - 4.0).abs();</span>
  1176. <span class="doccomment">///</span>
  1177. <span class="doccomment">/// assert!(abs_difference &lt; 1e-10);</span>
  1178. <span class="doccomment">/// ```</span>
  1179. <span class="kw">fn</span> <span class="ident">exp2</span>(<span class="self">self</span>) <span class="op">-&gt;</span> <span class="self">Self</span>;
  1180. <span class="doccomment">/// Returns the natural logarithm of the number.</span>
  1181. <span class="doccomment">///</span>
  1182. <span class="doccomment">/// # Panics</span>
  1183. <span class="doccomment">///</span>
  1184. <span class="doccomment">/// If `self &lt;= 0` and this type does not support a NaN representation, this function should panic.</span>
  1185. <span class="doccomment">///</span>
  1186. <span class="doccomment">/// ```</span>
  1187. <span class="doccomment">/// use num_traits::real::Real;</span>
  1188. <span class="doccomment">///</span>
  1189. <span class="doccomment">/// let one = 1.0;</span>
  1190. <span class="doccomment">/// // e^1</span>
  1191. <span class="doccomment">/// let e = one.exp();</span>
  1192. <span class="doccomment">///</span>
  1193. <span class="doccomment">/// // ln(e) - 1 == 0</span>
  1194. <span class="doccomment">/// let abs_difference = (e.ln() - 1.0).abs();</span>
  1195. <span class="doccomment">///</span>
  1196. <span class="doccomment">/// assert!(abs_difference &lt; 1e-10);</span>
  1197. <span class="doccomment">/// ```</span>
  1198. <span class="kw">fn</span> <span class="ident">ln</span>(<span class="self">self</span>) <span class="op">-&gt;</span> <span class="self">Self</span>;
  1199. <span class="doccomment">/// Returns the logarithm of the number with respect to an arbitrary base.</span>
  1200. <span class="doccomment">///</span>
  1201. <span class="doccomment">/// # Panics</span>
  1202. <span class="doccomment">///</span>
  1203. <span class="doccomment">/// If `self &lt;= 0` and this type does not support a NaN representation, this function should panic.</span>
  1204. <span class="doccomment">///</span>
  1205. <span class="doccomment">/// ```</span>
  1206. <span class="doccomment">/// use num_traits::real::Real;</span>
  1207. <span class="doccomment">///</span>
  1208. <span class="doccomment">/// let ten = 10.0;</span>
  1209. <span class="doccomment">/// let two = 2.0;</span>
  1210. <span class="doccomment">///</span>
  1211. <span class="doccomment">/// // log10(10) - 1 == 0</span>
  1212. <span class="doccomment">/// let abs_difference_10 = (ten.log(10.0) - 1.0).abs();</span>
  1213. <span class="doccomment">///</span>
  1214. <span class="doccomment">/// // log2(2) - 1 == 0</span>
  1215. <span class="doccomment">/// let abs_difference_2 = (two.log(2.0) - 1.0).abs();</span>
  1216. <span class="doccomment">///</span>
  1217. <span class="doccomment">/// assert!(abs_difference_10 &lt; 1e-10);</span>
  1218. <span class="doccomment">/// assert!(abs_difference_2 &lt; 1e-10);</span>
  1219. <span class="doccomment">/// ```</span>
  1220. <span class="kw">fn</span> <span class="ident">log</span>(<span class="self">self</span>, <span class="ident">base</span>: <span class="self">Self</span>) <span class="op">-&gt;</span> <span class="self">Self</span>;
  1221. <span class="doccomment">/// Returns the base 2 logarithm of the number.</span>
  1222. <span class="doccomment">///</span>
  1223. <span class="doccomment">/// # Panics</span>
  1224. <span class="doccomment">///</span>
  1225. <span class="doccomment">/// If `self &lt;= 0` and this type does not support a NaN representation, this function should panic.</span>
  1226. <span class="doccomment">///</span>
  1227. <span class="doccomment">/// ```</span>
  1228. <span class="doccomment">/// use num_traits::real::Real;</span>
  1229. <span class="doccomment">///</span>
  1230. <span class="doccomment">/// let two = 2.0;</span>
  1231. <span class="doccomment">///</span>
  1232. <span class="doccomment">/// // log2(2) - 1 == 0</span>
  1233. <span class="doccomment">/// let abs_difference = (two.log2() - 1.0).abs();</span>
  1234. <span class="doccomment">///</span>
  1235. <span class="doccomment">/// assert!(abs_difference &lt; 1e-10);</span>
  1236. <span class="doccomment">/// ```</span>
  1237. <span class="kw">fn</span> <span class="ident">log2</span>(<span class="self">self</span>) <span class="op">-&gt;</span> <span class="self">Self</span>;
  1238. <span class="doccomment">/// Returns the base 10 logarithm of the number.</span>
  1239. <span class="doccomment">///</span>
  1240. <span class="doccomment">/// # Panics</span>
  1241. <span class="doccomment">///</span>
  1242. <span class="doccomment">/// If `self &lt;= 0` and this type does not support a NaN representation, this function should panic.</span>
  1243. <span class="doccomment">///</span>
  1244. <span class="doccomment">///</span>
  1245. <span class="doccomment">/// ```</span>
  1246. <span class="doccomment">/// use num_traits::real::Real;</span>
  1247. <span class="doccomment">///</span>
  1248. <span class="doccomment">/// let ten = 10.0;</span>
  1249. <span class="doccomment">///</span>
  1250. <span class="doccomment">/// // log10(10) - 1 == 0</span>
  1251. <span class="doccomment">/// let abs_difference = (ten.log10() - 1.0).abs();</span>
  1252. <span class="doccomment">///</span>
  1253. <span class="doccomment">/// assert!(abs_difference &lt; 1e-10);</span>
  1254. <span class="doccomment">/// ```</span>
  1255. <span class="kw">fn</span> <span class="ident">log10</span>(<span class="self">self</span>) <span class="op">-&gt;</span> <span class="self">Self</span>;
  1256. <span class="doccomment">/// Converts radians to degrees.</span>
  1257. <span class="doccomment">///</span>
  1258. <span class="doccomment">/// ```</span>
  1259. <span class="doccomment">/// use std::f64::consts;</span>
  1260. <span class="doccomment">///</span>
  1261. <span class="doccomment">/// let angle = consts::PI;</span>
  1262. <span class="doccomment">///</span>
  1263. <span class="doccomment">/// let abs_difference = (angle.to_degrees() - 180.0).abs();</span>
  1264. <span class="doccomment">///</span>
  1265. <span class="doccomment">/// assert!(abs_difference &lt; 1e-10);</span>
  1266. <span class="doccomment">/// ```</span>
  1267. <span class="kw">fn</span> <span class="ident">to_degrees</span>(<span class="self">self</span>) <span class="op">-&gt;</span> <span class="self">Self</span>;
  1268. <span class="doccomment">/// Converts degrees to radians.</span>
  1269. <span class="doccomment">///</span>
  1270. <span class="doccomment">/// ```</span>
  1271. <span class="doccomment">/// use std::f64::consts;</span>
  1272. <span class="doccomment">///</span>
  1273. <span class="doccomment">/// let angle = 180.0_f64;</span>
  1274. <span class="doccomment">///</span>
  1275. <span class="doccomment">/// let abs_difference = (angle.to_radians() - consts::PI).abs();</span>
  1276. <span class="doccomment">///</span>
  1277. <span class="doccomment">/// assert!(abs_difference &lt; 1e-10);</span>
  1278. <span class="doccomment">/// ```</span>
  1279. <span class="kw">fn</span> <span class="ident">to_radians</span>(<span class="self">self</span>) <span class="op">-&gt;</span> <span class="self">Self</span>;
  1280. <span class="doccomment">/// Returns the maximum of the two numbers.</span>
  1281. <span class="doccomment">///</span>
  1282. <span class="doccomment">/// ```</span>
  1283. <span class="doccomment">/// use num_traits::real::Real;</span>
  1284. <span class="doccomment">///</span>
  1285. <span class="doccomment">/// let x = 1.0;</span>
  1286. <span class="doccomment">/// let y = 2.0;</span>
  1287. <span class="doccomment">///</span>
  1288. <span class="doccomment">/// assert_eq!(x.max(y), y);</span>
  1289. <span class="doccomment">/// ```</span>
  1290. <span class="kw">fn</span> <span class="ident">max</span>(<span class="self">self</span>, <span class="ident">other</span>: <span class="self">Self</span>) <span class="op">-&gt;</span> <span class="self">Self</span>;
  1291. <span class="doccomment">/// Returns the minimum of the two numbers.</span>
  1292. <span class="doccomment">///</span>
  1293. <span class="doccomment">/// ```</span>
  1294. <span class="doccomment">/// use num_traits::real::Real;</span>
  1295. <span class="doccomment">///</span>
  1296. <span class="doccomment">/// let x = 1.0;</span>
  1297. <span class="doccomment">/// let y = 2.0;</span>
  1298. <span class="doccomment">///</span>
  1299. <span class="doccomment">/// assert_eq!(x.min(y), x);</span>
  1300. <span class="doccomment">/// ```</span>
  1301. <span class="kw">fn</span> <span class="ident">min</span>(<span class="self">self</span>, <span class="ident">other</span>: <span class="self">Self</span>) <span class="op">-&gt;</span> <span class="self">Self</span>;
  1302. <span class="doccomment">/// The positive difference of two numbers.</span>
  1303. <span class="doccomment">///</span>
  1304. <span class="doccomment">/// * If `self &lt;= other`: `0:0`</span>
  1305. <span class="doccomment">/// * Else: `self - other`</span>
  1306. <span class="doccomment">///</span>
  1307. <span class="doccomment">/// ```</span>
  1308. <span class="doccomment">/// use num_traits::real::Real;</span>
  1309. <span class="doccomment">///</span>
  1310. <span class="doccomment">/// let x = 3.0;</span>
  1311. <span class="doccomment">/// let y = -3.0;</span>
  1312. <span class="doccomment">///</span>
  1313. <span class="doccomment">/// let abs_difference_x = (x.abs_sub(1.0) - 2.0).abs();</span>
  1314. <span class="doccomment">/// let abs_difference_y = (y.abs_sub(1.0) - 0.0).abs();</span>
  1315. <span class="doccomment">///</span>
  1316. <span class="doccomment">/// assert!(abs_difference_x &lt; 1e-10);</span>
  1317. <span class="doccomment">/// assert!(abs_difference_y &lt; 1e-10);</span>
  1318. <span class="doccomment">/// ```</span>
  1319. <span class="kw">fn</span> <span class="ident">abs_sub</span>(<span class="self">self</span>, <span class="ident">other</span>: <span class="self">Self</span>) <span class="op">-&gt;</span> <span class="self">Self</span>;
  1320. <span class="doccomment">/// Take the cubic root of a number.</span>
  1321. <span class="doccomment">///</span>
  1322. <span class="doccomment">/// ```</span>
  1323. <span class="doccomment">/// use num_traits::real::Real;</span>
  1324. <span class="doccomment">///</span>
  1325. <span class="doccomment">/// let x = 8.0;</span>
  1326. <span class="doccomment">///</span>
  1327. <span class="doccomment">/// // x^(1/3) - 2 == 0</span>
  1328. <span class="doccomment">/// let abs_difference = (x.cbrt() - 2.0).abs();</span>
  1329. <span class="doccomment">///</span>
  1330. <span class="doccomment">/// assert!(abs_difference &lt; 1e-10);</span>
  1331. <span class="doccomment">/// ```</span>
  1332. <span class="kw">fn</span> <span class="ident">cbrt</span>(<span class="self">self</span>) <span class="op">-&gt;</span> <span class="self">Self</span>;
  1333. <span class="doccomment">/// Calculate the length of the hypotenuse of a right-angle triangle given</span>
  1334. <span class="doccomment">/// legs of length `x` and `y`.</span>
  1335. <span class="doccomment">///</span>
  1336. <span class="doccomment">/// ```</span>
  1337. <span class="doccomment">/// use num_traits::real::Real;</span>
  1338. <span class="doccomment">///</span>
  1339. <span class="doccomment">/// let x = 2.0;</span>
  1340. <span class="doccomment">/// let y = 3.0;</span>
  1341. <span class="doccomment">///</span>
  1342. <span class="doccomment">/// // sqrt(x^2 + y^2)</span>
  1343. <span class="doccomment">/// let abs_difference = (x.hypot(y) - (x.powi(2) + y.powi(2)).sqrt()).abs();</span>
  1344. <span class="doccomment">///</span>
  1345. <span class="doccomment">/// assert!(abs_difference &lt; 1e-10);</span>
  1346. <span class="doccomment">/// ```</span>
  1347. <span class="kw">fn</span> <span class="ident">hypot</span>(<span class="self">self</span>, <span class="ident">other</span>: <span class="self">Self</span>) <span class="op">-&gt;</span> <span class="self">Self</span>;
  1348. <span class="doccomment">/// Computes the sine of a number (in radians).</span>
  1349. <span class="doccomment">///</span>
  1350. <span class="doccomment">/// ```</span>
  1351. <span class="doccomment">/// use num_traits::real::Real;</span>
  1352. <span class="doccomment">/// use std::f64;</span>
  1353. <span class="doccomment">///</span>
  1354. <span class="doccomment">/// let x = f64::consts::PI/2.0;</span>
  1355. <span class="doccomment">///</span>
  1356. <span class="doccomment">/// let abs_difference = (x.sin() - 1.0).abs();</span>
  1357. <span class="doccomment">///</span>
  1358. <span class="doccomment">/// assert!(abs_difference &lt; 1e-10);</span>
  1359. <span class="doccomment">/// ```</span>
  1360. <span class="kw">fn</span> <span class="ident">sin</span>(<span class="self">self</span>) <span class="op">-&gt;</span> <span class="self">Self</span>;
  1361. <span class="doccomment">/// Computes the cosine of a number (in radians).</span>
  1362. <span class="doccomment">///</span>
  1363. <span class="doccomment">/// ```</span>
  1364. <span class="doccomment">/// use num_traits::real::Real;</span>
  1365. <span class="doccomment">/// use std::f64;</span>
  1366. <span class="doccomment">///</span>
  1367. <span class="doccomment">/// let x = 2.0*f64::consts::PI;</span>
  1368. <span class="doccomment">///</span>
  1369. <span class="doccomment">/// let abs_difference = (x.cos() - 1.0).abs();</span>
  1370. <span class="doccomment">///</span>
  1371. <span class="doccomment">/// assert!(abs_difference &lt; 1e-10);</span>
  1372. <span class="doccomment">/// ```</span>
  1373. <span class="kw">fn</span> <span class="ident">cos</span>(<span class="self">self</span>) <span class="op">-&gt;</span> <span class="self">Self</span>;
  1374. <span class="doccomment">/// Computes the tangent of a number (in radians).</span>
  1375. <span class="doccomment">///</span>
  1376. <span class="doccomment">/// ```</span>
  1377. <span class="doccomment">/// use num_traits::real::Real;</span>
  1378. <span class="doccomment">/// use std::f64;</span>
  1379. <span class="doccomment">///</span>
  1380. <span class="doccomment">/// let x = f64::consts::PI/4.0;</span>
  1381. <span class="doccomment">/// let abs_difference = (x.tan() - 1.0).abs();</span>
  1382. <span class="doccomment">///</span>
  1383. <span class="doccomment">/// assert!(abs_difference &lt; 1e-14);</span>
  1384. <span class="doccomment">/// ```</span>
  1385. <span class="kw">fn</span> <span class="ident">tan</span>(<span class="self">self</span>) <span class="op">-&gt;</span> <span class="self">Self</span>;
  1386. <span class="doccomment">/// Computes the arcsine of a number. Return value is in radians in</span>
  1387. <span class="doccomment">/// the range [-pi/2, pi/2] or NaN if the number is outside the range</span>
  1388. <span class="doccomment">/// [-1, 1].</span>
  1389. <span class="doccomment">///</span>
  1390. <span class="doccomment">/// # Panics</span>
  1391. <span class="doccomment">///</span>
  1392. <span class="doccomment">/// If this type does not support a NaN representation, this function should panic</span>
  1393. <span class="doccomment">/// if the number is outside the range [-1, 1].</span>
  1394. <span class="doccomment">///</span>
  1395. <span class="doccomment">/// ```</span>
  1396. <span class="doccomment">/// use num_traits::real::Real;</span>
  1397. <span class="doccomment">/// use std::f64;</span>
  1398. <span class="doccomment">///</span>
  1399. <span class="doccomment">/// let f = f64::consts::PI / 2.0;</span>
  1400. <span class="doccomment">///</span>
  1401. <span class="doccomment">/// // asin(sin(pi/2))</span>
  1402. <span class="doccomment">/// let abs_difference = (f.sin().asin() - f64::consts::PI / 2.0).abs();</span>
  1403. <span class="doccomment">///</span>
  1404. <span class="doccomment">/// assert!(abs_difference &lt; 1e-10);</span>
  1405. <span class="doccomment">/// ```</span>
  1406. <span class="kw">fn</span> <span class="ident">asin</span>(<span class="self">self</span>) <span class="op">-&gt;</span> <span class="self">Self</span>;
  1407. <span class="doccomment">/// Computes the arccosine of a number. Return value is in radians in</span>
  1408. <span class="doccomment">/// the range [0, pi] or NaN if the number is outside the range</span>
  1409. <span class="doccomment">/// [-1, 1].</span>
  1410. <span class="doccomment">///</span>
  1411. <span class="doccomment">/// # Panics</span>
  1412. <span class="doccomment">///</span>
  1413. <span class="doccomment">/// If this type does not support a NaN representation, this function should panic</span>
  1414. <span class="doccomment">/// if the number is outside the range [-1, 1].</span>
  1415. <span class="doccomment">///</span>
  1416. <span class="doccomment">/// ```</span>
  1417. <span class="doccomment">/// use num_traits::real::Real;</span>
  1418. <span class="doccomment">/// use std::f64;</span>
  1419. <span class="doccomment">///</span>
  1420. <span class="doccomment">/// let f = f64::consts::PI / 4.0;</span>
  1421. <span class="doccomment">///</span>
  1422. <span class="doccomment">/// // acos(cos(pi/4))</span>
  1423. <span class="doccomment">/// let abs_difference = (f.cos().acos() - f64::consts::PI / 4.0).abs();</span>
  1424. <span class="doccomment">///</span>
  1425. <span class="doccomment">/// assert!(abs_difference &lt; 1e-10);</span>
  1426. <span class="doccomment">/// ```</span>
  1427. <span class="kw">fn</span> <span class="ident">acos</span>(<span class="self">self</span>) <span class="op">-&gt;</span> <span class="self">Self</span>;
  1428. <span class="doccomment">/// Computes the arctangent of a number. Return value is in radians in the</span>
  1429. <span class="doccomment">/// range [-pi/2, pi/2];</span>
  1430. <span class="doccomment">///</span>
  1431. <span class="doccomment">/// ```</span>
  1432. <span class="doccomment">/// use num_traits::real::Real;</span>
  1433. <span class="doccomment">///</span>
  1434. <span class="doccomment">/// let f = 1.0;</span>
  1435. <span class="doccomment">///</span>
  1436. <span class="doccomment">/// // atan(tan(1))</span>
  1437. <span class="doccomment">/// let abs_difference = (f.tan().atan() - 1.0).abs();</span>
  1438. <span class="doccomment">///</span>
  1439. <span class="doccomment">/// assert!(abs_difference &lt; 1e-10);</span>
  1440. <span class="doccomment">/// ```</span>
  1441. <span class="kw">fn</span> <span class="ident">atan</span>(<span class="self">self</span>) <span class="op">-&gt;</span> <span class="self">Self</span>;
  1442. <span class="doccomment">/// Computes the four quadrant arctangent of `self` (`y`) and `other` (`x`).</span>
  1443. <span class="doccomment">///</span>
  1444. <span class="doccomment">/// * `x = 0`, `y = 0`: `0`</span>
  1445. <span class="doccomment">/// * `x &gt;= 0`: `arctan(y/x)` -&gt; `[-pi/2, pi/2]`</span>
  1446. <span class="doccomment">/// * `y &gt;= 0`: `arctan(y/x) + pi` -&gt; `(pi/2, pi]`</span>
  1447. <span class="doccomment">/// * `y &lt; 0`: `arctan(y/x) - pi` -&gt; `(-pi, -pi/2)`</span>
  1448. <span class="doccomment">///</span>
  1449. <span class="doccomment">/// ```</span>
  1450. <span class="doccomment">/// use num_traits::real::Real;</span>
  1451. <span class="doccomment">/// use std::f64;</span>
  1452. <span class="doccomment">///</span>
  1453. <span class="doccomment">/// let pi = f64::consts::PI;</span>
  1454. <span class="doccomment">/// // All angles from horizontal right (+x)</span>
  1455. <span class="doccomment">/// // 45 deg counter-clockwise</span>
  1456. <span class="doccomment">/// let x1 = 3.0;</span>
  1457. <span class="doccomment">/// let y1 = -3.0;</span>
  1458. <span class="doccomment">///</span>
  1459. <span class="doccomment">/// // 135 deg clockwise</span>
  1460. <span class="doccomment">/// let x2 = -3.0;</span>
  1461. <span class="doccomment">/// let y2 = 3.0;</span>
  1462. <span class="doccomment">///</span>
  1463. <span class="doccomment">/// let abs_difference_1 = (y1.atan2(x1) - (-pi/4.0)).abs();</span>
  1464. <span class="doccomment">/// let abs_difference_2 = (y2.atan2(x2) - 3.0*pi/4.0).abs();</span>
  1465. <span class="doccomment">///</span>
  1466. <span class="doccomment">/// assert!(abs_difference_1 &lt; 1e-10);</span>
  1467. <span class="doccomment">/// assert!(abs_difference_2 &lt; 1e-10);</span>
  1468. <span class="doccomment">/// ```</span>
  1469. <span class="kw">fn</span> <span class="ident">atan2</span>(<span class="self">self</span>, <span class="ident">other</span>: <span class="self">Self</span>) <span class="op">-&gt;</span> <span class="self">Self</span>;
  1470. <span class="doccomment">/// Simultaneously computes the sine and cosine of the number, `x`. Returns</span>
  1471. <span class="doccomment">/// `(sin(x), cos(x))`.</span>
  1472. <span class="doccomment">///</span>
  1473. <span class="doccomment">/// ```</span>
  1474. <span class="doccomment">/// use num_traits::real::Real;</span>
  1475. <span class="doccomment">/// use std::f64;</span>
  1476. <span class="doccomment">///</span>
  1477. <span class="doccomment">/// let x = f64::consts::PI/4.0;</span>
  1478. <span class="doccomment">/// let f = x.sin_cos();</span>
  1479. <span class="doccomment">///</span>
  1480. <span class="doccomment">/// let abs_difference_0 = (f.0 - x.sin()).abs();</span>
  1481. <span class="doccomment">/// let abs_difference_1 = (f.1 - x.cos()).abs();</span>
  1482. <span class="doccomment">///</span>
  1483. <span class="doccomment">/// assert!(abs_difference_0 &lt; 1e-10);</span>
  1484. <span class="doccomment">/// assert!(abs_difference_0 &lt; 1e-10);</span>
  1485. <span class="doccomment">/// ```</span>
  1486. <span class="kw">fn</span> <span class="ident">sin_cos</span>(<span class="self">self</span>) <span class="op">-&gt;</span> (<span class="self">Self</span>, <span class="self">Self</span>);
  1487. <span class="doccomment">/// Returns `e^(self) - 1` in a way that is accurate even if the</span>
  1488. <span class="doccomment">/// number is close to zero.</span>
  1489. <span class="doccomment">///</span>
  1490. <span class="doccomment">/// ```</span>
  1491. <span class="doccomment">/// use num_traits::real::Real;</span>
  1492. <span class="doccomment">///</span>
  1493. <span class="doccomment">/// let x = 7.0;</span>
  1494. <span class="doccomment">///</span>
  1495. <span class="doccomment">/// // e^(ln(7)) - 1</span>
  1496. <span class="doccomment">/// let abs_difference = (x.ln().exp_m1() - 6.0).abs();</span>
  1497. <span class="doccomment">///</span>
  1498. <span class="doccomment">/// assert!(abs_difference &lt; 1e-10);</span>
  1499. <span class="doccomment">/// ```</span>
  1500. <span class="kw">fn</span> <span class="ident">exp_m1</span>(<span class="self">self</span>) <span class="op">-&gt;</span> <span class="self">Self</span>;
  1501. <span class="doccomment">/// Returns `ln(1+n)` (natural logarithm) more accurately than if</span>
  1502. <span class="doccomment">/// the operations were performed separately.</span>
  1503. <span class="doccomment">///</span>
  1504. <span class="doccomment">/// # Panics</span>
  1505. <span class="doccomment">///</span>
  1506. <span class="doccomment">/// If this type does not support a NaN representation, this function should panic</span>
  1507. <span class="doccomment">/// if `self-1 &lt;= 0`.</span>
  1508. <span class="doccomment">///</span>
  1509. <span class="doccomment">/// ```</span>
  1510. <span class="doccomment">/// use num_traits::real::Real;</span>
  1511. <span class="doccomment">/// use std::f64;</span>
  1512. <span class="doccomment">///</span>
  1513. <span class="doccomment">/// let x = f64::consts::E - 1.0;</span>
  1514. <span class="doccomment">///</span>
  1515. <span class="doccomment">/// // ln(1 + (e - 1)) == ln(e) == 1</span>
  1516. <span class="doccomment">/// let abs_difference = (x.ln_1p() - 1.0).abs();</span>
  1517. <span class="doccomment">///</span>
  1518. <span class="doccomment">/// assert!(abs_difference &lt; 1e-10);</span>
  1519. <span class="doccomment">/// ```</span>
  1520. <span class="kw">fn</span> <span class="ident">ln_1p</span>(<span class="self">self</span>) <span class="op">-&gt;</span> <span class="self">Self</span>;
  1521. <span class="doccomment">/// Hyperbolic sine function.</span>
  1522. <span class="doccomment">///</span>
  1523. <span class="doccomment">/// ```</span>
  1524. <span class="doccomment">/// use num_traits::real::Real;</span>
  1525. <span class="doccomment">/// use std::f64;</span>
  1526. <span class="doccomment">///</span>
  1527. <span class="doccomment">/// let e = f64::consts::E;</span>
  1528. <span class="doccomment">/// let x = 1.0;</span>
  1529. <span class="doccomment">///</span>
  1530. <span class="doccomment">/// let f = x.sinh();</span>
  1531. <span class="doccomment">/// // Solving sinh() at 1 gives `(e^2-1)/(2e)`</span>
  1532. <span class="doccomment">/// let g = (e*e - 1.0)/(2.0*e);</span>
  1533. <span class="doccomment">/// let abs_difference = (f - g).abs();</span>
  1534. <span class="doccomment">///</span>
  1535. <span class="doccomment">/// assert!(abs_difference &lt; 1e-10);</span>
  1536. <span class="doccomment">/// ```</span>
  1537. <span class="kw">fn</span> <span class="ident">sinh</span>(<span class="self">self</span>) <span class="op">-&gt;</span> <span class="self">Self</span>;
  1538. <span class="doccomment">/// Hyperbolic cosine function.</span>
  1539. <span class="doccomment">///</span>
  1540. <span class="doccomment">/// ```</span>
  1541. <span class="doccomment">/// use num_traits::real::Real;</span>
  1542. <span class="doccomment">/// use std::f64;</span>
  1543. <span class="doccomment">///</span>
  1544. <span class="doccomment">/// let e = f64::consts::E;</span>
  1545. <span class="doccomment">/// let x = 1.0;</span>
  1546. <span class="doccomment">/// let f = x.cosh();</span>
  1547. <span class="doccomment">/// // Solving cosh() at 1 gives this result</span>
  1548. <span class="doccomment">/// let g = (e*e + 1.0)/(2.0*e);</span>
  1549. <span class="doccomment">/// let abs_difference = (f - g).abs();</span>
  1550. <span class="doccomment">///</span>
  1551. <span class="doccomment">/// // Same result</span>
  1552. <span class="doccomment">/// assert!(abs_difference &lt; 1.0e-10);</span>
  1553. <span class="doccomment">/// ```</span>
  1554. <span class="kw">fn</span> <span class="ident">cosh</span>(<span class="self">self</span>) <span class="op">-&gt;</span> <span class="self">Self</span>;
  1555. <span class="doccomment">/// Hyperbolic tangent function.</span>
  1556. <span class="doccomment">///</span>
  1557. <span class="doccomment">/// ```</span>
  1558. <span class="doccomment">/// use num_traits::real::Real;</span>
  1559. <span class="doccomment">/// use std::f64;</span>
  1560. <span class="doccomment">///</span>
  1561. <span class="doccomment">/// let e = f64::consts::E;</span>
  1562. <span class="doccomment">/// let x = 1.0;</span>
  1563. <span class="doccomment">///</span>
  1564. <span class="doccomment">/// let f = x.tanh();</span>
  1565. <span class="doccomment">/// // Solving tanh() at 1 gives `(1 - e^(-2))/(1 + e^(-2))`</span>
  1566. <span class="doccomment">/// let g = (1.0 - e.powi(-2))/(1.0 + e.powi(-2));</span>
  1567. <span class="doccomment">/// let abs_difference = (f - g).abs();</span>
  1568. <span class="doccomment">///</span>
  1569. <span class="doccomment">/// assert!(abs_difference &lt; 1.0e-10);</span>
  1570. <span class="doccomment">/// ```</span>
  1571. <span class="kw">fn</span> <span class="ident">tanh</span>(<span class="self">self</span>) <span class="op">-&gt;</span> <span class="self">Self</span>;
  1572. <span class="doccomment">/// Inverse hyperbolic sine function.</span>
  1573. <span class="doccomment">///</span>
  1574. <span class="doccomment">/// ```</span>
  1575. <span class="doccomment">/// use num_traits::real::Real;</span>
  1576. <span class="doccomment">///</span>
  1577. <span class="doccomment">/// let x = 1.0;</span>
  1578. <span class="doccomment">/// let f = x.sinh().asinh();</span>
  1579. <span class="doccomment">///</span>
  1580. <span class="doccomment">/// let abs_difference = (f - x).abs();</span>
  1581. <span class="doccomment">///</span>
  1582. <span class="doccomment">/// assert!(abs_difference &lt; 1.0e-10);</span>
  1583. <span class="doccomment">/// ```</span>
  1584. <span class="kw">fn</span> <span class="ident">asinh</span>(<span class="self">self</span>) <span class="op">-&gt;</span> <span class="self">Self</span>;
  1585. <span class="doccomment">/// Inverse hyperbolic cosine function.</span>
  1586. <span class="doccomment">///</span>
  1587. <span class="doccomment">/// ```</span>
  1588. <span class="doccomment">/// use num_traits::real::Real;</span>
  1589. <span class="doccomment">///</span>
  1590. <span class="doccomment">/// let x = 1.0;</span>
  1591. <span class="doccomment">/// let f = x.cosh().acosh();</span>
  1592. <span class="doccomment">///</span>
  1593. <span class="doccomment">/// let abs_difference = (f - x).abs();</span>
  1594. <span class="doccomment">///</span>
  1595. <span class="doccomment">/// assert!(abs_difference &lt; 1.0e-10);</span>
  1596. <span class="doccomment">/// ```</span>
  1597. <span class="kw">fn</span> <span class="ident">acosh</span>(<span class="self">self</span>) <span class="op">-&gt;</span> <span class="self">Self</span>;
  1598. <span class="doccomment">/// Inverse hyperbolic tangent function.</span>
  1599. <span class="doccomment">///</span>
  1600. <span class="doccomment">/// ```</span>
  1601. <span class="doccomment">/// use num_traits::real::Real;</span>
  1602. <span class="doccomment">/// use std::f64;</span>
  1603. <span class="doccomment">///</span>
  1604. <span class="doccomment">/// let e = f64::consts::E;</span>
  1605. <span class="doccomment">/// let f = e.tanh().atanh();</span>
  1606. <span class="doccomment">///</span>
  1607. <span class="doccomment">/// let abs_difference = (f - e).abs();</span>
  1608. <span class="doccomment">///</span>
  1609. <span class="doccomment">/// assert!(abs_difference &lt; 1.0e-10);</span>
  1610. <span class="doccomment">/// ```</span>
  1611. <span class="kw">fn</span> <span class="ident">atanh</span>(<span class="self">self</span>) <span class="op">-&gt;</span> <span class="self">Self</span>;
  1612. }
  1613. <span class="kw">impl</span><span class="op">&lt;</span><span class="ident">T</span>: <span class="ident">Float</span><span class="op">&gt;</span> <span class="ident">Real</span> <span class="kw">for</span> <span class="ident">T</span> {
  1614. <span class="macro">forward</span><span class="macro">!</span> {
  1615. <span class="ident">Float</span>::<span class="ident">min_value</span>() <span class="op">-&gt;</span> <span class="self">Self</span>;
  1616. <span class="ident">Float</span>::<span class="ident">min_positive_value</span>() <span class="op">-&gt;</span> <span class="self">Self</span>;
  1617. <span class="ident">Float</span>::<span class="ident">epsilon</span>() <span class="op">-&gt;</span> <span class="self">Self</span>;
  1618. <span class="ident">Float</span>::<span class="ident">max_value</span>() <span class="op">-&gt;</span> <span class="self">Self</span>;
  1619. }
  1620. <span class="macro">forward</span><span class="macro">!</span> {
  1621. <span class="ident">Float</span>::<span class="ident">floor</span>(<span class="self">self</span>) <span class="op">-&gt;</span> <span class="self">Self</span>;
  1622. <span class="ident">Float</span>::<span class="ident">ceil</span>(<span class="self">self</span>) <span class="op">-&gt;</span> <span class="self">Self</span>;
  1623. <span class="ident">Float</span>::<span class="ident">round</span>(<span class="self">self</span>) <span class="op">-&gt;</span> <span class="self">Self</span>;
  1624. <span class="ident">Float</span>::<span class="ident">trunc</span>(<span class="self">self</span>) <span class="op">-&gt;</span> <span class="self">Self</span>;
  1625. <span class="ident">Float</span>::<span class="ident">fract</span>(<span class="self">self</span>) <span class="op">-&gt;</span> <span class="self">Self</span>;
  1626. <span class="ident">Float</span>::<span class="ident">abs</span>(<span class="self">self</span>) <span class="op">-&gt;</span> <span class="self">Self</span>;
  1627. <span class="ident">Float</span>::<span class="ident">signum</span>(<span class="self">self</span>) <span class="op">-&gt;</span> <span class="self">Self</span>;
  1628. <span class="ident">Float</span>::<span class="ident">is_sign_positive</span>(<span class="self">self</span>) <span class="op">-&gt;</span> <span class="ident">bool</span>;
  1629. <span class="ident">Float</span>::<span class="ident">is_sign_negative</span>(<span class="self">self</span>) <span class="op">-&gt;</span> <span class="ident">bool</span>;
  1630. <span class="ident">Float</span>::<span class="ident">mul_add</span>(<span class="self">self</span>, <span class="ident">a</span>: <span class="self">Self</span>, <span class="ident">b</span>: <span class="self">Self</span>) <span class="op">-&gt;</span> <span class="self">Self</span>;
  1631. <span class="ident">Float</span>::<span class="ident">recip</span>(<span class="self">self</span>) <span class="op">-&gt;</span> <span class="self">Self</span>;
  1632. <span class="ident">Float</span>::<span class="ident">powi</span>(<span class="self">self</span>, <span class="ident">n</span>: <span class="ident">i32</span>) <span class="op">-&gt;</span> <span class="self">Self</span>;
  1633. <span class="ident">Float</span>::<span class="ident">powf</span>(<span class="self">self</span>, <span class="ident">n</span>: <span class="self">Self</span>) <span class="op">-&gt;</span> <span class="self">Self</span>;
  1634. <span class="ident">Float</span>::<span class="ident">sqrt</span>(<span class="self">self</span>) <span class="op">-&gt;</span> <span class="self">Self</span>;
  1635. <span class="ident">Float</span>::<span class="ident">exp</span>(<span class="self">self</span>) <span class="op">-&gt;</span> <span class="self">Self</span>;
  1636. <span class="ident">Float</span>::<span class="ident">exp2</span>(<span class="self">self</span>) <span class="op">-&gt;</span> <span class="self">Self</span>;
  1637. <span class="ident">Float</span>::<span class="ident">ln</span>(<span class="self">self</span>) <span class="op">-&gt;</span> <span class="self">Self</span>;
  1638. <span class="ident">Float</span>::<span class="ident">log</span>(<span class="self">self</span>, <span class="ident">base</span>: <span class="self">Self</span>) <span class="op">-&gt;</span> <span class="self">Self</span>;
  1639. <span class="ident">Float</span>::<span class="ident">log2</span>(<span class="self">self</span>) <span class="op">-&gt;</span> <span class="self">Self</span>;
  1640. <span class="ident">Float</span>::<span class="ident">log10</span>(<span class="self">self</span>) <span class="op">-&gt;</span> <span class="self">Self</span>;
  1641. <span class="ident">Float</span>::<span class="ident">to_degrees</span>(<span class="self">self</span>) <span class="op">-&gt;</span> <span class="self">Self</span>;
  1642. <span class="ident">Float</span>::<span class="ident">to_radians</span>(<span class="self">self</span>) <span class="op">-&gt;</span> <span class="self">Self</span>;
  1643. <span class="ident">Float</span>::<span class="ident">max</span>(<span class="self">self</span>, <span class="ident">other</span>: <span class="self">Self</span>) <span class="op">-&gt;</span> <span class="self">Self</span>;
  1644. <span class="ident">Float</span>::<span class="ident">min</span>(<span class="self">self</span>, <span class="ident">other</span>: <span class="self">Self</span>) <span class="op">-&gt;</span> <span class="self">Self</span>;
  1645. <span class="ident">Float</span>::<span class="ident">abs_sub</span>(<span class="self">self</span>, <span class="ident">other</span>: <span class="self">Self</span>) <span class="op">-&gt;</span> <span class="self">Self</span>;
  1646. <span class="ident">Float</span>::<span class="ident">cbrt</span>(<span class="self">self</span>) <span class="op">-&gt;</span> <span class="self">Self</span>;
  1647. <span class="ident">Float</span>::<span class="ident">hypot</span>(<span class="self">self</span>, <span class="ident">other</span>: <span class="self">Self</span>) <span class="op">-&gt;</span> <span class="self">Self</span>;
  1648. <span class="ident">Float</span>::<span class="ident">sin</span>(<span class="self">self</span>) <span class="op">-&gt;</span> <span class="self">Self</span>;
  1649. <span class="ident">Float</span>::<span class="ident">cos</span>(<span class="self">self</span>) <span class="op">-&gt;</span> <span class="self">Self</span>;
  1650. <span class="ident">Float</span>::<span class="ident">tan</span>(<span class="self">self</span>) <span class="op">-&gt;</span> <span class="self">Self</span>;
  1651. <span class="ident">Float</span>::<span class="ident">asin</span>(<span class="self">self</span>) <span class="op">-&gt;</span> <span class="self">Self</span>;
  1652. <span class="ident">Float</span>::<span class="ident">acos</span>(<span class="self">self</span>) <span class="op">-&gt;</span> <span class="self">Self</span>;
  1653. <span class="ident">Float</span>::<span class="ident">atan</span>(<span class="self">self</span>) <span class="op">-&gt;</span> <span class="self">Self</span>;
  1654. <span class="ident">Float</span>::<span class="ident">atan2</span>(<span class="self">self</span>, <span class="ident">other</span>: <span class="self">Self</span>) <span class="op">-&gt;</span> <span class="self">Self</span>;
  1655. <span class="ident">Float</span>::<span class="ident">sin_cos</span>(<span class="self">self</span>) <span class="op">-&gt;</span> (<span class="self">Self</span>, <span class="self">Self</span>);
  1656. <span class="ident">Float</span>::<span class="ident">exp_m1</span>(<span class="self">self</span>) <span class="op">-&gt;</span> <span class="self">Self</span>;
  1657. <span class="ident">Float</span>::<span class="ident">ln_1p</span>(<span class="self">self</span>) <span class="op">-&gt;</span> <span class="self">Self</span>;
  1658. <span class="ident">Float</span>::<span class="ident">sinh</span>(<span class="self">self</span>) <span class="op">-&gt;</span> <span class="self">Self</span>;
  1659. <span class="ident">Float</span>::<span class="ident">cosh</span>(<span class="self">self</span>) <span class="op">-&gt;</span> <span class="self">Self</span>;
  1660. <span class="ident">Float</span>::<span class="ident">tanh</span>(<span class="self">self</span>) <span class="op">-&gt;</span> <span class="self">Self</span>;
  1661. <span class="ident">Float</span>::<span class="ident">asinh</span>(<span class="self">self</span>) <span class="op">-&gt;</span> <span class="self">Self</span>;
  1662. <span class="ident">Float</span>::<span class="ident">acosh</span>(<span class="self">self</span>) <span class="op">-&gt;</span> <span class="self">Self</span>;
  1663. <span class="ident">Float</span>::<span class="ident">atanh</span>(<span class="self">self</span>) <span class="op">-&gt;</span> <span class="self">Self</span>;
  1664. }
  1665. }
  1666. </pre>
  1667. </section>
  1668. <section id='search' class="content hidden"></section>
  1669. <section class="footer"></section>
  1670. <aside id="help" class="hidden">
  1671. <div>
  1672. <h1 class="hidden">Help</h1>
  1673. <div class="shortcuts">
  1674. <h2>Keyboard Shortcuts</h2>
  1675. <dl>
  1676. <dt><kbd>?</kbd></dt>
  1677. <dd>Show this help dialog</dd>
  1678. <dt><kbd>S</kbd></dt>
  1679. <dd>Focus the search field</dd>
  1680. <dt><kbd>↑</kbd></dt>
  1681. <dd>Move up in search results</dd>
  1682. <dt><kbd>↓</kbd></dt>
  1683. <dd>Move down in search results</dd>
  1684. <dt><kbd>↹</kbd></dt>
  1685. <dd>Switch tab</dd>
  1686. <dt><kbd>&#9166;</kbd></dt>
  1687. <dd>Go to active search result</dd>
  1688. <dt><kbd>+</kbd></dt>
  1689. <dd>Expand all sections</dd>
  1690. <dt><kbd>-</kbd></dt>
  1691. <dd>Collapse all sections</dd>
  1692. </dl>
  1693. </div>
  1694. <div class="infos">
  1695. <h2>Search Tricks</h2>
  1696. <p>
  1697. Prefix searches with a type followed by a colon (e.g.
  1698. <code>fn:</code>) to restrict the search to a given type.
  1699. </p>
  1700. <p>
  1701. Accepted types are: <code>fn</code>, <code>mod</code>,
  1702. <code>struct</code>, <code>enum</code>,
  1703. <code>trait</code>, <code>type</code>, <code>macro</code>,
  1704. and <code>const</code>.
  1705. </p>
  1706. <p>
  1707. Search functions by type signature (e.g.
  1708. <code>vec -> usize</code> or <code>* -> vec</code>)
  1709. </p>
  1710. </div>
  1711. </div>
  1712. </aside>
  1713. <script>
  1714. window.rootPath = "../../";
  1715. window.currentCrate = "num_traits";
  1716. </script>
  1717. <script src="../../main.js"></script>
  1718. <script defer src="../../search-index.js"></script>
  1719. </body>
  1720. </html>