WeakPointerScope

public class WeakPointerScope

A minimalist pointer scope only keeping weak references to its elements.

As opposed to ERROR(/org.bytedeco.javacpp.PointerScope), instances of this class will not prevent the garbage collector to free the memory of a pointer that is no longer reachable, even if it has been attached to the scope.

When the scope is closed, all pointers that are still valid will be automatically deallocated while those already garbage-collected will be ignored.

Public Constructors

WeakPointerScope()

Public Methods

void	attach(Pointer pointer) Attach a pointer to this scope.
synchronized void	close()
void	detach(Pointer pointer) Detach a pointer from this scope.

Inherited Methods

From class java.lang.Object

boolean	equals(Object arg0)
final Class<?>	getClass()
int	hashCode()
final void	notify()
final void	notifyAll()
String	toString()
final void	wait(long arg0, int arg1)
final void	wait(long arg0)
final void	wait()

From interface java.lang.AutoCloseable

abstract void

close()

Public Constructors

public WeakPointerScope ()

Public Methods

public void attach (Pointer pointer)

Attach a pointer to this scope.

Pointers attached to the scope will be automatically freed once the scope is closed, unless they have been already released by the garbage collector

It this pointer was already attached to this scope, this method has no effect.

Parameters

pointer	pointer to attach

Throws

IllegalStateException	if that scope has already been closed

public synchronized void close ()

public void detach (Pointer pointer)

Detach a pointer from this scope.

Detaching a pointer from the scope will prevent its memory to be freed when closing the scope.

If this pointer is not attached to this scope, this method has no effect.

Parameters

pointer	pointer to detach

Throws

IllegalStateException	if that scope has already been closed