File Manager

003 File Manager

Current Path: /usr/local/share/doc/mpdecimal/libmpdec

usr / local / share / doc / mpdecimal / libmpdec /

📁 ..
📄 README.txt(88 B)
📁 _static
📄 arithmetic.html(109.46 KB)
📄 assign-convert.html(56.83 KB)
📄 attributes.html(24.85 KB)
📄 context.html(37.84 KB)
📄 decimals.html(8.45 KB)
📄 functions.html(58.37 KB)
📄 index.html(16.95 KB)
📄 memory.html(15.59 KB)
📄 objects.inv(1.83 KB)
📄 search.html(2.76 KB)
📄 searchindex.js(30.97 KB)
📄 various.html(40.5 KB)

Editing: context.html

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<title>Context &#8212; mpdecimal 2.5.1 documentation</title>
 <link rel="stylesheet" href="_static/mpdecimal-doc.css" type="text/css" />
 <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
 
 <script id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script>
 <script src="_static/jquery.js"></script>
 <script src="_static/underscore.js"></script>
 <script src="_static/doctools.js"></script>
 <script src="_static/language_data.js"></script>
 
 <link rel="search" title="Search" href="search.html" />
 <link rel="next" title="Decimals" href="decimals.html" />
 <link rel="prev" title="Function Index" href="functions.html" /> 
 </head><body>
 <div class="related" role="navigation" aria-label="related navigation">
 <h3>Navigation</h3>
 <ul>
 <li class="right" style="margin-right: 10px">
 <a href="decimals.html" title="Decimals"
 accesskey="N">next</a></li>
 <li class="right" >
 <a href="functions.html" title="Function Index"
 accesskey="P">previous</a> |</li>
 <li><a href="http://www.bytereef.org/mpdecimal/index.html">project home</a></li>
 
 </ul>
 </div>
 <div class="sphinxsidebar" role="navigation" aria-label="main navigation">
 <div class="sphinxsidebarwrapper">
 <h3><a href="index.html">Table of Contents</a></h3>
 <ul>
<li><a class="reference internal" href="#">Context</a><ul>
<li><a class="reference internal" href="#data-type">Data Type</a></li>
<li><a class="reference internal" href="#constants">Constants</a></li>
<li><a class="reference internal" href="#precision-and-exponents">Precision and Exponents</a></li>
<li><a class="reference internal" href="#rounding">Rounding</a></li>
<li><a class="reference internal" href="#signals-and-conditions">Signals and Conditions</a></li>
<li><a class="reference internal" href="#exponent-clamping">Exponent Clamping</a></li>
<li><a class="reference internal" href="#correct-rounding">Correct Rounding</a></li>
</ul>
</li>
<li><a class="reference internal" href="#context-functions">Context Functions</a><ul>
<li><a class="reference internal" href="#initialization">Initialization</a></li>
<li><a class="reference internal" href="#ieee-interchange-formats">IEEE Interchange Formats</a></li>
<li><a class="reference internal" href="#getters-and-setters">Getters and Setters</a></li>
<li><a class="reference internal" href="#calling-the-trap-handler">Calling the Trap Handler</a></li>
</ul>
</li>
</ul>

<h4>Previous topic</h4>
 <a href="functions.html"
 title="previous chapter">Function Index</a>
 <h4>Next topic</h4>
 <a href="decimals.html"
 title="next chapter">Decimals</a>
<div id="searchbox" style="display: none" role="search">
 <h3 id="searchlabel">Quick search</h3>
 <div class="searchformwrapper">
 <form class="search" action="search.html" method="get">
 <input type="text" name="q" aria-labelledby="searchlabel" />
 <input type="submit" value="Go" />
 </form>
 </div>
</div>
<script>$('#searchbox').show(0);</script>
 </div>
 </div>

<div class="document">
 <div class="documentwrapper">
 <div class="bodywrapper">
 <div class="body" role="main">
 
 <div class="section" id="context">
<h1>Context</h1>
Most operations are affected by context. Usually, a pointer to the context
is passed as the last parameter to signaling functions or the last but one
parameter to quiet functions.
<div class="section" id="data-type">
<h2>Data Type</h2>
The context is defined as a C struct:
<div class="highlight-c notranslate"><div class="highlight"><pre>#include &lt;mpdecimal.h&gt;

