Index: base/memory/scoped_ptr.h |
diff --git a/base/memory/scoped_ptr.h b/base/memory/scoped_ptr.h |
index 50a4e09cf834f64c9a0ec641251b72f8e9368aaf..e63887483840e37e727bb3ccd8893e3bd6505b1a 100644 |
--- a/base/memory/scoped_ptr.h |
+++ b/base/memory/scoped_ptr.h |
@@ -2,98 +2,13 @@ |
// Use of this source code is governed by a BSD-style license that can be |
// found in the LICENSE file. |
-// Scopers help you manage ownership of a pointer, helping you easily manage a |
-// pointer within a scope, and automatically destroying the pointer at the end |
-// of a scope. There are two main classes you will use, which correspond to the |
-// operators new/delete and new[]/delete[]. |
-// |
-// Example usage (scoped_ptr<T>): |
-// { |
-// scoped_ptr<Foo> foo(new Foo("wee")); |
-// } // foo goes out of scope, releasing the pointer with it. |
-// |
-// { |
-// scoped_ptr<Foo> foo; // No pointer managed. |
-// foo.reset(new Foo("wee")); // Now a pointer is managed. |
-// foo.reset(new Foo("wee2")); // Foo("wee") was destroyed. |
-// foo.reset(new Foo("wee3")); // Foo("wee2") was destroyed. |
-// foo->Method(); // Foo::Method() called. |
-// foo.get()->Method(); // Foo::Method() called. |
-// SomeFunc(foo.release()); // SomeFunc takes ownership, foo no longer |
-// // manages a pointer. |
-// foo.reset(new Foo("wee4")); // foo manages a pointer again. |
-// foo.reset(); // Foo("wee4") destroyed, foo no longer |
-// // manages a pointer. |
-// } // foo wasn't managing a pointer, so nothing was destroyed. |
-// |
-// Example usage (scoped_ptr<T[]>): |
-// { |
-// scoped_ptr<Foo[]> foo(new Foo[100]); |
-// foo.get()->Method(); // Foo::Method on the 0th element. |
-// foo[10].Method(); // Foo::Method on the 10th element. |
-// } |
-// |
-// Scopers are testable as booleans: |
-// { |
-// scoped_ptr<Foo> foo; |
-// if (!foo) |
-// foo.reset(new Foo()); |
-// if (foo) |
-// LOG(INFO) << "This code is reached." |
-// } |
-// |
-// These scopers also implement part of the functionality of C++11 unique_ptr |
-// in that they are "movable but not copyable." You can use the scopers in |
-// the parameter and return types of functions to signify ownership transfer |
-// in to and out of a function. When calling a function that has a scoper |
-// as the argument type, it must be called with an rvalue of a scoper, which |
-// can be created by using std::move(), or the result of another function that |
-// generates a temporary; passing by copy will NOT work. Here is an example |
-// using scoped_ptr: |
-// |
-// void TakesOwnership(scoped_ptr<Foo> arg) { |
-// // Do something with arg. |
-// } |
-// scoped_ptr<Foo> CreateFoo() { |
-// // No need for calling std::move() for returning a move-only value, or |
-// // when you already have an rvalue as we do here. |
-// return scoped_ptr<Foo>(new Foo("new")); |
-// } |
-// scoped_ptr<Foo> PassThru(scoped_ptr<Foo> arg) { |
-// return arg; |
-// } |
-// |
-// { |
-// scoped_ptr<Foo> ptr(new Foo("yay")); // ptr manages Foo("yay"). |
-// TakesOwnership(std::move(ptr)); // ptr no longer owns Foo("yay"). |
-// scoped_ptr<Foo> ptr2 = CreateFoo(); // ptr2 owns the return Foo. |
-// scoped_ptr<Foo> ptr3 = // ptr3 now owns what was in ptr2. |
-// PassThru(std::move(ptr2)); // ptr2 is correspondingly nullptr. |
-// } |
-// |
-// Notice that if you do not call std::move() when returning from PassThru(), or |
-// when invoking TakesOwnership(), the code will not compile because scopers |
-// are not copyable; they only implement move semantics which require calling |
-// the std::move() function to signify a destructive transfer of state. |
-// CreateFoo() is different though because we are constructing a temporary on |
-// the return line and thus can avoid needing to call std::move(). |
-// |
-// The conversion move-constructor properly handles upcast in initialization, |
-// i.e. you can use a scoped_ptr<Child> to initialize a scoped_ptr<Parent>: |
-// |
-// scoped_ptr<Foo> foo(new Foo()); |
-// scoped_ptr<FooParent> parent(std::move(foo)); |
+// scoped_ptr is just a type alias for std::unique_ptr. Mass conversion coming |
+// soon (stay tuned for the PSA!), but until then, please continue using |
+// scoped_ptr. |
#ifndef BASE_MEMORY_SCOPED_PTR_H_ |
#define BASE_MEMORY_SCOPED_PTR_H_ |
-// This is an implementation designed to match the anticipated future TR2 |
-// implementation of the scoped_ptr class. |
- |
-// TODO(dcheng): Clean up these headers, but there are likely lots of existing |
-// IWYU violations. |
-#include <stdlib.h> |
- |
#include <memory> |
template <typename T, typename D = std::default_delete<T>> |