| OLD | NEW |
| 1 // Copyright (c) 2012 The Chromium Authors. All rights reserved. | 1 // Copyright (c) 2012 The Chromium Authors. All rights reserved. |
| 2 // Use of this source code is governed by a BSD-style license that can be | 2 // Use of this source code is governed by a BSD-style license that can be |
| 3 // found in the LICENSE file. | 3 // found in the LICENSE file. |
| 4 | 4 |
| 5 #ifndef BASE_MAC_SCOPED_CFTYPEREF_H_ | 5 #ifndef BASE_MAC_SCOPED_CFTYPEREF_H_ |
| 6 #define BASE_MAC_SCOPED_CFTYPEREF_H_ | 6 #define BASE_MAC_SCOPED_CFTYPEREF_H_ |
| 7 | 7 |
| 8 #include <CoreFoundation/CoreFoundation.h> | 8 #include <CoreFoundation/CoreFoundation.h> |
| 9 | 9 |
| 10 #include "base/mac/scoped_typeref.h" | 10 #include "base/mac/scoped_typeref.h" |
| 11 | 11 |
| 12 namespace base { | 12 namespace base { |
| 13 | 13 |
| 14 // ScopedCFTypeRef<> is patterned after scoped_ptr<>, but maintains ownership | 14 // ScopedCFTypeRef<> is patterned after std::unique_ptr<>, but maintains |
| 15 // of a CoreFoundation object: any object that can be represented as a | 15 // ownership of a CoreFoundation object: any object that can be represented |
| 16 // CFTypeRef. Style deviations here are solely for compatibility with | 16 // as a CFTypeRef. Style deviations here are solely for compatibility with |
| 17 // scoped_ptr<>'s interface, with which everyone is already familiar. | 17 // std::unique_ptr<>'s interface, with which everyone is already familiar. |
| 18 // | 18 // |
| 19 // By default, ScopedCFTypeRef<> takes ownership of an object (in the | 19 // By default, ScopedCFTypeRef<> takes ownership of an object (in the |
| 20 // constructor or in reset()) by taking over the caller's existing ownership | 20 // constructor or in reset()) by taking over the caller's existing ownership |
| 21 // claim. The caller must own the object it gives to ScopedCFTypeRef<>, and | 21 // claim. The caller must own the object it gives to ScopedCFTypeRef<>, and |
| 22 // relinquishes an ownership claim to that object. ScopedCFTypeRef<> does not | 22 // relinquishes an ownership claim to that object. ScopedCFTypeRef<> does not |
| 23 // call CFRetain(). This behavior is parameterized by the |OwnershipPolicy| | 23 // call CFRetain(). This behavior is parameterized by the |OwnershipPolicy| |
| 24 // enum. If the value |RETAIN| is passed (in the constructor or in reset()), | 24 // enum. If the value |RETAIN| is passed (in the constructor or in reset()), |
| 25 // then ScopedCFTypeRef<> will call CFRetain() on the object, and the initial | 25 // then ScopedCFTypeRef<> will call CFRetain() on the object, and the initial |
| 26 // ownership is not changed. | 26 // ownership is not changed. |
| 27 | 27 |
| (...skipping 13 matching lines...) Expand all Loading... |
| 41 | 41 |
| 42 } // namespace internal | 42 } // namespace internal |
| 43 | 43 |
| 44 template<typename CFT> | 44 template<typename CFT> |
| 45 using ScopedCFTypeRef = | 45 using ScopedCFTypeRef = |
| 46 ScopedTypeRef<CFT, internal::ScopedCFTypeRefTraits<CFT>>; | 46 ScopedTypeRef<CFT, internal::ScopedCFTypeRefTraits<CFT>>; |
| 47 | 47 |
| 48 } // namespace base | 48 } // namespace base |
| 49 | 49 |
| 50 #endif // BASE_MAC_SCOPED_CFTYPEREF_H_ | 50 #endif // BASE_MAC_SCOPED_CFTYPEREF_H_ |
| OLD | NEW |