typedef struct mpd_context_t {
 mpd_ssize_t prec; // precision
 mpd_ssize_t emax; // max positive exp
 mpd_ssize_t emin; // min negative exp
 uint32_t traps; // status events that should be trapped
 uint32_t status; // status flags
 uint32_t newtrap; // set by mpd_addstatus_raise()
 int round; // rounding mode
 int clamp; // clamp mode
 int allcr; // all functions correctly rounded
} mpd_context_t;
</pre></div>
</div>
</div>
<div class="section" id="constants">
<h2>Constants</h2>
<blockquote>
<div><table border="1" class="docutils align-default">
<colgroup>
<col width="31%" />
<col width="28%" />
<col width="41%" />
</colgroup>
<thead valign="bottom">
<tr class="row-odd"><th class="head">&#160;</th>
<th class="head">32-bit</th>
<th class="head">64-bit</th>
</tr>
</thead>
<tbody valign="top">
<tr class="row-even"><td><code class="xref c c-macro docutils literal notranslate">MPD_MAX_PREC</code></td>
<td><code class="xref c c-macro docutils literal notranslate">425000000</code></td>
<td><code class="xref c c-macro docutils literal notranslate">999999999999999999</code></td>
</tr>
<tr class="row-odd"><td><code class="xref c c-macro docutils literal notranslate">MPD_MAX_EMAX</code></td>
<td><code class="xref c c-macro docutils literal notranslate">425000000</code></td>
<td><code class="xref c c-macro docutils literal notranslate">999999999999999999</code></td>
</tr>
<tr class="row-even"><td><code class="xref c c-macro docutils literal notranslate">MPD_MIN_EMIN</code></td>
<td><code class="xref c c-macro docutils literal notranslate">-425000000</code></td>
<td><code class="xref c c-macro docutils literal notranslate">-999999999999999999</code></td>
</tr>
</tbody>
</table>
</div></blockquote>
</div>
<div class="section" id="precision-and-exponents">
<h2>Precision and Exponents</h2>
<blockquote>
<div><table border="1" class="docutils align-default">
<colgroup>
<col width="24%" />
<col width="76%" />
</colgroup>
<tbody valign="top">
<tr class="row-odd"><td>prec</td>
<td>[<code class="xref c c-macro docutils literal notranslate">1</code>, <code class="xref c c-macro docutils literal notranslate">MPD_MAX_PREC</code>]</td>
</tr>
<tr class="row-even"><td>emax</td>
<td>[<code class="xref c c-macro docutils literal notranslate">0</code>, <code class="xref c c-macro docutils literal notranslate">MPD_MAX_EMAX</code>]</td>
</tr>
<tr class="row-odd"><td>emin</td>
<td>[<code class="xref c c-macro docutils literal notranslate">MPD_MIN_EMIN</code>, <code class="xref c c-macro docutils literal notranslate">0</code>]</td>
</tr>
</tbody>
</table>
</div></blockquote>
Apart from the limits, the following rules must be observed when setting the context manually:
<blockquote>
<div><ul class="simple">
<li>prec &lt;= emax</li>
<li>emin = 1 - emax or emin = -emax</li>
</ul>
</div></blockquote>
The specification requires 5 x prec &lt;= emax and recommends 10 x prec &lt;= emax.
</div>
<div class="section" id="rounding">
<h2>Rounding</h2>
The round field can take one of these values:
<blockquote>
<div><table border="1" class="docutils align-default">
<colgroup>
<col width="42%" />
<col width="58%" />
</colgroup>
<tbody valign="top">
<tr class="row-odd"><td><code class="xref c c-macro docutils literal notranslate">MPD_ROUND_UP</code></td>
<td>round away from <code class="xref c c-macro docutils literal notranslate">0</code></td>
</tr>
<tr class="row-even"><td><code class="xref c c-macro docutils literal notranslate">MPD_ROUND_DOWN</code></td>
<td>round toward <code class="xref c c-macro docutils literal notranslate">0</code> (truncate)</td>
</tr>
<tr class="row-odd"><td><code class="xref c c-macro docutils literal notranslate">MPD_ROUND_CEILING</code></td>
<td>round toward <code class="xref c c-macro docutils literal notranslate">+infinity</code></td>
</tr>
<tr class="row-even"><td><code class="xref c c-macro docutils literal notranslate">MPD_ROUND_FLOOR</code></td>
<td>round toward <code class="xref c c-macro docutils literal notranslate">-infinity</code></td>
</tr>
<tr class="row-odd"><td><code class="xref c c-macro docutils literal notranslate">MPD_ROUND_HALF_UP</code></td>
<td><code class="xref c c-macro docutils literal notranslate">0.5</code> is rounded up</td>
</tr>
<tr class="row-even"><td><code class="xref c c-macro docutils literal notranslate">MPD_ROUND_HALF_DOWN</code></td>
<td><code class="xref c c-macro docutils literal notranslate">0.5</code> is rounded down</td>
</tr>
<tr class="row-odd"><td><code class="xref c c-macro docutils literal notranslate">MPD_ROUND_HALF_EVEN</code></td>
<td><code class="xref c c-macro docutils literal notranslate">0.5</code> is rounded to even</td>
</tr>
<tr class="row-even"><td><code class="xref c c-macro docutils literal notranslate">MPD_ROUND_05UP</code></td>
<td>round zero or five away from <code class="xref c c-macro docutils literal notranslate">0</code></td>
</tr>
<tr class="row-odd"><td><code class="xref c c-macro docutils literal notranslate">MPD_ROUND_TRUNC</code></td>
<td>truncate, but set infinities</td>
</tr>
</tbody>
</table>
</div></blockquote>
</div>
<div class="section" id="signals-and-conditions">
<h2>Signals and Conditions</h2>
The standard distinguishes between signals and conditions. In particular,
the <code class="xref c c-macro docutils literal notranslate">MPD_IEEE_Invalid_operation</code> signal comprises several conditions.
In a signaling function, the status field of the context is updated with
all conditions that occurred during the execution. It is never reset
automatically, so at any point in a program it contains the cumulative
status of all signaling functions.
The traps field determines which signals invoke the <code class="xref c c-func docutils literal notranslate">mpd_traphandler</code>
custom function. By default, this function raises <code class="xref c c-macro docutils literal notranslate">SIGFPE</code>.
If a trap occurs, the newtrap field is set to the value of the respective
condition. This makes it possible to determine the latest error condition
that occurred even when the status has already been “polluted” with previous
error conditions.
Here are the possible signals and conditions:
<blockquote>
<div><table border="1" class="docutils align-default">
<colgroup>
<col width="52%" />
<col width="48%" />
</colgroup>
<thead valign="bottom">
<tr class="row-odd"><th class="head">Signals</th>
<th class="head">Conditions</th>
</tr>
</thead>
<tbody valign="top">
<tr class="row-even"><td rowspan="6"><code class="xref c c-macro docutils literal notranslate">MPD_IEEE_Invalid_operation</code></td>
<td><code class="xref c c-macro docutils literal notranslate">MPD_Conversion_syntax</code></td>
</tr>
<tr class="row-odd"><td><code class="xref c c-macro docutils literal notranslate">MPD_Division_impossible</code></td>
</tr>
<tr class="row-even"><td><code class="xref c c-macro docutils literal notranslate">MPD_Division_undefined</code></td>
</tr>
<tr class="row-odd"><td><code class="xref c c-macro docutils literal notranslate">MPD_Invalid_context</code></td>
</tr>
<tr class="row-even"><td><code class="xref c c-macro docutils literal notranslate">MPD_Invalid_operation</code></td>
</tr>
<tr class="row-odd"><td><code class="xref c c-macro docutils literal notranslate">MPD_Malloc_error</code></td>
</tr>
<tr class="row-even"><td><code class="xref c c-macro docutils literal notranslate">MPD_Clamped</code></td>
<td><code class="xref c c-macro docutils literal notranslate">MPD_Clamped</code></td>
</tr>
<tr class="row-odd"><td><code class="xref c c-macro docutils literal notranslate">MPD_Division_by_zero</code></td>
<td><code class="xref c c-macro docutils literal notranslate">MPD_Division_by_zero</code></td>
</tr>
<tr class="row-even"><td><code class="xref c c-macro docutils literal notranslate">MPD_Fpu_error</code> <a class="footnote-reference" href="#f1" id="id1">[1]</a></td>
<td><code class="xref c c-macro docutils literal notranslate">MPD_Fpu_error</code></td>
</tr>
<tr class="row-odd"><td><code class="xref c c-macro docutils literal notranslate">MPD_Inexact</code></td>
<td><code class="xref c c-macro docutils literal notranslate">MPD_Inexact</code></td>
</tr>
<tr class="row-even"><td><code class="xref c c-macro docutils literal notranslate">MPD_Not_implemented</code> <a class="footnote-reference" href="#f2" id="id2">[2]</a></td>
<td><code class="xref c c-macro docutils literal notranslate">MPD_Not_implemented</code></td>
</tr>
<tr class="row-odd"><td><code class="xref c c-macro docutils literal notranslate">MPD_Overflow</code></td>
<td><code class="xref c c-macro docutils literal notranslate">MPD_Overflow</code></td>
</tr>
<tr class="row-even"><td><code class="xref c c-macro docutils literal notranslate">MPD_Rounded</code></td>
<td><code class="xref c c-macro docutils literal notranslate">MPD_Rounded</code></td>
</tr>
<tr class="row-odd"><td><code class="xref c c-macro docutils literal notranslate">MPD_Subnormal</code></td>
<td><code class="xref c c-macro docutils literal notranslate">MPD_Subnormal</code></td>
</tr>
<tr class="row-even"><td><code class="xref c c-macro docutils literal notranslate">MPD_Underflow</code></td>
<td><code class="xref c c-macro docutils literal notranslate">MPD_Underflow</code></td>
</tr>
</tbody>
</table>
<table class="docutils footnote" frame="void" id="f1" rules="none">
<colgroup><col class="label" /><col /></colgroup>
<tbody valign="top">
<tr><td class="label"><a class="fn-backref" href="#id1">[1]</a></td><td>deprecated, might be renamed to a user-definable signal.</td></tr>
</tbody>
</table>
<table class="docutils footnote" frame="void" id="f2" rules="none">
<colgroup><col class="label" /><col /></colgroup>
<tbody valign="top">
<tr><td class="label"><a class="fn-backref" href="#id2">[2]</a></td><td>unused, might be renamed to a user-definable signal.</td></tr>
</tbody>
</table>
</div></blockquote>
</div>
<div class="section" id="exponent-clamping">
<h2>Exponent Clamping</h2>
If the <code class="xref c c-member docutils literal notranslate">clamp</code> field is set to 1, the maximum exponent is reduced to
emax - prec + 1. This is compatible with the IEEE 754 decimal
interchange formats.
</div>
<div class="section" id="correct-rounding">
<h2>Correct Rounding</h2>
Most functions are correctly-rounded by default. If allcr is set
to 1, correct rounding is additionally enabled for <code class="xref c c-func docutils literal notranslate">mpd_exp</code>,
<code class="xref c c-func docutils literal notranslate">mpd_ln</code> and <code class="xref c c-func docutils literal notranslate">mpd_log10</code>.
In this case, all functions except <code class="xref c c-func docutils literal notranslate">mpd_pow</code> and <code class="xref c c-func docutils literal notranslate">mpd_invroot</code>
return correctly rounded results.
</div>
</div>
<div class="section" id="context-functions">
<h1>Context Functions</h1>
<div class="section" id="initialization">
<h2>Initialization</h2>
<div class="highlight-c notranslate" id="std:topic-mpd_init"><div class="highlight"><pre>void mpd_init(mpd_context_t *ctx, mpd_ssize_t prec);
</pre></div>
</div>
ctx is initialized by <code class="xref c c-func docutils literal notranslate">mpd_defaultcontext</code>, using prec.
At the same time, <code class="xref c c-macro docutils literal notranslate">MPD_MINALLOC</code> is initialized to the ideal
value for the given precision. Note that memory usage increases by
setting <code class="xref c c-macro docutils literal notranslate">MPD_MINALLOC</code> to higher values.
This function can only be used at program start.
<div class="highlight-c notranslate" id="std:topic-mpd_basiccontext"><div class="highlight"><pre>void mpd_maxcontext(mpd_context_t *ctx);
void mpd_defaultcontext(mpd_context_t *ctx);
void mpd_basiccontext(mpd_context_t *ctx);
</pre></div>
</div>
Initialize the given context. The values for each function:
<table border="1" class="docutils align-default">
<colgroup>
<col width="10%" />
<col width="29%" />
<col width="29%" />
<col width="32%" />
</colgroup>
<thead valign="bottom">
<tr class="row-odd"><th class="head">&#160;</th>
<th class="head">maxcontext</th>
<th class="head">defaultcontext <a class="footnote-reference" href="#f3" id="id3">[3]</a></th>
<th class="head">basiccontext <a class="footnote-reference" href="#f4" id="id4">[4]</a></th>
</tr>
</thead>
<tbody valign="top">
<tr class="row-even"><td>prec</td>
<td><code class="xref c c-macro docutils literal notranslate">MPD_MAX_PREC</code></td>
<td><code class="xref c c-macro docutils literal notranslate">2*MPD_RDIGITS</code></td>
<td><code class="xref c c-macro docutils literal notranslate">9</code></td>
</tr>
<tr class="row-odd"><td>emax</td>
<td><code class="xref c c-macro docutils literal notranslate">MPD_MAX_EMAX</code></td>
<td><code class="xref c c-macro docutils literal notranslate">MPD_MAX_EMAX</code></td>
<td><code class="xref c c-macro docutils literal notranslate">MPD_MAX_EMAX</code></td>
</tr>
<tr class="row-even"><td>emin</td>
<td><code class="xref c c-macro docutils literal notranslate">MPD_MIN_EMIN</code></td>
<td><code class="xref c c-macro docutils literal notranslate">MPD_MIN_EMIN</code></td>
<td><code class="xref c c-macro docutils literal notranslate">MPD_MIN_EMIN</code></td>
</tr>
<tr class="row-odd"><td>round</td>
<td><code class="xref c c-macro docutils literal notranslate">MPD_ROUND_HALF_EVEN</code></td>
<td><code class="xref c c-macro docutils literal notranslate">MPD_ROUND_HALF_UP</code></td>
<td><code class="xref c c-macro docutils literal notranslate">MPD_ROUND_HALF_UP</code></td>
</tr>
<tr class="row-even"><td>traps</td>
<td><code class="xref c c-macro docutils literal notranslate">MPD_Traps</code></td>
<td><code class="xref c c-macro docutils literal notranslate">MPD_Traps</code></td>
<td><code class="xref c c-macro docutils literal notranslate">MPD_Traps|MPD_Clamped</code></td>
</tr>
<tr class="row-odd"><td>status</td>
<td><code class="xref c c-macro docutils literal notranslate">0</code></td>
<td><code class="xref c c-macro docutils literal notranslate">0</code></td>
<td><code class="xref c c-macro docutils literal notranslate">0</code></td>
</tr>
<tr class="row-even"><td>newtrap</td>
<td><code class="xref c c-macro docutils literal notranslate">0</code></td>
<td><code class="xref c c-macro docutils literal notranslate">0</code></td>
<td><code class="xref c c-macro docutils literal notranslate">0</code></td>
</tr>
<tr class="row-odd"><td>clamp</td>
<td><code class="xref c c-macro docutils literal notranslate">0</code></td>
<td><code class="xref c c-macro docutils literal notranslate">0</code></td>
<td><code class="xref c c-macro docutils literal notranslate">0</code></td>
</tr>
<tr class="row-even"><td>allcr</td>
<td><code class="xref c c-macro docutils literal notranslate">1</code></td>
<td><code class="xref c c-macro docutils literal notranslate">1</code></td>
<td><code class="xref c c-macro docutils literal notranslate">1</code></td>
</tr>
</tbody>
</table>
<table class="docutils footnote" frame="void" id="f3" rules="none">
<colgroup><col class="label" /><col /></colgroup>
<tbody valign="top">
<tr><td class="label"><a class="fn-backref" href="#id3">[3]</a></td><td>libmpdec’s default context</td></tr>
</tbody>
</table>
<table class="docutils footnote" frame="void" id="f4" rules="none">
<colgroup><col class="label" /><col /></colgroup>
<tbody valign="top">
<tr><td class="label"><a class="fn-backref" href="#id4">[4]</a></td><td>the specification’s basic default context</td></tr>
</tbody>
</table>
</div>
<div class="section" id="ieee-interchange-formats">
<h2>IEEE Interchange Formats</h2>
<div class="highlight-c notranslate" id="std:topic-mpd_ieee_context"><div class="highlight"><pre>MPD_IEEE_CONTEXT_MAX_BITS
MPD_DECIMAL32
MPD_DECIMAL64
MPD_DECIMAL128

