@gtkx/ffi 0.1.45 → 0.1.46

package/dist/generated/gobject/value.js

@@ -3,6 +3,27 @@ import { getObject } from "@gtkx/ffi";
 import { GObject } from "./object.js";
 import { ParamSpec } from "./param-spec.js";
 import * as GLib from "../glib/index.js";
+/**
+ * An opaque structure used to hold different types of values.
+ *
+ * Before it can be used, a `GValue` has to be initialized to a specific type by
+ * calling [method@GObject.Value.init] on it.
+ *
+ * Many types which are stored within a `GValue` need to allocate data on the
+ * heap, so [method@GObject.Value.unset] must always be called on a `GValue` to
+ * free any such data once you’re finished with the `GValue`, even if the
+ * `GValue` itself is stored on the stack.
+ *
+ * The data within the structure has protected scope: it is accessible only
+ * to functions within a [struct@GObject.TypeValueTable] structure, or
+ * implementations of the `g_value_*()` API. That is, code which implements 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 [func@GObject.VALUE_TYPE] macro and related
+ * macros.
+ */
 export class Value {
     ptr;
     constructor() {
@@ -11,6 +32,12 @@ export class Value {
     createPtr(_init) {
         return alloc(8, "GValue", "libgobject-2.0.so.0");
     }
+    /**
+     * Checks whether a [method@GObject.Value.copy] is able to copy values of type
+     * `src_type` into values of type @dest_type.
+     * @param srcType - source type to be copied
+     * @param destType - destination type for copying
+     */
     static typeCompatible(srcType, destType) {
         return call("libgobject-2.0.so.0", "g_value_type_compatible", [
             {
@@ -23,6 +50,16 @@ export class Value {
             },
         ], { type: "boolean" });
     }
+    /**
+     * Checks whether [method@GObject.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 using
+     * [func@GObject.Value.register_transform_func].
+     * @param srcType - source type
+     * @param destType - target type
+     */
     static typeTransformable(srcType, destType) {
         return call("libgobject-2.0.so.0", "g_value_type_transformable", [
             {
@@ -35,6 +72,10 @@ export class Value {
             },
         ], { type: "boolean" });
     }
+    /**
+     * Copies the value of `src_value` into @dest_value.
+     * @param destValue - an initialized [struct@GObject.Value] structure of the same type
+     */
     copy(destValue) {
         call("libgobject-2.0.so.0", "g_value_copy", [
             {
@@ -52,6 +93,11 @@ export class Value {
             },
         ], { type: "undefined" });
     }
+    /**
+     * 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.
+     */
     dupObject() {
         const ptr = call("libgobject-2.0.so.0", "g_value_dup_object", [
             {
@@ -63,6 +109,9 @@ export class Value {
             return null;
         return getObject(ptr, GObject);
     }
+    /**
+     * Get a copy the contents of a %G_TYPE_STRING #GValue.
+     */
     dupString() {
         return call("libgobject-2.0.so.0", "g_value_dup_string", [
             {
@@ -71,6 +120,10 @@ export class Value {
             },
         ], { type: "string" });
     }
+    /**
+     * Get the contents of a variant #GValue, increasing its refcount. The returned
+     * #GVariant is never floating.
+     */
     dupVariant() {
         const ptr = call("libgobject-2.0.so.0", "g_value_dup_variant", [
             {
@@ -87,6 +140,11 @@ export class Value {
             return null;
         return getObject(ptr, GLib.Variant);
     }
+    /**
+     * Determines if `value` will fit inside the size of a pointer value.
+     *
+     * This is an internal function introduced mainly for C marshallers.
+     */
     fitsPointer() {
         return call("libgobject-2.0.so.0", "g_value_fits_pointer", [
             {
@@ -95,6 +153,9 @@ export class Value {
             },
         ], { type: "boolean" });
     }
+    /**
+     * Get the contents of a %G_TYPE_BOOLEAN #GValue.
+     */
     getBoolean() {
         return call("libgobject-2.0.so.0", "g_value_get_boolean", [
             {
@@ -103,6 +164,9 @@ export class Value {
             },
         ], { type: "boolean" });
     }
+    /**
+     * Get the contents of a %G_TYPE_BOXED derived #GValue.
+     */
     getBoxed() {
         return call("libgobject-2.0.so.0", "g_value_get_boxed", [
             {
@@ -111,6 +175,12 @@ export class Value {
             },
         ], { type: "int", size: 64, unsigned: true });
     }
+    /**
+     * 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.
+     */
     getChar() {
         return call("libgobject-2.0.so.0", "g_value_get_char", [
             {
@@ -119,6 +189,9 @@ export class Value {
             },
         ], { type: "int", size: 8, unsigned: false });
     }
+    /**
+     * Get the contents of a %G_TYPE_DOUBLE #GValue.
+     */
     getDouble() {
         return call("libgobject-2.0.so.0", "g_value_get_double", [
             {
@@ -127,6 +200,9 @@ export class Value {
             },
         ], { type: "float", size: 64 });
     }
+    /**
+     * Get the contents of a %G_TYPE_ENUM #GValue.
+     */
     getEnum() {
         return call("libgobject-2.0.so.0", "g_value_get_enum", [
             {
@@ -135,6 +211,9 @@ export class Value {
             },
         ], { type: "int", size: 32, unsigned: false });
     }
+    /**
+     * Get the contents of a %G_TYPE_FLAGS #GValue.
+     */
     getFlags() {
         return call("libgobject-2.0.so.0", "g_value_get_flags", [
             {
@@ -143,6 +222,9 @@ export class Value {
             },
         ], { type: "int", size: 32, unsigned: true });
     }
+    /**
+     * Get the contents of a %G_TYPE_FLOAT #GValue.
+     */
     getFloat() {
         return call("libgobject-2.0.so.0", "g_value_get_float", [
             {
@@ -151,6 +233,9 @@ export class Value {
             },
         ], { type: "float", size: 32 });
     }
+    /**
+     * Get the contents of a %G_TYPE_GTYPE #GValue.
+     */
     getGtype() {
         return call("libgobject-2.0.so.0", "g_value_get_gtype", [
             {
@@ -159,6 +244,9 @@ export class Value {
             },
         ], { type: "int", size: 64, unsigned: true });
     }
+    /**
+     * Get the contents of a %G_TYPE_INT #GValue.
+     */
     getInt() {
         return call("libgobject-2.0.so.0", "g_value_get_int", [
             {
@@ -167,6 +255,9 @@ export class Value {
             },
         ], { type: "int", size: 32, unsigned: false });
     }
+    /**
+     * Get the contents of a %G_TYPE_INT64 #GValue.
+     */
     getInt64() {
         return call("libgobject-2.0.so.0", "g_value_get_int64", [
             {
@@ -175,6 +266,9 @@ export class Value {
             },
         ], { type: "int", size: 64, unsigned: false });
     }
+    /**
+     * Get the contents of a %G_TYPE_LONG #GValue.
+     */
     getLong() {
         return call("libgobject-2.0.so.0", "g_value_get_long", [
             {
@@ -183,6 +277,9 @@ export class Value {
             },
         ], { type: "int", size: 64, unsigned: false });
     }
+    /**
+     * Get the contents of a %G_TYPE_OBJECT derived #GValue.
+     */
     getObject() {
         const ptr = call("libgobject-2.0.so.0", "g_value_get_object", [
             {
@@ -194,6 +291,9 @@ export class Value {
             return null;
         return getObject(ptr, GObject);
     }
+    /**
+     * Get the contents of a %G_TYPE_PARAM #GValue.
+     */
     getParam() {
         const ptr = call("libgobject-2.0.so.0", "g_value_get_param", [
             {
@@ -203,6 +303,9 @@ export class Value {
         ], { type: "gobject", borrowed: true });
         return getObject(ptr, ParamSpec);
     }
+    /**
+     * Get the contents of a pointer #GValue.
+     */
     getPointer() {
         return call("libgobject-2.0.so.0", "g_value_get_pointer", [
             {
@@ -211,6 +314,9 @@ export class Value {
             },
         ], { type: "int", size: 64, unsigned: true });
     }
+    /**
+     * Get the contents of a %G_TYPE_CHAR #GValue.
+     */
     getSchar() {
         return call("libgobject-2.0.so.0", "g_value_get_schar", [
             {
@@ -219,6 +325,9 @@ export class Value {
             },
         ], { type: "int", size: 8, unsigned: false });
     }
+    /**
+     * Get the contents of a %G_TYPE_STRING #GValue.
+     */
     getString() {
         return call("libgobject-2.0.so.0", "g_value_get_string", [
             {
@@ -227,6 +336,9 @@ export class Value {
             },
         ], { type: "string", borrowed: true });
     }
+    /**
+     * Get the contents of a %G_TYPE_UCHAR #GValue.
+     */
     getUchar() {
         return call("libgobject-2.0.so.0", "g_value_get_uchar", [
             {
@@ -235,6 +347,9 @@ export class Value {
             },
         ], { type: "int", size: 8, unsigned: true });
     }
+    /**
+     * Get the contents of a %G_TYPE_UINT #GValue.
+     */
     getUint() {
         return call("libgobject-2.0.so.0", "g_value_get_uint", [
             {
@@ -243,6 +358,9 @@ export class Value {
             },
         ], { type: "int", size: 32, unsigned: true });
     }
+    /**
+     * Get the contents of a %G_TYPE_UINT64 #GValue.
+     */
     getUint64() {
         return call("libgobject-2.0.so.0", "g_value_get_uint64", [
             {
@@ -251,6 +369,9 @@ export class Value {
             },
         ], { type: "int", size: 64, unsigned: true });
     }
+    /**
+     * Get the contents of a %G_TYPE_ULONG #GValue.
+     */
     getUlong() {
         return call("libgobject-2.0.so.0", "g_value_get_ulong", [
             {
@@ -259,6 +380,9 @@ export class Value {
             },
         ], { type: "int", size: 64, unsigned: true });
     }
+    /**
+     * Get the contents of a variant #GValue.
+     */
     getVariant() {
         const ptr = call("libgobject-2.0.so.0", "g_value_get_variant", [
             {
@@ -275,6 +399,22 @@ export class Value {
             return null;
         return getObject(ptr, GLib.Variant);
     }
+    /**
+     * Initializes `value` to store values of the given @type, and sets its value
+     * to the default for @type.
+     *
+     * This must be called before any other methods on a [struct@GObject.Value], so
+     * the value knows what type it’s meant to store.
+     *
+     * ```c
+     * GValue value = G_VALUE_INIT;
+     *
+     * g_value_init (&value, SOME_G_TYPE);
+     * …
+     * g_value_unset (&value);
+     * ```
+     * @param gType - type the [struct@GObject.Value] should hold values of
+     */
     init(gType) {
         const ptr = call("libgobject-2.0.so.0", "g_value_init", [
             {
@@ -293,6 +433,18 @@ export class Value {
         });
         return getObject(ptr, Value);
     }
+    /**
+     * Initializes and sets `value` from an instantiatable type.
+     *
+     * This calls the [callback@GObject.TypeValueCollectFunc] function for the type
+     * the [struct@GObject.Value] contains.
+     *
+     * Note: The `value` will be initialised with the exact type of
+     * @instance.  If you wish to set the @value’s type to a different
+     * [type@GObject.Type] (such as a parent class type), you need to manually call
+     * [method@GObject.Value.init] and [method@GObject.Value.set_instance].
+     * @param instance - the instance
+     */
     initFromInstance(instance) {
         call("libgobject-2.0.so.0", "g_value_init_from_instance", [
             {
@@ -305,6 +457,14 @@ export class Value {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Returns the value contents as a pointer.
+     *
+     * This function asserts that [method@GObject.Value.fits_pointer] returned true
+     * for the passed in value.
+     *
+     * This is an internal function introduced mainly for C marshallers.
+     */
     peekPointer() {
         return call("libgobject-2.0.so.0", "g_value_peek_pointer", [
             {
@@ -313,6 +473,11 @@ export class Value {
             },
         ], { type: "int", size: 64, unsigned: true });
     }
+    /**
+     * Clears the current value in `value` and resets it to the default value
+     * (as if the value had just been initialized using
+     * [method@GObject.Value.init]).
+     */
     reset() {
         const ptr = call("libgobject-2.0.so.0", "g_value_reset", [
             {
@@ -327,6 +492,10 @@ export class Value {
         });
         return getObject(ptr, Value);
     }
+    /**
+     * Set the contents of a %G_TYPE_BOOLEAN #GValue to @v_boolean.
+     * @param vBoolean - boolean value to be set
+     */
     setBoolean(vBoolean) {
         call("libgobject-2.0.so.0", "g_value_set_boolean", [
             {
@@ -339,6 +508,10 @@ export class Value {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Set the contents of a %G_TYPE_BOXED derived #GValue to @v_boxed.
+     * @param vBoxed - caller-owned boxed object to be duplicated for the #GValue
+     */
     setBoxed(vBoxed) {
         call("libgobject-2.0.so.0", "g_value_set_boxed", [
             {
@@ -352,6 +525,10 @@ export class Value {
             },
         ], { type: "undefined" });
     }
+    /**
+     * This is an internal function introduced mainly for C marshallers.
+     * @param vBoxed - duplicated unowned boxed value to be set
+     */
     setBoxedTakeOwnership(vBoxed) {
         call("libgobject-2.0.so.0", "g_value_set_boxed_take_ownership", [
             {
@@ -365,6 +542,10 @@ export class Value {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Set the contents of a %G_TYPE_CHAR #GValue to @v_char.
+     * @param vChar - character value to be set
+     */
     setChar(vChar) {
         call("libgobject-2.0.so.0", "g_value_set_char", [
             {
@@ -377,6 +558,10 @@ export class Value {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Set the contents of a %G_TYPE_DOUBLE #GValue to @v_double.
+     * @param vDouble - double value to be set
+     */
     setDouble(vDouble) {
         call("libgobject-2.0.so.0", "g_value_set_double", [
             {
@@ -389,6 +574,10 @@ export class Value {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Set the contents of a %G_TYPE_ENUM #GValue to @v_enum.
+     * @param vEnum - enum value to be set
+     */
     setEnum(vEnum) {
         call("libgobject-2.0.so.0", "g_value_set_enum", [
             {
@@ -401,6 +590,10 @@ export class Value {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Set the contents of a %G_TYPE_FLAGS #GValue to @v_flags.
+     * @param vFlags - flags value to be set
+     */
     setFlags(vFlags) {
         call("libgobject-2.0.so.0", "g_value_set_flags", [
             {
@@ -413,6 +606,10 @@ export class Value {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Set the contents of a %G_TYPE_FLOAT #GValue to @v_float.
+     * @param vFloat - float value to be set
+     */
     setFloat(vFloat) {
         call("libgobject-2.0.so.0", "g_value_set_float", [
             {
@@ -425,6 +622,10 @@ export class Value {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Set the contents of a %G_TYPE_GTYPE #GValue to @v_gtype.
+     * @param vGtype - #GType to be set
+     */
     setGtype(vGtype) {
         call("libgobject-2.0.so.0", "g_value_set_gtype", [
             {
@@ -437,6 +638,13 @@ export class Value {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Sets `value` from an instantiatable type.
+     *
+     * This calls the [callback@GObject.TypeValueCollectFunc] function for the type
+     * the [struct@GObject.Value] contains.
+     * @param instance - the instance
+     */
     setInstance(instance) {
         call("libgobject-2.0.so.0", "g_value_set_instance", [
             {
@@ -450,6 +658,10 @@ export class Value {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Set the contents of a %G_TYPE_INT #GValue to @v_int.
+     * @param vInt - integer value to be set
+     */
     setInt(vInt) {
         call("libgobject-2.0.so.0", "g_value_set_int", [
             {
@@ -462,6 +674,10 @@ export class Value {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Set the contents of a %G_TYPE_INT64 #GValue to @v_int64.
+     * @param vInt64 - 64bit integer value to be set
+     */
     setInt64(vInt64) {
         call("libgobject-2.0.so.0", "g_value_set_int64", [
             {
@@ -474,6 +690,12 @@ export class Value {
             },
         ], { type: "undefined" });
     }
+    /**
+     * 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.
+     * @param vString - static string to be set
+     */
     setInternedString(vString) {
         call("libgobject-2.0.so.0", "g_value_set_interned_string", [
             {
@@ -487,6 +709,10 @@ export class Value {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Set the contents of a %G_TYPE_LONG #GValue to @v_long.
+     * @param vLong - long integer value to be set
+     */
     setLong(vLong) {
         call("libgobject-2.0.so.0", "g_value_set_long", [
             {
@@ -499,6 +725,19 @@ export class Value {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Set the contents of a %G_TYPE_OBJECT derived #GValue to @v_object.
+     *
+     * g_value_set_object() increases the reference count of `v_object` (the #GValue holds a reference to @v_object).  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 `v_object` (either its
+     * own, or one it has taken) to ensure that the object won't be destroyed while
+     * the #GValue still exists).
+     * @param vObject - object value to be set
+     */
     setObject(vObject) {
         call("libgobject-2.0.so.0", "g_value_set_object", [
             {
@@ -512,6 +751,10 @@ export class Value {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Set the contents of a %G_TYPE_PARAM #GValue to @param.
+     * @param param - the #GParamSpec to be set
+     */
     setParam(param) {
         call("libgobject-2.0.so.0", "g_value_set_param", [
             {
@@ -525,6 +768,10 @@ export class Value {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Set the contents of a pointer #GValue to @v_pointer.
+     * @param vPointer - pointer value to be set
+     */
     setPointer(vPointer) {
         call("libgobject-2.0.so.0", "g_value_set_pointer", [
             {
@@ -538,6 +785,10 @@ export class Value {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Set the contents of a %G_TYPE_CHAR #GValue to @v_char.
+     * @param vChar - signed 8 bit integer to be set
+     */
     setSchar(vChar) {
         call("libgobject-2.0.so.0", "g_value_set_schar", [
             {
@@ -550,6 +801,13 @@ export class Value {
             },
         ], { type: "undefined" });
     }
+    /**
+     * 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.
+     * @param vBoxed - static boxed value to be set
+     */
     setStaticBoxed(vBoxed) {
         call("libgobject-2.0.so.0", "g_value_set_static_boxed", [
             {
@@ -563,6 +821,15 @@ export class Value {
             },
         ], { type: "undefined" });
     }
+    /**
+     * 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.
+     *
+     * If the the string is a canonical string, using g_value_set_interned_string()
+     * is more appropriate.
+     * @param vString - static string to be set
+     */
     setStaticString(vString) {
         call("libgobject-2.0.so.0", "g_value_set_static_string", [
             {
@@ -576,6 +843,10 @@ export class Value {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Set the contents of a %G_TYPE_STRING #GValue to a copy of @v_string.
+     * @param vString - caller-owned string to be duplicated for the #GValue
+     */
     setString(vString) {
         call("libgobject-2.0.so.0", "g_value_set_string", [
             {
@@ -589,6 +860,10 @@ export class Value {
             },
         ], { type: "undefined" });
     }
+    /**
+     * This is an internal function introduced mainly for C marshallers.
+     * @param vString - duplicated unowned string to be set
+     */
     setStringTakeOwnership(vString) {
         call("libgobject-2.0.so.0", "g_value_set_string_take_ownership", [
             {
@@ -602,6 +877,10 @@ export class Value {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Set the contents of a %G_TYPE_UCHAR #GValue to @v_uchar.
+     * @param vUchar - unsigned character value to be set
+     */
     setUchar(vUchar) {
         call("libgobject-2.0.so.0", "g_value_set_uchar", [
             {
@@ -614,6 +893,10 @@ export class Value {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Set the contents of a %G_TYPE_UINT #GValue to @v_uint.
+     * @param vUint - unsigned integer value to be set
+     */
     setUint(vUint) {
         call("libgobject-2.0.so.0", "g_value_set_uint", [
             {
@@ -626,6 +909,10 @@ export class Value {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Set the contents of a %G_TYPE_UINT64 #GValue to @v_uint64.
+     * @param vUint64 - unsigned 64bit integer value to be set
+     */
     setUint64(vUint64) {
         call("libgobject-2.0.so.0", "g_value_set_uint64", [
             {
@@ -638,6 +925,10 @@ export class Value {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Set the contents of a %G_TYPE_ULONG #GValue to @v_ulong.
+     * @param vUlong - unsigned long integer value to be set
+     */
     setUlong(vUlong) {
         call("libgobject-2.0.so.0", "g_value_set_ulong", [
             {
@@ -650,6 +941,11 @@ export class Value {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Set the contents of a variant #GValue to @variant.
+     * If the variant is floating, it is consumed.
+     * @param variant - a #GVariant, or %NULL
+     */
     setVariant(variant) {
         call("libgobject-2.0.so.0", "g_value_set_variant", [
             {
@@ -668,6 +964,17 @@ export class Value {
             },
         ], { type: "undefined" });
     }
+    /**
+     * 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.
+     */
     stealString() {
         return call("libgobject-2.0.so.0", "g_value_steal_string", [
             {
@@ -676,6 +983,11 @@ export class Value {
             },
         ], { type: "string" });
     }
+    /**
+     * 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.
+     * @param vBoxed - duplicated unowned boxed value to be set
+     */
     takeBoxed(vBoxed) {
         call("libgobject-2.0.so.0", "g_value_take_boxed", [
             {
@@ -689,6 +1001,10 @@ export class Value {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Sets the contents of a %G_TYPE_STRING #GValue to @v_string.
+     * @param vString - string to take ownership of
+     */
     takeString(vString) {
         call("libgobject-2.0.so.0", "g_value_take_string", [
             {
@@ -702,6 +1018,21 @@ export class Value {
             },
         ], { type: "undefined" });
     }
+    /**
+     * 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.
+     * @param variant - a #GVariant, or %NULL
+     */
     takeVariant(variant) {
         call("libgobject-2.0.so.0", "g_value_take_variant", [
             {
@@ -719,6 +1050,21 @@ export class Value {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Tries to cast the contents of `src_value` into a type appropriate
+     * to store in @dest_value.
+     *
+     * If a transformation is not possible, `dest_value` is not modified.
+     *
+     * For example, this could transform a `G_TYPE_INT` value into a `G_TYPE_FLOAT`
+     * value.
+     *
+     * Performing transformations between value types might incur precision loss.
+     * Especially transformations into strings might reveal seemingly arbitrary
+     * results and the format of particular transformations to strings is not
+     * guaranteed over time.
+     * @param destValue - target value
+     */
     transform(destValue) {
         return call("libgobject-2.0.so.0", "g_value_transform", [
             {
@@ -736,6 +1082,13 @@ export class Value {
             },
         ], { type: "boolean" });
     }
+    /**
+     * Clears the current value in `value` (if any) and ‘unsets’ the type.
+     *
+     * This releases all resources associated with this [struct@GObject.Value]. An
+     * unset value is the same as a cleared (zero-filled)
+     * [struct@GObject.Value] structure set to `G_VALUE_INIT`.
+     */
     unset() {
         call("libgobject-2.0.so.0", "g_value_unset", [
             {