cppgc::Heap Class Reference

#include <heap.h>

Classes
struct	HeapOptions
struct	ResourceConstraints

Public Types
enum class	StackSupport : uint8_t { kSupportsConservativeStackScan , kNoConservativeStackScan }
enum class	MarkingType : uint8_t { kAtomic , kIncremental , kIncrementalAndConcurrent }
enum class	SweepingType : uint8_t { kAtomic , kIncremental , kIncrementalAndConcurrent }
using	StackState = EmbedderStackState

Public Member Functions
virtual	~Heap ()=default
void	ForceGarbageCollectionSlow (const char *source, const char *reason, StackState stack_state=StackState::kMayContainHeapPointers)
AllocationHandle &	GetAllocationHandle ()
HeapHandle &	GetHeapHandle ()

Static Public Member Functions
static std::unique_ptr< Heap >	Create (std::shared_ptr< Platform > platform, HeapOptions options=HeapOptions::Default())

Friends
class	internal::Heap

Member Typedef Documentation

StackState

using cppgc::Heap::StackState = EmbedderStackState

Specifies the stack state the embedder is in.

Member Enumeration Documentation

MarkingType

enum class cppgc::Heap::MarkingType : uint8_t

strong

Specifies supported marking types.

Enumerator
kAtomic	Atomic stop-the-world marking. This option does not require any write barriers but is the most intrusive in terms of jank.
kIncremental	Incremental marking interleaves marking with the rest of the application workload on the same thread.
kIncrementalAndConcurrent	Incremental and concurrent marking.

StackSupport

enum class cppgc::Heap::StackSupport : uint8_t

strong

Specifies whether conservative stack scanning is supported.

Enumerator
kSupportsConservativeStackScan	Conservative stack scan is supported.
kNoConservativeStackScan	Conservative stack scan is not supported. Embedders may use this option when using custom infrastructure that is unsupported by the library.

SweepingType

enum class cppgc::Heap::SweepingType : uint8_t

strong

Specifies supported sweeping types.

Enumerator
kAtomic	Atomic stop-the-world sweeping. All of sweeping is performed at once.
kIncremental	Incremental sweeping interleaves sweeping with the rest of the application workload on the same thread.
kIncrementalAndConcurrent	Incremental and concurrent sweeping. Sweeping is split and interleaved with the rest of the application.

Constructor & Destructor Documentation

~Heap()

virtual cppgc::Heap::~Heap ( )

virtualdefault

Member Function Documentation

Create()

static std::unique_ptr< Heap > cppgc::Heap::Create ( std::shared_ptr< Platform >  platform, HeapOptions  options = HeapOptions::Default()  )

static

Creates a new heap that can be used for object allocation.

Parameters

platform	implemented and provided by the embedder.
options	HeapOptions specifying various properties for the Heap.

Returns

a new Heap instance.

ForceGarbageCollectionSlow()

void cppgc::Heap::ForceGarbageCollectionSlow	(	const char *	source,
		const char *	reason,
		StackState	stack_state = StackState::kMayContainHeapPointers
	)

Forces garbage collection.

Parameters

source	String specifying the source (or caller) triggering a forced garbage collection.
reason	String specifying the reason for the forced garbage collection.
stack_state	The embedder stack state, see StackState.

GetAllocationHandle()

AllocationHandle & cppgc::Heap::GetAllocationHandle

(

)

Returns

the opaque handle for allocating objects using MakeGarbageCollected().

GetHeapHandle()

HeapHandle & cppgc::Heap::GetHeapHandle

(

)

Returns

the opaque heap handle which may be used to refer to this heap in other APIs. Valid as long as the underlying Heap is alive.

Friends And Related Function Documentation

internal::Heap

friend class internal::Heap

friend

---

The documentation for this class was generated from the following file:

• include/cppgc/heap.h