get_strv


Description:

[ CCode ( array_length_type = "gsize" ) ]
public (unowned string)[] get_strv ()

Gets the contents of an array of strings Variant.

This call makes a shallow copy; the return result should be released with g_free, but the individual strings must not be modified.

If return.length is non-null then the number of elements in the result is stored there. In any case, the resulting array will be null-terminated.

For an empty array, return.length will be set to 0 and a pointer to a null pointer will be returned.

Example: Get a string array:

public static int main () {
Variant var1 = new Variant.strv ({"a", "b", "c"});
// Output: ``a,b,c``
print ("%s\n", string.joinv (",", var1.dup_strv ()));
// Output: ``a,b,c``
print ("%s\n", string.joinv (",", var1.get_strv ()));
// Output: ``a,b,c``
print ("%s\n", string.joinv (",", (string[]) var1));
return 0;
}

valac --pkg glib-2.0 GLib.Variant.get_strv.vala

Parameters:

this

an array of strings Variant

length

the length of the result, or null

Returns:

an array of constant strings