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: attributes.html

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

<title>Attributes of a Decimal &#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="Arithmetic Functions" href="arithmetic.html" />
 <link rel="prev" title="Assignment, Conversions, I/O" href="assign-convert.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="arithmetic.html" title="Arithmetic Functions"
 accesskey="N">next</a></li>
 <li class="right" >
 <a href="assign-convert.html" title="Assignment, Conversions, I/O"
 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="#">Attributes of a Decimal</a><ul>
<li><a class="reference internal" href="#getting-attributes">Getting Attributes</a></li>
<li><a class="reference internal" href="#setting-attributes">Setting Attributes</a></li>
</ul>
</li>
</ul>

<h4>Previous topic</h4>
 <a href="assign-convert.html"
 title="previous chapter">Assignment, Conversions, I/O</a>
 <h4>Next topic</h4>
 <a href="arithmetic.html"
 title="next chapter">Arithmetic Functions</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="attributes-of-a-decimal">
<h1>Attributes of a Decimal</h1>
<div class="section" id="getting-attributes">
<h2>Getting Attributes</h2>
<div class="highlight-c notranslate" id="std:topic-mpd_adjexp"><div class="highlight"><pre>mpd_ssize_t mpd_adjexp(const mpd_t *dec);
</pre></div>
</div>
Adjusted exponent of a decimal: exp + digits - 1
<div class="highlight-c notranslate" id="std:topic-mpd_class"><div class="highlight"><pre>const char *mpd_class(const mpd_t *dec, const mpd_context_t *ctx);
</pre></div>
</div>
Return a pointer to the class of dec, which is one of sNaN, NaN,
-Infinity, -Normal, -Subnormal, -Zero, +Zero, +Subnormal, +Normal,
+Infinity.
<div class="highlight-c notranslate" id="std:topic-mpd_iszero"><div class="highlight"><pre>int mpd_isfinite(const mpd_t *dec);
int mpd_isinfinite(const mpd_t *dec);
int mpd_isnan(const mpd_t *dec);
int mpd_isnegative(const mpd_t *dec);
int mpd_ispositive(const mpd_t *dec);
int mpd_isqnan(const mpd_t *dec);
int mpd_issigned(const mpd_t *dec);
int mpd_issnan(const mpd_t *dec);
int mpd_isspecial(const mpd_t *dec);
int mpd_iszero(const mpd_t *dec);
</pre></div>
</div>
These functions should be self-explanatory. <code class="xref c c-func docutils literal notranslate">mpd_issigned</code> is the same
as <code class="xref c c-func docutils literal notranslate">mpd_isnegative</code>.
<div class="highlight-c notranslate" id="std:topic-mpd_isnormal"><div class="highlight"><pre>int mpd_isnormal(const mpd_t *dec, const mpd_context_t *ctx);
</pre></div>
</div>
Return 0 if the decimal is special or zero, or the exponent is less than emin.
Return 1 otherwise.
<div class="highlight-c notranslate" id="std:topic-mpd_issubnormal"><div class="highlight"><pre>int mpd_issubnormal(const mpd_t *dec, const mpd_context_t *ctx);
</pre></div>
</div>
Return 0 if the decimal is special or zero, or the exponent is greater or equal
to emin. Return 1 otherwise.
<div class="highlight-c notranslate" id="std:topic-mpd_isinteger"><div class="highlight"><pre>int mpd_isinteger(const mpd_t *dec);
</pre></div>
</div>
Determine whether dec is an (arbitrary precision) integer. The exponent
of an integer is not necessarily zero and may be negative if the coefficient
has trailing zeros.
<div class="highlight-c notranslate" id="std:topic-mpd_iseven"><div class="highlight"><pre>int mpd_isodd(const mpd_t *dec);
int mpd_iseven(const mpd_t *dec);
</pre></div>
</div>
Determine whether an integer is odd or even. These functions are undefined
for non-integers, so they should only be used after calling <code class="xref c c-func docutils literal notranslate">mpd_isinteger</code>.
<div class="highlight-c notranslate" id="std:topic-mpd_sign"><div class="highlight"><pre>uint8_t mpd_sign(const mpd_t *dec);
</pre></div>
</div>
Return the sign flag, which is 0 for positive decimals and 1 for negative.
<div class="highlight-c notranslate" id="std:topic-mpd_arith_sign"><div class="highlight"><pre>int mpd_arith_sign(const mpd_t *dec);
</pre></div>
</div>
Return 1 for positive decimals and -1 for negative.
<div class="highlight-c notranslate" id="std:topic-mpd_trail_zeros"><div class="highlight"><pre>mpd_ssize_t mpd_trail_zeros(const mpd_t *dec);
</pre></div>
</div>
Return the number of trailing zeros in the coefficient.
<div class="highlight-c notranslate" id="std:topic-mpd_iszerocoeff"><div class="highlight"><pre>int mpd_iszerocoeff(const mpd_t *dec);
</pre></div>
</div>
Test if the coefficient is zero. Only useful for non-special numbers.
<div class="highlight-c notranslate" id="std:topic-mpd_isoddcoeff"><div class="highlight"><pre>int mpd_isoddcoeff(const mpd_t *dec);
</pre></div>
</div>
Test if the coefficient is odd. Only useful for non-special numbers.
<div class="highlight-c notranslate" id="std:topic-mpd_msword"><div class="highlight"><pre>mpd_uint_t mpd_msword(const mpd_t *dec);
</pre></div>
</div>
Return the most significant word of the coefficient.
<div class="highlight-c notranslate" id="std:topic-mpd_word_digits"><div class="highlight"><pre>int mpd_word_digits(mpd_uint_t word);
</pre></div>
</div>
Return the number of decimal digits in a word.
<div class="highlight-c notranslate" id="std:topic-mpd_msd"><div class="highlight"><pre>mpd_uint_t mpd_msd(mpd_uint_t word);
</pre></div>
</div>
Return the most significant digit of a word.
<div class="highlight-c notranslate" id="std:topic-mpd_lsd"><div class="highlight"><pre>mpd_uint_t mpd_lsd(mpd_uint_t word);
</pre></div>
</div>
Return the least significant digit of a word.
<div class="highlight-c notranslate" id="std:topic-mpd_isoddword"><div class="highlight"><pre>int mpd_isoddword(mpd_uint_t word);
</pre></div>
</div>
Test if a word is odd.
<div class="highlight-c notranslate" id="std:topic-mpd_exp_digits"><div class="highlight"><pre>int mpd_exp_digits(mpd_ssize_t exp);
</pre></div>
</div>
Number of decimal digits in the exponent.
<div class="highlight-c notranslate" id="std:topic-mpd_isconst_data"><div class="highlight"><pre>int mpd_isdynamic(const mpd_t *dec);
int mpd_isstatic(const mpd_t *dec);
int mpd_isdynamic_data(const mpd_t *dec);
int mpd_isstatic_data(const mpd_t *dec);
int mpd_isshared_data(const mpd_t *dec);
int mpd_isconst_data(const mpd_t *dec);
</pre></div>
</div>
These functions test the memory attributes of a decimal. They are only of interest
if features from the section <a class="reference internal" href="memory.html#advanced-memory-handling">Advanced Memory Handling</a>
are used.
</div>
<div class="section" id="setting-attributes">
<h2>Setting Attributes</h2>
The functions in this section are mostly low level functions that users
of the library should not need. They are required when operating
directly on the data field of a decimal, so that len, digits,
sign etc. have to be set.
When setting one of {<code class="xref c c-macro docutils literal notranslate">MPD_NEG</code>, <code class="xref c c-macro docutils literal notranslate">MPD_INF</code>, <code class="xref c c-macro docutils literal notranslate">MPD_NAN</code>,
<code class="xref c c-macro docutils literal notranslate">MPD_SNAN</code>}, the memory flags must be left intact. All functions in
this section take care of this aspect.
<div class="highlight-c notranslate" id="std:topic-mpd_clear_flags"><div class="highlight"><pre>void mpd_clear_flags(mpd_t *result);
</pre></div>
</div>
Clear the numeric flags, but leave the memory flags intact.
<div class="highlight-c notranslate" id="std:topic-mpd_set_flags"><div class="highlight"><pre>void mpd_set_flags(mpd_t *result, uint8_t flags);
</pre></div>
</div>
Set numeric flags, but leave the memory flags intact.
<div class="highlight-c notranslate" id="std:topic-mpd_copy_flags"><div class="highlight"><pre>void mpd_copy_flags(mpd_t *result, const mpd_t *a);
</pre></div>
</div>
Copy only the numeric flags from a to result.
<div class="highlight-c notranslate" id="std:topic-mpd_digits_to_size"><div class="highlight"><pre>mpd_ssize_t mpd_digits_to_size(mpd_ssize_t ndigits);
</pre></div>
</div>
Return the coefficient size required to store ndigits.
<div class="highlight-c notranslate" id="std:topic-mpd_setdigits"><div class="highlight"><pre>void mpd_setdigits(mpd_t *result);

