Boost-Commit :

Date view	Thread view	Subject view	Author view

Subject: [Boost-commit] svn:boost r75596 - in branches/release/libs/numeric/conversion/doc/html: . boost_numericconversion numeric_conversion
From: blkohn_at_[hidden]
Date: 2011-11-21 11:46:58

Next message: john_at_[hidden]: "[Boost-commit] svn:boost r75597 - sandbox/big_number/boost/multiprecision"
Previous message: joel_at_[hidden]: "[Boost-commit] svn:boost r75595 - in trunk/boost/fusion/container/vector: . detail/preprocessed"

Author: brandon.kohn
Date: 2011-11-21 11:46:56 EST (Mon, 21 Nov 2011)
New Revision: 75596
URL: http://svn.boost.org/trac/boost/changeset/75596

Log:
Missed imports to numeric_cast_traits docs.
Text files modified:
   branches/release/libs/numeric/conversion/doc/html/boost_numericconversion/bounds___traits_class.html | 102 +--
   branches/release/libs/numeric/conversion/doc/html/boost_numericconversion/conversion_traits___traits_class.html | 399 ++++++++---------
   branches/release/libs/numeric/conversion/doc/html/boost_numericconversion/converter___function_object.html | 396 +++++++---------
   branches/release/libs/numeric/conversion/doc/html/boost_numericconversion/definitions.html | 911 +++++++++++++++++++++------------------
   branches/release/libs/numeric/conversion/doc/html/boost_numericconversion/improved_numeric_cast__.html | 156 ++++--
   branches/release/libs/numeric/conversion/doc/html/boost_numericconversion/numeric_converter_policy_classes.html | 181 +++----
   branches/release/libs/numeric/conversion/doc/html/boost_numericconversion/type_requirements_and_user_defined_types_support.html | 521 +++++++++++++++++++---
   branches/release/libs/numeric/conversion/doc/html/index.html | 90 ++-
   branches/release/libs/numeric/conversion/doc/html/numeric_conversion/bibliography.html | 129 +++--
   branches/release/libs/numeric/conversion/doc/html/numeric_conversion/history_and_acknowledgments.html | 121 ++--
   10 files changed, 1722 insertions(+), 1284 deletions(-)

Modified: branches/release/libs/numeric/conversion/doc/html/boost_numericconversion/bounds___traits_class.html
==============================================================================
--- branches/release/libs/numeric/conversion/doc/html/boost_numericconversion/bounds___traits_class.html (original)
+++ branches/release/libs/numeric/conversion/doc/html/boost_numericconversion/bounds___traits_class.html 2011-11-21 11:46:56 EST (Mon, 21 Nov 2011)
@@ -1,43 +1,37 @@
<html>
<head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<title>bounds<> traits class</title>
<link rel="stylesheet" href="../boostbook.css" type="text/css">
-<meta name="generator" content="DocBook XSL Stylesheets V1.75.2">
-<link rel="home" href="../index.html" title="Chapter 1. Boost.NumericConversion">
-<link rel="up" href="../index.html" title="Chapter 1. Boost.NumericConversion">
-<link rel="prev" href="type_requirements_and_user_defined_types_support.html" title="Type Requirements and User-defined-types support">
-<link rel="next" href="conversion_traits___traits_class.html" title="conversion_traits<> traits class">
+<meta name="generator" content="DocBook XSL-NS Stylesheets V1.76.1">
+<link rel="home" href="../index.html" title="Chapter 1. Boost.NumericConversion">
+<link rel="up" href="../index.html" title="Chapter 1. Boost.NumericConversion">
</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">Home</td>
-<td align="center">Libraries</td>
+<td align="center">Libraries</td>
<td align="center">People</td>
<td align="center">FAQ</td>
<td align="center">More</td>
</tr></table>
<hr>
<div class="spirit-nav">
-<a accesskey="p" href="type_requirements_and_user_defined_types_support.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="conversion_traits___traits_class.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
+<a accesskey="u" href="../index.html"><img src="../../../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../../../../doc/src/images/home.png" alt="Home"></a>
</div>
-<div class="section" title="bounds<> traits class">
+<div class="section">
<div class="titlepage"><div><div><h2 class="title" style="clear: both">
<a name="boost_numericconversion.bounds___traits_class"></a><a class="link" href="bounds___traits_class.html" title="bounds<> traits class">bounds<>
 traits class</a>
</h2></div></div></div>
-<div class="toc"><dl>
-<dt>Introduction</dt>
-<dt><a href="bounds___traits_class.html#boost_numericconversion.bounds___traits_class.traits_class_bounds_n_">traits
- class bounds<N></a></dt>
-<dt>Examples</dt>
-</dl></div>
-<div class="section" title="Introduction">
+
+ <div class="section">
<div class="titlepage"><div><div><h3 class="title">
<a name="boost_numericconversion.bounds___traits_class.introduction"></a><a class="link" href="bounds___traits_class.html#boost_numericconversion.bounds___traits_class.introduction" title="Introduction">Introduction</a>
</h3></div></div></div>
-
+
+ 
 To determine the ranges of numeric types with <code class="computeroutput">std::numeric_limits</code>
 [18.2.1], different syntax have to be used depending on numeric type. Specifically,
 <code class="computeroutput">numeric_limits<T>::min()</code> for
@@ -45,19 +39,20 @@
 types it returns the minimum positive normalized value. The difference in
 semantics makes client code unnecessarily complex and error prone.
 
-
+ 
 <code class="computeroutput">boost::numeric::bounds<></code>
 provides a consistent interface for retrieving the maximum finite value,
 the minimum finite value and the minimum positive normalized value (0 for
 integral types) for numeric types. The selection of implementation is performed
 at compile time, so there is no runtime overhead.
 
-</div>
-<div class="section" title="traits class bounds<N>">
+ </div>
+ <div class="section">
<div class="titlepage"><div><div><h3 class="title">
<a name="boost_numericconversion.bounds___traits_class.traits_class_bounds_n_"></a><a class="link" href="bounds___traits_class.html#boost_numericconversion.bounds___traits_class.traits_class_bounds_n_" title="traits class bounds<N>">traits
 class bounds<N></a>
</h3></div></div></div>
+
<pre class="programlisting">template<class N>
struct bounds
{
@@ -66,56 +61,45 @@
 static N smallest() { return implementation_defined; }
};
</pre>
-<a name="boost_numericconversion.bounds___traits_class.traits_class_bounds_n_.members"></a><h5>
-<a name="id565414"></a>
- <a class="link" href="bounds___traits_class.html#boost_numericconversion.bounds___traits_class.traits_class_bounds_n_.members">Members</a>
+ <h5>
+<a name="boost_numericconversion.bounds___traits_class.traits_class_bounds_n_.h0"></a>
+ <a name="boost_numericconversion.bounds___traits_class.traits_class_bounds_n_.members"></a><a class="link" href="bounds___traits_class.html#boost_numericconversion.bounds___traits_class.traits_class_bounds_n_.members">Members</a>
 </h5>
-<div class="blockquote"><blockquote class="blockquote">
-
- 
-
- <code class="computeroutput">lowest()</code>
- 
-
+ <div class="blockquote"><blockquote class="blockquote">
+ 
+ <code class="computeroutput">lowest()</code>
 
-</blockquote></div>
-
+ </blockquote></div>
+ 
 Returns the minimum finite value, equivalent to <code class="computeroutput">numeric_limits<T>::min()</code> when
 <code class="computeroutput">T</code> is an integral type, and
 to <code class="computeroutput">-numeric_limits<T>::max()</code> when
 <code class="computeroutput">T</code> is a floating point type.
 
-<div class="blockquote"><blockquote class="blockquote">
-
- 
-
- <code class="computeroutput">highest()</code>
- 
-
+ <div class="blockquote"><blockquote class="blockquote">
+ 
+ <code class="computeroutput">highest()</code>
 
-</blockquote></div>
-
+ </blockquote></div>
+ 
 Returns the maximum finite value, equivalent to <code class="computeroutput">numeric_limits<T>::max()</code>.
 
-<div class="blockquote"><blockquote class="blockquote">
-
- 
-
- <code class="computeroutput">smallest()</code>
- 
-
+ <div class="blockquote"><blockquote class="blockquote">
+ 
+ <code class="computeroutput">smallest()</code>
 
-</blockquote></div>
-
+ </blockquote></div>
+ 
 Returns the smallest positive normalized value for floating point types with
 denormalization, or returns 0 for integral types.
 
-</div>
-<div class="section" title="Examples">
+ </div>
+ <div class="section">
<div class="titlepage"><div><div><h3 class="title">
<a name="boost_numericconversion.bounds___traits_class.examples"></a><a class="link" href="bounds___traits_class.html#boost_numericconversion.bounds___traits_class.examples" title="Examples">Examples</a>
</h3></div></div></div>
-
+
+ 
 The following example demonstrates the use of <code class="computeroutput">numeric::bounds<></code> and the equivalent code using <code class="computeroutput">numeric_limits</code>:
 
<pre class="programlisting">#include <iostream>
@@ -142,19 +126,15 @@
 return 0;
}
</pre>
-</div>
-</div>
+ </div>
+ </div>
<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
<td align="left"></td>
-<td align="right"><div class="copyright-footer">Copyright © 2004 -2007 Fernando Luis Cacciola Carballal
- Distributed under the Boost Software License, Version 1.0. (See accompanying
- file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
- 
-</div></td>
+<td align="right"><div class="copyright-footer"></div></td>
</tr></table>
<hr>
<div class="spirit-nav">
-<a accesskey="p" href="type_requirements_and_user_defined_types_support.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="conversion_traits___traits_class.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
+<a accesskey="u" href="../index.html"><img src="../../../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../../../../doc/src/images/home.png" alt="Home"></a>
</div>
</body>
</html>

Modified: branches/release/libs/numeric/conversion/doc/html/boost_numericconversion/conversion_traits___traits_class.html
==============================================================================
--- branches/release/libs/numeric/conversion/doc/html/boost_numericconversion/conversion_traits___traits_class.html (original)
+++ branches/release/libs/numeric/conversion/doc/html/boost_numericconversion/conversion_traits___traits_class.html 2011-11-21 11:46:56 EST (Mon, 21 Nov 2011)
@@ -1,63 +1,42 @@
<html>
<head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<title>conversion_traits<> traits class</title>
<link rel="stylesheet" href="../boostbook.css" type="text/css">
-<meta name="generator" content="DocBook XSL Stylesheets V1.75.2">
-<link rel="home" href="../index.html" title="Chapter 1. Boost.NumericConversion">
-<link rel="up" href="../index.html" title="Chapter 1. Boost.NumericConversion">
-<link rel="prev" href="bounds___traits_class.html" title="bounds<> traits class">
-<link rel="next" href="numeric_converter_policy_classes.html" title="Numeric Converter Policy Classes">
+<meta name="generator" content="DocBook XSL-NS Stylesheets V1.76.1">
+<link rel="home" href="../index.html" title="Chapter 1. Boost.NumericConversion">
+<link rel="up" href="../index.html" title="Chapter 1. Boost.NumericConversion">
</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">Home</td>
-<td align="center">Libraries</td>
+<td align="center">Libraries</td>
<td align="center">People</td>
<td align="center">FAQ</td>
<td align="center">More</td>
</tr></table>
<hr>
<div class="spirit-nav">
-<a accesskey="p" href="bounds___traits_class.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="numeric_converter_policy_classes.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
+<a accesskey="u" href="../index.html"><img src="../../../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../../../../doc/src/images/home.png" alt="Home"></a>
</div>
-<div class="section" title="conversion_traits<> traits class">
+<div class="section">
<div class="titlepage"><div><div><h2 class="title" style="clear: both">
<a name="boost_numericconversion.conversion_traits___traits_class"></a><a class="link" href="conversion_traits___traits_class.html" title="conversion_traits<> traits class">conversion_traits<>
 traits class</a>
</h2></div></div></div>
-<div class="toc"><dl>
-<dt>Types</dt>
-<dt>Examples</dt>
-</dl></div>
-<div class="section" title="Types">
+
+ <div class="section">
<div class="titlepage"><div><div><h3 class="title">
<a name="boost_numericconversion.conversion_traits___traits_class.types"></a><a class="link" href="conversion_traits___traits_class.html#boost_numericconversion.conversion_traits___traits_class.types" title="Types">Types</a>
</h3></div></div></div>
-<div class="toc"><dl>
-<dt><a href="conversion_traits___traits_class.html#boost_numericconversion.conversion_traits___traits_class.types.enumeration_int_float_mixture_enum">enumeration
- int_float_mixture_enum</a></dt>
-<dt><a href="conversion_traits___traits_class.html#boost_numericconversion.conversion_traits___traits_class.types.enumeration_sign_mixture_enum">enumeration
- sign_mixture_enum</a></dt>
-<dt><a href="conversion_traits___traits_class.html#boost_numericconversion.conversion_traits___traits_class.types.enumeration_udt_builtin_mixture_enum">enumeration
- udt_builtin_mixture_enum</a></dt>
-<dt><a href="conversion_traits___traits_class.html#boost_numericconversion.conversion_traits___traits_class.types.template_class_int_float_mixture__">template
- class int_float_mixture<></a></dt>
-<dt><a href="conversion_traits___traits_class.html#boost_numericconversion.conversion_traits___traits_class.types.template_class_sign_mixture__">template
- class sign_mixture<></a></dt>
-<dt><a href="conversion_traits___traits_class.html#boost_numericconversion.conversion_traits___traits_class.types.template_class_udt_builtin_mixture__">template
- class udt_builtin_mixture<></a></dt>
-<dt><a href="conversion_traits___traits_class.html#boost_numericconversion.conversion_traits___traits_class.types.template_class_is_subranged__">template
- class is_subranged<></a></dt>
-<dt><a href="conversion_traits___traits_class.html#boost_numericconversion.conversion_traits___traits_class.types.template_class_conversion_traits__">template
- class conversion_traits<></a></dt>
-</dl></div>
-<div class="section" title="enumeration int_float_mixture_enum">
+
+ <div class="section">
<div class="titlepage"><div><div><h4 class="title">
<a name="boost_numericconversion.conversion_traits___traits_class.types.enumeration_int_float_mixture_enum"></a><a class="link" href="conversion_traits___traits_class.html#boost_numericconversion.conversion_traits___traits_class.types.enumeration_int_float_mixture_enum" title="enumeration int_float_mixture_enum">enumeration
 int_float_mixture_enum</a>
</h4></div></div></div>
+
<pre class="programlisting">namespace boost { namespace numeric {

 enum int_float_mixture_enum
@@ -68,14 +47,15 @@
 ,float_to_float
 } ;

-} } // namespace boost::numeric
-</pre>
-</div>
-<div class="section" title="enumeration sign_mixture_enum">
+} } // namespace boost::numeric
+</pre>
+ </div>
+ <div class="section">
<div class="titlepage"><div><div><h4 class="title">
<a name="boost_numericconversion.conversion_traits___traits_class.types.enumeration_sign_mixture_enum"></a><a class="link" href="conversion_traits___traits_class.html#boost_numericconversion.conversion_traits___traits_class.types.enumeration_sign_mixture_enum" title="enumeration sign_mixture_enum">enumeration
 sign_mixture_enum</a>
</h4></div></div></div>
+
<pre class="programlisting">namespace boost { namespace numeric {

enum sign_mixture_enum
@@ -86,14 +66,15 @@
 ,unsigned_to_signed
} ;

-} } // namespace boost::numeric
-</pre>
-</div>
-<div class="section" title="enumeration udt_builtin_mixture_enum">
+} } // namespace boost::numeric
+</pre>
+ </div>
+ <div class="section">
<div class="titlepage"><div><div><h4 class="title">
<a name="boost_numericconversion.conversion_traits___traits_class.types.enumeration_udt_builtin_mixture_enum"></a><a class="link" href="conversion_traits___traits_class.html#boost_numericconversion.conversion_traits___traits_class.types.enumeration_udt_builtin_mixture_enum" title="enumeration udt_builtin_mixture_enum">enumeration
 udt_builtin_mixture_enum</a>
</h4></div></div></div>
+
<pre class="programlisting">namespace boost { namespace numeric {

 enum udt_builtin_mixture_enum
@@ -104,108 +85,113 @@
 ,udt_to_udt
 } ;

-} } // namespace boost::numeric
-</pre>
-</div>
-<div class="section" title="template class int_float_mixture<>">
+} } // namespace boost::numeric
+</pre>
+ </div>
+ <div class="section">
<div class="titlepage"><div><div><h4 class="title">
<a name="boost_numericconversion.conversion_traits___traits_class.types.template_class_int_float_mixture__"></a><a class="link" href="conversion_traits___traits_class.html#boost_numericconversion.conversion_traits___traits_class.types.template_class_int_float_mixture__" title="template class int_float_mixture<>">template
 class int_float_mixture<></a>
</h4></div></div></div>
+
<pre class="programlisting">namespace boost { namespace numeric {

 template <class T, class S>
 struct int_float_mixture : mpl::integral_c<int_float_mixture_enum, impl-def-value> {} ;

-} } // namespace boost::numeric
-</pre>
-
+} } // namespace boost::numeric
+</pre>
+ 
 Classifying <code class="computeroutput">S</code> and <code class="computeroutput">T</code> as either integral or float, this
- <a href="../../../../../mpl/doc/refmanual/integral-constant.html" target="_top">MPL's
+ <a class="ulink" href="../../../../mpl/doc/refmanual/integral-constant.html" target="_top">MPL's
 Integral Constant</a> indicates the combination of these attributes.
 
-
+ 
 Its <code class="computeroutput">::value</code>
 is of enumeration type <a class="link" href="conversion_traits___traits_class.html#boost_numericconversion.conversion_traits___traits_class.types.enumeration_int_float_mixture_enum" title="enumeration int_float_mixture_enum"><code class="computeroutput">boost::numeric::int_float_mixture_enum</code></a>
 
-</div>
-<div class="section" title="template class sign_mixture<>">
+ </div>
+ <div class="section">
<div class="titlepage"><div><div><h4 class="title">
<a name="boost_numericconversion.conversion_traits___traits_class.types.template_class_sign_mixture__"></a><a class="link" href="conversion_traits___traits_class.html#boost_numericconversion.conversion_traits___traits_class.types.template_class_sign_mixture__" title="template class sign_mixture<>">template
 class sign_mixture<></a>
</h4></div></div></div>
+
<pre class="programlisting">namespace boost { namespace numeric {

 template <class T, class S>
 struct sign_mixture : mpl::integral_c<sign_mixture_enum, impl-def-value> {} ;

-} } // namespace boost::numeric
-</pre>
-
+} } // namespace boost::numeric
+</pre>
+ 
 Classifying <code class="computeroutput">S</code> and <code class="computeroutput">T</code> as either signed or unsigned, this
- <a href="../../../../../mpl/doc/refmanual/integral-constant.html" target="_top">MPL's
+ <a class="ulink" href="../../../../mpl/doc/refmanual/integral-constant.html" target="_top">MPL's
 Integral Constant</a> indicates the combination of these attributes.
 
-
+ 
 Its <code class="computeroutput">::value</code>
 is of enumeration type <a class="link" href="conversion_traits___traits_class.html#boost_numericconversion.conversion_traits___traits_class.types.enumeration_sign_mixture_enum" title="enumeration sign_mixture_enum"><code class="computeroutput">boost::numeric::sign_mixture_enum</code></a>
 
-</div>
-<div class="section" title="template class udt_builtin_mixture<>">
+ </div>
+ <div class="section">
<div class="titlepage"><div><div><h4 class="title">
<a name="boost_numericconversion.conversion_traits___traits_class.types.template_class_udt_builtin_mixture__"></a><a class="link" href="conversion_traits___traits_class.html#boost_numericconversion.conversion_traits___traits_class.types.template_class_udt_builtin_mixture__" title="template class udt_builtin_mixture<>">template
 class udt_builtin_mixture<></a>
</h4></div></div></div>
+
<pre class="programlisting">namespace boost { namespace numeric {

 template <class T, class S>
 struct udt_builtin_mixture : mpl::integral_c<udt_builtin__mixture_enum, impl-def-value> {} ;

-} } // namespace boost::numeric
-</pre>
-
+} } // namespace boost::numeric
+</pre>
+ 
 Classifying <code class="computeroutput">S</code> and <code class="computeroutput">T</code> as either user-defined or builtin,
- this <a href="../../../../../mpl/doc/refmanual/integral-constant.html" target="_top">MPL's
+ this <a class="ulink" href="../../../../mpl/doc/refmanual/integral-constant.html" target="_top">MPL's
 Integral Constant</a> indicates the combination of these attributes.
 
-
+ 
 Its <code class="computeroutput">::value</code>
 is of enumeration type <a class="link" href="conversion_traits___traits_class.html#boost_numericconversion.conversion_traits___traits_class.types.enumeration_udt_builtin_mixture_enum" title="enumeration udt_builtin_mixture_enum"><code class="computeroutput">boost::numeric::udt_builtin_mixture_enum</code></a>
 
-</div>
-<div class="section" title="template class is_subranged<>">
+ </div>
+ <div class="section">
<div class="titlepage"><div><div><h4 class="title">
<a name="boost_numericconversion.conversion_traits___traits_class.types.template_class_is_subranged__"></a><a class="link" href="conversion_traits___traits_class.html#boost_numericconversion.conversion_traits___traits_class.types.template_class_is_subranged__" title="template class is_subranged<>">template
 class is_subranged<></a>
</h4></div></div></div>
+
<pre class="programlisting">namespace boost { namespace numeric {

 template <class T, class S>
 struct is_subranged : mpl::bool_<impl-def-value> {} ;

-} } // namespace boost::numeric
-</pre>
-
+} } // namespace boost::numeric
+</pre>
+ 
 Indicates if the range of the target type <code class="computeroutput">T</code>
 is a subset of the range of the source type <code class="computeroutput">S</code>.
 That is: if there are some source values which fall out of the Target type's
 range.
 
-
- It is a boolean <a href="../../../../../mpl/doc/refmanual/integral-constant.html" target="_top">MPL's
+ 
+ It is a boolean <a class="ulink" href="../../../../mpl/doc/refmanual/integral-constant.html" target="_top">MPL's
 Integral Constant</a> .
 
-
+ 
 It does not indicate if a particular conversion is effectively out of range;
 it indicates that some conversion might be out of range because not all
 the source values are representable as Target type.
 
