This commit was manufactured by cvs2svn to create tag

'Version_1_20_2'. [SVN r9073]
2026-08-06 13:34:14 +02:00 · 2001-02-10 14:52:07 +00:00
5 changed files with 41 additions and 54 deletions
@@ -1,5 +1,3 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
-
 <html>

 <head>
@@ -11,49 +9,46 @@

 <body bgcolor="#FFFFFF" text="#000000">

-<h1><img src="../../c++boost.gif" alt="c++boost.gif (8819 bytes)" align="middle" width="277" height="86">Header
+<h1><img src="../../c++boost.gif" alt="c++boost.gif (8819 bytes)" align="center" width="277" height="86">Header
 <a href="../../boost/cast.hpp">boost/cast.hpp</a></h1>
-
 <h2><a name="Cast Functions">Cast Functions</a></h2>
-
-<p>The header <a href="../../boost/cast.hpp">boost/cast.hpp</a>
+<p>The <code>header <a href="../../boost/cast.hpp">boost/cast.hpp</a></code>
 provides <a href="#Polymorphic_cast"><b>polymorphic_cast</b></a>, <a href="#Polymorphic_cast"><b>polymorphic_downcast</b></a>,
 and <a href="#numeric_cast"><b>numeric_cast</b></a> function templates designed
 to complement the C++ built-in casts.</p>
-
-<p>The program <a href="cast_test.cpp">cast_test.cpp</a> can be used to
+<p>The program&nbsp;<a href="cast_test.cpp">cast_test.cpp</a> can be used to
 verify these function templates work as expected.</p>
 <h3><a name="Polymorphic_cast">Polymorphic casts</a></h3>
 <p>Pointers to polymorphic objects (objects of classes which define at least one
-virtual function) are sometimes downcast or crosscast. Downcasting means
-casting from a base class to a derived class. Crosscasting means casting
+virtual function) are sometimes downcast or crosscast.&nbsp; Downcasting means
+casting from a base class to a derived class.&nbsp; Crosscasting means casting
 across an inheritance hierarchy diagram, such as from one base to the other in a
 <b>Y</b> diagram hierarchy.</p>
 <p>Such casts can be done with old-style casts, but this approach is never to be
-recommended. Old-style casts are sorely lacking in type safety, suffer
+recommended.&nbsp; Old-style casts are sorely lacking in type safety, suffer
 poor readability, and are difficult to locate with search tools.</p>
 <p>The C++ built-in <b>static_cast</b> can be used for efficiently downcasting
 pointers to polymorphic objects, but provides no error detection for the case
 where the pointer being cast actually points to the wrong derived class. The <b>polymorphic_downcast</b>
 template retains the efficiency of <b>static_cast</b> for non-debug
 compilations, but for debug compilations adds safety via an assert() that a <b>dynamic_cast</b>
-succeeds.</p>
+succeeds.&nbsp;<b>&nbsp;</b></p>
 <p>The C++ built-in <b>dynamic_cast</b> can be used for downcasts and crosscasts
 of pointers to polymorphic objects, but error notification in the form of a
 returned value of 0 is inconvenient to test, or worse yet, easy to forget to
-test. The <b>polymorphic_cast</b> template performs a <b>dynamic_cast</b>,
+test.&nbsp; The <b>polymorphic_cast</b> template performs a <b>dynamic_cast</b>,
 and throws an exception if the <b>dynamic_cast</b> returns 0.</p>
 <p>A <b>polymorphic_downcast</b> is preferred when debug-mode tests will cover
 100% of the object types possibly cast and when non-debug-mode efficiency is an
 issue. If these two conditions are not present, <b>polymorphic_cast</b> is
