Package org.gnome.glib

Class TrashStack

java.lang.Object

org.javagi.base.ProxyInstance

org.gnome.glib.TrashStack

All Implemented Interfaces:

Proxy

@Generated("io.github.jwharm.JavaGI")
@Deprecated
public class TrashStack
extends ProxyInstance

Deprecated.

GTrashStack is deprecated without replacement

A GTrashStack is an efficient way to keep a stack of unused allocated memory chunks. Each memory chunk is required to be large enough to hold a gpointer. This allows the stack to be maintained without any space overhead, since the stack pointers can be stored inside the memory chunks.

There is no function to create a GTrashStack. A NULL GTrashStack* is a perfectly valid empty stack.

Each piece of memory that is pushed onto the stack is cast to a GTrashStack*.

There is no longer any good reason to use GTrashStack. If you have extra pieces of memory, free() them and allocate them again later.

Constructor Summary

Constructors

Constructor	Description
TrashStack()	Deprecated. Allocate a new TrashStack.
TrashStack(Arena arena)	Deprecated. Allocate a new TrashStack.
TrashStack(MemorySegment address)	Deprecated. Create a TrashStack proxy instance for the provided memory address.
TrashStack(TrashStack next)	Deprecated. Allocate a new TrashStack with the fields set to the provided values.
TrashStack(TrashStack next, Arena arena)	Deprecated. Allocate a new TrashStack with the fields set to the provided values.

Method Summary

Modifier and Type	Method	Description
static MemoryLayout	getMemoryLayout()	Deprecated. The memory layout of the native struct.
int	height()	Deprecated.
@Nullable MemorySegment	peek()	Deprecated.
@Nullable MemorySegment	pop()	Deprecated.
void	push(MemorySegment dataP)	Deprecated.
TrashStack	readNext()	Deprecated. Read the value of the field next.
void	writeNext(TrashStack next)	Deprecated. Write a value in the field next.

Methods inherited from class org.javagi.base.ProxyInstance

equals, handle, hashCode

Methods inherited from class java.lang.Object

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

Constructor Details

TrashStack

public TrashStack(MemorySegment address)

Deprecated.

Create a TrashStack proxy instance for the provided memory address.

Parameters:

address - the memory address of the native object

TrashStack

public TrashStack(Arena arena)

Deprecated.

Allocate a new TrashStack.

Parameters:

arena - to control the memory allocation scope

TrashStack

public TrashStack()

Deprecated.

Allocate a new TrashStack. The memory is allocated with Arena.ofAuto().

TrashStack

public TrashStack(TrashStack next,
 Arena arena)

Deprecated.

Allocate a new TrashStack with the fields set to the provided values.

Parameters:

next - value for the field next

arena - to control the memory allocation scope

TrashStack

public TrashStack(TrashStack next)

Deprecated.

Allocate a new TrashStack with the fields set to the provided values. The memory is allocated with Arena.ofAuto().

Parameters:

next - value for the field next

Method Details

getMemoryLayout

public static MemoryLayout getMemoryLayout()

Deprecated.

The memory layout of the native struct.

Returns:

the memory layout

readNext

public TrashStack readNext()

Deprecated.

Read the value of the field next.

Returns:

The value of the field next

writeNext

public void writeNext(TrashStack next)

Deprecated.

Write a value in the field next.

Parameters:

next - The new value for the field next

height

@Deprecated
public int height()

Deprecated.

Returns the height of a GTrashStack.

Note that execution of this function is of O(N) complexity where N denotes the number of items on the stack.

Returns:

the height of the stack

peek

@Deprecated
public @Nullable MemorySegment peek()

Deprecated.

Returns the element at the top of a GTrashStack which may be null.

Returns:

the element at the top of the stack

pop

@Deprecated
public @Nullable MemorySegment pop()

Deprecated.

Pops a piece of memory off a GTrashStack.

Returns:

the element at the top of the stack

push

@Deprecated
public void push(MemorySegment dataP)

Deprecated.

Pushes a piece of memory onto a GTrashStack.

Parameters:

dataP - the piece of memory to push on the stack