Planet
navi homePPSaboutscreenshotsdownloaddevelopmentforum

source: downloads/boost_1_33_1/libs/numeric/conversion/doc/numeric_cast.html @ 12

Last change on this file since 12 was 12, checked in by landauf, 17 years ago

added boost
File size: 5.1 KB
Line 
1<HTML>
2  <HEAD>
3         <LINK REL="stylesheet" TYPE="text/css" HREF="../../../../boost.css">
4         <TITLE>Boost Numeric Conversion Library - numeric_cast</TITLE>
5  </HEAD>
6  <BODY BGCOLOR="#FFFFFF" TEXT="#000000">
7         <TABLE BORDER="0" CELLPADDING="7" CELLSPACING="0" WIDTH="100%"
8          SUMMARY="header">
9                <TR>
10                  <TH VALIGN="top" WIDTH="300">
11                         <H3><A HREF="../../../../index.htm"><IMG HEIGHT="86" WIDTH="277"
12                                ALT="C++ Boost" SRC="../../../../boost.png" BORDER="0"></A></H3> </TH> 
13                  <TH VALIGN="top"> 
14                         <H1 ALIGN="center">Boost Numeric Conversion Library</H1> 
15                         <H1><A HREF="http://www.boost.org">Header </A><A
16                                HREF="../../../../boost/numeric/conversion/cast.hpp">boost/numeric/conversion/cast.hpp</A></H1> </TH>
17                </TR>
18         </TABLE><HR>
19         <H2>Contents</H2>
20         <UL>
21                <LI><A HREF="#introduction">Introduction</A></LI>
22                <LI><A HREF="#numeric_cast"><CODE>numeric_cast</CODE></A></LI>
23                <LI><A HREF="#examples">Examples</A></LI>
24         </UL> <HR>
25         <H2><A NAME="introduction">Introduction</A></H2>
26         <P>The lack of preservation of range makes conversions between numeric
27                types error prone. This is true for both implicit conversions and explicit
28                conversions (through static_cast). <A HREF="#numeric_cast"> numeric_cast</A>
29                detects loss of range when a numeric type is converted, and throws an
30                exception if the range cannot be preserved.</P>
31         <P>There are several situations where conversions are unsafe: </P>
32         <UL>
33                <LI>Conversions from an integral type with a wider range than the target
34                  integral type.</LI>
35                <LI> Conversions from unsigned to signed (and vice versa) integral
36                  types.</LI>
37                <LI> Conversions from floating point types to integral types.</LI>
38         </UL>
39         <P>The C++ Standard does not specify the behavior when a numeric type is
40                assigned a value that cannot be represented by the type, except for unsigned
41                integral types [3.9.1.4], which must obey the laws of arithmetic modulo
42                2<SUP>n</SUP> (this implies that the result will be reduced modulo the number
43                that is one greater than the largest value that can be represented). The fact
44                that the behavior for overflow is undefined for all conversions (except the
45                aforementioned unsigned to unsigned) makes any code that may produce positive
46                or negative overflows exposed to portability issues.</P>
47         <P>numeric_cast adheres to the rules for implicit conversions mandated by
48                the C++ Standard, such as truncating floating point types when converting to
49                integral types. The implementation must guarantee that for a conversion to a
50                type that can hold all possible values of the source type, there will be no
51                runtime overhead. <BR> <BR> </P> <HR>
52         <H2><A NAME="numeric_cast"><CODE>numeric_cast</CODE></A></H2>
53         <BLOCKQUOTE>
54                <PRE>template&lt;typename Target, typename Source&gt; inline
55typename boost::numeric::converter&lt;Traget,Source&gt;::result_type
56numeric_cast ( Source arg )
57{
58   return boost::numeric::converter&lt;Traget,Source&gt;::convert(arg);
59}
60</PRE> </BLOCKQUOTE>
61         <P>numeric_cast returns the result of converting a value of type Source to a value of type
62                Target. If out-of-range is detected, an exception is thrown (see
63                <A HREF="converter_policies.html#bad_numc">bad_numeric_cast</A>, <A
64                HREF="converter_policies.html#posovr">positive_overflow</A> and
65                <A HREF="converter_policies.html#negovr">negative_overflow</A>). <BR> <BR> </P> <HR>
66         <H2><A NAME="examples">Examples</A></H2>
67         <P>The following example performs some typical conversions between numeric
68                types: </P>
69         <BLOCKQUOTE>
70                <PRE>#include &lt;boost/numeric_cast.hpp&gt;
71#include &lt;iostream&gt;
72
73int main()
74{
75   using boost::numeric_cast;
76   using boost::bad_numeric_cast;
77   using boost::positive_overflow;
78   using boost::negative_overflow;
79      try {
80      int i=42;
81      short s=numeric_cast&lt;short&gt;(i);
82   }
83   catch(negative_overflow&amp; e) {
84      std::cout &lt;&lt; e.what();
85   }
86   catch(positive_overflow&amp; e) {
87      std::cout &lt;&lt; e.what();
88   }
89
90   try {
91      float f=-42.1234;
92      // This will cause a boost::negative_underflow exception to be thrown
93      unsigned int i=numeric_cast&lt;unsigned int&gt;(f);
94
95      double d=f+numeric_cast&lt;double&gt;(i);
96
97      unsigned long l=std::numeric_limits&lt;unsigned long&gt;::max();
98      // This works, because unsigned integral types cannot cause overflow.
99      unsigned char c=numeric_cast&lt;unsigned char&gt;(l);
100
101      unsigned short us=std::numeric_limits&lt;unsigned short&gt;::max();
102      // This will cause an positive_overflow exception to be thrown
103      short s=numeric_cast&lt;short&gt;(us);
104
105   }
106   catch(bad_numeric_cast&amp; e) {
107      std::cout &lt;&lt; e.what();
108   }
109
110   return 0;
111}</PRE> </BLOCKQUOTE> <BR> <BR> <HR>
112<HR>
113<P>Back to <A HREF="index.html">Numeric Conversion library index</A></P>
114<HR>
115<P>Revised 23 June 2004</P>
116<p>© Copyright Boost 1999</p>
117<p>© Copyright Fernando Luis Cacciola Carballal, 1999,2004</p>
118<p> Use, modification, and distribution are subject to the Boost Software
119License, Version 1.0. (See accompanying file <a href="../../../../LICENSE_1_0.txt">
120LICENSE_1_0.txt</a> or copy at <a href="http://www.boost.org/LICENSE_1_0.txt">
121www.boost.org/LICENSE_1_0.txt</a>)</p>
122</BODY>
123</HTML>
Note: See TracBrowser for help on using the repository browser.