2009-11-25 12:38:09 +00:00
|
|
|
<html>
|
|
|
|
|
<head>
|
2009-11-27 11:13:02 +00:00
|
|
|
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
|
2009-11-25 12:38:09 +00:00
|
|
|
<title>Boost.Integer</title>
|
2010-07-08 20:50:29 +00:00
|
|
|
<link rel="stylesheet" href="../../../../doc/src/boostbook.css" type="text/css">
|
2018-11-02 13:45:45 -06:00
|
|
|
<meta name="generator" content="DocBook XSL Stylesheets V1.79.1">
|
2009-11-25 12:38:09 +00:00
|
|
|
<link rel="home" href="index.html" title="Boost.Integer">
|
2014-06-01 20:56:15 +01:00
|
|
|
<link rel="next" href="boost_integer/traits.html" title="Integer Traits">
|
2009-11-25 12:38:09 +00:00
|
|
|
</head>
|
|
|
|
|
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
|
|
|
|
|
<table cellpadding="2" width="100%"><tr>
|
|
|
|
|
<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../boost.png"></td>
|
|
|
|
|
<td align="center"><a href="../../../../index.html">Home</a></td>
|
|
|
|
|
<td align="center"><a href="../../../../libs/libraries.htm">Libraries</a></td>
|
|
|
|
|
<td align="center"><a href="http://www.boost.org/users/people.html">People</a></td>
|
|
|
|
|
<td align="center"><a href="http://www.boost.org/users/faq.html">FAQ</a></td>
|
|
|
|
|
<td align="center"><a href="../../../../more/index.htm">More</a></td>
|
|
|
|
|
</tr></table>
|
|
|
|
|
<hr>
|
2014-06-01 20:56:15 +01:00
|
|
|
<div class="spirit-nav"><a accesskey="n" href="boost_integer/traits.html"><img src="../../../../doc/src/images/next.png" alt="Next"></a></div>
|
2010-07-08 20:50:29 +00:00
|
|
|
<div class="article">
|
2009-11-25 12:38:09 +00:00
|
|
|
<div class="titlepage">
|
|
|
|
|
<div>
|
|
|
|
|
<div><h2 class="title">
|
|
|
|
|
<a name="boost_integer"></a>Boost.Integer</h2></div>
|
|
|
|
|
<div><div class="authorgroup">
|
|
|
|
|
<div class="author"><h3 class="author">
|
|
|
|
|
<span class="firstname">Beman</span> <span class="surname">Dawes</span>
|
|
|
|
|
</h3></div>
|
|
|
|
|
<div class="author"><h3 class="author">
|
|
|
|
|
<span class="firstname">Daryle</span> <span class="surname">Walker</span>
|
|
|
|
|
</h3></div>
|
|
|
|
|
<div class="author"><h3 class="author">
|
|
|
|
|
<span class="firstname">Gennaro</span> <span class="surname">Prota</span>
|
|
|
|
|
</h3></div>
|
|
|
|
|
<div class="author"><h3 class="author">
|
|
|
|
|
<span class="firstname">John</span> <span class="surname">Maddock</span>
|
|
|
|
|
</h3></div>
|
|
|
|
|
</div></div>
|
2014-06-01 09:59:12 -07:00
|
|
|
<div><p class="copyright">Copyright © 2001-2009 Beman
|
|
|
|
|
Dawes, Daryle Walker, Gennaro Prota, John Maddock</p></div>
|
2010-07-08 20:50:29 +00:00
|
|
|
<div><div class="legalnotice">
|
2014-06-01 09:59:12 -07:00
|
|
|
<a name="boost_integer.legal"></a><p>
|
2009-11-25 12:38:09 +00:00
|
|
|
Distributed under the Boost Software License, Version 1.0. (See accompanying
|
|
|
|
|
file LICENSE_1_0.txt or copy at <a href="http://www.boost.org/LICENSE_1_0.txt" target="_top">http://www.boost.org/LICENSE_1_0.txt</a>)
|
|
|
|
|
</p>
|
|
|
|
|
</div></div>
|
|
|
|
|
</div>
|
|
|
|
|
<hr>
|
|
|
|
|
</div>
|
|
|
|
|
<div class="toc">
|
|
|
|
|
<p><b>Table of Contents</b></p>
|
2018-11-02 13:45:45 -06:00
|
|
|
<dl class="toc">
|
2014-06-01 09:59:12 -07:00
|
|
|
<dt><span class="section"><a href="index.html#boost_integer.overview">Overview</a></span></dt>
|
|
|
|
|
<dt><span class="section"><a href="boost_integer/traits.html">Integer Traits</a></span></dt>
|
|
|
|
|
<dt><span class="section"><a href="boost_integer/integer.html">Integer Type Selection</a></span></dt>
|
2017-04-24 13:01:57 +01:00
|
|
|
<dt><span class="section"><a href="boost_integer/gcd_lcm.html">Greatest Common Divisor and Least
|
|
|
|
|
Common Multiple</a></span></dt>
|
2018-11-02 13:45:45 -06:00
|
|
|
<dt><span class="section"><a href="boost_integer/extended_euclidean.html">Extended Euclidean Algorithm</a></span></dt>
|
|
|
|
|
<dt><span class="section"><a href="boost_integer/mod_inverse.html">Modular Multiplicative Inverse</a></span></dt>
|
2014-06-01 09:59:12 -07:00
|
|
|
<dt><span class="section"><a href="boost_integer/mask.html">Integer Masks</a></span></dt>
|
|
|
|
|
<dt><span class="section"><a href="boost_integer/log2.html">Compile Time log2 Calculation</a></span></dt>
|
|
|
|
|
<dt><span class="section"><a href="boost_integer/minmax.html">Compile time min/max calculation</a></span></dt>
|
|
|
|
|
<dt><span class="section"><a href="boost_integer/history.html">History</a></span></dt>
|
2014-06-01 20:56:15 +01:00
|
|
|
<dt><span class="section"><a href="boost_integer/cstdint.html">Removed from library: Standard Integer
|
|
|
|
|
Types</a></span></dt>
|
2009-11-25 12:38:09 +00:00
|
|
|
</dl>
|
|
|
|
|
</div>
|
2010-07-08 20:50:29 +00:00
|
|
|
<div class="section">
|
2009-11-25 12:38:09 +00:00
|
|
|
<div class="titlepage"><div><div><h2 class="title" style="clear: both">
|
2014-06-01 09:59:12 -07:00
|
|
|
<a name="boost_integer.overview"></a><a class="link" href="index.html#boost_integer.overview" title="Overview">Overview</a>
|
2009-11-25 12:38:09 +00:00
|
|
|
</h2></div></div></div>
|
|
|
|
|
<p>
|
2009-11-28 17:08:31 +00:00
|
|
|
Boost.Integer provides integer type support, particularly helpful in generic
|
2014-06-01 09:59:12 -07:00
|
|
|
programming. It provides the means to select an integer type based upon its
|
|
|
|
|
properties, like the number of bits or the maximum supported value, as well
|
|
|
|
|
as compile-time bit mask selection. There is a derivative of std::numeric_limits
|
|
|
|
|
that provides integral constant expressions for <code class="computeroutput"><span class="identifier">min</span></code>
|
|
|
|
|
and <code class="computeroutput"><span class="identifier">max</span></code>. Finally, it provides
|
|
|
|
|
two compile-time algorithms: determining the highest power of two in a compile-time
|
|
|
|
|
value; and computing min and max of constant expressions.
|
2009-11-25 12:38:09 +00:00
|
|
|
</p>
|
|
|
|
|
<div class="informaltable"><table class="table">
|
|
|
|
|
<colgroup>
|
|
|
|
|
<col>
|
|
|
|
|
<col>
|
|
|
|
|
<col>
|
|
|
|
|
</colgroup>
|
|
|
|
|
<thead><tr>
|
|
|
|
|
<th>
|
2010-04-05 07:27:25 +00:00
|
|
|
<p>
|
|
|
|
|
Component
|
|
|
|
|
</p>
|
2009-11-25 12:38:09 +00:00
|
|
|
</th>
|
|
|
|
|
<th>
|
2010-04-05 07:27:25 +00:00
|
|
|
<p>
|
|
|
|
|
Header
|
|
|
|
|
</p>
|
2009-11-25 12:38:09 +00:00
|
|
|
</th>
|
|
|
|
|
<th>
|
2010-04-05 07:27:25 +00:00
|
|
|
<p>
|
|
|
|
|
Purpose
|
|
|
|
|
</p>
|
2009-11-25 12:38:09 +00:00
|
|
|
</th>
|
|
|
|
|
</tr></thead>
|
|
|
|
|
<tbody>
|
|
|
|
|
<tr>
|
|
|
|
|
<td>
|
2010-04-05 07:27:25 +00:00
|
|
|
<p>
|
|
|
|
|
Forward Declarations.
|
|
|
|
|
</p>
|
2009-11-25 12:38:09 +00:00
|
|
|
</td>
|
|
|
|
|
<td>
|
2010-04-05 07:27:25 +00:00
|
|
|
<p>
|
|
|
|
|
<code class="literal"><a href="../../../../boost/integer_fwd.hpp" target="_top"><boost/integer_fwd.hpp></a></code>
|
|
|
|
|
</p>
|
2009-11-25 12:38:09 +00:00
|
|
|
</td>
|
|
|
|
|
<td>
|
2010-04-05 07:27:25 +00:00
|
|
|
<p>
|
|
|
|
|
Forward declarations of classes and class templates - for use when
|
|
|
|
|
just the name of a class is needed.
|
|
|
|
|
</p>
|
2009-11-25 12:38:09 +00:00
|
|
|
</td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td>
|
2010-04-05 07:27:25 +00:00
|
|
|
<p>
|
|
|
|
|
<a class="link" href="boost_integer/traits.html" title="Integer Traits">Integer Traits</a>.
|
|
|
|
|
</p>
|
2009-11-25 12:38:09 +00:00
|
|
|
</td>
|
|
|
|
|
<td>
|
2010-04-05 07:27:25 +00:00
|
|
|
<p>
|
|
|
|
|
<code class="literal"><a href="../../../../boost/integer_traits.hpp" target="_top"><boost/integer_traits.hpp></a></code>
|
|
|
|
|
</p>
|
2009-11-25 12:38:09 +00:00
|
|
|
</td>
|
|
|
|
|
<td>
|
2010-04-05 07:27:25 +00:00
|
|
|
<p>
|
|
|
|
|
Class template <code class="literal">boost::integer_traits</code>, derives
|
|
|
|
|
from <code class="literal">std::numeric_limits</code> and adds <code class="literal">const_min</code>
|
|
|
|
|
and <code class="literal">const_max</code> members.
|
|
|
|
|
</p>
|
2009-11-25 12:38:09 +00:00
|
|
|
</td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td>
|
2010-04-05 07:27:25 +00:00
|
|
|
<p>
|
|
|
|
|
<a class="link" href="boost_integer/integer.html" title="Integer Type Selection">Integer Type Selection</a>.
|
|
|
|
|
</p>
|
2009-11-25 12:38:09 +00:00
|
|
|
</td>
|
|
|
|
|
<td>
|
2010-04-05 07:27:25 +00:00
|
|
|
<p>
|
|
|
|
|
<code class="literal"><a href="../../../../boost/integer.hpp" target="_top"><boost/integer.hpp></a></code>
|
|
|
|
|
</p>
|
2009-11-25 12:38:09 +00:00
|
|
|
</td>
|
|
|
|
|
<td>
|
2010-04-05 07:27:25 +00:00
|
|
|
<p>
|
|
|
|
|
Templates for integer type selection based on properties such as
|
|
|
|
|
maximum value or number of bits: Use to select the type of an integer
|
|
|
|
|
when some property such as maximum value or number of bits is known.
|
|
|
|
|
Useful for generic programming.
|
|
|
|
|
</p>
|
2009-11-25 12:38:09 +00:00
|
|
|
</td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2017-04-24 13:01:57 +01:00
|
|
|
<td>
|
|
|
|
|
<p>
|
|
|
|
|
<a class="link" href="boost_integer/gcd_lcm.html" title="Greatest Common Divisor and Least Common Multiple">Greatest Common Divisor and
|
|
|
|
|
Least Common Multiple</a>.
|
|
|
|
|
</p>
|
|
|
|
|
</td>
|
|
|
|
|
<td>
|
|
|
|
|
<p>
|
|
|
|
|
<code class="literal"><a href="../../../../boost/integer/common_factor_rt.hpp" target="_top"><boost/integer/common_factor_rt.hpp></a></code>
|
|
|
|
|
and <code class="literal"><a href="../../../../boost/integer/common_factor_ct.hpp" target="_top"><boost/integer/common_factor_ct.hpp></a></code>
|
|
|
|
|
</p>
|
|
|
|
|
</td>
|
|
|
|
|
<td>
|
|
|
|
|
<p>
|
|
|
|
|
Functions <code class="computeroutput"><span class="identifier">gcd</span></code> and
|
|
|
|
|
<code class="computeroutput"><span class="identifier">lcm</span></code> plus function
|
|
|
|
|
objects and compile time versions.
|
|
|
|
|
</p>
|
|
|
|
|
</td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2009-11-25 12:38:09 +00:00
|
|
|
<td>
|
2010-04-05 07:27:25 +00:00
|
|
|
<p>
|
|
|
|
|
<a class="link" href="boost_integer/mask.html" title="Integer Masks">Integer Masks</a>.
|
|
|
|
|
</p>
|
2009-11-25 12:38:09 +00:00
|
|
|
</td>
|
|
|
|
|
<td>
|
2010-04-05 07:27:25 +00:00
|
|
|
<p>
|
|
|
|
|
<code class="literal"><a href="../../../../boost/integer/integer_mask.hpp" target="_top"><boost/integer/integer_mask.hpp></a></code>
|
|
|
|
|
</p>
|
2009-11-25 12:38:09 +00:00
|
|
|
</td>
|
|
|
|
|
<td>
|
2010-04-05 07:27:25 +00:00
|
|
|
<p>
|
|
|
|
|
Templates for the selection of integer masks, single or lowest group,
|
|
|
|
|
based on the number of bits: Use to select a particular mask when
|
|
|
|
|
the bit position(s) are based on a compile-time variable. Useful
|
|
|
|
|
for generic programming.
|
|
|
|
|
</p>
|
2009-11-25 12:38:09 +00:00
|
|
|
</td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td>
|
2010-04-05 07:27:25 +00:00
|
|
|
<p>
|
|
|
|
|
<a class="link" href="boost_integer/log2.html" title="Compile Time log2 Calculation">Compile time log2 Calculation</a>.
|
|
|
|
|
</p>
|
2009-11-25 12:38:09 +00:00
|
|
|
</td>
|
|
|
|
|
<td>
|
2010-04-05 07:27:25 +00:00
|
|
|
<p>
|
|
|
|
|
<code class="literal"><a href="../../../../boost/integer/static_log2.hpp" target="_top"><boost/integer/static_log2.hpp></a></code>
|
|
|
|
|
</p>
|
2009-11-25 12:38:09 +00:00
|
|
|
</td>
|
|
|
|
|
<td>
|
2010-04-05 07:27:25 +00:00
|
|
|
<p>
|
|
|
|
|
Template for finding the highest power of two in a number: Use to
|
|
|
|
|
find the bit-size/range based on a maximum value. Useful for generic
|
|
|
|
|
programming.
|
|
|
|
|
</p>
|
2009-11-25 12:38:09 +00:00
|
|
|
</td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td>
|
2010-04-05 07:27:25 +00:00
|
|
|
<p>
|
|
|
|
|
<a class="link" href="boost_integer/minmax.html" title="Compile time min/max calculation">Compile time min/max calculation</a>.
|
|
|
|
|
</p>
|
2009-11-25 12:38:09 +00:00
|
|
|
</td>
|
|
|
|
|
<td>
|
2010-04-05 07:27:25 +00:00
|
|
|
<p>
|
|
|
|
|
<code class="literal"><a href="../../../../boost/integer/static_min_max.hpp" target="_top"><boost/integer/static_min_max.hpp></a></code>
|
|
|
|
|
</p>
|
2009-11-25 12:38:09 +00:00
|
|
|
</td>
|
|
|
|
|
<td>
|
2010-04-05 07:27:25 +00:00
|
|
|
<p>
|
|
|
|
|
Templates for finding the extrema of two numbers: Use to find a bound
|
|
|
|
|
based on a minimum or maximum value. Useful for generic programming.
|
|
|
|
|
</p>
|
2009-11-25 12:38:09 +00:00
|
|
|
</td>
|
|
|
|
|
</tr>
|
2018-11-02 13:45:45 -06:00
|
|
|
<tr>
|
|
|
|
|
<td>
|
|
|
|
|
<p>
|
|
|
|
|
<a class="link" href="boost_integer/extended_euclidean.html" title="Extended Euclidean Algorithm">Extended Euclidean
|
|
|
|
|
algorithm</a>.
|
|
|
|
|
</p>
|
|
|
|
|
</td>
|
|
|
|
|
<td>
|
|
|
|
|
<p>
|
|
|
|
|
<code class="literal"><a href="../../../../boost/integer/extended_euclidean.hpp" target="_top"><boost/integer/extended_euclidean.hpp></a></code>
|
|
|
|
|
</p>
|
|
|
|
|
</td>
|
|
|
|
|
<td>
|
|
|
|
|
<p>
|
|
|
|
|
Solves <span class="emphasis"><em>mx + ny = gcd(x,y)</em></span> for <span class="emphasis"><em>x</em></span>
|
|
|
|
|
and <span class="emphasis"><em>y</em></span>.
|
|
|
|
|
</p>
|
|
|
|
|
</td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td>
|
|
|
|
|
<p>
|
|
|
|
|
<a class="link" href="boost_integer/mod_inverse.html" title="Modular Multiplicative Inverse">Modular multiplicative
|
|
|
|
|
inverse</a>.
|
|
|
|
|
</p>
|
|
|
|
|
</td>
|
|
|
|
|
<td>
|
|
|
|
|
<p>
|
|
|
|
|
<code class="literal"><a href="../../../../boost/integer/mod_inverse.hpp" target="_top"><boost/integer/mod_inverse.hpp></a></code>
|
|
|
|
|
</p>
|
|
|
|
|
</td>
|
|
|
|
|
<td>
|
|
|
|
|
<p>
|
|
|
|
|
Given <span class="emphasis"><em>a</em></span> and <span class="emphasis"><em>m</em></span>, solves
|
|
|
|
|
<span class="emphasis"><em>ax</em></span> = 1 mod <span class="emphasis"><em>m</em></span> for <span class="emphasis"><em>x</em></span>.
|
|
|
|
|
</p>
|
|
|
|
|
</td>
|
|
|
|
|
</tr>
|
2009-11-25 12:38:09 +00:00
|
|
|
</tbody>
|
|
|
|
|
</table></div>
|
|
|
|
|
</div>
|
|
|
|
|
</div>
|
|
|
|
|
<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
|
2018-11-02 13:45:45 -06:00
|
|
|
<td align="left"><p><small>Last revised: November 02, 2018 at 19:38:28 GMT</small></p></td>
|
2009-11-25 12:38:09 +00:00
|
|
|
<td align="right"><div class="copyright-footer"></div></td>
|
|
|
|
|
</tr></table>
|
|
|
|
|
<hr>
|
2014-06-01 20:56:15 +01:00
|
|
|
<div class="spirit-nav"><a accesskey="n" href="boost_integer/traits.html"><img src="../../../../doc/src/images/next.png" alt="Next"></a></div>
|
2009-11-25 12:38:09 +00:00
|
|
|
</body>
|
|
|
|
|
</html>
|
