get_item_attribute
Description:
Queries item at position item_index
in this for the attribute specified by attribute
.
If the attribute exists and matches the VariantType corresponding to
format_string
then format_string
is used to deconstruct the value into the positional parameters and
true is returned.
If the attribute does not exist, or it does exist but has the wrong type, then the positional parameters are ignored and false is returned.
This function is a mix of get_item_attribute_value
and @get, followed by a g_variant_unref
. As such, format_string
must make a complete copy of the data (since the Variant may go away after the
call to g_variant_unref
). In particular, no '&' characters are allowed in format_string
.
Parameters:
this | |
item_index |
the index of the item |
attribute |
the attribute to query |
format_string |
a Variant format string |
... |
positional parameters, as per |
Returns:
true if the named attribute was found with the expected type |