This commit was manufactured by cvs2svn to create tag

'Version_1_22_0'. [SVN r10239]
2026-08-06 13:34:14 +02:00 · 2001-05-28 15:01:00 +00:00
5 changed files with 34 additions and 49 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
@@ -121,7 +121,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 +133,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 +144,7 @@ namespace boost
 # else
                 ;
 # endif
-         };
+	       };
       };

 # ifdef __GNUC__ // bug workaround courtesy Jens Maurer
@@ -295,7 +295,7 @@ namespace boost
        typedef std::numeric_limits<Source> arg_traits;
        typedef detail::fixed_numeric_limits<Target> result_traits;
        
-#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>