Variant.getNormalForm

Gets a glib.Variant instance that has the same value as value and is trusted to be in normal form.

If value is already trusted to be in normal form then a new reference to value is returned.

If value is not already trusted, then it is scanned to check if it is in normal form. If it is found to be in normal form then it is marked as trusted and a new reference to it is returned.

If value is found not to be in normal form then a new trusted glib.Variant is created with the same value as value.

It makes sense to call this function if you've received glib.Variant data from untrusted sources and you want to ensure your serialised output is definitely in normal form.

If value is already in normal form, a new reference will be returned (which will be floating if value is floating). If it is not in normal form, the newly created glib.Variant will be returned with a single non-floating reference. Typically, Variant.takeRef should be called on the return value from this function to guarantee ownership of a single non-floating reference to it.

class Variant
getNormalForm
()

Return Value

Type: Variant

a trusted glib.Variant

Meta

Since

2.24