int mpd_ieee_context(mpd_context_t *ctx, int bits);
</pre></div>
</div>
Initialize the context to the proper values for one of the IEEE interchange
formats. The argument must be a multiple of 32 and less than
<code class="xref c c-macro docutils literal notranslate">IEEE_CONTEXT_MAX_BITS</code>.
For the most common values, the following constants are provided:
<table border="1" class="docutils align-default">
<colgroup>
<col width="11%" />
<col width="30%" />
<col width="30%" />
<col width="30%" />
</colgroup>
<thead valign="bottom">
<tr class="row-odd"><th class="head">&#160;</th>
<th class="head"><code class="xref c c-macro docutils literal notranslate">MPD_DECIMAL32</code></th>
<th class="head"><code class="xref c c-macro docutils literal notranslate">MPD_DECIMAL64</code></th>
<th class="head"><code class="xref c c-macro docutils literal notranslate">MPD_DECIMAL128</code></th>
</tr>
</thead>
<tbody valign="top">
<tr class="row-even"><td>prec</td>
<td><code class="xref c c-macro docutils literal notranslate">7</code></td>
<td><code class="xref c c-macro docutils literal notranslate">16</code></td>
<td><code class="xref c c-macro docutils literal notranslate">34</code></td>
</tr>
<tr class="row-odd"><td>emax</td>
<td><code class="xref c c-macro docutils literal notranslate">96</code></td>
<td><code class="xref c c-macro docutils literal notranslate">384</code></td>
<td><code class="xref c c-macro docutils literal notranslate">6144</code></td>
</tr>
<tr class="row-even"><td>emin</td>
<td><code class="xref c c-macro docutils literal notranslate">-95</code></td>
<td><code class="xref c c-macro docutils literal notranslate">-383</code></td>
<td><code class="xref c c-macro docutils literal notranslate">-6143</code></td>
</tr>
<tr class="row-odd"><td>round</td>
<td><code class="xref c c-macro docutils literal notranslate">MPD_ROUND_HALF_EVEN</code></td>
<td><code class="xref c c-macro docutils literal notranslate">MPD_ROUND_HALF_EVEN</code></td>
<td><code class="xref c c-macro docutils literal notranslate">MPD_ROUND_HALF_EVEN</code></td>
</tr>
<tr class="row-even"><td>traps</td>
<td><code class="xref c c-macro docutils literal notranslate">0</code></td>
<td><code class="xref c c-macro docutils literal notranslate">0</code></td>
<td><code class="xref c c-macro docutils literal notranslate">0</code></td>
</tr>
<tr class="row-odd"><td>status</td>
<td><code class="xref c c-macro docutils literal notranslate">0</code></td>
<td><code class="xref c c-macro docutils literal notranslate">0</code></td>
<td><code class="xref c c-macro docutils literal notranslate">0</code></td>
</tr>
<tr class="row-even"><td>newtrap</td>
<td><code class="xref c c-macro docutils literal notranslate">0</code></td>
<td><code class="xref c c-macro docutils literal notranslate">0</code></td>
<td><code class="xref c c-macro docutils literal notranslate">0</code></td>
</tr>
<tr class="row-odd"><td>clamp</td>
<td><code class="xref c c-macro docutils literal notranslate">1</code></td>
<td><code class="xref c c-macro docutils literal notranslate">1</code></td>
<td><code class="xref c c-macro docutils literal notranslate">1</code></td>
</tr>
<tr class="row-even"><td>allcr</td>
<td><code class="xref c c-macro docutils literal notranslate">1</code></td>
<td><code class="xref c c-macro docutils literal notranslate">1</code></td>
<td><code class="xref c c-macro docutils literal notranslate">1</code></td>
</tr>
</tbody>
</table>
</div>
<div class="section" id="getters-and-setters">
<h2>Getters and Setters</h2>
<div class="highlight-c notranslate" id="std:topic-mpd_getcr"><div class="highlight"><pre>size_t mpd_getprec(const mpd_context_t *ctx);
mpd_ssize_t mpd_getemax(const mpd_context_t *ctx);
mpd_ssize_t mpd_getemin(const mpd_context_t *ctx);
int mpd_getround(const mpd_context_t *ctx);
uint32_t mpd_gettraps(const mpd_context_t *ctx);
uint32_t mpd_getstatus(const mpd_context_t *ctx);
int mpd_getclamp(const mpd_context_t *ctx);
int mpd_getcr(const mpd_context_t *ctx);
</pre></div>
</div>
Get the individual values.
<div class="highlight-c notranslate" id="std:topic-mpd_etiny"><div class="highlight"><pre>mpd_ssize_t mpd_etiny(const mpd_context_t *ctx);
</pre></div>
</div>
Return the lowest possible exponent of a subnormal number: emin - prec + 1
<div class="highlight-c notranslate" id="std:topic-mpd_etop"><div class="highlight"><pre>mpd_ssize_t mpd_etop(const mpd_context_t *ctx);
</pre></div>
</div>
Return the highest possible exponent of a normal number: emax - prec + 1
Only relevant if clamp is set to 1.
<div class="highlight-c notranslate" id="std:topic-mpd_qsetcr"><div class="highlight"><pre>int mpd_qsetprec(mpd_context_t *ctx, mpd_ssize_t prec);
int mpd_qsetemax(mpd_context_t *ctx, mpd_ssize_t emax);
int mpd_qsetemin(mpd_context_t *ctx, mpd_ssize_t emin);
int mpd_qsetround(mpd_context_t *ctx, int newround);
int mpd_qsettraps(mpd_context_t *ctx, uint32_t flags);
int mpd_qsetstatus(mpd_context_t *ctx, uint32_t flags);
int mpd_qsetclamp(mpd_context_t *ctx, int c);
int mpd_qsetcr(mpd_context_t *ctx, int c);
</pre></div>
</div>
Quietly set the individual values. These functions check the limits, but they
are not foolproof: For example, they still allow setting a prec that does
not agree with emax. The functions return 1 on success and 0 on failure.
They are quiet since raising an <code class="xref c c-macro docutils literal notranslate">MPD_Invalid_context</code> condition would
not make sense in most cases.
</div>
<div class="section" id="calling-the-trap-handler">
<h2>Calling the Trap Handler</h2>
<div class="highlight-c notranslate" id="std:topic-mpd_traphandler"><div class="highlight"><pre>extern void (* mpd_traphandler)(mpd_context_t *);
void mpd_dflt_traphandler(mpd_context_t *);

