[glibmm] Regenerated some glib .defs.

From: Murray Cumming <murrayc src gnome org>
To: commits-list gnome org
Cc:
Subject: [glibmm] Regenerated some glib .defs.
Date: Fri, 7 Sep 2012 07:33:36 +0000 (UTC)
commit 07e2367b0c25ac480eedf5980170d79ec0d31174
Author: Murray Cumming <murrayc murrayc com>
Date:   Thu Sep 6 10:24:08 2012 +0200

    Regenerated some glib .defs.
    
    * glib/src/glib_docs.xml:
    * glib/src/glib_enums.defs:
    * glib/src/glib_functions.defs:
    * glib/src/gobject_functions.defs:

 ChangeLog                       |    9 ++
 glib/src/glib_docs.xml          |  290 +++++++++++++++++++++++++++++++++++++++
 glib/src/glib_functions.defs    |   24 ++++
 glib/src/gobject_functions.defs |   48 +++++++
 4 files changed, 371 insertions(+), 0 deletions(-)
---
diff --git a/ChangeLog b/ChangeLog
index c5d6458..aa81c73 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,14 @@
 2012-09-06  Murray Cumming  <murrayc murrayc com>
 
+	Regenerated some glib .defs.
+
+	* glib/src/glib_docs.xml:
+	* glib/src/glib_enums.defs:
+	* glib/src/glib_functions.defs:
+	* glib/src/gobject_functions.defs:
+
+2012-09-06  Murray Cumming  <murrayc murrayc com>
+
 	Regenerate other gio .defs.
 
 	* gio/src/gio_docs.xml:
diff --git a/glib/src/glib_docs.xml b/glib/src/glib_docs.xml
index 4afcf5e..9287592 100644
--- a/glib/src/glib_docs.xml
+++ b/glib/src/glib_docs.xml
@@ -8047,10 +8047,55 @@ Since: 2.8
 </return>
 </function>
 
+<function name="g_datalist_id_dup_data">
+<description>
+This is a variant of g_datalist_id_get_data() which
+returns a 'duplicate' of the value. @dup_func defines the
+meaning of 'duplicate' in this context, it could e.g.
+take a reference on a ref-counted object.
+
+If the @key_id is not set in the datalist then @dup_func
+will be called with a %NULL argument.
+
+Note that @dup_func is called while the datalist is locked, so it
+is not allowed to read or modify the datalist.
+
+This function can be useful to avoid races when multiple
+threads are using the same datalist and the same key.
+
+Since: 2.34
+
+</description>
+<parameters>
+<parameter name="datalist">
+<parameter_description> location of a datalist
+</parameter_description>
+</parameter>
+<parameter name="key_id">
+<parameter_description> the #GQuark identifying a data element
+</parameter_description>
+</parameter>
+<parameter name="dup_func">
+<parameter_description> function to duplicate the old value
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> passed as user_data to @dup_func
+</parameter_description>
+</parameter>
+</parameters>
+<return> the result of calling @dup_func on the value
+associated with @key_id in @datalist, or %NULL if not set.
+If @dup_func is %NULL, the value is returned unmodified.
+
+</return>
+</function>
+
 <function name="g_datalist_id_get_data">
 <description>
 Retrieves the data element corresponding to @key_id.
 
+
 </description>
 <parameters>
 <parameter name="datalist">
@@ -8104,6 +8149,57 @@ function.
 </return>
 </function>
 
+<function name="g_datalist_id_replace_data">
+<description>
+Compares the member that is associated with @key_id in
+ datalist to @oldval, and if they are the same, replace
+ oldval with @newval.
+
+This is like a typical atomic compare-and-exchange
+operation, for a member of @datalist.
+
+If the previous value was replaced then ownership of the
+old value (@oldval) is passed to the caller, including
+the registred destroy notify for it (passed out in @old_destroy).
+Its up to the caller to free this as he wishes, which may
+or may not include using @old_destroy as sometimes replacement
+should not destroy the object in the normal way.
+
+Return: %TRUE if the existing value for @key_id was replaced
+by @newval, %FALSE otherwise.
+
+Since: 2.34
+
+</description>
+<parameters>
+<parameter name="datalist">
+<parameter_description> location of a datalist
+</parameter_description>
+</parameter>
+<parameter name="key_id">
+<parameter_description> the #GQuark identifying a data element
+</parameter_description>
+</parameter>
+<parameter name="oldval">
+<parameter_description> the old value to compare against
+</parameter_description>
+</parameter>
+<parameter name="newval">
+<parameter_description> the new value to replace it with
+</parameter_description>
+</parameter>
+<parameter name="destroy">
+<parameter_description> destroy notify for the new value
+</parameter_description>
+</parameter>
+<parameter name="old_destroy">
+<parameter_description> destroy notify for the existing value
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
 <function name="g_datalist_id_set_data">
 <description>
 Sets the data corresponding to the given #GQuark id. Any previous
