org.freedesktop.gstreamer.glib

Class GLib

java.lang.Object

org.freedesktop.gstreamer.glib.GLib

public class GLib
extends Object

Miscellaneous Utility Functions — a selection of portable utility functions from GLib Documentation derived from https://developer.gnome.org/glib/stable/glib-Miscellaneous-Utility-Functions.html#g-setenv

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	GLib.Types

Constructor Summary

Constructors

Constructor and Description
GLib()

Method Summary

Modifier and Type	Method and Description
static String	getEnv(String variable) Returns the value of an environment variable.
static boolean	setEnv(String variable, String value, boolean overwrite) Sets an environment variable.
static void	unsetEnv(String variable) Removes an environment variable from the environment.

Methods inherited from class java.lang.Object

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

Constructor Detail

GLib

public GLib()

Method Detail

setEnv

public static boolean setEnv(String variable,
                             String value,
                             boolean overwrite)

Sets an environment variable. On UNIX, both the variable's name and value can be arbitrary byte strings, except that the variable's name cannot contain '='. On Windows, they should be in UTF-8. Note that on some systems, when variables are overwritten, the memory used for the previous variables and its value isn't reclaimed. You should be mindful of the fact that environment variable handling in UNIX is not thread-safe, and your program may crash if one thread calls g_setenv() while another thread is calling getenv(). (And note that many functions, such as gettext(), call getenv() internally.) This function is only safe to use at the very start of your program, before creating any other threads (or creating objects that create worker threads of their own).

Parameters:

variable - the environment variable to set, must not contain '='.

value - the value to set the variable to.

overwrite - whether to change the variable if it already exists.

Returns:

FALSE if the environment variable couldn't be set.

getEnv

public static String getEnv(String variable)

Returns the value of an environment variable. On UNIX, the name and value are byte strings which might or might not be in some consistent character set and encoding. On Windows, they are in UTF-8. On Windows, in case the environment variable's value contains references to other environment variables, they are expanded.

Parameters:

variable - the environment variable to get.

Returns:

the value of the environment variable, or NULL if the environment variable is not found.

unsetEnv

public static void unsetEnv(String variable)

Removes an environment variable from the environment. Note that on some systems, when variables are overwritten, the memory used for the previous variables and its value isn't reclaimed. You should be mindful of the fact that environment variable handling in UNIX is not thread-safe, and your program may crash if one thread calls g_unsetenv() while another thread is calling getenv(). (And note that many functions, such as gettext(), call getenv() internally.) This function is only safe to use at the very start of your program, before creating any other threads (or creating objects that create worker threads of their own).

Parameters:

variable - the environment variable to remove, must not contain '='.