org.gnu.glib
public class List extends Struct
Deprecated: This class is deprecated. Use Java's collection classes or arrays
instead.
This object represents a doubly-linked list in the GLib system. This should
only be used internally. This type should be converted into one of the Java
container types prior to being passed to the application layer. Objects of
this type should be freed by calling thre free() method. The data
parameter that is being passed into many of the methods is the handle of a
java-gnome object.
This class is part of the java-gnome 2.x family of libraries,
which, due to their inefficiency and complexity, are no longer
being maintained and have been abandoned by the java-gnome
project. This class may have an equivalent in java-gnome 4.0,
see org.gnome.glib.List
.
You should be aware that there is a considerably different API
in the new library: the architecture is completely different
and most notably internals are no longer exposed to public view.
Constructor Summary | |
---|---|
List()
Construct a List object | |
List(Handle handle)
Contruct a List object using a given handle. |
Method Summary | |
---|---|
void | append(int data)
Append an element to the end of the list.
|
Handle | first()
Return the first element from the List. |
void | free()
Release the resources associated with this object. |
protected static Handle | getData(Handle obj)
BEGINNING OF JNI CODE
|
protected static Handle | g_list_alloc() |
protected static Handle | g_list_append(Handle list, long data) |
protected static Handle | g_list_first(Handle list) |
protected static void | g_list_free(Handle list) |
protected static Handle | g_list_insert(Handle list, long data, int position) |
protected static Handle | g_list_last(Handle list) |
protected static int | g_list_length(Handle list) |
protected static Handle | g_list_next(Handle list) |
protected static Handle | g_list_prepend(Handle list, long data) |
protected static Handle | g_list_previous(Handle list) |
protected static Handle | g_list_remove(Handle list, long data) |
protected static Handle | g_list_remove_all(Handle list, long data) |
void | insert(int data, int position)
Insert an element at a specified location in the List.
|
Handle | last()
Return the last element from the List. |
int | length()
Return the number of elements contained in the List.
|
Handle | next()
Return the next element in the List. |
void | prepend(int data)
Prepend an element to the end of the list.
|
Handle | previous()
Return the previous element in the List. |
void | remove(int data)
Remove the first instance of an element from the List.
|
void | removeAllInstances(int data)
Remove all instances of an element from the List.
|
Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.
Construct a List objectDeprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.
Contruct a List object using a given handle. This constructor is used by the libraries internally to construct the object with the handle returned by a native method.Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.
Append an element to the end of the list.Parameters: data The handle of the object that is being added to the List.
Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.
Return the first element from the List. This method will also reposition the current list item to the beginning of the list.Returns: The first element from the List.
Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.
Release the resources associated with this object.Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.
Insert an element at a specified location in the List.Parameters: data The handle of the object that is being added to the List. position The position to perform the insertion.
Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.
Return the last element from the List. This method will also reposition the current list item to the end of the list.Returns: The last element from the List.
Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.
Return the number of elements contained in the List.Returns: The number of elements in the List.
Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.
Return the next element in the List. This method will also move the current list item forward one element.Returns: The next element from the List.
Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.
Prepend an element to the end of the list.Parameters: data The handle of the object that is being added to the List.
Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.
Return the previous element in the List. This method will also move the current list item backward one element.Returns: The previous element from the List.
Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.
Remove the first instance of an element from the List.Parameters: data The item to remove from the list. If two items contain the same data only the first will be removed.
Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.
Remove all instances of an element from the List.Parameters: data The item to remove from the List. This method will remove all instances of the object pointed to by data.