-preferred. It must also be used for crosscasts. It does an assert(
+preferred.&nbsp; It must also be used for crosscasts.&nbsp; It does an assert(
 dynamic_cast&lt;Derived&gt;(x) == x ) where x is the base pointer, ensuring that
 not only is a non-zero pointer returned, but also that it correct in the
 presence of multiple inheritance.<b> Warning:</b>: Because <b>polymorphic_downcast</b>
 uses assert(), it violates the one definition rule (ODR) if NDEBUG is inconsistently
-defined across translation units. [See ISO Std 3.2]</p>
+defined across translation units.&nbsp; [See ISO Std 3.2]</p>
 <p>The C++ built-in <b>dynamic_cast</b> must be used to cast references rather
-than pointers. It is also the only cast that can be used to check whether
+than pointers.&nbsp; It is also the only cast that can be used to check whether
 a given interface is supported; in that case a return of 0 isn't an error
 condition.</p>
 <h3>polymorphic_cast and polymorphic_downcast synopsis</h3>
@@ -137,7 +132,7 @@ Abrahams</a>.<b><br>
 numeric_cast</b> was contributed by <a href="../../people/kevlin_henney.htm">Kevlin
 Henney</a>.</p>
 <hr>
-<p>Revised <!--webbot bot="Timestamp" s-type="EDITED" s-format="%d %B, %Y" startspan
+<p>Revised&nbsp; <!--webbot bot="Timestamp" s-type="EDITED" s-format="%d %B, %Y" startspan
 -->06 January, 2001<!--webbot bot="Timestamp" endspan i-checksum="38320"
 --></p>
 <p>© Copyright boost.org 1999. Permission to copy, use, modify, sell and
@@ -16,7 +16,6 @@

 #include <iostream>
 #include <climits>
-#include <cfloat>   // for DBL_MAX (Peter Schmid)
 #include <boost/cast.hpp>

 #  if SCHAR_MAX == LONG_MAX
@@ -9,10 +9,6 @@
 //  See http://www.boost.org for most recent version including documentation.

 //  Revision History
-//  02 Apr 01  Removed BOOST_NO_LIMITS workarounds and included 
-//             <boost/limits.hpp> instead (the workaround did not 
-//             actually compile when BOOST_NO_LIMITS was defined in 
-//             any case, so we loose nothing). (John Maddock)
 //  21 Jan 01  Undid a bug I introduced yesterday. numeric_cast<> never
 //             worked with stock GCC; trying to get it to do that broke
 //             vc-stlport.
@@ -47,7 +43,9 @@
 # include <cassert>
 # include <typeinfo>
 # include <boost/type.hpp>
-# include <boost/limits.hpp>
+# ifndef BOOST_NO_LIMITS
+#  include <limits>
+# endif

 //  It has been demonstrated numerous times that MSVC 6.0 fails silently at link
 //  time if you use a template function which has template parameters that don't
@@ -121,7 +119,7 @@ namespace boost

 //  numeric_cast  ------------------------------------------------------------//

-#if !defined(BOOST_NO_LIMITS_COMPILE_TIME_CONSTANTS) || defined(BOOST_SGI_CPP_LIMITS)
+#ifndef BOOST_NO_LIMITS_COMPILE_TIME_CONSTANTS
  
    namespace detail
    {
@@ -133,7 +131,7 @@ namespace boost
         template <class T>
         struct limits : std::numeric_limits<T>
         {
-         static inline T min()
+    	   static inline T min()
 # ifndef __GNUC__ // bug workaround courtesy Jens Maurer
             {
                 return std::numeric_limits<T>::min() >= 0
@@ -144,7 +142,7 @@ namespace boost
 # else
                 ;
 # endif
-         };
+	       };
       };

 # ifdef __GNUC__ // bug workaround courtesy Jens Maurer
@@ -268,6 +266,7 @@ namespace boost
 #  pragma option push -w-8041
 # endif

+# ifndef BOOST_NO_LIMITS
       // Move to namespace boost in utility.hpp?
       template <class T>
       struct fixed_numeric_limits : public std::numeric_limits<T>
@@ -278,6 +277,7 @@ namespace boost
                   ? T(-std::numeric_limits<T>::max()) : std::numeric_limits<T>::min();
           }
       };
+# endif // BOOST_NO_LIMITS
  
 # if BOOST_MSVC
 #  pragma warning(pop)
