forked from boostorg/integer
Eric Niebler
031a046c7a
https://svn.boost.org/svn/boost/trunk ........ r40816 | nasonov | 2007-11-05 14:22:48 -0800 (Mon, 05 Nov 2007) | 1 line #839 fixed: local variable shadow patch ........ r40817 | danmarsden | 2007-11-05 14:24:53 -0800 (Mon, 05 Nov 2007) | 1 line fixed spelling mistake in documentation ........ r40818 | noel_belcourt | 2007-11-05 14:39:49 -0800 (Mon, 05 Nov 2007) | 3 lines Commit patch submitted by John Maddock. ........ r40819 | grafik | 2007-11-05 14:48:41 -0800 (Mon, 05 Nov 2007) | 1 line Add missing action for --skip-tests option since it's a boolean flag. ........ r40820 | grafik | 2007-11-05 14:49:09 -0800 (Mon, 05 Nov 2007) | 1 line Oops, forgot a comma. ........ r40822 | djowel | 2007-11-05 17:44:49 -0800 (Mon, 05 Nov 2007) | 1 line fix for real number parsers with custom types that do not have a std::numeric_limits specialization. ........ r40824 | bemandawes | 2007-11-05 18:29:50 -0800 (Mon, 05 Nov 2007) | 1 line Make message test conditional for Windows, Linux, HP-UX, OSF, and VMS (Boris Gubenko) ........ r40825 | bemandawes | 2007-11-05 18:54:29 -0800 (Mon, 05 Nov 2007) | 1 line Remove prematurely committed portion of prior change ........ r40827 | djowel | 2007-11-06 02:09:38 -0800 (Tue, 06 Nov 2007) | 1 line doc updates to reflect structure changes ........ r40828 | djowel | 2007-11-06 03:40:27 -0800 (Tue, 06 Nov 2007) | 1 line Regenerating/reorganizing docs ........ r40829 | schoepflin | 2007-11-06 03:52:01 -0800 (Tue, 06 Nov 2007) | 2 lines Again removed markup which has been wrongly reintroduced by @40735. ........ r40830 | djowel | 2007-11-06 03:58:37 -0800 (Tue, 06 Nov 2007) | 1 line doc updates + some more header tweaks ........ r40831 | djowel | 2007-11-06 04:05:12 -0800 (Tue, 06 Nov 2007) | 1 line doc updates + some more header tweaks ........ r40832 | djowel | 2007-11-06 04:13:52 -0800 (Tue, 06 Nov 2007) | 1 line Regenerating/reorganizing docs ........ r40833 | djowel | 2007-11-06 04:17:26 -0800 (Tue, 06 Nov 2007) | 1 line todo update ........ r40834 | bemandawes | 2007-11-06 05:24:38 -0800 (Tue, 06 Nov 2007) | 1 line Add missing Boost.System entry ........ r40835 | bemandawes | 2007-11-06 05:41:19 -0800 (Tue, 06 Nov 2007) | 1 line Add missing copyright and license ........ r40836 | aaron_windsor | 2007-11-06 05:55:05 -0800 (Tue, 06 Nov 2007) | 1 line Renaming planar graph test files to under 32 characters each. ........ r40837 | bemandawes | 2007-11-06 06:22:00 -0800 (Tue, 06 Nov 2007) | 1 line Add license ........ r40838 | joaquin | 2007-11-06 06:33:59 -0800 (Tue, 06 Nov 2007) | 1 line updated according to latest regression tests results ........ r40840 | bemandawes | 2007-11-06 08:10:11 -0800 (Tue, 06 Nov 2007) | 1 line Add repository URL and revision number, plus other minor tweaks and fixes. ........ r40841 | igaztanaga | 2007-11-06 08:56:28 -0800 (Tue, 06 Nov 2007) | 1 line Corrected _CRT_SECURE_NO_DEPRECATE detection ........ r40842 | igaztanaga | 2007-11-06 08:56:48 -0800 (Tue, 06 Nov 2007) | 1 line Initialized native handle to avoid warnings in Visual2005 ........ r40843 | johnmaddock | 2007-11-06 08:58:46 -0800 (Tue, 06 Nov 2007) | 1 line Disabled static assertions for compilers that don't support them. ........ r40844 | johnmaddock | 2007-11-06 09:02:26 -0800 (Tue, 06 Nov 2007) | 1 line Still trying to get the Solaris error rates correct. ........ r40845 | johnmaddock | 2007-11-06 09:09:33 -0800 (Tue, 06 Nov 2007) | 1 line Still trying to get those Solaris error rates correct. ........ r40846 | anthonyw | 2007-11-06 09:15:50 -0800 (Tue, 06 Nov 2007) | 1 line use condition so we know when threads have unblocked, to avoid hard-coding a delay ........ r40847 | johnmaddock | 2007-11-06 09:21:28 -0800 (Tue, 06 Nov 2007) | 1 line Fix for Mac OS error rates. ........ r40848 | johnmaddock | 2007-11-06 10:32:57 -0800 (Tue, 06 Nov 2007) | 1 line Updates for new toolset Sun-5.9. ........ r40850 | hljin | 2007-11-06 11:15:03 -0800 (Tue, 06 Nov 2007) | 1 line GIL: removed an extra semi-colon and made some cosmetic changes ........ [SVN r40851]
133 lines
6.1 KiB
HTML
133 lines
6.1 KiB
HTML
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN">
|
|
<html>
|
|
<head>
|
|
<title>Boost Integer Library</title>
|
|
</head>
|
|
|
|
<body bgcolor="white" text="black">
|
|
<table border="1" bgcolor="teal" cellpadding="2">
|
|
<tr>
|
|
<td bgcolor="white"><img src="../../boost.png" alt="boost.png (6897 bytes)" width="277" height="86"></td>
|
|
<td><a href="../../index.htm"><font face="Arial" color="white"><big>Home</big></font></a></td>
|
|
<td><a href="../libraries.htm"><font face="Arial" color="white"><big>Libraries</big></font></a></td>
|
|
<td><a href="../../people/people.htm"><font face="Arial" color="white"><big>People</big></font></a></td>
|
|
<td><a href="../../more/faq.htm"><font face="Arial" color="white"><big>FAQ</big></font></a></td>
|
|
<td><a href="../../more/index.htm"><font face="Arial" color="white"><big>More</big></font></a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<h1>Boost Integer Library</h1>
|
|
|
|
<table border="1" cellpadding="5">
|
|
<tr>
|
|
<th>Header / Docs</th>
|
|
<th>Contents</th>
|
|
<th>Use</th>
|
|
</tr>
|
|
<tr>
|
|
<td align="center"><cite><a href="../../boost/integer_fwd.hpp"><boost/integer_fwd.hpp></a></cite></td>
|
|
<td valign="top">Forward declarations of classes and class templates</td>
|
|
<td valign="top">When just the name of a class is needed</td>
|
|
</tr>
|
|
<tr>
|
|
<td align="center"><code><a href="../../boost/cstdint.hpp"><boost/cstdint.hpp><br>
|
|
</a></code><a href="cstdint.htm"><br>
|
|
documentation</a>
|
|
</td>
|
|
<td valign="top">Typedef's based on the 1999 C Standard header <<code>stdint.h></code>, wrapped in namespace boost.
|
|
This implementation may #include the compiler
|
|
supplied <<code>stdint.h></code>, if present. </td>
|
|
<td valign="top">Supplies typedefs for standard integer types such as <code> int32_t</code> or <code>uint_least16_t</code>.
|
|
Use in preference to <<code>stdint.h></code>
|
|
for enhanced portability. Furthermore, all names are safely placed in the boost namespace.</td>
|
|
</tr>
|
|
<tr>
|
|
<td align="center"><code><a href="../../boost/integer_traits.hpp"><boost/integer_traits.hpp></a></code><br>
|
|
<br>
|
|
<a href="integer_traits.html">documentation</a>
|
|
</td>
|
|
<td valign="top">Template class <code>boost::integer_traits</code>, derived from <code>std::numeric_limits</code>.
|
|
Adds <code>const_min</code> and <code>const_max</code> members.</td>
|
|
<td valign="top">Use to obtain the characteristics of a known integer type.</td>
|
|
</tr>
|
|
<tr>
|
|
<td align="center"><code><a href="../../boost/integer.hpp"><boost/integer.hpp></a><br>
|
|
<br>
|
|
</code><a href="integer.htm">documentation</a></td>
|
|
<td valign="top">Templates for integer type selection based on properties such as
|
|
maximum value or number of bits.</td>
|
|
<td valign="top">Use to select the type an integer when some property such as maximum value or number of bits is known.
|
|
Useful for generic programming. </td>
|
|
</tr>
|
|
<tr>
|
|
<td align="center"><code><a href="../../boost/integer/integer_mask.hpp"><boost/integer/integer_mask.hpp></a><br>
|
|
<br>
|
|
</code><a href="doc/integer_mask.html">documentation</a></td>
|
|
<td valign="top">Templates for the selection of integer masks, single or lowest group, based on the number of bits.</td>
|
|
<td valign="top">Use to select a particular mask when the bit position(s) are based on a compile-time variable.
|
|
Useful for generic programming. </td>
|
|
</tr>
|
|
<tr>
|
|
<td align="center"><code><a href="../../boost/integer/static_log2.hpp"><boost/integer/static_log2.hpp></a><br>
|
|
<br>
|
|
</code><a href="doc/static_log2.html">documentation</a></td>
|
|
<td valign="top">Template for finding the highest power of two in a number.</td>
|
|
<td valign="top">Use to find the bit-size/range based on a maximum value.
|
|
Useful for generic programming. </td>
|
|
</tr>
|
|
<tr>
|
|
<td align="center"><code><a href="../../boost/integer/static_min_max.hpp"><boost/integer/static_min_max.hpp></a><br>
|
|
<br>
|
|
</code><a href="doc/static_min_max.html">documentation</a></td>
|
|
<td valign="top">Templates for finding the extrema of two numbers.</td>
|
|
<td valign="top">Use to find a bound based on a minimum or maximum value.
|
|
Useful for generic programming. </td>
|
|
</tr>
|
|
</table>
|
|
|
|
<h2>Rationale</h2>
|
|
|
|
<p>The organization of boost integer headers and classes is designed to
|
|
take advantage of <cite><stdint.h></cite> types from the 1999 C
|
|
standard without resorting to undefined behavior in terms of the 1998
|
|
C++ standard. The header <cite><boost/cstdint.hpp></cite> makes
|
|
the standard integer types safely available in namespace
|
|
<code>boost</code> without placing any names in namespace
|
|
<code>std</code>. As always, the intension is to complement rather than
|
|
compete with the C++ Standard Library. Should some future C++ standard
|
|
include <cite><stdint.h></cite> and <cite><cstdint></cite>,
|
|
then <cite><boost/cstdint.hpp></cite> will continue to function,
|
|
but will become redundant and may be safely deprecated.</p>
|
|
|
|
<p>Because these are boost headers, their names conform to boost header
|
|
naming conventions rather than C++ Standard Library header naming
|
|
conventions.</p>
|
|
|
|
<h2><i>Caveat emptor</i></h2>
|
|
|
|
<p>As an implementation artifact, certain C
|
|
<cite><limits.h></cite> macro names may possibly be visible to
|
|
users of <cite><boost/cstdint.hpp></cite>. Don't use these
|
|
macros; they are not part of any Boost-specified interface. Use
|
|
<code>boost::integer_traits<></code> or
|
|
<code>std::numeric_limits<></code> instead.</p>
|
|
|
|
<p>As another implementation artifact, certain C
|
|
<cite><stdint.h></cite> typedef names may possibly be visible in
|
|
the global namespace to users of <cite><boost/cstdint.hpp></cite>.
|
|
Don't use these names, they are not part of any Boost-specified
|
|
interface. Use the respective names in namespace <code>boost</code>
|
|
instead.</p>
|
|
|
|
<hr>
|
|
|
|
<p>Revised: <!--webbot bot="Timestamp" S-Type="EDITED" S-Format="%d %b %Y" startspan -->06 Nov 2007<!--webbot bot="Timestamp" endspan i-checksum="15272" -->
|
|
</p>
|
|
|
|
<p>© Copyright Beman Dawes 2003</p>
|
|
|
|
<p>Distributed under the Boost Software License, Version 1.0. See
|
|
<a href="http://www.boost.org/LICENSE_1_0.txt">www.boost.org/LICENSE_1_0.txt</a></p>
|
|
|
|
</body>
|
|
</html> |