Value

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 @g_type member should only be accessed through the G_VALUE_TYPE() macro.

class Value {

GValue* gValue;

bool ownedRef;

GValue* getValueStruct(bool transferOwnership);

void* getStruct();

this(GValue* gValue, bool ownedRef);

this(GOBJECT obj);

this(string value);

this(BOOL value);

this(CHAR value);

this(INT value);

this(FLOAT value);

GType gType [@property getter];

static GType getType();

void copy(Value destValue);

void* dupBoxed();

ObjectG dupObject();

ParamSpec dupParam();

string dupString();

Variant dupVariant();

bool fitsPointer();

bool getBoolean();

void* getBoxed();

char getChar();

double getDouble();

int getEnum();

uint getFlags();

float getFloat();

GType getGtype();

int getInt();

long getInt64();

glong getLong();

ObjectG getObject();

ParamSpec getParam();

void* getPointer();

byte getSchar();

string getString();

char getUchar();

uint getUint();

ulong getUint64();

gulong getUlong();

Variant getVariant();

Value init(GType gType);

void initFromInstance(TypeInstance instance_);

void* peekPointer();

Value reset();

void setBoolean(bool vBoolean);

void setBoxed(void* vBoxed);

void setBoxedTakeOwnership(void* vBoxed);

void setChar(char vChar);

void setDouble(double vDouble);

void setEnum(int vEnum);

void setFlags(uint vFlags);

void setFloat(float vFloat);

void setGtype(GType vGtype);

void setInstance(void* instance_);

void setInt(int vInt);

void setInt64(long vInt64);

void setInternedString(string vString);

void setLong(glong vLong);

void setObject(ObjectG vObject);

void setObjectTakeOwnership(void* vObject);

void setParam(ParamSpec param);

void setParamTakeOwnership(ParamSpec param);

void setPointer(void* vPointer);

void setSchar(byte vChar);

void setStaticBoxed(void* vBoxed);

void setStaticString(string vString);

void setString(string vString);

void setStringTakeOwnership(string vString);

void setUchar(char vUchar);

void setUint(uint vUint);

void setUint64(ulong vUint64);

void setUlong(gulong vUlong);

void setVariant(Variant variant);

void takeBoxed(void* vBoxed);

void takeObject(void* vObject);

void takeParam(ParamSpec param);

void takeString(string vString);

void takeVariant(Variant variant);

bool transform(Value destValue);

void unset();

static void registerTransformFunc(GType srcType, GType destType, GValueTransform transformFunc);

static bool typeCompatible(GType srcType, GType destType);

static bool typeTransformable(GType srcType, GType destType);

static ParamSpec paramSpecBoolean(string name, string nick, string blurb, bool defaultValue, GParamFlags flags);

static ParamSpec paramSpecBoxed(string name, string nick, string blurb, GType boxedType, GParamFlags flags);

static ParamSpec paramSpecChar(string name, string nick, string blurb, byte minimum, byte maximum, byte defaultValue, GParamFlags flags);

static ParamSpec paramSpecDouble(string name, string nick, string blurb, double minimum, double maximum, double defaultValue, GParamFlags flags);

static ParamSpec paramSpecEnum(string name, string nick, string blurb, GType enumType, int defaultValue, GParamFlags flags);

static ParamSpec paramSpecFlags(string name, string nick, string blurb, GType flagsType, uint defaultValue, GParamFlags flags);

static ParamSpec paramSpecFloat(string name, string nick, string blurb, float minimum, float maximum, float defaultValue, GParamFlags flags);

static ParamSpec paramSpecGtype(string name, string nick, string blurb, GType isAType, GParamFlags flags);

static ParamSpec paramSpecInt(string name, string nick, string blurb, int minimum, int maximum, int defaultValue, GParamFlags flags);

static ParamSpec paramSpecInt64(string name, string nick, string blurb, long minimum, long maximum, long defaultValue, GParamFlags flags);

static ParamSpec paramSpecLong(string name, string nick, string blurb, glong minimum, glong maximum, glong defaultValue, GParamFlags flags);

static ParamSpec paramSpecObject(string name, string nick, string blurb, GType objectType, GParamFlags flags);

static ParamSpec paramSpecOverride(string name, ParamSpec overridden);

static ParamSpec paramSpecParam(string name, string nick, string blurb, GType paramType, GParamFlags flags);

static ParamSpec paramSpecPointer(string name, string nick, string blurb, GParamFlags flags);

static ParamSpec paramSpecString(string name, string nick, string blurb, string defaultValue, GParamFlags flags);

static ParamSpec paramSpecUchar(string name, string nick, string blurb, ubyte minimum, ubyte maximum, ubyte defaultValue, GParamFlags flags);

static ParamSpec paramSpecUint(string name, string nick, string blurb, uint minimum, uint maximum, uint defaultValue, GParamFlags flags);

static ParamSpec paramSpecUint64(string name, string nick, string blurb, ulong minimum, ulong maximum, ulong defaultValue, GParamFlags flags);

static ParamSpec paramSpecUlong(string name, string nick, string blurb, gulong minimum, gulong maximum, gulong defaultValue, GParamFlags flags);

static ParamSpec paramSpecUnichar(string name, string nick, string blurb, dchar defaultValue, GParamFlags flags);

static ParamSpec paramSpecValueArray(string name, string nick, string blurb, ParamSpec elementSpec, GParamFlags flags);

static ParamSpec paramSpecVariant(string name, string nick, string blurb, VariantType type, Variant defaultValue, GParamFlags flags);

static string strdupValueContents(Value value);

}