-</div>
-<div class="section" title="template class conversion_traits<>">
+ </div>
+ <div class="section">
<div class="titlepage"><div><div><h4 class="title">
<a name="boost_numericconversion.conversion_traits___traits_class.types.template_class_conversion_traits__"></a><a class="link" href="conversion_traits___traits_class.html#boost_numericconversion.conversion_traits___traits_class.types.template_class_conversion_traits__" title="template class conversion_traits<>">template
 class conversion_traits<></a>
</h4></div></div></div>
+
<pre class="programlisting">namespace boost { namespace numeric {

 template <class T, class S>
@@ -226,9 +212,9 @@
 typedef ... subtype ;
 } ;

-} } // namespace numeric, namespace boost
-</pre>
-
+} } // namespace numeric, namespace boost
+</pre>
+ 
 This traits class indicates some properties of a numeric conversion
 direction: from a source type <code class="computeroutput">S</code>
 to a target type <code class="computeroutput">T</code>. It
@@ -236,242 +222,237 @@
 but of the conversion direction. See <a class="link" href="definitions.html#boost_numericconversion.definitions.subranged_conversion_direction__subtype_and_supertype" title="Subranged Conversion Direction, Subtype and Supertype">Definitions</a>
 for details.
 
-
- The traits class provides the following <a href="../../../../../mpl/doc/refmanual/integral-constant.html" target="_top">MPL's
+ 
+ The traits class provides the following <a class="ulink" href="../../../../mpl/doc/refmanual/integral-constant.html" target="_top">MPL's
 Integral Constant</a> \s of enumeration type. They express the combination
 of certain attributes of the Source and Target types (thus they are call
 mixture):
 
-<div class="informaltable"><table class="table">
+ <div class="informaltable">
+ <table border="1">
<colgroup>
<col>
<col>
</colgroup>
<thead><tr>
<th>
- 
- 
 </th>
<th>
- 
- 
 </th>
</tr></thead>
<tbody>
<tr>
<td>
- 
- int_float_mixture 
- 
+ 
+ int_float_mixture 
+ 
 </td>
<td>
- 
- Same as given by the traits class <a class="link" href="conversion_traits___traits_class.html#boost_numericconversion.conversion_traits___traits_class.types.template_class_int_float_mixture__" title="template class int_float_mixture<>">int_float_mixture</a>
- 
+ 
+ Same as given by the traits class <a class="link" href="conversion_traits___traits_class.html#boost_numericconversion.conversion_traits___traits_class.types.template_class_int_float_mixture__" title="template class int_float_mixture<>">int_float_mixture</a>
+ 
 </td>
</tr>
<tr>
<td>
- 
- sign_mixture 
- 
+ 
+ sign_mixture 
+ 
 </td>
<td>
- 
- Same as given by the traits class <a class="link" href="conversion_traits___traits_class.html#boost_numericconversion.conversion_traits___traits_class.types.template_class_sign_mixture__" title="template class sign_mixture<>">sign_mixture</a>
- 
+ 
+ Same as given by the traits class <a class="link" href="conversion_traits___traits_class.html#boost_numericconversion.conversion_traits___traits_class.types.template_class_sign_mixture__" title="template class sign_mixture<>">sign_mixture</a>
+ 
 </td>
</tr>
<tr>
<td>
- 
- udt_builtin_mixture 
- 
+ 
+ udt_builtin_mixture 
+ 
 </td>
<td>
- 
- Same as given by the traits class <a class="link" href="conversion_traits___traits_class.html#boost_numericconversion.conversion_traits___traits_class.types.template_class_udt_builtin_mixture__" title="template class udt_builtin_mixture<>">udt_builtin_mixture</a>
- 
+ 
+ Same as given by the traits class <a class="link" href="conversion_traits___traits_class.html#boost_numericconversion.conversion_traits___traits_class.types.template_class_udt_builtin_mixture__" title="template class udt_builtin_mixture<>">udt_builtin_mixture</a>
+ 
 </td>
</tr>
</tbody>
-</table></div>
-
- The traits class provides the following <a href="../../../../../mpl/doc/refmanual/integral-constant.html" target="_top">MPL's
+</table>
+ </div>
+ 
+ The traits class provides the following <a class="ulink" href="../../../../mpl/doc/refmanual/integral-constant.html" target="_top">MPL's
 Integral Constant</a> \s of boolean type which indicates indirectly
 the relation between the Source and Target ranges (see <a class="link" href="definitions.html#boost_numericconversion.definitions.range_and_precision" title="Range and Precision">Definitions</a>
 for details).
 
-<div class="informaltable"><table class="table">
+ <div class="informaltable">
+ <table border="1">
<colgroup>
<col>
<col>
</colgroup>
<thead><tr>
<th>
- 
- 
 </th>
<th>
- 
- 
 </th>
</tr></thead>
<tbody>
<tr>
<td>
- 
- subranged
- 
+ 
+ subranged
+ 
 </td>
<td>
- 
- Same as given by <a class="link" href="conversion_traits___traits_class.html#boost_numericconversion.conversion_traits___traits_class.types.template_class_is_subranged__" title="template class is_subranged<>">is_subranged</a>
- 
+ 
+ Same as given by <a class="link" href="conversion_traits___traits_class.html#boost_numericconversion.conversion_traits___traits_class.types.template_class_is_subranged__" title="template class is_subranged<>">is_subranged</a>
+ 
 </td>
</tr>
<tr>
<td>
- 
- trivial
- 
+ 
+ trivial
+ 
 </td>
<td>
- 
- Indicates if both Source and Target, without
- cv-qualifications, are the same type.
- 
- 
- Its <code class="computeroutput">::value</code>
- is of boolean type.
- 
+ 
+ Indicates if both Source and Target, without
+ cv-qualifications, are the same type.
+ 
+ 
+ Its <code class="computeroutput">::value</code>
+ is of boolean type.
+ 
 </td>
</tr>
</tbody>
-</table></div>
-
+</table>
+ </div>
+ 
 The traits class provides the following types. They are the Source and
 Target types classified and qualified for different purposes.
 
-<div class="informaltable"><table class="table">
+ <div class="informaltable">
+ <table border="1">
<colgroup>
<col>
<col>
</colgroup>
<thead><tr>
<th>
- 
- 
 </th>
<th>
- 
- 
 </th>
</tr></thead>
<tbody>
<tr>
<td>
- 
- target_type
- 
+ 
+ target_type
+ 
 </td>
<td>
- 
- The template parameter <code class="computeroutput">T</code>
- without cv-qualifications
- 
+ 
+ The template parameter <code class="computeroutput">T</code>
+ without cv-qualifications
+ 
 </td>
</tr>
<tr>
<td>
- 
- source_type
- 
+ 
+ source_type
+ 
 </td>
<td>
- 
- The template parameter <code class="computeroutput">S</code>
- without cv-qualifications
- 
+ 
+ The template parameter <code class="computeroutput">S</code>
+ without cv-qualifications
+ 
 </td>
</tr>
<tr>
<td>
- 
- argument_type
- 
+ 
+ argument_type
+ 
 </td>
<td>
- 
- This type is either source_type or <code class="computeroutput">source_type
- const&</code>.
- 
- 
- It represents the optimal argument type for the <a class="link" href="converter___function_object.html" title="converter<> function object">converter</a>
- member functions.
- 
- 
- If S is a built-in type, this is <code class="computeroutput">source_type</code>,
- otherwise, this is <code class="computeroutput">source_type
- const&</code>.
- 
+ 
+ This type is either source_type or <code class="computeroutput">source_type
+ const&</code>.
+ 
+ 
+ It represents the optimal argument type for the <a class="link" href="converter___function_object.html" title="converter<> function object">converter</a>
+ member functions.
+ 
+ 
+ If S is a built-in type, this is <code class="computeroutput">source_type</code>,
+ otherwise, this is <code class="computeroutput">source_type
+ const&</code>.
+ 
 </td>
</tr>
<tr>
<td>
- 
- result_type
- 
+ 
+ result_type
+ 
 </td>
<td>
- 
- This type is either target_type or target_type const&
- 
- 
- It represents the return type of the <a class="link" href="converter___function_object.html" title="converter<> function object">converter</a>
- member functions.
- 
- 
- If <code class="computeroutput">T==S</code>, it is <code class="computeroutput">target_type
- const&</code>,
- otherwise, it is <code class="computeroutput">target_type</code>.
- 
+ 
+ This type is either target_type or target_type const&
+ 
+ 
+ It represents the return type of the <a class="link" href="converter___function_object.html" title="converter<> function object">converter</a>
+ member functions.
+ 
+ 
+ If <code class="computeroutput">T==S</code>, it is <code class="computeroutput">target_type
+ const&</code>,
+ otherwise, it is <code class="computeroutput">target_type</code>.
+ 
 </td>
</tr>
<tr>
<td>
- 
- supertype
- 
+ 
+ supertype
+ 
 </td>
<td>
- 
- If the conversion is subranged, it is <code class="computeroutput">source_type</code>,
- otherwise, it is <code class="computeroutput">target_type</code>
- 
+ 
+ If the conversion is subranged, it is <code class="computeroutput">source_type</code>,
+ otherwise, it is <code class="computeroutput">target_type</code>
+ 
 </td>
</tr>
<tr>
<td>
- 
- subtype
- 
+ 
+ subtype
+ 
 </td>
<td>
- 
- If the conversion is subranged, it is <code class="computeroutput">target_type</code>,
- otherwise, it is <code class="computeroutput">source_type</code>
- 
+ 
+ If the conversion is subranged, it is <code class="computeroutput">target_type</code>,
+ otherwise, it is <code class="computeroutput">source_type</code>
+ 
 </td>
</tr>
</tbody>
-</table></div>
-</div>
-</div>
-<div class="section" title="Examples">
+</table>
+ </div>
+ </div>
+ </div>
+ <div class="section">
<div class="titlepage"><div><div><h3 class="title">
<a name="boost_numericconversion.conversion_traits___traits_class.examples"></a><a class="link" href="conversion_traits___traits_class.html#boost_numericconversion.conversion_traits___traits_class.examples" title="Examples">Examples</a>
</h3></div></div></div>
+
<pre class="programlisting">#include <cassert>
#include <typeinfo>
#include <boost/numeric/conversion/conversion_traits.hpp>
@@ -479,38 +460,34 @@
int main()
{

- // A trivial conversion.
- typedef boost::numeric::conversion_traits<short,short> Short2Short_Traits ;
+ // A trivial conversion.
+ typedef boost::numeric::conversion_traits<short,short> Short2Short_Traits ;
 assert ( Short2Short_Traits::trivial::value ) ;

- // A subranged conversion.
- typedef boost::numeric::conversion_traits<double,unsigned int> UInt2Double_Traits ;
+ // A subranged conversion.
+ typedef boost::numeric::conversion_traits<double,unsigned int> UInt2Double_Traits ;
 assert ( UInt2Double_Traits::int_float_mixture::value == boost::numeric::integral_to_float ) ;
 assert ( UInt2Double_Traits::sign_mixture::value == boost::numeric::unsigned_to_signed ) ;
 assert ( !UInt2Double_Traits::subranged::value ) ;
 assert ( typeid(UInt2Double_Traits::supertype) == typeid(double) ) ;
 assert ( typeid(UInt2Double_Traits::subtype) == typeid(unsigned int) ) ;

- // A doubly subranged conversion.
- assert ( (boost::numeric::conversion_traits<short, unsigned short>::subranged::value) );
+ // A doubly subranged conversion.
+ assert ( (boost::numeric::conversion_traits<short, unsigned short>::subranged::value) );
 assert ( (boost::numeric::conversion_traits<unsigned short, short>::subranged::value) );

 return 0;
}
</pre>
-</div>
-</div>
+ </div>
+ </div>
<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
<td align="left"></td>
-<td align="right"><div class="copyright-footer">Copyright © 2004 -2007 Fernando Luis Cacciola Carballal
- Distributed under the Boost Software License, Version 1.0. (See accompanying
- file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
- 
-</div></td>
+<td align="right"><div class="copyright-footer"></div></td>
</tr></table>
<hr>
<div class="spirit-nav">
-<a accesskey="p" href="bounds___traits_class.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="numeric_converter_policy_classes.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
+<a accesskey="u" href="../index.html"><img src="../../../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../../../../doc/src/images/home.png" alt="Home"></a>
</div>
</body>
</html>

Modified: branches/release/libs/numeric/conversion/doc/html/boost_numericconversion/converter___function_object.html
==============================================================================
--- branches/release/libs/numeric/conversion/doc/html/boost_numericconversion/converter___function_object.html (original)
+++ branches/release/libs/numeric/conversion/doc/html/boost_numericconversion/converter___function_object.html 2011-11-21 11:46:56 EST (Mon, 21 Nov 2011)
@@ -1,46 +1,36 @@
<html>
<head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<title>converter<> function object</title>
<link rel="stylesheet" href="../boostbook.css" type="text/css">
-<meta name="generator" content="DocBook XSL Stylesheets V1.75.2">
-<link rel="home" href="../index.html" title="Chapter 1. Boost.NumericConversion">
-<link rel="up" href="../index.html" title="Chapter 1. Boost.NumericConversion">
-<link rel="prev" href="definitions.html" title="Definitions">
-<link rel="next" href="type_requirements_and_user_defined_types_support.html" title="Type Requirements and User-defined-types support">
+<meta name="generator" content="DocBook XSL-NS Stylesheets V1.76.1">
+<link rel="home" href="../index.html" title="Chapter 1. Boost.NumericConversion">
+<link rel="up" href="../index.html" title="Chapter 1. Boost.NumericConversion">
</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">Home</td>
-<td align="center">Libraries</td>
+<td align="center">Libraries</td>
<td align="center">People</td>
<td align="center">FAQ</td>
<td align="center">More</td>
</tr></table>
<hr>
<div class="spirit-nav">
-<a accesskey="p" href="definitions.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="type_requirements_and_user_defined_types_support.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
+<a accesskey="u" href="../index.html"><img src="../../../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../../../../doc/src/images/home.png" alt="Home"></a>
</div>
-<div class="section" title="converter<> function object">
+<div class="section">
<div class="titlepage"><div><div><h2 class="title" style="clear: both">
<a name="boost_numericconversion.converter___function_object"></a><a class="link" href="converter___function_object.html" title="converter<> function object">converter<>
 function object</a>
</h2></div></div></div>
-<div class="toc"><dl>
-<dt>Synopsis</dt>
-<dt><a href="converter___function_object.html#boost_numericconversion.converter___function_object.template_parameters">Template
- parameters</a></dt>
-<dt><a href="converter___function_object.html#boost_numericconversion.converter___function_object.member_functions">Member
- functions</a></dt>
-<dt><a href="converter___function_object.html#boost_numericconversion.converter___function_object.range_checking_logic">Range
- Checking Logic</a></dt>
-<dt>Examples</dt>
-</dl></div>
-<div class="section" title="Synopsis">
+
+ <div class="section">
<div class="titlepage"><div><div><h3 class="title">
<a name="boost_numericconversion.converter___function_object.synopsis"></a><a class="link" href="converter___function_object.html#boost_numericconversion.converter___function_object.synopsis" title="Synopsis">Synopsis</a>
</h3></div></div></div>
+
<pre class="programlisting">namespace boost { namespace numeric {

@@ -64,8 +54,8 @@

 result_type operator() ( argument_type s ) const ;

- // Internal member functions:
-
+ // Internal member functions:
+
 static range_check_result out_of_range ( argument_type s ) ;
 static void validate_range ( argument_type s ) ;
 static result_type low_level_convert ( argument_type s ) ;
@@ -73,226 +63,216 @@

 } ;

-} } // namespace numeric, boost
-</pre>
-
+} } // namespace numeric, boost
+</pre>
+ 
 <code class="computeroutput">boost::numeric::converter<></code>
- is a <a href="http://www.sgi.com/tech/stl/UnaryFunction.html" target="_top">Unary Function
+ is a <a class="ulink" href="http://www.sgi.com/tech/stl/UnaryFunction.html" target="_top">Unary Function
 Object</a> encapsulating the code to perform a numeric conversion with
 the direction and properties specified by the Traits template parameter.
 It can optionally take some <a class="link" href="numeric_converter_policy_classes.html" title="Numeric Converter Policy Classes">policies</a>
 which can be used to customize its behavior. The <code class="computeroutput">Traits</code>
 parameter is not a policy but the parameter that defines the conversion.
 
-</div>
-<div class="section" title="Template parameters">
+ </div>
+ <div class="section">
<div class="titlepage"><div><div><h3 class="title">
<a name="boost_numericconversion.converter___function_object.template_parameters"></a><a class="link" href="converter___function_object.html#boost_numericconversion.converter___function_object.template_parameters" title="Template parameters">Template
 parameters</a>
</h3></div></div></div>
-<div class="informaltable"><table class="table">
+
+ <div class="informaltable">
+ <table border="1">
<colgroup>
<col>
<col>
</colgroup>
<thead><tr>
<th>
- 
- 
 </th>
<th>
- 
- 
 </th>
</tr></thead>
<tbody>
<tr>
<td>
- 
- <code class="computeroutput">T</code>
- 
+ 
+ <code class="computeroutput">T</code>
+ 
 </td>
<td>
- 
- The <a class="link" href="definitions.html#boost_numericconversion.definitions.numeric_types" title="Numeric Types">Numeric
- Type</a> which is the Target of the conversion.
- 
+ 
+ The <a class="link" href="definitions.html#boost_numericconversion.definitions.numeric_types" title="Numeric Types">Numeric
+ Type</a> which is the Target of the conversion.
+ 
 </td>
</tr>
<tr>
<td>
- 
- <code class="computeroutput">S</code>
- 
+ 
+ <code class="computeroutput">S</code>
+ 
 </td>
<td>
- 
- The <a class="link" href="definitions.html#boost_numericconversion.definitions.numeric_types" title="Numeric Types">Numeric
- Type</a> which is the Source of the conversion.
- 
+ 
+ The <a class="link" href="definitions.html#boost_numericconversion.definitions.numeric_types" title="Numeric Types">Numeric
+ Type</a> which is the Source of the conversion.
+ 
 </td>
</tr>
<tr>
<td>
- 
- <code class="computeroutput">Traits</code>
- 
+ 
+ <code class="computeroutput">Traits</code>
+ 
 </td>
<td>
- 
- This must be a conversion traits class with the interface of <a class="link" href="conversion_traits___traits_class.html" title="conversion_traits<> traits class"><code class="computeroutput">boost::numeric::conversion_traits</code></a>
- 
+ 
+ This must be a conversion traits class with the interface of <a class="link" href="conversion_traits___traits_class.html" title="conversion_traits<> traits class"><code class="computeroutput">boost::numeric::conversion_traits</code></a>
+ 
 </td>
</tr>
<tr>
<td>
- 
- <code class="computeroutput">OverflowHandler</code>
- 
+ 
+ <code class="computeroutput">OverflowHandler</code>
+ 
 </td>
<td>
- 
- Stateless Policy called to administrate
- the result of the range checking.
- 
- 
- It is a Function Object which receives
- the result of <code class="computeroutput">out_of_range()</code> and is called inside the <code class="computeroutput">validate_range()</code>
- static member function exposed by the converter.
- 
+ 
+ Stateless Policy called to administrate
+ the result of the range checking.
+ 
+ 
+ It is a Function Object which
+ receives the result of <code class="computeroutput">out_of_range()</code> and is called inside the <code class="computeroutput">validate_range()</code>
+ static member function exposed by the converter.
+ 
 </td>
</tr>
<tr>
<td>
- 
- <code class="computeroutput">Float2IntRounder</code>
- 
+ 
+ <code class="computeroutput">Float2IntRounder</code>
+ 
 </td>
<td>
- 
- Stateless Policy which specifies
- the rounding mode used for float to integral conversions.
- 
- 
- It supplies the <code class="computeroutput">nearbyint()</code> static member function exposed
- by the converter.
- 
+ 
+ Stateless Policy which specifies
+ the rounding mode used for float to integral conversions.
+ 
+ 
+ It supplies the <code class="computeroutput">nearbyint()</code> static member function exposed
+ by the converter.
+ 
 </td>
</tr>
<tr>
<td>
- 
- <code class="computeroutput">RawConverter</code>
- 
+ 
+ <code class="computeroutput">RawConverter</code>
+ 
 </td>
<td>
- 
- Stateless Policy which is used to
- perform the actual conversion.
- 
- 
- It supplies the <code class="computeroutput">low_level_convert()</code> static member function exposed
- by the converter.
- 
+ 
+ Stateless Policy which is used
+ to perform the actual conversion.
+ 
+ 
+ It supplies the <code class="computeroutput">low_level_convert()</code> static member function exposed
+ by the converter.
+ 
 </td>
</tr>
<tr>
<td>
- 
- <code class="computeroutput">UserRangeChecker</code>
- 
+ 
+ <code class="computeroutput">UserRangeChecker</code>
+ 
 </td>
<td>
- 
- Special and Optional Stateless
- Policy which can be used to override the internal range
- checking logic.
- 
- 
- If given, supplies alternative code for the <code class="computeroutput">out_of_range()</code> and <code class="computeroutput">validate_range()</code> static member functions exposed
- by the converter.
- 
+ 
+ Special and Optional Stateless
+ Policy which can be used to override the internal range
+ checking logic.
+ 
+ 
+ If given, supplies alternative code for the <code class="computeroutput">out_of_range()</code> and <code class="computeroutput">validate_range()</code> static member functions exposed
+ by the converter.
+ 
 </td>
</tr>
</tbody>
-</table></div>
-</div>
-<div class="section" title="Member functions">
+</table>
+ </div>
+ </div>
+ <div class="section">
<div class="titlepage"><div><div><h3 class="title">
<a name="boost_numericconversion.converter___function_object.member_functions"></a><a class="link" href="converter___function_object.html#boost_numericconversion.converter___function_object.member_functions" title="Member functions">Member
 functions</a>
</h3></div></div></div>
-<div class="blockquote"><blockquote class="blockquote">
-
- 
-
- <code class="computeroutput">static result_type
- converter<>::convert (
- argument_type s
- ) ;
- // throw </code>
- 
-
+
+ <div class="blockquote"><blockquote class="blockquote">
+ 
+ <code class="computeroutput">static result_type
+ converter<>::convert ( argument_type s
+ ) ; // throw </code>
 
-</blockquote></div>
-
+ </blockquote></div>
+ 
 This static member function converts an rvalue of type <code class="computeroutput">source_type</code>
 to an rvalue of type <code class="computeroutput">target_type</code>.
 
