Initial commit after public review (note change in library name per review)

[SVN r8515]

include/boost/lexical_cast.hpp

@@ -0,0 +1,67 @@
+//  boost lexical_cast.hpp header  -------------------------------------------//
+
+//  See http://www.boost.org for most recent version including documentation.
+
+#ifndef BOOST_LEXICAL_CAST_INCLUDED
+#define BOOST_LEXICAL_CAST_INCLUDED
+
+// what:  lexical_cast custom keyword cast
+// who:   contributed by Kevlin Henney, with alternative naming, behaviors
+//        and fixes contributed by Dave Abrahams, Daryle Walker and other
+//        Boosters on the list
+// when:  November 2000
+// where: tested with MSVC 6.0, BCC 5.5, and g++ 2.91
+
+#include <boost/config.hpp>
+# ifndef BOOST_NO_STRINGSTREAM
+#  include <sstream>
+# else
+#  include <strstream>
+# endif
+#include <typeinfo>
+
+namespace boost
+{
+    // exception used to indicate runtime lexical_cast failure
+    class bad_lexical_cast : public std::bad_cast
+    {
+    public:
+        // constructors, destructors, and assignment operator defaulted
+
+        // function inlined for brevity and consistency with rest of library
+        virtual const char * what() const throw()
+        {
+            return "bad lexical cast: "
+                   "source type value could not be interpreted as target";
+        }
+    };
+
+    template<typename Target, typename Source>
+    Target lexical_cast(Source arg)
+    {
+# ifndef BOOST_NO_STRINGSTREAM
+        std::stringstream interpreter;
+# else
+        std::strstream interpreter; // for out-of-the-box g++ 2.95.2
+# endif
+        Target result;
+
+        if(!(interpreter << arg) || !(interpreter >> result) ||
+           !(interpreter >> std::ws).eof())
+            throw bad_lexical_cast();
+
+        return result;
+    }
+}
+
+// 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, 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.
+
+#endif