From 4caba73704c3b07f66bd16bc423c4c15feaf2921 Mon Sep 17 00:00:00 2001 From: Murray Cumming Date: Tue, 3 Mar 2015 08:41:56 +0100 Subject: Regenerate *_docs.xml files. --- gio/src/gio_docs.xml | 384 ++++++++++---- glib/src/glib_docs.xml | 1375 ++++++++++++++++++++++++++++++++++++++++++++++-- 2 files changed, 1621 insertions(+), 138 deletions(-) diff --git a/gio/src/gio_docs.xml b/gio/src/gio_docs.xml index b8ea5b9e..31853ca2 100644 --- a/gio/src/gio_docs.xml +++ b/gio/src/gio_docs.xml @@ -1456,6 +1456,67 @@ Flags used when creating a #GAppInfo. + + +Signal emitted when the app info database for changes (ie: newly installed +or removed applications). + + + + + + + + + +The ::launch-failed signal is emitted when a #GAppInfo launch +fails. The startup notification id is provided, so that the launcher +can cancel the startup notification. + +Since: 2.36 + + + + + the object emitting the signal + + + + the startup notification id for the failed launch + + + + + + + + +The ::launched signal is emitted when a #GAppInfo is successfully +launched. The @platform_data is an GVariant dictionary mapping +strings to variants (ie a{sv}), which contains additional, +platform-specific data about this launch. On UNIX, at least the +"pid" and "startup-notification-id" keys will be present. + +Since: 2.36 + + + + + the object emitting the signal + + + + the #GAppInfo that was just launched + + + + additional platform-specific data for this launch + + + + + + The ::activate signal is emitted on the primary instance when an @@ -21554,6 +21615,35 @@ Since: 2.40 + + +Marks @application as busy (see g_application_mark_busy()) while +@property on @object is %TRUE. + +The binding holds a reference to @application while it is active, but +not to @object. Instead, the binding is destroyed when @object is +finalized. + +Since: 2.44 + + + + + a #GApplication + + + + a #GObject + + + + the name of a boolean property of @object + + + + + + Creates a #GFile corresponding to a filename that was given as part @@ -22057,6 +22147,25 @@ Since: 2.28 + + +Gets the application's current busy state, as set through +g_application_mark_busy() or g_application_bind_busy_property(). + +Since: 2.44 + + + + + a #GApplication + + + + %TRUE if @application is currenty marked as busy + + + + Checks if @application is registered. @@ -22427,11 +22536,7 @@ except in the case that g_application_set_inactivity_timeout() is in use. This function sets the prgname (g_set_prgname()), if not already set, -to the basename of argv[0]. Since 2.38, if %G_APPLICATION_IS_SERVICE -is specified, the prgname is set to the application ID. The main -impact of this is is that the wmclass of windows created by Gtk+ will -be set accordingly, which helps the window manager determine which -application is showing the window. +to the basename of argv[0]. Since 2.40, applications that are not explicitly flagged as services or launchers (ie: neither %G_APPLICATION_IS_SERVICE or @@ -22694,6 +22799,32 @@ Since: 2.42 + + +Destroys a binding between @property and the busy state of +@application that was previously created with +g_application_bind_busy_property(). + +Since: 2.44 + + + + + a #GApplication + + + + a #GObject + + + + the name of a boolean property of @object + + + + + + Decreases the busy count of @application. @@ -24102,7 +24233,9 @@ This function is thread-safe. In other words, you can safely call it from a thread other than the one running the operation that was passed the @cancellable. -The convention within gio is that cancelling an asynchronous +If @cancellable is %NULL, this function returns immediately for convenience. + +The convention within GIO is that cancelling an asynchronous operation causes it to complete asynchronously. That is, if you cancel the operation from the same thread in which it is running, then the operation's #GAsyncReadyCallback will not be invoked until @@ -36133,6 +36266,76 @@ Checks if the file enumerator has been closed. + + +This is a version of g_file_enumerator_next_file() that's easier to +use correctly from C programs. With g_file_enumerator_next_file(), +the gboolean return value signifies "end of iteration or error", which +requires allocation of a temporary #GError. + +In contrast, with this function, a %FALSE return from +gs_file_enumerator_iterate() *always* means +"error". End of iteration is signaled by @out_info or @out_child being %NULL. + +Another crucial difference is that the references for @out_info and +@out_child are owned by @direnum (they are cached as hidden +properties). You must not unref them in your own code. This makes +memory management significantly easier for C code in combination +with loops. + +Finally, this function optionally allows retrieving a #GFile as +well. + +You must specify at least one of @out_info or @out_child. + +The code pattern for correctly using g_file_enumerator_iterate() from C +is: + +|[ +direnum = g_file_enumerate_children (file, ...); +while (TRUE) +{ +GFileInfo *info; +if (!g_file_enumerator_iterate (direnum, &info, NULL, cancellable, error)) +goto out; +if (!info) +break; +... do stuff with "info"; do not unref it! ... +} + +out: +g_object_unref (direnum); // Note: frees the last @info +]| + + +Since: 2.44 + + + + + an open #GFileEnumerator + + + + Output location for the next #GFileInfo, or %NULL + + + + Output location for the next #GFile, or %NULL + + + + a #GCancellable + + + + a #GError + + + + + + Returns information for the next file in the enumerated object. @@ -42888,22 +43091,6 @@ ignore. - - -Checks if an input stream's read_async function uses threads. - - - - - - input stream - - - - %TRUE if @stream's read_async function uses threads. - - - Clears the pending flag on @stream. @@ -44882,6 +45069,14 @@ Since: 2.44 the new item + + pairwise comparison function for sorting + + + + user data for @compare_func + + the position at which @item was inserted @@ -48778,22 +48973,6 @@ Since: 2.28 - - -Checks if an ouput stream's write_async function uses threads. - - - - - - a #GOutputStream. - - - - %TRUE if @stream's write_async function uses threads. - - - Clears the pending flag on @stream. @@ -50499,7 +50678,8 @@ Since: 2.38 - the object that has the property to wrap + the object that has the property +to wrap @@ -53280,9 +53460,11 @@ with it. +<!-- --> + Since: 2.28 -Deprecated:2.40: Use g_settings_schema_source_list_schemas() instead +Deprecated: 2.40: Use g_settings_schema_source_list_schemas() instead @@ -53296,9 +53478,11 @@ modified or freed. +<!-- --> + Since: 2.26 -Deprecated:2.40: Use g_settings_schema_source_list_schemas() instead. +Deprecated: 2.40: Use g_settings_schema_source_list_schemas() instead. If you used g_settings_list_schemas() to check for the presence of a particular schema, use g_settings_schema_source_lookup() instead of your whole loop. @@ -53352,7 +53536,7 @@ At the most basic level, a #GSettings object is a pure composition of backend, and a #GMainContext to which signals are dispatched. This constructor therefore gives you full control over constructing -#GSettings instances. The first 4 parameters are given directly as +#GSettings instances. The first 3 parameters are given directly as @schema, @backend and @path, and the main context is taken from the thread-default (as per g_settings_new()). @@ -55393,6 +55577,29 @@ Since: 2.28 + + +Creates a new #GSimpleIOStream wrapping @input_stream and @output_stream. +See also #GIOStream. + +Since: 2.44 + + + + + a #GInputStream. + + + + a #GOutputStream. + + + + a new #GSimpleIOStream instance. + + + + Creates a new #GPermission instance that represents an action that is @@ -65391,28 +65598,59 @@ Checks if a unix mount is a system path. + + +Gets the #GUnixMountMonitor for the current thread-default main +context. + +The mount monitor can be used to monitor for changes to the list of +mounted filesystems as well as the list of mount points (ie: fstab +entries). + +You must only call g_object_unref() on the return value from under +the same main context as you called this function. + +Since: 2.44 + + + + + the #GUnixMountMonitor. + + + + -Gets a new #GUnixMountMonitor. The default rate limit for which the -monitor will report consecutive changes for the mount and mount -point entry files is the default for a #GFileMonitor. Use -g_unix_mount_monitor_set_rate_limit() to change this. +Deprecated alias for g_unix_mount_monitor_get(). +This function was never a true constructor, which is why it was +renamed. + +Deprecated:2.44:Use g_unix_mount_monitor_get() instead. - a #GUnixMountMonitor. + a #GUnixMountMonitor. + -Sets the rate limit to which the @mount_monitor will report -consecutive change events to the mount and mount point entry files. +This function does nothing. + +Before 2.44, this was a partially-effective way of controlling the +rate at which events would be reported under some uncommon +circumstances. Since @mount_monitor is a singleton, it also meant +that calling this function would have side effects for other users of +the monitor. Since: 2.18 +Deprecated:2.44:This function does nothing. Don't call it. + @@ -66924,50 +67162,6 @@ Since: 2.26 - - - - - - - the GWinHttpFile being read - - - - handle to the HTTP connection, as from WinHttpConnect() - - - - handle to the HTTP request, as from WinHttpOpenRequest - - - - #GFileInputStream for the given request - - - - - - - - - - the GWinHttpFile being read - - - - handle to the HTTP connection, as from WinHttpConnect() - - - - handle to the HTTP request, as from WinHttpOpenRequest - - - - #GFileOutputStream for the given request - - - Returns a new #GVfs handle for a WinHttp vfs. @@ -67676,10 +67870,6 @@ port_add will associate a GSource to @f->source - - - - diff --git a/glib/src/glib_docs.xml b/glib/src/glib_docs.xml index 543c9391..aebd445e 100644 --- a/glib/src/glib_docs.xml +++ b/glib/src/glib_docs.xml @@ -6382,7 +6382,7 @@ Since: 2.44 - + a supported variable type @@ -6390,6 +6390,44 @@ Since: 2.44 + + +Macro to add an attribute to pointer variable to ensure automatic +cleanup using g_free(). + +This macro differs from g_autoptr() in that it is an attribute supplied +before the type name, rather than wrapping the type definition. Instead +of using a type-specific lookup, this macro always calls g_free() directly. + +This means it's useful for any type that is returned from +g_malloc(). + +Otherwise, this macro has similar constraints as g_autoptr() - only +supported on GCC and clang, the variable must be initialized, etc. + +|[ +gboolean +operate_on_malloc_buf (void) +{ +g_autofree guint8* membuf = NULL; + +membuf = g_malloc (8192); + +/ * Some computation on membuf * / + +/ * membuf will be automatically freed here * / +return TRUE; +} +]| + +Since: 2.44 + + + + + + + Helper to declare a pointer variable with automatic cleanup. @@ -6402,7 +6440,7 @@ defined on other compilers and should not be used in programs that are intended to be portable to those compilers. This is meant to be used to declare pointers to types with cleanup -functions. The type of the variable is a pointer to @typename. You +functions. The type of the variable is a pointer to @TypeName. You must not add your own '*'. This macro can be used to avoid having to do explicit cleanups of @@ -6447,7 +6485,7 @@ Since: 2.44 - + a supported variable type @@ -9252,6 +9290,91 @@ data structures to @func; use g_cache_key_foreach() instead + + +A #GClosureMarshal function for use with signals with handlers that +take two boxed pointers as arguments and return a boolean. If you +have such a signal, you will probably also need to use an +accumulator, such as g_signal_accumulator_true_handled(). + + + + + A #GClosure. + + + + A #GValue to store the return value. May be %NULL +if the callback of closure doesn't return a value. + + + + The length of the @param_values array. + + + + An array of #GValues holding the arguments +on which to invoke the callback of closure. + + + + The invocation hint given as the last argument to +g_closure_invoke(). + + + + Additional data specified when registering the +marshaller, see g_closure_set_marshal() and +g_closure_set_meta_marshal() + + + + + + + + +The #GVaClosureMarshal equivalent to g_cclosure_marshal_BOOLEAN__BOXED_BOXED(). + + + + + the #GClosure to which the marshaller belongs + + + + a #GValue to store the return +value. May be %NULL if the callback of @closure doesn't return a +value. + + + + the instance on which the closure is invoked. + + + + va_list of arguments to be passed to the closure. + + + + additional data specified when +registering the marshaller, see g_closure_set_marshal() and +g_closure_set_meta_marshal() + + + + the length of the @param_types array + + + + the #GType of each argument from +@args. + + + + + + A marshaller for a #GCClosure with a callback of type @@ -9289,6 +9412,49 @@ to g_closure_invoke() + + +The #GVaClosureMarshal equivalent to g_cclosure_marshal_BOOLEAN__FLAGS(). + + + + + the #GClosure to which the marshaller belongs + + + + a #GValue to store the return +value. May be %NULL if the callback of @closure doesn't return a +value. + + + + the instance on which the closure is invoked. + + + + va_list of arguments to be passed to the closure. + + + + additional data specified when +registering the marshaller, see g_closure_set_marshal() and +g_closure_set_meta_marshal() + + + + the length of the @param_types array + + + + the #GType of each argument from +@args. + + + + + + A marshaller for a #GCClosure with a callback of type @@ -9327,6 +9493,45 @@ to g_closure_invoke() + + +An old alias for g_cclosure_marshal_BOOLEAN__BOXED_BOXED(). + + + + + A #GClosure. + + + + A #GValue to store the return value. May be %NULL +if the callback of closure doesn't return a value. + + + + The length of the @param_values array. + + + + An array of #GValues holding the arguments +on which to invoke the callback of closure. + + + + The invocation hint given as the last argument to +g_closure_invoke(). + + + + Additional data specified when registering the +marshaller, see g_closure_set_marshal() and +g_closure_set_meta_marshal() + + + + + + Another name for g_cclosure_marshal_BOOLEAN__FLAGS(). @@ -9373,6 +9578,49 @@ to g_closure_invoke() + + +The #GVaClosureMarshal equivalent to g_cclosure_marshal_STRING__OBJECT_POINTER(). + + + + + the #GClosure to which the marshaller belongs + + + + a #GValue to store the return +value. May be %NULL if the callback of @closure doesn't return a +value. + + + + the instance on which the closure is invoked. + + + + va_list of arguments to be passed to the closure. + + + + additional data specified when +registering the marshaller, see g_closure_set_marshal() and +g_closure_set_meta_marshal() + + + + the length of the @param_types array + + + + the #GType of each argument from +@args. + + + + + + A marshaller for a #GCClosure with a callback of type @@ -9409,6 +9657,49 @@ to g_closure_invoke() + + +The #GVaClosureMarshal equivalent to g_cclosure_marshal_VOID__BOOLEAN(). + + + + + the #GClosure to which the marshaller belongs + + + + a #GValue to store the return +value. May be %NULL if the callback of @closure doesn't return a +value. + + + + the instance on which the closure is invoked. + + + + va_list of arguments to be passed to the closure. + + + + additional data specified when +registering the marshaller, see g_closure_set_marshal() and +g_closure_set_meta_marshal() + + + + the length of the @param_types array + + + + the #GType of each argument from +@args. + + + + + + A marshaller for a #GCClosure with a callback of type @@ -9445,6 +9736,49 @@ to g_closure_invoke() + + +The #GVaClosureMarshal equivalent to g_cclosure_marshal_VOID__BOXED(). + + + + + the #GClosure to which the marshaller belongs + + + + a #GValue to store the return +value. May be %NULL if the callback of @closure doesn't return a +value. + + + + the instance on which the closure is invoked. + + + + va_list of arguments to be passed to the closure. + + + + additional data specified when +registering the marshaller, see g_closure_set_marshal() and +g_closure_set_meta_marshal() + + + + the length of the @param_types array + + + + the #GType of each argument from +@args. + + + + + + A marshaller for a #GCClosure with a callback of type @@ -9481,6 +9815,49 @@ to g_closure_invoke() + + +The #GVaClosureMarshal equivalent to g_cclosure_marshal_VOID__CHAR(). + + + + + the #GClosure to which the marshaller belongs + + + + a #GValue to store the return +value. May be %NULL if the callback of @closure doesn't return a +value. + + + + the instance on which the closure is invoked. + + + + va_list of arguments to be passed to the closure. + + + + additional data specified when +registering the marshaller, see g_closure_set_marshal() and +g_closure_set_meta_marshal() + + + + the length of the @param_types array + + + + the #GType of each argument from +@args. + + + + + + A marshaller for a #GCClosure with a callback of type @@ -9517,6 +9894,49 @@ to g_closure_invoke() + + +The #GVaClosureMarshal equivalent to g_cclosure_marshal_VOID__DOUBLE(). + + + + + the #GClosure to which the marshaller belongs + + + + a #GValue to store the return +value. May be %NULL if the callback of @closure doesn't return a +value. + + + + the instance on which the closure is invoked. + + + + va_list of arguments to be passed to the closure. + + + + additional data specified when +registering the marshaller, see g_closure_set_marshal() and +g_closure_set_meta_marshal() + + + + the length of the @param_types array + + + + the #GType of each argument from +@args. + + + + + + A marshaller for a #GCClosure with a callback of type @@ -9553,6 +9973,49 @@ to g_closure_invoke() + + +The #GVaClosureMarshal equivalent to g_cclosure_marshal_VOID__ENUM(). + + + + + the #GClosure to which the marshaller belongs + + + + a #GValue to store the return +value. May be %NULL if the callback of @closure doesn't return a +value. + + + + the instance on which the closure is invoked. + + + + va_list of arguments to be passed to the closure. + + + + additional data specified when +registering the marshaller, see g_closure_set_marshal() and +g_closure_set_meta_marshal() + + + + the length of the @param_types array + + + + the #GType of each argument from +@args. + + + + + + A marshaller for a #GCClosure with a callback of type @@ -9589,6 +10052,49 @@ to g_closure_invoke() + + +The #GVaClosureMarshal equivalent to g_cclosure_marshal_VOID__FLAGS(). + + + + + the #GClosure to which the marshaller belongs + + + + a #GValue to store the return +value. May be %NULL if the callback of @closure doesn't return a +value. + + + + the instance on which the closure is invoked. + + + + va_list of arguments to be passed to the closure. + + + + additional data specified when +registering the marshaller, see g_closure_set_marshal() and +g_closure_set_meta_marshal() + + + + the length of the @param_types array + + + + the #GType of each argument from +@args. + + + + + + A marshaller for a #GCClosure with a callback of type @@ -9625,6 +10131,49 @@ to g_closure_invoke() + + +The #GVaClosureMarshal equivalent to g_cclosure_marshal_VOID__FLOAT(). + + + + + the #GClosure to which the marshaller belongs + + + + a #GValue to store the return +value. May be %NULL if the callback of @closure doesn't return a +value. + + + + the instance on which the closure is invoked. + + + + va_list of arguments to be passed to the closure. + + + + additional data specified when +registering the marshaller, see g_closure_set_marshal() and +g_closure_set_meta_marshal() + + + + the length of the @param_types array + + + + the #GType of each argument from +@args. + + + + + + A marshaller for a #GCClosure with a callback of type @@ -9661,6 +10210,49 @@ to g_closure_invoke() + + +The #GVaClosureMarshal equivalent to g_cclosure_marshal_VOID__INT(). + + + + + the #GClosure to which the marshaller belongs + + + + a #GValue to store the return +value. May be %NULL if the callback of @closure doesn't return a +value. + + + + the instance on which the closure is invoked. + + + + va_list of arguments to be passed to the closure. + + + + additional data specified when +registering the marshaller, see g_closure_set_marshal() and +g_closure_set_meta_marshal() + + + + the length of the @param_types array + + + + the #GType of each argument from +@args. + + + + + + A marshaller for a #GCClosure with a callback of type @@ -9697,6 +10289,49 @@ to g_closure_invoke() + + +The #GVaClosureMarshal equivalent to g_cclosure_marshal_VOID__LONG(). + + + + + the #GClosure to which the marshaller belongs + + + + a #GValue to store the return +value. May be %NULL if the callback of @closure doesn't return a +value. + + + + the instance on which the closure is invoked. + + + + va_list of arguments to be passed to the closure. + + + + additional data specified when +registering the marshaller, see g_closure_set_marshal() and +g_closure_set_meta_marshal() + + + + the length of the @param_types array + + + + the #GType of each argument from +@args. + + + + + + A marshaller for a #GCClosure with a callback of type @@ -9733,6 +10368,49 @@ to g_closure_invoke() + + +The #GVaClosureMarshal equivalent to g_cclosure_marshal_VOID__OBJECT(). + + + + + the #GClosure to which the marshaller belongs + + + + a #GValue to store the return +value. May be %NULL if the callback of @closure doesn't return a +value. + + + + the instance on which the closure is invoked. + + + + va_list of arguments to be passed to the closure. + + + + additional data specified when +registering the marshaller, see g_closure_set_marshal() and +g_closure_set_meta_marshal() + + + + the length of the @param_types array + + + + the #GType of each argument from +@args. + + + + + + A marshaller for a #GCClosure with a callback of type @@ -9769,6 +10447,49 @@ to g_closure_invoke() + + +The #GVaClosureMarshal equivalent to g_cclosure_marshal_VOID__PARAM(). + + + + + the #GClosure to which the marshaller belongs + + + + a #GValue to store the return +value. May be %NULL if the callback of @closure doesn't return a +value. + + + + the instance on which the closure is invoked. + + + + va_list of arguments to be passed to the closure. + + + + additional data specified when +registering the marshaller, see g_closure_set_marshal() and +g_closure_set_meta_marshal() + + + + the length of the @param_types array + + + + the #GType of each argument from +@args. + + + + + + A marshaller for a #GCClosure with a callback of type @@ -9805,6 +10526,49 @@ to g_closure_invoke() + + +The #GVaClosureMarshal equivalent to g_cclosure_marshal_VOID__POINTER(). + + + + + the #GClosure to which the marshaller belongs + + + + a #GValue to store the return +value. May be %NULL if the callback of @closure doesn't return a +value. + + + + the instance on which the closure is invoked. + + + + va_list of arguments to be passed to the closure. + + + + additional data specified when +registering the marshaller, see g_closure_set_marshal() and +g_closure_set_meta_marshal() + + + + the length of the @param_types array + + + + the #GType of each argument from +@args. + + + + + + A marshaller for a #GCClosure with a callback of type @@ -9841,6 +10605,49 @@ to g_closure_invoke() + + +The #GVaClosureMarshal equivalent to g_cclosure_marshal_VOID__STRING(). + + + + + the #GClosure to which the marshaller belongs + + + + a #GValue to store the return +value. May be %NULL if the callback of @closure doesn't return a +value. + + + + the instance on which the closure is invoked. + + + + va_list of arguments to be passed to the closure. + + + + additional data specified when +registering the marshaller, see g_closure_set_marshal() and +g_closure_set_meta_marshal() + + + + the length of the @param_types array + + + + the #GType of each argument from +@args. + + + + + + A marshaller for a #GCClosure with a callback of type @@ -9877,6 +10684,49 @@ to g_closure_invoke() + + +The #GVaClosureMarshal equivalent to g_cclosure_marshal_VOID__UCHAR(). + + + + + the #GClosure to which the marshaller belongs + + + + a #GValue to store the return +value. May be %NULL if the callback of @closure doesn't return a +value. + + + + the instance on which the closure is invoked. + + + + va_list of arguments to be passed to the closure. + + + + additional data specified when +registering the marshaller, see g_closure_set_marshal() and +g_closure_set_meta_marshal() + + + + the length of the @param_types array + + + + the #GType of each argument from +@args. + + + + + + A marshaller for a #GCClosure with a callback of type @@ -9949,6 +10799,92 @@ to g_closure_invoke() + + +The #GVaClosureMarshal equivalent to g_cclosure_marshal_VOID__UINT_POINTER(). + + + + + the #GClosure to which the marshaller belongs + + + + a #GValue to store the return +value. May be %NULL if the callback of @closure doesn't return a +value. + + + + the instance on which the closure is invoked. + + + + va_list of arguments to be passed to the closure. + + + + additional data specified when +registering the marshaller, see g_closure_set_marshal() and +g_closure_set_meta_marshal() + + + + the length of the @param_types array + + + + the #GType of each argument from +@args. + + + + + + + + +The #GVaClosureMarshal equivalent to g_cclosure_marshal_VOID__UINT(). + + + + + the #GClosure to which the marshaller belongs + + + + a #GValue to store the return +value. May be %NULL if the callback of @closure doesn't return a +value. + + + + the instance on which the closure is invoked. + + + + va_list of arguments to be passed to the closure. + + + + additional data specified when +registering the marshaller, see g_closure_set_marshal() and +g_closure_set_meta_marshal() + + + + the length of the @param_types array + + + + the #GType of each argument from +@args. + + + + + + A marshaller for a #GCClosure with a callback of type @@ -9985,6 +10921,49 @@ to g_closure_invoke() + + +The #GVaClosureMarshal equivalent to g_cclosure_marshal_VOID__ULONG(). + + + + + the #GClosure to which the marshaller belongs + + + + a #GValue to store the return +value. May be %NULL if the callback of @closure doesn't return a +value. + + + + the instance on which the closure is invoked. + + + + va_list of arguments to be passed to the closure. + + + + additional data specified when +registering the marshaller, see g_closure_set_marshal() and +g_closure_set_meta_marshal() + + + + the length of the @param_types array + + + + the #GType of each argument from +@args. + + + + + + A marshaller for a #GCClosure with a callback of type @@ -10023,6 +11002,49 @@ to g_closure_invoke() + + +The #GVaClosureMarshal equivalent to g_cclosure_marshal_VOID__VARIANT(). + + + + + the #GClosure to which the marshaller belongs + + + + a #GValue to store the return +value. May be %NULL if the callback of @closure doesn't return a +value. + + + + the instance on which the closure is invoked. + + + + va_list of arguments to be passed to the closure. + + + + additional data specified when +registering the marshaller, see g_closure_set_marshal() and +g_closure_set_meta_marshal() + + + + the length of the @param_types array + + + + the #GType of each argument from +@args. + + + + + + A marshaller for a #GCClosure with a callback of type @@ -10059,6 +11081,49 @@ to g_closure_invoke() + + +The #GVaClosureMarshal equivalent to g_cclosure_marshal_VOID__VOID(). + + + + + the #GClosure to which the marshaller belongs + + + + a #GValue to store the return +value. May be %NULL if the callback of @closure doesn't return a +value. + + + + the instance on which the closure is invoked. + + + + va_list of arguments to be passed to the closure. + + + + additional data specified when +registering the marshaller, see g_closure_set_marshal() and +g_closure_set_meta_marshal() + + + + the length of the @param_types array + + + + the #GType of each argument from +@args. + + + + + + A generic marshaller function implemented via @@ -10104,6 +11169,52 @@ g_closure_set_meta_marshal() + + +A generic #GVaClosureMarshal function implemented via +[libffi](http://sourceware.org/libffi/). + +Since: 2.30 + + + + + the #GClosure to which the marshaller belongs + + + + a #GValue to store the return +value. May be %NULL if the callback of @closure doesn't return a +value. + + + + the instance on which the closure is invoked. + + + + va_list of arguments to be passed to the closure. + + + + additional data specified when +registering the marshaller, see g_closure_set_marshal() and +g_closure_set_meta_marshal() + + + + the length of the @param_types array + + + + the #GType of each argument from +@args_list. + + + + + + Creates a new closure which invokes @callback_func with @user_data as @@ -16673,7 +17784,8 @@ freed. - return location for character set name + return location for character set +name, or %NULL. @@ -22373,7 +23485,8 @@ Gets the number of elements in a #GList. This function iterates over the whole list to count its elements. Use a #GQueue instead of a GList if you regularly need the number -of items. +of items. To check whether the list is non-empty, it is faster to check +@list against %NULL. @@ -26079,6 +27192,70 @@ already been locked by the same thread results in undefined behaviour + + +Unlock @locker's mutex. See g_mutex_locker_new() for details. + +Since: 2.44 + + + + + a GMutexLocker + + + + + + + + +Lock @mutex and return a new #GMutexLocker. Unlock with +g_mutex_locker_free(). Using g_mutex_unlock() on @mutex +while a #GMutexLocker exists can lead to undefined behaviour. + +This is intended to be used with g_autoptr(). Note that g_autoptr() +is only available when using GCC or clang, so the following example +will only work with those compilers: +|[ +typedef struct +{ +... +GMutex mutex; +... +} MyObject; + +static void +my_object_do_stuff (MyObject *self) +{ +g_autoptr(GMutexLocker) locker = g_mutex_locker_new (&self->mutex); + +// Code with mutex locked here + +if (cond) +// No need to unlock +return; + +// Optionally early unlock +g_clear_pointer (&locker, g_mutex_locker_free); + +// Code with mutex unlocked here +} +]| + +Since: 2.44 + + + + + a mutex to lock + + + + a #GMutexLocker + + + Allocates and initializes a new #GMutex. @@ -28918,10 +30095,8 @@ from open(). Adds a #GOptionGroup to the @context, so that parsing with @context -will recognize the options in the group. Note that the group will -be freed together with the context when g_option_context_free() is -called, so you must not free the group yourself after adding it -to a context. +will recognize the options in the group. Note that this will take +ownership of the @group and thus the @group should not be freed. Since: 2.6 @@ -29087,9 +30262,9 @@ Since: 2.6 - the main group of @context, or %NULL if @context doesn't -have a main group. Note that group belongs to @context and should -not be modified or freed. + the main group of @context, or %NULL if +@context doesn't have a main group. Note that group belongs to +@context and should not be modified or freed. @@ -29518,6 +30693,8 @@ which have been added to a #GOptionContext. Since: 2.6 +Deprecated: 2.44: Use g_option_group_unref() instead. + @@ -29564,7 +30741,25 @@ the error hook and to callbacks of %G_OPTION_ARG_CALLBACK options, or %NULL a newly created option group. It should be added -to a #GOptionContext or freed with g_option_group_free(). +to a #GOptionContext or freed with g_option_group_unref(). + + + + + + +Increments the reference count of @group by one. + +Since: 2.44 + + + + + a #GOptionGroup + + + + a #GoptionGroup @@ -29677,24 +30872,22 @@ Since: 2.6 - + -Gets the default value of @param as a pointer to a #GValue. +Decrements the reference count of @group by one. +If the reference count drops to 0, the @group will be freed. +and all memory allocated by the @group is released. -The #GValue will remain value for the life of @param. - -Since: 2.38 +Since: 2.44 - - a #GParamSpec + + a #GOptionGroup - a pointer to a #GValue which must not be modified - - + @@ -29986,6 +31179,26 @@ Get the short description of a #GParamSpec. + + +Gets the default value of @param as a pointer to a #GValue. + +The #GValue will remain value for the life of @param. + +Since: 2.38 + + + + + a #GParamSpec + + + + a pointer to a #GValue which must not be modified + + + + Get the name of a #GParamSpec. @@ -38719,6 +39932,33 @@ g_signal_add_emission_hook() + + +Change the #GSignalCVaMarshaller used for a given signal. This is a +specialised form of the marshaller that can often be used for the +common case of a single connected signal handler and avoids the +overhead of #GValue. Its use is optional. + +Since: 2.32 + + + + + the signal id + + + + the instance type on which to set the marshaller. + + + + the marshaller to set. + + + + + + Stops a signal's current emission. @@ -39523,7 +40763,8 @@ or %NULL if the #GSList has no elements Gets the number of elements in a #GSList. This function iterates over the whole list to -count its elements. +count its elements. To check whether the list is non-empty, it is faster to +check @list against %NULL. @@ -41874,6 +43115,69 @@ Deprectated: 2.32: Use g_rw_lock_writer_unlock() instead + + +Sets @pp to %NULL, returning the value that was there before. + +Conceptually, this transfers the ownership of the pointer from the +referenced variable to the "caller" of the macro (ie: "steals" the +reference). + +The return value will be properly typed, according to the type of +@pp. + +This can be very useful when combined with g_autoptr() to prevent the +return value of a function from being automatically freed. Consider +the following example (which only works on GCC and clang): + +|[ +GObject * +create_object (void) +{ +g_autoptr(GObject) obj = g_object_new (G_TYPE_OBJECT, NULL); + +if (early_error_case) +return NULL; + +return g_steal_pointer (&obj); +} +]| + +It can also be used in similar ways for 'out' parameters and is +particularly useful for dealing with optional out parameters: + +|[ +gboolean +get_object (GObject **obj_out) +{ +g_autoptr(GObject) obj = g_object_new (G_TYPE_OBJECT, NULL); + +if (early_error_case) +return FALSE; + +if (obj_out) +*obj_out = g_steal_pointer (&obj); + +return TRUE; +} +]| + +In the above example, the object will be automatically freed in the +early error case and also in the case that %NULL was given for +@obj_out. + +Since: 2.44 + + + + + a pointer to a pointer + + + + + + Copies a nul-terminated string into the dest buffer, include the @@ -44169,15 +45473,15 @@ Since: 2.16 - /-separated test case path name for the test. + /-separated test case path name for the test. - Test data argument for the test function. + Test data argument for the test function. - The test function to invoke for this test. + The test function to invoke for this test. @@ -44229,7 +45533,7 @@ Since: 2.16 - /-separated test case path name for the test. + /-separated test case path name for the test. @@ -44382,11 +45686,11 @@ Since: 2.16 - the function to set up the fixture data + the function to set up the fixture data - the actual test function + the actual test function @@ -54544,17 +55848,6 @@ the fixed array - - -Since: 2.24 -Deprecated: 2.26 - - - - - - - Returns the 32-bit signed integer value of @value. -- cgit v1.2.1