Constructors

this this(GValue* gValue, bool ownedRef): Sets our main struct and passes it to the parent class.
this this()
this this(GOBJECT obj)
this this(string value)
this this(BOOL value)
this this(CHAR value)
this this(INT value)
this this(FLOAT value)

Members

Functions

copy void copy(Value destValue): Copies the value of @src_value into @dest_value.
dupBoxed void* 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 (@value), return_value);
dupObject ObjectG 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.
dupParam ParamSpec dupParam(): Get the contents of a %G_TYPE_PARAM #GValue, increasing its reference count.
dupString string dupString(): Get a copy the contents of a %G_TYPE_STRING #GValue.
dupVariant Variant dupVariant(): Get the contents of a variant #GValue, increasing its refcount. The returned #GVariant is never floating.
fitsPointer bool fitsPointer(): Determines if @value will fit inside the size of a pointer value. This is an internal function introduced mainly for C marshallers.
get TYPE get(): Retrieves a TYPE from Value, the Value must contain the appropriate type.
getBoolean bool getBoolean(): Get the contents of a %G_TYPE_BOOLEAN #GValue.
getBoxed void* getBoxed(): Get the contents of a %G_TYPE_BOXED derived #GValue.
getChar char getChar(): 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().
getDouble double getDouble(): Get the contents of a %G_TYPE_DOUBLE #GValue.
getEnum int getEnum(): Get the contents of a %G_TYPE_ENUM #GValue.
getFlags uint getFlags(): Get the contents of a %G_TYPE_FLAGS #GValue.
getFloat float getFloat(): Get the contents of a %G_TYPE_FLOAT #GValue.
getGtype GType getGtype(): Get the contents of a %G_TYPE_GTYPE #GValue.
getInt int getInt(): Get the contents of a %G_TYPE_INT #GValue.
getInt64 long getInt64(): Get the contents of a %G_TYPE_INT64 #GValue.
getLong glong getLong(): Get the contents of a %G_TYPE_LONG #GValue.
getObject ObjectG getObject(): Get the contents of a %G_TYPE_OBJECT derived #GValue.
getParam ParamSpec getParam(): Get the contents of a %G_TYPE_PARAM #GValue.
getPointer void* getPointer(): Get the contents of a pointer #GValue.
getSchar byte getSchar(): Get the contents of a %G_TYPE_CHAR #GValue.
getString string getString(): Get the contents of a %G_TYPE_STRING #GValue.
getStruct void* getStruct(): the main Gtk struct as a void*
getUchar char getUchar(): Get the contents of a %G_TYPE_UCHAR #GValue.
getUint uint getUint(): Get the contents of a %G_TYPE_UINT #GValue.
getUint64 ulong getUint64(): Get the contents of a %G_TYPE_UINT64 #GValue.
getUlong gulong getUlong(): Get the contents of a %G_TYPE_ULONG #GValue.
getValueStruct GValue* getValueStruct(bool transferOwnership): Get the main Gtk struct
getVariant Variant getVariant(): Get the contents of a variant #GValue.
init Value init(GType gType): Initializes @value with the default value of @type.
initFromInstance void initFromInstance(TypeInstance instance_): Initializes and sets @value from an instantiatable type via the value_table's collect_value() function.
peekPointer void* 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.
reset Value reset(): Clears the current value in @value and resets it to the default value (as if the value had just been initialized).
setBoolean void setBoolean(bool vBoolean): Set the contents of a %G_TYPE_BOOLEAN #GValue to @v_boolean.
setBoxed void setBoxed(void* vBoxed): Set the contents of a %G_TYPE_BOXED derived #GValue to @v_boxed.
setBoxedTakeOwnership void setBoxedTakeOwnership(void* vBoxed): This is an internal function introduced mainly for C marshallers.
setChar void setChar(char vChar): Set the contents of a %G_TYPE_CHAR #GValue to @v_char.
setDouble void setDouble(double vDouble): Set the contents of a %G_TYPE_DOUBLE #GValue to @v_double.
setEnum void setEnum(int vEnum): Set the contents of a %G_TYPE_ENUM #GValue to @v_enum.
setFlags void setFlags(uint vFlags): Set the contents of a %G_TYPE_FLAGS #GValue to @v_flags.
setFloat void setFloat(float vFloat): Set the contents of a %G_TYPE_FLOAT #GValue to @v_float.
setGtype void setGtype(GType vGtype): Set the contents of a %G_TYPE_GTYPE #GValue to @v_gtype.
setInstance void setInstance(void* instance_): Sets @value from an instantiatable type via the value_table's collect_value() function.
setInt void setInt(int vInt): Set the contents of a %G_TYPE_INT #GValue to @v_int.
setInt64 void setInt64(long vInt64): Set the contents of a %G_TYPE_INT64 #GValue to @v_int64.
setInternedString void setInternedString(string vString): Set the contents of a %G_TYPE_STRING #GValue to @v_string. 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.
setLong void setLong(glong vLong): Set the contents of a %G_TYPE_LONG #GValue to @v_long.
setObject void setObject(ObjectG vObject): Set the contents of a %G_TYPE_OBJECT derived #GValue to @v_object.
setObjectTakeOwnership void setObjectTakeOwnership(void* vObject): This is an internal function introduced mainly for C marshallers.
setParam void setParam(ParamSpec param): Set the contents of a %G_TYPE_PARAM #GValue to @param.
setParamTakeOwnership void setParamTakeOwnership(ParamSpec param): This is an internal function introduced mainly for C marshallers.
setPointer void setPointer(void* vPointer): Set the contents of a pointer #GValue to @v_pointer.
setSchar void setSchar(byte vChar): Set the contents of a %G_TYPE_CHAR #GValue to @v_char.
setStaticBoxed void setStaticBoxed(void* vBoxed): Set the contents of a %G_TYPE_BOXED derived #GValue to @v_boxed. The boxed value is assumed to be static, and is thus not duplicated when setting the #GValue.
setStaticString void setStaticString(string vString): Set the contents of a %G_TYPE_STRING #GValue to @v_string. The string is assumed to be static, and is thus not duplicated when setting the #GValue.
setString void setString(string vString): Set the contents of a %G_TYPE_STRING #GValue to @v_string.
setStringTakeOwnership void setStringTakeOwnership(string vString): This is an internal function introduced mainly for C marshallers.
setUchar void setUchar(char vUchar): Set the contents of a %G_TYPE_UCHAR #GValue to @v_uchar.
setUint void setUint(uint vUint): Set the contents of a %G_TYPE_UINT #GValue to @v_uint.
setUint64 void setUint64(ulong vUint64): Set the contents of a %G_TYPE_UINT64 #GValue to @v_uint64.
setUlong void setUlong(gulong vUlong): Set the contents of a %G_TYPE_ULONG #GValue to @v_ulong.
setVariant void setVariant(Variant variant): Set the contents of a variant #GValue to @variant. If the variant is floating, it is consumed.
takeBoxed void takeBoxed(void* vBoxed): Sets the contents of a %G_TYPE_BOXED derived #GValue to @v_boxed and takes over the ownership of the caller’s reference to @v_boxed; the caller doesn’t have to unref it any more.
takeObject void takeObject(void* vObject): Sets the contents of a %G_TYPE_OBJECT derived #GValue to @v_object and takes over the ownership of the caller’s reference to @v_object; the caller doesn’t have to unref it any more (i.e. the reference count of the object is not increased).
takeParam void takeParam(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.
takeString void takeString(string vString): Sets the contents of a %G_TYPE_STRING #GValue to @v_string.
takeVariant void takeVariant(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).
transform bool transform(Value destValue): Tries to cast the contents of @src_value into a type appropriate to store in @dest_value, 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).
unset void unset(): Clears the current value in @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.