@@ -23012,6 +23108,98 @@ followed by %NULL
 <return></return>
 </function>
 
+<function name="g_object_dup_data">
+<description>
+This is a variant of g_object_get_data() which returns
+a 'duplicate' of the value. @dup_func defines the
+meaning of 'duplicate' in this context, it could e.g.
+take a reference on a ref-counted object.
+
+If the @key is not set on the object then @dup_func
+will be called with a %NULL argument.
+
+Note that @dup_func is called while user data of @object
+is locked.
+
+This function can be useful to avoid races when multiple
+threads are using object data on the same key on the same
+object.
+
+Since: 2.34
+
+</description>
+<parameters>
+<parameter name="object">
+<parameter_description> the #GObject to store user data on
+</parameter_description>
+</parameter>
+<parameter name="key">
+<parameter_description> a string, naming the user data pointer
+</parameter_description>
+</parameter>
+<parameter name="dup_func">
+<parameter_description> function to dup the value
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> passed as user_data to @dup_func
+</parameter_description>
+</parameter>
+</parameters>
+<return> the result of calling @dup_func on the value
+associated with @key on @object, or %NULL if not set.
+If @dup_func is %NULL, the value is returned
+unmodified.
+
+</return>
+</function>
+
+<function name="g_object_dup_qdata">
+<description>
+This is a variant of g_object_get_qdata() which returns
+a 'duplicate' of the value. @dup_func defines the
+meaning of 'duplicate' in this context, it could e.g.
+take a reference on a ref-counted object.
+
+If the @quark is not set on the object then @dup_func
+will be called with a %NULL argument.
+
+Note that @dup_func is called while user data of @object
+is locked.
+
+This function can be useful to avoid races when multiple
+threads are using object data on the same key on the same
+object.
+
+Since: 2.34
+
+</description>
+<parameters>
+<parameter name="object">
+<parameter_description> the #GObject to store user data on
+</parameter_description>
+</parameter>
+<parameter name="quark">
+<parameter_description> a #GQuark, naming the user data pointer
+</parameter_description>
+</parameter>
+<parameter name="dup_func">
+<parameter_description> function to dup the value
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> passed as user_data to @dup_func
+</parameter_description>
+</parameter>
+</parameters>
+<return> the result of calling @dup_func on the value
+associated with @quark on @object, or %NULL if not set.
+If @dup_func is %NULL, the value is returned
+unmodified.
+
+</return>
+</function>
+
 <function name="g_object_force_floating">
 <description>
 This function is intended for #GObject implementations to re-enforce a
@@ -23568,6 +23756,108 @@ to match the one used with g_object_add_weak_pointer().
 <return></return>
 </function>
 
+<function name="g_object_replace_data">
+<description>
+Compares the user data for the key @key on @object with
+ oldval, and if they are the same, replaces @oldval with
+ newval 
+
+This is like a typical atomic compare-and-exchange
+operation, for user data on an object.
+
+If the previous value was replaced then ownership of the
+old value (@oldval) is passed to the caller, including
+the registred destroy notify for it (passed out in @old_destroy).
+Its up to the caller to free this as he wishes, which may
+or may not include using @old_destroy as sometimes replacement
+should not destroy the object in the normal way.
+
+Return: %TRUE if the existing value for @key was replaced
+by @newval, %FALSE otherwise.
+
+Since: 2.34
+
+</description>
+<parameters>
+<parameter name="object">
+<parameter_description> the #GObject to store user data on
+</parameter_description>
+</parameter>
+<parameter name="key">
+<parameter_description> a string, naming the user data pointer
+</parameter_description>
+</parameter>
+<parameter name="oldval">
+<parameter_description> the old value to compare against
+</parameter_description>
+</parameter>
+<parameter name="newval">
+<parameter_description> the new value
+</parameter_description>
+</parameter>
+<parameter name="destroy">
+<parameter_description> a destroy notify for the new value
+</parameter_description>
+</parameter>
+<parameter name="old_destroy">
+<parameter_description> destroy notify for the existing value
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_object_replace_qdata">
+<description>
+Compares the user data for the key @quark on @object with
+ oldval, and if they are the same, replaces @oldval with
+ newval 
+
+This is like a typical atomic compare-and-exchange
+operation, for user data on an object.
+
+If the previous value was replaced then ownership of the
+old value (@oldval) is passed to the caller, including
+the registred destroy notify for it (passed out in @old_destroy).
+Its up to the caller to free this as he wishes, which may
+or may not include using @old_destroy as sometimes replacement
+should not destroy the object in the normal way.
+
+Return: %TRUE if the existing value for @quark was replaced
+by @newval, %FALSE otherwise.
+
+Since: 2.34
+
+</description>
+<parameters>
+<parameter name="object">
+<parameter_description> the #GObject to store user data on
+</parameter_description>
+</parameter>
+<parameter name="quark">
+<parameter_description> a #GQuark, naming the user data pointer
+</parameter_description>
+</parameter>
+<parameter name="oldval">
+<parameter_description> the old value to compare against
+</parameter_description>
+</parameter>
+<parameter name="newval">
+<parameter_description> the new value
+</parameter_description>
+</parameter>
+<parameter name="destroy">
+<parameter_description> a destroy notify for the new value
+</parameter_description>
+</parameter>
+<parameter name="old_destroy">
+<parameter_description> destroy notify for the existing value
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
 <function name="g_object_run_dispose">
 <description>
 Releases all references to other objects. This can be used to break
