boost-react-native-bundle

Version:

Boost library as in https://sourceforge.net/projects/boost/files/boost/1.57.0/

89 lines (88 loc) • 5.08 kB

HTML

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <html> <head> <title>Smart Pointer Changes</title> <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"> </head> <body text="#000000" bgcolor="#ffffff" link="#0000ff" vlink="#0000ff"> <h1><img height="86" alt="boost.png (6897 bytes)" src="../../boost.png" width="277" align="middle" border="0">Smart Pointer Changes</h1> The February 2002 change to the Boost smart pointers introduced a number of changes. Since the previous version of the smart pointers was in use for a long time, it's useful to have a detailed list of what changed from a library user's point of view. Note that for compilers that don't support member templates well enough, a separate implementation is used that lacks many of the new features and is more like the old version. <h2>Features Requiring Code Changes to Take Advantage</h2> <ul> <li> The smart pointer class templates now each have their own header file. For compatibility, the <a href="../../boost/smart_ptr.hpp"><boost/smart_ptr.hpp></a> header now includes the headers for the four classic smart pointer class templates. <li> The weak_ptr template was added. <li> The new shared_ptr and shared_array relax the requirement that the pointed-to object's destructor must be visible when instantiating the shared_ptr destructor. This makes it easier to have shared_ptr members in classes without explicit destructors. <li> A custom deallocator can be passed in when creating a shared_ptr or shared_array. <li> shared_static_cast and shared_dynamic_cast function templates are provided which work for shared_ptr and weak_ptr as static_cast and dynamic_cast do for pointers. <li> The self-assignment misfeature has been removed from shared_ptr::reset, although it is still present in scoped_ptr, and in std::auto_ptr. Calling reset with a pointer to the object that's already owned by the shared_ptr results in undefined behavior (an assertion, or eventually a double-delete if assertions are off). <li> The BOOST_SMART_PTR_CONVERSION feature has been removed. <li> shared_ptr<void> is now allowed.</li> </ul> <h2>Features That Improve Robustness</h2> <ul> <li> The manipulation of use counts is now <a name="threadsafe">thread safe</a> on Windows, Linux, and platforms that support pthreads. See the <a href="../../boost/detail/atomic_count.hpp"> <boost/detail/atomic_count.hpp></a> file for details <li> The new shared_ptr will always delete the object using the pointer it was originally constructed with. This prevents subtle problems that could happen if the last shared_ptr was a pointer to a sub-object of a class that did not have a virtual destructor.</li> </ul> <h2>Implementation Details</h2> <ul> <li> Some bugs in the assignment operator implementations and in reset have been fixed by using the "copy and swap" idiom. <li> Assertions have been added to check preconditions of various functions; however, since these use the new <a href="../../boost/assert.hpp"><boost/assert.hpp></a> header, the assertions are disabled by default. <li> The partial specialization of std::less has been replaced by operator< overloads which accomplish the same thing without relying on undefined behavior. <li> The incorrect overload of std::swap has been replaced by boost::swap, which has many of the same advantages for generic programming but does not violate the C++ standard.</li> </ul> <hr> $Date$ Copyright 2002 Darin Adler. Distributed under the Boost Software License, Version 1.0. See accompanying file <A href="../../LICENSE_1_0.txt">LICENSE_1_0.txt</A> or copy at <A href="http://www.boost.org/LICENSE_1_0.txt">http://www.boost.org/LICENSE_1_0.txt</A>. </body> </html>