Properties

gType GType gType [@property getter]: The GType of the contianed value.

Static functions

getType GType getType()
paramSpecBoolean ParamSpec paramSpecBoolean(string name, string nick, string blurb, bool defaultValue, GParamFlags flags): Creates a new #GParamSpecBoolean instance specifying a %G_TYPE_BOOLEAN property. In many cases, it may be more appropriate to use an enum with g_param_spec_enum(), both to improve code clarity by using explicitly named values, and to allow for more values to be added in future without breaking API.
paramSpecBoxed ParamSpec paramSpecBoxed(string name, string nick, string blurb, GType boxedType, GParamFlags flags): Creates a new #GParamSpecBoxed instance specifying a %G_TYPE_BOXED derived property.
paramSpecChar ParamSpec paramSpecChar(string name, string nick, string blurb, byte minimum, byte maximum, byte defaultValue, GParamFlags flags): Creates a new #GParamSpecChar instance specifying a %G_TYPE_CHAR property.
paramSpecDouble ParamSpec paramSpecDouble(string name, string nick, string blurb, double minimum, double maximum, double defaultValue, GParamFlags flags): Creates a new #GParamSpecDouble instance specifying a %G_TYPE_DOUBLE property.
paramSpecEnum ParamSpec paramSpecEnum(string name, string nick, string blurb, GType enumType, int defaultValue, GParamFlags flags): Creates a new #GParamSpecEnum instance specifying a %G_TYPE_ENUM property.
paramSpecFlags ParamSpec paramSpecFlags(string name, string nick, string blurb, GType flagsType, uint defaultValue, GParamFlags flags): Creates a new #GParamSpecFlags instance specifying a %G_TYPE_FLAGS property.
paramSpecFloat ParamSpec paramSpecFloat(string name, string nick, string blurb, float minimum, float maximum, float defaultValue, GParamFlags flags): Creates a new #GParamSpecFloat instance specifying a %G_TYPE_FLOAT property.
paramSpecGtype ParamSpec paramSpecGtype(string name, string nick, string blurb, GType isAType, GParamFlags flags): Creates a new #GParamSpecGType instance specifying a %G_TYPE_GTYPE property.
paramSpecInt ParamSpec paramSpecInt(string name, string nick, string blurb, int minimum, int maximum, int defaultValue, GParamFlags flags): Creates a new #GParamSpecInt instance specifying a %G_TYPE_INT property.
paramSpecInt64 ParamSpec paramSpecInt64(string name, string nick, string blurb, long minimum, long maximum, long defaultValue, GParamFlags flags): Creates a new #GParamSpecInt64 instance specifying a %G_TYPE_INT64 property.
paramSpecLong ParamSpec paramSpecLong(string name, string nick, string blurb, glong minimum, glong maximum, glong defaultValue, GParamFlags flags): Creates a new #GParamSpecLong instance specifying a %G_TYPE_LONG property.
paramSpecObject ParamSpec paramSpecObject(string name, string nick, string blurb, GType objectType, GParamFlags flags): Creates a new #GParamSpecBoxed instance specifying a %G_TYPE_OBJECT derived property.
paramSpecOverride ParamSpec paramSpecOverride(string name, ParamSpec overridden): Creates a new property of type #GParamSpecOverride. This is used to direct operations to another paramspec, and will not be directly useful unless you are implementing a new base type similar to GObject.
paramSpecParam ParamSpec paramSpecParam(string name, string nick, string blurb, GType paramType, GParamFlags flags): Creates a new #GParamSpecParam instance specifying a %G_TYPE_PARAM property.
paramSpecPointer ParamSpec paramSpecPointer(string name, string nick, string blurb, GParamFlags flags): Creates a new #GParamSpecPointer instance specifying a pointer property. Where possible, it is better to use g_param_spec_object() or g_param_spec_boxed() to expose memory management information.
paramSpecString ParamSpec paramSpecString(string name, string nick, string blurb, string defaultValue, GParamFlags flags): Creates a new #GParamSpecString instance.
paramSpecUchar ParamSpec paramSpecUchar(string name, string nick, string blurb, ubyte minimum, ubyte maximum, ubyte defaultValue, GParamFlags flags): Creates a new #GParamSpecUChar instance specifying a %G_TYPE_UCHAR property.
paramSpecUint ParamSpec paramSpecUint(string name, string nick, string blurb, uint minimum, uint maximum, uint defaultValue, GParamFlags flags): Creates a new #GParamSpecUInt instance specifying a %G_TYPE_UINT property.
paramSpecUint64 ParamSpec paramSpecUint64(string name, string nick, string blurb, ulong minimum, ulong maximum, ulong defaultValue, GParamFlags flags): Creates a new #GParamSpecUInt64 instance specifying a %G_TYPE_UINT64 property.
paramSpecUlong ParamSpec paramSpecUlong(string name, string nick, string blurb, gulong minimum, gulong maximum, gulong defaultValue, GParamFlags flags): Creates a new #GParamSpecULong instance specifying a %G_TYPE_ULONG property.
paramSpecUnichar ParamSpec paramSpecUnichar(string name, string nick, string blurb, dchar defaultValue, GParamFlags flags): Creates a new #GParamSpecUnichar instance specifying a %G_TYPE_UINT property. #GValue structures for this property can be accessed with g_value_set_uint() and g_value_get_uint().
paramSpecValueArray ParamSpec paramSpecValueArray(string name, string nick, string blurb, ParamSpec elementSpec, GParamFlags flags): Creates a new #GParamSpecValueArray instance specifying a %G_TYPE_VALUE_ARRAY property. %G_TYPE_VALUE_ARRAY is a %G_TYPE_BOXED type, as such, #GValue structures for this property can be accessed with g_value_set_boxed() and g_value_get_boxed().
paramSpecVariant ParamSpec paramSpecVariant(string name, string nick, string blurb, VariantType type, Variant defaultValue, GParamFlags flags): Creates a new #GParamSpecVariant instance specifying a #GVariant property.
registerTransformFunc void registerTransformFunc(GType srcType, GType destType, GValueTransform transformFunc): Registers a value transformation function for use in g_value_transform(). A previously registered transformation function for @src_type and @dest_type will be replaced.
strdupValueContents string strdupValueContents(Value value): Return a newly allocated string, which describes the contents of a #GValue. The main purpose of this function is to describe #GValue contents for debugging output, the way in which the contents are described may change between different GLib versions.
typeCompatible bool typeCompatible(GType srcType, GType destType): Returns whether a #GValue of type @src_type can be copied into a #GValue of type @dest_type.
typeTransformable bool typeTransformable(GType srcType, GType destType): Check whether g_value_transform() is able to transform values of type @src_type into values of type @dest_type. Note that for the types to be transformable, they must be compatible or a transformation function must be registered.

Variables

gValue GValue* gValue;: the main Gtk struct
ownedRef bool ownedRef;: Undocumented in source.

Meta

Source

See Implementation

gobject Value classes

Value