Package org.gnome.gobject

Class Value

java.lang.Object

io.github.jwharm.javagi.base.ProxyInstance

org.gnome.gobject.Value

All Implemented Interfaces:

Proxy

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

An opaque structure used to hold different types of values.

The data within the structure has protected scope: it is accessible only to functions within a GTypeValueTable structure, or implementations of the g_value_*() API. That is, code portions which implement new fundamental types.

GValue users cannot make any assumptions about how data is stored within the 2 element data union, and the gType member should only be accessed through the G_VALUE_TYPE() macro.

Constructor Summary

Constructors

Constructor	Description
Value()	Allocate a new Value.
Value(Arena arena)	Allocate a new Value.
Value(MemorySegment address)	Create a Value proxy instance for the provided memory address.
Value(Type gType, ValueDataUnion[] data)	Allocate a new Value with the fields set to the provided values.
Value(Type gType, ValueDataUnion[] data, Arena arena)	Allocate a new Value with the fields set to the provided values.

Method Summary

Modifier and Type	Method	Description
void	copy(Value destValue)	Copies the value of this Value into destValue.
MemorySegment	dupBoxed()	Get the contents of a G_TYPE_BOXED derived GValue.
GObject	dupObject()	Get the contents of a G_TYPE_OBJECT derived GValue, increasing its reference count.
ParamSpec	dupParam()	Get the contents of a G_TYPE_PARAM GValue, increasing its reference count.
String	dupString()	Get a copy the contents of a G_TYPE_STRING GValue.
Variant	dupVariant()	Get the contents of a variant GValue, increasing its refcount.
boolean	fitsPointer()	Determines if this Value will fit inside the size of a pointer value.
boolean	getBoolean()	Get the contents of a G_TYPE_BOOLEAN GValue.
MemorySegment	getBoxed()	Get the contents of a G_TYPE_BOXED derived GValue.
byte	getChar()	Deprecated. This function's return type is broken, see g_value_get_schar()
double	getDouble()	Get the contents of a G_TYPE_DOUBLE GValue.
int	getEnum()	Get the contents of a G_TYPE_ENUM GValue.
int	getFlags()	Get the contents of a G_TYPE_FLAGS GValue.
float	getFloat()	Get the contents of a G_TYPE_FLOAT GValue.
Type	getGtype()	Get the contents of a G_TYPE_GTYPE GValue.
int	getInt()	Get the contents of a G_TYPE_INT GValue.
long	getInt64()	Get the contents of a G_TYPE_INT64 GValue.
int	getLong()	Get the contents of a G_TYPE_LONG GValue.
static MemoryLayout	getMemoryLayout()	The memory layout of the native struct.
GObject	getObject()	Get the contents of a G_TYPE_OBJECT derived GValue.
ParamSpec	getParam()	Get the contents of a G_TYPE_PARAM GValue.
MemorySegment	getPointer()	Get the contents of a pointer GValue.
byte	getSchar()	Get the contents of a G_TYPE_CHAR GValue.
String	getString()	Get the contents of a G_TYPE_STRING GValue.
static Type	getType()	Get the GType of the Value class
byte	getUchar()	Get the contents of a G_TYPE_UCHAR GValue.
int	getUint()	Get the contents of a G_TYPE_UINT GValue.
long	getUint64()	Get the contents of a G_TYPE_UINT64 GValue.
int	getUlong()	Get the contents of a G_TYPE_ULONG GValue.
Variant	getVariant()	Get the contents of a variant GValue.
Value	init(Type gType)	Initializes this Value with the default value of type.
void	initFromInstance(TypeInstance instance)	Initializes and sets this Value from an instantiatable type via the value_table's collect_value() function.
MemorySegment	peekPointer()	Returns the value contents as pointer.
ValueDataUnion[]	readData()	Read the value of the field data.
Type	readGType()	Read the value of the field g_type.
static void	registerTransformFunc(Type srcType, Type destType, ValueTransform transformFunc)	Registers a value transformation function for use in g_value_transform().
Value	reset()	Clears the current value in this Value and resets it to the default value (as if the value had just been initialized).
void	setBoolean(boolean vBoolean)	Set the contents of a G_TYPE_BOOLEAN GValue to vBoolean.
void	setBoxed(@Nullable MemorySegment vBoxed)	Set the contents of a G_TYPE_BOXED derived GValue to vBoxed.
void	setBoxedTakeOwnership(@Nullable MemorySegment vBoxed)	Deprecated. Use g_value_take_boxed() instead.
void	setChar(byte vChar)	Deprecated. This function's input type is broken, see g_value_set_schar()
void	setDouble(double vDouble)	Set the contents of a G_TYPE_DOUBLE GValue to vDouble.
void	setEnum(int vEnum)	Set the contents of a G_TYPE_ENUM GValue to vEnum.
void	setFlags(int vFlags)	Set the contents of a G_TYPE_FLAGS GValue to vFlags.
void	setFloat(float vFloat)	Set the contents of a G_TYPE_FLOAT GValue to vFloat.
void	setGtype(Type vGtype)	Set the contents of a G_TYPE_GTYPE GValue to vGtype.
void	setInstance(@Nullable MemorySegment instance)	Sets this Value from an instantiatable type via the value_table's collect_value() function.
void	setInt(int vInt)	Set the contents of a G_TYPE_INT GValue to vInt.
void	setInt64(long vInt64)	Set the contents of a G_TYPE_INT64 GValue to vInt64.
void	setInternedString(@Nullable String vString)	Set the contents of a G_TYPE_STRING GValue to vString.
void	setLong(int vLong)	Set the contents of a G_TYPE_LONG GValue to vLong.
void	setObject(@Nullable GObject vObject)	Set the contents of a G_TYPE_OBJECT derived GValue to vObject.
void	setObjectTakeOwnership(@Nullable MemorySegment vObject)	Deprecated. Use g_value_take_object() instead.
void	setParam(@Nullable ParamSpec param)	Set the contents of a G_TYPE_PARAM GValue to param.
void	setParamTakeOwnership(@Nullable ParamSpec param)	Deprecated. Use g_value_take_param() instead.
void	setPointer(@Nullable MemorySegment vPointer)	Set the contents of a pointer GValue to vPointer.
void	setSchar(byte vChar)	Set the contents of a G_TYPE_CHAR GValue to vChar.
void	setStaticBoxed(@Nullable MemorySegment vBoxed)	Set the contents of a G_TYPE_BOXED derived GValue to vBoxed.
void	setStaticString(@Nullable String vString)	Set the contents of a G_TYPE_STRING GValue to vString.
void	setString(@Nullable String vString)	Set the contents of a G_TYPE_STRING GValue to a copy of vString.
void	setStringTakeOwnership(@Nullable String vString)	Deprecated. Use g_value_take_string() instead.
void	setUchar(byte vUchar)	Set the contents of a G_TYPE_UCHAR GValue to vUchar.
void	setUint(int vUint)	Set the contents of a G_TYPE_UINT GValue to vUint.
void	setUint64(long vUint64)	Set the contents of a G_TYPE_UINT64 GValue to vUint64.
void	setUlong(int vUlong)	Set the contents of a G_TYPE_ULONG GValue to vUlong.
void	setVariant(@Nullable Variant variant)	Set the contents of a variant GValue to variant.
String	stealString()	Steal ownership on contents of a G_TYPE_STRING GValue.
void	takeBoxed(@Nullable MemorySegment vBoxed)	Sets the contents of a G_TYPE_BOXED derived GValue to vBoxed and takes over the ownership of the caller’s reference to vBoxed; the caller doesn’t have to unref it any more.
void	takeObject(@Nullable MemorySegment vObject)	Sets the contents of a G_TYPE_OBJECT derived GValue to vObject and takes over the ownership of the caller’s reference to vObject; the caller doesn’t have to unref it any more (i.e.
void	takeParam(@Nullable ParamSpec param)	Sets the contents of a G_TYPE_PARAM GValue to param and takes over the ownership of the caller’s reference to param; the caller doesn’t have to unref it any more.
void	takeString(@Nullable String vString)	Sets the contents of a G_TYPE_STRING GValue to vString.
void	takeVariant(@Nullable Variant variant)	Set the contents of a variant GValue to variant, and takes over the ownership of the caller's reference to variant; the caller doesn't have to unref it any more (i.e.
String	toString()	Return a newly allocated String using GObjects.strdupValueContents(Value), which describes the contents of a Value.
boolean	transform(Value destValue)	Tries to cast the contents of this Value into a type appropriate to store in destValue, e.g.
static boolean	typeCompatible(Type srcType, Type destType)	Returns whether a GValue of type srcType can be copied into a GValue of type destType.
static boolean	typeTransformable(Type srcType, Type destType)	Check whether g_value_transform() is able to transform values of type srcType into values of type destType.
void	unset()	Clears the current value in this Value (if any) and "unsets" the type, this releases all resources associated with this GValue.
void	writeData(ValueDataUnion[] data, Arena _arena)	Write a value in the field data.
void	writeGType(Type gType)	Write a value in the field g_type.

Methods inherited from class io.github.jwharm.javagi.base.ProxyInstance

equals, handle, hashCode

Methods inherited from class java.lang.Object

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

Constructor Details

Value

public Value(MemorySegment address)

Create a Value proxy instance for the provided memory address.

Parameters:

address - the memory address of the native object

Value

public Value(Arena arena)

Allocate a new Value.

Parameters:

arena - to control the memory allocation scope

Value

public Value()

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

Value

public Value(Type gType,
 ValueDataUnion[] data,
 Arena arena)

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

Parameters:

gType - value for the field gType

data - value for the field data

arena - to control the memory allocation scope

Value

public Value(Type gType,
 ValueDataUnion[] data)

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

Parameters:

gType - value for the field gType

data - value for the field data

Method Details

getType

public static Type getType()

Get the GType of the Value class

Returns:

the GType

getMemoryLayout

public static MemoryLayout getMemoryLayout()

The memory layout of the native struct.

Returns:

the memory layout

readGType

public Type readGType()

Read the value of the field g_type.

Returns:

The value of the field g_type

writeGType

public void writeGType(Type gType)

Write a value in the field g_type.

Parameters:

gType - The new value for the field g_type

readData

public ValueDataUnion[] readData()

Read the value of the field data.

Returns:

The value of the field data

writeData

public void writeData(ValueDataUnion[] data,
 Arena _arena)

Write a value in the field data.

Parameters:

data - The new value for the field data

_arena - to control the memory allocation scope

registerTransformFunc

public static void registerTransformFunc(Type srcType,
 Type destType,
 ValueTransform transformFunc)

Registers a value transformation function for use in g_value_transform(). A previously registered transformation function for srcType and destType will be replaced.

Parameters:

srcType - Source type.

destType - Target type.

transformFunc - a function which transforms values of type srcType into value of type destType

typeCompatible

public static boolean typeCompatible(Type srcType,
 Type destType)

Returns whether a GValue of type srcType can be copied into a GValue of type destType.

Parameters:

srcType - source type to be copied.

destType - destination type for copying.

Returns:

true if g_value_copy() is possible with srcType and destType.

typeTransformable

public static boolean typeTransformable(Type srcType,
 Type destType)

Check whether g_value_transform() is able to transform values of type srcType into values of type destType. Note that for the types to be transformable, they must be compatible or a transformation function must be registered.

Parameters:

srcType - Source type.

destType - Target type.

Returns:

true if the transformation is possible, false otherwise.

copy

public void copy(Value destValue)

Copies the value of this Value into destValue.

Parameters:

destValue - An initialized GValue structure of the same type as this Value.

dupBoxed

public MemorySegment dupBoxed()

Get the contents of a G_TYPE_BOXED derived GValue. Upon getting, the boxed value is duplicated and needs to be later freed with g_boxed_free(), e.g. like: g_boxed_free (G_VALUE_TYPE (this Value), return_value);

Returns:

boxed contents of this Value

dupObject

public GObject dupObject()

Get the contents of a G_TYPE_OBJECT derived GValue, increasing its reference count. If the contents of the GValue are null, then null will be returned.

Returns:

object content of this Value, should be unreferenced when no longer needed.

dupParam

public ParamSpec dupParam()

Get the contents of a G_TYPE_PARAM GValue, increasing its reference count.

Returns:

GParamSpec content of this Value, should be unreferenced when no longer needed.

dupString

public String dupString()

Get a copy the contents of a G_TYPE_STRING GValue.

Returns:

a newly allocated copy of the string content of this Value

dupVariant

public Variant dupVariant()

Get the contents of a variant GValue, increasing its refcount. The returned GVariant is never floating.

Returns:

variant contents of this Value (may be null); should be unreffed using g_variant_unref() when no longer needed

fitsPointer

public boolean fitsPointer()

Determines if this Value will fit inside the size of a pointer value. This is an internal function introduced mainly for C marshallers.

Returns:

true if this Value will fit inside a pointer value.

getBoolean

public boolean getBoolean()

Get the contents of a G_TYPE_BOOLEAN GValue.

Returns:

boolean contents of this Value

getBoxed

public MemorySegment getBoxed()

Get the contents of a G_TYPE_BOXED derived GValue.

Returns:

boxed contents of this Value

getChar

@Deprecated
public byte getChar()

Deprecated.

This function's return type is broken, see g_value_get_schar()

Do not use this function; it is broken on platforms where the char type is unsigned, such as ARM and PowerPC. See g_value_get_schar().

Get the contents of a G_TYPE_CHAR GValue.

Returns:

character contents of this Value

getDouble

public double getDouble()

Get the contents of a G_TYPE_DOUBLE GValue.

Returns:

double contents of this Value

getEnum

public int getEnum()

Get the contents of a G_TYPE_ENUM GValue.

Returns:

enum contents of this Value

getFlags

public int getFlags()

Get the contents of a G_TYPE_FLAGS GValue.

Returns:

flags contents of this Value

getFloat

public float getFloat()

Get the contents of a G_TYPE_FLOAT GValue.

Returns:

float contents of this Value

getGtype

public Type getGtype()

Get the contents of a G_TYPE_GTYPE GValue.

Returns:

the GType stored in this Value

getInt

public int getInt()

Get the contents of a G_TYPE_INT GValue.

Returns:

integer contents of this Value

getInt64

public long getInt64()

Get the contents of a G_TYPE_INT64 GValue.

Returns:

64bit integer contents of this Value

getLong

public int getLong()

Get the contents of a G_TYPE_LONG GValue.

Returns:

long integer contents of this Value

getObject

public GObject getObject()

Get the contents of a G_TYPE_OBJECT derived GValue.

Returns:

object contents of this Value

getParam

public ParamSpec getParam()

Get the contents of a G_TYPE_PARAM GValue.

Returns:

GParamSpec content of this Value

getPointer

public MemorySegment getPointer()

Get the contents of a pointer GValue.

Returns:

pointer contents of this Value

getSchar

public byte getSchar()

Get the contents of a G_TYPE_CHAR GValue.

Returns:

signed 8 bit integer contents of this Value

getString

public String getString()

Get the contents of a G_TYPE_STRING GValue.

Returns:

string content of this Value

getUchar

public byte getUchar()

Get the contents of a G_TYPE_UCHAR GValue.

Returns:

unsigned character contents of this Value

getUint

public int getUint()

Get the contents of a G_TYPE_UINT GValue.

Returns:

unsigned integer contents of this Value

getUint64

public long getUint64()

Get the contents of a G_TYPE_UINT64 GValue.

Returns:

unsigned 64bit integer contents of this Value

getUlong

public int getUlong()

Get the contents of a G_TYPE_ULONG GValue.

Returns:

unsigned long integer contents of this Value

getVariant

public Variant getVariant()

Get the contents of a variant GValue.

Returns:

variant contents of this Value (may be null)

init

public Value init(Type gType)

Initializes this Value with the default value of type.

Parameters:

gType - Type the GValue should hold values of.

Returns:

the GValue structure that has been passed in

initFromInstance

public void initFromInstance(TypeInstance instance)

Initializes and sets this Value from an instantiatable type via the value_table's collect_value() function.

Note: The this Value will be initialised with the exact type of instance. If you wish to set the this Value's type to a different GType (such as a parent class GType), you need to manually call g_value_init() and g_value_set_instance().

Parameters:

instance - the instance

peekPointer

public MemorySegment peekPointer()

Returns the value contents as pointer. This function asserts that g_value_fits_pointer() returned true for the passed in value. This is an internal function introduced mainly for C marshallers.

Returns:

the value contents as pointer

reset

public Value reset()

Clears the current value in this Value and resets it to the default value (as if the value had just been initialized).

Returns:

the GValue structure that has been passed in

setBoolean

public void setBoolean(boolean vBoolean)

Set the contents of a G_TYPE_BOOLEAN GValue to vBoolean.

Parameters:

vBoolean - boolean value to be set

setBoxed

public void setBoxed(@Nullable
 @Nullable MemorySegment vBoxed)

Set the contents of a G_TYPE_BOXED derived GValue to vBoxed.

Parameters:

vBoxed - boxed value to be set

setBoxedTakeOwnership

@Deprecated
public void setBoxedTakeOwnership(@Nullable
 @Nullable MemorySegment vBoxed)

Deprecated.

Use g_value_take_boxed() instead.

This is an internal function introduced mainly for C marshallers.

Parameters:

vBoxed - duplicated unowned boxed value to be set

setChar

@Deprecated
public void setChar(byte vChar)

Deprecated.

This function's input type is broken, see g_value_set_schar()

Set the contents of a G_TYPE_CHAR GValue to vChar.

Parameters:

vChar - character value to be set

setDouble

public void setDouble(double vDouble)

Set the contents of a G_TYPE_DOUBLE GValue to vDouble.

Parameters:

vDouble - double value to be set

setEnum

public void setEnum(int vEnum)

Set the contents of a G_TYPE_ENUM GValue to vEnum.

Parameters:

vEnum - enum value to be set

setFlags

public void setFlags(int vFlags)

Set the contents of a G_TYPE_FLAGS GValue to vFlags.

Parameters:

vFlags - flags value to be set

setFloat

public void setFloat(float vFloat)

Set the contents of a G_TYPE_FLOAT GValue to vFloat.

Parameters:

vFloat - float value to be set

setGtype

public void setGtype(Type vGtype)

Set the contents of a G_TYPE_GTYPE GValue to vGtype.

Parameters:

vGtype - GType to be set

setInstance

public void setInstance(@Nullable
 @Nullable MemorySegment instance)

Sets this Value from an instantiatable type via the value_table's collect_value() function.

Parameters:

instance - the instance

setInt

public void setInt(int vInt)

Set the contents of a G_TYPE_INT GValue to vInt.

Parameters:

vInt - integer value to be set

setInt64

public void setInt64(long vInt64)

Set the contents of a G_TYPE_INT64 GValue to vInt64.

Parameters:

vInt64 - 64bit integer value to be set

setInternedString

public void setInternedString(@Nullable
 @Nullable String vString)

Set the contents of a G_TYPE_STRING GValue to vString. The string is assumed to be static and interned (canonical, for example from g_intern_string()), and is thus not duplicated when setting the GValue.

Parameters:

vString - static string to be set

setLong

public void setLong(int vLong)

Set the contents of a G_TYPE_LONG GValue to vLong.

Parameters:

vLong - long integer value to be set

setObject

public void setObject(@Nullable
 @Nullable GObject vObject)

Set the contents of a G_TYPE_OBJECT derived GValue to vObject.

g_value_set_object() increases the reference count of vObject (the GValue holds a reference to vObject). If you do not wish to increase the reference count of the object (i.e. you wish to pass your current reference to the GValue because you no longer need it), use g_value_take_object() instead.

It is important that your GValue holds a reference to vObject (either its own, or one it has taken) to ensure that the object won't be destroyed while the GValue still exists).

Parameters:

vObject - object value to be set

setObjectTakeOwnership

@Deprecated
public void setObjectTakeOwnership(@Nullable
 @Nullable MemorySegment vObject)

Deprecated.

Use g_value_take_object() instead.

This is an internal function introduced mainly for C marshallers.

Parameters:

vObject - object value to be set

setParam

public void setParam(@Nullable
 @Nullable ParamSpec param)

Set the contents of a G_TYPE_PARAM GValue to param.

Parameters:

param - the GParamSpec to be set

setParamTakeOwnership

@Deprecated
public void setParamTakeOwnership(@Nullable
 @Nullable ParamSpec param)

Deprecated.

Use g_value_take_param() instead.

This is an internal function introduced mainly for C marshallers.

Parameters:

param - the GParamSpec to be set

setPointer

public void setPointer(@Nullable
 @Nullable MemorySegment vPointer)

Set the contents of a pointer GValue to vPointer.

Parameters:

vPointer - pointer value to be set

setSchar

public void setSchar(byte vChar)

Set the contents of a G_TYPE_CHAR GValue to vChar.

Parameters:

vChar - signed 8 bit integer to be set

setStaticBoxed

public void setStaticBoxed(@Nullable
 @Nullable MemorySegment vBoxed)

Set the contents of a G_TYPE_BOXED derived GValue to vBoxed.

The boxed value is assumed to be static, and is thus not duplicated when setting the GValue.

Parameters:

vBoxed - static boxed value to be set

setStaticString

public void setStaticString(@Nullable
 @Nullable String vString)

Set the contents of a G_TYPE_STRING GValue to vString. The string is assumed to be static, and is thus not duplicated when setting the GValue.

If the the string is a canonical string, using g_value_set_interned_string() is more appropriate.

Parameters:

vString - static string to be set

setString

public void setString(@Nullable
 @Nullable String vString)

Set the contents of a G_TYPE_STRING GValue to a copy of vString.

Parameters:

vString - caller-owned string to be duplicated for the GValue

setStringTakeOwnership

@Deprecated
public void setStringTakeOwnership(@Nullable
 @Nullable String vString)

Deprecated.

Use g_value_take_string() instead.

This is an internal function introduced mainly for C marshallers.

Parameters:

vString - duplicated unowned string to be set

setUchar

public void setUchar(byte vUchar)

Set the contents of a G_TYPE_UCHAR GValue to vUchar.

Parameters:

vUchar - unsigned character value to be set

setUint

public void setUint(int vUint)

Set the contents of a G_TYPE_UINT GValue to vUint.

Parameters:

vUint - unsigned integer value to be set

setUint64

public void setUint64(long vUint64)

Set the contents of a G_TYPE_UINT64 GValue to vUint64.

Parameters:

vUint64 - unsigned 64bit integer value to be set

setUlong

public void setUlong(int vUlong)

Set the contents of a G_TYPE_ULONG GValue to vUlong.

Parameters:

vUlong - unsigned long integer value to be set

setVariant

public void setVariant(@Nullable
 @Nullable Variant variant)

Set the contents of a variant GValue to variant. If the variant is floating, it is consumed.

Parameters:

variant - a GVariant, or null

stealString

public String stealString()

Steal ownership on contents of a G_TYPE_STRING GValue. As a result of this operation the value's contents will be reset to null.

The purpose of this call is to provide a way to avoid an extra copy when some object have been serialized into string through GValue API.

NOTE: for safety and compatibility purposes, if GValue contains static string, or an interned one, this function will return a copy of the string. Otherwise the transfer notation would be ambiguous.

Returns:

string content of this Value; Should be freed with g_free() when no longer needed.

takeBoxed

public void takeBoxed(@Nullable
 @Nullable MemorySegment vBoxed)

Sets the contents of a G_TYPE_BOXED derived GValue to vBoxed and takes over the ownership of the caller’s reference to vBoxed; the caller doesn’t have to unref it any more.

Parameters:

vBoxed - duplicated unowned boxed value to be set

takeObject

public void takeObject(@Nullable
 @Nullable MemorySegment vObject)

Sets the contents of a G_TYPE_OBJECT derived GValue to vObject and takes over the ownership of the caller’s reference to vObject; the caller doesn’t have to unref it any more (i.e. the reference count of the object is not increased).

If you want the GValue to hold its own reference to vObject, use g_value_set_object() instead.

Parameters:

vObject - object value to be set

takeParam

public void takeParam(@Nullable
 @Nullable ParamSpec param)

Sets the contents of a G_TYPE_PARAM GValue to param and takes over the ownership of the caller’s reference to param; the caller doesn’t have to unref it any more.

Parameters:

param - the GParamSpec to be set

takeString

public void takeString(@Nullable
 @Nullable String vString)

Sets the contents of a G_TYPE_STRING GValue to vString.

Parameters:

vString - string to take ownership of

takeVariant

public void takeVariant(@Nullable
 @Nullable Variant variant)

Set the contents of a variant GValue to variant, and takes over the ownership of the caller's reference to variant; the caller doesn't have to unref it any more (i.e. the reference count of the variant is not increased).

If variant was floating then its floating reference is converted to a hard reference.

If you want the GValue to hold its own reference to variant, use g_value_set_variant() instead.

This is an internal function introduced mainly for C marshallers.

Parameters:

variant - a GVariant, or null

transform

public boolean transform(Value destValue)

Tries to cast the contents of this Value into a type appropriate to store in destValue, e.g. to transform a G_TYPE_INT value into a G_TYPE_FLOAT value. Performing transformations between value types might incur precision lossage. Especially transformations into strings might reveal seemingly arbitrary results and shouldn't be relied upon for production code (such as rcfile value or object property serialization).

Parameters:

destValue - Target value.

Returns:

Whether a transformation rule was found and could be applied. Upon failing transformations, destValue is left untouched.

unset

public void unset()

Clears the current value in this Value (if any) and "unsets" the type, this releases all resources associated with this GValue. An unset value is the same as an uninitialized (zero-filled) GValue structure.

toString

public String toString()

Return a newly allocated String using GObjects.strdupValueContents(Value), which describes the contents of a Value. The main purpose of this function is to describe Value contents for debugging output, the way in which the contents are described may change between different GLib versions.

Overrides:

toString in class Object

Returns:

the newly allocated String.