org.gnu.glib

Class GListString

public final class GListString extends GObject

Deprecated: This class is deprecated. Use Java's collection classes or arrays instead. Wrapper class for glib's GList structure, specialized to hold only lists of strings. This class provides a way to translate between GList and native Java arrays and collections. For instances initially constructed at the Java layer, the class manages all of the memory pointed to by the GLib layer, so, in that case, if an instance of this class gets gc'ed then the GLib memory will be reclaimed. Some instances of this class have their origin in the GLib layer, however. For these instances, no GLib memory is reclaimed when the Java instance gets collected.

This class is not intended to provide all of the functionality of GList directly. If, for example, you are interested in interactively inserting or deleting elements, or iterating over the elements, you should do such things with Java objects, translating to and from instances of this class as needed.

The Java-Gnome bindings library is free software distributed under the terms of the GNU Library General Public License version 2.

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.GListString. 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
GListString()
Construct an instance.
GListString(Vector vec)
Construct an instance initially containing the elements of the given vector.
GListString(String[] list)
Construct an instance initially containing the elemnts of the given array.
Method Summary
voidappend(String s)
Append a string to the end of this instance.
Handleappend0(Handle handle, String str)
Append a string to this instance, where the string is represented as an array of bytes representing character values in the default encoding.
protected voidfinalize()
Finalize this instance.

Constructor Detail

GListString

public GListString()

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 an instance. It initially contains no elements.

GListString

public GListString(Vector vec)

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 an instance initially containing the elements of the given vector.

Parameters: vec the vector containing the elements to put in the instance

GListString

public GListString(String[] 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 an instance initially containing the elemnts of the given array.

Parameters: list The Array containing the elements to put in this instance.

Method Detail

append

public void append(String s)

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 a string to the end of this instance.

Parameters: s the string to append

append0

public Handle append0(Handle handle, String str)

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 a string to this instance, where the string is represented as an array of bytes representing character values in the default encoding.

Parameters: str The string, represented in ISO-8859-1

finalize

protected void finalize()

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.

Finalize this instance. This method should never be called, other than by the Java virtual machine.