![]() | ![]() | ![]() | GIMP Config Library Reference Manual | ![]() |
---|
gimpconfig-ifacegimpconfig-iface — High-level API for libgimpconfig. |
GimpConfig; GimpConfigInterface; gboolean gimp_config_serialize_to_file (GimpConfig *config, const gchar *filename, const gchar *header, const gchar *footer, gpointer data, GError **error); gboolean gimp_config_serialize_to_fd (GimpConfig *config, gint fd, gpointer data); gchar* gimp_config_serialize_to_string (GimpConfig *config, gpointer data); gboolean gimp_config_deserialize_file (GimpConfig *config, const gchar *filename, gpointer data, GError **error); gboolean gimp_config_deserialize_string (GimpConfig *config, const gchar *text, gint text_len, gpointer data, GError **error); gboolean gimp_config_deserialize_return (GScanner *scanner, GTokenType expected_token, gint nest_level); gpointer gimp_config_duplicate (GimpConfig *config); gboolean gimp_config_is_equal_to (GimpConfig *a, GimpConfig *b); void gimp_config_reset (GimpConfig *config);
gboolean gimp_config_serialize_to_file (GimpConfig *config, const gchar *filename, const gchar *header, const gchar *footer, gpointer data, GError **error);
Serializes the object properties of config to the file specified by filename. If a file with that name already exists, it is overwritten. Basically this function opens filename for you and calls the serialize function of the config's GimpConfigInterface.
config : | a GObject that implements the GimpConfigInterface. |
filename : | the name of the file to write the configuration to. |
header : | optional file header (must be ASCII only) |
footer : | optional file footer (must be ASCII only) |
data : | user data passed to the serialize implementation. |
error : | |
Returns : | TRUE if serialization succeeded, FALSE otherwise. |
Since GIMP 2.4
gboolean gimp_config_serialize_to_fd (GimpConfig *config, gint fd, gpointer data);
Serializes the object properties of config to the given file descriptor.
config : | a GObject that implements the GimpConfigInterface. |
fd : | a file descriptor, opened for writing |
data : | user data passed to the serialize implementation. |
Returns : | TRUE if serialization succeeded, FALSE otherwise. |
Since GIMP 2.4
gchar* gimp_config_serialize_to_string (GimpConfig *config, gpointer data);
Serializes the object properties of config to a string.
config : | a GObject that implements the GimpConfigInterface. |
data : | user data passed to the serialize implementation. |
Returns : | a newly allocated NUL-terminated string. |
Since GIMP 2.4
gboolean gimp_config_deserialize_file (GimpConfig *config, const gchar *filename, gpointer data, GError **error);
config : | |
filename : | |
data : | |
error : | |
Returns : |
gboolean gimp_config_deserialize_string (GimpConfig *config, const gchar *text, gint text_len, gpointer data, GError **error);
Configures config from text. Basically this function creates a properly configured GScanner for you and calls the deserialize function of the config's GimpConfigInterface.
config : | a GObject that implements the GimpConfigInterface. |
text : | string to deserialize (in UTF-8 encoding) |
text_len : | length of text in bytes or -1 |
data : | |
error : | |
Returns : | TRUE if deserialization succeeded, FALSE otherwise. |
Since GIMP 2.4
gboolean gimp_config_deserialize_return (GScanner *scanner, GTokenType expected_token, gint nest_level);
scanner : | |
expected_token : | |
nest_level : | |
Returns : |
Since GIMP 2.4
gpointer gimp_config_duplicate (GimpConfig *config);
Creates a copy of the passed object by copying all object properties. The default implementation of the GimpConfigInterface only works for objects that are completely defined by their properties.
config : | a GObject that implements the GimpConfigInterface. |
Returns : | the duplicated GimpConfig object |
Since GIMP 2.4
gboolean gimp_config_is_equal_to (GimpConfig *a, GimpConfig *b);
Compares the two objects. The default implementation of the GimpConfigInterface compares the object properties and thus only works for objects that are completely defined by their properties.
a : | a GObject that implements the GimpConfigInterface. |
b : | another GObject of the same type as a. |
Returns : | TRUE if the two objects are equal. |
Since GIMP 2.4
void gimp_config_reset (GimpConfig *config);
Resets the object to its default state. The default implementation of the GimpConfigInterface only works for objects that are completely defined by their properties.
config : | a GObject that implements the GimpConfigInterface. |
Since GIMP 2.4
<< Object Hierarchy | gimpconfig-deserialize >> |