forked from boostorg/integer
80 lines
3.9 KiB
HTML
80 lines
3.9 KiB
HTML
<html>
|
|
|
|
<head>
|
|
<meta http-equiv="Content-Type" content="text/html; charset=windows-1252">
|
|
<meta name="GENERATOR" content="Microsoft FrontPage 4.0">
|
|
<meta name="ProgId" content="FrontPage.Editor.Document">
|
|
<title>Header boost/cstdint.hpp</title>
|
|
</head>
|
|
|
|
<body bgcolor="#FFFFFF" text="#000000">
|
|
|
|
<h1><img src="../../c++boost.gif" alt="c++boost.gif (8819 bytes)" align="center" width="277" height="86">Header
|
|
boost/cstdint.hpp </h1>
|
|
<p>The header <code><a href="../../boost/cstdint.hpp"><boost/cstdint.hpp></a></code>
|
|
places the contents of the header <code><a href="../../boost/stdint.h"><boost/stdint.h></a></code>
|
|
in namespace boost. That header consists entirely of typedef's useful for
|
|
writing portable code that requires certain integer widths.</p>
|
|
<p>The specifications are based on the ISO/IEC 9899:1999 C Language standard
|
|
header stdint.h. The 64-bit types required by the C standard are not
|
|
required in the boost header, and may not be supplied in all implementations,
|
|
because <code>long long</code> is not [yet] included in the C++ standard.</p>
|
|
<p>See <a href="cstdint_test.cpp">cstdint_test.cpp</a> for a test program.</p>
|
|
<h2>Exact-width integer types</h2>
|
|
<p>The typedef <code>int#_t</code>, with # replaced by the width, designates a
|
|
signed integer type of exactly # bits; <code>int8_t</code> denotes an 8-bit
|
|
signed integer type. Similarly, the typedef <code>uint#_t</code>
|
|
designates and unsigned integer type of exactly # bits.</p>
|
|
<p>These types are optional. However, if an implementation provides integer
|
|
types with widths of 8, 16, 32, or 64 bits, it shall define the corresponding
|
|
typedef names.</p>
|
|
<h2>Minimum-width integer types</h2>
|
|
<p>The typedef <code>int_least#_t</code>, with # replaced by the width,
|
|
designates a signed integer type with a width of at least # bits, such that no
|
|
signed integer type with lesser size has at least the specified width. Thus, <code>int_least32_t</code>
|
|
denotes a signed integer type with a width of at least 32 bits. Similarly, the
|
|
typedef name <code>uint_least#_t</code> designates an unsigned integer type with
|
|
a width of at least # bits, such that no unsigned integer type with lesser size
|
|
has at least the specified width.</p>
|
|
<p>Required minimum-width integer types:</p>
|
|
<ul>
|
|
<li><code>int_least8_t</code></li>
|
|
<li><code>int_least16_t</code></li>
|
|
<li><code>int_least32_t</code></li>
|
|
<li><code>uint_least8_t</code></li>
|
|
<li><code>uint_least16_t</code></li>
|
|
<li><code>uint_least32_t</code></li>
|
|
</ul>
|
|
<p>All other minimum-width integer types are optional.</p>
|
|
<h2>Fastest minimum-width integer types</h2>
|
|
<p>The typedef <code>int_fast#_t</code>, with # replaced by the width,
|
|
designates the fastest signed integer type with a width of at least # bits.
|
|
Similarly, the typedef name <code>uint_fast#_t</code> designates the fastest
|
|
unsigned integer type with a width of at least # bits.</p>
|
|
<p>There is no guarantee that these types are fastest for all purposes. In
|
|
any case, however, they satisfy the signedness and width requirements.</p>
|
|
<p>Required fastest minimum-width integer types:</p>
|
|
<ul>
|
|
<li><code>int_fast8_t</code></li>
|
|
<li><code>int_fast16_t</code></li>
|
|
<li><code>int_fast32_t</code></li>
|
|
<li><code>uint_fast8_t</code></li>
|
|
<li><code>uint_fast16_t</code></li>
|
|
<li><code>uint_fast32_t</code></li>
|
|
</ul>
|
|
<p>All other fastest minimum-width integer types are optional.</p>
|
|
<h2>Greatest-width integer types</h2>
|
|
<p>The typedef <code>intmax_t </code>designates a signed integer type capable of
|
|
representing any value of any signed integer type.</p>
|
|
<p>The typedef <code>uintmax_t</code> designates an unsigned integer type
|
|
capable of representing any value of any unsigned integer type.</p>
|
|
<p>These types are required.</p>
|
|
<hr>
|
|
<p>Revised <!--webbot bot="Timestamp" s-type="EDITED" s-format="%d %b %Y" startspan -->29 Jun 2000<!--webbot bot="Timestamp" endspan i-checksum="15060" -->
|
|
</p>
|
|
<p> </p>
|
|
|
|
</body>
|
|
|
|
</html>
|