org.bytedeco.javacpp

Class PointerScope

java.lang.Object

org.bytedeco.javacpp.PointerScope

All Implemented Interfaces:

java.lang.AutoCloseable

public class PointerScope
extends java.lang.Object
implements java.lang.AutoCloseable

Pointer objects attach themselves automatically on Pointer.init(long, long, long, long) to the first PointerScope found in scopeStack that they can to based on the classes found in forClasses. The user can then call deallocate(), or rely on close() to release in a timely fashion all attached Pointer objects, instead of relying on the garbage collector.

Constructor Summary

Constructors

Constructor and Description
PointerScope(java.lang.Class<? extends Pointer>... forClasses) Initializes forClasses, and pushes itself on the scopeStack.

Method Summary

Modifier and Type	Method and Description
PointerScope	attach(Pointer p) Pushes the Pointer onto the pointerStack of this Scope and calls Pointer.retainReference().
void	close() Pops from pointerStack all attached pointers, calls Pointer.releaseReference() on them, unless extended, in which case it only resets the extend flag instead, and finally removes itself from scopeStack.
void	deallocate() Pops from pointerStack all attached pointers, and calls Pointer.deallocate() on them.
PointerScope	detach(Pointer p) Removes the Pointer from the pointerStack of this Scope and calls Pointer.releaseReference().
PointerScope	extend() Extends the life of this scope past the next call to close() by setting the extend flag.
java.lang.Class<? extends Pointer>[]	forClasses()
static PointerScope	getInnerScope() Returns scopeStack.get().peek(), the last opened scope not yet closed.
static java.util.Iterator<PointerScope>	getScopeIterator() Returns scopeStack.get().iterator(), all scopes not yet closed.

Methods inherited from class java.lang.Object

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

Constructor Detail

PointerScope

public PointerScope(java.lang.Class<? extends Pointer>... forClasses)

Initializes forClasses, and pushes itself on the scopeStack.

Method Detail

getInnerScope

public static PointerScope getInnerScope()

Returns scopeStack.get().peek(), the last opened scope not yet closed.

getScopeIterator

public static java.util.Iterator<PointerScope> getScopeIterator()

Returns scopeStack.get().iterator(), all scopes not yet closed.

forClasses

public java.lang.Class<? extends Pointer>[] forClasses()

attach

public PointerScope attach(Pointer p)

Pushes the Pointer onto the pointerStack of this Scope and calls Pointer.retainReference().

Throws:

java.lang.IllegalArgumentException - when it is not an instance of a class in forClasses.

detach

public PointerScope detach(Pointer p)

Removes the Pointer from the pointerStack of this Scope and calls Pointer.releaseReference().

extend

public PointerScope extend()

Extends the life of this scope past the next call to close() by setting the extend flag.

close

public void close()

Pops from pointerStack all attached pointers, calls Pointer.releaseReference() on them, unless extended, in which case it only resets the extend flag instead, and finally removes itself from scopeStack.

Specified by:

close in interface java.lang.AutoCloseable

deallocate

public void deallocate()

Pops from pointerStack all attached pointers, and calls Pointer.deallocate() on them.