/* Example */
dec-&gt;len = 10;
mpd_setdigits(dec);
mpd_set_negative(dec);
</pre></div>
</div>
Calculate and set digits field. The len field of result is assumed to be correct.
<div class="highlight-c notranslate" id="std:topic-mpd_set_sign"><div class="highlight"><pre>void mpd_set_sign(mpd_t *result, uint8_t sign);
</pre></div>
</div>
Set the sign of result to <code class="xref c c-macro docutils literal notranslate">MPD_POS</code> or <code class="xref c c-macro docutils literal notranslate">MPD_NEG</code>.
<div class="highlight-c notranslate" id="std:topic-mpd_set_positive"><div class="highlight"><pre>void mpd_set_negative(mpd_t *result);
void mpd_set_positive(mpd_t *result);
</pre></div>
</div>
Set the sign of result to negative or positive.
<div class="highlight-c notranslate" id="std:topic-mpd_signcpy"><div class="highlight"><pre>void mpd_signcpy(mpd_t *result, const mpd_t *a);
</pre></div>
</div>
Set the sign of result to the sign of a.
<div class="highlight-c notranslate" id="std:topic-mpd_set_const_data"><div class="highlight"><pre>void mpd_set_dynamic(mpd_t *result);
void mpd_set_static(mpd_t *result);
void mpd_set_dynamic_data(mpd_t *result);
void mpd_set_static_data(mpd_t *result);
void mpd_set_shared_data(mpd_t *result);
void mpd_set_const_data(mpd_t *result);
</pre></div>
</div>
Set memory flags. These functions are only of interest if features from
the section Advanced Memory Handling are used.
<div class="highlight-c notranslate" id="std:topic-mpd_set_snan"><div class="highlight"><pre>/* DEPRECATED */
void mpd_set_infinity(mpd_t *result);
void mpd_set_qnan(mpd_t *result);
void mpd_set_snan(mpd_t *result);
</pre></div>
</div>
All of these functions are deprecated, since they do not set the len and
digits fields of result. It is safer to use <code class="xref c c-func docutils literal notranslate">mpd_setspecial</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="arithmetic.html" title="Arithmetic Functions"
 >next</a></li>
 <li class="right" >
 <a href="assign-convert.html" title="Assignment, Conversions, I/O"
 >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: attributes.html

Upload File

Create Folder