Class NativeMemorySegmentPool

java.lang.Object

org.episteme.nativ.util.NativeMemorySegmentPool

All Implemented Interfaces:

AutoCloseable, MemorySegmentPool

public class NativeMemorySegmentPool
extends Object
implements MemorySegmentPool

A pool for native memory segments to reduce allocation overhead in tight loops.

This class is not thread-safe.

Since:

1.1

Author:

Silvere Martin-Michiellot, Gemini AI (Google DeepMind)

Constructor Summary

Constructors

Constructor	Description
NativeMemorySegmentPool(Arena arena)	Creates a new pool using a shared arena.

Method Summary

Modifier and Type	Method	Description
MemorySegment	acquire(long sizeBytes)	Acquires a segment of at least the requested size.
void	close()
int	getPoolSize()	Gets the number of segments currently in the pool.
void	release(MemorySegment segment)	Return a segment to the pool.

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

NativeMemorySegmentPool

public NativeMemorySegmentPool(Arena arena)

Creates a new pool using a shared arena.

Parameters:

arena - the arena to allocate from

Method Details

acquire

public MemorySegment acquire(long sizeBytes)

Acquires a segment of at least the requested size.

Specified by:

acquire in interface MemorySegmentPool

Parameters:

sizeBytes - requested size

Returns:

a memory segment

release

public void release(MemorySegment segment)

Return a segment to the pool.

Specified by:

release in interface MemorySegmentPool

Parameters:

segment - the segment to return

getPoolSize

public int getPoolSize()

Description copied from interface: MemorySegmentPool

Gets the number of segments currently in the pool.

Specified by:

getPoolSize in interface MemorySegmentPool

Returns:

pool size

close

public void close()

Specified by:

close in interface AutoCloseable

Specified by:

close in interface MemorySegmentPool