-
+ 
 If the conversion requires it, it performs a range checking before the conversion
 and passes the result of the check to the overflow handler policy (the default
 policy throws an exception if out-of-range is detected)
 
-
+ 
 The implementation of this function is actually built from the policies and
 is basically as follows:
 
<pre class="programlisting">result_type converter<>::convert ( argument_type s )
{
- validate_range(s); // Implemented by the internal range checking logic
- // (which also calls the OverflowHandler policy)
- // or externally supplied by the UserRangeChecker policy.
-
- s = nearbyint(s); // Externally supplied by the Float2IntRounder policy.
- // NOTE: This is actually called only for float to int conversions.
-
- return low_level_convert(s); // Externally supplied by the RawConverter policy.
-}
+ validate_range(s); // Implemented by the internal range checking logic
+ // (which also calls the OverflowHandler policy)
+ // or externally supplied by the UserRangeChecker policy.
+
+ s = nearbyint(s); // Externally supplied by the Float2IntRounder policy.
+ // NOTE: This is actually called only for float to int conversions.
+
+ return low_level_convert(s); // Externally supplied by the RawConverter policy.
+}
</pre>
-
+ 
 <code class="computeroutput">converter<>::operator() const</code> just calls <code class="computeroutput">convert()</code>
 
-
+ 
 <img src="../images/space.png" alt="space">
 
-<div class="blockquote"><blockquote class="blockquote">
-
- 
-
- <code class="computeroutput">static range_check_result
- numeric_converter<>::out_of_range (
- argument_type s
- ) ;</code>
- 
-
+ <div class="blockquote"><blockquote class="blockquote">
+ 
+ <code class="computeroutput">static range_check_result
+ numeric_converter<>::out_of_range (
+ argument_type s
+ ) ;</code>
 
-</blockquote></div>
-
+ </blockquote></div>
+ 
 This <a class="link" href="converter___function_object.html#numeric_conversion_converter_internal">internal</a>
 static member function determines if the value <code class="computeroutput">s</code>
 can be represented by the target type without overflow.
 
-
+ 
 It does not determine if the conversion is exact; that
 is, it does not detect inexact conversions, only out-of-range
 conversions (see the <a class="link" href="definitions.html#boost_numericconversion.definitions.exact__correctly_rounded_and_out_of_range_representations" title="Exact, Correctly Rounded and Out-Of-Range Representations">Definitions</a>
 for further details).
 
-
+ 
 The return value is of enum type <a class="link" href="numeric_converter_policy_classes.html#boost_numericconversion.numeric_converter_policy_classes.enum_range_check_result" title="enum range_check_result"><code class="computeroutput">boost::numeric::range_check_result</code></a>
 
-
+ 
 The actual code for the range checking logic is optimized for the combined
 properties of the source and target types. For example, a non-subranged conversion
 (i.e: <code class="computeroutput">int</code>-><code class="computeroutput">float</code>), requires no range checking, so <code class="computeroutput">out_of_range()</code>
@@ -300,128 +280,115 @@
 See the following <a class="link" href="converter___function_object.html#boost_numericconversion.converter___function_object.range_checking_logic" title="Range Checking Logic">table</a>
 for more details.
 
-
+ 
 If the user supplied a <a class="link" href="numeric_converter_policy_classes.html#boost_numericconversion.numeric_converter_policy_classes.policy_userrangechecker" title="Policy UserRangeChecker">UserRangeChecker</a>
 policy, is this policy which implements this function, so the implementation
 is user defined, although it is expected to perform the same conceptual check
 and return the appropriate result.
 
-
+ 
 <img src="../images/space.png" alt="space">
 
-<div class="blockquote"><blockquote class="blockquote">
-
- 
-
- <code class="computeroutput">static void
- numeric_converter<>::validate_range (
- argument_type s
- ) ;
- // no throw </code>
- 
-
+ <div class="blockquote"><blockquote class="blockquote">
+ 
+ <code class="computeroutput">static void
+ numeric_converter<>::validate_range (
+ argument_type s
+ ) ; // no throw </code>
 
-</blockquote></div>
-
+ </blockquote></div>
+ 
 This <a class="link" href="converter___function_object.html#numeric_conversion_converter_internal">internal</a>
 static member function calls out_of_range(s), and passes the result to the
 <a class="link" href="numeric_converter_policy_classes.html#boost_numericconversion.numeric_converter_policy_classes.policy_overflowhandler" title="Policy OverflowHandler">OverflowHandler</a>
 policy class.
 
-
+ 
 For those Target/Source combinations which don't require range checking,
 this is an empty inline function.
 
-
+ 
 If the user supplied a <a class="link" href="numeric_converter_policy_classes.html#boost_numericconversion.numeric_converter_policy_classes.policy_userrangechecker" title="Policy UserRangeChecker">UserRangeChecker</a>
 policy, is this policy which implements this function, so the implementation
 is user defined, although it is expected to perform the same action as the
 default. In particular, it is expected to pass the result of the check to
 the overflow handler.
 
-
+ 
 <img src="../images/space.png" alt="space">
 
-<div class="blockquote"><blockquote class="blockquote">
-
- 
-
- <code class="computeroutput">static result_type
- numeric_converter<>::low_level_convert (
- argument_type s
- ) ;</code>
- 
-
+ <div class="blockquote"><blockquote class="blockquote">
+ 
+ <code class="computeroutput">static result_type
+ numeric_converter<>::low_level_convert (
+ argument_type s
+ ) ;</code>
 
-</blockquote></div>
-
+ </blockquote></div>
+ 
 This <a class="link" href="converter___function_object.html#numeric_conversion_converter_internal">internal</a>
 static member function performs the actual conversion.
 
-
+ 
 This function is externally supplied by the <a class="link" href="numeric_converter_policy_classes.html#boost_numericconversion.numeric_converter_policy_classes.policy_rawconverter" title="Policy RawConverter">RawConverter</a>
 policy class.
 
-
+ 
 <img src="../images/space.png" alt="space">
 
-<div class="blockquote"><blockquote class="blockquote">
-
- 
-
- <code class="computeroutput">static source_type
- converter<>::nearbyint (
- argument_type s
- ) ;</code>
- 
-
+ <div class="blockquote"><blockquote class="blockquote">
+ 
+ <code class="computeroutput">static source_type
+ converter<>::nearbyint (
+ argument_type s
+ ) ;</code>
 
-</blockquote></div>
-
+ </blockquote></div>
+ 
 This <a class="link" href="converter___function_object.html#numeric_conversion_converter_internal">internal</a>
 static member function, which is only used
 for <code class="computeroutput">float</code> to <code class="computeroutput">int</code>
 conversions, returns an integer value of floating-point type according to some
 rounding direction.
 
-
+ 
 This function is externally supplied by the <a class="link" href="numeric_converter_policy_classes.html#boost_numericconversion.numeric_converter_policy_classes.policy_float2introunder" title="Policy Float2IntRounder">Float2IntRounder</a>
 policy class which encapsulates the specific rounding mode.
 
-
+ 
 <img src="../images/space.png" alt="space">
 
-<a name="numeric_conversion_converter_internal"></a>
- 
-<a name="boost_numericconversion.converter___function_object.member_functions.internal_member_functions"></a><h5>
-<a name="id563268"></a>
- <a class="link" href="converter___function_object.html#boost_numericconversion.converter___function_object.member_functions.internal_member_functions">Internal
+ <a name="numeric_conversion_converter_internal"></a>
+ <h5>
+<a name="boost_numericconversion.converter___function_object.member_functions.h0"></a>
+ <a name="boost_numericconversion.converter___function_object.member_functions.internal_member_functions"></a><a class="link" href="converter___function_object.html#boost_numericconversion.converter___function_object.member_functions.internal_member_functions">Internal
 Member Functions</a>
 </h5>
-
+ 
 These static member functions build the actual conversion code used by <code class="computeroutput">convert()</code>.
 The user does not have to call these if calling <code class="computeroutput">convert()</code>, since <code class="computeroutput">convert()</code> calls them infernally, but they can be
 called separately for specific needs.
 
-</div>
-<div class="section" title="Range Checking Logic">
+ </div>
+ <div class="section">
<div class="titlepage"><div><div><h3 class="title">
<a name="boost_numericconversion.converter___function_object.range_checking_logic"></a><a class="link" href="converter___function_object.html#boost_numericconversion.converter___function_object.range_checking_logic" title="Range Checking Logic">Range
 Checking Logic</a>
</h3></div></div></div>
-
+
+ 
 The following table summarizes the internal range checking logic performed
 for each combination of the properties of Source and Target.
 
-
+ 
 LowestT/HighestT denotes the highest and lowest values of the Target type,
 respectively.
 
-
+ 
 <code class="computeroutput">S(n)</code> is short
 for <code class="computeroutput">static_cast<S>(n)</code> (<code class="computeroutput">S</code> denotes the Source type).
 
-
+ 
 <code class="computeroutput">NONE</code> indicates that for this
 case there is no range checking.
 
@@ -452,11 +419,12 @@
 |--> not subranged |--> NONE
</code>
</pre>
-</div>
-<div class="section" title="Examples">
+ </div>
+ <div class="section">
<div class="titlepage"><div><div><h3 class="title">
<a name="boost_numericconversion.converter___function_object.examples"></a><a class="link" href="converter___function_object.html#boost_numericconversion.converter___function_object.examples" title="Examples">Examples</a>
</h3></div></div></div>
+
<pre class="programlisting">#include <cassert>
#include <boost/numeric/conversion/converter.hpp>

@@ -467,14 +435,14 @@
 int x = Double2Int::convert(2.0);
 assert ( x == 2 );

- int y = Double2Int()(3.14); // As a function object.
- assert ( y == 3 ) ; // The default rounding is trunc.
-
+ int y = Double2Int()(3.14); // As a function object.
+ assert ( y == 3 ) ; // The default rounding is trunc.
+
 try
 {
 double m = boost::numeric::bounds<double>::highest();
- int z = Double2Int::convert(m); // By default throws positive_overflow()
- }
+ int z = Double2Int::convert(m); // By default throws positive_overflow()
+ }
 catch ( boost::numeric::positive_overflow const& )
 {
 }