diff --git a/glib/src/glib_functions.defs b/glib/src/glib_functions.defs
index ff5c0b0..4ff4cd5 100644
--- a/glib/src/glib_functions.defs
+++ b/glib/src/glib_functions.defs
@@ -2799,6 +2799,30 @@
   )
 )
 
+(define-function g_datalist_id_dup_data
+  (c-name "g_datalist_id_dup_data")
+  (return-type "gpointer")
+  (parameters
+    '("GData**" "data")
+    '("GQuark" "key_id")
+    '("GDuplicateFunc" "dup_func")
+    '("gpointer" "user_data")
+  )
+)
+
+(define-function g_datalist_id_replace_data
+  (c-name "g_datalist_id_replace_data")
+  (return-type "gboolean")
+  (parameters
+    '("GData**" "data")
+    '("GQuark" "key_id")
+    '("gpointer" "oldval")
+    '("gpointer" "newval")
+    '("GDestroyNotify" "destroy")
+    '("GDestroyNotify*" "old_destroy")
+  )
+)
+
 (define-function g_datalist_id_remove_no_notify
   (c-name "g_datalist_id_remove_no_notify")
   (return-type "gpointer")
diff --git a/glib/src/gobject_functions.defs b/glib/src/gobject_functions.defs
index 001c583..3589d89 100644
--- a/glib/src/gobject_functions.defs
+++ b/glib/src/gobject_functions.defs
@@ -1070,6 +1070,30 @@
   )
 )
 
+(define-method dup_qdata
+  (of-object "GObject")
+  (c-name "g_object_dup_qdata")
+  (return-type "gpointer")
+  (parameters
+    '("GQuark" "quark")
+    '("GDuplicateFunc" "dup_func")
+    '("gpointer" "user_data")
+  )
+)
+
+(define-method replace_qdata
+  (of-object "GObject")
+  (c-name "g_object_replace_qdata")
+  (return-type "gboolean")
+  (parameters
+    '("GQuark" "quark")
+    '("gpointer" "oldval")
+    '("gpointer" "newval")
+    '("GDestroyNotify" "destroy")
+    '("GDestroyNotify*" "old_destroy")
+  )
+)
+
 (define-method get_data
   (of-object "GObject")
   (c-name "g_object_get_data")
@@ -1109,6 +1133,30 @@
   )
 )
 
+(define-method dup_data
+  (of-object "GObject")
+  (c-name "g_object_dup_data")
+  (return-type "gpointer")
+  (parameters
+    '("const-gchar*" "key")
+    '("GDuplicateFunc" "dup_func")
+    '("gpointer" "user_data")
+  )
+)
+
+(define-method replace_data
+  (of-object "GObject")
+  (c-name "g_object_replace_data")
+  (return-type "gboolean")
+  (parameters
+    '("const-gchar*" "key")
+    '("gpointer" "oldval")
+    '("gpointer" "newval")
+    '("GDestroyNotify" "destroy")
+    '("GDestroyNotify*" "old_destroy")
+  )
+)
+
 (define-method watch_closure
   (of-object "GObject")
   (c-name "g_object_watch_closure")
[Date Prev][Date Next] [Thread Prev][Thread Next] [Thread Index] [Date Index] [Author Index]