summaryrefslogtreecommitdiff
path: root/devdocs/c/numeric%2Fmath%2Fdiv.html
diff options
context:
space:
mode:
authorCraig Jennings <c@cjennings.net>2025-08-14 22:58:58 -0500
committerCraig Jennings <c@cjennings.net>2025-08-14 22:58:58 -0500
commit82ba818ff456bcd6d56a06226e3f27e98fbb55c3 (patch)
tree158cfc17b2f644a10f063cb546752cfaae12c97f /devdocs/c/numeric%2Fmath%2Fdiv.html
parent9278ddd4ea1a8b1a4c1edaa8894516e3f48d245b (diff)
downloaddotemacs-82ba818ff456bcd6d56a06226e3f27e98fbb55c3.tar.gz
dotemacs-82ba818ff456bcd6d56a06226e3f27e98fbb55c3.zip
removing all downloaded devdocs files
Diffstat (limited to 'devdocs/c/numeric%2Fmath%2Fdiv.html')
-rw-r--r--devdocs/c/numeric%2Fmath%2Fdiv.html120
1 files changed, 0 insertions, 120 deletions
diff --git a/devdocs/c/numeric%2Fmath%2Fdiv.html b/devdocs/c/numeric%2Fmath%2Fdiv.html
deleted file mode 100644
index 529a3c32..00000000
--- a/devdocs/c/numeric%2Fmath%2Fdiv.html
+++ /dev/null
@@ -1,120 +0,0 @@
- <h1 id="firstHeading" class="firstHeading">div, ldiv, lldiv, imaxdiv</h1> <table class="t-dcl-begin"> <tr class="t-dsc-header"> <th> Defined in header <code>&lt;stdlib.h&gt;</code> </th> <th> </th> <th> </th> </tr> <tr class="t-dcl"> <td> <pre data-language="c">div_t div( int x, int y );</pre>
-</td> <td> (1) </td> <td class="t-dcl-nopad"> </td> </tr> <tr class="t-dcl"> <td> <pre data-language="c">ldiv_t ldiv( long x, long y );</pre>
-</td> <td> (2) </td> <td class="t-dcl-nopad"> </td> </tr> <tr class="t-dcl t-since-c99"> <td> <pre data-language="c">lldiv_t lldiv( long long x, long long y );</pre>
-</td> <td> (3) </td> <td> <span class="t-mark-rev t-since-c99">(since C99)</span> </td> </tr> <tr class="t-dsc-header"> <th> Defined in header <code>&lt;inttypes.h&gt;</code> </th> <th> </th> <th> </th> </tr> <tr class="t-dcl t-since-c99"> <td> <pre data-language="c">imaxdiv_t imaxdiv( intmax_t x, intmax_t y );</pre>
-</td> <td> (4) </td> <td> <span class="t-mark-rev t-since-c99">(since C99)</span> </td> </tr> </table> <p>Computes both the quotient and the remainder of the division of the numerator <code>x</code> by the denominator <code>y</code>.</p>
-<table class="t-rev-begin"> <tr class="t-rev t-until-c99">
-<td> <p>Computes quotient and remainder simultaneously. The quotient is the algebraic quotient with any fractional part discarded (truncated towards zero). The remainder is such that <code>quot * y + rem == x</code>.</p>
-</td> <td><span class="t-mark-rev t-until-c99">(until C99)</span></td>
-</tr> <tr class="t-rev t-since-c99">
-<td> <p>Computes the quotient (the result of the expression <code>x / y</code>) and remainder (the result of the expression <code>x % y</code>) simultaneously.</p>
-</td> <td><span class="t-mark-rev t-since-c99">(since C99)</span></td>
-</tr> </table> <h3 id="Parameters"> Parameters</h3> <table class="t-par-begin"> <tr class="t-par"> <td> x, y </td> <td> - </td> <td> integer values </td>
-</tr>
-</table> <h3 id="Return_value"> Return value</h3> <p>If both the remainder and the quotient can be represented as objects of the corresponding type (<code>int</code>, <code>long</code>, <code>long long</code>, <code><a href="http://en.cppreference.com/w/c/types/integer"><span class="kw118">intmax_t</span></a></code>, respectively), returns both as an object of type <code>div_t</code>, <code>ldiv_t</code>, <code>lldiv_t</code>, <code>imaxdiv_t</code> defined as follows:</p>
-<div class="t-member"> <h2 id="div_t"> div_t</h2> <div class="c source-c"><pre data-language="c">struct div_t { int quot; int rem; };</pre></div> <p>or</p>
-<div class="c source-c"><pre data-language="c">struct div_t { int rem; int quot; };</pre></div> </div> <div class="t-member"> <h2 id="ldiv_t"> ldiv_t</h2> <div class="c source-c"><pre data-language="c">struct ldiv_t { long quot; long rem; };</pre></div> <p>or</p>
-<div class="c source-c"><pre data-language="c">struct ldiv_t { long rem; long quot; };</pre></div> </div> <div class="t-member"> <h2 id="lldiv_t"> lldiv_t</h2> <div class="c source-c"><pre data-language="c">struct lldiv_t { long long quot; long long rem; };</pre></div> <p>or</p>
-<div class="c source-c"><pre data-language="c">struct lldiv_t { long long rem; long long quot; };</pre></div> </div> <div class="t-member"> <h2 id="imaxdiv_t"> imaxdiv_t</h2> <div class="c source-c"><pre data-language="c">struct imaxdiv_t { intmax_t quot; intmax_t rem; };</pre></div> <p>or</p>
-<div class="c source-c"><pre data-language="c">struct imaxdiv_t { intmax_t rem; intmax_t quot; };</pre></div> </div> <p>If either the remainder or the quotient cannot be represented, the behavior is undefined.</p>
-<h3 id="Notes"> Notes</h3> <p>Until C99, the rounding direction of the quotient and the sign of the remainder in the built-in division and remainder operators was implementation-defined if either of the operands was negative, but it was well-defined in <code>div</code> and <code>ldiv</code>.</p>
-<p>On many platforms, a single CPU instruction obtains both the quotient and the remainder, and this function may leverage that, although compilers are generally able to merge nearby <code>/</code> and <code>%</code> where suitable.</p>
-<h3 id="Example"> Example</h3> <div class="t-example"> <div class="c source-c"><pre data-language="c">#include &lt;assert.h&gt;
-#include &lt;limits.h&gt;
-#include &lt;math.h&gt;
-#include &lt;stdio.h&gt;
-#include &lt;stdlib.h&gt;
-
-void reverse(char* first, char* last)
-{
- for (--last; first &lt; last; ++first, --last)
- {
- char c = *last;
- *last = *first;
- *first = c;
- }
-}
-
-// returns empty buffer in case of buffer overflow
-char* itoa(int n, int base, char* buf, size_t buf_size)
-{
- assert(2 &lt;= base &amp;&amp; base &lt;= 16 &amp;&amp; buf &amp;&amp; buf_size);
- div_t dv = {.quot = n};
- char* p = buf;
- do
- {
- if (!--buf_size)
- return (*buf = '\0'), buf;
- dv = div(dv.quot, base);
- *p++ = "0123456789abcdef"[abs(dv.rem)];
- }
- while(dv.quot);
- if (n &lt; 0)
- *p++ = '-';
- *p = '\0';
- reverse(buf, p);
- return buf;
-}
-
-int main(void)
-{
- char buf[16];
- printf("%s\n", itoa(0, 2, buf, sizeof buf));
- printf("%s\n", itoa(007, 3, buf, sizeof buf));
- printf("%s\n", itoa(12346, 10, buf, sizeof buf));
- printf("%s\n", itoa(-12346, 10, buf, sizeof buf));
- printf("%s\n", itoa(-42, 2, buf, sizeof buf));
- printf("%s\n", itoa(INT_MAX, 16, buf, sizeof buf));
- printf("%s\n", itoa(INT_MIN, 16, buf, sizeof buf));
-}</pre></div> <p>Possible output:</p>
-<div class="text source-text"><pre data-language="c">0
-21
-12346
--12346
--101010
-7fffffff
--80000000</pre></div> </div> <h3 id="References"> References</h3> <ul>
-<li> C23 standard (ISO/IEC 9899:2023): </li>
-<ul>
-<li> 7.8.2.2 The imaxdiv function (p: TBD) </li>
-<li> 7.22.6.2 The div, ldiv and lldiv functions (p: TBD) </li>
-</ul>
-<li> C17 standard (ISO/IEC 9899:2018): </li>
-<ul>
-<li> 7.8.2.2 The imaxdiv function (p: 159) </li>
-<li> 7.22.6.2 The div, ldiv and lldiv functions (p: 259) </li>
-</ul>
-<li> C11 standard (ISO/IEC 9899:2011): </li>
-<ul>
-<li> 7.8.2.2 The imaxdiv function (p: 219) </li>
-<li> 7.22.6.2 The div, ldiv and lldiv functions (p: 356) </li>
-</ul>
-<li> C99 standard (ISO/IEC 9899:1999): </li>
-<ul>
-<li> 7.8.2.2 The imaxdiv function (p: 200) </li>
-<li> 7.20.6.2 The div, ldiv and lldiv functions (p: 320) </li>
-</ul>
-<li> C89/C90 standard (ISO/IEC 9899:1990): </li>
-<ul>
-<li> 4.10 div_t, ldiv_t </li>
-<li> 4.10.6.2 The div function </li>
-<li> 4.10.6.4 The ldiv function </li>
-</ul>
-</ul> <h3 id="See_also"> See also</h3> <table class="t-dsc-begin"> <tr class="t-dsc"> <td> <div><a href="fmod" title="c/numeric/math/fmod"> <span class="t-lines"><span>fmod</span><span>fmodf</span><span>fmodl</span></span></a></div>
-<div><span class="t-lines"><span><span class="t-mark-rev t-since-c99">(C99)</span></span><span><span class="t-mark-rev t-since-c99">(C99)</span></span></span></div> </td> <td> computes remainder of the floating-point division operation <br> <span class="t-mark">(function)</span> </td>
-</tr> <tr class="t-dsc"> <td> <div><a href="remainder" title="c/numeric/math/remainder"> <span class="t-lines"><span>remainder</span><span>remainderf</span><span>remainderl</span></span></a></div>
-<div><span class="t-lines"><span><span class="t-mark-rev t-since-c99">(C99)</span></span><span><span class="t-mark-rev t-since-c99">(C99)</span></span><span><span class="t-mark-rev t-since-c99">(C99)</span></span></span></div> </td> <td> computes signed remainder of the floating-point division operation <br> <span class="t-mark">(function)</span> </td>
-</tr> <tr class="t-dsc"> <td> <div><a href="remquo" title="c/numeric/math/remquo"> <span class="t-lines"><span>remquo</span><span>remquof</span><span>remquol</span></span></a></div>
-<div><span class="t-lines"><span><span class="t-mark-rev t-since-c99">(C99)</span></span><span><span class="t-mark-rev t-since-c99">(C99)</span></span><span><span class="t-mark-rev t-since-c99">(C99)</span></span></span></div> </td> <td> computes signed remainder as well as the three last bits of the division operation <br> <span class="t-mark">(function)</span> </td>
-</tr> <tr class="t-dsc"> <td colspan="2"> <span><a href="https://en.cppreference.com/w/cpp/numeric/math/div" title="cpp/numeric/math/div">C++ documentation</a></span> for <code>div</code> </td>
-</tr> </table> <h3 id="External_links"> External links</h3> <table> <tr style="vertical-align:top;"> <td>1. </td> <td>
-<a href="https://en.wikipedia.org/wiki/Euclidean_division" class="extiw" title="enwiki:Euclidean division">Euclidean division</a> — From Wikipedia. </td>
-</tr> <tr style="vertical-align:top;"> <td>2. </td> <td>
-<a href="https://en.wikipedia.org/wiki/Modulo" class="extiw" title="enwiki:Modulo">Modulo (and Truncated division)</a> — From Wikipedia. </td>
-</tr>
-</table> <div class="_attribution">
- <p class="_attribution-p">
- &copy; cppreference.com<br>Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.<br>
- <a href="https://en.cppreference.com/w/c/numeric/math/div" class="_attribution-link">https://en.cppreference.com/w/c/numeric/math/div</a>
- </p>
-</div>