void mpd_addstatus_raise(mpd_context_t *ctx, uint32_t flags);
</pre></div>
</div>
Add flags to the status field of ctx. If a condition is trapped, set
newtrap to the condition and call <code class="xref c c-func docutils literal notranslate">mpd_traphandler</code>. By default,
<code class="xref c c-func docutils literal notranslate">mpd_traphandler</code> is points to <code class="xref c c-func docutils literal notranslate">mpd_dflt_traphandler</code>, which
raises <code class="xref c c-macro docutils literal notranslate">SIGFPE</code>.
</div>
</div>

</div>
 </div>
 </div>
 <div class="clearer"></div>
 </div>
 <div class="related" role="navigation" aria-label="related navigation">
 <h3>Navigation</h3>
 <ul>
 <li class="right" style="margin-right: 10px">
 <a href="decimals.html" title="Decimals"
 >next</a></li>
 <li class="right" >
 <a href="functions.html" title="Function Index"
 >previous</a> |</li>
 <li><a href="http://www.bytereef.org/mpdecimal/index.html">project home</a></li>
 
 </ul>
 </div>
 <div class="footer" role="contentinfo">
 &#169; Copyright 2010-2020, Stefan Krah.
 Created using <a href="http://sphinx-doc.org/">Sphinx</a> 2.4.4.
 </div>
 </body>
</html>

003 File Manager

Editing: context.html

Upload File

Create Folder