@@ -482,19 +450,15 @@
 return 0;
}
</pre>
-</div>
-</div>
+ </div>
+ </div>
<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
<td align="left"></td>
-<td align="right"><div class="copyright-footer">Copyright © 2004 -2007 Fernando Luis Cacciola Carballal
- Distributed under the Boost Software License, Version 1.0. (See accompanying
- file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
- 
-</div></td>
+<td align="right"><div class="copyright-footer"></div></td>
</tr></table>
<hr>
<div class="spirit-nav">
-<a accesskey="p" href="definitions.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="type_requirements_and_user_defined_types_support.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
+<a accesskey="u" href="../index.html"><img src="../../../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../../../../doc/src/images/home.png" alt="Home"></a>
</div>
</body>
</html>

Modified: branches/release/libs/numeric/conversion/doc/html/boost_numericconversion/definitions.html
==============================================================================
--- branches/release/libs/numeric/conversion/doc/html/boost_numericconversion/definitions.html (original)
+++ branches/release/libs/numeric/conversion/doc/html/boost_numericconversion/definitions.html 2011-11-21 11:46:56 EST (Mon, 21 Nov 2011)
@@ -1,346 +1,350 @@
<html>
<head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<title>Definitions</title>
<link rel="stylesheet" href="../boostbook.css" type="text/css">
-<meta name="generator" content="DocBook XSL Stylesheets V1.75.2">
-<link rel="home" href="../index.html" title="Chapter 1. Boost.NumericConversion">
-<link rel="up" href="../index.html" title="Chapter 1. Boost.NumericConversion">
-<link rel="prev" href="../index.html" title="Chapter 1. Boost.NumericConversion">
-<link rel="next" href="converter___function_object.html" title="converter<> function object">
+<meta name="generator" content="DocBook XSL-NS Stylesheets V1.76.1">
+<link rel="home" href="../index.html" title="Chapter 1. Boost.NumericConversion">
+<link rel="up" href="../index.html" title="Chapter 1. Boost.NumericConversion">
</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">Home</td>
-<td align="center">Libraries</td>
+<td align="center">Libraries</td>
<td align="center">People</td>
<td align="center">FAQ</td>
<td align="center">More</td>
</tr></table>
<hr>
<div class="spirit-nav">
-<a accesskey="p" href="../index.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="converter___function_object.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
+<a accesskey="u" href="../index.html"><img src="../../../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../../../../doc/src/images/home.png" alt="Home"></a>
</div>
-<div class="section" title="Definitions">
+<div class="section">
<div class="titlepage"><div><div><h2 class="title" style="clear: both">
<a name="boost_numericconversion.definitions"></a><a class="link" href="definitions.html" title="Definitions">Definitions</a>
</h2></div></div></div>
-<div class="toc"><dl>
-<dt>Introduction</dt>
-<dt><a href="definitions.html#boost_numericconversion.definitions.types_and_values">Types
- and Values</a></dt>
-<dt><a href="definitions.html#boost_numericconversion.definitions.c___arithmetic_types">C++
- Arithmetic Types</a></dt>
-<dt><a href="definitions.html#boost_numericconversion.definitions.numeric_types">Numeric
- Types</a></dt>
-<dt><a href="definitions.html#boost_numericconversion.definitions.range_and_precision">Range
- and Precision</a></dt>
-<dt><a href="definitions.html#boost_numericconversion.definitions.exact__correctly_rounded_and_out_of_range_representations">Exact,
- Correctly Rounded and Out-Of-Range Representations</a></dt>
-<dt><a href="definitions.html#boost_numericconversion.definitions.standard__numeric__conversions">Standard
- (numeric) Conversions</a></dt>
-<dt><a href="definitions.html#boost_numericconversion.definitions.subranged_conversion_direction__subtype_and_supertype">Subranged
- Conversion Direction, Subtype and Supertype</a></dt>
-</dl></div>
-<div class="section" title="Introduction">
+
+ <div class="section">
<div class="titlepage"><div><div><h3 class="title">
<a name="boost_numericconversion.definitions.introduction"></a><a class="link" href="definitions.html#boost_numericconversion.definitions.introduction" title="Introduction">Introduction</a>
</h3></div></div></div>
-
+
+ 
 This section provides definitions of terms used in the Numeric Conversion
 library.
 
-<div class="sidebar">
-
-
+ <div class="sidebar">
+<div class="titlepage"></div>
+ 
 Notation underlined
 text denotes terms defined in the C++ standard.
 
-
+ 
 bold face denotes terms defined here but
 not in the standard.
 
-</div>
-</div>
-<div class="section" title="Types and Values">
+ </div>
+ </div>
+ <div class="section">
<div class="titlepage"><div><div><h3 class="title">
<a name="boost_numericconversion.definitions.types_and_values"></a><a class="link" href="definitions.html#boost_numericconversion.definitions.types_and_values" title="Types and Values">Types
 and Values</a>
</h3></div></div></div>
-
+
+ 
 As defined by the C++ Object Model
- (§1.7) the storage or memory on which
+ (§1.7) the storage or memory on which
 a C++ program runs is a contiguous sequence of bytes
 where each byte is a contiguous sequence of bits.
 
-
- An object is a region of storage (§1.8)
- and has a type (§3.9).
+ 
+ An object is a region of storage (§1.8)
+ and has a type (§3.9).
 
-
+ 
 A type is a discrete set of values.
 
-
+ 
 An object of type <code class="computeroutput">T</code> has an
 object representation which is the
- sequence of bytes stored in the object (§3.9/4)
+ sequence of bytes stored in the object (§3.9/4)
 
-
+ 
 An object of type <code class="computeroutput">T</code> has a
 value representation which is the set
 of bits that determine the value of an object of that
- type (§3.9/4). For POD types (§3.9/10),
+ type (§3.9/4). For POD types (§3.9/10),
 this bitset is given by the object representation, but not all the bits in
 the storage need to participate in the value representation (except for character
 types): for example, some bits might be used for padding or there may be
 trap-bits.
 
-
+ 
 <img src="../images/space.png" alt="space">
 
-
+ 
 The typed value that is held by an object
 is the value which is determined by its value representation.
 
-
+ 
 An abstract value (untyped) is the conceptual
 information that is represented in a type (i.e. the number π).
 
-
+ 
 The intrinsic value of an object is the
 binary value of the sequence of unsigned characters which form its object
 representation.
 
-
+ 
 <img src="../images/space.png" alt="space">
 
-
+ 
 Abstract values can be represented
 in a given type.
 
-
+ 
 To represent an abstract value <code class="computeroutput">V</code> in a type <code class="computeroutput">T</code>
 is to obtain a typed value <code class="computeroutput">v</code>
 which corresponds to the abstract value <code class="computeroutput">V</code>.
 
-
+ 
 The operation is denoted using the <code class="computeroutput">rep()</code> operator, as in: <code class="computeroutput">v=rep(V)</code>. <code class="computeroutput">v</code> is the representation
 of <code class="computeroutput">V</code> in the type <code class="computeroutput">T</code>.
 
-
+ 
 For example, the abstract value π can be represented in the type <code class="computeroutput">double</code> as the <code class="computeroutput">double
 value M_PI</code>
 and in the type <code class="computeroutput">int</code> as the
 <code class="computeroutput">int value
 3</code>
 
-
+ 
 <img src="../images/space.png" alt="space">
 
-
+ 
 Conversely, typed values can be abstracted.
 
-
+ 
 To abstract a typed value <code class="computeroutput">v</code> of type <code class="computeroutput">T</code>
 is to obtain the abstract value <code class="computeroutput">V</code>
 whose representation in <code class="computeroutput">T</code>
 is <code class="computeroutput">v</code>.
 
-
+ 
 The operation is denoted using the <code class="computeroutput">abt()</code> operator, as in: <code class="computeroutput">V=abt(v)</code>.
 
-
+ 
 <code class="computeroutput">V</code> is the abstraction
 of <code class="computeroutput">v</code> of type <code class="computeroutput">T</code>.
 
-
+ 
 Abstraction is just an abstract operation (you can't do it); but it is defined
 nevertheless because it will be used to give the definitions in the rest
 of this document.
 
-</div>
-<div class="section" title="C++ Arithmetic Types">
+ </div>
+ <div class="section">
<div class="titlepage"><div><div><h3 class="title">
<a name="boost_numericconversion.definitions.c___arithmetic_types"></a><a class="link" href="definitions.html#boost_numericconversion.definitions.c___arithmetic_types" title="C++ Arithmetic Types">C++
 Arithmetic Types</a>
</h3></div></div></div>
-
+
+ 
 The C++ language defines fundamental types
- (§3.9.1). The following subsets of the fundamental types are intended to
+ (§3.9.1). The following subsets of the fundamental types are intended to
 represent numbers:
 
-<div class="variablelist">
+ <div class="variablelist">

<dl>
-<dt>signed integer
- types (§3.9.1/2):</dt>
-<dd>
- <code class="computeroutput">{signed
- char,
- signed short
- int,
- signed int, signed long int}</code> Can be used to represent general integer
- numbers (both negative and positive).
- </dd>
-<dt>unsigned integer
- types (§3.9.1/3):</dt>
-<dd>
- <code class="computeroutput">{unsigned
- char,
- unsigned short
- int,
- unsigned int, unsigned long int}</code> Can be used to represent positive integer
- numbers with modulo-arithmetic.
- </dd>
-<dt>floating-point
- types (§3.9.1/8):</dt>
-<dd>
- <code class="computeroutput">{float,double,long double}</code>
- Can be used to represent real numbers.
- </dd>
-<dt>integral or
- integer types (§3.9.1/7):</dt>
-<dd>
- <code class="computeroutput">{{signed
- integers},{unsigned integers}, bool, char and wchar_t}</code>
- </dd>
-<dt>arithmetic
- types (§3.9.1/8):</dt>
-<dd>
- <code class="computeroutput">{{integer
- types},{floating types}}</code>
- </dd>
+<dt>signed integer types (§3.9.1/2):</dt>
+<dd>
+ 
+ <code class="computeroutput">{signed
+ char,
+ signed short
+ int,
+ signed int, signed long int}</code> Can be used to represent general integer
+ numbers (both negative and positive).
+ 
+ </dd>
+<dt>unsigned integer types (§3.9.1/3):</dt>
+<dd>
+ 
+ <code class="computeroutput">{unsigned
+ char,
+ unsigned short
+ int,
+ unsigned int, unsigned
+ long int}</code> Can be used to represent positive
+ integer numbers with modulo-arithmetic.
+ 
+ </dd>
+<dt>floating-point types (§3.9.1/8):</dt>
+<dd>
+ 
+ <code class="computeroutput">{float,double,long double}</code>
+ Can be used to represent real numbers.
+ 
+ </dd>
+<dt>integral or integer types (§3.9.1/7):</dt>
+<dd>
+ 
+ <code class="computeroutput">{{signed
+ integers},{unsigned integers}, bool, char and wchar_t}</code>
+ 
+ </dd>
+<dt>arithmetic types (§3.9.1/8):</dt>
+<dd>
+ 
+ <code class="computeroutput">{{integer
+ types},{floating types}}</code>
+ 
+ </dd>
</dl>
</div>
-
+ 
 The integer types are required to have a binary value
 representation.
 
-
+ 
 Additionally, the signed/unsigned integer types of the same base type (<code class="computeroutput">short</code>, <code class="computeroutput">int</code>
 or <code class="computeroutput">long</code>) are required to have
 the same value representation, that is:
 
-<pre class="programlisting"> int i = -3 ; // suppose value representation is: 10011 (sign bit + 4 magnitude bits)
-unsigned int u = i ; // u is required to have the same 10011 as its value representation.
-</pre>
-
+<pre class="programlisting"> int i = -3 ; // suppose value representation is: 10011 (sign bit + 4 magnitude bits)
+unsigned int u = i ; // u is required to have the same 10011 as its value representation.
+</pre>
+ 
 In other words, the integer types signed/unsigned X use the same value representation
 but a different interpretation of it; that is, their
 typed values might differ.
 
-
+ 
 Another consequence of this is that the range for signed X is always a smaller
- subset of the range of unsigned X, as required by §3.9.1/3.
+ subset of the range of unsigned X, as required by §3.9.1/3.
 
-<div class="note" title="Note"><table border="0" summary="Note">
+ <div class="note"><table border="0" summary="Note">
<tr>
-<td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../../../../../../doc/html/images/note.png"></td>
+<td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../../../../../../doc/src/images/note.png"></td>
<th align="left">Note</th>
</tr>
<tr><td align="left" valign="top">
-
+ 
 Always remember that unsigned types, unlike signed types, have modulo-arithmetic;
 that is, they do not overflow. This means that:
 
-
+ 
 - Always be extra careful when mixing
 signed/unsigned types
 
-
+ 
 - Use unsigned types only when you need
 modulo arithmetic or very very large numbers. Don't use unsigned types
 just because you intend to deal with positive values only (you can do this
 with signed types as well).
 
-</td></tr>
+ </td></tr>
</table></div>
-</div>
-<div class="section" title="Numeric Types">
+ </div>
+ <div class="section">
<div class="titlepage"><div><div><h3 class="title">
<a name="boost_numericconversion.definitions.numeric_types"></a><a class="link" href="definitions.html#boost_numericconversion.definitions.numeric_types" title="Numeric Types">Numeric
 Types</a>
</h3></div></div></div>
-
+
+ 
 This section introduces the following definitions intended to integrate arithmetic
 types with user-defined types which behave like numbers. Some definitions
 are purposely broad in order to include a vast variety of user-defined number
 types.
 
-
+ 
 Within this library, the term number refers to an abstract
 numeric value.
 
-
+ 
 A type is numeric if:
 
-<div class="itemizedlist"><ul class="itemizedlist" type="disc">
-<li class="listitem">
- It is an arithmetic type, or,
- </li>
-<li class="listitem">
- It is a user-defined type which
- <div class="itemizedlist"><ul class="itemizedlist" type="circle">
+ <div class="itemizedlist"><ul class="itemizedlist" type="disc">
<li class="listitem">
- Represents numeric abstract values (i.e. numbers).
- </li>
-<li class="listitem">
- Can be converted (either implicitly or explicitly) to/from at least
- one arithmetic type.
- </li>
-<li class="listitem">
- Has <a class="link" href="definitions.html#boost_numericconversion.definitions.range_and_precision" title="Range and Precision">range</a>
- (possibly unbounded) and <a class="link" href="definitions.html#boost_numericconversion.definitions.range_and_precision" title="Range and Precision">precision</a>
- (possibly dynamic or unlimited).
- </li>
-<li class="listitem">
- Provides an specialization of <code class="computeroutput">std::numeric_limits</code>.
- </li>
+
+ It is an arithmetic type, or,
+
+ </li>
+<li class="listitem">
+
+ It is a user-defined type which
+ <div class="itemizedlist"><ul class="itemizedlist" type="circle">
+<li class="listitem">
+
+ Represents numeric abstract values (i.e. numbers).
+
+ </li>
+<li class="listitem">
+
+ Can be converted (either implicitly or explicitly) to/from at least
+ one arithmetic type.
+
+ </li>
+<li class="listitem">
+
+ Has <a class="link" href="definitions.html#boost_numericconversion.definitions.range_and_precision" title="Range and Precision">range</a>
+ (possibly unbounded) and <a class="link" href="definitions.html#boost_numericconversion.definitions.range_and_precision" title="Range and Precision">precision</a>
+ (possibly dynamic or unlimited).
+
+ </li>
+<li class="listitem">
+
+ Provides an specialization of <code class="computeroutput">std::numeric_limits</code>.
+
+ </li>
</ul></div>
-</li>
+
+ </li>
</ul></div>
-
+ 
 A numeric type is signed if the abstract
 values it represent include negative numbers.
 
-
+ 
 A numeric type is unsigned if the abstract
 values it represent exclude negative numbers.
 
-
+ 
 A numeric type is modulo if it has modulo-arithmetic
 (does not overflow).
 
-
+ 
 A numeric type is integer if the abstract
 values it represent are whole numbers.
 
-
+ 
 A numeric type is floating if the abstract
 values it represent are real numbers.
 
-
+ 
 An arithmetic value is the typed value of
 an arithmetic type
 
-
+ 
 A numeric value is the typed value of a
 numeric type
 
-
+ 
 These definitions simply generalize the standard notions of arithmetic types
 and values by introducing a superset called numeric.
 All arithmetic types and values are numeric types and values, but not vice
 versa, since user-defined numeric types are not arithmetic types.
 
-
+ 
 The following examples clarify the differences between arithmetic and numeric
 types (and values):
 
-<pre class="programlisting">// A numeric type which is not an arithmetic type (is user-defined)
-// and which is intended to represent integer numbers (i.e., an 'integer' numeric type)
-class MyInt
+<pre class="programlisting">// A numeric type which is not an arithmetic type (is user-defined)
+// and which is intended to represent integer numbers (i.e., an 'integer' numeric type)
+class MyInt
{
 MyInt ( long long v ) ;
 long long to_builtin();
@@ -349,68 +353,69 @@
template<> numeric_limits<MyInt> { ... } ;
}

-// A 'floating' numeric type (double) which is also an arithmetic type (built-in),
-// with a float numeric value.
-double pi = M_PI ;
+// A 'floating' numeric type (double) which is also an arithmetic type (built-in),
+// with a float numeric value.
+double pi = M_PI ;

-// A 'floating' numeric type with a whole numeric value.
-// NOTE: numeric values are typed valued, hence, they are, for instance,
-// integer or floating, despite the value itself being whole or including
-// a fractional part.
-double two = 2.0 ;
+// A 'floating' numeric type with a whole numeric value.
+// NOTE: numeric values are typed valued, hence, they are, for instance,
+// integer or floating, despite the value itself being whole or including
+// a fractional part.
+double two = 2.0 ;

-// An integer numeric type with an integer numeric value.
-MyInt i(1234);
+// An integer numeric type with an integer numeric value.
+MyInt i(1234);
</pre>
-</div>
-<div class="section" title="Range and Precision">
+ </div>
+ <div class="section">
<div class="titlepage"><div><div><h3 class="title">
<a name="boost_numericconversion.definitions.range_and_precision"></a><a class="link" href="definitions.html#boost_numericconversion.definitions.range_and_precision" title="Range and Precision">Range
 and Precision</a>
</h3></div></div></div>
-
+
+ 
 Given a number set <code class="computeroutput">N</code>, some
 of its elements are representable in a numeric type <code class="computeroutput">T</code>.
 
-
+ 
 The set of representable values of type <code class="computeroutput">T</code>,
 or numeric set of <code class="computeroutput">T</code>, is a
 set of numeric values whose elements are the representation of some subset
 of <code class="computeroutput">N</code>.
 
-
+ 
 For example, the interval of <code class="computeroutput">int</code>
 values <code class="computeroutput">[INT_MIN,INT_MAX]</code> is the set of representable values of type
 <code class="computeroutput">int</code>, i.e. the <code class="computeroutput">int</code> numeric set, and corresponds to the representation
 of the elements of the interval of abstract values <code class="computeroutput">[abt(INT_MIN),abt(INT_MAX)]</code>
 from the integer numbers.
 
-
+ 
 Similarly, the interval of <code class="computeroutput">double</code>
 values <code class="computeroutput">[-DBL_MAX,DBL_MAX]</code> is the <code class="computeroutput">double</code>
 numeric set, which corresponds to the subset of the real numbers from <code class="computeroutput">abt(-DBL_MAX)</code> to <code class="computeroutput">abt(DBL_MAX)</code>.
 
-
+ 
 <img src="../images/space.png" alt="space">
 
-
+ 
 Let <code class="computeroutput">next(x)</code>
 denote the lowest numeric value greater than x.
 
-
+ 
 Let <code class="computeroutput">prev(x)</code>
 denote the highest numeric value lower then x.
 
-
+ 
 Let <code class="computeroutput">v=prev(next(V))</code> and <code class="computeroutput">v=next(prev(V))</code>
 be identities that relate a numeric typed value <code class="computeroutput">v</code>
 with a number <code class="computeroutput">V</code>.
 
-
+ 
 An ordered pair of numeric values <code class="computeroutput">x</code>,<code class="computeroutput">y</code> s.t. <code class="computeroutput">x<y</code> are
 consecutive iff <code class="computeroutput">next(x)==y</code>.
 
-
+ 
 The abstract distance between consecutive numeric values is usually referred
 to as a Unit in the Last Place, or
 ulp for short. A ulp is a quantity whose
@@ -421,7 +426,7 @@
 <code class="computeroutput">x</code> might be (usually is) different
 from the magnitude of a 1ulp after the numeric value y for <code class="computeroutput">x!=y</code>.
 
-
+ 
 Since numbers are inherently ordered, a numeric set
 of type <code class="computeroutput">T</code> is an ordered sequence
 of numeric values (of type <code class="computeroutput">T</code>)
@@ -429,22 +434,22 @@
 
<pre class="programlisting">REP(T)={l,next(l),next(next(l)),...,prev(prev(h)),prev(h),h}
</pre>
-
+ 
 where <code class="computeroutput">l</code> and <code class="computeroutput">h</code> are respectively the lowest and highest
 values of type <code class="computeroutput">T</code>, called
 the boundary values of type <code class="computeroutput">T</code>.
 
-
+ 
 <img src="../images/space.png" alt="space">
 
-
+ 
 A numeric set is discrete. It has a size
 which is the number of numeric values in the set, a width
 which is the abstract difference between the highest and lowest boundary
 values: <code class="computeroutput">[abt(h)-abt(l)]</code>, and a density
 which is the relation between its size and width: <code class="computeroutput">density=size/width</code>.
 
-
+ 
 The integer types have density 1, which means that there are no unrepresentable
 integer numbers between <code class="computeroutput">abt(l)</code>
 and <code class="computeroutput">abt(h)</code> (i.e.
@@ -452,15 +457,15 @@
 than 1, which means that there are real numbers unrepresented between consecutive
 floating values (i.e. there are gaps).
 
-
+ 
 <img src="../images/space.png" alt="space">
 
-
+ 
 The interval of abstract values <code class="computeroutput">[abt(l),abt(h)]</code>
 is the range of the type <code class="computeroutput">T</code>,
 denoted <code class="computeroutput">R(T)</code>.
 
-
+ 
 A range is a set of abstract values and not a set of numeric values. In other
 documents, such as the C++ standard, the word <code class="computeroutput">range</code>
 is sometimes used as synonym for <code class="computeroutput">numeric
@@ -469,51 +474,55 @@
 to <code class="computeroutput">h</code>. In this document, however,
 a range is an abstract interval which subtends the numeric set.
 
-
+ 
 For example, the sequence <code class="computeroutput">[-DBL_MAX,DBL_MAX]</code>
 is the numeric set of the type <code class="computeroutput">double</code>,
 and the real interval <code class="computeroutput">[abt(-DBL_MAX),abt(DBL_MAX)]</code>
 is its range.
 
-
+ 
 Notice, for instance, that the range of a floating-point type is continuous
 unlike its numeric set.
 
-
+ 
 This definition was chosen because:
 
-<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+ <div class="itemizedlist"><ul class="itemizedlist" type="disc">
<li class="listitem">
-(a) The discrete set of numeric values
- is already given by the numeric set.
+
+ (a) The discrete set of numeric values
+ is already given by the numeric set.
+
 </li>
<li class="listitem">
-(b) Abstract intervals are easier to compare
- and overlap since only boundary values need to be considered.
+
+ (b) Abstract intervals are easier to
+ compare and overlap since only boundary values need to be considered.
+
 </li>
</ul></div>
-
+ 
 This definition allows for a concise definition of <code class="computeroutput">subranged</code>
 as given in the last section.
 
-
+ 
 The width of a numeric set, as defined, is exactly equivalent to the width
 of a range.
 
-
+ 
 <img src="../images/space.png" alt="space">
 
-
+ 
 The precision of a type is given by the
 width or density of the numeric set.
 
-
+ 
 For integer types, which have density 1, the precision is conceptually equivalent
 to the range and is determined by the number of bits used in the value representation:
 The higher the number of bits the bigger the size of the numeric set, the
 wider the range, and the higher the precision.
 
-
+ 
 For floating types, which have density <<1, the precision is given
 not by the width of the range but by the density. In a typical implementation,
 the range is determined by the number of bits used in the exponent, and the
@@ -522,18 +531,19 @@
 the number of exponent bits the wider the range, while the higher the number
 of mantissa bits, the higher the precision.
 
-</div>
-<div class="section" title="Exact, Correctly Rounded and Out-Of-Range Representations">
+ </div>
+ <div class="section">
<div class="titlepage"><div><div><h3 class="title">
<a name="boost_numericconversion.definitions.exact__correctly_rounded_and_out_of_range_representations"></a><a class="link" href="definitions.html#boost_numericconversion.definitions.exact__correctly_rounded_and_out_of_range_representations" title="Exact, Correctly Rounded and Out-Of-Range Representations">Exact,
 Correctly Rounded and Out-Of-Range Representations</a>
</h3></div></div></div>
-
+
+ 
 Given an abstract value <code class="computeroutput">V</code>
 and a type <code class="computeroutput">T</code> with its corresponding
 range <code class="computeroutput">[abt(l),abt(h)]</code>:
 
-
+ 
 If <code class="computeroutput">V <
 abt(l)</code> or
 <code class="computeroutput">V >
@@ -542,19 +552,23 @@
 or, equivalently, it's representation in the type <code class="computeroutput">T</code>
 is out of range, or overflows.
 
-<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+ <div class="itemizedlist"><ul class="itemizedlist" type="disc">
<li class="listitem">
- If <code class="computeroutput">V <
- abt(l)</code>, the
- overflow is negative.
+
+ If <code class="computeroutput">V <
+ abt(l)</code>,
+ the overflow is negative.
+
 </li>
<li class="listitem">
- If <code class="computeroutput">V >
- abt(h)</code>, the
- overflow is positive.
+
+ If <code class="computeroutput">V >
+ abt(h)</code>,
+ the overflow is positive.
+
 </li>
</ul></div>
-
+ 
 If <code class="computeroutput">V >=
 abt(l)</code> and
 <code class="computeroutput">V <=
@@ -564,7 +578,7 @@
 is in range, or does
 not overflow.
 
-
+ 
 Notice that a numeric type, such as a C++ unsigned type, can define that
 any <code class="computeroutput">V</code> does not overflow by
 always representing not <code class="computeroutput">V</code>
@@ -572,30 +586,34 @@
 = [ V % (abt(h)+1)
 ]</code>, which is always in range.
 
-
+ 
 Given an abstract value <code class="computeroutput">V</code>
 represented in the type <code class="computeroutput">T</code>
 as <code class="computeroutput">v</code>, the roundoff
 error of the representation is the abstract difference: <code class="computeroutput">(abt(v)-V)</code>.
 
-
+ 
 Notice that a representation is an operation, hence,
 the roundoff error corresponds to the representation operation and not to
 the numeric value itself (i.e. numeric values do not have any error themselves)
 
-<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+ <div class="itemizedlist"><ul class="itemizedlist" type="disc">
<li class="listitem">
- If the roundoff is 0, the representation is exact,
- and <code class="computeroutput">V</code> is exactly representable
- in the type <code class="computeroutput">T</code>.
+
+ If the roundoff is 0, the representation is exact,
+ and <code class="computeroutput">V</code> is exactly representable
+ in the type <code class="computeroutput">T</code>.
+
 </li>
<li class="listitem">
- If the roundoff is not 0, the representation is inexact,
- and <code class="computeroutput">V</code> is inexactly representable
- in the type <code class="computeroutput">T</code>.
+
+ If the roundoff is not 0, the representation is inexact,
+ and <code class="computeroutput">V</code> is inexactly representable
+ in the type <code class="computeroutput">T</code>.
+
 </li>
</ul></div>
-
+ 
 If a representation <code class="computeroutput">v</code> in
 a type <code class="computeroutput">T</code> -either exact or
 inexact-, is any of the adjacents of <code class="computeroutput">V</code>
@@ -606,7 +624,7 @@
 rounding direction, it is correctly
 rounded.
 
-
+ 
 All exact representations are correctly rounded, but not all inexact representations
 are. In particular, C++ requires numeric conversions (described below) and
 the result of arithmetic operations (not covered by this document) to be
@@ -615,205 +633,239 @@
 of the adjacents of the abstract value <code class="computeroutput">R</code>
 which is the theoretical result.
 
-
+ 
 Because a correctly rounded representation is always one of adjacents of
 the abstract value being represented, the roundoff is guaranteed to be at
 most 1ulp.
 
-
+ 
 The following examples summarize the given definitions. Consider:
 
-<div class="itemizedlist"><ul class="itemizedlist" type="disc">
-<li class="listitem">
- A numeric type <code class="computeroutput">Int</code> representing
- integer numbers with a numeric set: <code class="computeroutput">{-2,-1,0,1,2}</code> and range:
- <code class="computeroutput">[-2,2]</code>
-</li>
+ <div class="itemizedlist"><ul class="itemizedlist" type="disc">
<li class="listitem">
- A numeric type <code class="computeroutput">Cardinal</code>
- representing integer numbers with a numeric set:
- <code class="computeroutput">{0,1,2,3,4,5,6,7,8,9}</code> and range: <code class="computeroutput">[0,9]</code> (no modulo-arithmetic
- here)
+
+ A numeric type <code class="computeroutput">Int</code> representing
+ integer numbers with a numeric set: <code class="computeroutput">{-2,-1,0,1,2}</code> and
+ range: <code class="computeroutput">[-2,2]</code>
+
+ </li>
+<li class="listitem">
+
+ A numeric type <code class="computeroutput">Cardinal</code>
+ representing integer numbers with a numeric set:
+ <code class="computeroutput">{0,1,2,3,4,5,6,7,8,9}</code> and range: <code class="computeroutput">[0,9]</code> (no
+ modulo-arithmetic here)
+
+ </li>
+<li class="listitem">
+
+ A numeric type <code class="computeroutput">Real</code> representing
+ real numbers with a numeric set: <code class="computeroutput">{-2.0,-1.5,-1.0,-0.5,-0.0,+0.0,+0.5,+1.0,+1.5,+2.0}</code> and
+ range: <code class="computeroutput">[-2.0,+2.0]</code>
+
+ </li>
+<li class="listitem">
+
+ A numeric type <code class="computeroutput">Whole</code>
+ representing real numbers with a numeric set: <code class="computeroutput">{-2.0,-1.0,0.0,+1.0,+2.0}</code> and
+ range: <code class="computeroutput">[-2.0,+2.0]</code>
+
 </li>
-<li class="listitem">
- A numeric type <code class="computeroutput">Real</code> representing
- real numbers with a numeric set: <code class="computeroutput">{-2.0,-1.5,-1.0,-0.5,-0.0,+0.0,+0.5,+1.0,+1.5,+2.0}</code> and
- range: <code class="computeroutput">[-2.0,+2.0]</code>
-</li>
-<li class="listitem">
- A numeric type <code class="computeroutput">Whole</code> representing
- real numbers with a numeric set: <code class="computeroutput">{-2.0,-1.0,0.0,+1.0,+2.0}</code> and range: <code class="computeroutput">[-2.0,+2.0]</code>
-</li>
</ul></div>
-
+ 
 First, notice that the types <code class="computeroutput">Real</code>
 and <code class="computeroutput">Whole</code> both represent
 real numbers, have the same range, but different precision.
 
-<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+ <div class="itemizedlist"><ul class="itemizedlist" type="disc">
<li class="listitem">
- The integer number <code class="computeroutput">1</code> (an abstract
- value) can be exactly represented in any of these types.
- </li>
-<li class="listitem">
- The integer number <code class="computeroutput">-1</code>
- can be exactly represented in <code class="computeroutput">Int</code>,
- <code class="computeroutput">Real</code> and <code class="computeroutput">Whole</code>, but cannot be represented in
- <code class="computeroutput">Cardinal</code>, yielding negative
- overflow.
- </li>
-<li class="listitem">
- The real number <code class="computeroutput">1.5</code> can be
- exactly represented in <code class="computeroutput">Real</code>,
- and inexactly represented in the other types.
- </li>
-<li class="listitem">
- If <code class="computeroutput">1.5</code> is represented as either
- <code class="computeroutput">1</code> or <code class="computeroutput">2</code>
- in any of the types (except <code class="computeroutput">Real</code>),
- the representation is correctly rounded.
- </li>
-<li class="listitem">
- If <code class="computeroutput">0.5</code> is represented as <code class="computeroutput">+1.5</code> in the
- type <code class="computeroutput">Real</code>, it is incorrectly
- rounded.
- </li>
-<li class="listitem">
-<code class="computeroutput">(-2.0,-1.5)</code>
- are the <code class="computeroutput">Real</code> adjacents
- of any real number in the interval <code class="computeroutput">[-2.0,-1.5]</code>, yet there are no <code class="computeroutput">Real</code>
- adjacents for <code class="computeroutput">x <
- -2.0</code>,
- nor for <code class="computeroutput">x >
- +2.0</code>.
+
+ The integer number <code class="computeroutput">1</code> (an
+ abstract value) can be exactly represented in any of these types.
+
+ </li>
+<li class="listitem">
+
+ The integer number <code class="computeroutput">-1</code>
+ can be exactly represented in <code class="computeroutput">Int</code>,
+ <code class="computeroutput">Real</code> and <code class="computeroutput">Whole</code>, but cannot be represented in
+ <code class="computeroutput">Cardinal</code>, yielding negative
+ overflow.
+
+ </li>
+<li class="listitem">
+
+ The real number <code class="computeroutput">1.5</code> can be
+ exactly represented in <code class="computeroutput">Real</code>,
+ and inexactly represented in the other types.
+
+ </li>
+<li class="listitem">
+
+ If <code class="computeroutput">1.5</code> is represented as
+ either <code class="computeroutput">1</code> or <code class="computeroutput">2</code> in any of the types (except <code class="computeroutput">Real</code>), the representation is correctly
+ rounded.
+
+ </li>
+<li class="listitem">
+
+ If <code class="computeroutput">0.5</code> is represented as
+ <code class="computeroutput">+1.5</code>
+ in the type <code class="computeroutput">Real</code>, it
+ is incorrectly rounded.
+
+ </li>
+<li class="listitem">
+
+ <code class="computeroutput">(-2.0,-1.5)</code>
+ are the <code class="computeroutput">Real</code> adjacents
+ of any real number in the interval <code class="computeroutput">[-2.0,-1.5]</code>, yet there are no <code class="computeroutput">Real</code>
+ adjacents for <code class="computeroutput">x <
+ -2.0</code>,
+ nor for <code class="computeroutput">x >
+ +2.0</code>.
+
 </li>
</ul></div>
-</div>
-<div class="section" title="Standard (numeric) Conversions">
+ </div>
+ <div class="section">
<div class="titlepage"><div><div><h3 class="title">
<a name="boost_numericconversion.definitions.standard__numeric__conversions"></a><a class="link" href="definitions.html#boost_numericconversion.definitions.standard__numeric__conversions" title="Standard (numeric) Conversions">Standard
 (numeric) Conversions</a>
</h3></div></div></div>
-
+
+ 
 The C++ language defines Standard Conversions
- (§4) some of which are conversions between arithmetic types.
+ (§4) some of which are conversions between arithmetic types.
 
-
- These are Integral promotions (§4.5),
- Integral conversions (§4.7), Floating point promotions (§4.6), Floating point conversions (§4.8) and Floating-integral conversions (§4.9).
+ 
+ These are Integral promotions (§4.5),
+ Integral conversions (§4.7), Floating point promotions (§4.6), Floating point conversions (§4.8) and Floating-integral conversions (§4.9).
 
-
+ 
 In the sequel, integral and floating point promotions are called arithmetic promotions, and these plus integral, floating-point
 and floating-integral conversions are called arithmetic
 conversions (i.e, promotions are conversions).
 
-
+ 
 Promotions, both Integral and Floating point, are value-preserving,
 which means that the typed value is not changed with the conversion.
 
-
+ 
 In the sequel, consider a source typed value <code class="computeroutput">s</code>
 of type <code class="computeroutput">S</code>, the source abstract
 value <code class="computeroutput">N=abt(s)</code>, a destination type <code class="computeroutput">T</code>;
 and whenever possible, a result typed value <code class="computeroutput">t</code>
 of type <code class="computeroutput">T</code>.
 
-
+ 
 Integer to integer conversions are always defined:
 
-<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+ <div class="itemizedlist"><ul class="itemizedlist" type="disc">
<li class="listitem">
- If <code class="computeroutput">T</code> is unsigned, the abstract
- value which is effectively represented is not <code class="computeroutput">N</code>
- but <code class="computeroutput">M=[
- N %
- ( abt(h)
- + 1 ) ]</code>, where
- <code class="computeroutput">h</code> is the highest unsigned
- typed value of type <code class="computeroutput">T</code>.
- </li>
-<li class="listitem">
- If <code class="computeroutput">T</code> is signed and <code class="computeroutput">N</code> is not directly representable, the
- result <code class="computeroutput">t</code> is implementation-defined,
- which means that the C++ implementation is required to produce a value
- <code class="computeroutput">t</code> even if it is totally
- unrelated to <code class="computeroutput">s</code>.
+
+ If <code class="computeroutput">T</code> is unsigned, the
+ abstract value which is effectively represented is not <code class="computeroutput">N</code> but <code class="computeroutput">M=[ N % ( abt(h) + 1
+ ) ]</code>,
+ where <code class="computeroutput">h</code> is the highest
+ unsigned typed value of type <code class="computeroutput">T</code>.
+
+ </li>
+<li class="listitem">
+
+ If <code class="computeroutput">T</code> is signed and <code class="computeroutput">N</code> is not directly representable, the
+ result <code class="computeroutput">t</code> is implementation-defined, which means that
+ the C++ implementation is required to produce a value <code class="computeroutput">t</code>
+ even if it is totally unrelated to <code class="computeroutput">s</code>.
+
 </li>
</ul></div>
-
+ 
 Floating to Floating conversions are defined only if <code class="computeroutput">N</code>
 is representable; if it is not, the conversion has undefined
 behavior.
 
-<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+ <div class="itemizedlist"><ul class="itemizedlist" type="disc">
<li class="listitem">
- If <code class="computeroutput">N</code> is exactly representable,
- <code class="computeroutput">t</code> is required to be the
- exact representation.
+
+ If <code class="computeroutput">N</code> is exactly representable,
+ <code class="computeroutput">t</code> is required to be the
+ exact representation.
+
 </li>
<li class="listitem">
- If <code class="computeroutput">N</code> is inexactly representable,
- <code class="computeroutput">t</code> is required to be one
- of the two adjacents, with an implementation-defined choice of rounding
- direction; that is, the conversion is required to be correctly rounded.
+
+ If <code class="computeroutput">N</code> is inexactly representable,
+ <code class="computeroutput">t</code> is required to be one
+ of the two adjacents, with an implementation-defined choice of rounding
+ direction; that is, the conversion is required to be correctly rounded.
+
 </li>
</ul></div>
-
+ 
 Floating to Integer conversions represent not <code class="computeroutput">N</code>
 but <code class="computeroutput">M=trunc(N)</code>, were
 <code class="computeroutput">trunc()</code>
 is to truncate: i.e. to remove the fractional part, if any.
 
-<div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem">
- If <code class="computeroutput">M</code> is not representable
- in <code class="computeroutput">T</code>, the conversion has
- undefined behavior (unless <code class="computeroutput">T</code> is <code class="computeroutput">bool</code>,
- see §4.12).
+ <div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem">
+
+ If <code class="computeroutput">M</code> is not representable
+ in <code class="computeroutput">T</code>, the conversion
+ has undefined behavior (unless
+ <code class="computeroutput">T</code> is <code class="computeroutput">bool</code>,
+ see §4.12).
+
 </li></ul></div>
-
+ 
 Integer to Floating conversions are always defined.
 
-<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+ <div class="itemizedlist"><ul class="itemizedlist" type="disc">
<li class="listitem">
- If <code class="computeroutput">N</code> is exactly representable,
- <code class="computeroutput">t</code> is required to be the
- exact representation.
+
+ If <code class="computeroutput">N</code> is exactly representable,
+ <code class="computeroutput">t</code> is required to be the
+ exact representation.
+
 </li>
<li class="listitem">
- If <code class="computeroutput">N</code> is inexactly representable,
- <code class="computeroutput">t</code> is required to be one
- of the two adjacents, with an implementation-defined choice of rounding
- direction; that is, the conversion is required to be correctly rounded.
+
+ If <code class="computeroutput">N</code> is inexactly representable,
+ <code class="computeroutput">t</code> is required to be one
+ of the two adjacents, with an implementation-defined choice of rounding
+ direction; that is, the conversion is required to be correctly rounded.
+
 </li>
</ul></div>
-</div>
-<div class="section" title="Subranged Conversion Direction, Subtype and Supertype">
+ </div>
+ <div class="section">
<div class="titlepage"><div><div><h3 class="title">
<a name="boost_numericconversion.definitions.subranged_conversion_direction__subtype_and_supertype"></a><a class="link" href="definitions.html#boost_numericconversion.definitions.subranged_conversion_direction__subtype_and_supertype" title="Subranged Conversion Direction, Subtype and Supertype">Subranged
 Conversion Direction, Subtype and Supertype</a>
</h3></div></div></div>
-
+
+ 
 Given a source type <code class="computeroutput">S</code> and
 a destination type <code class="computeroutput">T</code>, there
 is a conversion direction denoted: <code class="computeroutput">S->T</code>.
 
-
+ 
 For any two ranges the following range relation can
 be defined: A range <code class="computeroutput">X</code> can
 be entirely contained in a range <code class="computeroutput">Y</code>,
 in which case it is said that <code class="computeroutput">X</code>
 is enclosed by <code class="computeroutput">Y</code>.
 
-<div class="blockquote"><blockquote class="blockquote">
-
- 
-
- Formally: <code class="computeroutput">R(S)</code> is enclosed by <code class="computeroutput">R(T)</code> iif <code class="computeroutput">(R(S) intersection R(T)) == R(S)</code>.
- 
-
+ <div class="blockquote"><blockquote class="blockquote">
+ 
+ Formally: <code class="computeroutput">R(S)</code>
+ is enclosed by <code class="computeroutput">R(T)</code> iif
+ <code class="computeroutput">(R(S)
+ intersection R(T))
+ == R(S)</code>.
 
-</blockquote></div>
-
+ </blockquote></div>
+ 
 If the source type range, <code class="computeroutput">R(S)</code>,
 is not enclosed in the target type range, <code class="computeroutput">R(T)</code>;
 that is, if <code class="computeroutput">(R(S)
@@ -829,59 +881,71 @@
 because they are out of range. Notice that for <code class="computeroutput">S->T</code>,
 the adjective subranged applies to <code class="computeroutput">T</code>.
 
-
+ 
 Examples:
 
-
+ 
 Given the following numeric types all representing real numbers:
 
-<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+ <div class="itemizedlist"><ul class="itemizedlist" type="disc">
<li class="listitem">
-<code class="computeroutput">X</code> with numeric set <code class="computeroutput">{-2.0,-1.0,0.0,+1.0,+2.0}</code> and
- range <code class="computeroutput">[-2.0,+2.0]</code>
-</li>
+
+ <code class="computeroutput">X</code> with numeric set <code class="computeroutput">{-2.0,-1.0,0.0,+1.0,+2.0}</code> and
+ range <code class="computeroutput">[-2.0,+2.0]</code>
+
+ </li>
<li class="listitem">
-<code class="computeroutput">Y</code> with numeric set <code class="computeroutput">{-2.0,-1.5,-1.0,-0.5,0.0,+0.5,+1.0,+1.5,+2.0}</code> and range <code class="computeroutput">[-2.0,+2.0]</code>
-</li>
+
+ <code class="computeroutput">Y</code> with numeric set <code class="computeroutput">{-2.0,-1.5,-1.0,-0.5,0.0,+0.5,+1.0,+1.5,+2.0}</code> and range <code class="computeroutput">[-2.0,+2.0]</code>
+
+ </li>
<li class="listitem">
-<code class="computeroutput">Z</code> with numeric set <code class="computeroutput">{-1.0,0.0,+1.0}</code> and range <code class="computeroutput">[-1.0,+1.0]</code>
-</li>
+
+ <code class="computeroutput">Z</code> with numeric set <code class="computeroutput">{-1.0,0.0,+1.0}</code> and range <code class="computeroutput">[-1.0,+1.0]</code>
+
+ </li>
</ul></div>
-
+ 
 For:
 
-<div class="variablelist">
+ <div class="variablelist">

<dl>
<dt>(a) X->Y:</dt>
-<dd>
- <code class="computeroutput">R(X) & R(Y) == R(X)</code>,
- then <code class="computeroutput">X->Y</code> is not subranged. Thus, all values
- of type <code class="computeroutput">X</code> are representable
- in the type <code class="computeroutput">Y</code>.
- </dd>
+<dd>
+ 
+ <code class="computeroutput">R(X) & R(Y) == R(X)</code>,
+ then <code class="computeroutput">X->Y</code> is not subranged. Thus, all values
+ of type <code class="computeroutput">X</code> are representable
+ in the type <code class="computeroutput">Y</code>.
+ 
+ </dd>
<dt>(b) Y->X:</dt>
-<dd>
- <code class="computeroutput">R(Y) & R(X) == R(Y)</code>,
- then <code class="computeroutput">Y->X</code> is not subranged. Thus, all values
- of type <code class="computeroutput">Y</code> are representable
- in the type <code class="computeroutput">X</code>, but in
- this case, some values are inexactly representable
- (all the halves). (note: it is to permit this case that a range is an
- interval of abstract values and not an interval of typed values)
- </dd>
+<dd>
+ 
+ <code class="computeroutput">R(Y) & R(X) == R(Y)</code>,
+ then <code class="computeroutput">Y->X</code> is not subranged. Thus, all values
+ of type <code class="computeroutput">Y</code> are representable
+ in the type <code class="computeroutput">X</code>, but
+ in this case, some values are inexactly representable
+ (all the halves). (note: it is to permit this case that a range is
+ an interval of abstract values and not an interval of typed values)
+ 
+ </dd>
<dt>(b) X->Z:</dt>
-<dd>
- <code class="computeroutput">R(X) & R(Z) != R(X)</code>,
- then <code class="computeroutput">X->Z</code> is subranged. Thus, some values of
- type <code class="computeroutput">X</code> are not representable
- in the type <code class="computeroutput">Z</code>, they fall
- out of range <code class="computeroutput">(-2.0
- and +2.0)</code>.
- </dd>
+<dd>
+ 
+ <code class="computeroutput">R(X) & R(Z) != R(X)</code>,
+ then <code class="computeroutput">X->Z</code> is subranged. Thus, some values
+ of type <code class="computeroutput">X</code> are not representable
+ in the type <code class="computeroutput">Z</code>, they
+ fall out of range <code class="computeroutput">(-2.0
+ and +2.0)</code>.
+ 
+ </dd>
</dl>
</div>
-
+ 
 It is possible that <code class="computeroutput">R(S)</code> is not
 enclosed by <code class="computeroutput">R(T)</code>, while
 neither is <code class="computeroutput">R(T)</code> enclosed
@@ -892,7 +956,7 @@
 of signed/unsigned types are involved and indicates that in both directions
 there are values which can fall out of range.
 
-
+ 
 Given the range relation (subranged or not) of a conversion direction <code class="computeroutput">S->T</code>, it is possible to classify <code class="computeroutput">S</code> and <code class="computeroutput">T</code>
 as supertype and subtype:
 If the conversion is subranged, which means that <code class="computeroutput">T</code>
@@ -900,71 +964,70 @@
 <code class="computeroutput">S</code> is the supertype and <code class="computeroutput">T</code> the subtype; otherwise, <code class="computeroutput">T</code> is the supertype and <code class="computeroutput">S</code>
 the subtype.
 
-
+ 
 For example:
 
-<div class="blockquote"><blockquote class="blockquote">
-
- 
-
- <code class="computeroutput">R(float)=[-FLT_MAX,FLT_MAX]</code>
- and <code class="computeroutput">R(double)=[-DBL_MAX,DBL_MAX]</code>
- 
-
+ <div class="blockquote"><blockquote class="blockquote">
+ 
+ <code class="computeroutput">R(float)=[-FLT_MAX,FLT_MAX]</code>
+ and <code class="computeroutput">R(double)=[-DBL_MAX,DBL_MAX]</code>
 
-</blockquote></div>
-
+ </blockquote></div>
+ 
 If <code class="computeroutput">FLT_MAX <
 DBL_MAX</code>:
 
-<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+ <div class="itemizedlist"><ul class="itemizedlist" type="disc">
<li class="listitem">
-<code class="computeroutput">double->float</code> is subranged and <code class="computeroutput">supertype=double</code>,
- <code class="computeroutput">subtype=float</code>.
+
+ <code class="computeroutput">double->float</code> is subranged and <code class="computeroutput">supertype=double</code>,
+ <code class="computeroutput">subtype=float</code>.
+
 </li>
<li class="listitem">
-<code class="computeroutput">float->double</code> is not subranged and <code class="computeroutput">supertype=double</code>, <code class="computeroutput">subtype=float</code>.
+
+ <code class="computeroutput">float->double</code> is not subranged and <code class="computeroutput">supertype=double</code>, <code class="computeroutput">subtype=float</code>.
+
 </li>
</ul></div>
-
+ 
 Notice that while <code class="computeroutput">double->float</code> is subranged, <code class="computeroutput">float->double</code>
 is not, which yields the same supertype,subtype for both directions.
 
-
+ 
 Now consider:
 
-<div class="blockquote"><blockquote class="blockquote">
-
- 
-
- <code class="computeroutput">R(int)=[INT_MIN,INT_MAX]</code>
- and <code class="computeroutput">R(unsigned int)=[0,UINT_MAX]</code>
- 
-
+ <div class="blockquote"><blockquote class="blockquote">
+ 
+ <code class="computeroutput">R(int)=[INT_MIN,INT_MAX]</code> and <code class="computeroutput">R(unsigned int)=[0,UINT_MAX]</code>
 
-</blockquote></div>
-
+ </blockquote></div>
+ 
 A C++ implementation is required to have <code class="computeroutput">UINT_MAX
 > INT_MAX</code>
- (§3.9/3), so:
+ (§3.9/3), so:
 
-<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+ <div class="itemizedlist"><ul class="itemizedlist" type="disc">
<li class="listitem">
- 'int->unsigned' is subranged (negative values fall out of range) and
- <code class="computeroutput">supertype=int</code>, <code class="computeroutput">subtype=unsigned</code>.
+
+ 'int->unsigned' is subranged (negative values fall out of range) and
+ <code class="computeroutput">supertype=int</code>, <code class="computeroutput">subtype=unsigned</code>.
+
 </li>
<li class="listitem">
- 'unsigned->int' is also subranged (high positive
- values fall out of range) and <code class="computeroutput">supertype=unsigned</code>,
- <code class="computeroutput">subtype=int</code>.
+
+ 'unsigned->int' is also subranged (high positive
+ values fall out of range) and <code class="computeroutput">supertype=unsigned</code>,
+ <code class="computeroutput">subtype=int</code>.
+
 </li>
</ul></div>
-
+ 
 In this case, the conversion is subranged in both directions and the supertype,subtype
 pairs are not invariant (under inversion of direction). This indicates that
 none of the types can represent all the values of the other.
 
-
+ 
 When the supertype is the same for both <code class="computeroutput">S->T</code>
 and <code class="computeroutput">T->S</code>, it is effectively indicating a type
 which can represent all the values of the subtype. Consequently, if a conversion
@@ -976,19 +1039,15 @@
 correctly rounded (even if inexact). For example, all integer to floating
 conversions are correctly rounded value preserving.
 
-</div>
-</div>
+ </div>
+ </div>
<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
<td align="left"></td>
-<td align="right"><div class="copyright-footer">Copyright © 2004 -2007 Fernando Luis Cacciola Carballal
- Distributed under the Boost Software License, Version 1.0. (See accompanying
- file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
- 
-</div></td>
+<td align="right"><div class="copyright-footer"></div></td>
</tr></table>
<hr>
<div class="spirit-nav">
-<a accesskey="p" href="../index.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="converter___function_object.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
+<a accesskey="u" href="../index.html"><img src="../../../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../../../../doc/src/images/home.png" alt="Home"></a>
</div>
</body>
</html>

Modified: branches/release/libs/numeric/conversion/doc/html/boost_numericconversion/improved_numeric_cast__.html
==============================================================================
--- branches/release/libs/numeric/conversion/doc/html/boost_numericconversion/improved_numeric_cast__.html (original)
+++ branches/release/libs/numeric/conversion/doc/html/boost_numericconversion/improved_numeric_cast__.html 2011-11-21 11:46:56 EST (Mon, 21 Nov 2011)
@@ -1,64 +1,65 @@
<html>
<head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<title>Improved numeric_cast<></title>
<link rel="stylesheet" href="../boostbook.css" type="text/css">
-<meta name="generator" content="DocBook XSL Stylesheets V1.75.2">
-<link rel="home" href="../index.html" title="Chapter 1. Boost.NumericConversion">
-<link rel="up" href="../index.html" title="Chapter 1. Boost.NumericConversion">
-<link rel="prev" href="numeric_converter_policy_classes.html" title="Numeric Converter Policy Classes">
-<link rel="next" href="../numeric_conversion/history_and_acknowledgments.html" title="History and Acknowledgments">
+<meta name="generator" content="DocBook XSL-NS Stylesheets V1.76.1">
+<link rel="home" href="../index.html" title="Chapter 1. Boost.NumericConversion">
+<link rel="up" href="../index.html" title="Chapter 1. Boost.NumericConversion">
</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">Home</td>
-<td align="center">Libraries</td>
+<td align="center">Libraries</td>
<td align="center">People</td>
<td align="center">FAQ</td>
<td align="center">More</td>
</tr></table>
<hr>
<div class="spirit-nav">
-<a accesskey="p" href="numeric_converter_policy_classes.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../numeric_conversion/history_and_acknowledgments.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
+<a accesskey="u" href="../index.html"><img src="../../../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../../../../doc/src/images/home.png" alt="Home"></a>
</div>
-<div class="section" title="Improved numeric_cast<>">
+<div class="section">
<div class="titlepage"><div><div><h2 class="title" style="clear: both">
<a name="boost_numericconversion.improved_numeric_cast__"></a><a class="link" href="improved_numeric_cast__.html" title="Improved numeric_cast<>">Improved
 numeric_cast<></a>
</h2></div></div></div>
-<div class="toc"><dl>
-<dt>Introduction</dt>
-<dt>numeric_cast</dt>
-<dt>Examples</dt>
-</dl></div>
-<div class="section" title="Introduction">
+
+ <div class="section">
<div class="titlepage"><div><div><h3 class="title">
<a name="boost_numericconversion.improved_numeric_cast__.introduction"></a><a class="link" href="improved_numeric_cast__.html#boost_numericconversion.improved_numeric_cast__.introduction" title="Introduction">Introduction</a>
</h3></div></div></div>
-
+
+ 
 The lack of preservation of range makes conversions between numeric types
 error prone. This is true for both implicit conversions and explicit conversions
 (through <code class="computeroutput">static_cast</code>). <a class="link" href="improved_numeric_cast__.html#boost_numericconversion.improved_numeric_cast__.numeric_cast" title="numeric_cast"><code class="computeroutput">numeric_cast</code></a> detects loss of range
 when a numeric type is converted, and throws an exception if the range cannot
 be preserved.
 
-
+ 
 There are several situations where conversions are unsafe:
 
-<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+ <div class="itemizedlist"><ul class="itemizedlist" type="disc">
<li class="listitem">
- Conversions from an integral type with a wider range than the target integral
- type.
+
+ Conversions from an integral type with a wider range than the target
+ integral type.
+
 </li>
<li class="listitem">
- Conversions from unsigned to signed (and vice versa) integral types.
+
+ Conversions from unsigned to signed (and vice versa) integral types.
+
 </li>
<li class="listitem">
- Conversions from floating point types to integral types.
+
+ Conversions from floating point types to integral types.
+
 </li>
</ul></div>
-
+ 
 The C++ Standard does not specify the behavior when a numeric type is assigned
 a value that cannot be represented by the type, except for unsigned integral
 types [3.9.1.4], which must obey the laws of arithmetic modulo 2n (this implies
@@ -68,47 +69,84 @@
 to unsigned) makes any code that may produce positive or negative overflows
 exposed to portability issues.
 
-
- <code class="computeroutput">numeric_cast</code> adheres to the
- rules for implicit conversions mandated by the C++ Standard, such as truncating
- floating point types when converting to integral types. The implementation
- must guarantee that for a conversion to a type that can hold all possible
- values of the source type, there will be no runtime overhead.
+ 
+ By default <code class="computeroutput">numeric_cast</code> adheres
+ to the rules for implicit conversions mandated by the C++ Standard, such
+ as truncating floating point types when converting to integral types. The
+ implementation must guarantee that for a conversion to a type that can hold
+ all possible values of the source type, there will be no runtime overhead.
 
-</div>
-<div class="section" title="numeric_cast">
+ </div>
+ <div class="section">
<div class="titlepage"><div><div><h3 class="title">
<a name="boost_numericconversion.improved_numeric_cast__.numeric_cast"></a><a class="link" href="improved_numeric_cast__.html#boost_numericconversion.improved_numeric_cast__.numeric_cast" title="numeric_cast">numeric_cast</a>
</h3></div></div></div>
-<pre class="programlisting">template<typename Target, typename Source> inline
-typename boost::numeric::converter<Target,Source>::result_type
-numeric_cast ( Source arg )
+
+<pre class="programlisting">template <typename Target, typename Source> inline
+Target numeric_cast( Source arg )
{
- return boost::numeric::converter<Target,Source>::convert(arg);
+ typedef conversion_traits<Target, Source> conv_traits;
+ typedef numeric_cast_traits<Target, Source> cast_traits;
+ typedef converter
+ <
+ Target,
+ Source,
+ conv_traits,
+ typename cast_traits::overflow_policy,
+ typename cast_traits::rounding_policy,
+ raw_converter<conv_traits>,
+ typename cast_traits::range_checking_policy
+ > converter;
+ return converter::convert(arg);
}
</pre>
-
+ 
 <code class="computeroutput">numeric_cast</code> returns the
 result of converting a value of type Source to a value of type Target. If
- out-of-range is detected, an exception is thrown (see <a class="link" href="numeric_converter_policy_classes.html#numeric_conversion_bad_numeric_cast">bad_numeric_cast</a>,
+ out-of-range is detected, an overflow policy is executed whose default behavior
+ is to throw an an exception (see <a class="link" href="numeric_converter_policy_classes.html#numeric_conversion_bad_numeric_cast">bad_numeric_cast</a>,
 <a class="link" href="numeric_converter_policy_classes.html#numeric_conversion_negative_overflow">negative_overflow</a>
 and <a class="link" href="numeric_converter_policy_classes.html#numeric_conversion_possitive_overflow">positive_overflow</a>
 ).
 
-</div>
-<div class="section" title="Examples">
+ </div>
+ <div class="section">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="boost_numericconversion.improved_numeric_cast__.numeric_cast_traits"></a><a class="link" href="improved_numeric_cast__.html#boost_numericconversion.improved_numeric_cast__.numeric_cast_traits" title="numeric_cast_traits">numeric_cast_traits</a>
+</h3></div></div></div>
+
+<pre class="programlisting">template <typename Target, typename Source, typename EnableIf = void>
+struct numeric_cast_traits
+{
+ typedef def_overflow_handler overflow_policy;
+ typedef UseInternalRangeChecker range_checking_policy;
+ typedef Trunc<Source> rounding_policy;
+};
+</pre>
+ 
+ The behavior of <code class="computeroutput">numeric_cast</code>
+ may be tailored for custom numeric types through the specialization of <code class="computeroutput">numeric_cast_traits</code>. (see <a class="link" href="type_requirements_and_user_defined_types_support.html" title="Type Requirements and User-defined-types support">User
+ Defined Types</a> for details. )
+ 
+ </div>
+ <div class="section">
<div class="titlepage"><div><div><h3 class="title">
<a name="boost_numericconversion.improved_numeric_cast__.examples"></a><a class="link" href="improved_numeric_cast__.html#boost_numericconversion.improved_numeric_cast__.examples" title="Examples">Examples</a>
</h3></div></div></div>
-
+
+ 
 The following example performs some typical conversions between numeric types:
 
-<div class="orderedlist"><ol class="orderedlist" type="1">
+ <div class="orderedlist"><ol class="orderedlist" type="1">
<li class="listitem">
- include <boost/numeric/conversion/cast.hpp>
+
+ include <boost/numeric/conversion/cast.hpp>
+
 </li>
<li class="listitem">
- include <iostream>
+
+ include <iostream>
+
 </li>
</ol></div>
<pre class="programlisting">int main()
@@ -122,8 +160,8 @@
 try
 {
 int i=42;
- short s=numeric_cast<short>(i); // This conversion succeeds (is in range)
- }
+ short s=numeric_cast<short>(i); // This conversion succeeds (is in range)
+ }
 catch(negative_overflow& e) {
 std::cout << e.what();
 }
@@ -135,23 +173,23 @@
 {
 float f=-42.1234;

- // This will cause a boost::numeric::negative_overflow exception to be thrown
- unsigned int i=numeric_cast<unsigned int>(f);
+ // This will cause a boost::numeric::negative_overflow exception to be thrown
+ unsigned int i=numeric_cast<unsigned int>(f);
 }
 catch(bad_numeric_cast& e) {
 std::cout << e.what();
 }

- double d= f + numeric_cast<double>(123); // int -> double
-
+ double d= f + numeric_cast<double>(123); // int -> double
+
 unsigned long l=std::numeric_limits<unsigned long>::max();

 try
 {
- // This will cause a boost::numeric::positive_overflow exception to be thrown
- // NOTE: *operations* on unsigned integral types cannot cause overflow
- // but *conversions* to a signed type ARE range checked by numeric_cast.
-
+ // This will cause a boost::numeric::positive_overflow exception to be thrown
+ // NOTE: *operations* on unsigned integral types cannot cause overflow
+ // but *conversions* to a signed type ARE range checked by numeric_cast.
+
 unsigned char c=numeric_cast<unsigned char>(l);
 }
 catch(positive_overflow& e) {
@@ -162,19 +200,15 @@
 return 0;
}
</pre>
-</div>
-</div>
+ </div>
+ </div>
<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
<td align="left"></td>
-<td align="right"><div class="copyright-footer">Copyright © 2004 -2007 Fernando Luis Cacciola Carballal
- Distributed under the Boost Software License, Version 1.0. (See accompanying
- file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
- 
-</div></td>
+<td align="right"><div class="copyright-footer"></div></td>
</tr></table>
<hr>
<div class="spirit-nav">
-<a accesskey="p" href="numeric_converter_policy_classes.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../numeric_conversion/history_and_acknowledgments.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
+<a accesskey="u" href="../index.html"><img src="../../../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../../../../doc/src/images/home.png" alt="Home"></a>
</div>
</body>
</html>

Modified: branches/release/libs/numeric/conversion/doc/html/boost_numericconversion/numeric_converter_policy_classes.html
==============================================================================
--- branches/release/libs/numeric/conversion/doc/html/boost_numericconversion/numeric_converter_policy_classes.html (original)
+++ branches/release/libs/numeric/conversion/doc/html/boost_numericconversion/numeric_converter_policy_classes.html 2011-11-21 11:46:56 EST (Mon, 21 Nov 2011)
@@ -1,49 +1,37 @@
<html>
<head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<title>Numeric Converter Policy Classes</title>
<link rel="stylesheet" href="../boostbook.css" type="text/css">
-<meta name="generator" content="DocBook XSL Stylesheets V1.75.2">
-<link rel="home" href="../index.html" title="Chapter 1. Boost.NumericConversion">
-<link rel="up" href="../index.html" title="Chapter 1. Boost.NumericConversion">
-<link rel="prev" href="conversion_traits___traits_class.html" title="conversion_traits<> traits class">
-<link rel="next" href="improved_numeric_cast__.html" title="Improved numeric_cast<>">
+<meta name="generator" content="DocBook XSL-NS Stylesheets V1.76.1">
+<link rel="home" href="../index.html" title="Chapter 1. Boost.NumericConversion">
+<link rel="up" href="../index.html" title="Chapter 1. Boost.NumericConversion">
</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">Home</td>
-<td align="center">Libraries</td>
+<td align="center">Libraries</td>
<td align="center">People</td>
<td align="center">FAQ</td>
<td align="center">More</td>
</tr></table>
<hr>
<div class="spirit-nav">
-<a accesskey="p" href="conversion_traits___traits_class.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="improved_numeric_cast__.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
+<a accesskey="u" href="../index.html"><img src="../../../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../../../../doc/src/images/home.png" alt="Home"></a>
</div>
-<div class="section" title="Numeric Converter Policy Classes">
+<div class="section">
<div class="titlepage"><div><div><h2 class="title" style="clear: both">
<a name="boost_numericconversion.numeric_converter_policy_classes"></a><a class="link" href="numeric_converter_policy_classes.html" title="Numeric Converter Policy Classes">Numeric
 Converter Policy Classes</a>
</h2></div></div></div>
-<div class="toc"><dl>
-<dt><a href="numeric_converter_policy_classes.html#boost_numericconversion.numeric_converter_policy_classes.enum_range_check_result">enum
- range_check_result</a></dt>
-<dt><a href="numeric_converter_policy_classes.html#boost_numericconversion.numeric_converter_policy_classes.policy_overflowhandler">Policy
- OverflowHandler</a></dt>
-<dt><a href="numeric_converter_policy_classes.html#boost_numericconversion.numeric_converter_policy_classes.policy_float2introunder">Policy
- Float2IntRounder</a></dt>
-<dt><a href="numeric_converter_policy_classes.html#boost_numericconversion.numeric_converter_policy_classes.policy_rawconverter">Policy
- RawConverter</a></dt>
-<dt><a href="numeric_converter_policy_classes.html#boost_numericconversion.numeric_converter_policy_classes.policy_userrangechecker">Policy
- UserRangeChecker</a></dt>
-</dl></div>
-<div class="section" title="enum range_check_result">
+
+ <div class="section">
<div class="titlepage"><div><div><h3 class="title">
<a name="boost_numericconversion.numeric_converter_policy_classes.enum_range_check_result"></a><a class="link" href="numeric_converter_policy_classes.html#boost_numericconversion.numeric_converter_policy_classes.enum_range_check_result" title="enum range_check_result">enum
 range_check_result</a>
</h3></div></div></div>
+
<pre class="programlisting">namespace boost { namespace numeric {

 enum range_check_result
@@ -55,42 +43,43 @@

} }
</pre>
-
+ 
 Defines the values returned by <code class="computeroutput">boost::numeric::converter<>::out_of_range()</code>
 
-</div>
-<div class="section" title="Policy OverflowHandler">
+ </div>
+ <div class="section">
<div class="titlepage"><div><div><h3 class="title">
<a name="boost_numericconversion.numeric_converter_policy_classes.policy_overflowhandler"></a><a class="link" href="numeric_converter_policy_classes.html#boost_numericconversion.numeric_converter_policy_classes.policy_overflowhandler" title="Policy OverflowHandler">Policy
 OverflowHandler</a>
</h3></div></div></div>
-
+
+ 
 This stateless non-template policy class must be a
 function object and is called to administrate the result
 of the range checking. It can throw an exception if overflow has been detected
 by the range checking as indicated by its argument. If it throws, is is recommended
 that it be <code class="computeroutput">std::bad_cast</code> or derived.
 
-
+ 
 It must have the following interface (it does not has to be a template class):
 
<pre class="programlisting">struct YourOverflowHandlerPolicy
{
- void operator() ( boost::range_check_result ) ; // throw bad_cast or derived
-} ;
+ void operator() ( boost::range_check_result ) ; // throw bad_cast or derived
+} ;
</pre>
-
+ 
 It is called with the result of the converter's <code class="computeroutput">out_of_range()</code> inside <code class="computeroutput">validate_range()</code>.
 
-
+ 
 These are the two overflow handler classes provided by the library:
 
<pre class="programlisting">namespace boost { namespace numeric {

 struct def_overflow_handler
 {
- void operator() ( range_check_result r ) // throw bad_numeric_conversion derived
- {
+ void operator() ( range_check_result r ) // throw bad_numeric_conversion derived
+ {
 if ( r == cNegOverflow )
 throw negative_overflow() ;
 else if ( r == cPosOverflow )
@@ -100,46 +89,46 @@

 struct silent_overflow_handler
 {
- void operator() ( range_check_result ) // no-throw
- {}
+ void operator() ( range_check_result ) // no-throw
+ {}
 } ;

} }
</pre>
-
+ 
 And these are the Exception Classes thrown by the default overflow handler
 <a class="link" href="numeric_converter_policy_classes.html#numeric_conversion_policy_overflow_handler_important_note">(see
 IMPORTANT note)</a>
 
-<a name="numeric_conversion_bad_numeric_cast"></a><a name="numeric_conversion_negative_overflow"></a><a name="numeric_conversion_possitive_overflow"></a><pre class="programlisting">namespace boost { namespace numeric {
+<pre class="programlisting">namespace boost { namespace numeric {

-
+ <a name="numeric_conversion_bad_numeric_cast"></a>
 class bad_numeric_cast : public std::bad_cast
 {
 public:
- virtual const char *what() const // throw()
- {
+ virtual const char *what() const // throw()
+ {
 return "bad numeric conversion: overflow";
 }

 };

-
+ <a name="numeric_conversion_negative_overflow"></a>
 class negative_overflow : public bad_numeric_cast
 {
 public:
- virtual const char *what() const // throw()
- {
+ virtual const char *what() const // throw()
+ {
 return "bad numeric conversion: negative overflow";
 }
 };

-
+ <a name="numeric_conversion_possitive_overflow"></a>
 class positive_overflow : public bad_numeric_cast
 {
 public:
- virtual const char *what() const // throw()
- {
+ virtual const char *what() const // throw()
+ {
 return "bad numeric conversion: positive overflow";
 }
 };
@@ -147,14 +136,14 @@

} }
</pre>
-<a name="numeric_conversion_policy_overflow_handler_important_note"></a>
- 
-<div class="important" title="Important"><table border="0" summary="Important">
+ <a name="numeric_conversion_policy_overflow_handler_important_note"></a>
+ <div class="important"><table border="0" summary="Important">
<tr>
-<td rowspan="2" align="center" valign="top" width="25"><img alt="[Important]" src="../../../../../../doc/html/images/important.png"></td>
+<td rowspan="2" align="center" valign="top" width="25"><img alt="[Important]" src="../../../../../../doc/src/images/important.png"></td>
<th align="left">Important</th>
</tr>
-<tr><td align="left" valign="top">
+<tr><td align="left" valign="top">
+ 
 RELEASE NOTE for 1.33 Previous to boost
 version 1.33, the exception class <code class="computeroutput">bad_numeric_cast</code>
 was named <code class="computeroutput">bad_numeric_conversion</code>.
@@ -166,22 +155,24 @@
 its exception type so I decided to avoid backward compatibility problems
 by adopting it (guessing that the user base for the old code is wider than
 for the new code).
- </td></tr>
+ 
+ </td></tr>
</table></div>
-</div>
-<div class="section" title="Policy Float2IntRounder">
+ </div>
+ <div class="section">
<div class="titlepage"><div><div><h3 class="title">
<a name="boost_numericconversion.numeric_converter_policy_classes.policy_float2introunder"></a><a class="link" href="numeric_converter_policy_classes.html#boost_numericconversion.numeric_converter_policy_classes.policy_float2introunder" title="Policy Float2IntRounder">Policy
 Float2IntRounder</a>
</h3></div></div></div>
-
+
+ 
 This stateless template policy class specifies the rounding
 mode used for float to integral conversions.
 It supplies the <code class="computeroutput">nearbyint()</code> static member function exposed by the converter,
 which means that it publicly inherits from this
 policy.
 
-
+ 
 The policy must have the following interface:
 
<pre class="programlisting">template<class S>
@@ -196,20 +187,22 @@

} ;
</pre>
-
+ 
 These are the rounder classes provided by the library (only the specific
 parts are shown, see the general policy form above)
 
-<div class="note" title="Note"><table border="0" summary="Note">
+ <div class="note"><table border="0" summary="Note">
<tr>
-<td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../../../../../../doc/html/images/note.png"></td>
+<td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../../../../../../doc/src/images/note.png"></td>
<th align="left">Note</th>
</tr>
-<tr><td align="left" valign="top">
+<tr><td align="left" valign="top">
+ 
 These classes are not intended to be general purpose rounding functions
 but specific policies for <code class="computeroutput">converter<></code>. This is why they are not function
 objects.
- </td></tr>
+ 
+ </td></tr>
</table></div>
<pre class="programlisting">namespace boost { namespace numeric {

@@ -265,44 +258,45 @@
 typedef mpl::integral_c<std::float_round_style,std::round_toward_neg_infinity> round_style ;
 } ;

-} } // namespace numeric, namespace boost
-</pre>
-<a name="boost_numericconversion.numeric_converter_policy_classes.policy_float2introunder.math_functions_used_by_the_rounder_policies"></a><h5>
-<a name="id572764"></a>
- <a class="link" href="numeric_converter_policy_classes.html#boost_numericconversion.numeric_converter_policy_classes.policy_float2introunder.math_functions_used_by_the_rounder_policies">Math
+} } // namespace numeric, namespace boost
+</pre>
+ <h5>
+<a name="boost_numericconversion.numeric_converter_policy_classes.policy_float2introunder.h0"></a>
+ <a name="boost_numericconversion.numeric_converter_policy_classes.policy_float2introunder.math_functions_used_by_the_rounder_policies"></a><a class="link" href="numeric_converter_policy_classes.html#boost_numericconversion.numeric_converter_policy_classes.policy_float2introunder.math_functions_used_by_the_rounder_policies">Math
 Functions used by the rounder policies</a>
 </h5>
-
+ 
 The rounder policies supplied by this header use math functions <code class="computeroutput">floor()</code>
 and <code class="computeroutput">ceil()</code>.
 The standard versions of these functions are introduced in context by a using
 directive, so in normal conditions, the standard functions will be used.
 
-
+ 
 However, if there are other visible corresponding overloads an ambiguity
 could arise. In this case, the user can supply her own rounder policy which
 could, for instance, use a fully qualified call.
 
-
+ 
 This technique allows the default rounder policies to be used directly with
 user defined types. The user only requires that suitable overloads of <code class="computeroutput">floor()</code>
 and <code class="computeroutput">ceil()</code>
 be visible. See also <a class="link" href="type_requirements_and_user_defined_types_support.html" title="Type Requirements and User-defined-types support">User
 Defined Numeric Types</a> support.
 
-</div>
-<div class="section" title="Policy RawConverter">
+ </div>
+ <div class="section">
<div class="titlepage"><div><div><h3 class="title">
<a name="boost_numericconversion.numeric_converter_policy_classes.policy_rawconverter"></a><a class="link" href="numeric_converter_policy_classes.html#boost_numericconversion.numeric_converter_policy_classes.policy_rawconverter" title="Policy RawConverter">Policy
 RawConverter</a>
</h3></div></div></div>
-
+
+ 
 This stateless template policy class is used to perform
 the actual conversion from Source to Target. It supplies the <code class="computeroutput">low_level_convert()</code>
 static member function exposed by the converter, which means that it publicly
 inherits from this policy.
 
-
+ 
 The policy must have the following interface:
 
<pre class="programlisting">template<class Traits>
@@ -314,12 +308,12 @@
 static result_type low_level_convert ( argument_type s ) { return <impl defined> ; }
} ;
</pre>
-
+ 
 This policy is mostly provided as a hook for user defined types which don't
 support <code class="computeroutput">static_cast<></code>
 conversions to some types
 
-
+ 
 This is the only raw converter policy class provided by the library:
 
<pre class="programlisting">namespace boost { namespace numeric {
@@ -332,27 +326,28 @@

 static result_type low_level_convert ( argument_type s )
 {
- return static_cast<result_type>(s) ;
+ return static_cast<result_type>(s) ;
 }
 } ;

} }
</pre>
-</div>
-<div class="section" title="Policy UserRangeChecker">
+ </div>
+ <div class="section">
<div class="titlepage"><div><div><h3 class="title">
<a name="boost_numericconversion.numeric_converter_policy_classes.policy_userrangechecker"></a><a class="link" href="numeric_converter_policy_classes.html#boost_numericconversion.numeric_converter_policy_classes.policy_userrangechecker" title="Policy UserRangeChecker">Policy
 UserRangeChecker</a>
</h3></div></div></div>
-
+
+ 
 This stateless template policy class is used only if supplied to override
 the internal range checking logic.
 
-
+ 
 It supplies the <code class="computeroutput">validate_range()</code> static member function exposed by the converter,
 which means that it publicly inherits from this policy.
 
-
+ 
 The policy must have the following interface:
 
<pre class="programlisting">template<class Traits>
@@ -360,37 +355,33 @@
{
 typedef typename Traits::argument_type argument_type ;

- // Determines if the value 's' fits in the range of the Target type.
- static range_check_result out_of_range ( argument_type s ) ;
+ // Determines if the value 's' fits in the range of the Target type.
+ static range_check_result out_of_range ( argument_type s ) ;

- // Checks whether the value 's' is out_of_range()
- // and passes the result of the check to the OverflowHandler policy.
- static void validate_range ( argument_type s )
+ // Checks whether the value 's' is out_of_range()
+ // and passes the result of the check to the OverflowHandler policy.
+ static void validate_range ( argument_type s )
 {
 OverflowHandler()( out_of_range(s) ) ;
 }
} ;
</pre>
-
+ 
 This policy is only provided as a hook for
 user defined types which require range checking (which is disabled by default
 when a UDT is involved). The library provides a class: <code class="computeroutput">UseInternalRangeChecker{}</code>; which is a fake
 <code class="computeroutput">RangeChecker</code> policy used
 to signal the converter to use its internal range checking implementation.
 
-</div>
-</div>
+ </div>
+ </div>
<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
<td align="left"></td>
-<td align="right"><div class="copyright-footer">Copyright © 2004 -2007 Fernando Luis Cacciola Carballal
- Distributed under the Boost Software License, Version 1.0. (See accompanying
- file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
- 
-</div></td>
+<td align="right"><div class="copyright-footer"></div></td>
</tr></table>
<hr>
<div class="spirit-nav">
-<a accesskey="p" href="conversion_traits___traits_class.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="improved_numeric_cast__.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
+<a accesskey="u" href="../index.html"><img src="../../../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../../../../doc/src/images/home.png" alt="Home"></a>
</div>
</body>
</html>

Modified: branches/release/libs/numeric/conversion/doc/html/boost_numericconversion/type_requirements_and_user_defined_types_support.html
==============================================================================
--- branches/release/libs/numeric/conversion/doc/html/boost_numericconversion/type_requirements_and_user_defined_types_support.html (original)
+++ branches/release/libs/numeric/conversion/doc/html/boost_numericconversion/type_requirements_and_user_defined_types_support.html 2011-11-21 11:46:56 EST (Mon, 21 Nov 2011)
@@ -1,63 +1,55 @@
<html>
<head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<title>Type Requirements and User-defined-types support</title>
<link rel="stylesheet" href="../boostbook.css" type="text/css">
-<meta name="generator" content="DocBook XSL Stylesheets V1.75.2">
-<link rel="home" href="../index.html" title="Chapter 1. Boost.NumericConversion">
-<link rel="up" href="../index.html" title="Chapter 1. Boost.NumericConversion">
-<link rel="prev" href="converter___function_object.html" title="converter<> function object">
-<link rel="next" href="bounds___traits_class.html" title="bounds<> traits class">
+<meta name="generator" content="DocBook XSL-NS Stylesheets V1.76.1">
+<link rel="home" href="../index.html" title="Chapter 1. Boost.NumericConversion">
+<link rel="up" href="../index.html" title="Chapter 1. Boost.NumericConversion">
</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">Home</td>
-<td align="center">Libraries</td>
+<td align="center">Libraries</td>
<td align="center">People</td>
<td align="center">FAQ</td>
<td align="center">More</td>
</tr></table>
<hr>
<div class="spirit-nav">
-<a accesskey="p" href="converter___function_object.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="bounds___traits_class.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
+<a accesskey="u" href="../index.html"><img src="../../../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../../../../doc/src/images/home.png" alt="Home"></a>
</div>
-<div class="section" title="Type Requirements and User-defined-types support">
+<div class="section">
<div class="titlepage"><div><div><h2 class="title" style="clear: both">
<a name="boost_numericconversion.type_requirements_and_user_defined_types_support"></a><a class="link" href="type_requirements_and_user_defined_types_support.html" title="Type Requirements and User-defined-types support">Type
 Requirements and User-defined-types support</a>
</h2></div></div></div>
-<div class="toc"><dl>
-<dt><a href="type_requirements_and_user_defined_types_support.html#boost_numericconversion.type_requirements_and_user_defined_types_support.type_requirements">Type
- Requirements</a></dt>
-<dt><a href="type_requirements_and_user_defined_types_support.html#boost_numericconversion.type_requirements_and_user_defined_types_support.udt_s_special_semantics">UDT's
- special semantics</a></dt>
-<dt><a href="type_requirements_and_user_defined_types_support.html#boost_numericconversion.type_requirements_and_user_defined_types_support.special_policies">Special
- Policies</a></dt>
-</dl></div>
-<div class="section" title="Type Requirements">
+
+ <div class="section">
<div class="titlepage"><div><div><h3 class="title">
<a name="boost_numericconversion.type_requirements_and_user_defined_types_support.type_requirements"></a><a class="link" href="type_requirements_and_user_defined_types_support.html#boost_numericconversion.type_requirements_and_user_defined_types_support.type_requirements" title="Type Requirements">Type
 Requirements</a>
</h3></div></div></div>
-
+
+ 
 Both arithmetic (built-in) and user-defined numeric types require proper
 specialization of <code class="computeroutput">std::numeric_limits<></code>
 (that is, with (in-class) integral constants).
 
-
+ 
 The library uses <code class="computeroutput">std::numeric_limits<T>::is_specialized</code> to detect whether the type
 is builtin or user defined, and <code class="computeroutput">std::numeric_limits<T>::is_integer</code>, <code class="computeroutput">std::numeric_limits<T>::is_signed</code> to detect whether the type is
 integer or floating point; and whether it is signed/unsigned.
 
-
+ 
 The default <code class="computeroutput">Float2IntRounder</code>
 policies uses unqualified calls to functions <code class="computeroutput">floor()</code> and <code class="computeroutput">ceil()</code>; but the standard functions are introduced
 in scope by a using directive:
 
<pre class="programlisting">using std::floor ; return floor(s);
</pre>
-
+ 
 Therefore, for builtin arithmetic types, the std functions will be used.
 User defined types should provide overloaded versions of these functions
 in order to use the default rounder policies. If these overloads are defined
@@ -65,25 +57,26 @@
 but if your compiler has a weak ADL you might need to put these functions
 some place else or write your own rounder policy.
 
-
+ 
 The default <code class="computeroutput">Trunc<></code>
 rounder policy needs to determine if the source value is positive or not,
 and for this it evaluates the expression <code class="computeroutput">s
 < static_cast<S>(0)</code>. Therefore,
 user defined types require a visible <code class="computeroutput">operator<</code> in order to use the <code class="computeroutput">Trunc<></code> policy (the default).
 
-</div>
-<div class="section" title="UDT's special semantics">
+ </div>
+ <div class="section">
<div class="titlepage"><div><div><h3 class="title">
<a name="boost_numericconversion.type_requirements_and_user_defined_types_support.udt_s_special_semantics"></a><a class="link" href="type_requirements_and_user_defined_types_support.html#boost_numericconversion.type_requirements_and_user_defined_types_support.udt_s_special_semantics" title="UDT's special semantics">UDT's
 special semantics</a>
</h3></div></div></div>
-<a name="boost_numericconversion.type_requirements_and_user_defined_types_support.udt_s_special_semantics.conversion_traits"></a><h5>
-<a name="id564459"></a>
- <a class="link" href="type_requirements_and_user_defined_types_support.html#boost_numericconversion.type_requirements_and_user_defined_types_support.udt_s_special_semantics.conversion_traits">Conversion
+
+ <h5>
+<a name="boost_numericconversion.type_requirements_and_user_defined_types_support.udt_s_special_semantics.h0"></a>
+ <a name="boost_numericconversion.type_requirements_and_user_defined_types_support.udt_s_special_semantics.conversion_traits"></a><a class="link" href="type_requirements_and_user_defined_types_support.html#boost_numericconversion.type_requirements_and_user_defined_types_support.udt_s_special_semantics.conversion_traits">Conversion
 Traits</a>
 </h5>
-
+ 
 If a User Defined Type is involved in a conversion, it is assumed
 that the UDT has <a class="link" href="definitions.html#boost_numericconversion.definitions.range_and_precision" title="Range and Precision">wider
 range</a> than any built-in type, and consequently the values of some
@@ -91,43 +84,88 @@
 members are hardwired regardless of the reality. The following table summarizes
 this:
 
-<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+ <div class="itemizedlist"><ul class="itemizedlist" type="disc">
+<li class="listitem">
+
+ <code class="computeroutput">Target=</code>UDT
+ and <code class="computeroutput">Source=</code>built-in
+ <div class="itemizedlist"><ul class="itemizedlist" type="circle">
+<li class="listitem">
+
+ <code class="computeroutput">subranged=false</code>
+
+ </li>
<li class="listitem">
-<code class="computeroutput">Target=</code>UDT
- and <code class="computeroutput">Source=</code>built-in<div class="itemizedlist"><ul class="itemizedlist" type="circle">
-<li class="listitem"><code class="computeroutput">subranged=false</code></li>
-<li class="listitem"><code class="computeroutput">supertype=Target</code></li>
-<li class="listitem"><code class="computeroutput">subtype=Source</code></li>
+
+ <code class="computeroutput">supertype=Target</code>
+
+ </li>
+<li class="listitem">
+
+ <code class="computeroutput">subtype=Source</code>
+
+ </li>
</ul></div>
-</li>
+
+ </li>
+<li class="listitem">
+
+ <code class="computeroutput">Target=</code>built-in
+ and <code class="computeroutput">Source=</code>UDT
+ <div class="itemizedlist"><ul class="itemizedlist" type="circle">
<li class="listitem">
-<code class="computeroutput">Target=</code>built-in
- and <code class="computeroutput">Source=</code>UDT<div class="itemizedlist"><ul class="itemizedlist" type="circle">
-<li class="listitem"><code class="computeroutput">subranged=true</code></li>
-<li class="listitem"><code class="computeroutput">supertype=Source</code></li>
-<li class="listitem"><code class="computeroutput">subtype=Target</code></li>
+
+ <code class="computeroutput">subranged=true</code>
+
+ </li>
+<li class="listitem">
+
+ <code class="computeroutput">supertype=Source</code>
+
+ </li>
+<li class="listitem">
+
+ <code class="computeroutput">subtype=Target</code>
+
+ </li>
</ul></div>
-</li>
+
+ </li>
+<li class="listitem">
+
+ <code class="computeroutput">Target=</code>UDT
+ and <code class="computeroutput">Source=</code>UDT
+ <div class="itemizedlist"><ul class="itemizedlist" type="circle">
+<li class="listitem">
+
+ <code class="computeroutput">subranged=false</code>
+
+ </li>
+<li class="listitem">
+
+ <code class="computeroutput">supertype=Target</code>
+
+ </li>
<li class="listitem">
-<code class="computeroutput">Target=</code>UDT
- and <code class="computeroutput">Source=</code>UDT<div class="itemizedlist"><ul class="itemizedlist" type="circle">
-<li class="listitem"><code class="computeroutput">subranged=false</code></li>
-<li class="listitem"><code class="computeroutput">supertype=Target</code></li>
-<li class="listitem"><code class="computeroutput">subtype=Source</code></li>
+
+ <code class="computeroutput">subtype=Source</code>
+
+ </li>
</ul></div>
-</li>
+
+ </li>
</ul></div>
-
+ 
 The <code class="computeroutput">Traits</code> member <code class="computeroutput">udt_mixture</code> can be used to detect whether
 a UDT is involved and to infer the validity of the other members as shown
 above.
 
-<a name="boost_numericconversion.type_requirements_and_user_defined_types_support.udt_s_special_semantics.range_checking"></a><h5>
-<a name="id564867"></a>
- <a class="link" href="type_requirements_and_user_defined_types_support.html#boost_numericconversion.type_requirements_and_user_defined_types_support.udt_s_special_semantics.range_checking">Range
+ <h5>
+<a name="boost_numericconversion.type_requirements_and_user_defined_types_support.udt_s_special_semantics.h1"></a>
+ <a name="boost_numericconversion.type_requirements_and_user_defined_types_support.udt_s_special_semantics.range_checking"></a><a class="link" href="type_requirements_and_user_defined_types_support.html#boost_numericconversion.type_requirements_and_user_defined_types_support.udt_s_special_semantics.range_checking">Range
 Checking</a>
 </h5>
-
+ 
 Because User Defined Numeric Types might have peculiar ranges (such as an
 unbounded range), this library does not attempt to supply a meaningful range
 checking logic when UDTs are involved in a conversion. Therefore, if either
@@ -137,51 +175,392 @@
 a user-defined range-checker. See <a class="link" href="type_requirements_and_user_defined_types_support.html#boost_numericconversion.type_requirements_and_user_defined_types_support.special_policies" title="Special Policies">Special
 Policies</a>
 
-</div>
-<div class="section" title="Special Policies">
+ </div>
+ <div class="section">
<div class="titlepage"><div><div><h3 class="title">
<a name="boost_numericconversion.type_requirements_and_user_defined_types_support.special_policies"></a><a class="link" href="type_requirements_and_user_defined_types_support.html#boost_numericconversion.type_requirements_and_user_defined_types_support.special_policies" title="Special Policies">Special
 Policies</a>
</h3></div></div></div>
-
+
+ 
 There are two components of the <code class="computeroutput">converter<></code> class that might require special
 behavior if User Defined Numeric Types are involved: the Range Checking and
 the Raw Conversion.
 
-
+ 
 When both Target and Source are built-in types, the converter class uses
 an internal range checking logic which is optimized and customized for the
 combined properties of the types.
 
-
+ 
 However, this internal logic is disabled when either type is User Defined.
 In this case, the user can specify an external range
- checking policy which will be used in place of the internal code. See <a class="link" href="numeric_converter_policy_classes.html#boost_numericconversion.numeric_converter_policy_classes.policy_userrangechecker" title="Policy UserRangeChecker">UserRangeChecker</a>
- policy for details.
+ checking policy which will be used in place of the internal code. See <a class="link" href="type_requirements_and_user_defined_types_support.html#boost_numericconversion.type_requirements_and_user_defined_types_support.udts_with_numeric_cast" title="UDTs with numeric_cast">numeric_cast_traits</a>
+ for details on using UDTs with <code class="computeroutput">numeric_cast</code>.
 
-
+ 
 The converter class performs the actual conversion using a Raw Converter
 policy. The default raw converter simply performs a <code class="computeroutput">static_cast<Target>(source)</code>.
 
-
+ 
 However, if the a UDT is involved, the <code class="computeroutput">static_cast</code>
 might not work. In this case, the user can implement and pass a different
 raw converter policy. See <a class="link" href="numeric_converter_policy_classes.html#boost_numericconversion.numeric_converter_policy_classes.policy_rawconverter" title="Policy RawConverter">RawConverter</a>
- policy for details
+ policy for details.
 
-</div>
-</div>
+ </div>
+ <div class="section">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="boost_numericconversion.type_requirements_and_user_defined_types_support.udts_with_numeric_cast"></a><a class="link" href="type_requirements_and_user_defined_types_support.html#boost_numericconversion.type_requirements_and_user_defined_types_support.udts_with_numeric_cast" title="UDTs with numeric_cast">UDTs
+ with numeric_cast</a>
+</h3></div></div></div>
+
+ 
+ In order to employ UDTs with <code class="computeroutput">numeric_cast</code>,
+ the user should define a <code class="computeroutput">numeric_cast_traits</code>
+ specialization on the UDT for each conversion. Here is an example of specializations
+ for converting between the UDT and any other type:
+ 
+<pre class="programlisting">namespace boost { namespace numeric {
+template <typename Source>
+struct numeric_cast_traits<UDT, Source>
+{
+ typedef conversion_traits<UDT, Source> conv_traits;
+
+ //! The following are required:
+ typedef YourOverflowHandlerPolicy overflow_policy;
+ typedef YourRangeCheckerPolicy<conv_traits> range_checking_policy;
+ typedef YourFloat2IntRounderPolicy<Source> rounding_policy;
+};
+template <typename Target>
+struct numeric_cast_traits<Target, UDT>
+{
+ typedef conversion_traits<Target, UDT> conv_traits;
+
+ //! The following are required:
+ typedef YourOverflowHandlerPolicy overflow_policy;
+ typedef YourRangeCheckerPolicy<conv_traits> range_checking_policy;
+ typedef YourFloat2IntRounderPolicy<UDT> rounding_policy;
+};
+}}//namespace boost::numeric;
+</pre>
+ 
+ These specializations are already defined with default values for the built-in
+ numeric types. It is possible to disable the generation of specializations
+ for built-in types by defining <code class="computeroutput">BOOST_NUMERIC_CONVERSION_RELAX_BUILT_IN_CAST_TRAITS</code>.
+ For details on defining custom policies see <a class="link" href="numeric_converter_policy_classes.html" title="Numeric Converter Policy Classes">Converter
+ Policies</a>.
+ 
+ 
+ Here is a full example of how to define a custom UDT for use with <code class="computeroutput">numeric_cast</code>:
+ 
+<pre class="programlisting">//! Define a simple custom number
+struct Double
+ : boost::ordered_field_operators
+ <
+ Double
+ , boost::ordered_field_operators2< Double, long double
+ , boost::ordered_field_operators2< Double, double
+ , boost::ordered_field_operators2< Double, float
+ , boost::ordered_field_operators2< Double, int
+ , boost::ordered_field_operators2< Double, unsigned int
+ , boost::ordered_field_operators2< Double, long
+ , boost::ordered_field_operators2< Double, unsigned long
+ , boost::ordered_field_operators2< Double, long long
+ , boost::ordered_field_operators2< Double, unsigned long long
+ , boost::ordered_field_operators2< Double, char
+ , boost::ordered_field_operators2< Double, unsigned char
+ , boost::ordered_field_operators2< Double, short
+ , boost::ordered_field_operators2< Double, unsigned short
+ > > > > > > > > > > > > > >
+{
+ Double()
+ : v(0)
+ {}
+
+ template <typename T>
+ explicit Double( T v )
+ : v(static_cast<double>(v))
+ {}
+
+ template <typename T>
+ Double& operator= ( T t )
+ {
+ v = static_cast<double>(t);
+ return *this;
+ }
+
+ bool operator < ( const Double& rhs ) const
+ {
+ return v < rhs.v;
+ }
+
+ template <typename T>
+ bool operator < ( T rhs ) const
+ {
+ return v < static_cast<double>(rhs);
+ }
+
+ bool operator > ( const Double& rhs ) const
+ {
+ return v > rhs.v;
+ }
+
+ template <typename T>
+ bool operator > ( T rhs ) const
+ {
+ return v > static_cast<double>(rhs);
+ }
+
+ bool operator ==( const Double& rhs ) const
+ {
+ return v == rhs.v;
+ }
+
+ template <typename T>
+ bool operator == ( T rhs ) const
+ {
+ return v == static_cast<double>(rhs);
+ }
+
+ bool operator !() const
+ {
+ return v == 0;
+ }
+
+ Double operator -() const
+ {
+ return Double(-v);
+ }
+
+ Double& operator +=( const Double& t )
+ {
+ v += t.v;
+ return *this;
+ }
+
+ template <typename T>
+ Double& operator +=( T t )
+ {
+ v += static_cast<double>(t);
+ return *this;
+ }
+
+ Double& operator -=( const Double& t )
+ {
+ v -= t.v;
+ return *this;
+ }
+
+ template <typename T>
+ Double& operator -=( T t )
+ {
+ v -= static_cast<double>(t);
+ return *this;
+ }
+
+ Double& operator *= ( const Double& factor )
+ {
+ v *= factor.v;
+ return *this;
+ }
+
+ template <typename T>
+ Double& operator *=( T t )
+ {
+ v *= static_cast<double>(t);
+ return *this;
+ }
+
+ Double& operator /= (const Double& divisor)
+ {
+ v /= divisor.v;
+ return *this;
+ }
+
+ template <typename T>
+ Double& operator /=( T t )
+ {
+ v /= static_cast<double>(t);
+ return (*this);
+ }
+
+ double v;
+};
+
+//! Define numeric_limits for the custom type.
+namespace std
+{
+ template<>
+ class numeric_limits<Double> : public numeric_limits<double>
+ {
+ public:
+
+ //! Limit our Double to a range of +/- 100.0
+ static Double (min)()
+ {
+ return Double(1.e-2);
+ }
+
+ static Double (max)()
+ {
+ return Double(1.e2);
+ }
+
+ static Double epsilon()
+ {
+ return Double( std::numeric_limits<double>::epsilon() );
+ }
+ };
+}
+
+//! Define range checking and overflow policies.
+namespace custom
+{
+ //! Define a custom range checker
+ template<typename Traits, typename OverFlowHandler>
+ struct range_checker
+ {
+ typedef typename Traits::argument_type argument_type ;
+ typedef typename Traits::source_type S;
+ typedef typename Traits::target_type T;
+
+ //! Check range of integral types.
+ static boost::numeric::range_check_result out_of_range( argument_type s )
+ {
+ using namespace boost::numeric;
+ if( s > bounds<T>::highest() )
+ return cPosOverflow;
+ else if( s < bounds<T>::lowest() )
+ return cNegOverflow;
+ else
+ return cInRange;
+ }
+
+ static void validate_range ( argument_type s )
+ {
+ BOOST_STATIC_ASSERT( std::numeric_limits<T>::is_bounded );
+ OverFlowHandler()( out_of_range(s) );
+ }
+ };
+
+ //! Overflow handler
+ struct positive_overflow{};
+ struct negative_overflow{};
+
+ struct overflow_handler
+ {
+ void operator() ( boost::numeric::range_check_result r )
+ {
+ using namespace boost::numeric;
+ if( r == cNegOverflow )
+ throw negative_overflow() ;
+ else if( r == cPosOverflow )
+ throw positive_overflow() ;
+ }
+ };
+
+ //! Define a rounding policy and specialize on the custom type.
+ template<class S>
+ struct Ceil : boost::numeric::Ceil<S>{};
+
+ template<>
+ struct Ceil<Double>
+ {
+ typedef Double source_type;
+
+ typedef Double const& argument_type;
+
+ static source_type nearbyint ( argument_type s )
+ {
+#if !defined(BOOST_NO_STDC_NAMESPACE)
+ using std::ceil ;
+#endif
+ return Double( ceil(s.v) );
+ }
+
+ typedef boost::mpl::integral_c< std::float_round_style, std::round_toward_infinity> round_style;
+ };
+
+ //! Define a rounding policy and specialize on the custom type.
+ template<class S>
+ struct Trunc: boost::numeric::Trunc<S>{};
+
+ template<>
+ struct Trunc<Double>
+ {
+ typedef Double source_type;
+
+ typedef Double const& argument_type;
+
+ static source_type nearbyint ( argument_type s )
+ {
+#if !defined(BOOST_NO_STDC_NAMESPACE)
+ using std::floor;
+#endif
+ return Double( floor(s.v) );
+ }
+
+ typedef boost::mpl::integral_c< std::float_round_style, std::round_toward_zero> round_style;
+ };
+}//namespace custom;
+
+namespace boost { namespace numeric {
+
+ //! Define the numeric_cast_traits specializations on the custom type.
+ template <typename S>
+ struct numeric_cast_traits<Double, S>
+ {
+ typedef custom::overflow_handler overflow_policy;
+ typedef custom::range_checker
+ <
+ boost::numeric::conversion_traits<Double, S>
+ , overflow_policy
+ > range_checking_policy;
+ typedef boost::numeric::Trunc<S> rounding_policy;
+ };
+
+ template <typename T>
+ struct numeric_cast_traits<T, Double>
+ {
+ typedef custom::overflow_handler overflow_policy;
+ typedef custom::range_checker
+ <
+ boost::numeric::conversion_traits<T, Double>
+ , overflow_policy
+ > range_checking_policy;
+ typedef custom::Trunc<Double> rounding_policy;
+ };
+
+ //! Define the conversion from the custom type to built-in types and vice-versa.
+ template<typename T>
+ struct raw_converter< conversion_traits< T, Double > >
+ {
+ static T low_level_convert ( const Double& n )
+ {
+ return static_cast<T>( n.v );
+ }
+ };
+
+ template<typename S>
+ struct raw_converter< conversion_traits< Double, S > >
+ {
+ static Double low_level_convert ( const S& n )
+ {
+ return Double(n);
+ }
+ };
+}}//namespace boost::numeric;
+</pre>
+ </div>
+ </div>
<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
<td align="left"></td>
-<td align="right"><div class="copyright-footer">Copyright © 2004 -2007 Fernando Luis Cacciola Carballal
- Distributed under the Boost Software License, Version 1.0. (See accompanying
- file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
- 
-</div></td>
+<td align="right"><div class="copyright-footer"></div></td>
</tr></table>
<hr>
<div class="spirit-nav">
-<a accesskey="p" href="converter___function_object.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="bounds___traits_class.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
+<a accesskey="u" href="../index.html"><img src="../../../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../../../../doc/src/images/home.png" alt="Home"></a>
</div>
</body>
</html>

Modified: branches/release/libs/numeric/conversion/doc/html/index.html
==============================================================================
--- branches/release/libs/numeric/conversion/doc/html/index.html (original)
+++ branches/release/libs/numeric/conversion/doc/html/index.html 2011-11-21 11:46:56 EST (Mon, 21 Nov 2011)
@@ -1,37 +1,38 @@
<html>
<head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
-<title>Chapter 1. Boost.NumericConversion</title>
+<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
+<title>Chapter 1. Boost.NumericConversion</title>
<link rel="stylesheet" href="boostbook.css" type="text/css">
-<meta name="generator" content="DocBook XSL Stylesheets V1.75.2">
-<link rel="home" href="index.html" title="Chapter 1. Boost.NumericConversion">
-<link rel="next" href="boost_numericconversion/definitions.html" title="Definitions">
+<meta name="generator" content="DocBook XSL-NS Stylesheets V1.76.1">
+<link rel="home" href="index.html" title="Chapter 1. Boost.NumericConversion">
</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">Home</td>
-<td align="center">Libraries</td>
+<td align="center">Libraries</td>
<td align="center">People</td>
<td align="center">FAQ</td>
<td align="center">More</td>
</tr></table>
<hr>
-<div class="spirit-nav"><a accesskey="n" href="boost_numericconversion/definitions.html"><img src="../../../../../doc/html/images/next.png" alt="Next"></a></div>
-<div class="chapter" title="Chapter 1. Boost.NumericConversion">
+<div class="spirit-nav"></div>
+<div class="chapter">
<div class="titlepage"><div>
<div><h2 class="title">
-<a name="numeric_conversion"></a>Chapter 1. Boost.NumericConversion</h2></div>
+<a name="numeric_conversion"></a>Chapter 1. Boost.NumericConversion</h2></div>
<div><div class="author"><h3 class="author">
Fernando Luis Cacciola Carballal
</h3></div></div>
-<div>Copyright © 2004 -2007 Fernando Luis Cacciola Carballal</div>
-<div><div class="legalnotice" title="Legal Notice">
-<a name="id553943"></a>
+<div>Copyright © 2004-2007 Fernando
+ Luis Cacciola Carballal</div>
+<div><div class="legalnotice">
+<a name="numeric_conversion.legal"></a>
+ 
 Distributed under the Boost Software License, Version 1.0. (See accompanying
- file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ file LICENSE_1_0.txt or copy at <a class="ulink" href="http://www.boost.org/LICENSE_1_0.txt" target="_top">http://www.boost.org/LICENSE_1_0.txt>)
 
-</div></div>
+ </div></div>
</div></div>
<div class="toc">
Table of Contents
@@ -76,6 +77,8 @@
 special semantics</a></dt>
<dt><a href="boost_numericconversion/type_requirements_and_user_defined_types_support.html#boost_numericconversion.type_requirements_and_user_defined_types_support.special_policies">Special
 Policies</a></dt>
+<dt><a href="boost_numericconversion/type_requirements_and_user_defined_types_support.html#boost_numericconversion.type_requirements_and_user_defined_types_support.udts_with_numeric_cast">UDTs
+ with numeric_cast</a></dt>
</dl></dd>
<dt><a href="boost_numericconversion/bounds___traits_class.html">bounds<>
 traits class</a></dt>
@@ -110,6 +113,7 @@
<dd><dl>
<dt>Introduction</dt>
<dt>numeric_cast</dt>
+<dt>numeric_cast_traits</dt>
<dt>Examples</dt>
</dl></dd>
<dt><a href="numeric_conversion/history_and_acknowledgments.html">History
@@ -117,61 +121,81 @@
<dt>Bibliography</dt>
</dl>
</div>
-<div class="section" title="Overview">
+
+
+ <div class="section">
<div class="titlepage"><div><div><h2 class="title" style="clear: both">
<a name="numeric_conversion.overview"></a><a class="link" href="index.html#numeric_conversion.overview" title="Overview">Overview</a>
</h2></div></div></div>
-
+
+ 
 The Boost Numeric Conversion library is a collection of tools to describe and
 perform conversions between values of different <a class="link" href="boost_numericconversion/definitions.html#boost_numericconversion.definitions.numeric_types" title="Numeric Types">numeric
 types</a>.
 
-
+ 
 The library includes a special alternative for a subset of <code class="computeroutput">std::numeric_limits<></code>, the <a class="link" href="boost_numericconversion/bounds___traits_class.html" title="bounds<> traits class">bounds<></a>
 traits class, which provides a consistent way to obtain the <a class="link" href="boost_numericconversion/definitions.html#boost_numericconversion.definitions.range_and_precision" title="Range and Precision">boundary</a>
 values for the <a class="link" href="boost_numericconversion/definitions.html#boost_numericconversion.definitions.range_and_precision" title="Range and Precision">range</a>
 of a numeric type.
 
-
+ 
 It also includes a set of <a class="link" href="boost_numericconversion/conversion_traits___traits_class.html" title="conversion_traits<> traits class">trait
 classes</a> which describes the compile-time properties of a conversion
 from a source to a target numeric type. Both <a class="link" href="boost_numericconversion/definitions.html#boost_numericconversion.definitions.c___arithmetic_types" title="C++ Arithmetic Types">arithmetic</a>
 and <a class="link" href="boost_numericconversion/definitions.html#boost_numericconversion.definitions.numeric_types" title="Numeric Types">user-defined
 numeric types</a> can be used.
 
-
+ 
 A policy-based <a class="link" href="boost_numericconversion/converter___function_object.html" title="converter<> function object">converter</a>
 object which uses <code class="computeroutput">conversion_traits</code>
 to select an optimized implementation is supplied. Such implementation uses
 an optimal range checking code suitable for the source/target combination.
 
-<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+ <div class="itemizedlist"><ul class="itemizedlist" type="disc">
<li class="listitem">
- The converter's out-of-range behavior can be customized via an <a class="link" href="boost_numericconversion/numeric_converter_policy_classes.html#boost_numericconversion.numeric_converter_policy_classes.policy_overflowhandler" title="Policy OverflowHandler">OverflowHandler</a>
- policy.
+
+ The converter's out-of-range behavior can be customized via an <a class="link" href="boost_numericconversion/numeric_converter_policy_classes.html#boost_numericconversion.numeric_converter_policy_classes.policy_overflowhandler" title="Policy OverflowHandler">OverflowHandler</a>
+ policy.
+
 </li>
<li class="listitem">
- For floating-point to integral conversions, the rounding mode can be selected
- via the <a class="link" href="boost_numericconversion/numeric_converter_policy_classes.html#boost_numericconversion.numeric_converter_policy_classes.policy_float2introunder" title="Policy Float2IntRounder">Float2IntRounder</a>
- policy.
+
+ For floating-point to integral conversions, the rounding mode can be selected
+ via the <a class="link" href="boost_numericconversion/numeric_converter_policy_classes.html#boost_numericconversion.numeric_converter_policy_classes.policy_float2introunder" title="Policy Float2IntRounder">Float2IntRounder</a>
+ policy.
+
 </li>
<li class="listitem">
- A custom low-level conversion routine (for UDTs for instance) can be passed
- via a <a class="link" href="boost_numericconversion/numeric_converter_policy_classes.html#boost_numericconversion.numeric_converter_policy_classes.policy_rawconverter" title="Policy RawConverter">RawConverter</a>
- policy.
+
+ A custom low-level conversion routine (for UDTs for instance) can be passed
+ via a <a class="link" href="boost_numericconversion/numeric_converter_policy_classes.html#boost_numericconversion.numeric_converter_policy_classes.policy_rawconverter" title="Policy RawConverter">RawConverter</a>
+ policy.
+
 </li>
<li class="listitem">
- The optimized automatic range-checking logic can be overridden via a <a class="link" href="boost_numericconversion/numeric_converter_policy_classes.html#boost_numericconversion.numeric_converter_policy_classes.policy_userrangechecker" title="Policy UserRangeChecker">UserRangeChecker</a>
- policy.
+
+ The optimized automatic range-checking logic can be overridden via a <a class="link" href="boost_numericconversion/numeric_converter_policy_classes.html#boost_numericconversion.numeric_converter_policy_classes.policy_userrangechecker" title="Policy UserRangeChecker">UserRangeChecker</a>
+ policy.
+
 </li>
</ul></div>
-</div>
+ </div>
+
+
+
+
+
+
+
+
+
</div>
<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
-<td align="left">Last revised: November 20, 2009 at 09:59:43 GMT</td>
+<td align="left">Last revised: November 21, 2011 at 16:44:25 GMT</td>
<td align="right"><div class="copyright-footer"></div></td>
</tr></table>
<hr>
-<div class="spirit-nav"><a accesskey="n" href="boost_numericconversion/definitions.html"><img src="../../../../../doc/html/images/next.png" alt="Next"></a></div>
+<div class="spirit-nav"></div>
</body>
</html>

Modified: branches/release/libs/numeric/conversion/doc/html/numeric_conversion/bibliography.html
==============================================================================
--- branches/release/libs/numeric/conversion/doc/html/numeric_conversion/bibliography.html (original)
+++ branches/release/libs/numeric/conversion/doc/html/numeric_conversion/bibliography.html 2011-11-21 11:46:56 EST (Mon, 21 Nov 2011)
@@ -1,86 +1,107 @@
<html>
<head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<title>Bibliography</title>
<link rel="stylesheet" href="../boostbook.css" type="text/css">
-<meta name="generator" content="DocBook XSL Stylesheets V1.75.2">
-<link rel="home" href="../index.html" title="Chapter 1. Boost.NumericConversion">
-<link rel="up" href="../index.html" title="Chapter 1. Boost.NumericConversion">
-<link rel="prev" href="history_and_acknowledgments.html" title="History and Acknowledgments">
+<meta name="generator" content="DocBook XSL-NS Stylesheets V1.76.1">
+<link rel="home" href="../index.html" title="Chapter 1. Boost.NumericConversion">
+<link rel="up" href="../index.html" title="Chapter 1. Boost.NumericConversion">
</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">Home</td>
-<td align="center">Libraries</td>
+<td align="center">Libraries</td>
<td align="center">People</td>
<td align="center">FAQ</td>
<td align="center">More</td>
</tr></table>
<hr>
<div class="spirit-nav">
-<a accesskey="p" href="history_and_acknowledgments.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a>
+<a accesskey="u" href="../index.html"><img src="../../../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../../../../doc/src/images/home.png" alt="Home"></a>
</div>
-<div class="section" title="Bibliography">
+<div class="section">
<div class="titlepage"><div><div><h2 class="title" style="clear: both">
<a name="numeric_conversion.bibliography"></a><a class="link" href="bibliography.html" title="Bibliography">Bibliography</a>
</h2></div></div></div>
-<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+
+ <div class="itemizedlist"><ul class="itemizedlist" type="disc">
<li class="listitem">
- Standard Documents:
- <div class="orderedlist"><ol class="orderedlist" type="1">
-<li class="listitem">
- ISO/IEC 14882:98 (C++98 Standard)
- </li>
-<li class="listitem">
- ISO/IEC 9899:1999 (C99 Standard)
- </li>
-<li class="listitem">
- ISO/IEC 10967-1 (Language Independent Arithmetic (LIA), Part I, 1994)
- </li>
-<li class="listitem">
- ISO/IEC 2382-1:1993 (Information Technology - Vocabulary - Part I: Fundamental
- Terms)
- </li>
-<li class="listitem">
- ANSI/IEEE 754-1985 [and IEC 60559:1989] (Binary floating-point)
- </li>
-<li class="listitem">
- ANSI/IEEE 854-1988 (Radix Independent floating-point)
- </li>
-<li class="listitem">
- ANSI X3/TR-1-82 (Dictionary for Information Processing Systems)
- </li>
-<li class="listitem">
- ISO/IEC JTC1/SC22/WG14/N753 C9X Revision Proposal: LIA-1 Binding: Rationale
- </li>
+
+ Standard Documents:
+ <div class="orderedlist"><ol class="orderedlist" type="1">
+<li class="listitem">
+
+ ISO/IEC 14882:98 (C++98 Standard)
+
+ </li>
+<li class="listitem">
+
+ ISO/IEC 9899:1999 (C99 Standard)
+
+ </li>
+<li class="listitem">
+
+ ISO/IEC 10967-1 (Language Independent Arithmetic (LIA), Part I, 1994)
+
+ </li>
+<li class="listitem">
+
+ ISO/IEC 2382-1:1993 (Information Technology - Vocabulary - Part I:
+ Fundamental Terms)
+
+ </li>
+<li class="listitem">
+
+ ANSI/IEEE 754-1985 [and IEC 60559:1989] (Binary floating-point)
+
+ </li>
+<li class="listitem">
+
+ ANSI/IEEE 854-1988 (Radix Independent floating-point)
+
+ </li>
+<li class="listitem">
+
+ ANSI X3/TR-1-82 (Dictionary for Information Processing Systems)
+
+ </li>
+<li class="listitem">
+
+ ISO/IEC JTC1/SC22/WG14/N753 C9X Revision Proposal: LIA-1 Binding:
+ Rationale
+
+ </li>
</ol></div>
-</li>
-<li class="listitem">
- Papers:
- <div class="orderedlist"><ol class="orderedlist" type="1">
+
+ </li>
<li class="listitem">
- David Goldberg What Every Computer Scientist Should Know About Floating-Point
- Arithmetic
- </li>
-<li class="listitem">
- Prof. William Kahan papers on floating-point.
- </li>
+
+ Papers:
+ <div class="orderedlist"><ol class="orderedlist" type="1">
+<li class="listitem">
+
+ David Goldberg What Every Computer Scientist Should Know About Floating-Point
+ Arithmetic
+
+ </li>
+<li class="listitem">
+
+ Prof. William Kahan papers on floating-point.
+
+ </li>
</ol></div>
-</li>
+
+ </li>
</ul></div>
-</div>
+ </div>
<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
<td align="left"></td>
-<td align="right"><div class="copyright-footer">Copyright © 2004 -2007 Fernando Luis Cacciola Carballal
- Distributed under the Boost Software License, Version 1.0. (See accompanying
- file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
- 
-</div></td>
+<td align="right"><div class="copyright-footer"></div></td>
</tr></table>
<hr>
<div class="spirit-nav">
-<a accesskey="p" href="history_and_acknowledgments.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a>
+<a accesskey="u" href="../index.html"><img src="../../../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../../../../doc/src/images/home.png" alt="Home"></a>
</div>
</body>
</html>

Modified: branches/release/libs/numeric/conversion/doc/html/numeric_conversion/history_and_acknowledgments.html
==============================================================================
--- branches/release/libs/numeric/conversion/doc/html/numeric_conversion/history_and_acknowledgments.html (original)
+++ branches/release/libs/numeric/conversion/doc/html/numeric_conversion/history_and_acknowledgments.html 2011-11-21 11:46:56 EST (Mon, 21 Nov 2011)
@@ -1,96 +1,105 @@
<html>
<head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<title>History and Acknowledgments</title>
<link rel="stylesheet" href="../boostbook.css" type="text/css">
-<meta name="generator" content="DocBook XSL Stylesheets V1.75.2">
-<link rel="home" href="../index.html" title="Chapter 1. Boost.NumericConversion">
-<link rel="up" href="../index.html" title="Chapter 1. Boost.NumericConversion">
-<link rel="prev" href="../boost_numericconversion/improved_numeric_cast__.html" title="Improved numeric_cast<>">
-<link rel="next" href="bibliography.html" title="Bibliography">
+<meta name="generator" content="DocBook XSL-NS Stylesheets V1.76.1">
+<link rel="home" href="../index.html" title="Chapter 1. Boost.NumericConversion">
+<link rel="up" href="../index.html" title="Chapter 1. Boost.NumericConversion">
</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">Home</td>
-<td align="center">Libraries</td>
+<td align="center">Libraries</td>
<td align="center">People</td>
<td align="center">FAQ</td>
<td align="center">More</td>
</tr></table>
<hr>
<div class="spirit-nav">
-<a accesskey="p" href="../boost_numericconversion/improved_numeric_cast__.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="bibliography.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
+<a accesskey="u" href="../index.html"><img src="../../../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../../../../doc/src/images/home.png" alt="Home"></a>
</div>
-<div class="section" title="History and Acknowledgments">
+<div class="section">
<div class="titlepage"><div><div><h2 class="title" style="clear: both">
<a name="numeric_conversion.history_and_acknowledgments"></a><a class="link" href="history_and_acknowledgments.html" title="History and Acknowledgments">History
 and Acknowledgments</a>
</h2></div></div></div>
-<a name="numeric_conversion.history_and_acknowledgments.pre_formal_review"></a><h4>
-<a name="id575108"></a>
- <a class="link" href="history_and_acknowledgments.html#numeric_conversion.history_and_acknowledgments.pre_formal_review">Pre-formal
+
+ <h4>
+<a name="numeric_conversion.history_and_acknowledgments.h0"></a>
+ <a name="numeric_conversion.history_and_acknowledgments.pre_formal_review"></a><a class="link" href="history_and_acknowledgments.html#numeric_conversion.history_and_acknowledgments.pre_formal_review">Pre-formal
 review</a>
 </h4>
-<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+ <div class="itemizedlist"><ul class="itemizedlist" type="disc">
<li class="listitem">
- Kevlin Henney, with help from David Abrahams and Beman Dawes, originally
- contributed the previous version of <code class="computeroutput">numeric_cast<></code> which already presented the idea
- of a runtime range check.
- </li>
-<li class="listitem">
- Later, Eric Ford, Kevin Lynch and the author spotted some genericity problems
- with that <code class="computeroutput">numeric_cast<></code>
- which prevented it from being used in a generic layer of math functions.
- </li>
-<li class="listitem">
- An improved <code class="computeroutput">numeric_cast<></code> which properly handled all combinations
- of arithmetic types was presented.
- </li>
-<li class="listitem">
- David Abrahams and Beman Dawes acknowledged the need of an improved version
- of <code class="computeroutput">numeric_cast<></code>
- and supported the submission as originally laid out. Daryl Walker and Darin
- Adler made some important comments and proposed fixes to the original submission.
- </li>
-<li class="listitem">
- Special thanks go to Björn Karlsoon who helped the author considerably.
- Having found the problems with <code class="computeroutput">numeric_cast<></code> himself, he revised very carefully
- the original submission and spot a subtle bug in the range checking implementation.
- He also wrote part of this documentation and proof-read and corrected other
- parts. And most importantly: the features now presented here in this library
- evolved from the original submission as a result of the useful private communications
- between Björn and the author.
+
+ Kevlin Henney, with help from David Abrahams and Beman Dawes, originally
+ contributed the previous version of <code class="computeroutput">numeric_cast<></code> which already presented the idea
+ of a runtime range check.
+
+ </li>
+<li class="listitem">
+
+ Later, Eric Ford, Kevin Lynch and the author spotted some genericity problems
+ with that <code class="computeroutput">numeric_cast<></code> which prevented it from being used
+ in a generic layer of math functions.
+
+ </li>
+<li class="listitem">
+
+ An improved <code class="computeroutput">numeric_cast<></code> which properly handled all combinations
+ of arithmetic types was presented.
+
+ </li>
+<li class="listitem">
+
+ David Abrahams and Beman Dawes acknowledged the need of an improved version
+ of <code class="computeroutput">numeric_cast<></code>
+ and supported the submission as originally laid out. Daryl Walker and Darin
+ Adler made some important comments and proposed fixes to the original submission.
+
+ </li>
+<li class="listitem">
+
+ Special thanks go to Björn Karlsoon who helped the author considerably.
+ Having found the problems with <code class="computeroutput">numeric_cast<></code> himself, he revised very carefully
+ the original submission and spot a subtle bug in the range checking implementation.
+ He also wrote part of this documentation and proof-read and corrected other
+ parts. And most importantly: the features now presented here in this library
+ evolved from the original submission as a result of the useful private
+ communications between Björn and the author.
+
 </li>
</ul></div>
-<a name="numeric_conversion.history_and_acknowledgments.post_formal_review"></a><h4>
-<a name="id575242"></a>
- <a class="link" href="history_and_acknowledgments.html#numeric_conversion.history_and_acknowledgments.post_formal_review">Post-formal
+ <h4>
+<a name="numeric_conversion.history_and_acknowledgments.h1"></a>
+ <a name="numeric_conversion.history_and_acknowledgments.post_formal_review"></a><a class="link" href="history_and_acknowledgments.html#numeric_conversion.history_and_acknowledgments.post_formal_review">Post-formal
 review</a>
 </h4>
-<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+ <div class="itemizedlist"><ul class="itemizedlist" type="disc">
<li class="listitem">
- Guillaume Melquiond spoted some documentation and code issues, particularly
- about rounding conversions.
+
+ Guillaume Melquiond spoted some documentation and code issues, particularly
+ about rounding conversions.
+
 </li>
<li class="listitem">
- The following people contributed an important review of the design, documentation
- and c ode: Kevin Lynch, Thorsten Ottosen, Paul Bristow, Daryle Walker, Jhon
- Torjo, Eric Ford, Gennadiy Rozental.
+
+ The following people contributed an important review of the design, documentation
+ and c ode: Kevin Lynch, Thorsten Ottosen, Paul Bristow, Daryle Walker,
+ Jhon Torjo, Eric Ford, Gennadiy Rozental.
+
 </li>
</ul></div>
-</div>
+ </div>
<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
<td align="left"></td>
-<td align="right"><div class="copyright-footer">Copyright © 2004 -2007 Fernando Luis Cacciola Carballal
- Distributed under the Boost Software License, Version 1.0. (See accompanying
- file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
- 
-</div></td>
+<td align="right"><div class="copyright-footer"></div></td>
</tr></table>
<hr>
<div class="spirit-nav">
-<a accesskey="p" href="../boost_numericconversion/improved_numeric_cast__.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="bibliography.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
+<a accesskey="u" href="../index.html"><img src="../../../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../../../../doc/src/images/home.png" alt="Home"></a>
</div>
</body>
</html>

Next message: john_at_[hidden]: "[Boost-commit] svn:boost r75597 - sandbox/big_number/boost/multiprecision"
Previous message: joel_at_[hidden]: "[Boost-commit] svn:boost r75595 - in trunk/boost/fusion/container/vector: . detail/preprocessed"

Date view	Thread view	Subject view	Author view

Boost-Commit list run by bdawes at acm.org, david.abrahams at rcn.com, gregod at cs.rpi.edu, cpdaniel at pacbell.net, john at johnmaddock.co.uk