46 lines
1.3 KiB
C
46 lines
1.3 KiB
C
|
// Copyright 2021 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_EXPLICIT_MANAGEMENT_H_
|
||
|
|
#define INCLUDE_CPPGC_EXPLICIT_MANAGEMENT_H_
|
||
|
|
|
||
|
|
#include <cstddef>
|
||
|
|
|
||
|
|
#include "cppgc/internal/logging.h"
|
||
|
|
#include "cppgc/type-traits.h"
|
||
|
|
|
||
|
|
namespace cppgc {
|
||
|
|
namespace internal {
|
||
|
|
|
||
|
|
V8_EXPORT void FreeUnreferencedObject(void*);
|
||
|
|
|
||
|
|
} // namespace internal
|
||
|
|
|
||
|
|
namespace subtle {
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Informs the garbage collector that `object` can be immediately reclaimed. The
|
||
|
|
* destructor may not be invoked immediately but only on next garbage
|
||
|
|
* collection.
|
||
|
|
*
|
||
|
|
* It is up to the embedder to guarantee that no other object holds a reference
|
||
|
|
* to `object` after calling `FreeUnreferencedObject()`. In case such a
|
||
|
|
* reference exists, it's use results in a use-after-free.
|
||
|
|
*
|
||
|
|
* \param object Reference to an object that is of type `GarbageCollected` and
|
||
|
|
* should be immediately reclaimed.
|
||
|
|
*/
|
||
|
|
template <typename T>
|
||
|
|
void FreeUnreferencedObject(T* object) {
|
||
|
|
static_assert(IsGarbageCollectedTypeV<T>,
|
||
|
|
"Object must be of type GarbageCollected.");
|
||
|
|
if (!object) return;
|
||
|
|
internal::FreeUnreferencedObject(object);
|
||
|
|
}
|
||
|
|
|
||
|
|
} // namespace subtle
|
||
|
|
} // namespace cppgc
|
||
|
|
|
||
|
|
#endif // INCLUDE_CPPGC_EXPLICIT_MANAGEMENT_H_
|