REDROOM

Navigation

Breadcrumbs

Create

Preview: garbage-collected.h Size: 3.11 KB

//opt/cpanel/ea-nodejs20/include/node/cppgc/garbage-collected.h

// 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_

Name	Size	Perms	Modified	Actions
internal DIR	-	drwxr-xr-x	2026-02-03 09:33:34	Edit Download recursive recursive
allocation.h	11.61 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
common.h	643 B	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
cross-thread-persistent.h	14.81 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
custom-space.h	2.40 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
default-platform.h	2.18 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
ephemeron-pair.h	804 B	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
explicit-management.h	3.29 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
garbage-collected.h	3.11 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
heap-consistency.h	11.74 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
heap-handle.h	1.26 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
heap-state.h	2.57 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
heap-statistics.h	3.89 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
heap.h	5.70 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
liveness-broker.h	2.34 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
macros.h	1.31 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
member.h	22.75 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
name-provider.h	1.99 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
object-size-trait.h	1.60 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
persistent.h	13.50 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
platform.h	5.56 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
prefinalizer.h	2.88 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
process-heap-statistics.h	1009 B	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
sentinel-pointer.h	935 B	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
source-location.h	2.57 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
testing.h	2.96 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
trace-trait.h	3.14 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
type-traits.h	7.78 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
visitor.h	14.84 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive

Directory Contents