Server IP : 85.214.239.14 / Your IP : 3.129.71.13 Web Server : Apache/2.4.62 (Debian) System : Linux h2886529.stratoserver.net 4.9.0 #1 SMP Tue Jan 9 19:45:01 MSK 2024 x86_64 User : www-data ( 33) PHP Version : 7.4.18 Disable Function : pcntl_alarm,pcntl_fork,pcntl_waitpid,pcntl_wait,pcntl_wifexited,pcntl_wifstopped,pcntl_wifsignaled,pcntl_wifcontinued,pcntl_wexitstatus,pcntl_wtermsig,pcntl_wstopsig,pcntl_signal,pcntl_signal_get_handler,pcntl_signal_dispatch,pcntl_get_last_error,pcntl_strerror,pcntl_sigprocmask,pcntl_sigwaitinfo,pcntl_sigtimedwait,pcntl_exec,pcntl_getpriority,pcntl_setpriority,pcntl_async_signals,pcntl_unshare, MySQL : OFF | cURL : OFF | WGET : ON | Perl : ON | Python : ON | Sudo : ON | Pkexec : OFF Directory : /proc/3/cwd/usr/include/node/cppgc/ |
Upload File : |
// Copyright 2020 the V8 project authors. All rights reserved. // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. #ifndef INCLUDE_CPPGC_GARBAGE_COLLECTED_H_ #define INCLUDE_CPPGC_GARBAGE_COLLECTED_H_ #include "cppgc/internal/api-constants.h" #include "cppgc/platform.h" #include "cppgc/trace-trait.h" #include "cppgc/type-traits.h" namespace cppgc { class Visitor; /** * Base class for managed objects. Only descendent types of `GarbageCollected` * can be constructed using `MakeGarbageCollected()`. Must be inherited from as * left-most base class. * * Types inheriting from GarbageCollected must provide a method of * signature `void Trace(cppgc::Visitor*) const` that dispatchs all managed * pointers to the visitor and delegates to garbage-collected base classes. * The method must be virtual if the type is not directly a child of * GarbageCollected and marked as final. * * \code * // Example using final class. * class FinalType final : public GarbageCollected<FinalType> { * public: * void Trace(cppgc::Visitor* visitor) const { * // Dispatch using visitor->Trace(...); * } * }; * * // Example using non-final base class. * class NonFinalBase : public GarbageCollected<NonFinalBase> { * public: * virtual void Trace(cppgc::Visitor*) const {} * }; * * class FinalChild final : public NonFinalBase { * public: * void Trace(cppgc::Visitor* visitor) const final { * // Dispatch using visitor->Trace(...); * NonFinalBase::Trace(visitor); * } * }; * \endcode */ template <typename T> class GarbageCollected { public: using IsGarbageCollectedTypeMarker = void; using ParentMostGarbageCollectedType = T; // Must use MakeGarbageCollected. void* operator new(size_t) = delete; void* operator new[](size_t) = delete; // The garbage collector is taking care of reclaiming the object. Also, // virtual destructor requires an unambiguous, accessible 'operator delete'. void operator delete(void*) { #ifdef V8_ENABLE_CHECKS internal::Fatal( "Manually deleting a garbage collected object is not allowed"); #endif // V8_ENABLE_CHECKS } void operator delete[](void*) = delete; protected: GarbageCollected() = default; }; /** * Base class for managed mixin objects. Such objects cannot be constructed * directly but must be mixed into the inheritance hierarchy of a * GarbageCollected object. * * Types inheriting from GarbageCollectedMixin must override a virtual method * of signature `void Trace(cppgc::Visitor*) const` that dispatchs all managed * pointers to the visitor and delegates to base classes. * * \code * class Mixin : public GarbageCollectedMixin { * public: * void Trace(cppgc::Visitor* visitor) const override { * // Dispatch using visitor->Trace(...); * } * }; * \endcode */ class GarbageCollectedMixin { public: using IsGarbageCollectedMixinTypeMarker = void; /** * This Trace method must be overriden by objects inheriting from * GarbageCollectedMixin. */ virtual void Trace(cppgc::Visitor*) const {} }; } // namespace cppgc #endif // INCLUDE_CPPGC_GARBAGE_COLLECTED_H_