trait.CheckedDiv.html 22 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173
  1. <!DOCTYPE html>
  2. <html lang="en">
  3. <head>
  4. <meta charset="utf-8">
  5. <meta name="viewport" content="width=device-width, initial-scale=1.0">
  6. <meta name="generator" content="rustdoc">
  7. <meta name="description" content="API documentation for the Rust `CheckedDiv` trait in crate `num`.">
  8. <meta name="keywords" content="rust, rustlang, rust-lang, CheckedDiv">
  9. <title>num::CheckedDiv - Rust</title>
  10. <link rel="stylesheet" type="text/css" href="../normalize.css">
  11. <link rel="stylesheet" type="text/css" href="../rustdoc.css" id="mainThemeStyle">
  12. <link rel="stylesheet" type="text/css" href="../dark.css">
  13. <link rel="stylesheet" type="text/css" href="../main.css" id="themeStyle">
  14. <script src="../storage.js"></script>
  15. </head>
  16. <body class="rustdoc trait">
  17. <!--[if lte IE 8]>
  18. <div class="warning">
  19. This old browser is unsupported and will most likely display funky
  20. things.
  21. </div>
  22. <![endif]-->
  23. <nav class="sidebar">
  24. <div class="sidebar-menu">&#9776;</div>
  25. <p class='location'>Trait CheckedDiv</p><div class="sidebar-elems"><div class="block items"><a class="sidebar-title" href="#required-methods">Required Methods</a><div class="sidebar-links"><a href="#tymethod.checked_div">checked_div</a></div><a class="sidebar-title" href="#foreign-impls">Implementations on Foreign Types</a><div class="sidebar-links"><a href="#impl-CheckedDiv">i32</a><a href="#impl-CheckedDiv">u16</a><a href="#impl-CheckedDiv">u32</a><a href="#impl-CheckedDiv">i16</a><a href="#impl-CheckedDiv">i64</a><a href="#impl-CheckedDiv">isize</a><a href="#impl-CheckedDiv">u64</a><a href="#impl-CheckedDiv">i8</a><a href="#impl-CheckedDiv">usize</a><a href="#impl-CheckedDiv">u8</a><a href="#impl-CheckedDiv">Ratio&lt;T&gt;</a></div><a class="sidebar-title" href="#implementors">Implementors</a></div><p class='location'><a href='index.html'>num</a></p><script>window.sidebarCurrent = {name: 'CheckedDiv', ty: 'trait', relpath: ''};</script><script defer src="sidebar-items.js"></script></div>
  26. </nav>
  27. <div class="theme-picker">
  28. <button id="theme-picker" aria-label="Pick another theme!">
  29. <img src="../brush.svg" width="18" alt="Pick another theme!">
  30. </button>
  31. <div id="theme-choices"></div>
  32. </div>
  33. <script src="../theme.js"></script>
  34. <nav class="sub">
  35. <form class="search-form js-only">
  36. <div class="search-container">
  37. <input class="search-input" name="search"
  38. autocomplete="off"
  39. placeholder="Click or press ‘S’ to search, ‘?’ for more options…"
  40. type="search">
  41. </div>
  42. </form>
  43. </nav>
  44. <section id='main' class="content">
  45. <h1 class='fqn'><span class='in-band'>Trait <a href='index.html'>num</a>::<wbr><a class="trait" href=''>CheckedDiv</a></span><span class='out-of-band'><span id='render-detail'>
  46. <a id="toggle-all-docs" href="javascript:void(0)" title="collapse all docs">
  47. [<span class='inner'>&#x2212;</span>]
  48. </a>
  49. </span><a class='srclink' href='../src/num_traits/ops/checked.rs.html#75-79' title='goto source code'>[src]</a></span></h1>
  50. <pre class='rust trait'>pub trait CheckedDiv: <a class="trait" href="https://doc.rust-lang.org/nightly/core/ops/arith/trait.Div.html" title="trait core::ops::arith::Div">Div</a>&lt;Self, Output = Self&gt; {
  51. fn <a href='#tymethod.checked_div' class='fnname'>checked_div</a>(&amp;self, v: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.reference.html">&amp;</a>Self) -&gt; <a class="enum" href="https://doc.rust-lang.org/nightly/core/option/enum.Option.html" title="enum core::option::Option">Option</a>&lt;Self&gt;;
  52. }</pre><div class='docblock'><p>Performs division that returns <code>None</code> instead of panicking on division by zero and instead of
  53. wrapping around on underflow and overflow.</p>
  54. </div>
  55. <h2 id='required-methods' class='small-section-header'>
  56. Required Methods<a href='#required-methods' class='anchor'></a>
  57. </h2>
  58. <div class='methods'>
  59. <h3 id='tymethod.checked_div' class='method'><span id='checked_div.v' class='invisible'><code>fn <a href='#tymethod.checked_div' class='fnname'>checked_div</a>(&amp;self, v: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.reference.html">&amp;</a>Self) -&gt; <a class="enum" href="https://doc.rust-lang.org/nightly/core/option/enum.Option.html" title="enum core::option::Option">Option</a>&lt;Self&gt;</code></span></h3><div class='docblock'><p>Divides two numbers, checking for underflow, overflow and division by
  60. zero. If any of that happens, <code>None</code> is returned.</p>
  61. </div></div>
  62. <h2 id='foreign-impls' class='small-section-header'>
  63. Implementations on Foreign Types<a href='#foreign-impls' class='anchor'></a>
  64. </h2>
  65. <h3 id='impl-CheckedDiv' class='impl'><span class='in-band'><code>impl <a class="trait" href="../num/trait.CheckedDiv.html" title="trait num::CheckedDiv">CheckedDiv</a> for <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.i32.html">i32</a></code><a href='#impl-CheckedDiv' class='anchor'></a></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/ops/checked.rs.html#13-18' title='goto source code'>[src]</a></span></h3>
  66. <span class='docblock autohide'><div class='impl-items'><h4 id='method.checked_div' class="method"><span id='checked_div.v-1' class='invisible'><code>fn <a href='#method.checked_div' class='fnname'>checked_div</a>(&amp;self, v: &amp;<a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.i32.html">i32</a>) -&gt; <a class="enum" href="https://doc.rust-lang.org/nightly/core/option/enum.Option.html" title="enum core::option::Option">Option</a>&lt;<a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.i32.html">i32</a>&gt;</code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/ops/checked.rs.html#15-17' title='goto source code'>[src]</a></span></h4>
  67. </div></span><h3 id='impl-CheckedDiv-1' class='impl'><span class='in-band'><code>impl <a class="trait" href="../num/trait.CheckedDiv.html" title="trait num::CheckedDiv">CheckedDiv</a> for <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u16.html">u16</a></code><a href='#impl-CheckedDiv-1' class='anchor'></a></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/ops/checked.rs.html#13-18' title='goto source code'>[src]</a></span></h3>
  68. <span class='docblock autohide'><div class='impl-items'><h4 id='method.checked_div-1' class="method"><span id='checked_div.v-2' class='invisible'><code>fn <a href='#method.checked_div' class='fnname'>checked_div</a>(&amp;self, v: &amp;<a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u16.html">u16</a>) -&gt; <a class="enum" href="https://doc.rust-lang.org/nightly/core/option/enum.Option.html" title="enum core::option::Option">Option</a>&lt;<a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u16.html">u16</a>&gt;</code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/ops/checked.rs.html#15-17' title='goto source code'>[src]</a></span></h4>
  69. </div></span><h3 id='impl-CheckedDiv-2' class='impl'><span class='in-band'><code>impl <a class="trait" href="../num/trait.CheckedDiv.html" title="trait num::CheckedDiv">CheckedDiv</a> for <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a></code><a href='#impl-CheckedDiv-2' class='anchor'></a></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/ops/checked.rs.html#13-18' title='goto source code'>[src]</a></span></h3>
  70. <span class='docblock autohide'><div class='impl-items'><h4 id='method.checked_div-2' class="method"><span id='checked_div.v-3' class='invisible'><code>fn <a href='#method.checked_div' class='fnname'>checked_div</a>(&amp;self, v: &amp;<a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a>) -&gt; <a class="enum" href="https://doc.rust-lang.org/nightly/core/option/enum.Option.html" title="enum core::option::Option">Option</a>&lt;<a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a>&gt;</code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/ops/checked.rs.html#15-17' title='goto source code'>[src]</a></span></h4>
  71. </div></span><h3 id='impl-CheckedDiv-3' class='impl'><span class='in-band'><code>impl <a class="trait" href="../num/trait.CheckedDiv.html" title="trait num::CheckedDiv">CheckedDiv</a> for <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.i16.html">i16</a></code><a href='#impl-CheckedDiv-3' class='anchor'></a></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/ops/checked.rs.html#13-18' title='goto source code'>[src]</a></span></h3>
  72. <span class='docblock autohide'><div class='impl-items'><h4 id='method.checked_div-3' class="method"><span id='checked_div.v-4' class='invisible'><code>fn <a href='#method.checked_div' class='fnname'>checked_div</a>(&amp;self, v: &amp;<a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.i16.html">i16</a>) -&gt; <a class="enum" href="https://doc.rust-lang.org/nightly/core/option/enum.Option.html" title="enum core::option::Option">Option</a>&lt;<a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.i16.html">i16</a>&gt;</code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/ops/checked.rs.html#15-17' title='goto source code'>[src]</a></span></h4>
  73. </div></span><h3 id='impl-CheckedDiv-4' class='impl'><span class='in-band'><code>impl <a class="trait" href="../num/trait.CheckedDiv.html" title="trait num::CheckedDiv">CheckedDiv</a> for <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.i64.html">i64</a></code><a href='#impl-CheckedDiv-4' class='anchor'></a></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/ops/checked.rs.html#13-18' title='goto source code'>[src]</a></span></h3>
  74. <span class='docblock autohide'><div class='impl-items'><h4 id='method.checked_div-4' class="method"><span id='checked_div.v-5' class='invisible'><code>fn <a href='#method.checked_div' class='fnname'>checked_div</a>(&amp;self, v: &amp;<a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.i64.html">i64</a>) -&gt; <a class="enum" href="https://doc.rust-lang.org/nightly/core/option/enum.Option.html" title="enum core::option::Option">Option</a>&lt;<a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.i64.html">i64</a>&gt;</code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/ops/checked.rs.html#15-17' title='goto source code'>[src]</a></span></h4>
  75. </div></span><h3 id='impl-CheckedDiv-5' class='impl'><span class='in-band'><code>impl <a class="trait" href="../num/trait.CheckedDiv.html" title="trait num::CheckedDiv">CheckedDiv</a> for <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.isize.html">isize</a></code><a href='#impl-CheckedDiv-5' class='anchor'></a></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/ops/checked.rs.html#13-18' title='goto source code'>[src]</a></span></h3>
  76. <span class='docblock autohide'><div class='impl-items'><h4 id='method.checked_div-5' class="method"><span id='checked_div.v-6' class='invisible'><code>fn <a href='#method.checked_div' class='fnname'>checked_div</a>(&amp;self, v: &amp;<a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.isize.html">isize</a>) -&gt; <a class="enum" href="https://doc.rust-lang.org/nightly/core/option/enum.Option.html" title="enum core::option::Option">Option</a>&lt;<a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.isize.html">isize</a>&gt;</code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/ops/checked.rs.html#15-17' title='goto source code'>[src]</a></span></h4>
  77. </div></span><h3 id='impl-CheckedDiv-6' class='impl'><span class='in-band'><code>impl <a class="trait" href="../num/trait.CheckedDiv.html" title="trait num::CheckedDiv">CheckedDiv</a> for <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u64.html">u64</a></code><a href='#impl-CheckedDiv-6' class='anchor'></a></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/ops/checked.rs.html#13-18' title='goto source code'>[src]</a></span></h3>
  78. <span class='docblock autohide'><div class='impl-items'><h4 id='method.checked_div-6' class="method"><span id='checked_div.v-7' class='invisible'><code>fn <a href='#method.checked_div' class='fnname'>checked_div</a>(&amp;self, v: &amp;<a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u64.html">u64</a>) -&gt; <a class="enum" href="https://doc.rust-lang.org/nightly/core/option/enum.Option.html" title="enum core::option::Option">Option</a>&lt;<a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u64.html">u64</a>&gt;</code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/ops/checked.rs.html#15-17' title='goto source code'>[src]</a></span></h4>
  79. </div></span><h3 id='impl-CheckedDiv-7' class='impl'><span class='in-band'><code>impl <a class="trait" href="../num/trait.CheckedDiv.html" title="trait num::CheckedDiv">CheckedDiv</a> for <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.i8.html">i8</a></code><a href='#impl-CheckedDiv-7' class='anchor'></a></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/ops/checked.rs.html#13-18' title='goto source code'>[src]</a></span></h3>
  80. <span class='docblock autohide'><div class='impl-items'><h4 id='method.checked_div-7' class="method"><span id='checked_div.v-8' class='invisible'><code>fn <a href='#method.checked_div' class='fnname'>checked_div</a>(&amp;self, v: &amp;<a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.i8.html">i8</a>) -&gt; <a class="enum" href="https://doc.rust-lang.org/nightly/core/option/enum.Option.html" title="enum core::option::Option">Option</a>&lt;<a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.i8.html">i8</a>&gt;</code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/ops/checked.rs.html#15-17' title='goto source code'>[src]</a></span></h4>
  81. </div></span><h3 id='impl-CheckedDiv-8' class='impl'><span class='in-band'><code>impl <a class="trait" href="../num/trait.CheckedDiv.html" title="trait num::CheckedDiv">CheckedDiv</a> for <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.usize.html">usize</a></code><a href='#impl-CheckedDiv-8' class='anchor'></a></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/ops/checked.rs.html#13-18' title='goto source code'>[src]</a></span></h3>
  82. <span class='docblock autohide'><div class='impl-items'><h4 id='method.checked_div-8' class="method"><span id='checked_div.v-9' class='invisible'><code>fn <a href='#method.checked_div' class='fnname'>checked_div</a>(&amp;self, v: &amp;<a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.usize.html">usize</a>) -&gt; <a class="enum" href="https://doc.rust-lang.org/nightly/core/option/enum.Option.html" title="enum core::option::Option">Option</a>&lt;<a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.usize.html">usize</a>&gt;</code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/ops/checked.rs.html#15-17' title='goto source code'>[src]</a></span></h4>
  83. </div></span><h3 id='impl-CheckedDiv-9' class='impl'><span class='in-band'><code>impl <a class="trait" href="../num/trait.CheckedDiv.html" title="trait num::CheckedDiv">CheckedDiv</a> for <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u8.html">u8</a></code><a href='#impl-CheckedDiv-9' class='anchor'></a></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/ops/checked.rs.html#13-18' title='goto source code'>[src]</a></span></h3>
  84. <span class='docblock autohide'><div class='impl-items'><h4 id='method.checked_div-9' class="method"><span id='checked_div.v-10' class='invisible'><code>fn <a href='#method.checked_div' class='fnname'>checked_div</a>(&amp;self, v: &amp;<a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u8.html">u8</a>) -&gt; <a class="enum" href="https://doc.rust-lang.org/nightly/core/option/enum.Option.html" title="enum core::option::Option">Option</a>&lt;<a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u8.html">u8</a>&gt;</code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_traits/ops/checked.rs.html#15-17' title='goto source code'>[src]</a></span></h4>
  85. </div></span><h3 id='impl-CheckedDiv-10' class='impl'><span class='in-band'><code>impl&lt;T&gt; <a class="trait" href="../num/trait.CheckedDiv.html" title="trait num::CheckedDiv">CheckedDiv</a> for <a class="struct" href="../num_rational/struct.Ratio.html" title="struct num_rational::Ratio">Ratio</a>&lt;T&gt; <span class="where fmt-newline">where<br>&nbsp;&nbsp;&nbsp;&nbsp;T: <a class="trait" href="https://doc.rust-lang.org/nightly/core/clone/trait.Clone.html" title="trait core::clone::Clone">Clone</a> + <a class="trait" href="../num/trait.Integer.html" title="trait num::Integer">Integer</a> + <a class="trait" href="../num/trait.CheckedMul.html" title="trait num::CheckedMul">CheckedMul</a>,&nbsp;</span></code><a href='#impl-CheckedDiv-10' class='anchor'></a></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_rational/lib.rs.html#661-673' title='goto source code'>[src]</a></span></h3>
  86. <span class='docblock autohide'><div class='impl-items'><h4 id='method.checked_div-10' class="method"><span id='checked_div.v-11' class='invisible'><code>fn <a href='#method.checked_div' class='fnname'>checked_div</a>(&amp;self, rhs: &amp;<a class="struct" href="../num_rational/struct.Ratio.html" title="struct num_rational::Ratio">Ratio</a>&lt;T&gt;) -&gt; <a class="enum" href="https://doc.rust-lang.org/nightly/core/option/enum.Option.html" title="enum core::option::Option">Option</a>&lt;<a class="struct" href="../num_rational/struct.Ratio.html" title="struct num_rational::Ratio">Ratio</a>&lt;T&gt;&gt;</code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/num_rational/lib.rs.html#665-672' title='goto source code'>[src]</a></span></h4>
  87. </div></span>
  88. <h2 id='implementors' class='small-section-header'>
  89. Implementors<a href='#implementors' class='anchor'></a>
  90. </h2>
  91. <ul class='item-list' id='implementors-list'>
  92. <li><div class='out-of-band'><a class='srclink' href='../src/num_bigint/biguint.rs.html#909-917' title='goto source code'>[src]</a></div><code>impl CheckedDiv for <a class="struct" href="../num/struct.BigUint.html" title="struct num::BigUint">BigUint</a></code></li>
  93. <li><div class='out-of-band'><a class='srclink' href='../src/num_bigint/bigint.rs.html#950-958' title='goto source code'>[src]</a></div><code>impl CheckedDiv for <a class="struct" href="../num/struct.BigInt.html" title="struct num::BigInt">BigInt</a></code></li>
  94. </ul><script type="text/javascript" async
  95. src="../implementors/num_traits/ops/checked/trait.CheckedDiv.js">
  96. </script></section>
  97. <section id='search' class="content hidden"></section>
  98. <section class="footer"></section>
  99. <aside id="help" class="hidden">
  100. <div>
  101. <h1 class="hidden">Help</h1>
  102. <div class="shortcuts">
  103. <h2>Keyboard Shortcuts</h2>
  104. <dl>
  105. <dt><kbd>?</kbd></dt>
  106. <dd>Show this help dialog</dd>
  107. <dt><kbd>S</kbd></dt>
  108. <dd>Focus the search field</dd>
  109. <dt><kbd>↑</kbd></dt>
  110. <dd>Move up in search results</dd>
  111. <dt><kbd>↓</kbd></dt>
  112. <dd>Move down in search results</dd>
  113. <dt><kbd>↹</kbd></dt>
  114. <dd>Switch tab</dd>
  115. <dt><kbd>&#9166;</kbd></dt>
  116. <dd>Go to active search result</dd>
  117. <dt><kbd>+</kbd></dt>
  118. <dd>Expand all sections</dd>
  119. <dt><kbd>-</kbd></dt>
  120. <dd>Collapse all sections</dd>
  121. </dl>
  122. </div>
  123. <div class="infos">
  124. <h2>Search Tricks</h2>
  125. <p>
  126. Prefix searches with a type followed by a colon (e.g.
  127. <code>fn:</code>) to restrict the search to a given type.
  128. </p>
  129. <p>
  130. Accepted types are: <code>fn</code>, <code>mod</code>,
  131. <code>struct</code>, <code>enum</code>,
  132. <code>trait</code>, <code>type</code>, <code>macro</code>,
  133. and <code>const</code>.
  134. </p>
  135. <p>
  136. Search functions by type signature (e.g.
  137. <code>vec -> usize</code> or <code>* -> vec</code>)
  138. </p>
  139. </div>
  140. </div>
  141. </aside>
  142. <script>
  143. window.rootPath = "../";
  144. window.currentCrate = "num";
  145. </script>
  146. <script src="../main.js"></script>
  147. <script defer src="../search-index.js"></script>
  148. </body>
  149. </html>