// // Copyright 2019 Pixar // // Licensed under the Apache License, Version 2.0 (the "Apache License") // with the following modification; you may not use this file except in // compliance with the Apache License and the following modification to it: // Section 6. Trademarks. is deleted and replaced with: // // 6. Trademarks. This License does not grant permission to use the trade // names, trademarks, service marks, or product names of the Licensor // and its affiliates, except as required to comply with Section 4(c) of // the License and to reproduce the content of the NOTICE file. // // You may obtain a copy of the Apache License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the Apache License with the above modification is // distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY // KIND, either express or implied. See the Apache License for the specific // language governing permissions and limitations under the Apache License. // #ifndef PXR_BASE_TF_ANY_UNIQUE_PTR_H #define PXR_BASE_TF_ANY_UNIQUE_PTR_H #include "pxr/pxr.h" #include "pxr/base/tf/api.h" #include PXR_NAMESPACE_OPEN_SCOPE /// A simple type-erased container that provides only destruction, moves and /// immutable, untyped access to the held value. /// /// There are a couple of facilities that provide fallback or default values /// in error cases. TfAnyUniquePtr exists to hold these oft-instantiated but /// rarely accessed values. As such, its design prioritizes compile-time /// overhead over runtime performance and avoids clever metaprogramming. /// Please resist the urge to add functionality to this class (e.g. small /// object optimization, boost::python interoperability.) class TfAnyUniquePtr { public: template static TfAnyUniquePtr New() { static_assert(!std::is_array::value, "Array types not supported"); return TfAnyUniquePtr(new T()); } template static TfAnyUniquePtr New(T const &v) { static_assert(!std::is_array::value, "Array types not supported"); return TfAnyUniquePtr(new T(v)); } TfAnyUniquePtr(TfAnyUniquePtr &&other) : _ptr(other._ptr) , _delete(other._delete) { other._ptr = nullptr; // We don't set other._delete to nullptr here on purpose. Invoking // delete on a null pointer is not an error so if we can ensure that // _delete is never null we can call it unconditionally. } TfAnyUniquePtr& operator=(TfAnyUniquePtr &&other) { if (this != &other) { _delete(_ptr); _ptr = other._ptr; _delete = other._delete; other._ptr = nullptr; } return *this; } TfAnyUniquePtr(TfAnyUniquePtr const&) = delete; TfAnyUniquePtr& operator=(TfAnyUniquePtr const&) = delete; ~TfAnyUniquePtr() { _delete(_ptr); } /// Return a pointer to the owned object. void const *Get() const { return _ptr; } private: template explicit TfAnyUniquePtr(T const *ptr) : _ptr(ptr) , _delete(&_Delete) {} template static void _Delete(void const *ptr) { delete static_cast(ptr); } private: void const *_ptr; void (*_delete)(void const *); }; PXR_NAMESPACE_CLOSE_SCOPE #endif