@@ -291,11 +291,13 @@ namespace boost
    template<typename Target, typename Source>
    inline Target numeric_cast(Source arg BOOST_EXPLICIT_DEFAULT_TARGET)
    {
+#ifndef BOOST_NO_LIMITS
        // typedefs abbreviating respective trait classes
        typedef std::numeric_limits<Source> arg_traits;
        typedef detail::fixed_numeric_limits<Target> result_traits;
+#endif
        
-#if !defined(BOOST_NO_LIMITS_COMPILE_TIME_CONSTANTS) || defined(BOOST_SGI_CPP_LIMITS)
+#ifndef BOOST_NO_LIMITS_COMPILE_TIME_CONSTANTS
        // typedefs that act as compile time assertions
        // (to be replaced by boost compile time assertions
        // as and when they become available and are stable)
@@ -13,18 +13,11 @@
 // where: tested with MSVC 6.0, BCC 5.5, and g++ 2.91

 #include <boost/config.hpp>
-
-// Some sstream implementations are broken for the purposes of lexical cast.
-# if defined(BOOST_NO_STRINGSTREAM)
-#  define BOOST_LEXICAL_CAST_USE_STRSTREAM
+# ifndef BOOST_NO_STRINGSTREAM
+#  include <sstream>
+# else
+#  include <strstream>
 # endif
-
-#ifdef BOOST_LEXICAL_CAST_USE_STRSTREAM
-# include <strstream>
-#else
-# include <sstream>
-#endif
-
 #include <typeinfo>

 namespace boost
@@ -46,10 +39,10 @@ namespace boost
    template<typename Target, typename Source>
    Target lexical_cast(Source arg)
    {
-# ifdef BOOST_LEXICAL_CAST_USE_STRSTREAM
-        std::strstream interpreter; // for out-of-the-box g++ 2.95.2
-# else
+# ifndef BOOST_NO_STRINGSTREAM
        std::stringstream interpreter;
+# else
+        std::strstream interpreter; // for out-of-the-box g++ 2.95.2
 # endif
        Target result;

@@ -61,16 +54,14 @@ namespace boost
    }
 }

-// Copyright Kevlin Henney, 2000, 2001, 2002. All rights reserved.
+// Copyright Kevlin Henney, 2000. All rights reserved.
 //
 // Permission to use, copy, modify, and distribute this software for any
 // purpose is hereby granted without fee, provided that this copyright and
-// permissions notice appear in all copies and derivatives.
+// permissions notice appear in all copies and derivatives, and that no
+// charge may be made for the software and its documentation except to cover
+// cost of distribution.
 //
 // This software is provided "as is" without express or implied warranty.

-#ifdef BOOST_LEXICAL_CAST_USE_STRSTREAM
-# undef BOOST_LEXICAL_CAST_USE_STRSTREAM
-#endif
-
 #endif
@@ -12,13 +12,13 @@
 <a href="../../boost/lexical_cast.hpp">boost/lexical_cast.hpp</a></h1>

 <ul>
-    <li><a href="#motivation">Motivation</a></li>
-    <li><a href="#examples">Examples</a></li>
-    <li><a href="#synopsis">Synopsis</a></li>
-    <li><a href="#lexical_cast"><code>lexical_cast</code></a></li>
-    <li><a href="#bad_lexical_cast"><code>bad_lexical_cast</code></a></li>
-    <li><a href="#portability">Portability</a></li>
-    <li><a href="#future">Future directions</a></li>
+    <li><a href="#motivation">Motivation</li>
+    <li></a><a href="#examples">Examples</li>
+    <li></a><a href="#synopsis">Synopsis</li>
+    <li></a><a href="#lexical_cast"><code>lexical_cast</code></li>
+    <li></a><a href="#bad_lexical_cast"><code>bad_lexical_cast</code></li>
+    <li></a><a href="#portability">Portability</li>
+    <li></a><a href="#future">Future directions</li>
 </ul>

 <hr>