Function

GioSettingsGetMapping

Declaration

gboolean
(* GSettingsGetMapping) (
  GVariant* value,
  gpointer* result,
  gpointer user_data
)

Description [src]

The type of the function that is used to convert from a value stored in a GSettings to a value that is useful to the application.

If the value is successfully mapped, the result should be stored at result and TRUE returned. If mapping fails (for example, if value is not in the right format) then FALSE should be returned.

If value is NULL then it means that the mapping function is being given a “last chance” to successfully return a valid value. TRUE must be returned in this case.

Parameters

value GVariant
 

The GVariant to map, or NULL.

 The data is owned by the caller of the function.
result gpointer*
 

The result of the mapping.

 The argument will be set by the function.
 The argument can be set to NULL.
 The called function takes ownership of the data, and is responsible for freeing it.
user_data gpointer
 

The user data that was passed to g_settings_get_mapped()

Return value

Returns: gboolean
 

TRUE if the conversion succeeded, FALSE in case of an error.