Package org.gnome.glib

Class SList<E>

java.lang.Object

java.util.AbstractCollection<E>

java.util.AbstractList<E>

java.util.AbstractSequentialList<@Nullable E>

org.gnome.glib.SList<E>

Type Parameters:

E - The element type must be a MemorySegment, a String, a primitive value, or implement the Proxy interface.

All Implemented Interfaces:

Iterable<E>, Collection<E>, List<E>, SequencedCollection<E>, Proxy

@NullMarked
public class SList<E>
extends AbstractSequentialList<@Nullable E>
implements Proxy

Java wrapper for GLib.SList that implements List.

Because SList is a singly-linked list, attempts to navigate the list backwards will throw an UnsupportedOperationException.

Field Summary

Fields inherited from class java.util.AbstractList

modCount

Constructor Summary

Constructors

Constructor	Description
SList(MemorySegment address, Function<MemorySegment,E> make, @Nullable Consumer<E> free, TransferOwnership ownership)	Create a new GLib.SList wrapper.
SList(MemorySegment address, Function<MemorySegment,E> make, TransferOwnership ownership)	Create a new GLib.SList wrapper.
SList(Function<MemorySegment,E> make, Consumer<E> free, TransferOwnership ownership)	Create a wrapper for a new, empty GLib.SList.

Method Summary

Modifier and Type	Method	Description
static MemoryLayout	getMemoryLayout()	The memory layout of the native struct.
MemorySegment	handle()	Returns the memory address of the head of the list.
boolean	isEmpty()	Checks if the list has no elements (the head of the list is null).
ListIterator<E>	listIterator(int index)	Returns a list iterator over the elements in this GLib.SList (in proper sequence).
void	setOwnership(TransferOwnership ownership)	Change ownership status of this list
int	size()	Retrieve the size of the list.

Methods inherited from class java.util.AbstractSequentialList

add, addAll, get, iterator, remove, set

Methods inherited from class java.util.AbstractList

add, clear, equals, hashCode, indexOf, lastIndexOf, listIterator, removeRange, subList

Methods inherited from class java.util.AbstractCollection

addAll, contains, containsAll, remove, removeAll, retainAll, toArray, toArray, toString

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.util.Collection

parallelStream, removeIf, stream, toArray

Methods inherited from interface java.lang.Iterable

forEach

Methods inherited from interface java.util.List

addAll, addFirst, addLast, contains, containsAll, getFirst, getLast, remove, removeAll, removeFirst, removeLast, replaceAll, retainAll, reversed, sort, spliterator, toArray, toArray

Constructor Details

SList

public SList(MemorySegment address,
 Function<MemorySegment,E> make,
 @Nullable Consumer<E> free,
 TransferOwnership ownership)

Create a new GLib.SList wrapper.

Parameters:

address - the memory address of the head element of the SList

make - a function to construct element instances

free - a function to free element instances. If ownership is "none" or "container", this can safely be set to null.

ownership - whether to free memory automatically

SList

public SList(Function<MemorySegment,E> make,
 Consumer<E> free,
 TransferOwnership ownership)

Create a wrapper for a new, empty GLib.SList.

Parameters:

make - a function to construct element instances

free - a function to free element instances. If ownership is "none" or "container", this can safely be set to null.

ownership - whether to free memory automatically

SList

public SList(MemorySegment address,
 Function<MemorySegment,E> make,
 TransferOwnership ownership)

Create a new GLib.SList wrapper.

Parameters:

address - the memory address of the head element of the SList

make - a function to construct element instances

ownership - whether to free memory automatically

Method Details

setOwnership

public void setOwnership(TransferOwnership ownership)

Change ownership status of this list

Parameters:

ownership - the new ownership status

listIterator

public ListIterator<E> listIterator(int index)

Returns a list iterator over the elements in this GLib.SList (in proper sequence).

Because SList is a singly-linked list, the following iterator methods will throw an UnsupportedOperationException:

• ListIterator.hasPrevious()
• ListIterator.previous()
• ListIterator.previousIndex()

Specified by:

listIterator in interface List<E>

Specified by:

listIterator in class AbstractSequentialList<@Nullable E>

Parameters:

index - index of first element to be returned from the list iterator (by a call to the next method)

Returns:

a list iterator over the elements in this list (in proper sequence).

size

public int size()

Retrieve the size of the list. This is an expensive operation for long lists, because the entire length must be traversed.

Specified by:

size in interface Collection<E>

Specified by:

size in interface List<E>

Specified by:

size in class AbstractCollection<E>

Returns:

the length of the list

isEmpty

public boolean isEmpty()

Checks if the list has no elements (the head of the list is null).

Specified by:

isEmpty in interface Collection<E>

Specified by:

isEmpty in interface List<E>

Overrides:

isEmpty in class AbstractCollection<E>

Returns:

whether the list is empty

handle

public MemorySegment handle()

Returns the memory address of the head of the list. This address can change if the list is modified.

Specified by:

handle in interface Proxy

Returns:

the memory address of the current GLib.SList head, or MemorySegment.NULL if the head is null.

getMemoryLayout

public static MemoryLayout getMemoryLayout()

The memory layout of the native struct.

Returns:

the memory layout of one list node