Function

Giodbus_gvalue_to_gvariant

Declaration

GVariant*
g_dbus_gvalue_to_gvariant (
  const GValue* gvalue,
  const GVariantType* type
)

Description

Converts a GValue to a GVariant of the type indicated by the type parameter.

The conversion is using the following rules:

  • G_TYPE_STRING: ‘s’, ‘o’, ‘g’ or ‘ay’
  • G_TYPE_STRV: ‘as’, ‘ao’ or ‘aay’
  • G_TYPE_BOOLEAN: ‘b’
  • G_TYPE_UCHAR: ‘y’
  • G_TYPE_INT: ‘i’, ‘n’
  • G_TYPE_UINT: ‘u’, ‘q’
  • G_TYPE_INT64: ‘x’
  • G_TYPE_UINT64: ‘t’
  • G_TYPE_DOUBLE: ‘d’
  • G_TYPE_VARIANT: Any GVariantType

This can fail if e.g. gvalue is of type G_TYPE_STRING and type is ‘i’, i.e. G_VARIANT_TYPE_INT32. It will also fail for any GType (including e.g. G_TYPE_OBJECT and G_TYPE_BOXED derived-types) not in the table above.

Note that if gvalue is of type G_TYPE_VARIANT and its value is NULL, the empty GVariant instance (never NULL) for type is returned (e.g. 0 for scalar types, the empty string for string types, ‘/’ for object path types, the empty array for any array type and so on).

See the g_dbus_gvariant_to_gvalue() function for how to convert a GVariant to a GValue.

Available since:2.30

Parameters

gvalue GValue
 

A GValue to convert to a GVariant.

 The data is owned by the caller of the function.
type GVariantType
 

A GVariantType.

 The data is owned by the caller of the function.

Return value

Returns: GVariant
 

A GVariant (never floating) of GVariantType type holding the data from gvalue or an empty GVariant in case of failure. Free with g_variant_unref().

 The caller of the function takes ownership of the data, and is responsible for freeing it.