GimpConfig-utils: GIMP Config Library Reference Manual

+ + +

GimpConfig-utils

GimpConfig-utils — Miscellaneous utility functions for libgimpconfig.

Functions

++++ + + + + + + + + + + + + + + + + + + + + + + +

+GList * +	+gimp_config_diff () +
+gboolean +	+gimp_config_sync () +
+void +	+gimp_config_reset_properties () +
+void +	+gimp_config_reset_property () +
+void +	+gimp_config_string_append_escaped () +

Description

Miscellaneous utility functions for libgimpconfig.

Functions

gimp_config_diff ()

GList *
+gimp_config_diff (GObject *a,
+                  GObject *b,
+                  GParamFlags flags);

Compares all properties of a + and b + that have all flags + set. If +flags + is 0, all properties are compared.

If the two objects are not of the same type, only properties that +exist in both object classes and are of the same value_type are +compared.

Parameters

+++++ + + + + + + + + + + + + + + + + + +

a	a GObject
b	another GObject object
flags	a mask of GParamFlags

Returns

a GList of differing GParamSpecs.

Since: 2.4

gimp_config_sync ()

gboolean
+gimp_config_sync (GObject *src,
+                  GObject *dest,
+                  GParamFlags flags);

Compares all read- and write-able properties from src + and dest + +that have all flags + set. Differing values are then copied from +src + to dest +. If flags + is 0, all differing read/write properties.

Properties marked as "construct-only" are not touched.

If the two objects are not of the same type, only properties that +exist in both object classes and are of the same value_type are +synchronized

Parameters

+++++ + + + + + + + + + + + + + + + + + +

src	a GObject
dest	another GObject
flags	a mask of GParamFlags

Returns

TRUE if dest +was modified, FALSE otherwise

Since: 2.4

gimp_config_reset_properties ()

void
+gimp_config_reset_properties (GObject *object);

Resets all writable properties of object + to the default values as +defined in their GParamSpec. Properties marked as "construct-only" +are not touched.

If you want to reset a GimpConfig object, please use gimp_config_reset().

Parameters

+++++ + + + + + +

object

a GObject

Since: 2.4

gimp_config_reset_property ()

void
+gimp_config_reset_property (GObject *object,
+                            const gchar *property_name);

Resets the property named property_name + to its default value. The +property must be writable and must not be marked as "construct-only".

Parameters

+++++ + + + + + + + + + + + + +

object	a GObject
property_name	name of the property to reset

Since: 2.4

gimp_config_string_append_escaped ()

void
+gimp_config_string_append_escaped (GString *string,
+                                   const gchar *val);

Escapes and quotes val + and appends it to string +. The escape +algorithm is different from the one used by g_strescape() since it +leaves non-ASCII characters intact and thus preserves UTF-8 +strings. Only control characters and quotes are being escaped.

Parameters

+++++ + + + + + + + + + + + + +

string	pointer to a GString
val	a string to append or `NULL`

Since: 2.4