--- TelepathyGLib-0.12.gir.orig 2012-09-05 11:07:54.101730153 +0100 +++ TelepathyGLib-0.12.gir 2012-09-05 11:19:58.072191201 +0100 @@ -29802,6 +29802,80 @@ c:type="TP_UNKNOWN_HANDLE_TYPE"> + + A simple wrapper for a weak reference to a #GObject, suitable for use in +asynchronous calls which should only affect the object if it hasn't already +been freed. + +As well as wrapping a weak reference to an object, this structure can +contain an extra pointer to arbitrary data. This is useful for asynchronous +calls which act on an object and some second piece of data, which are quite +common in practice. + +If more than one piece of auxiliary data is required, the @user_data +argument to the constructor can be a struct or a #GValueArray. + + Free a weak reference wrapper. This drops the weak reference to the +object (if it still exists), and frees the user data with the user-supplied +destructor function if one was provided. + + + + + + If the weakly referenced object still exists, return a new reference to +it. Otherwise, return %NULL. + + a new reference, or %NULL + + + + + Return the additional data that was passed to tp_weak_ref_new(). + +%NULL + + the additional data supplied in tp_weak_ref_new(), which may be + + + + + Return a new weak reference wrapper for @object. + + +Free-function: tp_weak_ref_destroy() + + a new weak-reference wrapper + + + + + an object to which to take a weak reference + + + + optional additional data to store alongside the weak ref + + + + destructor for @user_data, called when the weak ref is freed + + + + + @@ -31846,6 +31920,37 @@ + + Escape an arbitrary string so it follows the rules for a C identifier, +and hence an object path component, interface element component, +bus name component or member name in D-Bus. + +Unlike g_strcanon this is a reversible encoding, so it preserves +distinctness. + +The escaping consists of replacing all non-alphanumerics, and the first +character if it's a digit, with an underscore and two lower-case hex +digits: + +"0123abc_xyz\x01\xff" -> _30123abc_5fxyz_01_ff + +i.e. similar to URI encoding, but with _ taking the role of %, and a +smaller allowed set. As a special case, "" is escaped to "_" (just for +completeness, really). + +the caller with #g_free + + the escaped string, which must be freed by + + + + + The string to be escaped + + + + + + Add each item in @source to @target, replacing any existing item with the +same key. @key_dup and @value_dup are used to duplicate the items; in +principle they could also be used to convert between types. + + + + + + The hash table to be updated + + + + + + + The hash table to update it with (read-only) + + + + + + + function to duplicate a key from @source so it can be be stored in @target. If NULL, the key is not copied, but is used as-is + + + + function to duplicate a value from @source so it can be stored in @target. If NULL, the value is not copied, but is used as-is + + + + + + Returns the value associated with @key under @group_name as a signed +64-bit integer. This is similar to g_key_file_get_integer() but can return +64-bit results without truncation. + +0 if the key was not found or could not be parsed. + + the value associated with the key as a signed 64-bit integer, or + + + + + a non-%NULL #GKeyFile + + + + a non-%NULL group name + + + + a non-%NULL key + + + + + + Returns the value associated with @key under @group_name as an unsigned +64-bit integer. This is similar to g_key_file_get_integer() but can return +large positive results without truncation. + +or 0 if the key was not found or could not be parsed. + + the value associated with the key as an unsigned 64-bit integer, + + + + + a non-%NULL #GKeyFile + + + + a non-%NULL group name + + + + a non-%NULL key + + + + + + <!--no further documentation needed--> + + %TRUE if @needle is one of the elements of @haystack + + + + + The pointer array to be searched + + + + + + The pointer to look for + + + + + + Appends all elements of @source to @target. Note that this only copies the +pointers from @source; any duplication or reference-incrementing must be +performed by the caller. + +After this function has been called, it is safe to call +g_ptr_array_free() on @source and also free the actual pointer array, +as long as doing so does not free the data pointed to by the new +items in @target. + + + + + + a #GPtrArray to copy items to + + + + + + a #GPtrArray to copy items from + + + + + + + + Connects a #GCallback function to a signal for a particular object, as if +with g_signal_connect(). Additionally, arranges for the signal handler to be +disconnected if @gobject is destroyed. + +This is similar to g_signal_connect_data(), but uses a closure which +ensures that the @gobject stays alive during the call to @c_handler +by temporarily adding a reference count to @gobject. + +This is similar to g_signal_connect_object(), but doesn't have the +documented bug that everyone is too scared to fix. Also, it does not allow +you to pass in NULL as @gobject + +This is intended to be a convenient way for objects to use themselves as +user_data for callbacks without having to explicitly disconnect all the +handlers in their finalizers. + +Changed in 0.10.4 and 0.11.3: %G_CONNECT_AFTER is now respected. + + the handler id + + + + + the instance to connect to. + + + + a string of the form "signal-name::detail". + + + + the #GCallback to connect. + + + + the object to pass as data to @c_handler. + + + + a combination of #GConnectFlags. Only %G_CONNECT_AFTER and %G_CONNECT_SWAPPED are supported by this function. + + + + + + <!-- 'Returns' says it all --> + +tp_g_value_slice_free() or g_slice_free(). + + a newly allocated copy of @value, to be freed with + + + + + A GValue + + + + + + Unset and free a slice-allocated GValue. + +<literal>(GDestroyNotify) tp_g_value_slice_free</literal> can be used +as a destructor for values in a #GHashTable, for example. + + + + + + A GValue which was allocated with the g_slice API + + + + Returns a connection to the D-Bus daemon on which this process was activated if it was launched by D-Bus service activation, or the session @@ -34022,6 +34354,81 @@ + + If the type of @klass, or any of its ancestor types, has had an offset +attached using qdata with the given @quark, return that offset; if not, +return 0. + +In older telepathy-glib versions, calling this function on an instance that +did not have the mixin was considered to be a programming error. Since +version 0.13.9, 0 is returned, without error. + +This is used to implement the telepathy-glib mixin classes. + + the offset of the mixin class + + + + + A pointer to a GObjectClass-derived class structure + + + + A quark that was used to store the offset with g_type_set_qdata() + + + + + + If the type of @instance, or any of its ancestor types, has had an offset +attached using qdata with the given @quark, return that offset. If not, +return 0. + +In older telepathy-glib versions, calling this function on an instance that +did not have the mixin was considered to be a programming error. Since +version 0.13.9, 0 is returned, without error. + +This is used to implement the telepathy-glib mixin classes. + + the offset of the mixin + + + + + A pointer to a GObject-derived instance structure + + + + A quark that was used to store the offset with g_type_set_qdata() + + + + + + Extend a pointer by an offset, provided the offset is not 0. +This is used to cast from an object instance to one of the telepathy-glib +mixin classes. + + a pointer @offset bytes beyond @instance + + + + + A pointer to a structure + + + + The offset of a structure member in bytes, which must not be 0 + + + + + + Create a new #GSimpleAsyncResult with no operation result, and call +g_simple_async_result_complete_in_idle() on it. + +This is like a successful version of g_simple_async_report_error_in_idle(), +suitable for asynchronous functions that (conceptually) either succeed and +return nothing, or raise an error, such as tp_proxy_prepare_async(). + +The corresponding finish function should not call a function that attempts +to get a result, such as g_simple_async_result_get_op_res_gpointer(). + + + + + + the source object + + + + the callback + + + + user data for @callback + + + + the source tag for the #GSimpleAsyncResult + + + + + + Return %TRUE if the given strings are different. Unlike #strcmp this +function will handle null pointers, treating them as distinct from any +string. + +neither is %NULL and both have the same contents; %TRUE otherwise + + %FALSE if @left and @right are both %NULL, or if + + + + + The first string to compare (may be NULL) + + + + The second string to compare (may be NULL) + + + + + + <!-- --> + + TRUE if @str is an element of @strv, according to strcmp(). + + + + + a NULL-terminated array of strings, or %NULL (which is treated as an empty strv) + + + + a non-NULL string + + + + + + Convert an X11 timestamp into a user action time as used in Telepathy. + +This also works for the timestamps used by GDK 2, GDK 3 and Clutter 1.0; +it may or may not work with other toolkits or versions. + +%TP_USER_ACTION_TIME_CURRENT_TIME + + a nonzero Telepathy user action time, or + + + + + an X11 timestamp, or 0 to indicate the current time + + + + + + Interpret a Telepathy user action time to decide whether a Handler should +attempt to gain focus. If %TRUE is returned, it would be appropriate to +call gtk_window_present_with_time() using @x11_time as input, for instance. + +@x11_time is used to return a timestamp in the right format for X11, +GDK 2, GDK 3 and Clutter 1.0; it may or may not work with other +toolkits or versions. + + %TRUE if it would be appropriate to present a window + + + + + the Telepathy user action time + + + + a pointer to guint32 used to return an X11 timestamp, or 0 to indicate the current time; if %FALSE is returned, the value placed here is not meaningful + + + + + + Validate that the provided string is valid UTF8. If not, +replace all invalid bytes with unicode replacement +character (U+FFFD). + +This method is a verbatim copy of glib's internal +_g_utf8_make_valid<!-- -->() function, and will be deprecated as +soon as the glib one becomes public. + + a new valid UTF8 string + + + + + string to coerce into UTF8 + + + + + + Creates a new #GValueArray for use with structs, containing the values +passed in as parameters. The values are copied or reffed as appropriate for +their type. + +<example> +<title> using tp_value_array_build</title> +<programlisting> +GValueArray *array = tp_value_array_build (2, +G_TYPE_STRING, host, +G_TYPE_UINT, port, +G_TYPE_INVALID); +</programlisting> +</example> + + a newly created #GValueArray, free with g_value_array_free. + + + + + The number of elements that should be in the array + + + + The type of the first argument. + + + + + + + + + + Unpacks a #GValueArray into separate variables. + +The contents of the values aren't copied into the variables, and so become +invalid when @array is freed. + +<example> +<title>using tp_value_array_unpack</title> +<programlisting> +const gchar *host; +guint port; + +tp_value_array_unpack (array, 2, +&host, +&port); +</programlisting> +</example> + + + + + + the array to unpack + + + + The number of elements that should be in the array + + + + + + + + + + Return a new weak reference wrapper for @object. + + +Free-function: tp_weak_ref_destroy() + + a new weak-reference wrapper + + + + + an object to which to take a weak reference + + + + optional additional data to store alongside the weak ref + + + + destructor for @user_data, called when the weak ref is freed + + + +