diff --git a/rust-bindings/rust/gir-files/GLib-2.0.gir b/rust-bindings/rust/gir-files/GLib-2.0.gir index 6f8527d9..0a894f03 100644 --- a/rust-bindings/rust/gir-files/GLib-2.0.gir +++ b/rust-bindings/rust/gir-files/GLib-2.0.gir @@ -9,24 +9,20 @@ and/or use gtk-doc annotations. --> Integer representing a day of the month; between 1 and 31. #G_DATE_BAD_DAY represents an invalid day of the month. - Integer representing a year; #G_DATE_BAD_YEAR is the invalid value. The year must be 1 or higher; negative (BC) years are not allowed. The year is represented with four digits. - Opaque type. See g_main_context_pusher_new() for details. - Opaque type. See g_mutex_locker_new() for details. - @@ -37,28 +33,23 @@ while Windows uses process handles (which are pointers). GPid is used in GLib only for descendant processes spawned with the g_spawn functions. - A GQuark is a non-zero integer which uniquely identifies a particular string. A GQuark value of zero is associated to %NULL. - Opaque type. See g_rw_lock_reader_locker_new() for details. - Opaque type. See g_rw_lock_writer_locker_new() for details. - Opaque type. See g_rec_mutex_locker_new() for details. - @@ -69,13 +60,11 @@ called on `char*` arrays not allocated using g_ref_string_new(). If using #GRefString with autocleanups, g_autoptr() must be used rather than g_autofree(), so that the reference counting metadata is also freed. - A typedef alias for gchar**. This is mostly useful when used together with g_auto(). - @@ -99,16 +88,13 @@ gtime = (GTime)ttime; ]| This is not [Y2038-safe](https://en.wikipedia.org/wiki/Year_2038_problem). Use #GDateTime or #time_t instead. - A value representing an interval of time, in microseconds. - - @@ -121,7 +107,6 @@ Note this is not necessarily the same as the value returned by GCC’s `__alignof__` operator, which returns the preferred alignment for a type. The preferred alignment may be a stricter alignment than the minimal alignment. - a type-name @@ -129,7 +114,6 @@ alignment. - @@ -141,7 +125,6 @@ For example, - `G_APPROX_VALUE (3.14, 3.15, 0.001)` evaluates to false - `G_APPROX_VALUE (n, 0.f, FLT_EPSILON)` evaluates to true if `n` is within the single precision floating point epsilon from zero - a numeric value @@ -165,11 +148,9 @@ The typical usage would be something like: fprintf (out, "value=%s\n", g_ascii_dtostr (buf, sizeof (buf), value)); ]| - - @@ -177,7 +158,6 @@ The typical usage would be something like: Contains the public fields of a GArray. - a pointer to the element data. The data may be moved as elements are added to the #GArray. @@ -190,7 +170,6 @@ The typical usage would be something like: Adds @len elements onto the end of the array. - the #GArray @@ -241,7 +220,6 @@ guint matched_index; gboolean result = g_array_binary_search (garray, &i, cmpint, &matched_index); ... ]| - %TRUE if @target is one of the elements of @array, %FALSE otherwise. @@ -271,7 +249,6 @@ gboolean result = g_array_binary_search (garray, &i, cmpint, &matched_in Create a shallow copy of a #GArray. If the array elements consist of pointers to data, the pointers are copied but the actual data is not. - A copy of @array. @@ -302,7 +279,6 @@ function has been set for @array. This function is not thread-safe. If using a #GArray from multiple threads, use only the atomic g_array_ref() and g_array_unref() functions. - the element data if @free_segment is %FALSE, otherwise %NULL. The element data should be freed using g_free(). @@ -323,7 +299,6 @@ functions. Gets the size of the elements in @array. - Size of each element, in bytes @@ -351,7 +326,6 @@ upwards. @data may be %NULL if (and only if) @len is zero. If @len is zero, this function is a no-op. - the #GArray @@ -381,7 +355,6 @@ function is a no-op. Creates a new #GArray with a reference count of 1. - the new #GArray @@ -414,7 +387,6 @@ function is a no-op. This operation is slower than g_array_append_vals() since the existing elements in the array have to be moved to make space for the new elements. - the #GArray @@ -441,7 +413,6 @@ the new elements. Atomically increments the reference count of @array by one. This function is thread-safe and may be called from any thread. - The passed in #GArray @@ -460,7 +431,6 @@ This function is thread-safe and may be called from any thread. Removes the element at the given index from a #GArray. The following elements are moved down one place. - the #GArray @@ -485,7 +455,6 @@ elements are moved down one place. element in the array is used to fill in the space, so this function does not preserve the order of the #GArray. But it is faster than g_array_remove_index(). - the #GArray @@ -508,7 +477,6 @@ g_array_remove_index(). Removes the given number of elements starting at the given index from a #GArray. The following elements are moved to close the gap. - the #GArray @@ -543,7 +511,6 @@ pointer to the element to clear, rather than the element itself. Note that in contrast with other uses of #GDestroyNotify functions, @clear_func is expected to clear the contents of the array element it is given, but not free the element itself. - @@ -563,7 +530,6 @@ the array element it is given, but not free the element itself. Sets the size of the array, expanding it if necessary. If the array was created with @clear_ set to %TRUE, the new elements are set to 0. - the #GArray @@ -588,7 +554,6 @@ was created with @clear_ set to %TRUE, the new elements are set to 0. a reference count of 1. This avoids frequent reallocation, if you are going to add many elements to the array. Note however that the size of the array is still 0. - the new #GArray @@ -623,7 +588,6 @@ than second arg, zero for equal, greater zero if first arg is greater than second arg). This is guaranteed to be a stable sort since version 2.32. - @@ -649,7 +613,6 @@ This is guaranteed to be a stable sort since version 2.32. There used to be a comment here about making the sort stable by using the addresses of the elements in the comparison function. This did not actually work, so any such code should be removed. - @@ -689,7 +652,6 @@ gsize data_len; data = g_array_steal (some_array, &data_len); ... ]| - the element data, which should be freed using g_free(). @@ -714,7 +676,6 @@ data = g_array_steal (some_array, &data_len); reference count drops to 0, all memory allocated by the array is released. This function is thread-safe and may be called from any thread. - @@ -729,7 +690,6 @@ thread. - @@ -757,7 +717,6 @@ thread. The GAsyncQueue struct is an opaque data structure which represents an asynchronous queue. It should only be accessed through the g_async_queue_* functions. - Returns the length of the queue. @@ -767,7 +726,6 @@ value means waiting threads, and a positive value means available entries in the @queue. A return value of 0 could mean n entries in the queue and n threads waiting. This can happen due to locking of the queue or due to scheduling. - the length of the @queue @@ -790,7 +748,6 @@ in the queue and n threads waiting. This can happen due to locking of the queue or due to scheduling. This function must be called while holding the @queue's lock. - the length of the @queue. @@ -812,7 +769,6 @@ Call g_async_queue_unlock() to drop the lock again. While holding the lock, you can only call the g_async_queue_*_unlocked() functions on @queue. Otherwise, deadlock may occur. - @@ -826,7 +782,6 @@ deadlock may occur. Pops data from the @queue. If @queue is empty, this function blocks until data becomes available. - data from the queue @@ -843,7 +798,6 @@ blocks until data becomes available. blocks until data becomes available. This function must be called while holding the @queue's lock. - data from the queue. @@ -857,7 +811,6 @@ This function must be called while holding the @queue's lock. Pushes the @data into the @queue. @data must not be %NULL. - @@ -877,7 +830,6 @@ This function must be called while holding the @queue's lock. In contrast to g_async_queue_push(), this function pushes the new item ahead of the items already in the queue, so that it will be the next one to be popped off the queue. - @@ -899,7 +851,6 @@ pushes the new item ahead of the items already in the queue, so that it will be the next one to be popped off the queue. This function must be called while holding the @queue's lock. - @@ -925,7 +876,6 @@ This function will lock @queue before it sorts the queue and unlock it when it is finished. For an example of @func see g_async_queue_sort(). - @@ -964,7 +914,6 @@ new elements, see g_async_queue_sort(). This function must be called while holding the @queue's lock. For an example of @func see g_async_queue_sort(). - @@ -991,7 +940,6 @@ For an example of @func see g_async_queue_sort(). Pushes the @data into the @queue. @data must not be %NULL. This function must be called while holding the @queue's lock. - @@ -1009,7 +957,6 @@ This function must be called while holding the @queue's lock. Increases the reference count of the asynchronous @queue by 1. You do not need to hold the lock to call this function. - the @queue that was passed in (since 2.6) @@ -1026,7 +973,6 @@ You do not need to hold the lock to call this function. Reference counting is done atomically. so g_async_queue_ref() can be used regardless of the @queue's lock. - @@ -1039,7 +985,6 @@ lock. Remove an item from the queue. - %TRUE if the item was removed @@ -1059,7 +1004,6 @@ lock. Remove an item from the queue. This function must be called while holding the @queue's lock. - %TRUE if the item was removed @@ -1098,7 +1042,6 @@ lowest priority would be at the top of the queue, you could use: return (id1 > id2 ? +1 : id1 == id2 ? 0 : -1); ]| - @@ -1127,7 +1070,6 @@ if the first element should be lower in the @queue than the second element. This function must be called while holding the @queue's lock. - @@ -1155,7 +1097,6 @@ If no data is received before @end_time, %NULL is returned. To easily calculate @end_time, a combination of g_get_real_time() and g_time_val_add() can be used. use g_async_queue_timeout_pop(). - data from the queue or %NULL, when no data is received before @end_time. @@ -1183,7 +1124,6 @@ and g_time_val_add() can be used. This function must be called while holding the @queue's lock. use g_async_queue_timeout_pop_unlocked(). - data from the queue or %NULL, when no data is received before @end_time. @@ -1205,7 +1145,6 @@ This function must be called while holding the @queue's lock. @timeout microseconds, or until data becomes available. If no data is received before the timeout, %NULL is returned. - data from the queue or %NULL, when no data is received before the timeout. @@ -1229,7 +1168,6 @@ If no data is received before the timeout, %NULL is returned. If no data is received before the timeout, %NULL is returned. This function must be called while holding the @queue's lock. - data from the queue or %NULL, when no data is received before the timeout. @@ -1249,7 +1187,6 @@ This function must be called while holding the @queue's lock. Tries to pop data from the @queue. If no data is available, %NULL is returned. - data from the queue or %NULL, when no data is available immediately. @@ -1267,7 +1204,6 @@ This function must be called while holding the @queue's lock. %NULL is returned. This function must be called while holding the @queue's lock. - data from the queue or %NULL, when no data is available immediately. @@ -1286,7 +1222,6 @@ This function must be called while holding the @queue's lock. Calling this function when you have not acquired the with g_async_queue_lock() leads to undefined behaviour. - @@ -1304,7 +1239,6 @@ If the reference count went to 0, the @queue will be destroyed and the memory allocated will be freed. So you are not allowed to use the @queue afterwards, as it might have disappeared. You do not need to hold the lock to call this function. - @@ -1323,7 +1257,6 @@ will be destroyed and the memory allocated will be freed. Reference counting is done atomically. so g_async_queue_unref() can be used regardless of the @queue's lock. - @@ -1336,7 +1269,6 @@ lock. Creates a new asynchronous queue. - a new #GAsyncQueue. Free with g_async_queue_unref() @@ -1346,7 +1278,6 @@ lock. Creates a new asynchronous queue and sets up a destroy notify function that is used to free any remaining queue items when the queue is destroyed after the final unref. - a new #GAsyncQueue. Free with g_async_queue_unref() @@ -1362,13 +1293,11 @@ the queue is destroyed after the final unref. Specifies one of the possible types of byte order. See #G_BYTE_ORDER. - The `GBookmarkFile` structure contains only private data and should not be directly accessed. - Adds the application with @name and @exec to the list of applications that have registered a bookmark for @uri into @@ -1392,7 +1321,6 @@ with the same @name had already registered a bookmark for @uri inside @bookmark. If no bookmark for @uri is found, one is created. - @@ -1421,7 +1349,6 @@ If no bookmark for @uri is found, one is created. belongs to. If no bookmark for @uri is found then it is created. - @@ -1442,7 +1369,6 @@ If no bookmark for @uri is found then it is created. Frees a #GBookmarkFile. - @@ -1460,7 +1386,6 @@ In the event the URI cannot be found, -1 is returned and @error is set to #G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND. Use g_bookmark_file_get_added_date_time() instead, as `time_t` is deprecated due to the year 2038 problem. - a timestamp @@ -1481,7 +1406,6 @@ In the event the URI cannot be found, -1 is returned and In the event the URI cannot be found, %NULL is returned and @error is set to #G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND. - a #GDateTime @@ -1513,7 +1437,6 @@ the command line fails, an error of the #G_SHELL_ERROR domain is set and %FALSE is returned. Use g_bookmark_file_get_application_info() instead, as `time_t` is deprecated due to the year 2038 problem. - %TRUE on success. @@ -1559,7 +1482,6 @@ for @uri, %FALSE is returned and error is set to #G_BOOKMARK_FILE_ERROR_APP_NOT_REGISTERED. In the event that unquoting the command line fails, an error of the #G_SHELL_ERROR domain is set and %FALSE is returned. - %TRUE on success. @@ -1597,7 +1519,6 @@ bookmark for @uri. In the event the URI cannot be found, %NULL is returned and @error is set to #G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND. - a newly allocated %NULL-terminated array of strings. Use g_strfreev() to free it. @@ -1625,7 +1546,6 @@ In the event the URI cannot be found, %NULL is returned and In the event the URI cannot be found, %NULL is returned and @error is set to #G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND. - a newly allocated string or %NULL if the specified URI cannot be found. @@ -1650,7 +1570,6 @@ In the event the URI cannot be found, %NULL is returned and The returned array is %NULL terminated, so @length may optionally be %NULL. - a newly allocated %NULL-terminated array of group names. Use g_strfreev() to free it. @@ -1678,7 +1597,6 @@ be %NULL. In the event the URI cannot be found, %FALSE is returned and @error is set to #G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND. - %TRUE if the icon for the bookmark for the URI was found. You should free the returned strings. @@ -1710,7 +1628,6 @@ In the event the URI cannot be found, %FALSE is returned and @error is set to #G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND. In the event that the private flag cannot be found, %FALSE is returned and @error is set to #G_BOOKMARK_FILE_ERROR_INVALID_VALUE. - %TRUE if the private flag is set, %FALSE otherwise. @@ -1733,7 +1650,6 @@ In the event the URI cannot be found, %NULL is returned and @error is set to #G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND. In the event that the MIME type cannot be found, %NULL is returned and @error is set to #G_BOOKMARK_FILE_ERROR_INVALID_VALUE. - a newly allocated string or %NULL if the specified URI cannot be found. @@ -1757,7 +1673,6 @@ In the event the URI cannot be found, -1 is returned and @error is set to #G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND. Use g_bookmark_file_get_modified_date_time() instead, as `time_t` is deprecated due to the year 2038 problem. - a timestamp @@ -1778,7 +1693,6 @@ In the event the URI cannot be found, -1 is returned and In the event the URI cannot be found, %NULL is returned and @error is set to #G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND. - a #GDateTime @@ -1796,7 +1710,6 @@ In the event the URI cannot be found, %NULL is returned and Gets the number of bookmarks inside @bookmark. - the number of bookmarks @@ -1815,7 +1728,6 @@ If @uri is %NULL, the title of @bookmark is returned. In the event the URI cannot be found, %NULL is returned and @error is set to #G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND. - a newly allocated string or %NULL if the specified URI cannot be found. @@ -1836,7 +1748,6 @@ In the event the URI cannot be found, %NULL is returned and Returns all URIs of the bookmarks in the bookmark file @bookmark. The array of returned URIs will be %NULL-terminated, so @length may optionally be %NULL. - a newly allocated %NULL-terminated array of strings. Use g_strfreev() to free it. @@ -1862,7 +1773,6 @@ In the event the URI cannot be found, -1 is returned and @error is set to #G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND. Use g_bookmark_file_get_visited_date_time() instead, as `time_t` is deprecated due to the year 2038 problem. - a timestamp. @@ -1883,7 +1793,6 @@ In the event the URI cannot be found, -1 is returned and In the event the URI cannot be found, %NULL is returned and @error is set to #G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND. - a #GDateTime @@ -1905,7 +1814,6 @@ registered by application @name. In the event the URI cannot be found, %FALSE is returned and @error is set to #G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND. - %TRUE if the application @name was found @@ -1931,7 +1839,6 @@ the bookmark for @uri belongs to. In the event the URI cannot be found, %FALSE is returned and @error is set to #G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND. - %TRUE if @group was found. @@ -1953,7 +1860,6 @@ In the event the URI cannot be found, %FALSE is returned and Looks whether the desktop bookmark has an item with its URI set to @uri. - %TRUE if @uri is inside @bookmark, %FALSE otherwise @@ -1973,7 +1879,6 @@ In the event the URI cannot be found, %FALSE is returned and Loads a bookmark file from memory into an empty #GBookmarkFile structure. If the object cannot be created then @error is set to a #GBookmarkFileError. - %TRUE if a desktop bookmark could be loaded. @@ -2002,7 +1907,6 @@ paths returned from g_get_user_data_dir() and g_get_system_data_dirs(), loads the file into @bookmark and returns the file's full path in @full_path. If the file could not be loaded then @error is set to either a #GFileError or #GBookmarkFileError. - %TRUE if a key file could be loaded, %FALSE otherwise @@ -2027,7 +1931,6 @@ set to either a #GFileError or #GBookmarkFileError. Loads a desktop bookmark file into an empty #GBookmarkFile structure. If the file could not be loaded then @error is set to either a #GFileError or #GBookmarkFileError. - %TRUE if a desktop bookmark file could be loaded @@ -2051,7 +1954,6 @@ existing bookmark for @new_uri will be overwritten. If @new_uri is In the event the URI cannot be found, %FALSE is returned and @error is set to #G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND. - %TRUE if the URI was successfully changed @@ -2080,7 +1982,6 @@ In the event the URI cannot be found, %FALSE is returned and In the event that no application with name @app_name has registered a bookmark for @uri, %FALSE is returned and error is set to #G_BOOKMARK_FILE_ERROR_APP_NOT_REGISTERED. - %TRUE if the application was successfully removed. @@ -2108,7 +2009,6 @@ In the event the URI cannot be found, %FALSE is returned and @error is set to #G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND. In the event no group was defined, %FALSE is returned and @error is set to #G_BOOKMARK_FILE_ERROR_INVALID_VALUE. - %TRUE if @group was successfully removed. @@ -2130,7 +2030,6 @@ In the event no group was defined, %FALSE is returned and Removes the bookmark for @uri from the bookmark file @bookmark. - %TRUE if the bookmark was removed successfully. @@ -2152,7 +2051,6 @@ In the event no group was defined, %FALSE is returned and If no bookmark for @uri is found then it is created. Use g_bookmark_file_set_added_date_time() instead, as `time_t` is deprecated due to the year 2038 problem. - @@ -2175,7 +2073,6 @@ If no bookmark for @uri is found then it is created. Sets the time the bookmark for @uri was added into @bookmark. If no bookmark for @uri is found then it is created. - @@ -2225,7 +2122,6 @@ for @uri, %FALSE is returned and error is set to for @uri is found, one is created. Use g_bookmark_file_set_application_info() instead, as `time_t` is deprecated due to the year 2038 problem. - %TRUE if the application's meta-data was successfully changed. @@ -2286,7 +2182,6 @@ in the event that no application @name has registered a bookmark for @uri, %FALSE is returned and error is set to #G_BOOKMARK_FILE_ERROR_APP_NOT_REGISTERED. Otherwise, if no bookmark for @uri is found, one is created. - %TRUE if the application's meta-data was successfully changed. @@ -2326,7 +2221,6 @@ for @uri is found, one is created. If @uri is %NULL, the description of @bookmark is set. If a bookmark for @uri cannot be found then it is created. - @@ -2350,7 +2244,6 @@ If a bookmark for @uri cannot be found then it is created. set group name list is removed. If @uri cannot be found then an item for it is created. - @@ -2382,7 +2275,6 @@ the currently set icon. @href can either be a full URL for the icon file or the icon name following the Icon Naming specification. If no bookmark for @uri is found one is created. - @@ -2409,7 +2301,6 @@ If no bookmark for @uri is found one is created. Sets the private flag of the bookmark for @uri. If a bookmark for @uri cannot be found then it is created. - @@ -2432,7 +2323,6 @@ If a bookmark for @uri cannot be found then it is created. Sets @mime_type as the MIME type of the bookmark for @uri. If a bookmark for @uri cannot be found then it is created. - @@ -2462,7 +2352,6 @@ modifies a bookmark also changes the modification time, except for g_bookmark_file_set_visited_date_time(). Use g_bookmark_file_set_modified_date_time() instead, as `time_t` is deprecated due to the year 2038 problem. - @@ -2490,7 +2379,6 @@ The "modified" time should only be set when the bookmark's meta-data was actually changed. Every function of #GBookmarkFile that modifies a bookmark also changes the modification time, except for g_bookmark_file_set_visited_date_time(). - @@ -2516,7 +2404,6 @@ bookmark file @bookmark. If @uri is %NULL, the title of @bookmark is set. If a bookmark for @uri cannot be found then it is created. - @@ -2547,7 +2434,6 @@ using g_bookmark_file_get_mime_type(). Changing the "visited" time does not affect the "modified" time. Use g_bookmark_file_set_visited_date_time() instead, as `time_t` is deprecated due to the year 2038 problem. - @@ -2576,7 +2462,6 @@ either using the command line retrieved by g_bookmark_file_get_application_info( or by the default application for the bookmark's MIME type, retrieved using g_bookmark_file_get_mime_type(). Changing the "visited" time does not affect the "modified" time. - @@ -2597,7 +2482,6 @@ does not affect the "modified" time. This function outputs @bookmark as a string. - a newly allocated string holding the contents of the #GBookmarkFile @@ -2619,7 +2503,6 @@ does not affect the "modified" time. This function outputs @bookmark into a file. The write process is guaranteed to be atomic by using g_file_set_contents() internally. - %TRUE if the file was successfully written. @@ -2646,7 +2529,6 @@ guaranteed to be atomic by using g_file_set_contents() internally. Use g_bookmark_file_load_from_file(), g_bookmark_file_load_from_data() or g_bookmark_file_load_from_data_dirs() to read an existing bookmark file. - an empty #GBookmarkFile @@ -2655,7 +2537,6 @@ file. Error codes returned by bookmark file parsing. - URI was ill-formed @@ -2685,7 +2566,6 @@ file. Contains the public fields of a GByteArray. - a pointer to the element data. The data may be moved as elements are added to the #GByteArray @@ -2698,7 +2578,6 @@ file. Adds the given bytes to the end of the #GByteArray. The array will grow in size automatically if necessary. - the #GByteArray @@ -2727,7 +2606,6 @@ The array will grow in size automatically if necessary. %TRUE it frees the actual byte data. If the reference count of @array is greater than one, the #GByteArray wrapper is preserved but the size of @array will be set to zero. - the element data if @free_segment is %FALSE, otherwise %NULL. The element data should be freed using g_free(). @@ -2755,7 +2633,6 @@ will be set to zero. This is identical to using g_bytes_new_take() and g_byte_array_free() together. - a new immutable #GBytes representing same byte data that was in the array @@ -2772,7 +2649,6 @@ together. Creates a new #GByteArray with a reference count of 1. - the new #GByteArray @@ -2782,8 +2658,11 @@ together. Create byte array containing the data. The data will be owned by the array -and will be freed with g_free(), i.e. it could be allocated using g_strdup(). - +and will be freed with g_free(), i.e. it could be allocated using g_strdup(). + +Do not use it if @len is greater than %G_MAXUINT. #GByteArray +stores the length of its data in #guint, which may be shorter than +#gsize. a new #GByteArray @@ -2806,7 +2685,6 @@ and will be freed with g_free(), i.e. it could be allocated using g_strdup(). Adds the given data to the start of the #GByteArray. The array will grow in size automatically if necessary. - the #GByteArray @@ -2833,7 +2711,6 @@ The array will grow in size automatically if necessary. Atomically increments the reference count of @array by one. This function is thread-safe and may be called from any thread. - The passed in #GByteArray @@ -2852,7 +2729,6 @@ This function is thread-safe and may be called from any thread. Removes the byte at the given index from a #GByteArray. The following bytes are moved down one place. - the #GByteArray @@ -2877,7 +2753,6 @@ The following bytes are moved down one place. element in the array is used to fill in the space, so this function does not preserve the order of the #GByteArray. But it is faster than g_byte_array_remove_index(). - the #GByteArray @@ -2900,7 +2775,6 @@ than g_byte_array_remove_index(). Removes the given number of bytes starting at the given index from a #GByteArray. The following elements are moved to close the gap. - the #GByteArray @@ -2926,7 +2800,6 @@ than g_byte_array_remove_index(). Sets the size of the #GByteArray, expanding it if necessary. - the #GByteArray @@ -2951,7 +2824,6 @@ than g_byte_array_remove_index(). This avoids frequent reallocation, if you are going to add many bytes to the array. Note however that the size of the array is still 0. - the new #GByteArray @@ -2976,7 +2848,6 @@ is undefined. If you want equal elements to keep their order (i.e. you want a stable sort) you can write a comparison function that, if two elements would otherwise compare equal, compares them by their addresses. - @@ -2996,7 +2867,6 @@ their addresses. Like g_byte_array_sort(), but the comparison function takes an extra user data argument. - @@ -3021,7 +2891,6 @@ user data argument. Frees the data in the array and resets the size to zero, while the underlying array is preserved for use elsewhere and returned to the caller. - the element data, which should be freed using g_free(). @@ -3046,7 +2915,6 @@ to the caller. reference count drops to 0, all memory allocated by the array is released. This function is thread-safe and may be called from any thread. - @@ -3085,12 +2953,10 @@ The data pointed to by this bytes must not be modified. For a mutable array of bytes see #GByteArray. Use g_bytes_unref_to_array() to create a mutable array for a #GBytes sequence. To create an immutable #GBytes from a mutable #GByteArray, use the g_byte_array_free_to_bytes() function. - Creates a new #GBytes from @data. @data is copied. If @size is 0, @data may be %NULL. - a new #GBytes @@ -3114,7 +2980,6 @@ a mutable #GByteArray, use the g_byte_array_free_to_bytes() function. @data must be static (ie: never modified or freed). It may be %NULL if @size is 0. - a new #GBytes @@ -3146,7 +3011,6 @@ For creating #GBytes with memory from other allocators, see g_bytes_new_with_free_func(). @data may be %NULL if @size is 0. - a new #GBytes @@ -3175,7 +3039,6 @@ When the last reference is dropped, @free_func will be called with the been called to indicate that the bytes is no longer in use. @data may be %NULL if @size is 0. - a new #GBytes @@ -3212,7 +3075,6 @@ prefix of the longer one then the shorter one is considered to be less than the longer one. Otherwise the first byte where both differ is used for comparison. If @bytes1 has a smaller value at that position it is considered less, otherwise greater than @bytes2. - a negative value if @bytes1 is less than @bytes2, a positive value if @bytes1 is greater than @bytes2, and zero if @bytes1 is equal to @@ -3236,7 +3098,6 @@ considered less, otherwise greater than @bytes2. This function can be passed to g_hash_table_new() as the @key_equal_func parameter, when using non-%NULL #GBytes pointers as keys in a #GHashTable. - %TRUE if the two keys match. @@ -3260,7 +3121,6 @@ This function will always return the same pointer for a given #GBytes. %NULL may be returned if @size is 0. This is not guaranteed, as the #GBytes may represent an empty string with @data non-%NULL and @size as 0. %NULL will not be returned if @size is non-zero. - a pointer to the byte data, or %NULL @@ -3283,7 +3143,6 @@ not be returned if @size is non-zero. Get the size of the byte data in the #GBytes. This function will always return the same value for a given #GBytes. - the size @@ -3300,7 +3159,6 @@ This function will always return the same value for a given #GBytes. This function can be passed to g_hash_table_new() as the @key_hash_func parameter, when using non-%NULL #GBytes pointers as keys in a #GHashTable. - a hash value corresponding to the key. @@ -3324,7 +3182,6 @@ Since 2.56, if @offset is 0 and @length matches the size of @bytes, then is a slice of another #GBytes, then the resulting #GBytes will reference the same #GBytes instead of @bytes. This allows consumers to simplify the usage of #GBytes when asynchronously writing to streams. - a new #GBytes @@ -3346,7 +3203,6 @@ usage of #GBytes when asynchronously writing to streams. Increase the reference count on @bytes. - the #GBytes @@ -3361,7 +3217,6 @@ usage of #GBytes when asynchronously writing to streams. Releases a reference on @bytes. This may result in the bytes being freed. If @bytes is %NULL, it will return immediately. - @@ -3379,8 +3234,11 @@ the same byte data. As an optimization, the byte data is transferred to the array without copying if this was the last reference to bytes and bytes was created with g_bytes_new(), g_bytes_new_take() or g_byte_array_free_to_bytes(). In all -other cases the data is copied. - +other cases the data is copied. + +Do not use it if @bytes contains more than %G_MAXUINT +bytes. #GByteArray stores the length of its data in #guint, which +may be shorter than #gsize, that @bytes is using. a new mutable #GByteArray containing the same byte data @@ -3402,7 +3260,6 @@ As an optimization, the byte data is returned without copying if this was the last reference to bytes and bytes was created with g_bytes_new(), g_bytes_new_take() or g_byte_array_free_to_bytes(). In all other cases the data is copied. - a pointer to the same byte data, which should be freed with g_free() @@ -3425,7 +3282,6 @@ data is copied. Checks the version of the GLib library that is being compiled against. See glib_check_version() for a runtime check. - the major version to check for @@ -3442,28 +3298,24 @@ against. See glib_check_version() for a runtime check. The set of uppercase ASCII alphabet characters. Used for specifying valid identifier characters in #GScannerConfig. - The set of ASCII digits. Used for specifying valid identifier characters in #GScannerConfig. - The set of lowercase ASCII alphabet characters. Used for specifying valid identifier characters in #GScannerConfig. - An opaque structure representing a checksumming operation. To create a new GChecksum, use g_checksum_new(). To free a GChecksum, use g_checksum_free(). - Creates a new #GChecksum, using the checksum algorithm @checksum_type. If the @checksum_type is not known, %NULL is returned. @@ -3478,8 +3330,7 @@ vector of raw bytes. Once either g_checksum_get_string() or g_checksum_get_digest() have been called on a #GChecksum, the checksum will be closed and it won't be possible to call g_checksum_update() on it anymore. - - + the newly created #GChecksum, or %NULL. Use g_checksum_free() to free the memory allocated by it. @@ -3495,10 +3346,9 @@ on it anymore. Copies a #GChecksum. If @checksum has been closed, by calling g_checksum_get_string() or g_checksum_get_digest(), the copied checksum will be closed as well. - - the copy of the passed #GChecksum. Use g_checksum_free() - when finished using it. + the copy of the passed #GChecksum. Use + g_checksum_free() when finished using it. @@ -3510,7 +3360,6 @@ checksum will be closed as well. Frees the memory allocated for @checksum. - @@ -3527,7 +3376,6 @@ into @buffer. The size of the digest depends on the type of checksum. Once this function has been called, the #GChecksum is closed and can no longer be updated with g_checksum_update(). - @@ -3556,7 +3404,6 @@ Once this function has been called the #GChecksum can no longer be updated with g_checksum_update(). The hexadecimal characters will be lower case. - the hexadecimal representation of the checksum. The returned string is owned by the checksum and should not be modified @@ -3572,7 +3419,6 @@ The hexadecimal characters will be lower case. Resets the state of the @checksum back to its initial state. - @@ -3587,7 +3433,6 @@ The hexadecimal characters will be lower case. Feeds @data into an existing #GChecksum. The checksum must still be open, that is g_checksum_get_string() or g_checksum_get_digest() must not have been called on @checksum. - @@ -3610,7 +3455,6 @@ not have been called on @checksum. Gets the length in bytes of digests of type @checksum_type - the checksum length, or -1 if @checksum_type is not supported. @@ -3630,7 +3474,6 @@ digest of some data. Note that the #GChecksumType enumeration may be extended at a later date to include new hashing algorithm types. - Use the MD5 hashing algorithm @@ -3651,7 +3494,6 @@ date to include new hashing algorithm types. Prototype of a #GChildWatchSource callback, called when a child process has exited. To interpret @status, see the documentation for g_spawn_check_exit_status(). - @@ -3676,7 +3518,6 @@ for g_spawn_check_exit_status(). The implementation is expected to free the resource identified by @handle_id; for instance, if @handle_id is a #GSource ID, g_source_remove() can be used. - @@ -3692,7 +3533,6 @@ g_source_remove() can be used. values. The function should return a negative integer if the first value comes before the second, 0 if they are equal, or a positive integer if the first value comes after the second. - negative value if @a < @b; zero if @a = @b; positive value if @a > @b @@ -3718,7 +3558,6 @@ integer if the first value comes after the second. values. The function should return a negative integer if the first value comes before the second, 0 if they are equal, or a positive integer if the first value comes after the second. - negative value if @a < @b; zero if @a = @b; positive value if @a > @b @@ -3801,7 +3640,6 @@ without initialisation. Otherwise, you should call g_cond_init() on it and g_cond_clear() when done. A #GCond should only be accessed via the g_cond_ functions. - @@ -3815,7 +3653,6 @@ A #GCond should only be accessed via the g_cond_ functions. If no threads are waiting for @cond, this function has no effect. It is good practice to lock the same mutex as the waiting threads while calling this function, though not required. - @@ -3834,7 +3671,6 @@ statically allocated. Calling g_cond_clear() for a #GCond on which threads are blocking leads to undefined behaviour. - @@ -3857,7 +3693,6 @@ needed, use g_cond_clear(). Calling g_cond_init() on an already-initialised #GCond leads to undefined behaviour. - @@ -3873,7 +3708,6 @@ to undefined behaviour. If no threads are waiting for @cond, this function has no effect. It is good practice to hold the same lock as the waiting thread while calling this function, though not required. - @@ -3899,7 +3733,6 @@ condition is no longer met. For this reason, g_cond_wait() must always be used in a loop. See the documentation for #GCond for a complete example. - @@ -3963,7 +3796,6 @@ time on this API -- if a relative time of 5 seconds were passed directly to the call and a spurious wakeup occurred, the program would have to start over waiting again (which would lead to a total wait time of more than 5 seconds). - %TRUE on a signal, %FALSE on a timeout @@ -3986,7 +3818,6 @@ time of more than 5 seconds). Error codes returned by character set conversion routines. - Conversion between the requested character sets is not supported. @@ -4020,7 +3851,6 @@ time of more than 5 seconds). A function of this signature is used to copy the node data when doing a deep-copy of a tree. - A pointer to the copy @@ -4040,22 +3870,18 @@ when doing a deep-copy of a tree. A bitmask that restricts the possible flags passed to g_datalist_set_flags(). Passing a flags value where flags & ~G_DATALIST_FLAGS_MASK != 0 is an error. - Represents an invalid #GDateDay. - Represents an invalid Julian day number. - Represents an invalid year. - @@ -4076,7 +3902,6 @@ G_DEFINE_AUTOPTR_CLEANUP_FUNC(GObject, g_object_unref) This macro should be used unconditionally; it is a no-op on compilers where cleanup is not supported. - a type name to define a g_autoptr() cleanup function for @@ -4100,7 +3925,6 @@ G_DEFINE_AUTO_CLEANUP_CLEAR_FUNC(GQueue, g_queue_clear) This macro should be used unconditionally; it is a no-op on compilers where cleanup is not supported. - a type name to define a g_auto() cleanup function for @@ -4131,7 +3955,6 @@ G_DEFINE_AUTO_CLEANUP_FREE_FUNC(GStrv, g_strfreev, NULL) This macro should be used unconditionally; it is a no-op on compilers where cleanup is not supported. - a type name to define a g_auto() cleanup function for @@ -4151,7 +3974,6 @@ where cleanup is not supported. Note that the quark name will be stringified automatically in the macro, so you shouldn't use double quotes. - the name to return a #GQuark for @@ -4162,154 +3984,132 @@ in the macro, so you shouldn't use double quotes. - - - - - - - - - - - - - - - - - - - - - - @@ -4325,7 +4125,6 @@ before the function declaration. G_DEPRECATED_FOR(my_replacement) int my_mistake (void); ]| - the name of the function that this function was deprecated for @@ -4333,455 +4132,390 @@ int my_mistake (void); - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - @@ -4790,26 +4524,22 @@ int my_mistake (void); The directory separator character. This is '/' on UNIX machines and '\' under Windows. - The directory separator as a string. This is "/" on UNIX machines and "\" under Windows. - The #GData struct is an opaque data structure to represent a [Keyed Data List][glib-Keyed-Data-Lists]. It should only be accessed via the following functions. - Specifies the type of function passed to g_dataset_foreach(). It is called with each #GQuark id and associated data element, together with the @user_data parameter supplied to g_dataset_foreach(). - @@ -4840,7 +4570,6 @@ initialized with g_date_clear(). g_date_clear() makes the date invalid but safe. An invalid date doesn't represent a day, it's "empty." A date becomes valid after you set it to a Julian day or you set a day, month, and year. - the Julian representation of the date @@ -4872,7 +4601,6 @@ and year. it to a safe state. The new date will be cleared (as if you'd called g_date_clear()) but invalid (it won't represent an existing day). Free the return value with g_date_free(). - a newly-allocated #GDate @@ -4882,7 +4610,6 @@ represent an existing day). Free the return value with g_date_free(). Like g_date_new(), but also sets the value of the date. Assuming the day-month-year triplet you pass in represents an existing day, the returned date will be valid. - a newly-allocated #GDate initialized with @day, @month, and @year @@ -4906,7 +4633,6 @@ returned date will be valid. Like g_date_new(), but also sets the value of the date. Assuming the Julian day number you pass in is valid (greater than 0, less than an unreasonably large number), the returned date will be valid. - a newly-allocated #GDate initialized with @julian_day @@ -4922,7 +4648,6 @@ unreasonably large number), the returned date will be valid. Increments a date some number of days. To move forward by weeks, add weeks*7 days. The date must be valid. - @@ -4943,7 +4668,6 @@ If the day of the month is greater than 28, this routine may change the day of the month (because the destination month may not have the current day in it). The date must be valid. - @@ -4963,7 +4687,6 @@ the current day in it). The date must be valid. If the date is February 29, and the destination year is not a leap year, the date will be changed to February 28. The date must be valid. - @@ -4984,7 +4707,6 @@ If @date falls after @max_date, sets @date equal to @max_date. Otherwise, @date is unchanged. Either of @min_date and @max_date may be %NULL. All non-%NULL dates must be valid. - @@ -5008,7 +4730,6 @@ All non-%NULL dates must be valid. state. The cleared dates will not represent an existing date, but will not contain garbage. Useful to init a date declared on the stack. Validity can be tested with g_date_valid(). - @@ -5026,7 +4747,6 @@ Validity can be tested with g_date_valid(). qsort()-style comparison function for dates. Both dates must be valid. - 0 for equal, less than zero if @lhs is less than @rhs, greater than zero if @lhs is greater than @rhs @@ -5047,7 +4767,6 @@ Both dates must be valid. Copies a GDate to a newly-allocated GDate. If the input was invalid (as determined by g_date_valid()), the invalid state will be copied as is into the new object. - a newly-allocated #GDate initialized from @date @@ -5063,7 +4782,6 @@ as is into the new object. Computes the number of days between two dates. If @date2 is prior to @date1, the returned value is negative. Both dates must be valid. - the number of days between @date1 and @date2 @@ -5081,7 +4799,6 @@ Both dates must be valid. Frees a #GDate returned from g_date_new(). - @@ -5094,7 +4811,6 @@ Both dates must be valid. Returns the day of the month. The date must be valid. - day of the month @@ -5109,7 +4825,6 @@ Both dates must be valid. Returns the day of the year, where Jan 1 is the first day of the year. The date must be valid. - day of the year @@ -5124,7 +4839,6 @@ year. The date must be valid. Returns the week of the year, where weeks are interpreted according to ISO 8601. - ISO 8601 week number of the year. @@ -5141,7 +4855,6 @@ to ISO 8601. Julian day is simply the number of days since January 1, Year 1; i.e., January 1, Year 1 is Julian day 1; January 2, Year 1 is Julian day 2, etc. The date must be valid. - Julian day @@ -5157,7 +4870,6 @@ etc. The date must be valid. Returns the week of the year, where weeks are understood to start on Monday. If the date is before the first Monday of the year, return 0. The date must be valid. - week of the year @@ -5171,7 +4883,6 @@ The date must be valid. Returns the month of the year. The date must be valid. - month of the year as a #GDateMonth @@ -5187,7 +4898,6 @@ The date must be valid. Returns the week of the year during which this date falls, if weeks are understood to begin on Sunday. The date must be valid. Can return 0 if the day is before the first Sunday of the year. - week number @@ -5201,7 +4911,6 @@ Can return 0 if the day is before the first Sunday of the year. Returns the day of the week for a #GDate. The date must be valid. - day of the week as a #GDateWeekday. @@ -5215,7 +4924,6 @@ Can return 0 if the day is before the first Sunday of the year. Returns the year of a #GDate. The date must be valid. - year in which the date falls @@ -5230,7 +4938,6 @@ Can return 0 if the day is before the first Sunday of the year. Returns %TRUE if the date is on the first of a month. The date must be valid. - %TRUE if the date is the first of the month @@ -5245,7 +4952,6 @@ The date must be valid. Returns %TRUE if the date is the last day of the month. The date must be valid. - %TRUE if the date is the last day of the month @@ -5260,7 +4966,6 @@ The date must be valid. Checks if @date1 is less than or equal to @date2, and swap the values if this is not the case. - @@ -5278,7 +4983,6 @@ and swap the values if this is not the case. Sets the day of the month for a #GDate. If the resulting day-month-year triplet is invalid, the date will be invalid. - @@ -5298,7 +5002,6 @@ day-month-year triplet is invalid, the date will be invalid. The day-month-year triplet must be valid; if you aren't sure it is, call g_date_valid_dmy() to check before you set it. - @@ -5323,7 +5026,6 @@ set it. Sets the value of a #GDate from a Julian day number. - @@ -5341,7 +5043,6 @@ set it. Sets the month of the year for a #GDate. If the resulting day-month-year triplet is invalid, the date will be invalid. - @@ -5368,7 +5069,6 @@ isn't very precise, and its exact behavior varies with the locale. It's intended to be a heuristic routine that guesses what the user means by a given string (and it does work pretty well in that capacity). - @@ -5387,7 +5087,6 @@ capacity). Sets the value of a date from a #GTime value. The time to date conversion is done using the user's current timezone. Use g_date_set_time_t() instead. - @@ -5414,7 +5113,6 @@ To set the value of a date to the current day, you could write: // handle the error g_date_set_time_t (date, now); ]| - @@ -5437,7 +5135,6 @@ additional precision. The time to date conversion is done using the user's current timezone. #GTimeVal is not year-2038-safe. Use g_date_set_time_t() instead. - @@ -5455,7 +5152,6 @@ The time to date conversion is done using the user's current timezone. Sets the year for a #GDate. If the resulting day-month-year triplet is invalid, the date will be invalid. - @@ -5474,7 +5170,6 @@ triplet is invalid, the date will be invalid. Moves a date some number of days into the past. To move by weeks, just move by weeks*7 days. The date must be valid. - @@ -5494,7 +5189,6 @@ The date must be valid. If the current day of the month doesn't exist in the destination month, the day of the month may change. The date must be valid. - @@ -5515,7 +5209,6 @@ If the current day doesn't exist in the destination year (i.e. it's February 29 and you move to a non-leap-year) then the day is changed to February 29. The date must be valid. - @@ -5533,7 +5226,6 @@ must be valid. Fills in the date-related bits of a struct tm using the @date value. Initializes the non-date parts with something safe but meaningless. - @@ -5552,7 +5244,6 @@ Initializes the non-date parts with something safe but meaningless. Returns %TRUE if the #GDate represents an existing day. The date must not contain garbage; it should have been initialized with g_date_clear() if it wasn't allocated by one of the g_date_new() variants. - Whether the date is valid @@ -5567,7 +5258,6 @@ if it wasn't allocated by one of the g_date_new() variants. Returns the number of days in a month, taking leap years into account. - number of days in @month during the @year @@ -5591,7 +5281,6 @@ plus 1 or 2 extra days depending on whether it's a leap year. This function is basically telling you how many Mondays are in the year, i.e. there are 53 Mondays if one of the extra days happens to be a Monday.) - number of Mondays in the year @@ -5611,7 +5300,6 @@ plus 1 or 2 extra days depending on whether it's a leap year. This function is basically telling you how many Sundays are in the year, i.e. there are 53 Sundays if one of the extra days happens to be a Sunday.) - the number of weeks in @year @@ -5630,7 +5318,6 @@ For the purposes of this function, leap year is every year divisible by 4 unless that year is divisible by 100. If it is divisible by 100 it would be a leap year only if that year is also divisible by 400. - %TRUE if the year is a leap year @@ -5656,7 +5343,6 @@ addition to those implemented by the platform's C library. For example, don't expect that using g_date_strftime() would make the \%F provided by the C99 strftime() work on Windows where the C library only complies to C89. - number of characters written to the buffer, or 0 the buffer was too small @@ -5683,7 +5369,6 @@ where the C library only complies to C89. Returns %TRUE if the day of the month is valid (a day is valid if it's between 1 and 31 inclusive). - %TRUE if the day is valid @@ -5699,7 +5384,6 @@ between 1 and 31 inclusive). Returns %TRUE if the day-month-year triplet forms a valid, existing day in the range of days #GDate understands (Year 1 or later, no more than a few thousand years in the future). - %TRUE if the date is a valid one @@ -5722,7 +5406,6 @@ a few thousand years in the future). Returns %TRUE if the Julian day is valid. Anything greater than zero is basically a valid Julian, though there is a 32-bit limit. - %TRUE if the Julian day is valid @@ -5737,7 +5420,6 @@ is basically a valid Julian, though there is a 32-bit limit. Returns %TRUE if the month value is valid. The 12 #GDateMonth enumeration values are the only valid months. - %TRUE if the month is valid @@ -5752,7 +5434,6 @@ enumeration values are the only valid months. Returns %TRUE if the weekday is valid. The seven #GDateWeekday enumeration values are the only valid weekdays. - %TRUE if the weekday is valid @@ -5767,7 +5448,6 @@ values are the only valid weekdays. Returns %TRUE if the year is valid. Any year greater than 0 is valid, though there is a 16-bit limit to what #GDate will understand. - %TRUE if the year is valid @@ -5783,7 +5463,6 @@ though there is a 16-bit limit to what #GDate will understand. This enumeration isn't used in the API, but may be useful if you need to mark a number as a day, month, or year. - a day @@ -5797,7 +5476,6 @@ to mark a number as a day, month, or year. Enumeration representing a month; values are #G_DATE_JANUARY, #G_DATE_FEBRUARY, etc. #G_DATE_BAD_MONTH is the invalid value. - invalid value @@ -5841,7 +5519,6 @@ to mark a number as a day, month, or year. `GDateTime` is an opaque structure whose members cannot be accessed directly. - Creates a new #GDateTime corresponding to the given date and time in the time zone @tz. @@ -5871,7 +5548,6 @@ return %NULL. You should release the return value by calling g_date_time_unref() when you are done with it. - a new #GDateTime, or %NULL @@ -5951,7 +5627,6 @@ formatted string. You should release the return value by calling g_date_time_unref() when you are done with it. - a new #GDateTime, or %NULL @@ -5983,7 +5658,6 @@ You should release the return value by calling g_date_time_unref() when you are done with it. #GTimeVal is not year-2038-safe. Use g_date_time_new_from_unix_local() instead. - a new #GDateTime, or %NULL @@ -6008,7 +5682,6 @@ You should release the return value by calling g_date_time_unref() when you are done with it. #GTimeVal is not year-2038-safe. Use g_date_time_new_from_unix_utc() instead. - a new #GDateTime, or %NULL @@ -6032,7 +5705,6 @@ of the supported range of #GDateTime. You should release the return value by calling g_date_time_unref() when you are done with it. - a new #GDateTime, or %NULL @@ -6055,7 +5727,6 @@ of the supported range of #GDateTime. You should release the return value by calling g_date_time_unref() when you are done with it. - a new #GDateTime, or %NULL @@ -6073,7 +5744,6 @@ the local time zone. This call is equivalent to calling g_date_time_new() with the time zone returned by g_time_zone_new_local(). - a #GDateTime, or %NULL @@ -6115,7 +5785,6 @@ year 9999. You should release the return value by calling g_date_time_unref() when you are done with it. - a new #GDateTime, or %NULL @@ -6133,7 +5802,6 @@ time zone. This is equivalent to calling g_date_time_new_now() with the time zone returned by g_time_zone_new_local(). - a new #GDateTime, or %NULL @@ -6144,7 +5812,6 @@ zone returned by g_time_zone_new_local(). This is equivalent to calling g_date_time_new_now() with the time zone returned by g_time_zone_new_utc(). - a new #GDateTime, or %NULL @@ -6156,7 +5823,6 @@ UTC. This call is equivalent to calling g_date_time_new() with the time zone returned by g_time_zone_new_utc(). - a #GDateTime, or %NULL @@ -6190,7 +5856,6 @@ zone returned by g_time_zone_new_utc(). Creates a copy of @datetime and adds the specified timespan to the copy. - the newly created #GDateTime which should be freed with g_date_time_unref(), or %NULL @@ -6210,7 +5875,6 @@ zone returned by g_time_zone_new_utc(). Creates a copy of @datetime and adds the specified number of days to the copy. Add negative values to subtract days. - the newly created #GDateTime which should be freed with g_date_time_unref(), or %NULL @@ -6230,7 +5894,6 @@ copy. Add negative values to subtract days. Creates a new #GDateTime adding the specified values to the current date and time in @datetime. Add negative values to subtract. - the newly created #GDateTime which should be freed with g_date_time_unref(), or %NULL @@ -6270,7 +5933,6 @@ time in @datetime. Add negative values to subtract. Creates a copy of @datetime and adds the specified number of hours. Add negative values to subtract hours. - the newly created #GDateTime which should be freed with g_date_time_unref(), or %NULL @@ -6290,7 +5952,6 @@ Add negative values to subtract hours. Creates a copy of @datetime adding the specified number of minutes. Add negative values to subtract minutes. - the newly created #GDateTime which should be freed with g_date_time_unref(), or %NULL @@ -6315,7 +5976,6 @@ The day of the month of the resulting #GDateTime is clamped to the number of days in the updated calendar month. For example, if adding 1 month to 31st January 2018, the result would be 28th February 2018. In 2020 (a leap year), the result would be 29th February. - the newly created #GDateTime which should be freed with g_date_time_unref(), or %NULL @@ -6335,7 +5995,6 @@ year), the result would be 29th February. Creates a copy of @datetime and adds the specified number of seconds. Add negative values to subtract seconds. - the newly created #GDateTime which should be freed with g_date_time_unref(), or %NULL @@ -6355,7 +6014,6 @@ Add negative values to subtract seconds. Creates a copy of @datetime and adds the specified number of weeks to the copy. Add negative values to subtract weeks. - the newly created #GDateTime which should be freed with g_date_time_unref(), or %NULL @@ -6378,7 +6036,6 @@ copy. Add negative values to subtract years. As with g_date_time_add_months(), if the resulting date would be 29th February on a non-leap year, the day will be clamped to 28th February. - the newly created #GDateTime which should be freed with g_date_time_unref(), or %NULL @@ -6395,11 +6052,29 @@ February on a non-leap year, the day will be clamped to 28th February. + + A comparison function for #GDateTimes that is suitable +as a #GCompareFunc. Both #GDateTimes must be non-%NULL. + + -1, 0 or 1 if @dt1 is less than, equal to or greater + than @dt2. + + + + + first #GDateTime to compare + + + + second #GDateTime to compare + + + + Calculates the difference in time between @end and @begin. The #GTimeSpan that is returned is effectively @end - @begin (ie: positive if the first parameter is larger). - the difference between the two #GDateTime, as a time span expressed in microseconds. @@ -6416,6 +6091,26 @@ positive if the first parameter is larger). + + Checks to see if @dt1 and @dt2 are equal. + +Equal here means that they represent the same moment after converting +them to the same time zone. + + %TRUE if @dt1 and @dt2 are equal + + + + + a #GDateTime + + + + a #GDateTime + + + + Creates a newly allocated string representing the requested @format. @@ -6516,7 +6211,6 @@ some languages (Baltic, Slavic, Greek, and more) due to their grammatical rules. For other languages there is no difference. \%OB is a GNU and BSD strftime() extension expected to be added to the future POSIX specification, \%Ob and \%Oh are GNU strftime() extensions. Since: 2.56 - a newly allocated string formatted to the requested format or %NULL in the case that there was an error (such @@ -6542,7 +6236,6 @@ including the date, time and time zone, and return that as a UTF-8 encoded string. Since GLib 2.66, this will output to sub-second precision if needed. - a newly allocated string formatted in ISO 8601 format or %NULL in the case that there was an error. The string @@ -6559,7 +6252,6 @@ Since GLib 2.66, this will output to sub-second precision if needed. Retrieves the day of the month represented by @datetime in the gregorian calendar. - the day of the month @@ -6574,7 +6266,6 @@ calendar. Retrieves the ISO 8601 day of the week on which @datetime falls (1 is Monday, 2 is Tuesday... 7 is Sunday). - the day of the week @@ -6589,7 +6280,6 @@ Monday, 2 is Tuesday... 7 is Sunday). Retrieves the day of the year represented by @datetime in the Gregorian calendar. - the day of the year @@ -6603,7 +6293,6 @@ calendar. Retrieves the hour of the day represented by @datetime - the hour of the day @@ -6617,7 +6306,6 @@ calendar. Retrieves the microsecond of the date represented by @datetime - the microsecond of the second @@ -6631,7 +6319,6 @@ calendar. Retrieves the minute of the hour represented by @datetime - the minute of the hour @@ -6646,7 +6333,6 @@ calendar. Retrieves the month of the year represented by @datetime in the Gregorian calendar. - the month represented by @datetime @@ -6660,7 +6346,6 @@ calendar. Retrieves the second of the minute represented by @datetime - the second represented by @datetime @@ -6675,7 +6360,6 @@ calendar. Retrieves the number of seconds since the start of the last minute, including the fractional part. - the number of seconds @@ -6689,7 +6373,6 @@ including the fractional part. Get the time zone for this @datetime. - the time zone @@ -6708,7 +6391,6 @@ the time zone of @datetime. For example, in Toronto this is currently "EST" during the winter months and "EDT" during the summer months when daylight savings time is in effect. - the time zone abbreviation. The returned string is owned by the #GDateTime and it should not be @@ -6731,7 +6413,6 @@ arrive at local time for the time zone (ie: negative numbers for time zones west of GMT, positive numbers for east). If @datetime represents UTC time, then the offset is always zero. - the number of microseconds that should be added to UTC to get the local time @@ -6776,7 +6457,6 @@ week (Monday to Sunday). Note that January 1 0001 in the proleptic Gregorian calendar is a Monday, so this function never returns 0. - the ISO 8601 week-numbering year for @datetime @@ -6804,7 +6484,6 @@ year are considered as being contained in the last week of the previous year. Similarly, the final days of a calendar year may be considered as being part of the first ISO 8601 week of the next year if 4 or more days of that week are contained within the new year. - the ISO 8601 week number for @datetime. @@ -6818,7 +6497,6 @@ if 4 or more days of that week are contained within the new year. Retrieves the year represented by @datetime in the Gregorian calendar. - the year represented by @datetime @@ -6832,7 +6510,6 @@ if 4 or more days of that week are contained within the new year. Retrieves the Gregorian day, month, and year of a given #GDateTime. - @@ -6855,10 +6532,22 @@ if 4 or more days of that week are contained within the new year. + + Hashes @datetime into a #guint, suitable for use within #GHashTable. + + a #guint containing the hash + + + + + a #GDateTime + + + + Determines if daylight savings time is in effect at the time and in the time zone of @datetime. - %TRUE if daylight savings time is in effect @@ -6872,7 +6561,6 @@ the time zone of @datetime. Atomically increments the reference count of @datetime by one. - the #GDateTime with the reference count increased @@ -6890,7 +6578,6 @@ the time zone of @datetime. This call is equivalent to calling g_date_time_to_timezone() with the time zone returned by g_time_zone_new_local(). - the newly created #GDateTime which should be freed with g_date_time_unref(), or %NULL @@ -6919,7 +6606,6 @@ out of range. On systems where 'long' is 64bit, this function never fails. #GTimeVal is not year-2038-safe. Use g_date_time_to_unix() instead. - %TRUE if successful, else %FALSE @@ -6942,7 +6628,6 @@ On systems where 'long' is 64bit, this function never fails. This call can fail in the case that the time goes out of bounds. For example, converting 0001-01-01 00:00:00 UTC to a time zone west of Greenwich will fail (due to the year 0 being out of range). - the newly created #GDateTime which should be freed with g_date_time_unref(), or %NULL @@ -6965,7 +6650,6 @@ nearest second. Unix time is the number of seconds that have elapsed since 1970-01-01 00:00:00 UTC, regardless of the time zone associated with @datetime. - the Unix time corresponding to @datetime @@ -6983,7 +6667,6 @@ Unix time is the number of seconds that have elapsed since 1970-01-01 This call is equivalent to calling g_date_time_to_timezone() with the time zone returned by g_time_zone_new_utc(). - the newly created #GDateTime which should be freed with g_date_time_unref(), or %NULL @@ -7001,7 +6684,6 @@ time zone returned by g_time_zone_new_utc(). When the reference count reaches zero, the resources allocated by @datetime are freed - @@ -7012,66 +6694,10 @@ When the reference count reaches zero, the resources allocated by - - A comparison function for #GDateTimes that is suitable -as a #GCompareFunc. Both #GDateTimes must be non-%NULL. - - - -1, 0 or 1 if @dt1 is less than, equal to or greater - than @dt2. - - - - - first #GDateTime to compare - - - - second #GDateTime to compare - - - - - - Checks to see if @dt1 and @dt2 are equal. - -Equal here means that they represent the same moment after converting -them to the same time zone. - - - %TRUE if @dt1 and @dt2 are equal - - - - - a #GDateTime - - - - a #GDateTime - - - - - - Hashes @datetime into a #guint, suitable for use within #GHashTable. - - - a #guint containing the hash - - - - - a #GDateTime - - - - Enumeration representing a day of the week; #G_DATE_MONDAY, #G_DATE_TUESDAY, etc. #G_DATE_BAD_WEEKDAY is an invalid weekday. - invalid value @@ -7100,7 +6726,6 @@ them to the same time zone. Associates a string with a bit flag. Used in g_parse_debug_string(). - the string @@ -7114,7 +6739,6 @@ Used in g_parse_debug_string(). Specifies the type of function which is called when a data element is destroyed. It is passed the pointer to the data element and should free any memory and resources allocated for it. - @@ -7127,10 +6751,8 @@ should free any memory and resources allocated for it. An opaque structure representing an opened directory. - Closes the directory and deallocates all related resources. - @@ -7155,7 +6777,6 @@ name is in the on-disk encoding. On Windows, as is true of all GLib functions which operate on filenames, the returned name is in UTF-8. - The entry's name or %NULL if there are no more entries. The return value is owned by GLib and @@ -7172,7 +6793,6 @@ filenames, the returned name is in UTF-8. Resets the given directory. The next call to g_dir_read_name() will return the first entry again. - @@ -7195,7 +6815,6 @@ basename, no directory components are allowed. If template is Note that in contrast to g_mkdtemp() (and mkdtemp()) @tmpl is not modified, and might thus be a read-only literal string. - The actual name used. This string should be freed with g_free() when not needed any longer and is @@ -7215,7 +6834,6 @@ modified, and might thus be a read-only literal string. Opens a directory for reading. The names of the files in the directory can then be retrieved using g_dir_read_name(). Note that the ordering is not defined. - a newly allocated #GDir on success, %NULL on failure. If non-%NULL, you must free the result with g_dir_close() @@ -7240,13 +6858,11 @@ that the ordering is not defined. mantissa and exponent of IEEE floats and doubles. These unions are defined as appropriate for a given platform. IEEE floats and doubles are supported (used for storage) by at least Intel, PPC and Sparc. - the double value - @@ -7266,7 +6882,6 @@ as appropriate for a given platform. IEEE floats and doubles are supported What this means depends on the context, it could just be incrementing the reference count, if @data is a ref-counted object. - a duplicate of data @@ -7285,11 +6900,9 @@ object. The base of natural logarithms. - - @@ -7301,7 +6914,6 @@ object. Specifies the type of a function used to test two values for equality. The function should return %TRUE if both values are equal and %FALSE otherwise. - %TRUE if @a = @b; %FALSE otherwise @@ -7320,7 +6932,6 @@ and %FALSE otherwise. The `GError` structure contains information about an error that has occurred. - error domain, e.g. #G_FILE_ERROR @@ -7336,7 +6947,6 @@ an error that has occurred. Creates a new #GError with the given @domain and @code, and a message formatted with @format. - a new #GError @@ -7365,7 +6975,6 @@ and a message formatted with @format. not a printf()-style format string. Use this function if @message contains text you don't have control over, that could include printf() escape sequences. - a new #GError @@ -7388,7 +6997,6 @@ that could include printf() escape sequences. Creates a new #GError with the given @domain and @code, and a message formatted with @format. - a new #GError @@ -7414,7 +7022,6 @@ and a message formatted with @format. Makes a copy of @error. - a new #GError @@ -7428,7 +7035,6 @@ and a message formatted with @format. Frees a #GError and associated resources. - @@ -7450,7 +7056,6 @@ instead treat any not-explicitly-recognized error code as being equivalent to the `FAILED` code. This way, if the domain is extended in the future to provide a more specific error code for a certain case, your code will still work. - whether @error has @domain and @code @@ -7474,7 +7079,6 @@ a certain case, your code will still work. The possible errors, used in the @v_error field of #GTokenValue, when the token is a %G_TOKEN_ERROR. - unknown error @@ -7513,7 +7117,6 @@ It's not very portable to make detailed assumptions about exactly which errors will be returned from a given operation. Some errors don't occur on some systems, etc., sometimes there are subtle differences in when a system will report a given error, etc. - Operation not permitted; only the owner of the file (or other resource) or processes with special privileges @@ -7635,7 +7238,6 @@ differences in when a system will report a given error, etc. Flags to pass to g_file_set_contents_full() to affect its safety and performance. - No guarantees about file consistency or durability. The most dangerous setting, which is slightly faster than other settings. @@ -7663,7 +7265,6 @@ performance. A test to perform on a file using g_file_test(). - %TRUE if the file is a regular file (not a directory). Note that this test will also return %TRUE @@ -7688,13 +7289,11 @@ performance. mantissa and exponent of IEEE floats and doubles. These unions are defined as appropriate for a given platform. IEEE floats and doubles are supported (used for storage) by at least Intel, PPC and Sparc. - the double value - @@ -7708,7 +7307,6 @@ as appropriate for a given platform. IEEE floats and doubles are supported Flags to modify the format of the string returned by g_format_size_full(). - behave the same as g_format_size() @@ -7731,7 +7329,6 @@ as appropriate for a given platform. IEEE floats and doubles are supported Declares a type of function which takes an arbitrary data pointer argument and has no return value. It is not currently used in GLib or GTK+. - @@ -7745,7 +7342,6 @@ not currently used in GLib or GTK+. Specifies the type of functions passed to g_list_foreach() and g_slist_foreach(). - @@ -7773,7 +7369,6 @@ sscanf ("42", "%" G_GINT16_FORMAT, &in) out = in * 1000; g_print ("%" G_GINT32_FORMAT, out); ]| - @@ -7788,26 +7383,22 @@ The following example prints "0x7b"; gint16 value = 123; g_print ("%#" G_GINT16_MODIFIER "x", value); ]| - This is the platform dependent conversion specifier for scanning and printing values of type #gint32. See also #G_GINT16_FORMAT. - The platform dependent length modifier for conversion specifiers for scanning and printing values of type #gint32 or #guint32. It is a string literal. See also #G_GINT16_MODIFIER. - This macro is used to insert 64-bit integer literals into the source code. - a literal integer value, e.g. 0x1d636b02300a7aa7 @@ -7824,7 +7415,6 @@ is not defined. Note that scanf() may not support 64-bit integers, even if %G_GINT64_FORMAT is defined. Due to its weak error handling, scanf() is not recommended for parsing anyway; consider using g_ascii_strtoull() instead. - @@ -7835,20 +7425,17 @@ It is a string literal. Some platforms do not support printing 64-bit integers, even though the types are supported. On such platforms %G_GINT64_MODIFIER is not defined. - This is the platform dependent conversion specifier for scanning and printing values of type #gintptr. - The platform dependent length modifier for conversion specifiers for scanning and printing values of type #gintptr or #guintptr. It is a string literal. - @@ -7865,7 +7452,6 @@ gpointer g_malloc (gsize n_bytes) G_GNUC_MALLOC G_GNUC_ALLOC_SIZE(1); ]| See the [GNU C documentation](https://gcc.gnu.org/onlinedocs/gcc/Common-Function-Attributes.html#index-alloc_005fsize-function-attribute) for more details. - the index of the argument specifying the allocation size @@ -7887,7 +7473,6 @@ gpointer g_malloc_n (gsize n_blocks, ]| See the [GNU C documentation](https://gcc.gnu.org/onlinedocs/gcc/Common-Function-Attributes.html#index-alloc_005fsize-function-attribute) for more details. - the index of the argument specifying one factor of the allocation size @@ -7906,7 +7491,6 @@ the following would only match on compilers such as GCC 4.8 or newer. #if G_GNUC_CHECK_VERSION(4, 8) #endif ]| - major version to check against @@ -7932,7 +7516,6 @@ See the [GNU C documentation](https://gcc.gnu.org/onlinedocs/gcc/Common-Function Note that if @f is a macro, it will be expanded in the warning message. You can enclose it in quotes to prevent this. (The quotes will show up in the warning, but it's better than showing the macro expansion.) - the intended replacement for the deprecated symbol, @@ -7957,7 +7540,6 @@ See the [GNU C documentation](https://gcc.gnu.org/onlinedocs/gcc/Common-Function |[<!-- language="C" --> gchar *g_dgettext (gchar *domain_name, gchar *msgid) G_GNUC_FORMAT (2); ]| - the index of the argument @@ -7968,14 +7550,12 @@ gchar *g_dgettext (gchar *domain_name, gchar *msgid) G_GNUC_FORMAT (2); Expands to "" on all modern compilers, and to __FUNCTION__ on gcc version 2.x. Don't use it. Use G_STRFUNC() instead - Expands to "" on all modern compilers, and to __PRETTY_FUNCTION__ on gcc version 2.x. Don't use it. Use G_STRFUNC() instead - @@ -7997,7 +7577,6 @@ gint g_snprintf (gchar *string, gchar const *format, ...) G_GNUC_PRINTF (3, 4); ]| - the index of the argument corresponding to the @@ -8027,7 +7606,6 @@ int my_vscanf (MyStream *stream, See the [GNU C documentation](https://gcc.gnu.org/onlinedocs/gcc/Common-Function-Attributes.html#index-Wformat-3288) for details. - the index of the argument corresponding to @@ -8054,7 +7632,6 @@ gsize my_strftime (MyBuffer *buffer, See the [GNU C documentation](https://gcc.gnu.org/onlinedocs/gcc/Common-Function-Attributes.html#index-Wformat-3288) for details. - the index of the argument corresponding to @@ -8067,7 +7644,6 @@ for details. into the source code. See also #G_GINT64_CONSTANT. - a literal integer value, e.g. 0x1d636b02300a7aa7 @@ -8077,45 +7653,38 @@ See also #G_GINT64_CONSTANT. This is the platform dependent conversion specifier for scanning and printing values of type #gsize. See also #G_GINT16_FORMAT. - The platform dependent length modifier for conversion specifiers for scanning and printing values of type #gsize. It is a string literal. - This is the platform dependent conversion specifier for scanning and printing values of type #gssize. See also #G_GINT16_FORMAT. - The platform dependent length modifier for conversion specifiers for scanning and printing values of type #gssize. It is a string literal. - This is the platform dependent conversion specifier for scanning and printing values of type #guint16. See also #G_GINT16_FORMAT - This is the platform dependent conversion specifier for scanning and printing values of type #guint32. See also #G_GINT16_FORMAT. - This macro is used to insert 64-bit unsigned integer literals into the source code. - a literal integer value, e.g. 0x1d636b02300a7aa7U @@ -8132,41 +7701,33 @@ is not defined. Note that scanf() may not support 64-bit integers, even if %G_GINT64_FORMAT is defined. Due to its weak error handling, scanf() is not recommended for parsing anyway; consider using g_ascii_strtoull() instead. - This is the platform dependent conversion specifier for scanning and printing values of type #guintptr. - - - Defined to 1 if gcc-style visibility handling is supported. - - - Specifies the type of the function passed to g_hash_table_foreach(). It is called with each key/value pair, together with the @user_data parameter which is passed to g_hash_table_foreach(). - @@ -8187,7 +7748,6 @@ parameter which is passed to g_hash_table_foreach(). Casts a pointer to a `GHook*`. - a pointer @@ -8197,7 +7757,6 @@ parameter which is passed to g_hash_table_foreach(). Returns %TRUE if the #GHook is active, which is normally the case until the #GHook is destroyed. - a #GHook @@ -8206,7 +7765,6 @@ until the #GHook is destroyed. Gets the flags of a hook. - a #GHook @@ -8218,12 +7776,10 @@ until the #GHook is destroyed. use be the #GHook implementation, i.e. `1 << G_HOOK_FLAG_USER_SHIFT` is the first bit which can be used for application-defined flags. - Returns %TRUE if the #GHook function is currently executing. - a #GHook @@ -8232,7 +7788,6 @@ bit which can be used for application-defined flags. Returns %TRUE if the #GHook is not in a #GHookList. - a #GHook @@ -8242,7 +7797,6 @@ bit which can be used for application-defined flags. Returns %TRUE if the #GHook is valid, i.e. it is in a #GHookList, it is active and it has not been destroyed. - a #GHook @@ -8255,7 +7809,6 @@ g_hash_table_foreach_remove(). It is called with each key/value pair, together with the @user_data parameter passed to g_hash_table_foreach_remove(). It should return %TRUE if the key/value pair should be removed from the #GHashTable. - %TRUE if the key/value pair should be removed from the #GHashTable @@ -8307,7 +7860,6 @@ The key to choosing a good hash is unpredictability. Even cryptographic hashes are very easy to find collisions for when the remainder is taken modulo a somewhat predictable prime number. There must be an element of randomness that an attacker is unable to guess. - the hash value corresponding to the key @@ -8323,7 +7875,6 @@ must be an element of randomness that an attacker is unable to guess. The #GHashTable struct is an opaque data structure to represent a [Hash Table][glib-Hash-Tables]. It should only be accessed via the following functions. - This is a convenience function for using a #GHashTable as a set. It is equivalent to calling g_hash_table_replace() with @key as both the @@ -8340,7 +7891,6 @@ the discussion in the section description. Starting from GLib 2.40, this function returns a boolean value to indicate whether the newly added value was already in the hash table or not. - %TRUE if the key did not exist yet @@ -8361,7 +7911,6 @@ or not. Checks if @key is in @hash_table. - %TRUE if @key is in @hash_table, %FALSE otherwise. @@ -8387,7 +7936,6 @@ you should either free them first or create the #GHashTable with destroy notifiers using g_hash_table_new_full(). In the latter case the destroy functions you supplied will be called on all keys and values during the destruction phase. - @@ -8415,7 +7963,6 @@ once per every entry in a hash table) should probably be reworked to use additional or different data structures for reverse lookups (keep in mind that an O(n) find/foreach operation issued for all n values in a hash table ends up needing O(n*n) operations). - The value of the first key/value pair is returned, for which @predicate evaluates to %TRUE. If no pair with the @@ -8453,7 +8000,6 @@ the hash table is not defined. See g_hash_table_find() for performance caveats for linear order searches in contrast to g_hash_table_lookup(). - @@ -8484,7 +8030,6 @@ used to free the memory allocated for the removed keys and values. See #GHashTableIter for an alternative way to loop over the key/value pairs in the hash table. - the number of key/value pairs removed @@ -8515,7 +8060,6 @@ destroy functions are called. See #GHashTableIter for an alternative way to loop over the key/value pairs in the hash table. - the number of key/value pairs removed. @@ -8545,7 +8089,6 @@ until changes to the hash release those keys. This iterates over every entry in the hash table to build its return value. To iterate over the entries in a #GHashTable more efficiently, use a #GHashTableIter. - a #GList containing all the keys inside the hash table. The content of the list is owned by the @@ -8583,7 +8126,6 @@ You should always free the return result with g_free(). In the above-mentioned case of a string-keyed hash table, it may be appropriate to use g_strfreev() if you call g_hash_table_steal_all() first to transfer ownership of the keys. - a %NULL-terminated array containing each key from the table. @@ -8612,7 +8154,6 @@ is valid until @hash_table is modified. This iterates over every entry in the hash table to build its return value. To iterate over the entries in a #GHashTable more efficiently, use a #GHashTableIter. - a #GList containing all the values inside the hash table. The content of the list is owned by the @@ -8645,7 +8186,6 @@ key is freed using that function. Starting from GLib 2.40, this function returns a boolean value to indicate whether the newly added value was already in the hash table or not. - %TRUE if the key did not exist yet @@ -8673,7 +8213,6 @@ or not. distinguish between a key that is not present and one which is present and has the value %NULL. If you need this distinction, use g_hash_table_lookup_extended(). - the associated value, or %NULL if the key is not found @@ -8701,7 +8240,6 @@ for example before calling g_hash_table_remove(). You can actually pass %NULL for @lookup_key to test whether the %NULL key exists, provided the hash and equal functions of @hash_table are %NULL-safe. - %TRUE if the key was found in the #GHashTable @@ -8746,7 +8284,6 @@ a similar fashion to g_direct_equal(), but without the overhead of a function call. @key_equal_func is called with the key from the hash table as its first parameter, and the user-provided key to check against as its second. - a new #GHashTable @@ -8777,7 +8314,6 @@ permissible if the application still holds a reference to the hash table. This means that you may need to ensure that the hash table is empty by calling g_hash_table_remove_all() before releasing the last reference using g_hash_table_unref(). - a new #GHashTable @@ -8811,7 +8347,6 @@ g_hash_table_unref(). Atomically increments the reference count of @hash_table by one. This function is MT-safe and may be called from any thread. - the passed in #GHashTable @@ -8836,7 +8371,6 @@ If the #GHashTable was created using g_hash_table_new_full(), the key and value are freed using the supplied destroy functions, otherwise you have to make sure that any dynamically allocated values are freed yourself. - %TRUE if the key was found and removed from the #GHashTable @@ -8862,7 +8396,6 @@ If the #GHashTable was created using g_hash_table_new_full(), the keys and values are freed using the supplied destroy functions, otherwise you have to make sure that any dynamically allocated values are freed yourself. - @@ -8888,7 +8421,6 @@ If you supplied a @key_destroy_func when creating the Starting from GLib 2.40, this function returns a boolean value to indicate whether the newly added value was already in the hash table or not. - %TRUE if the key did not exist yet @@ -8913,7 +8445,6 @@ or not. Returns the number of elements contained in the #GHashTable. - the number of key/value pairs in the #GHashTable. @@ -8931,7 +8462,6 @@ or not. Removes a key and its associated value from a #GHashTable without calling the key and value destroy functions. - %TRUE if the key was found and removed from the #GHashTable @@ -8953,7 +8483,6 @@ calling the key and value destroy functions. Removes all keys and their associated values from a #GHashTable without calling the key and value destroy functions. - @@ -8978,7 +8507,6 @@ the caller of this method; as with g_hash_table_steal(). You can pass %NULL for @lookup_key, provided the hash and equal functions of @hash_table are %NULL-safe. - %TRUE if the key was found in the #GHashTable @@ -9012,7 +8540,6 @@ of @hash_table are %NULL-safe. If the reference count drops to 0, all keys and values will be destroyed, and all memory allocated by the hash table is released. This function is MT-safe and may be called from any thread. - @@ -9035,7 +8562,6 @@ with g_hash_table_iter_init(). The iteration order of a #GHashTableIter over the keys/values in a hash table is not defined. - @@ -9056,7 +8582,6 @@ table is not defined. Returns the #GHashTable associated with @iter. - the #GHashTable associated with @iter. @@ -9089,7 +8614,6 @@ while (g_hash_table_iter_next (&iter, &key, &value)) // do something with key and value } ]| - @@ -9111,7 +8635,6 @@ while (g_hash_table_iter_next (&iter, &key, &value)) Advances @iter and retrieves the key and/or value that are now pointed to as a result of this advancement. If %FALSE is returned, @key and @value are not set, and the iterator becomes invalid. - %FALSE if the end of the #GHashTable has been reached. @@ -9150,7 +8673,6 @@ while (g_hash_table_iter_next (&iter, &key, &value)) g_hash_table_iter_remove (&iter); } ]| - @@ -9168,7 +8690,6 @@ g_hash_table_iter_next() returned %TRUE. If you supplied a @value_destroy_func when creating the #GHashTable, the old value is freed using that function. - @@ -9189,7 +8710,6 @@ iterator from its associated #GHashTable, without calling the key and value destroy functions. Can only be called after g_hash_table_iter_next() returned %TRUE, and cannot be called more than once for the same key/value pair. - @@ -9205,12 +8725,10 @@ be called more than once for the same key/value pair. An opaque structure representing a HMAC operation. To create a new GHmac, use g_hmac_new(). To free a GHmac, use g_hmac_unref(). - Copies a #GHmac. If @hmac has been closed, by calling g_hmac_get_string() or g_hmac_get_digest(), the copied HMAC will be closed as well. - the copy of the passed #GHmac. Use g_hmac_unref() when finished using it. @@ -9229,7 +8747,6 @@ into @buffer. The size of the digest depends on the type of checksum. Once this function has been called, the #GHmac is closed and can no longer be updated with g_checksum_update(). - @@ -9258,7 +8775,6 @@ Once this function has been called the #GHmac can no longer be updated with g_hmac_update(). The hexadecimal characters will be lower case. - the hexadecimal representation of the HMAC. The returned string is owned by the HMAC and should not be modified @@ -9276,7 +8792,6 @@ The hexadecimal characters will be lower case. Atomically increments the reference count of @hmac by one. This function is MT-safe and may be called from any thread. - the passed in #GHmac. @@ -9295,7 +8810,6 @@ If the reference count drops to 0, all keys and values will be destroyed, and all memory allocated by the hash table is released. This function is MT-safe and may be called from any thread. Frees the memory allocated for @hmac. - @@ -9311,7 +8825,6 @@ Frees the memory allocated for @hmac. The HMAC must still be open, that is g_hmac_get_string() or g_hmac_get_digest() must not have been called on @hmac. - @@ -9349,7 +8862,6 @@ on it anymore. Support for digests of type %G_CHECKSUM_SHA512 has been added in GLib 2.42. Support for %G_CHECKSUM_SHA384 was added in GLib 2.52. - the newly created #GHmac, or %NULL. Use g_hmac_unref() to free the memory allocated by it. @@ -9375,7 +8887,6 @@ Support for %G_CHECKSUM_SHA384 was added in GLib 2.52. The #GHook struct represents a single hook function in a #GHookList. - data which is passed to func when this hook is invoked @@ -9414,7 +8925,6 @@ Support for %G_CHECKSUM_SHA384 was added in GLib 2.52. Compares the ids of two #GHook elements, returning a negative value if the second id is greater than the first. - a value <= 0 if the id of @sibling is >= the id of @new_hook @@ -9432,7 +8942,6 @@ if the second id is greater than the first. Allocates space for a #GHook and initializes it. - a new #GHook @@ -9446,7 +8955,6 @@ if the second id is greater than the first. Destroys a #GHook, given its ID. - %TRUE if the #GHook was found in the #GHookList and destroyed @@ -9465,7 +8973,6 @@ if the second id is greater than the first. Removes one #GHook from a #GHookList, marking it inactive and calling g_hook_unref() on it. - @@ -9483,7 +8990,6 @@ inactive and calling g_hook_unref() on it. Finds a #GHook in a #GHookList using the given function to test for a match. - the found #GHook or %NULL if no matching #GHook is found @@ -9511,7 +9017,6 @@ test for a match. Finds a #GHook in a #GHookList with the given data. - the #GHook with the given @data or %NULL if no matching #GHook is found @@ -9535,7 +9040,6 @@ test for a match. Finds a #GHook in a #GHookList with the given function. - the #GHook with the given @func or %NULL if no matching #GHook is found @@ -9559,7 +9063,6 @@ test for a match. Finds a #GHook in a #GHookList with the given function and data. - the #GHook with the given @func and @data or %NULL if no matching #GHook is found @@ -9590,7 +9093,6 @@ test for a match. The reference count for the #GHook is incremented, so you must call g_hook_unref() to restore it when no longer needed. (Or call g_hook_next_valid() if you are stepping through the #GHookList.) - the first valid #GHook, or %NULL if none are valid @@ -9611,7 +9113,6 @@ g_hook_next_valid() if you are stepping through the #GHookList.) Calls the #GHookList @finalize_hook function if it exists, and frees the memory allocated for the #GHook. - @@ -9628,7 +9129,6 @@ and frees the memory allocated for the #GHook. Returns the #GHook with the given id, or %NULL if it is not found. - the #GHook with the given id, or %NULL if it is not found @@ -9646,7 +9146,6 @@ and frees the memory allocated for the #GHook. Inserts a #GHook into a #GHookList, before a given #GHook. - @@ -9667,7 +9166,6 @@ and frees the memory allocated for the #GHook. Inserts a #GHook into a #GHookList, sorted by the given function. - @@ -9691,7 +9189,6 @@ and frees the memory allocated for the #GHook. The reference count for the #GHook is incremented, so you must call g_hook_unref() to restore it when no longer needed. (Or continue to call g_hook_next_valid() until %NULL is returned.) - the next valid #GHook, or %NULL if none are valid @@ -9715,7 +9212,6 @@ g_hook_next_valid() until %NULL is returned.) Prepends a #GHook on the start of a #GHookList. - @@ -9732,7 +9228,6 @@ g_hook_next_valid() until %NULL is returned.) Increments the reference count for a #GHook. - the @hook that was passed in (since 2.6) @@ -9752,7 +9247,6 @@ g_hook_next_valid() until %NULL is returned.) Decrements the reference count of a #GHook. If the reference count falls to 0, the #GHook is removed from the #GHookList and g_hook_free() is called to free it. - @@ -9771,7 +9265,6 @@ from the #GHookList and g_hook_free() is called to free it. Defines the type of a hook function that can be invoked by g_hook_list_invoke_check(). - %FALSE if the #GHook should be destroyed @@ -9785,7 +9278,6 @@ by g_hook_list_invoke_check(). Defines the type of function used by g_hook_list_marshal_check(). - %FALSE if @hook should be destroyed @@ -9804,7 +9296,6 @@ by g_hook_list_invoke_check(). Defines the type of function used to compare #GHook elements in g_hook_insert_sorted(). - a value <= 0 if @new_hook should be before @sibling @@ -9823,7 +9314,6 @@ g_hook_insert_sorted(). Defines the type of function to be called when a hook in a list of hooks gets finalized. - @@ -9840,7 +9330,6 @@ list of hooks gets finalized. Defines the type of the function passed to g_hook_find(). - %TRUE if the required #GHook has been found @@ -9858,7 +9347,6 @@ list of hooks gets finalized. Flags used internally in the #GHook implementation. - set if the hook has not been destroyed @@ -9873,7 +9361,6 @@ list of hooks gets finalized. Defines the type of a hook function that can be invoked by g_hook_list_invoke(). - @@ -9886,7 +9373,6 @@ by g_hook_list_invoke(). The #GHookList struct represents a list of hook functions. - the next free #GHook id @@ -9920,7 +9406,6 @@ by g_hook_list_invoke(). Removes all the #GHook elements from a #GHookList. - @@ -9934,7 +9419,6 @@ by g_hook_list_invoke(). Initializes a #GHookList. This must be called before the #GHookList is used. - @@ -9952,7 +9436,6 @@ This must be called before the #GHookList is used. Calls all of the #GHook functions in a #GHookList. - @@ -9972,7 +9455,6 @@ This must be called before the #GHookList is used. Calls all of the #GHook functions in a #GHookList. Any function which returns %FALSE is removed from the #GHookList. - @@ -9991,7 +9473,6 @@ Any function which returns %FALSE is removed from the #GHookList. Calls a function on each valid #GHook. - @@ -10019,7 +9500,6 @@ Any function which returns %FALSE is removed from the #GHookList. Calls a function on each valid #GHook and destroys it if the function returns %FALSE. - @@ -10047,7 +9527,6 @@ function returns %FALSE. Defines the type of function used by g_hook_list_marshal(). - @@ -10065,7 +9544,6 @@ function returns %FALSE. The GIConv struct wraps an iconv() conversion descriptor. It contains private data and should only be accessed using the following functions. - Same as the standard UNIX routine iconv(), but may be implemented via libiconv on UNIX flavors that lack @@ -10080,7 +9558,6 @@ set, is implementation defined. This function may return success (with a positive number of non-reversible conversions as replacement characters were used), or it may return -1 and set an error such as %EILSEQ, in such a situation. - count of non-reversible conversions, or -1 on error @@ -10117,7 +9594,6 @@ you are done converting things. GLib provides g_convert() and g_locale_to_utf8() which are likely more convenient than the raw iconv wrappers. - -1 on error, 0 on success @@ -10136,7 +9612,6 @@ a native implementation. GLib provides g_convert() and g_locale_to_utf8() which are likely more convenient than the raw iconv wrappers. - a "conversion descriptor", or (GIConv)-1 if opening the converter failed. @@ -10156,19 +9631,16 @@ more convenient than the raw iconv wrappers. The bias by which exponents in double-precision floats are offset. - The bias by which exponents in single-precision floats are offset. - A data structure representing an IO Channel. The fields should be considered private and should only be accessed with the following functions. - @@ -10237,7 +9709,6 @@ channel will be closed when the last reference to it is dropped, so there is no need to call g_io_channel_close() (though doing so will not cause problems, as long as no attempt is made to access the channel after it is closed). - A #GIOChannel on success, %NULL on failure. @@ -10277,7 +9748,6 @@ sockets overlap. There is no way for GLib to know which one you mean in case the argument you pass to this function happens to be both a valid file descriptor and socket. If that happens a warning is issued, and GLib assumes that it is the file descriptor you mean. - a new #GIOChannel. @@ -10294,7 +9764,6 @@ issued, and GLib assumes that it is the file descriptor you mean. flushed, ignoring errors. The channel will not be freed until the last reference is dropped using g_io_channel_unref(). Use g_io_channel_shutdown() instead. - @@ -10307,7 +9776,6 @@ last reference is dropped using g_io_channel_unref(). Flushes the write buffer for the GIOChannel. - the status of the operation: One of #G_IO_STATUS_NORMAL, #G_IO_STATUS_AGAIN, or @@ -10325,7 +9793,6 @@ last reference is dropped using g_io_channel_unref(). This function returns a #GIOCondition depending on whether there is data to be read/space to write data in the internal buffers in the #GIOChannel. Only the flags %G_IO_IN and %G_IO_OUT may be set. - A #GIOCondition @@ -10339,7 +9806,6 @@ the #GIOChannel. Only the flags %G_IO_IN and %G_IO_OUT may be set. Gets the buffer size. - the size of the buffer. @@ -10353,7 +9819,6 @@ the #GIOChannel. Only the flags %G_IO_IN and %G_IO_OUT may be set. Returns whether @channel is buffered. - %TRUE if the @channel is buffered. @@ -10370,7 +9835,6 @@ the #GIOChannel. Only the flags %G_IO_IN and %G_IO_OUT may be set. will be closed when @channel receives its final unref and is destroyed. The default value of this is %TRUE for channels created by g_io_channel_new_file (), and %FALSE for all other channels. - %TRUE if the channel will be closed, %FALSE otherwise. @@ -10386,7 +9850,6 @@ by g_io_channel_new_file (), and %FALSE for all other channels. Gets the encoding for the input/output of the channel. The internal encoding is always UTF-8. The encoding %NULL makes the channel safe for binary data. - A string containing the encoding, this string is owned by GLib and must not be freed. @@ -10409,7 +9872,6 @@ If they should change at some later point (e.g. partial shutdown of a socket with the UNIX shutdown() function), the user should immediately call g_io_channel_get_flags() to update the internal values of these flags. - the flags which are set on the channel @@ -10425,7 +9887,6 @@ the internal values of these flags. This returns the string that #GIOChannel uses to determine where in the file a line break occurs. A value of %NULL indicates autodetection. - The line termination string. This value is owned by GLib and must not be freed. @@ -10448,7 +9909,6 @@ indicates autodetection. This is called by each of the above functions when creating a #GIOChannel, and so is not often needed by the application programmer (unless you are creating a new type of #GIOChannel). - @@ -10462,7 +9922,6 @@ programmer (unless you are creating a new type of #GIOChannel). Reads data from a #GIOChannel. Use g_io_channel_read_chars() instead. - %G_IO_ERROR_NONE if the operation was successful. @@ -10489,7 +9948,6 @@ programmer (unless you are creating a new type of #GIOChannel). Replacement for g_io_channel_read() with the new API. - the status of the operation. @@ -10526,7 +9984,6 @@ programmer (unless you are creating a new type of #GIOChannel). from a #GIOChannel into a newly-allocated string. @str_return will contain allocated memory if the return is %G_IO_STATUS_NORMAL. - the status of the operation. @@ -10555,7 +10012,6 @@ is %G_IO_STATUS_NORMAL. Reads a line from a #GIOChannel, using a #GString as a buffer. - the status of the operation. @@ -10579,7 +10035,6 @@ is %G_IO_STATUS_NORMAL. Reads all the remaining data from the file. - %G_IO_STATUS_NORMAL on success. This function never returns %G_IO_STATUS_EOF. @@ -10609,7 +10064,6 @@ is %G_IO_STATUS_NORMAL. Reads a Unicode character from @channel. This function cannot be called on a channel with %NULL encoding. - a #GIOStatus @@ -10627,7 +10081,6 @@ This function cannot be called on a channel with %NULL encoding. Increments the reference count of a #GIOChannel. - the @channel that was passed in (since 2.6) @@ -10643,7 +10096,6 @@ This function cannot be called on a channel with %NULL encoding. Sets the current position in the #GIOChannel, similar to the standard library function fseek(). Use g_io_channel_seek_position() instead. - %G_IO_ERROR_NONE if the operation was successful. @@ -10668,7 +10120,6 @@ library function fseek(). Replacement for g_io_channel_seek() with the new API. - the status of the operation. @@ -10693,7 +10144,6 @@ library function fseek(). Sets the buffer size. - @@ -10728,7 +10178,6 @@ calls from the new and old APIs, if this is necessary for maintaining old code. The default state of the channel is buffered. - @@ -10750,7 +10199,6 @@ created by g_io_channel_new_file (), and %FALSE for all other channels. Setting this flag to %TRUE for a channel you have already closed can cause problems when the final reference to the #GIOChannel is dropped. - @@ -10801,7 +10249,6 @@ Channels which do not meet one of the above conditions cannot call g_io_channel_seek_position() with an offset of %G_SEEK_CUR, and, if they are "seekable", cannot call g_io_channel_write_chars() after calling one of the API "read" functions. - %G_IO_STATUS_NORMAL if the encoding was successfully set @@ -10819,7 +10266,6 @@ calling one of the API "read" functions. Sets the (writeable) flags in @channel to (@flags & %G_IO_FLAG_SET_MASK). - the status of the operation. @@ -10838,7 +10284,6 @@ calling one of the API "read" functions. This sets the string that #GIOChannel uses to determine where in the file a line break occurs. - @@ -10866,7 +10311,6 @@ where in the file a line break occurs. Close an IO channel. Any pending data to be written will be flushed if @flush is %TRUE. The channel will not be freed until the last reference is dropped using g_io_channel_unref(). - the status of the operation. @@ -10887,7 +10331,6 @@ last reference is dropped using g_io_channel_unref(). On Windows this function returns the file descriptor or socket of the #GIOChannel. - the file descriptor of the #GIOChannel. @@ -10901,7 +10344,6 @@ the #GIOChannel. Decrements the reference count of a #GIOChannel. - @@ -10915,7 +10357,6 @@ the #GIOChannel. Writes data to a #GIOChannel. Use g_io_channel_write_chars() instead. - %G_IO_ERROR_NONE if the operation was successful. @@ -10946,7 +10387,6 @@ On seekable channels with encodings other than %NULL or UTF-8, generic mixing of reading and writing is not allowed. A call to g_io_channel_write_chars () may only be made on a channel from which data has been read in the cases described in the documentation for g_io_channel_set_encoding (). - the status of the operation. @@ -10980,7 +10420,6 @@ cases described in the documentation for g_io_channel_set_encoding (). Writes a Unicode character to @channel. This function cannot be called on a channel with %NULL encoding. - a #GIOStatus @@ -10998,7 +10437,6 @@ This function cannot be called on a channel with %NULL encoding. Converts an `errno` error number to a #GIOChannelError. - a #GIOChannelError error number, e.g. %G_IO_CHANNEL_ERROR_INVAL. @@ -11019,7 +10457,6 @@ This function cannot be called on a channel with %NULL encoding. Error codes returned by #GIOChannel operations. - File too large. @@ -11074,7 +10511,6 @@ event source. #GIOError is only used by the deprecated functions g_io_channel_read(), g_io_channel_write(), and g_io_channel_seek(). - no error @@ -11092,7 +10528,6 @@ g_io_channel_read(), g_io_channel_write(), and g_io_channel_seek(). Specifies properties of a #GIOChannel. Some of the flags can only be read with g_io_channel_get_flags(), but not changed with g_io_channel_set_flags(). - turns on append mode, corresponds to %O_APPEND (see the documentation of the UNIX open() syscall) @@ -11136,7 +10571,6 @@ g_io_channel_set_flags(). Specifies the type of function passed to g_io_add_watch() or g_io_add_watch_full(), which is called when the requested condition on a #GIOChannel is satisfied. - the function should return %FALSE if the event source should be removed @@ -11160,10 +10594,8 @@ on a #GIOChannel is satisfied. A table of functions used to handle different types of #GIOChannel in a generic way. - - @@ -11185,7 +10617,6 @@ in a generic way. - @@ -11207,7 +10638,6 @@ in a generic way. - @@ -11226,7 +10656,6 @@ in a generic way. - @@ -11239,7 +10668,6 @@ in a generic way. - @@ -11255,7 +10683,6 @@ in a generic way. - @@ -11268,7 +10695,6 @@ in a generic way. - @@ -11284,7 +10710,6 @@ in a generic way. - @@ -11298,7 +10723,6 @@ in a generic way. Statuses returned by most of the #GIOFuncs functions. - An error occurred. @@ -11316,7 +10740,6 @@ in a generic way. Checks whether a character is a directory separator. It returns %TRUE for '/' on UNIX machines and for '\' or '/' under Windows. - a character @@ -11328,104 +10751,88 @@ machines and for '\' or '/' under Windows. [Desktop Entry Specification](http://freedesktop.org/Standards/desktop-entry-spec). Consult the specification for more details about the meanings of the keys below. - A key under #G_KEY_FILE_DESKTOP_GROUP, whose value is a string list giving the available application actions. - A key under #G_KEY_FILE_DESKTOP_GROUP, whose value is a list of strings giving the categories in which the desktop entry should be shown in a menu. - A key under #G_KEY_FILE_DESKTOP_GROUP, whose value is a localized string giving the tooltip for the desktop entry. - A key under #G_KEY_FILE_DESKTOP_GROUP, whose value is a boolean set to true if the application is D-Bus activatable. - A key under #G_KEY_FILE_DESKTOP_GROUP, whose value is a string giving the command line to execute. It is only valid for desktop entries with the `Application` type. - A key under #G_KEY_FILE_DESKTOP_GROUP, whose value is a localized string giving the generic name of the desktop entry. - A key under #G_KEY_FILE_DESKTOP_GROUP, whose value is a boolean stating whether the desktop entry has been deleted by the user. - A key under #G_KEY_FILE_DESKTOP_GROUP, whose value is a localized string giving the name of the icon to be displayed for the desktop entry. - A key under #G_KEY_FILE_DESKTOP_GROUP, whose value is a list of strings giving the MIME types supported by this desktop entry. - A key under #G_KEY_FILE_DESKTOP_GROUP, whose value is a localized string giving the specific name of the desktop entry. - A key under #G_KEY_FILE_DESKTOP_GROUP, whose value is a list of strings identifying the environments that should not display the desktop entry. - A key under #G_KEY_FILE_DESKTOP_GROUP, whose value is a boolean stating whether the desktop entry should be shown in menus. - A key under #G_KEY_FILE_DESKTOP_GROUP, whose value is a list of strings identifying the environments that should display the desktop entry. - A key under #G_KEY_FILE_DESKTOP_GROUP, whose value is a string containing the working directory to run the program in. It is only valid for desktop entries with the `Application` type. - A key under #G_KEY_FILE_DESKTOP_GROUP, whose value is a boolean stating whether the application supports the [Startup Notification Protocol Specification](http://www.freedesktop.org/Standards/startup-notification-spec). - @@ -11433,7 +10840,6 @@ stating whether the application supports the identifying the WM class or name hint of a window that the application will create, which can be used to emulate Startup Notification with older applications. - @@ -11441,7 +10847,6 @@ older applications. stating whether the program should be run in a terminal window. It is only valid for desktop entries with the `Application` type. - @@ -11449,7 +10854,6 @@ It is only valid for desktop entries with the giving the file name of a binary on disk used to determine if the program is actually installed. It is only valid for desktop entries with the `Application` type. - @@ -11458,51 +10862,43 @@ giving the type of the desktop entry. Usually #G_KEY_FILE_DESKTOP_TYPE_APPLICATION, #G_KEY_FILE_DESKTOP_TYPE_LINK, or #G_KEY_FILE_DESKTOP_TYPE_DIRECTORY. - A key under #G_KEY_FILE_DESKTOP_GROUP, whose value is a string giving the URL to access. It is only valid for desktop entries with the `Link` type. - A key under #G_KEY_FILE_DESKTOP_GROUP, whose value is a string giving the version of the Desktop Entry Specification used for the desktop entry file. - The value of the #G_KEY_FILE_DESKTOP_KEY_TYPE, key for desktop entries representing applications. - The value of the #G_KEY_FILE_DESKTOP_KEY_TYPE, key for desktop entries representing directories. - The value of the #G_KEY_FILE_DESKTOP_KEY_TYPE, key for desktop entries representing links to documents. - The GKeyFile struct contains only private data and should not be accessed directly. - Creates a new empty #GKeyFile object. Use g_key_file_load_from_file(), g_key_file_load_from_data(), g_key_file_load_from_dirs() or g_key_file_load_from_data_dirs() to read an existing key file. - an empty #GKeyFile. @@ -11512,7 +10908,6 @@ read an existing key file. Clears all keys and groups from @key_file, and decreases the reference count by 1. If the reference count reaches zero, frees the key file and all its allocated memory. - @@ -11531,7 +10926,6 @@ If @key cannot be found then %FALSE is returned and @error is set to #G_KEY_FILE_ERROR_KEY_NOT_FOUND. Likewise, if the value associated with @key cannot be interpreted as a boolean then %FALSE is returned and @error is set to #G_KEY_FILE_ERROR_INVALID_VALUE. - the value associated with the key as a boolean, or %FALSE if the key was not found or could not be parsed. @@ -11560,7 +10954,6 @@ If @key cannot be found then %NULL is returned and @error is set to #G_KEY_FILE_ERROR_KEY_NOT_FOUND. Likewise, if the values associated with @key cannot be interpreted as booleans then %NULL is returned and @error is set to #G_KEY_FILE_ERROR_INVALID_VALUE. - the values associated with the key as a list of booleans, or %NULL if the @@ -11598,7 +10991,6 @@ If @key is %NULL then @comment will be read from above Note that the returned string does not include the '#' comment markers, but does include any whitespace after them (on each line). It includes the line breaks between lines, but does not include the final line break. - a comment that should be freed with g_free() @@ -11612,7 +11004,7 @@ the line breaks between lines, but does not include the final line break. a group name, or %NULL - + a key @@ -11626,7 +11018,6 @@ If @key cannot be found then 0.0 is returned and @error is set to #G_KEY_FILE_ERROR_KEY_NOT_FOUND. Likewise, if the value associated with @key cannot be interpreted as a double then 0.0 is returned and @error is set to #G_KEY_FILE_ERROR_INVALID_VALUE. - the value associated with the key as a double, or 0.0 if the key was not found or could not be parsed. @@ -11655,7 +11046,6 @@ If @key cannot be found then %NULL is returned and @error is set to #G_KEY_FILE_ERROR_KEY_NOT_FOUND. Likewise, if the values associated with @key cannot be interpreted as doubles then %NULL is returned and @error is set to #G_KEY_FILE_ERROR_INVALID_VALUE. - the values associated with the key as a list of doubles, or %NULL if the @@ -11688,7 +11078,6 @@ and @error is set to #G_KEY_FILE_ERROR_INVALID_VALUE. Returns all groups in the key file loaded with @key_file. The array of returned groups will be %NULL-terminated, so @length may optionally be %NULL. - a newly-allocated %NULL-terminated array of strings. Use g_strfreev() to free it. @@ -11711,7 +11100,6 @@ The array of returned groups will be %NULL-terminated, so 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. - the value associated with the key as a signed 64-bit integer, or 0 if the key was not found or could not be parsed. @@ -11741,7 +11129,6 @@ If @key cannot be found then 0 is returned and @error is set to with @key cannot be interpreted as an integer, or is out of range for a #gint, then 0 is returned and @error is set to #G_KEY_FILE_ERROR_INVALID_VALUE. - the value associated with the key as an integer, or 0 if the key was not found or could not be parsed. @@ -11771,7 +11158,6 @@ If @key cannot be found then %NULL is returned and @error is set to with @key cannot be interpreted as integers, or are out of range for #gint, then %NULL is returned and @error is set to #G_KEY_FILE_ERROR_INVALID_VALUE. - the values associated with the key as a list of integers, or %NULL if @@ -11806,7 +11192,6 @@ returned keys will be %NULL-terminated, so @length may optionally be %NULL. In the event that the @group_name cannot be found, %NULL is returned and @error is set to #G_KEY_FILE_ERROR_GROUP_NOT_FOUND. - a newly-allocated %NULL-terminated array of strings. Use g_strfreev() to free it. @@ -11839,7 +11224,6 @@ g_key_file_get_locale_string_list() with exactly the same @key_file, @group_name, @key and @locale, the result of those functions will have originally been tagged with the locale that is the result of this function. - the locale from the file, or %NULL if the key was not found or the entry in the file was was untranslated @@ -11877,7 +11261,6 @@ If @key cannot be found then %NULL is returned and @error is set to #G_KEY_FILE_ERROR_KEY_NOT_FOUND. If the value associated with @key cannot be interpreted or no suitable translation can be found then the untranslated value is returned. - a newly allocated string or %NULL if the specified key cannot be found. @@ -11917,7 +11300,6 @@ with @key cannot be interpreted or no suitable translations can be found then the untranslated values are returned. The returned array is %NULL-terminated, so @length may optionally be %NULL. - a newly allocated %NULL-terminated string array or %NULL if the key isn't found. The string array should be freed @@ -11951,8 +11333,7 @@ be %NULL. Returns the name of the start group of the file. - - + The start group of the key file. @@ -11972,7 +11353,6 @@ In the event the key cannot be found, %NULL is returned and @error is set to #G_KEY_FILE_ERROR_KEY_NOT_FOUND. In the event that the @group_name cannot be found, %NULL is returned and @error is set to #G_KEY_FILE_ERROR_GROUP_NOT_FOUND. - a newly allocated string or %NULL if the specified key cannot be found. @@ -12000,7 +11380,6 @@ In the event the key cannot be found, %NULL is returned and @error is set to #G_KEY_FILE_ERROR_KEY_NOT_FOUND. In the event that the @group_name cannot be found, %NULL is returned and @error is set to #G_KEY_FILE_ERROR_GROUP_NOT_FOUND. - a %NULL-terminated string array or %NULL if the specified @@ -12032,7 +11411,6 @@ and @error is set to #G_KEY_FILE_ERROR_GROUP_NOT_FOUND. 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. - the value associated with the key as an unsigned 64-bit integer, or 0 if the key was not found or could not be parsed. @@ -12061,7 +11439,6 @@ In the event the key cannot be found, %NULL is returned and @error is set to #G_KEY_FILE_ERROR_KEY_NOT_FOUND. In the event that the @group_name cannot be found, %NULL is returned and @error is set to #G_KEY_FILE_ERROR_GROUP_NOT_FOUND. - a newly allocated string or %NULL if the specified key cannot be found. @@ -12084,7 +11461,6 @@ and @error is set to #G_KEY_FILE_ERROR_GROUP_NOT_FOUND. Looks whether the key file has the group @group_name. - %TRUE if @group_name is a part of @key_file, %FALSE otherwise. @@ -12112,7 +11488,6 @@ whether it is not %NULL to see if an error occurred. Language bindings should use g_key_file_get_value() to test whether or not a key exists. - %TRUE if @key is a part of @group_name, %FALSE otherwise @@ -12135,7 +11510,6 @@ or not a key exists. Loads a key file from the data in @bytes into an empty #GKeyFile structure. If the object cannot be created then %error is set to a #GKeyFileError. - %TRUE if a key file could be loaded, %FALSE otherwise @@ -12158,7 +11532,6 @@ If the object cannot be created then %error is set to a #GKeyFileError. Loads a key file from memory into an empty #GKeyFile structure. If the object cannot be created then %error is set to a #GKeyFileError. - %TRUE if a key file could be loaded, %FALSE otherwise @@ -12188,7 +11561,6 @@ returned from g_get_user_data_dir() and g_get_system_data_dirs(), loads the file into @key_file and returns the file's full path in @full_path. If the file could not be loaded then an %error is set to either a #GFileError or #GKeyFileError. - %TRUE if a key file could be loaded, %FALSE otherwise @@ -12223,7 +11595,6 @@ If the file could not be found in any of the @search_dirs, the file is found but the OS returns an error when opening or reading the file, a %G_FILE_ERROR is returned. If there is a problem parsing the file, a %G_KEY_FILE_ERROR is returned. - %TRUE if a key file could be loaded, %FALSE otherwise @@ -12263,7 +11634,6 @@ If the OS returns an error when opening or reading the file, a This function will never return a %G_KEY_FILE_ERROR_NOT_FOUND error. If the @file is not found, %G_FILE_ERROR_NOENT is returned. - %TRUE if a key file could be loaded, %FALSE otherwise @@ -12285,7 +11655,6 @@ This function will never return a %G_KEY_FILE_ERROR_NOT_FOUND error. If the Increases the reference count of @key_file. - the same @key_file. @@ -12302,7 +11671,6 @@ This function will never return a %G_KEY_FILE_ERROR_NOT_FOUND error. If the If @key is %NULL then @comment will be removed above @group_name. If both @key and @group_name are %NULL, then @comment will be removed above the first group in the file. - %TRUE if the comment was removed, %FALSE otherwise @@ -12325,7 +11693,6 @@ be removed above the first group in the file. Removes the specified group, @group_name, from the key file. - %TRUE if the group was removed, %FALSE otherwise @@ -12343,7 +11710,6 @@ from the key file. Removes @key in @group_name from the key file. - %TRUE if the key was removed, %FALSE otherwise @@ -12371,7 +11737,6 @@ g_file_set_contents_full() with the return value of g_key_file_to_data(). This function can fail for any of the reasons that g_file_set_contents() may fail. - %TRUE if successful, else %FALSE with @error set @@ -12390,7 +11755,6 @@ g_file_set_contents() may fail. Associates a new boolean value with @key under @group_name. If @key cannot be found then it is created. - @@ -12417,7 +11781,6 @@ If @key cannot be found then it is created. Associates a list of boolean values with @key under @group_name. If @key cannot be found then it is created. If @group_name is %NULL, the start_group is used. - @@ -12455,7 +11818,6 @@ written above the first group in the file. Note that this function prepends a '#' comment marker to each line of @comment. - %TRUE if the comment was written, %FALSE otherwise @@ -12482,7 +11844,6 @@ each line of @comment. Associates a new double value with @key under @group_name. If @key cannot be found then it is created. - @@ -12508,7 +11869,6 @@ If @key cannot be found then it is created. Associates a list of double values with @key under @group_name. If @key cannot be found then it is created. - @@ -12540,7 +11900,6 @@ If @key cannot be found then it is created. Associates a new integer value with @key under @group_name. If @key cannot be found then it is created. - @@ -12566,7 +11925,6 @@ If @key cannot be found then it is created. Associates a new integer value with @key under @group_name. If @key cannot be found then it is created. - @@ -12592,7 +11950,6 @@ If @key cannot be found then it is created. Associates a list of integer values with @key under @group_name. If @key cannot be found then it is created. - @@ -12625,7 +11982,6 @@ If @key cannot be found then it is created. Sets the character which is used to separate values in lists. Typically ';' or ',' are used as separators. The default list separator is ';'. - @@ -12643,7 +11999,6 @@ as separators. The default list separator is ';'. Associates a string value for @key and @locale under @group_name. If the translation for @key cannot be found then it is created. - @@ -12674,7 +12029,6 @@ If the translation for @key cannot be found then it is created. Associates a list of string values for @key and @locale under @group_name. If the translation for @key cannot be found then it is created. - @@ -12713,7 +12067,6 @@ If @key cannot be found then it is created. If @group_name cannot be found then it is created. Unlike g_key_file_set_value(), this function handles characters that need escaping, such as newlines. - @@ -12740,7 +12093,6 @@ that need escaping, such as newlines. Associates a list of string values for @key under @group_name. If @key cannot be found then it is created. If @group_name cannot be found then it is created. - @@ -12772,7 +12124,6 @@ If @group_name cannot be found then it is created. Associates a new integer value with @key under @group_name. If @key cannot be found then it is created. - @@ -12802,7 +12153,6 @@ If @key cannot be found then it is created. If @group_name cannot be found then it is created. To set an UTF-8 string which may contain characters that need escaping (such as newlines or spaces), use g_key_file_set_string(). - @@ -12830,7 +12180,6 @@ g_key_file_set_string(). Note that this function never reports an error, so it is safe to pass %NULL as @error. - a newly allocated string holding the contents of the #GKeyFile @@ -12851,7 +12200,6 @@ so it is safe to pass %NULL as @error. Decreases the reference count of @key_file by 1. If the reference count reaches zero, frees the key file and all its allocated memory. - @@ -12870,7 +12218,6 @@ reaches zero, frees the key file and all its allocated memory. Error codes returned by key file parsing. - the text being parsed was in an unknown encoding @@ -12893,7 +12240,6 @@ reaches zero, frees the key file and all its allocated memory. Flags which influence the parsing. - No flags, default behaviour @@ -12918,7 +12264,6 @@ a true value. The compiler may use this information for optimizations. if (G_LIKELY (random () != 1)) g_print ("not one"); ]| - the expression @@ -12928,23 +12273,19 @@ if (G_LIKELY (random () != 1)) Specifies one of the possible types of byte order. See #G_BYTE_ORDER. - The natural logarithm of 10. - The natural logarithm of 2. - Works like g_mutex_lock(), but for a lock defined with #G_LOCK_DEFINE. - the name of the lock @@ -12978,7 +12319,6 @@ Here is an example for using the #G_LOCK convenience macros: return ret_val; } ]| - the name of the lock @@ -12987,7 +12327,6 @@ Here is an example for using the #G_LOCK convenience macros: This works like #G_LOCK_DEFINE, but it creates a static object. - the name of the lock @@ -12997,7 +12336,6 @@ Here is an example for using the #G_LOCK convenience macros: This declares a lock, that is defined with #G_LOCK_DEFINE in another module. - the name of the lock @@ -13005,7 +12343,6 @@ module. - @@ -13013,7 +12350,6 @@ module. Multiplying the base 2 exponent by this number yields the base 10 exponent. - @@ -13040,7 +12376,6 @@ AM_CPPFLAGS = -DG_LOG_DOMAIN=\"Gtk\" Applications can choose to leave it as the default %NULL (or `""`) domain. However, defining the domain offers the same advantages as above. - @@ -13048,18 +12383,15 @@ above. This is not used if structured logging is enabled; see [Using Structured Logging][using-structured-logging]. - Log levels below 1<<G_LOG_LEVEL_USER_SHIFT are used by GLib. Higher bits can be used for user-defined log levels. - The #GList struct is used for each element in a doubly-linked list. - holds the element's data, which can be a pointer to any kind of data, or any integer value using the @@ -13082,7 +12414,6 @@ Higher bits can be used for user-defined log levels. Allocates space for one #GList element. It is called by g_list_append(), g_list_prepend(), g_list_insert() and g_list_insert_sorted() and so is rarely used on its own. - a pointer to the newly-allocated #GList element @@ -13113,7 +12444,6 @@ string_list = g_list_append (string_list, "second"); number_list = g_list_append (number_list, GINT_TO_POINTER (27)); number_list = g_list_append (number_list, GINT_TO_POINTER (14)); ]| - either @list or the new start of the #GList if @list was %NULL @@ -13144,7 +12474,6 @@ The following example moves an element to the top of the list: list = g_list_remove_link (list, llink); list = g_list_concat (llink, list); ]| - the start of the new #GList, which equals @list1 if not %NULL @@ -13174,7 +12503,6 @@ Note that this is a "shallow" copy. If the list elements consist of pointers to data, the pointers are copied but the actual data is not. See g_list_copy_deep() if you need to copy the data as well. - the start of the new list that holds the same data as @list @@ -13212,7 +12540,6 @@ And, to entirely free the new list, you could do: |[<!-- language="C" --> g_list_free_full (another_list, g_object_unref); ]| - the start of the new list that holds a full copy of @list, use g_list_free_full() to free it @@ -13241,7 +12568,6 @@ g_list_free_full (another_list, g_object_unref); Removes the node link_ from the list and frees it. Compare this to g_list_remove_link() which removes the node without freeing it. - the (possibly changed) start of the #GList @@ -13265,7 +12591,6 @@ without freeing it. Finds the element in a #GList which contains the given data. - the found #GList element, or %NULL if it is not found @@ -13292,7 +12617,6 @@ the given function which should return 0 when the desired element is found. The function takes two #gconstpointer arguments, the #GList element's data as the first argument and the given user data. - the found #GList element, or %NULL if it is not found @@ -13319,7 +12643,6 @@ given user data. Gets the first element in a #GList. - the first element in the #GList, or %NULL if the #GList has no elements @@ -13341,7 +12664,6 @@ given user data. It is safe for @func to remove the element from @list, but it must not modify any part of the list after that element. - @@ -13375,13 +12697,12 @@ is not left dangling: GList *list_of_borrowed_things = …; /<!-- -->* (transfer container) *<!-- -->/ g_list_free (g_steal_pointer (&list_of_borrowed_things)); ]| - - a #GList + the first link of a #GList @@ -13394,7 +12715,6 @@ previous elements in the list, so you should not call this function on an element that is currently part of a list. It is usually used after g_list_remove_link(). - @@ -13422,13 +12742,12 @@ from @free_func: GList *list_of_owned_things = …; /<!-- -->* (transfer full) (element-type GObject) *<!-- -->/ g_list_free_full (g_steal_pointer (&list_of_owned_things), g_object_unref); ]| - - a pointer to a #GList + the first link of a #GList @@ -13442,7 +12761,6 @@ g_list_free_full (g_steal_pointer (&list_of_owned_things), g_object_unref); Gets the position of the element containing the given data (starting from 0). - the index of the element containing the data, or -1 if the data is not found @@ -13463,7 +12781,6 @@ the given data (starting from 0). Inserts a new element into the list at the given position. - the (possibly changed) start of the #GList @@ -13491,7 +12808,6 @@ the given data (starting from 0). Inserts a new element into the list before the given position. - the (possibly changed) start of the #GList @@ -13520,7 +12836,6 @@ the given data (starting from 0). Inserts @link_ into the list before the given position. - the (possibly changed) start of the #GList @@ -13558,7 +12873,6 @@ If you are adding many new elements to a list, and the number of new elements is much larger than the length of the list, use g_list_prepend() to add the new items and sort the list afterwards with g_list_sort(). - the (possibly changed) start of the #GList @@ -13593,7 +12907,6 @@ If you are adding many new elements to a list, and the number of new elements is much larger than the length of the list, use g_list_prepend() to add the new items and sort the list afterwards with g_list_sort(). - the (possibly changed) start of the #GList @@ -13626,7 +12939,6 @@ with g_list_sort(). Gets the last element in a #GList. - the last element in the #GList, or %NULL if the #GList has no elements @@ -13650,7 +12962,6 @@ 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. To check whether the list is non-empty, it is faster to check @list against %NULL. - the number of elements in the #GList @@ -13670,7 +12981,6 @@ of items. To check whether the list is non-empty, it is faster to check This iterates over the list until it reaches the @n-th position. If you intend to iterate over every element, it is better to use a for-loop as described in the #GList introduction. - the element, or %NULL if the position is off the end of the #GList @@ -13697,7 +13007,6 @@ described in the #GList introduction. This iterates over the list until it reaches the @n-th position. If you intend to iterate over every element, it is better to use a for-loop as described in the #GList introduction. - the element's data, or %NULL if the position is off the end of the #GList @@ -13718,7 +13027,6 @@ described in the #GList introduction. Gets the element @n places before @list. - the element, or %NULL if the position is off the end of the #GList @@ -13742,7 +13050,6 @@ described in the #GList introduction. Gets the position of the given element in the #GList (starting from 0). - the position of the element in the #GList, or -1 if the element is not found @@ -13779,7 +13086,6 @@ list = g_list_prepend (list, "first"); Do not use this function to prepend a new element to a different element than the start of the list. Use g_list_insert_before() instead. - a pointer to the newly prepended element, which is the new start of the #GList @@ -13804,7 +13110,6 @@ element than the start of the list. Use g_list_insert_before() instead. Removes an element from a #GList. If two elements contain the same data, only the first is removed. If none of the elements contain the data, the #GList is unchanged. - the (possibly changed) start of the #GList @@ -13829,7 +13134,6 @@ If none of the elements contain the data, the #GList is unchanged. Returns the new head of the list. Contrast with g_list_remove() which removes only the first node matching the given data. - the (possibly changed) start of the #GList @@ -13862,7 +13166,6 @@ list = g_list_remove_link (list, llink); free_some_data_that_may_access_the_list_again (llink->data); g_list_free (llink); ]| - the (possibly changed) start of the #GList @@ -13887,7 +13190,6 @@ g_list_free (llink); Reverses a #GList. It simply switches the next and prev pointers of each element. - the start of the reversed #GList @@ -13906,7 +13208,6 @@ It simply switches the next and prev pointers of each element. Sorts a #GList using the given comparison function. The algorithm used is a stable sort. - the (possibly changed) start of the #GList @@ -13933,7 +13234,6 @@ used is a stable sort. Like g_list_sort(), but the comparison function accepts a user data argument. - the (possibly changed) start of the #GList @@ -13966,7 +13266,6 @@ Log fields may contain arbitrary values, including binary with embedded nul bytes. If the field contains a string, the string must be UTF-8 encoded and have a trailing nul byte. Otherwise, @length must be set to a non-negative value. - field name (UTF-8 string) @@ -13991,7 +13290,6 @@ log handler is changed. This is not used if structured logging is enabled; see [Using Structured Logging][using-structured-logging]. - @@ -14020,7 +13318,6 @@ This is not used if structured logging is enabled; see It is possible to change how GLib treats messages of the various levels using g_log_set_handler() and g_log_set_fatal_mask(). - internal flag @@ -14072,7 +13369,6 @@ error handling the message (for example, if the writer function is meant to send messages to a remote logging server and there is a network error), it should return %G_LOG_WRITER_UNHANDLED. This allows writer functions to be chained and fall back to simpler handlers in case of failure. - %G_LOG_WRITER_HANDLED if the log entry was handled successfully; %G_LOG_WRITER_UNHANDLED otherwise @@ -14106,7 +13402,6 @@ handling it (and hence a fallback writer should be used). If a #GLogWriterFunc ignores a log entry, it should return %G_LOG_WRITER_HANDLED. - Log writer has handled the log entry. @@ -14120,76 +13415,62 @@ If a #GLogWriterFunc ignores a log entry, it should return Like #glib_major_version, but from the headers used at application compile time, rather than from the library linked against at application run time. - The maximum value which can be held in a #gint16. - The maximum value which can be held in a #gint32. - The maximum value which can be held in a #gint64. - The maximum value which can be held in a #gint8. - The maximum value which can be held in a #guint16. - The maximum value which can be held in a #guint32. - The maximum value which can be held in a #guint64. - The maximum value which can be held in a #guint8. - - + The micro version number of the GLib library. Like #gtk_micro_version, but from the headers used at application compile time, rather than from the library linked against at application run time. - The minimum value which can be held in a #gint16. - The minimum value which can be held in a #gint32. - The minimum value which can be held in a #gint64. - The minimum value which can be held in a #gint8. - @@ -14198,20 +13479,16 @@ linked against at application run time. Like #gtk_minor_version, but from the headers used at application compile time, rather than from the library linked against at application run time. - - The `GMainContext` struct is an opaque data type representing a set of sources to be handled in a main loop. - Creates a new #GMainContext structure. - the new #GMainContext @@ -14228,7 +13505,6 @@ is called as many times as g_main_context_acquire(). You must be the owner of a context before you can call g_main_context_prepare(), g_main_context_query(), g_main_context_check(), g_main_context_dispatch(). - %TRUE if the operation succeeded, and this thread is now the owner of @context. @@ -14245,7 +13521,6 @@ g_main_context_check(), g_main_context_dispatch(). Adds a file descriptor to the set of file descriptors polled for this context. This will very seldom be used directly. Instead a typical event source will use g_source_add_unix_fd() instead. - @@ -14268,11 +13543,13 @@ a typical event source will use g_source_add_unix_fd() instead. - Passes the results of polling back to the main loop. + Passes the results of polling back to the main loop. You should be +careful to pass @fds and its length @n_fds as received from +g_main_context_query(), as this functions relies on assumptions +on how @fds is filled. You must have successfully acquired the context with g_main_context_acquire() before you may call this function. - %TRUE if some sources are ready to be dispatched. @@ -14304,7 +13581,6 @@ g_main_context_acquire() before you may call this function. You must have successfully acquired the context with g_main_context_acquire() before you may call this function. - @@ -14319,7 +13595,6 @@ g_main_context_acquire() before you may call this function. Finds a source with the given source functions and user data. If multiple sources exist with the same source function and user data, the first one found will be returned. - the source, if one was found, otherwise %NULL @@ -14352,7 +13627,6 @@ idle may already have run and been removed by the time this function is called on its (now invalid) source ID. This source ID may have been reissued, leading to the operation being performed against the wrong source. - the #GSource @@ -14372,7 +13646,6 @@ wrong source. Finds a source with the given user data for the callback. If multiple sources exist with the same user data, the first one found will be returned. - the source, if one was found, otherwise %NULL @@ -14390,7 +13663,6 @@ one found will be returned. Gets the poll function set by g_main_context_set_poll_func(). - the poll function @@ -14424,7 +13696,6 @@ g_main_context_invoke_full(). Note that, as with normal idle functions, @function should probably return %FALSE. If it returns %TRUE, it will be continuously run in a loop (and may prevent this call from returning). - @@ -14453,7 +13724,6 @@ scheduled as an idle and also lets you give a #GDestroyNotify for @data. @notify should not assume that it is called from any particular thread or with any particular context acquired. - @@ -14485,7 +13755,6 @@ thread or with any particular context acquired. ownership of this #GMainContext. This is useful to know before waiting on another thread that may be blocking to get ownership of @context. - %TRUE if current thread is owner of @context. @@ -14510,7 +13779,6 @@ given moment without further waiting. Note that even when @may_block is %TRUE, it is still possible for g_main_context_iteration() to return %FALSE, since the wait may be interrupted for other reasons than an event source becoming ready. - %TRUE if events were dispatched. @@ -14528,7 +13796,6 @@ be interrupted for other reasons than an event source becoming ready. Checks if any sources have pending events for the given context. - %TRUE if events are pending. @@ -14543,7 +13810,6 @@ be interrupted for other reasons than an event source becoming ready. Pops @context off the thread-default context stack (verifying that it was on the top of the stack). - @@ -14560,7 +13826,6 @@ for polling is determined by calling g_main_context_query (). You must have successfully acquired the context with g_main_context_acquire() before you may call this function. - %TRUE if some source is ready to be dispatched prior to polling. @@ -14617,7 +13882,6 @@ started while the non-default context is active. Beware that libraries that predate this function may not correctly handle being used from a thread with a thread-default context. Eg, see g_file_supports_thread_contexts(). - @@ -14629,11 +13893,13 @@ see g_file_supports_thread_contexts(). - Determines information necessary to poll this main loop. + Determines information necessary to poll this main loop. You should +be careful to pass the resulting @fds array and its length @n_fds +as is when calling g_main_context_check(), as this function relies +on assumptions made when the array is filled. You must have successfully acquired the context with g_main_context_acquire() before you may call this function. - the number of records actually stored in @fds, or, if more than @n_fds records need to be stored, the number @@ -14668,7 +13934,6 @@ g_main_context_acquire() before you may call this function. Increases the reference count on a #GMainContext object by one. - the @context that was passed in (since 2.6) @@ -14685,7 +13950,6 @@ g_main_context_acquire() before you may call this function. with g_main_context_acquire(). If the context was acquired multiple times, the ownership will be released only when g_main_context_release() is called as many times as it was acquired. - @@ -14699,7 +13963,6 @@ is called as many times as it was acquired. Removes file descriptor from the set of file descriptors to be polled for a particular context. - @@ -14722,7 +13985,6 @@ poll() isn't available). This function could possibly be used to integrate the GLib event loop with an external event loop. - @@ -14740,7 +14002,6 @@ loop with an external event loop. Decreases the reference count on a #GMainContext object by one. If the result is zero, free the context and free all associated memory. - @@ -14758,7 +14019,6 @@ is the owner, atomically drop @mutex and wait on @cond until that owner releases ownership or until @cond is signaled, then try again (once) to become the owner. Use g_main_context_is_owner() and separate locking instead. - %TRUE if the operation succeeded, and this thread is now the owner of @context. @@ -14794,7 +14054,7 @@ loop with a termination condition, computed from multiple threads: |[<!-- language="C" --> #define NUM_TASKS 10 - static volatile gint tasks_remaining = NUM_TASKS; + static gint tasks_remaining = NUM_TASKS; // (atomic) ... while (g_atomic_int_get (&tasks_remaining) != 0) @@ -14808,7 +14068,6 @@ Then in a thread: if (g_atomic_int_dec_and_test (&tasks_remaining)) g_main_context_wakeup (NULL); ]| - @@ -14824,7 +14083,6 @@ Then in a thread: used for main loop functions when a main loop is not explicitly specified, and corresponds to the "main" main loop. See also g_main_context_get_thread_default(). - the global default main context. @@ -14842,8 +14100,7 @@ always return %NULL if you are running in the default thread.) If you need to hold a reference on the context, use g_main_context_ref_thread_default() instead. - - + the thread-default #GMainContext, or %NULL if the thread-default context is the global default context. @@ -14856,7 +14113,6 @@ it with g_main_context_ref(). In addition, unlike g_main_context_get_thread_default(), if the thread-default context is the global default context, this will return that #GMainContext (with a ref added to it) rather than returning %NULL. - the thread-default #GMainContext. Unref with g_main_context_unref() when you are done with it. @@ -14867,10 +14123,8 @@ is the global default context, this will return that #GMainContext The `GMainLoop` struct is an opaque data type representing the main event loop of a GLib or GTK+ application. - Creates a new #GMainLoop structure. - a new #GMainLoop. @@ -14890,7 +14144,6 @@ is not very important since calling g_main_loop_run() will set this to Returns the #GMainContext of @loop. - the #GMainContext of @loop @@ -14904,7 +14157,6 @@ is not very important since calling g_main_loop_run() will set this to Checks to see if the main loop is currently being run via g_main_loop_run(). - %TRUE if the mainloop is currently being run. @@ -14922,7 +14174,6 @@ for the loop will return. Note that sources that have already been dispatched when g_main_loop_quit() is called will still be executed. - @@ -14935,7 +14186,6 @@ g_main_loop_quit() is called will still be executed. Increases the reference count on a #GMainLoop object by one. - @loop @@ -14952,7 +14202,6 @@ g_main_loop_quit() is called will still be executed. If this is called for the thread of the loop's #GMainContext, it will process events from the loop, otherwise it will simply wait. - @@ -14966,7 +14215,6 @@ simply wait. Decreases the reference count on a #GMainLoop object by one. If the result is zero, free the loop and free all associated memory. - @@ -14982,7 +14230,6 @@ the result is zero, free the loop and free all associated memory. The #GMappedFile represents a file mapping created with g_mapped_file_new(). It has only private members and should not be accessed directly. - Maps a file into memory. On UNIX, this is using the mmap() function. @@ -15000,7 +14247,6 @@ If @filename is the name of an empty, regular file, the function will successfully return an empty #GMappedFile. In other cases of size 0 (e.g. device files such as /dev/null), @error will be set to the #GFileError value #G_FILE_ERROR_INVAL. - a newly allocated #GMappedFile which must be unref'd with g_mapped_file_unref(), or %NULL if the mapping failed. @@ -15030,7 +14276,6 @@ Note that modifications of the underlying file might affect the contents of the #GMappedFile. Therefore, mapping should only be used if the file will not be modified, or if all modifications of the file are done atomically (e.g. using g_file_set_contents()). - a newly allocated #GMappedFile which must be unref'd with g_mapped_file_unref(), or %NULL if the mapping failed. @@ -15051,7 +14296,6 @@ atomically (e.g. using g_file_set_contents()). This call existed before #GMappedFile had refcounting and is currently exactly the same as g_mapped_file_unref(). Use g_mapped_file_unref() instead. - @@ -15066,7 +14310,6 @@ exactly the same as g_mapped_file_unref(). Creates a new #GBytes which references the data mapped from @file. The mapped contents of the file must not be modified after creating this bytes object, because a #GBytes should be immutable. - A newly allocated #GBytes referencing data from @file @@ -15086,7 +14329,6 @@ Note that the contents may not be zero-terminated, even if the #GMappedFile is backed by a text file. If the file is empty then %NULL is returned. - the contents of @file, or %NULL. @@ -15100,7 +14342,6 @@ If the file is empty then %NULL is returned. Returns the length of the contents of a #GMappedFile. - the length of the contents of @file. @@ -15115,7 +14356,6 @@ If the file is empty then %NULL is returned. Increments the reference count of @file by one. It is safe to call this function from any thread. - the passed in #GMappedFile. @@ -15134,7 +14374,6 @@ drops to 0, unmaps the buffer of @file and frees it. It is safe to call this function from any thread. Since 2.22 - @@ -15153,7 +14392,6 @@ bitwise OR the type with the flag %G_MARKUP_COLLECT_OPTIONAL. It is likely that this enum will be extended in the future to support other types. - used to terminate the list of attributes to collect @@ -15190,7 +14428,6 @@ support other types. Error codes returned by markup parsing. - text being parsed was not valid UTF-8 @@ -15223,14 +14460,12 @@ you expect to contain marked-up text. See g_markup_parse_context_new(), #GMarkupParser, and so on for more details. - Creates a new parse context. A parse context is used to parse marked-up documents. You can feed any number of documents into a context, as long as no errors occur; once an error occurs, the parse context can't continue to parse text (you have to free it and create a new parse context). - a new #GMarkupParseContext @@ -15261,7 +14496,6 @@ fed into the parse context with g_markup_parse_context_parse(). This function reports an error if the document isn't complete, for example if elements are still open. - %TRUE on success, %FALSE if an error was set @@ -15278,7 +14512,6 @@ for example if elements are still open. This function can't be called from inside one of the #GMarkupParser functions or while a subparser is pushed. - @@ -15295,7 +14528,6 @@ This function can't be called from inside one of the If called from the start_element or end_element handlers this will give the element_name as passed to those functions. For the parent elements, see g_markup_parse_context_get_element_stack(). - the name of the currently open element, or %NULL @@ -15319,7 +14551,6 @@ This function is intended to be used in the start_element and end_element handlers where g_markup_parse_context_get_element() would merely return the name of the element that is being processed. - the element stack, which must not be modified @@ -15338,7 +14569,6 @@ processed. that line. Intended for use in error messages; there are no strict semantics for what constitutes the "current" line number other than "the best number we could come up with for error messages." - @@ -15363,7 +14593,6 @@ semantics for what constitutes the "current" line number other than This will either be the user_data that was provided to g_markup_parse_context_new() or to the most recent call of g_markup_parse_context_push(). - the provided user_data. The returned data belongs to the markup context and will be freed when @@ -15388,7 +14617,6 @@ connection or file, you feed each received chunk of data into this function, aborting the process if an error occurs. Once an error is reported, no further data may be fed to the #GMarkupParseContext; all errors are fatal. - %FALSE if an error occurred, %TRUE on success @@ -15422,7 +14650,6 @@ This function is not intended to be directly called by users interested in invoking subparsers. Instead, it is intended to be used by the subparsers themselves to implement a higher-level interface. - the user data passed to g_markup_parse_context_push() @@ -15549,7 +14776,6 @@ static void end_element (context, element_name, ...) // else, handle other tags... } ]| - @@ -15570,7 +14796,6 @@ static void end_element (context, element_name, ...) Increases the reference count of @context. - the same @context @@ -15585,7 +14810,6 @@ static void end_element (context, element_name, ...) Decreases the reference count of @context. When its reference count drops to 0, it is freed. - @@ -15599,7 +14823,6 @@ drops to 0, it is freed. Flags that affect the behaviour of the parser. - flag you should not use @@ -15632,10 +14855,8 @@ can set an error; in particular the %G_MARKUP_ERROR_UNKNOWN_ELEMENT, errors are intended to be set from these callbacks. If you set an error from a callback, g_markup_parse_context_parse() will report that error back to its caller. - - @@ -15660,7 +14881,6 @@ back to its caller. - @@ -15679,7 +14899,6 @@ back to its caller. - @@ -15701,7 +14920,6 @@ back to its caller. - @@ -15723,7 +14941,6 @@ back to its caller. - @@ -15744,7 +14961,6 @@ back to its caller. A GMatchInfo is an opaque struct used to return information about matches. - Returns a new string containing the text in @string_to_expand with references and escape sequences expanded. References refer to the last @@ -15763,7 +14979,6 @@ pattern and '\n' merely will be replaced with \n character, while to expand "\0" (whole match) one needs the result of a match. Use g_regex_check_replacement() to find out whether @string_to_expand contains references. - the expanded string, or %NULL if an error occurred @@ -15796,7 +15011,6 @@ substring. Substrings are matched in reverse order of length, so The string is fetched from the string passed to the match function, so you cannot call this function after freeing the string. - The matched substring, or %NULL if an error occurred. You have to free the string yourself @@ -15830,7 +15044,6 @@ so the first one is the longest match. The strings are fetched from the string passed to the match function, so you cannot call this function after freeing the string. - a %NULL-terminated array of gchar * pointers. It must be freed using g_strfreev(). If the previous @@ -15855,7 +15068,6 @@ then an empty string is returned. The string is fetched from the string passed to the match function, so you cannot call this function after freeing the string. - The matched substring, or %NULL if an error occurred. You have to free the string yourself @@ -15878,7 +15090,6 @@ so you cannot call this function after freeing the string. If @name is a valid sub pattern name but it didn't match anything (e.g. sub pattern "X", matching "b" against "(?P<X>a)?b") then @start_pos and @end_pos are set to -1 and %TRUE is returned. - %TRUE if the position was fetched, %FALSE otherwise. If the position cannot be fetched, @start_pos and @end_pos @@ -15920,7 +15131,6 @@ g_regex_match_all() or g_regex_match_all_full(), the retrieved position is not that of a set of parentheses but that of a matched substring. Substrings are matched in reverse order of length, so 0 is the longest match. - %TRUE if the position was fetched, %FALSE otherwise. If the position cannot be fetched, @start_pos and @end_pos are left @@ -15951,7 +15161,6 @@ substring. Substrings are matched in reverse order of length, so If @match_info is not %NULL, calls g_match_info_unref(); otherwise does nothing. - @@ -15971,7 +15180,6 @@ If the last match was obtained using the DFA algorithm, that is using g_regex_match_all() or g_regex_match_all_full(), the retrieved count is not that of the number of capturing parentheses but that of the number of matched substrings. - Number of matched substrings, or -1 if an error occurred @@ -15987,7 +15195,6 @@ the number of matched substrings. Returns #GRegex object used in @match_info. It belongs to Glib and must not be freed. Use g_regex_ref() if you need to keep it after you free @match_info object. - #GRegex object used in @match_info @@ -16003,7 +15210,6 @@ after you free @match_info object. Returns the string searched with @match_info. This is the string passed to g_regex_match() or g_regex_replace() so you may not free it before calling this function. - the string searched with @match_info @@ -16049,7 +15255,6 @@ There were formerly some restrictions on the pattern for partial matching. The restrictions no longer apply. See pcrepartial(3) for more information on partial matching. - %TRUE if the match was partial, %FALSE otherwise @@ -16063,7 +15268,6 @@ See pcrepartial(3) for more information on partial matching. Returns whether the previous match operation succeeded. - %TRUE if the previous match operation succeeded, %FALSE otherwise @@ -16083,7 +15287,6 @@ call to g_regex_match_full() or g_regex_match() that returned The match is done on the string passed to the match function, so you cannot free it before calling this function. - %TRUE is the string matched, %FALSE otherwise @@ -16097,7 +15300,6 @@ cannot free it before calling this function. Increases reference count of @match_info by 1. - @match_info @@ -16112,7 +15314,6 @@ cannot free it before calling this function. Decreases reference count of @match_info by 1. When reference count drops to zero, it frees all the memory associated with the match_info structure. - @@ -16130,10 +15331,8 @@ be used for all allocations in the same program; a call to g_mem_set_vtable(), if it exists, should be prior to any use of GLib. This functions related to this has been deprecated in 2.46, and no longer work. - - @@ -16146,7 +15345,6 @@ This functions related to this has been deprecated in 2.46, and no longer work.< - @@ -16162,7 +15360,6 @@ This functions related to this has been deprecated in 2.46, and no longer work.< - @@ -16175,7 +15372,6 @@ This functions related to this has been deprecated in 2.46, and no longer work.< - @@ -16191,7 +15387,6 @@ This functions related to this has been deprecated in 2.46, and no longer work.< - @@ -16204,7 +15399,6 @@ This functions related to this has been deprecated in 2.46, and no longer work.< - @@ -16264,7 +15458,6 @@ If a #GMutex is placed in other contexts (eg: embedded in a struct) then it must be explicitly initialised using g_mutex_init(). A #GMutex should only be accessed via g_mutex_ functions. - @@ -16283,7 +15476,6 @@ Calling g_mutex_clear() on a locked mutex leads to undefined behaviour. Sine: 2.32 - @@ -16319,7 +15511,6 @@ needed, use g_mutex_clear(). Calling g_mutex_init() on an already initialized #GMutex leads to undefined behaviour. - @@ -16339,7 +15530,6 @@ thread. non-recursive. As such, calling g_mutex_lock() on a #GMutex that has already been locked by the same thread results in undefined behaviour (including but not limited to deadlocks). - @@ -16359,7 +15549,6 @@ it immediately returns %FALSE. Otherwise it locks @mutex and returns non-recursive. As such, calling g_mutex_lock() on a #GMutex that has already been locked by the same thread results in undefined behaviour (including but not limited to deadlocks or arbitrary return values). - %TRUE if @mutex could be locked @@ -16377,7 +15566,6 @@ call for @mutex, it will become unblocked and can lock @mutex itself. Calling g_mutex_unlock() on a mutex that is not locked by the current thread leads to undefined behaviour. - @@ -16391,7 +15579,6 @@ current thread leads to undefined behaviour. Returns %TRUE if a #GNode is a leaf node. - a #GNode @@ -16400,7 +15587,6 @@ current thread leads to undefined behaviour. Returns %TRUE if a #GNode is the root of a tree. - a #GNode @@ -16412,7 +15598,6 @@ current thread leads to undefined behaviour. declared so the compiler knows its size at compile-time; this macro will not work on an array allocated on the heap, only static arrays or arrays on the stack. - the array @@ -16421,7 +15606,6 @@ arrays or arrays on the stack. The #GNode struct represents one node in a [n-ary tree][glib-N-ary-Trees]. - contains the actual data of the node. @@ -16449,7 +15633,6 @@ arrays or arrays on the stack. Gets the position of the first child of a #GNode which contains the given data. - the index of the child of @node which contains @data, or -1 if the data is not found @@ -16470,7 +15653,6 @@ which contains the given data. Gets the position of a #GNode with respect to its siblings. @child must be a child of @node. The first child is numbered 0, the second 1, and so on. - the position of @child with respect to its siblings @@ -16490,7 +15672,6 @@ the second 1, and so on. Calls a function for each of the children of a #GNode. Note that it doesn't descend beneath the child nodes. @func must not do anything that would modify the structure of the tree. - @@ -16517,7 +15698,6 @@ that would modify the structure of the tree. Recursively copies a #GNode (but does not deep-copy the data inside the nodes, see g_node_copy_deep() if you need that). - a new #GNode containing the same data pointers @@ -16531,7 +15711,6 @@ nodes, see g_node_copy_deep() if you need that). Recursively copies a #GNode and its data. - a new #GNode containing copies of the data in @node. @@ -16557,7 +15736,6 @@ nodes, see g_node_copy_deep() if you need that). If @node is %NULL the depth is 0. The root node has a depth of 1. For the children of the root node the depth is 2. And so on. - the depth of the #GNode @@ -16572,7 +15750,6 @@ For the children of the root node the depth is 2. And so on. Removes @root and its children from the tree, freeing any memory allocated. - @@ -16585,7 +15762,6 @@ allocated. Finds a #GNode in a tree. - the found #GNode, or %NULL if the data is not found @@ -16613,7 +15789,6 @@ allocated. Finds the first child of a #GNode with the given data. - the found child #GNode, or %NULL if the data is not found @@ -16637,7 +15812,6 @@ allocated. Gets the first sibling of a #GNode. This could possibly be the node itself. - the first sibling of @node @@ -16651,7 +15825,6 @@ This could possibly be the node itself. Gets the root of a tree. - the root of the tree @@ -16665,7 +15838,6 @@ This could possibly be the node itself. Inserts a #GNode beneath the parent at the given position. - the inserted #GNode @@ -16688,7 +15860,6 @@ This could possibly be the node itself. Inserts a #GNode beneath the parent after the given sibling. - the inserted #GNode @@ -16711,7 +15882,6 @@ This could possibly be the node itself. Inserts a #GNode beneath the parent before the given sibling. - the inserted #GNode @@ -16736,7 +15906,6 @@ This could possibly be the node itself. Returns %TRUE if @node is an ancestor of @descendant. This is true if node is the parent of @descendant, or if node is the grandparent of @descendant etc. - %TRUE if @node is an ancestor of @descendant @@ -16754,7 +15923,6 @@ or if node is the grandparent of @descendant etc. Gets the last child of a #GNode. - the last child of @node, or %NULL if @node has no children @@ -16769,7 +15937,6 @@ or if node is the grandparent of @descendant etc. Gets the last sibling of a #GNode. This could possibly be the node itself. - the last sibling of @node @@ -16787,7 +15954,6 @@ This is the maximum distance from the #GNode to all leaf nodes. If @root is %NULL, 0 is returned. If @root has no children, 1 is returned. If @root has children, 2 is returned. And so on. - the maximum height of the tree beneath @root @@ -16801,7 +15967,6 @@ If @root is %NULL, 0 is returned. If @root has no children, Gets the number of children of a #GNode. - the number of children of @node @@ -16815,7 +15980,6 @@ If @root is %NULL, 0 is returned. If @root has no children, Gets the number of nodes in a tree. - the number of nodes in the tree @@ -16836,7 +16000,6 @@ If @root is %NULL, 0 is returned. If @root has no children, Gets a child of a #GNode, using the given index. The first child is at index 0. If the index is too big, %NULL is returned. - the child of @node at index @n @@ -16854,7 +16017,6 @@ too big, %NULL is returned. Inserts a #GNode as the first child of the given parent. - the inserted #GNode @@ -16873,7 +16035,6 @@ too big, %NULL is returned. Reverses the order of the children of a #GNode. (It doesn't change the order of the grandchildren.) - @@ -16889,7 +16050,6 @@ too big, %NULL is returned. It calls the given function for each node visited. The traversal can be halted at any point by returning %TRUE from @func. @func must not do anything that would modify the structure of the tree. - @@ -16927,7 +16087,6 @@ The traversal can be halted at any point by returning %TRUE from @func. Unlinks a #GNode from a tree, resulting in two separate trees. - @@ -16941,7 +16100,6 @@ The traversal can be halted at any point by returning %TRUE from @func. Creates a new #GNode containing the given data. Used to create the first node in a tree. - a new #GNode @@ -16958,7 +16116,6 @@ Used to create the first node in a tree. Specifies the type of function passed to g_node_children_foreach(). The function is called with each child node, together with the user data passed to g_node_children_foreach(). - @@ -16978,7 +16135,6 @@ data passed to g_node_children_foreach(). function is called with each of the nodes visited, together with the user data passed to g_node_traverse(). If the function returns %TRUE, then the traversal is stopped. - %TRUE to stop the traversal. @@ -17000,7 +16156,6 @@ form, standardizing such issues as whether a character with an accent is represented as a base character and combining accent or as a single precomposed character. Unicode strings should generally be normalized before comparing them. - standardize differences that do not affect the text content, such as the above-mentioned accent representation @@ -17035,7 +16190,6 @@ should generally be normalized before comparing them. Error codes returned by functions converting a string to a number. - String was not a valid number. @@ -17054,14 +16208,12 @@ or %G_OPTION_ARG_FILENAME_ARRAY. Using #G_OPTION_REMAINING instead of simply scanning `argv` for leftover arguments has the advantage that GOption takes care of necessary encoding conversions for strings or filenames. - A #GOnce struct controls a one-time initialization function. Any one-time initialization function must have its own unique #GOnce struct. - the status of the #GOnce @@ -17072,7 +16224,6 @@ struct. - @@ -17110,8 +16261,10 @@ like this: } // use initialization_value here -]| - +]| + +While @location has a `volatile` qualifier, this is a historical artifact and +the pointer passed to it should not be `volatile`. %TRUE if the initialization section should be entered, %FALSE and blocks otherwise @@ -17130,8 +16283,10 @@ like this: 0-initialized initialization variable, and an initialization value other than 0. Sets the variable to the initialization value, and releases concurrent threads blocking in g_once_init_enter() on this -initialization variable. - +initialization variable. + +While @location has a `volatile` qualifier, this is a historical artifact and +the pointer passed to it should not be `volatile`. @@ -17151,7 +16306,6 @@ initialization variable. The possible statuses of a one-time initialization function controlled by a #GOnce struct. - the function has not been called yet. @@ -17167,7 +16321,6 @@ controlled by a #GOnce struct. options expect to find. If an option expects an extra argument, it can be specified in several ways; with a short option: `-x arg`, with a long option: `--name arg` or combined in a single argument: `--name=arg`. - No extra argument. This is useful for simple flags. @@ -17208,7 +16361,6 @@ option: `--name arg` or combined in a single argument: `--name=arg`. The type of function to be passed as callback for %G_OPTION_ARG_CALLBACK options. - %TRUE if the option was successfully parsed, %FALSE if an error occurred, in which case @error should be set with g_set_error() @@ -17236,12 +16388,10 @@ options. A `GOptionContext` struct defines which options are accepted by the commandline option parser. The struct has only private fields and should not be directly accessed. - Adds a #GOptionGroup to the @context, so that parsing with @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. - @@ -17259,7 +16409,6 @@ ownership of the @group and thus the @group should not be freed. A convenience function which creates a main group if it doesn't exist, adds the @entries to it and sets the translation domain. - @@ -17288,7 +16437,6 @@ added to it. Please note that parsed arguments need to be freed separately (see #GOptionEntry). - @@ -17301,7 +16449,6 @@ Please note that parsed arguments need to be freed separately (see Returns the description. See g_option_context_set_description(). - the description @@ -17321,7 +16468,6 @@ To obtain the text produced by `--help-all`, call `g_option_context_get_help (context, FALSE, NULL)`. To obtain the help text for an option group, call `g_option_context_get_help (context, FALSE, group)`. - A newly allocated string containing the help text @@ -17344,7 +16490,6 @@ To obtain the help text for an option group, call Returns whether automatic `--help` generation is turned on for @context. See g_option_context_set_help_enabled(). - %TRUE if automatic help generation is turned on. @@ -17359,7 +16504,6 @@ is turned on for @context. See g_option_context_set_help_enabled(). Returns whether unknown options are ignored or not. See g_option_context_set_ignore_unknown_options(). - %TRUE if unknown options are ignored. @@ -17373,7 +16517,6 @@ g_option_context_set_ignore_unknown_options(). Returns a pointer to the main group of @context. - the main group of @context, or %NULL if @context doesn't have a main group. Note that group belongs to @@ -17391,7 +16534,6 @@ g_option_context_set_ignore_unknown_options(). Returns whether strict POSIX code is enabled. See g_option_context_set_strict_posix() for more information. - %TRUE if strict POSIX is enabled, %FALSE otherwise. @@ -17405,7 +16547,6 @@ See g_option_context_set_strict_posix() for more information. Returns the summary. See g_option_context_set_summary(). - the summary @@ -17439,7 +16580,6 @@ call `exit (0)`. Note that function depends on the [current locale][setlocale] for automatic character set conversion of string and filename arguments. - %TRUE if the parsing was successful, %FALSE if an error occurred @@ -17479,7 +16619,6 @@ See g_win32_get_command_line() for a solution. This function is useful if you are trying to use #GOptionContext with #GApplication. - %TRUE if the parsing was successful, %FALSE if an error occurred @@ -17507,7 +16646,6 @@ of options. This text often includes a bug reporting address. Note that the summary is translated (see g_option_context_set_translate_func()). - @@ -17528,7 +16666,6 @@ g_option_context_set_translate_func()). By default, g_option_context_parse() recognizes `--help`, `-h`, `-?`, `--help-all` and `--help-groupname` and creates suitable output to stdout. - @@ -17551,7 +16688,6 @@ g_option_context_parse() treats unknown options as error. This setting does not affect non-option arguments (i.e. arguments which don't start with a dash). But note that GOption cannot reliably determine whether a non-option belongs to a preceding unknown option. - @@ -17572,7 +16708,6 @@ determine whether a non-option belongs to a preceding unknown option. This has the same effect as calling g_option_context_add_group(), the only difference is that the options in the main group are treated differently when generating `--help` output. - @@ -17612,7 +16747,6 @@ options up to the verb name while leaving the remaining options to be parsed by the relevant subcommand (which can be determined by examining the verb name, which should be present in argv[1] after parsing). - @@ -17634,7 +16768,6 @@ of options. This is typically a summary of the program functionality. Note that the summary is translated (see g_option_context_set_translate_func() and g_option_context_set_translation_domain()). - @@ -17662,7 +16795,6 @@ the summary (see g_option_context_set_summary()) and the description If you are using gettext(), you only need to set the translation domain, see g_option_context_set_translation_domain(). - @@ -17688,7 +16820,6 @@ domain, see g_option_context_set_translation_domain(). A convenience function to use gettext() for translating user-visible strings. - @@ -17723,7 +16854,6 @@ below the usage line, use g_option_context_set_summary(). Note that the @parameter_string is translated using the function set with g_option_context_set_translate_func(), so it should normally be passed untranslated. - a newly created #GOptionContext, which must be freed with g_option_context_free() after use. @@ -17743,7 +16873,6 @@ it should normally be passed untranslated. A GOptionEntry struct defines a single option. To have an effect, they must be added to a #GOptionGroup with g_option_context_add_main_entries() or g_option_group_add_entries(). - The long name of an option can be used to specify it in a commandline as `--long_name`. Every option must have a @@ -17803,7 +16932,6 @@ or g_option_group_add_entries(). Error codes returned by option parsing. - An option was not known to the parser. This error will only be reported, if the parser hasn't been instructed @@ -17818,7 +16946,6 @@ or g_option_group_add_entries(). The type of function to be used as callback when a parse error occurs. - @@ -17840,7 +16967,6 @@ or g_option_group_add_entries(). Flags which modify individual options. - No flags. Since: 2.42. @@ -17888,10 +17014,8 @@ All options in a group share the same translation function. Libraries which need to parse commandline options are expected to provide a function for getting a `GOptionGroup` holding their options, which the application can then add to its #GOptionContext. - Creates a new #GOptionGroup. - a newly created option group. It should be added to a #GOptionContext or freed with g_option_group_unref(). @@ -17928,7 +17052,6 @@ the application can then add to its #GOptionContext. Adds the options specified in @entries to @group. - @@ -17949,7 +17072,6 @@ the application can then add to its #GOptionContext. Frees a #GOptionGroup. Note that you must not free groups which have been added to a #GOptionContext. Use g_option_group_unref() instead. - @@ -17962,7 +17084,6 @@ which have been added to a #GOptionContext. Increments the reference count of @group by one. - a #GOptionGroup @@ -17980,7 +17101,6 @@ from g_option_context_parse() when an error occurs. Note that the user data to be passed to @error_func can be specified when constructing the group with g_option_group_new(). - @@ -18003,7 +17123,6 @@ and after the last option has been parsed, respectively. Note that the user data to be passed to @pre_parse_func and @post_parse_func can be specified when constructing the group with g_option_group_new(). - @@ -18029,7 +17148,6 @@ for `--help` output. Different groups can use different If you are using gettext(), you only need to set the translation domain, see g_option_group_set_translation_domain(). - @@ -18055,7 +17173,6 @@ domain, see g_option_group_set_translation_domain(). A convenience function to use gettext() for translating user-visible strings. - @@ -18074,7 +17191,6 @@ user-visible strings. 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. - @@ -18088,7 +17204,6 @@ and all memory allocated by the @group is released. The type of function that can be called before and after parsing. - %TRUE if the function completed successfully, %FALSE if an error occurred, in which case @error should be set with g_set_error() @@ -18113,34 +17228,28 @@ and all memory allocated by the @group is released. Specifies one of the possible types of byte order (currently unused). See #G_BYTE_ORDER. - The value of pi (ratio of circle's circumference to its diameter). - A format specifier that can be used in printf()-style format strings when printing a #GPid. - Pi divided by 2. - Pi divided by 4. - A format specifier that can be used in printf()-style format strings when printing the @fd member of a #GPollFD. - @@ -18149,7 +17258,6 @@ when printing the @fd member of a #GPollFD. In GLib this priority is used when adding timeout functions with g_timeout_add(). In GDK this priority is used for events from the X server. - @@ -18157,14 +17265,12 @@ from the X server. In GLib this priority is used when adding idle functions with g_idle_add(). - Use this for high priority event sources. It is not used within GLib or GTK+. - @@ -18174,14 +17280,12 @@ GTK+ uses #G_PRIORITY_HIGH_IDLE + 10 for resizing operations, and #G_PRIORITY_HIGH_IDLE + 20 for redrawing operations. (This is done to ensure that any pending resizes are processed before any pending redraws, so that widgets are not redrawn twice unnecessarily.) - Use this for very low priority background tasks. It is not used within GLib or GTK+. - @@ -18231,7 +17335,6 @@ set_local_count (gint count) g_private_set (&count_key, GINT_TO_POINTER (count)); } ]| - a #GDestroyNotify @@ -18241,11 +17344,9 @@ set_local_count (gint count) A GPatternSpec struct is the 'compiled' form of a pattern. This structure is opaque and its fields cannot be accessed directly. - Compares two compiled pattern specs and returns whether they will match the same set of strings. - Whether the compiled patterns are equal @@ -18263,7 +17364,6 @@ match the same set of strings. Frees the memory allocated for the #GPatternSpec. - @@ -18276,7 +17376,6 @@ match the same set of strings. Compiles a pattern to a #GPatternSpec. - a newly-allocated #GPatternSpec @@ -18292,7 +17391,6 @@ match the same set of strings. Represents a file descriptor, which events to poll for, and which events occurred. - the file descriptor to poll (or a HANDLE on Win32) @@ -18313,7 +17411,6 @@ occurred. Specifies the type of function passed to g_main_context_set_poll_func(). The semantics of the function should match those of the poll() system call. - the number of #GPollFD elements which have events or errors reported, or -1 if an error occurred. @@ -18338,7 +17435,6 @@ The semantics of the function should match those of the poll() system call. Specifies the type of the print handler functions. These are called with the complete formatted string to output. - @@ -18367,7 +17463,6 @@ See G_PRIVATE_INIT() for a couple of examples. The #GPrivate structure should be considered opaque. It should only be accessed via the g_private_ functions. - @@ -18385,7 +17480,6 @@ be accessed via the g_private_ functions. If the value has not yet been set in this thread, %NULL is returned. Values are never copied between threads (when a new thread is created, for example). - the thread-local value @@ -18404,7 +17498,6 @@ current thread. This function differs from g_private_set() in the following way: if the previous value was non-%NULL then the #GDestroyNotify handler for @key is run on it. - @@ -18425,7 +17518,6 @@ current thread. This function differs from g_private_replace() in the following way: the #GDestroyNotify for @key is not called on the old value. - @@ -18443,7 +17535,6 @@ the #GDestroyNotify for @key is not called on the old value. Contains the public fields of a pointer array. - points to the array of pointers, which may be moved when the array grows @@ -18456,7 +17547,6 @@ the #GDestroyNotify for @key is not called on the old value. Adds a pointer to the end of the pointer array. The array will grow in size automatically if necessary. - @@ -18487,7 +17577,6 @@ pointing to) are copied to the new #GPtrArray. The copy of @array will have the same #GDestroyNotify for its elements as @array. - a deep copy of the initial #GPtrArray. @@ -18524,7 +17613,6 @@ may get compiler warnings from this though if compiling with GCC’s If @func is %NULL, then only the pointers (and not what they are pointing to) are copied to the new #GPtrArray. - @@ -18559,7 +17647,6 @@ ownership of each element from @array to @array_to_extend and modifying As with g_ptr_array_free(), @array will be destroyed if its reference count is 1. If its reference count is higher, it will be decremented and the length of @array set to zero. - @@ -18587,7 +17674,6 @@ multiple times in @haystack, the index of the first instance is returned. This does pointer comparisons only. If you want to use more complex equality checks, such as string comparisons, use g_ptr_array_find_with_equal_func(). - %TRUE if @needle is one of the elements of @haystack @@ -18620,7 +17706,6 @@ the first instance is returned. @equal_func is called with the element from the array as its first parameter, and @needle as its second parameter. If @equal_func is %NULL, pointer equality is used. - %TRUE if @needle is one of the elements of @haystack @@ -18652,7 +17737,6 @@ equality is used. Calls a function for each element of a #GPtrArray. @func must not add elements to or remove elements from the array. - @@ -18688,10 +17772,9 @@ function has been set for @array. This function is not thread-safe. If using a #GPtrArray from multiple threads, use only the atomic g_ptr_array_ref() and g_ptr_array_unref() functions. - - - the pointer array if @free_seg is %FALSE, otherwise %NULL. - The pointer array should be freed using g_free(). + + the pointer array if @free_seg is + %FALSE, otherwise %NULL. The pointer array should be freed using g_free(). @@ -18710,7 +17793,6 @@ functions. Inserts an element into the pointer array at the given index. The array will grow in size automatically if necessary. - @@ -18733,7 +17815,6 @@ array will grow in size automatically if necessary. Creates a new #GPtrArray with a reference count of 1. - the new #GPtrArray @@ -18749,7 +17830,6 @@ the size of the array is still 0. It also set @element_free_func for freeing each element when the array is destroyed either via g_ptr_array_unref(), when g_ptr_array_free() is called with @free_segment set to %TRUE or when removing elements. - A new #GPtrArray @@ -18773,7 +17853,6 @@ g_ptr_array_unref(), when g_ptr_array_free() is called with @element_free_func for freeing each element when the array is destroyed either via g_ptr_array_unref(), when g_ptr_array_free() is called with @free_segment set to %TRUE or when removing elements. - A new #GPtrArray @@ -18791,7 +17870,6 @@ either via g_ptr_array_unref(), when g_ptr_array_free() is called with Atomically increments the reference count of @array by one. This function is thread-safe and may be called from any thread. - The passed in #GPtrArray @@ -18815,7 +17893,6 @@ removed element. It returns %TRUE if the pointer was removed, or %FALSE if the pointer was not found. - %TRUE if the pointer is removed, %FALSE if the pointer is not found in the array @@ -18843,7 +17920,6 @@ is faster than g_ptr_array_remove(). If @array has a non-%NULL It returns %TRUE if the pointer was removed, or %FALSE if the pointer was not found. - %TRUE if the pointer was found in the array @@ -18867,7 +17943,6 @@ The following elements are moved down one place. If @array has a non-%NULL #GDestroyNotify function it is called for the removed element. If so, the return value from this function will potentially point to freed memory (depending on the #GDestroyNotify implementation). - the pointer which was removed @@ -18893,7 +17968,6 @@ is faster than g_ptr_array_remove_index(). If @array has a non-%NULL #GDestroyNotify function it is called for the removed element. If so, the return value from this function will potentially point to freed memory (depending on the #GDestroyNotify implementation). - the pointer which was removed @@ -18916,7 +17990,6 @@ return value from this function will potentially point to freed memory from a #GPtrArray. The following elements are moved to close the gap. If @array has a non-%NULL #GDestroyNotify function it is called for the removed elements. - the @array @@ -18944,7 +18017,6 @@ called for the removed elements. Sets a function for freeing each element when @array is destroyed either via g_ptr_array_unref(), when g_ptr_array_free() is called with @free_segment set to %TRUE or when removing elements. - @@ -18967,7 +18039,6 @@ with @free_segment set to %TRUE or when removing elements. newly-added elements will be set to %NULL. When making it smaller, if @array has a non-%NULL #GDestroyNotify function then it will be called for the removed elements. - @@ -18989,7 +18060,6 @@ called for the removed elements. and a reference count of 1. This avoids frequent reallocation, if you are going to add many pointers to the array. Note however that the size of the array is still 0. - the new #GPtrArray @@ -19039,7 +18109,6 @@ g_ptr_array_sort (file_list, sort_filelist); ]| This is guaranteed to be a stable sort since version 2.32. - @@ -19110,7 +18179,6 @@ g_ptr_array_sort_with_data (file_list, ]| This is guaranteed to be a stable sort since version 2.32. - @@ -19172,7 +18240,6 @@ g_free (chunks); // next set of chunks. g_assert (chunk_buffer->len == 0); ]| - the element data, which should be freed using g_free(). @@ -19197,7 +18264,6 @@ g_assert (chunk_buffer->len == 0); The following elements are moved down one place. The #GDestroyNotify for @array is *not* called on the removed element; ownership is transferred to the caller of this function. - the pointer which was removed @@ -19222,7 +18288,6 @@ this function does not preserve the order of the array. But it is faster than g_ptr_array_steal_index(). The #GDestroyNotify for @array is *not* called on the removed element; ownership is transferred to the caller of this function. - the pointer which was removed @@ -19245,7 +18310,6 @@ of this function. reference count drops to 0, the effect is the same as calling g_ptr_array_free() with @free_segment set to %TRUE. This function is thread-safe and may be called from any thread. - @@ -19262,7 +18326,6 @@ is thread-safe and may be called from any thread. Contains the public fields of a [Queue][glib-Double-ended-Queues]. - a pointer to the first element of the queue @@ -19282,7 +18345,6 @@ is thread-safe and may be called from any thread. Removes all the elements in @queue. If queue elements contain dynamically-allocated memory, they should be freed first. - @@ -19296,7 +18358,6 @@ dynamically-allocated memory, they should be freed first. Convenience method, which frees all the memory used by a #GQueue, and calls the provided @free_func on each item in the #GQueue. - @@ -19315,7 +18376,6 @@ and calls the provided @free_func on each item in the #GQueue. Copies a @queue. Note that is a shallow copy. If the elements in the queue consist of pointers to data, the pointers are copied, but the actual data is not. - a copy of @queue @@ -19331,7 +18391,6 @@ actual data is not. Removes @link_ from @queue and frees it. @link_ must be part of @queue. - @@ -19350,7 +18409,6 @@ actual data is not. Finds the first link in @queue which contains @data. - the first link in @queue which contains @data @@ -19374,7 +18432,6 @@ desired element. It iterates over the queue, calling the given function which should return 0 when the desired element is found. The function takes two gconstpointer arguments, the #GQueue element's data as the first argument and the given user data as the second argument. - the found link, or %NULL if it wasn't found @@ -19403,7 +18460,6 @@ function. It is safe for @func to remove the element from @queue, but it must not modify any part of the queue after that element. - @@ -19429,7 +18485,6 @@ dynamically-allocated memory, they should be freed first. If queue elements contain dynamically-allocated memory, you should either use g_queue_free_full() or free them manually first. - @@ -19446,7 +18501,6 @@ and calls the specified destroy function on every element's data. @free_func should not modify the queue (eg, by removing the freed element from it). - @@ -19463,7 +18517,6 @@ element from it). Returns the number of items in @queue. - the number of items in @queue @@ -19477,7 +18530,6 @@ element from it). Returns the position of the first element in @queue which contains @data. - the position of the first element in @queue which contains @data, or -1 if no element in @queue contains @data @@ -19499,7 +18551,6 @@ element from it). before it can be used. Alternatively you can initialize it with #G_QUEUE_INIT. It is not necessary to initialize queues created with g_queue_new(). - @@ -19515,7 +18566,6 @@ g_queue_new(). @sibling must be part of @queue. Since GLib 2.44 a %NULL sibling pushes the data at the head of the queue. - @@ -19541,7 +18591,6 @@ data at the head of the queue. Inserts @link_ into @queue after @sibling. @sibling must be part of @queue. - @@ -19570,7 +18619,6 @@ data at the head of the queue. @sibling must be part of @queue. Since GLib 2.44 a %NULL sibling pushes the data at the tail of the queue. - @@ -19596,7 +18644,6 @@ data at the tail of the queue. Inserts @link_ into @queue before @sibling. @sibling must be part of @queue. - @@ -19622,7 +18669,6 @@ data at the tail of the queue. Inserts @data into @queue using @func to determine the new position. - @@ -19651,7 +18697,6 @@ data at the tail of the queue. Returns %TRUE if the queue is empty. - %TRUE if the queue is empty @@ -19665,7 +18710,6 @@ data at the tail of the queue. Returns the position of @link_ in @queue. - the position of @link_, or -1 if the link is not part of @queue @@ -19686,7 +18730,6 @@ data at the tail of the queue. Returns the first element of the queue. - the data of the first element in the queue, or %NULL if the queue is empty @@ -19701,7 +18744,6 @@ data at the tail of the queue. Returns the first link in @queue. - the first link in @queue, or %NULL if @queue is empty @@ -19717,7 +18759,6 @@ data at the tail of the queue. Returns the @n'th element of @queue. - the data for the @n'th element of @queue, or %NULL if @n is off the end of @queue @@ -19736,7 +18777,6 @@ data at the tail of the queue. Returns the link at the given position - the link at the @n'th position, or %NULL if @n is off the end of the list @@ -19757,7 +18797,6 @@ data at the tail of the queue. Returns the last element of the queue. - the data of the last element in the queue, or %NULL if the queue is empty @@ -19772,7 +18811,6 @@ data at the tail of the queue. Returns the last link in @queue. - the last link in @queue, or %NULL if @queue is empty @@ -19788,7 +18826,6 @@ data at the tail of the queue. Removes the first element of the queue and returns its data. - the data of the first element in the queue, or %NULL if the queue is empty @@ -19803,7 +18840,6 @@ data at the tail of the queue. Removes and returns the first element of the queue. - the #GList element at the head of the queue, or %NULL if the queue is empty @@ -19820,7 +18856,6 @@ data at the tail of the queue. Removes the @n'th element of @queue and returns its data. - the element's data, or %NULL if @n is off the end of @queue @@ -19838,7 +18873,6 @@ data at the tail of the queue. Removes and returns the link at the given position. - the @n'th link, or %NULL if @n is off the end of @queue @@ -19858,7 +18892,6 @@ data at the tail of the queue. Removes the last element of the queue and returns its data. - the data of the last element in the queue, or %NULL if the queue is empty @@ -19873,7 +18906,6 @@ data at the tail of the queue. Removes and returns the last element of the queue. - the #GList element at the tail of the queue, or %NULL if the queue is empty @@ -19890,7 +18922,6 @@ data at the tail of the queue. Adds a new element at the head of the queue. - @@ -19907,7 +18938,6 @@ data at the tail of the queue. Adds a new element at the head of the queue. - @@ -19926,7 +18956,6 @@ data at the tail of the queue. Inserts a new element into @queue at the given position. - @@ -19949,7 +18978,6 @@ data at the tail of the queue. Inserts @link into @queue at the given position. - @@ -19974,7 +19002,6 @@ data at the tail of the queue. Adds a new element at the tail of the queue. - @@ -19991,7 +19018,6 @@ data at the tail of the queue. Adds a new element at the tail of the queue. - @@ -20010,7 +19036,6 @@ data at the tail of the queue. Removes the first element in @queue that contains @data. - %TRUE if @data was found and removed from @queue @@ -20028,7 +19053,6 @@ data at the tail of the queue. Remove all elements whose data equals @data from @queue. - the number of elements removed from @queue @@ -20046,7 +19070,6 @@ data at the tail of the queue. Reverses the order of the items in @queue. - @@ -20059,7 +19082,6 @@ data at the tail of the queue. Sorts @queue using @compare_func. - @@ -20086,7 +19108,6 @@ data at the tail of the queue. The link is not freed. @link_ must be part of @queue. - @@ -20105,7 +19126,6 @@ The link is not freed. Creates a new #GQueue. - a newly allocated #GQueue @@ -20176,7 +19196,6 @@ without initialisation. Otherwise, you should call g_rw_lock_init() on it and g_rw_lock_clear() when done. A GRWLock should only be accessed with the g_rw_lock_ functions. - @@ -20195,7 +19214,6 @@ Calling g_rw_lock_clear() when any thread holds the lock leads to undefined behaviour. Sine: 2.32 - @@ -20231,7 +19249,6 @@ needed, use g_rw_lock_clear(). Calling g_rw_lock_init() on an already initialized #GRWLock leads to undefined behaviour. - @@ -20244,15 +19261,20 @@ to undefined behaviour. Obtain a read lock on @rw_lock. If another thread currently holds -the write lock on @rw_lock, the current thread will block. If another thread -does not hold the write lock, but is waiting for it, it is implementation -defined whether the reader or writer will block. Read locks can be taken +the write lock on @rw_lock, the current thread will block until the +write lock was (held and) released. If another thread does not hold +the write lock, but is waiting for it, it is implementation defined +whether the reader or writer will block. Read locks can be taken recursively. -It is implementation-defined how many threads are allowed to -hold read locks on the same lock simultaneously. If the limit is hit, +Calling g_rw_lock_reader_lock() while the current thread already +owns a write lock leads to undefined behaviour. Read locks however +can be taken recursively, in which case you need to make sure to +call g_rw_lock_reader_unlock() the same amount of times. + +It is implementation-defined how many read locks are allowed to be +held on the same lock simultaneously. If the limit is hit, or if a deadlock is detected, a critical warning will be emitted. - @@ -20267,7 +19289,6 @@ or if a deadlock is detected, a critical warning will be emitted. Tries to obtain a read lock on @rw_lock and returns %TRUE if the read lock was successfully obtained. Otherwise it returns %FALSE. - %TRUE if @rw_lock could be locked @@ -20284,7 +19305,6 @@ returns %FALSE. Calling g_rw_lock_reader_unlock() on a lock that is not held by the current thread leads to undefined behaviour. - @@ -20296,10 +19316,12 @@ by the current thread leads to undefined behaviour. - Obtain a write lock on @rw_lock. If any thread already holds + Obtain a write lock on @rw_lock. If another thread currently holds a read or write lock on @rw_lock, the current thread will block -until all other threads have dropped their locks on @rw_lock. - +until all other threads have dropped their locks on @rw_lock. + +Calling g_rw_lock_writer_lock() while the current thread already +owns a read or write lock on @rw_lock leads to undefined behaviour. @@ -20311,10 +19333,10 @@ until all other threads have dropped their locks on @rw_lock. - Tries to obtain a write lock on @rw_lock. If any other thread holds -a read or write lock on @rw_lock, it immediately returns %FALSE. + Tries to obtain a write lock on @rw_lock. If another thread +currently holds a read or write lock on @rw_lock, it immediately +returns %FALSE. Otherwise it locks @rw_lock and returns %TRUE. - %TRUE if @rw_lock could be locked @@ -20331,7 +19353,6 @@ Otherwise it locks @rw_lock and returns %TRUE. Calling g_rw_lock_writer_unlock() on a lock that is not held by the current thread leads to undefined behaviour. - @@ -20346,12 +19367,10 @@ by the current thread leads to undefined behaviour. The GRand struct is an opaque data structure. It should only be accessed through the g_rand_* functions. - Copies a #GRand into a new one with the same exact state as before. This way you can take a snapshot of the random number generator for replaying later. - the new #GRand @@ -20366,7 +19385,6 @@ replaying later. Returns the next random #gdouble from @rand_ equally distributed over the range [0..1). - a random number @@ -20381,7 +19399,6 @@ the range [0..1). Returns the next random #gdouble from @rand_ equally distributed over the range [@begin..@end). - a random number @@ -20403,7 +19420,6 @@ the range [@begin..@end). Frees the memory allocated for the #GRand. - @@ -20417,7 +19433,6 @@ the range [@begin..@end). Returns the next random #guint32 from @rand_ equally distributed over the range [0..2^32-1]. - a random number @@ -20432,7 +19447,6 @@ the range [0..2^32-1]. Returns the next random #gint32 from @rand_ equally distributed over the range [@begin..@end-1]. - a random number @@ -20454,7 +19468,6 @@ the range [@begin..@end-1]. Sets the seed for the random number generator #GRand to @seed. - @@ -20475,7 +19488,6 @@ Array can be of arbitrary size, though only the first 624 values are taken. This function is useful if you have many low entropy seeds, or if you require more then 32 bits of actual entropy for your application. - @@ -20500,7 +19512,6 @@ either from `/dev/urandom` (if existing) or from the current time (as a fallback). On Windows, the seed is taken from rand_s(). - the new #GRand @@ -20508,7 +19519,6 @@ On Windows, the seed is taken from rand_s(). Creates a new random number generator initialized with @seed. - the new #GRand @@ -20522,7 +19532,6 @@ On Windows, the seed is taken from rand_s(). Creates a new random number generator initialized with @seed. - the new #GRand @@ -20553,7 +19562,6 @@ g_rec_mutex_init() on it and g_rec_mutex_clear() when done. A GRecMutex should only be accessed with the g_rec_mutex_ functions. - @@ -20573,7 +19581,6 @@ Calling g_rec_mutex_clear() on a locked recursive mutex leads to undefined behaviour. Sine: 2.32 - @@ -20611,7 +19618,6 @@ leads to undefined behaviour. To undo the effect of g_rec_mutex_init() when a recursive mutex is no longer needed, use g_rec_mutex_clear(). - @@ -20629,7 +19635,6 @@ unlocked by the other thread. If @rec_mutex is already locked by the current thread, the 'lock count' of @rec_mutex is increased. The mutex will only become available again when it is unlocked as many times as it has been locked. - @@ -20644,7 +19649,6 @@ as many times as it has been locked. Tries to lock @rec_mutex. If @rec_mutex is already locked by another thread, it immediately returns %FALSE. Otherwise it locks @rec_mutex and returns %TRUE. - %TRUE if @rec_mutex could be locked @@ -20663,7 +19667,6 @@ and can lock @rec_mutex itself. Calling g_rec_mutex_unlock() on a recursive mutex that is not locked by the current thread leads to undefined behaviour. - @@ -20741,11 +19744,9 @@ The regular expressions low-level functionalities are obtained through the excellent [PCRE](http://www.pcre.org/) library written by Philip Hazel. - Compiles the regular expression to an internal form, and does the initial setup of the #GRegex structure. - a #GRegex structure or %NULL if an error occurred. Call g_regex_unref() when you are done with it @@ -20768,7 +19769,6 @@ the initial setup of the #GRegex structure. Returns the number of capturing subpatterns in the pattern. - the number of capturing subpatterns @@ -20786,7 +19786,6 @@ the initial setup of the #GRegex structure. Depending on the version of PCRE that is used, this may or may not include flags set by option expressions such as `(?i)` found at the top-level within the compiled pattern. - flags from #GRegexCompileFlags @@ -20800,7 +19799,6 @@ top-level within the compiled pattern. Checks whether the pattern contains explicit CR or LF references. - %TRUE if the pattern contains explicit CR or LF references @@ -20814,7 +19812,6 @@ top-level within the compiled pattern. Returns the match options that @regex was created with. - flags from #GRegexMatchFlags @@ -20830,7 +19827,6 @@ top-level within the compiled pattern. Returns the number of the highest back reference in the pattern, or 0 if the pattern does not contain back references. - the number of the highest back reference @@ -20846,7 +19842,6 @@ back references. Gets the number of characters in the longest lookbehind assertion in the pattern. This information is useful when doing multi-segment matching using the partial matching facilities. - the number of characters in the longest lookbehind assertion. @@ -20861,7 +19856,6 @@ the partial matching facilities. Gets the pattern string associated with @regex, i.e. a copy of the string passed to g_regex_new(). - the pattern of @regex @@ -20875,7 +19869,6 @@ the string passed to g_regex_new(). Retrieves the number of the subexpression named @name. - The number of the subexpression or -1 if @name does not exists @@ -20933,7 +19926,6 @@ print_uppercase_words (const gchar *string) @string is not copied and is used in #GMatchInfo internally. If you use any #GMatchInfo method (except g_match_info_free()) after freeing or modifying @string then the behaviour is undefined. - %TRUE is the string matched, %FALSE otherwise @@ -20973,7 +19965,6 @@ matched. @string is not copied and is used in #GMatchInfo internally. If you use any #GMatchInfo method (except g_match_info_free()) after freeing or modifying @string then the behaviour is undefined. - %TRUE is the string matched, %FALSE otherwise @@ -21037,7 +20028,6 @@ matched. @string is not copied and is used in #GMatchInfo internally. If you use any #GMatchInfo method (except g_match_info_free()) after freeing or modifying @string then the behaviour is undefined. - %TRUE is the string matched, %FALSE otherwise @@ -21124,7 +20114,6 @@ print_uppercase_words (const gchar *string) } } ]| - %TRUE is the string matched, %FALSE otherwise @@ -21161,7 +20150,6 @@ print_uppercase_words (const gchar *string) Increases reference count of @regex by 1. - @regex @@ -21200,7 +20188,6 @@ you can use g_regex_replace_literal(). Setting @start_position differs from just passing over a shortened string and setting #G_REGEX_MATCH_NOTBOL in the case of a pattern that begins with any kind of lookbehind assertion, such as "\b". - a newly allocated string containing the replacements @@ -21280,7 +20267,6 @@ g_hash_table_destroy (h); ... ]| - a newly allocated string containing the replacements @@ -21327,7 +20313,6 @@ Setting @start_position differs from just passing over a shortened string and setting #G_REGEX_MATCH_NOTBOL in the case of a pattern that begins with any kind of lookbehind assertion, such as "\b". - a newly allocated string containing the replacements @@ -21379,7 +20364,6 @@ A pattern that can match empty strings splits @string into separate characters wherever it matches the empty string between characters. For example splitting "ab c" using as a separator "\s*", you will get "a", "b" and "c". - a %NULL-terminated gchar ** array. Free it using g_strfreev() @@ -21424,7 +20408,6 @@ For example splitting "ab c" using as a separator "\s*", you will get Setting @start_position differs from just passing over a shortened string and setting #G_REGEX_MATCH_NOTBOL in the case of a pattern that begins with any kind of lookbehind assertion, such as "\b". - a %NULL-terminated gchar ** array. Free it using g_strfreev() @@ -21465,7 +20448,6 @@ it using g_strfreev() Decreases reference count of @regex by 1. When reference count drops to zero, it frees all the memory associated with the regex structure. - @@ -21486,7 +20468,6 @@ for pattern references. For instance, replacement text 'foo\n' does not contain references and may be evaluated without information about actual match, but '\0\1' (whole match followed by first subpattern) requires valid #GMatchInfo object. - whether @replacement is a valid replacement string @@ -21514,7 +20495,6 @@ to compile a regex with embedded nul characters. For completeness, @length can be -1 for a nul-terminated string. In this case the output string will be of course equal to @string. - a newly-allocated escaped string @@ -21538,7 +20518,6 @@ function is useful to dynamically generate regular expressions. @string can contain nul characters that are replaced with "\0", in this case remember to specify the correct length of @string in @length. - a newly-allocated escaped string @@ -21567,7 +20546,6 @@ substrings, capture counts, and so on. If this function is to be called on the same @pattern more than once, it's more efficient to compile the pattern once with g_regex_new() and then use g_regex_match(). - %TRUE if the string matched, %FALSE otherwise @@ -21619,7 +20597,6 @@ A pattern that can match empty strings splits @string into separate characters wherever it matches the empty string between characters. For example splitting "ab c" using as a separator "\s*", you will get "a", "b" and "c". - a %NULL-terminated array of strings. Free it using g_strfreev() @@ -21649,7 +20626,6 @@ it using g_strfreev() Flags specifying compile-time options. - Letters in the pattern match both upper- and lowercase letters. This option can be changed within a pattern @@ -21758,7 +20734,6 @@ it using g_strfreev() Error codes returned by regular expressions functions. - Compilation of the regular expression failed. @@ -21979,7 +20954,6 @@ it using g_strfreev() It is called for each occurrence of the pattern in the string passed to g_regex_replace_eval(), and it should append the replacement to @result. - %FALSE to continue the replacement process, %TRUE to stop it @@ -22003,7 +20977,6 @@ to g_regex_replace_eval(), and it should append the replacement to Flags specifying match-time options. - The pattern is forced to be "anchored", that is, it is constrained to match only at the first matching point in the @@ -22097,23 +21070,19 @@ to g_regex_replace_eval(), and it should append the replacement to The search path separator character. This is ':' on UNIX machines and ';' under Windows. - The search path separator as a string. This is ":" on UNIX machines and ";" under Windows. - - Returns the size of @member in the struct definition without having a declared instance of @struct_type. - a structure type, e.g. #GOutputVector @@ -22124,21 +21093,17 @@ declared instance of @struct_type. - - - The #GSList struct is used for each element in the singly-linked list. - holds the element's data, which can be a pointer to any kind of data, or any integer value using the @@ -22155,7 +21120,6 @@ list. Allocates space for one #GSList element. It is called by the g_slist_append(), g_slist_prepend(), g_slist_insert() and g_slist_insert_sorted() functions and so is rarely used on its own. - a pointer to the newly-allocated #GSList element. @@ -22186,7 +21150,6 @@ list = g_slist_append (list, "second"); number_list = g_slist_append (number_list, GINT_TO_POINTER (27)); number_list = g_slist_append (number_list, GINT_TO_POINTER (14)); ]| - the new start of the #GSList @@ -22210,7 +21173,6 @@ number_list = g_slist_append (number_list, GINT_TO_POINTER (14)); Adds the second #GSList onto the end of the first #GSList. Note that the elements of the second #GSList are not copied. They are used directly. - the start of the new #GSList @@ -22239,7 +21201,6 @@ Note that this is a "shallow" copy. If the list elements consist of pointers to data, the pointers are copied but the actual data isn't. See g_slist_copy_deep() if you need to copy the data as well. - a copy of @list @@ -22276,7 +21237,6 @@ And, to entirely free the new list, you could do: |[<!-- language="C" --> g_slist_free_full (another_list, g_object_unref); ]| - a full copy of @list, use g_slist_free_full() to free it @@ -22310,7 +21270,6 @@ that is proportional to the length of the list (ie. O(n)). If you find yourself using g_slist_delete_link() frequently, you should consider a different data structure, such as the doubly-linked #GList. - the new head of @list @@ -22335,7 +21294,6 @@ consider a different data structure, such as the doubly-linked Finds the element in a #GSList which contains the given data. - the found #GSList element, or %NULL if it is not found @@ -22363,7 +21321,6 @@ the given function which should return 0 when the desired element is found. The function takes two #gconstpointer arguments, the #GSList element's data as the first argument and the given user data. - the found #GSList element, or %NULL if it is not found @@ -22393,7 +21350,6 @@ given user data. It is safe for @func to remove the element from @list, but it must not modify any part of the list after that element. - @@ -22428,13 +21384,12 @@ is not left dangling: GSList *list_of_borrowed_things = …; /<!-- -->* (transfer container) *<!-- -->/ g_slist_free (g_steal_pointer (&list_of_borrowed_things)); ]| - - a #GSList + the first link of a #GSList @@ -22444,7 +21399,6 @@ g_slist_free (g_steal_pointer (&list_of_borrowed_things)); Frees one #GSList element. It is usually used after g_slist_remove_link(). - @@ -22472,13 +21426,12 @@ from @free_func: GSList *list_of_owned_things = …; /<!-- -->* (transfer full) (element-type GObject) *<!-- -->/ g_slist_free_full (g_steal_pointer (&list_of_owned_things), g_object_unref); ]| - - a pointer to a #GSList + the first link of a #GSList @@ -22492,7 +21445,6 @@ g_slist_free_full (g_steal_pointer (&list_of_owned_things), g_object_unref); Gets the position of the element containing the given data (starting from 0). - the index of the element containing the data, or -1 if the data is not found @@ -22513,7 +21465,6 @@ the given data (starting from 0). Inserts a new element into the list at the given position. - the new start of the #GSList @@ -22542,7 +21493,6 @@ the given data (starting from 0). Inserts a node before @sibling containing @data. - the new head of the list. @@ -22571,7 +21521,6 @@ the given data (starting from 0). Inserts a new element into the list, using the given comparison function to determine its position. - the new start of the #GSList @@ -22600,7 +21549,6 @@ comparison function to determine its position. Inserts a new element into the list, using the given comparison function to determine its position. - the new start of the #GSList @@ -22634,7 +21582,6 @@ comparison function to determine its position. Gets the last element in a #GSList. This function iterates over the whole list. - the last element in the #GSList, or %NULL if the #GSList has no elements @@ -22657,7 +21604,6 @@ This function iterates over the whole list. This function iterates over the whole list to count its elements. To check whether the list is non-empty, it is faster to check @list against %NULL. - the number of elements in the #GSList @@ -22673,7 +21619,6 @@ check @list against %NULL. Gets the element at the given position in a #GSList. - the element, or %NULL if the position is off the end of the #GSList @@ -22696,7 +21641,6 @@ check @list against %NULL. Gets the data of the element at the given position. - the element's data, or %NULL if the position is off the end of the #GSList @@ -22718,7 +21662,6 @@ check @list against %NULL. Gets the position of the given element in the #GSList (starting from 0). - the position of the element in the #GSList, or -1 if the element is not found @@ -22751,7 +21694,6 @@ GSList *list = NULL; list = g_slist_prepend (list, "last"); list = g_slist_prepend (list, "first"); ]| - the new start of the #GSList @@ -22775,7 +21717,6 @@ list = g_slist_prepend (list, "first"); Removes an element from a #GSList. If two elements contain the same data, only the first is removed. If none of the elements contain the data, the #GSList is unchanged. - the new start of the #GSList @@ -22800,7 +21741,6 @@ If none of the elements contain the data, the #GSList is unchanged. Returns the new head of the list. Contrast with g_slist_remove() which removes only the first node matching the given data. - new head of @list @@ -22831,7 +21771,6 @@ requires time that is proportional to the length of the list (ie. O(n)). If you find yourself using g_slist_remove_link() frequently, you should consider a different data structure, such as the doubly-linked #GList. - the new start of the #GSList, without the element @@ -22855,7 +21794,6 @@ such as the doubly-linked #GList. Reverses a #GSList. - the start of the reversed #GSList @@ -22874,7 +21812,6 @@ such as the doubly-linked #GList. Sorts a #GSList using the given comparison function. The algorithm used is a stable sort. - the start of the sorted #GSList @@ -22900,7 +21837,6 @@ used is a stable sort. Like g_slist_sort(), but the sort function accepts a user data argument. - new head of the list @@ -22928,7 +21864,6 @@ used is a stable sort. Use this macro as the return value of a #GSourceFunc to leave the #GSource in the main loop. - @@ -22941,7 +21876,6 @@ g_child_watch_source_new() is #GChildWatchFunc, which accepts more arguments than #GSourceFunc. Casting the function with `(GSourceFunc)` to call g_source_set_callback() will trigger a warning, even though it will be cast back to the correct type before it is called by the source. - a function pointer. @@ -22951,12 +21885,10 @@ back to the correct type before it is called by the source. Use this macro as the return value of a #GSourceFunc to remove the #GSource from the main loop. - The square root of two. - @@ -22973,7 +21905,6 @@ is transformed by the preprocessor into (code equivalent to): |[<!-- language="C" --> const gchar *greeting = "27 today!"; ]| - a macro or a string @@ -22981,7 +21912,6 @@ const gchar *greeting = "27 today!"; - @@ -22989,7 +21919,6 @@ const gchar *greeting = "27 today!"; Returns a member of a structure at a given offset, using the given type. - the type of the struct field @@ -23005,7 +21934,6 @@ const gchar *greeting = "27 today!"; Returns an untyped pointer to a given offset of a struct. - a pointer to a struct @@ -23017,7 +21945,6 @@ const gchar *greeting = "27 today!"; Returns the offset, in bytes, of a member of a struct. - a structure type, e.g. #GtkWidget @@ -23029,31 +21956,24 @@ const gchar *greeting = "27 today!"; The standard delimiters, used in g_strdelimit(). - - - - - - - @@ -23071,7 +21991,6 @@ can place them here. If you want to use your own message handler you can set the @msg_handler field. The type of the message handler function is declared by #GScannerMsgFunc. - unused @@ -23157,7 +22076,6 @@ is declared by #GScannerMsgFunc. Returns the current line in the input stream (counting from 1). This is the line of the last token parsed via g_scanner_get_next_token(). - the current line @@ -23173,7 +22091,6 @@ g_scanner_get_next_token(). Returns the current position in the current line (counting from 0). This is the position of the last token parsed via g_scanner_get_next_token(). - the current position on the line @@ -23188,7 +22105,6 @@ g_scanner_get_next_token(). Gets the current token type. This is simply the @token field in the #GScanner structure. - the current token type @@ -23203,7 +22119,6 @@ field in the #GScanner structure. Gets the current token value. This is simply the @value field in the #GScanner structure. - the current token value @@ -23217,7 +22132,6 @@ field in the #GScanner structure. Frees all memory used by the #GScanner. - @@ -23231,7 +22145,6 @@ field in the #GScanner structure. Returns %TRUE if the scanner has reached the end of the file or text buffer. - %TRUE if the scanner has reached the end of the file or text buffer @@ -23246,7 +22159,6 @@ the file or text buffer. Outputs an error message, via the #GScanner message handler. - @@ -23270,7 +22182,6 @@ the file or text buffer. and also removes it from the input stream. The token data is placed in the @token, @value, @line, and @position fields of the #GScanner structure. - the type of the token @@ -23284,7 +22195,6 @@ the #GScanner structure. Prepares to scan a file. - @@ -23301,7 +22211,6 @@ the #GScanner structure. Prepares to scan a text buffer. - @@ -23324,7 +22233,6 @@ the #GScanner structure. Looks up a symbol in the current scope and return its value. If the symbol is not bound in the current scope, %NULL is returned. - the value of @symbol in the current scope, or %NULL if @symbol is not bound in the current scope @@ -23353,7 +22261,6 @@ results when changing scope or the scanner configuration after peeking the next token. Getting the next token after switching the scope or configuration will return whatever was peeked before, regardless of any symbols that may have been added or removed in the new scope. - the type of the token @@ -23367,7 +22274,6 @@ any symbols that may have been added or removed in the new scope. Adds a symbol to the given scope. - @@ -23395,7 +22301,6 @@ any symbols that may have been added or removed in the new scope. in the given scope of the #GScanner. The function is passed the symbol and value of each pair, and the given @user_data parameter. - @@ -23421,7 +22326,6 @@ parameter. Looks up a symbol in a scope and return its value. If the symbol is not bound in the scope, %NULL is returned. - the value of @symbol in the given scope, or %NULL if @symbol is not bound in the given scope. @@ -23444,7 +22348,6 @@ symbol is not bound in the scope, %NULL is returned. Removes a symbol from a scope. - @@ -23465,7 +22368,6 @@ symbol is not bound in the scope, %NULL is returned. Sets the current scope. - the old scope id @@ -23486,7 +22388,6 @@ symbol is not bound in the scope, %NULL is returned. and blows the file read ahead buffer. This is useful for third party uses of the scanners filedescriptor, which hooks onto the current scanning position. - @@ -23505,7 +22406,6 @@ followed by g_scanner_unexp_token() without an intermediate call to g_scanner_get_next_token(), as g_scanner_unexp_token() evaluates the scanner's current token (not the peeked token) to construct part of the message. - @@ -23551,7 +22451,6 @@ to construct part of the message. Outputs a warning message, via the #GScanner message handler. - @@ -23577,7 +22476,6 @@ The @config_templ structure specifies the initial settings of the scanner, which are copied into the #GScanner @config field. If you pass %NULL then the default settings are used. - the new #GScanner @@ -23594,7 +22492,6 @@ are used. Specifies the #GScanner parser configuration. Most settings can be changed during the parsing phase and will affect the lexical parsing of the next unpeeked token. - specifies which characters should be skipped by the scanner (the default is the whitespace characters: space, @@ -23735,7 +22632,6 @@ parsing of the next unpeeked token. Specifies the type of the message handler function. - @@ -23758,7 +22654,6 @@ parsing of the next unpeeked token. An enumeration specifying the base position for a g_io_channel_seek_position() operation. - the current position in the file. @@ -23772,10 +22667,8 @@ g_io_channel_seek_position() operation. The #GSequence struct is an opaque data type representing a [sequence][glib-Sequences] data type. - Adds a new item to the end of @seq. - an iterator pointing to the new item @@ -23794,7 +22687,6 @@ g_io_channel_seek_position() operation. Calls @func for each item in the sequence passing @user_data to the function. @func must not modify the sequence itself. - @@ -23817,7 +22709,6 @@ to the function. @func must not modify the sequence itself. Frees the memory allocated for @seq. If @seq has a data destroy function associated with it, that function is called on all items in @seq. - @@ -23830,7 +22721,6 @@ in @seq. Returns the begin iterator for @seq. - the begin iterator for @seq. @@ -23844,7 +22734,6 @@ in @seq. Returns the end iterator for @seg - the end iterator for @seq @@ -23859,7 +22748,6 @@ in @seq. Returns the iterator at position @pos. If @pos is negative or larger than the number of items in @seq, the end iterator is returned. - The #GSequenceIter at position @pos @@ -23876,10 +22764,9 @@ than the number of items in @seq, the end iterator is returned. - Returns the length of @seq. Note that this method is O(h) where `h' is the -height of the tree. It is thus more efficient to use g_sequence_is_empty() -when comparing the length to zero. - + Returns the positive length (>= 0) of @seq. Note that this method is +O(h) where `h' is the height of the tree. It is thus more efficient +to use g_sequence_is_empty() when comparing the length to zero. the length of @seq @@ -23904,7 +22791,6 @@ if the second item comes before the first. Note that when adding a large amount of data to a #GSequence, it is more efficient to do unsorted insertions and then call g_sequence_sort() or g_sequence_sort_iter(). - a #GSequenceIter pointing to the new item. @@ -23941,7 +22827,6 @@ positive value if the second iterator comes before the first. Note that when adding a large amount of data to a #GSequence, it is more efficient to do unsorted insertions and then call g_sequence_sort() or g_sequence_sort_iter(). - a #GSequenceIter pointing to the new item @@ -23971,7 +22856,6 @@ g_sequence_sort() or g_sequence_sort_iter(). This function is functionally identical to checking the result of g_sequence_get_length() being equal to zero. However this function is implemented in O(1) running time. - %TRUE if the sequence is empty, otherwise %FALSE. @@ -23997,7 +22881,6 @@ the second item comes before the first. This function will fail if the data contained in the sequence is unsorted. - an #GSequenceIter pointing to the position of the first item found equal to @data according to @cmp_func and @@ -24034,7 +22917,6 @@ value if the second iterator comes before the first. This function will fail if the data contained in the sequence is unsorted. - an #GSequenceIter pointing to the position of the first item found equal to @data according to @iter_cmp @@ -24062,7 +22944,6 @@ unsorted. Adds a new item to the front of @seq - an iterator pointing to the new item @@ -24092,7 +22973,6 @@ consider using g_sequence_lookup(). This function will fail if the data contained in the sequence is unsorted. - an #GSequenceIter pointing to the position where @data would have been inserted according to @cmp_func and @cmp_data @@ -24131,7 +23011,6 @@ consider using g_sequence_lookup_iter(). This function will fail if the data contained in the sequence is unsorted. - a #GSequenceIter pointing to the position in @seq where @data would have been inserted according to @iter_cmp @@ -24164,7 +23043,6 @@ unsorted. return 0 if they are equal, a negative value if the first comes before the second, and a positive value if the second comes before the first. - @@ -24191,7 +23069,6 @@ of a #GCompareDataFunc as the compare function return 0 if the iterators are equal, a negative value if the first iterator comes before the second, and a positive value if the second iterator comes before the first. - @@ -24214,7 +23091,6 @@ iterator comes before the first. Calls @func for each item in the range (@begin, @end) passing @user_data to the function. @func must not modify the sequence itself. - @@ -24239,7 +23115,6 @@ itself. Returns the data that @iter points to. - the data that @iter points to @@ -24253,7 +23128,6 @@ itself. Inserts a new item just before the item pointed to by @iter. - an iterator pointing to the new item @@ -24274,7 +23148,6 @@ itself. After calling this function @dest will point to the position immediately after @src. It is allowed for @src and @dest to point into different sequences. - @@ -24299,7 +23172,6 @@ into by @begin and @end. If @dest is %NULL, the range indicated by @begin and @end is removed from the sequence. If @dest points to a place within the (@begin, @end) range, the range does not move. - @@ -24322,7 +23194,6 @@ the (@begin, @end) range, the range does not move. Creates a new GSequence. The @data_destroy function, if non-%NULL will be called on all items when the sequence is destroyed and on items that are removed from the sequence. - a new #GSequence @@ -24341,7 +23212,6 @@ guaranteed to be exactly in the middle. The @begin and @end iterators must both point to the same sequence and @begin must come before or be equal to @end in the sequence. - a #GSequenceIter pointing somewhere in the (@begin, @end) range @@ -24364,7 +23234,6 @@ end iterator to this function. If the sequence has a data destroy function associated with it, this function is called on the data for the removed item. - @@ -24380,7 +23249,6 @@ function is called on the data for the removed item. If the sequence has a data destroy function associated with it, this function is called on the data for the removed items. - @@ -24399,7 +23267,6 @@ function is called on the data for the removed items. Changes the data for the item pointed to by @iter to be @data. If the sequence has a data destroy function associated with it, that function is called on the existing data that @iter pointed to. - @@ -24425,7 +23292,6 @@ may return different values for that item. It should return 0 if the items are equal, a negative value if the first item comes before the second, and a positive value if the second item comes before the first. - @@ -24454,7 +23320,6 @@ the compare function. return 0 if the iterators are equal, a negative value if the first iterator comes before the second, and a positive value if the second iterator comes before the first. - @@ -24476,7 +23341,6 @@ iterator comes before the first. Swaps the items pointed to by @a and @b. It is allowed for @a and @b to point into difference sequences. - @@ -24495,13 +23359,11 @@ to point into difference sequences. The #GSequenceIter struct is an opaque data type representing an iterator pointing into a #GSequence. - Returns a negative number if @a comes before @b, 0 if they are equal, and a positive number if @a comes after @b. The @a and @b iterators must point into the same sequence. - a negative number if @a comes before @b, 0 if they are equal, and a positive number if @a comes after @b @@ -24520,7 +23382,6 @@ The @a and @b iterators must point into the same sequence. Returns the position of @iter - the position of @iter @@ -24534,7 +23395,6 @@ The @a and @b iterators must point into the same sequence. Returns the #GSequence that @iter points into. - the #GSequence that @iter points into @@ -24548,7 +23408,6 @@ The @a and @b iterators must point into the same sequence. Returns whether @iter is the begin iterator - whether @iter is the begin iterator @@ -24562,7 +23421,6 @@ The @a and @b iterators must point into the same sequence. Returns whether @iter is the end iterator - Whether @iter is the end iterator @@ -24579,7 +23437,6 @@ The @a and @b iterators must point into the same sequence. If @iter is closer than -@delta positions to the beginning of the sequence, the begin iterator is returned. If @iter is closer than @delta positions to the end of the sequence, the end iterator is returned. - a #GSequenceIter which is @delta positions away from @iter @@ -24599,7 +23456,6 @@ to the end of the sequence, the end iterator is returned. Returns an iterator pointing to the next position after @iter. If @iter is the end iterator, the end iterator is returned. - a #GSequenceIter pointing to the next position after @iter @@ -24614,7 +23470,6 @@ If @iter is the end iterator, the end iterator is returned. Returns an iterator pointing to the previous position before @iter. If @iter is the begin iterator, the begin iterator is returned. - a #GSequenceIter pointing to the previous position before @iter @@ -24632,7 +23487,6 @@ If @iter is the begin iterator, the begin iterator is returned. A #GSequenceIterCompareFunc is a function used to compare iterators. It must return zero if the iterators compare equal, a negative value if @a comes before @b, and a positive value if @b comes before @a. - zero if the iterators are equal, a negative value if @a comes before @b, and a positive value if @b comes before @a. @@ -24655,7 +23509,6 @@ if @a comes before @b, and a positive value if @b comes before @a. Error codes returned by shell functions. - Mismatched or otherwise mangled quoting. @@ -24667,7 +23520,6 @@ if @a comes before @b, and a positive value if @b comes before @a. - @@ -24684,7 +23536,6 @@ if @a comes before @b, and a positive value if @b comes before @a. The `GSource` struct is an opaque data type representing an event source. - @@ -24735,7 +23586,6 @@ additional data. The size passed in must be at least The source will not initially be associated with any #GMainContext and must be added to one with g_source_attach() before it will be executed. - the newly-created #GSource. @@ -24770,7 +23620,6 @@ is attached to it. This API is only intended to be used by implementations of #GSource. Do not call this API on a #GSource that you did not create. - @@ -24798,7 +23647,6 @@ Do not call this API on a #GSource that you did not create. Using this API forces the linear scanning of event sources on each main loop iteration. Newly-written event sources should try to use g_source_add_unix_fd() instead of this API. - @@ -24828,7 +23676,6 @@ This API is only intended to be used by implementations of #GSource. Do not call this API on a #GSource that you did not create. As the name suggests, this function is not available on Windows. - an opaque tag @@ -24854,7 +23701,6 @@ that context. Remove it by calling g_source_destroy(). This function is safe to call from any thread, regardless of which thread the @context is running in. - the ID (greater than 0) for the source within the #GMainContext. @@ -24882,7 +23728,6 @@ g_source_unref() to drop it. This function is safe to call from any thread, regardless of which thread the #GMainContext is running in. - @@ -24896,7 +23741,6 @@ the #GMainContext is running in. Checks whether a source is allowed to be called recursively. see g_source_set_can_recurse(). - whether recursion is allowed. @@ -24917,7 +23761,6 @@ case it will return that #GMainContext). In particular, you can always call this function on the source returned from g_main_current_source(). But calling this function on a source whose #GMainContext has been destroyed is an error. - the #GMainContext with which the source is associated, or %NULL if the context has not @@ -24935,7 +23778,6 @@ whose #GMainContext has been destroyed is an error. This function ignores @source and is otherwise the same as g_get_current_time(). use g_source_get_time() instead - @@ -24960,7 +23802,6 @@ You can only call this function while the source is associated to a #GMainContext instance; calling this function before g_source_attach() or after g_source_destroy() yields undefined behavior. The ID returned is unique within the #GMainContext instance passed to g_source_attach(). - the ID (greater than 0) for the source @@ -24975,8 +23816,7 @@ is unique within the #GMainContext instance passed to g_source_attach(). Gets a name for the source, used in debugging and profiling. The name may be #NULL if it has never been set with g_source_set_name(). - - + the name of the source @@ -24989,7 +23829,6 @@ name may be #NULL if it has never been set with g_source_set_name(). Gets the priority of a source. - the priority of the source @@ -25007,7 +23846,6 @@ g_source_set_ready_time(). Any time before the current monotonic time (including 0) is an indication that the source will fire immediately. - the monotonic ready time, -1 for "never" @@ -25027,7 +23865,6 @@ instead of having to repeatedly get the system monotonic time. The time here is the system monotonic time, if available, or some other reasonable alternative otherwise. See g_get_monotonic_time(). - the monotonic time in microseconds @@ -25052,10 +23889,10 @@ idle_callback (gpointer data) { SomeWidget *self = data; - GDK_THREADS_ENTER (); + g_mutex_lock (&self->idle_id_mutex); // do stuff with self self->idle_id = 0; - GDK_THREADS_LEAVE (); + g_mutex_unlock (&self->idle_id_mutex); return G_SOURCE_REMOVE; } @@ -25063,9 +23900,19 @@ idle_callback (gpointer data) static void some_widget_do_stuff_later (SomeWidget *self) { + g_mutex_lock (&self->idle_id_mutex); self->idle_id = g_idle_add (idle_callback, self); + g_mutex_unlock (&self->idle_id_mutex); } +static void +some_widget_init (SomeWidget *self) +{ + g_mutex_init (&self->idle_id_mutex); + + // ... +} + static void some_widget_finalize (GObject *object) { @@ -25074,6 +23921,8 @@ some_widget_finalize (GObject *object) if (self->idle_id) g_source_remove (self->idle_id); + g_mutex_clear (&self->idle_id_mutex); + G_OBJECT_CLASS (parent_class)->finalize (object); } ]| @@ -25090,12 +23939,12 @@ idle_callback (gpointer data) { SomeWidget *self = data; - GDK_THREADS_ENTER (); + g_mutex_lock (&self->idle_id_mutex); if (!g_source_is_destroyed (g_main_current_source ())) { // do stuff with self } - GDK_THREADS_LEAVE (); + g_mutex_unlock (&self->idle_id_mutex); return FALSE; } @@ -25106,7 +23955,6 @@ Calls to this function from a thread other than the one acquired by the source could be destroyed immediately after this function returns. However, once a source is destroyed it cannot be un-destroyed, so this function can be used for opportunistic checks from any thread. - %TRUE if the source has been destroyed @@ -25130,7 +23978,6 @@ This API is only intended to be used by implementations of #GSource. Do not call this API on a #GSource that you did not create. As the name suggests, this function is not available on Windows. - @@ -25160,7 +24007,6 @@ This API is only intended to be used by implementations of #GSource. Do not call this API on a #GSource that you did not create. As the name suggests, this function is not available on Windows. - the conditions reported on the fd @@ -25178,7 +24024,6 @@ As the name suggests, this function is not available on Windows. Increases the reference count on a source by one. - @source @@ -25195,7 +24040,6 @@ As the name suggests, this function is not available on Windows. This API is only intended to be used by implementations of #GSource. Do not call this API on a #GSource that you did not create. - @@ -25217,7 +24061,6 @@ this source. This API is only intended to be used by implementations of #GSource. Do not call this API on a #GSource that you did not create. - @@ -25243,7 +24086,6 @@ This API is only intended to be used by implementations of #GSource. Do not call this API on a #GSource that you did not create. As the name suggests, this function is not available on Windows. - @@ -25276,7 +24118,6 @@ to the type of source you are using, such as g_idle_add() or g_timeout_add(). It is safe to call this function multiple times on a source which has already been attached to a context. The changes will take effect for the next time the source is dispatched after this call returns. - @@ -25310,7 +24151,6 @@ than @callback_funcs->ref. It is safe to call this function multiple times on a source which has already been attached to a context. The changes will take effect for the next time the source is dispatched after this call returns. - @@ -25335,7 +24175,6 @@ the source is dispatched after this call returns. %TRUE, then while the source is being dispatched then this source will be processed normally. Otherwise, all processing of this source is blocked until the dispatch function returns. - @@ -25367,7 +24206,6 @@ The finalize function can not be used for this purpose as at that point @source is already partially freed and not valid anymore. This should only ever be called from #GSource implementations. - @@ -25385,7 +24223,6 @@ This should only ever be called from #GSource implementations. Sets the source functions (can be used to override default implementations) of an unattached source. - @@ -25417,7 +24254,6 @@ Use caution if changing the name while another thread may be accessing it with g_source_get_name(); that function does not copy the value, and changing the value will free it while the other thread may be attempting to use it. - @@ -25441,7 +24277,6 @@ dispatched. A child source always has the same priority as its parent. It is not permitted to change the priority of a source once it has been added as a child of another source. - @@ -25479,7 +24314,6 @@ destroyed with g_source_destroy(). This API is only intended to be used by implementations of #GSource. Do not call this API on a #GSource that you did not create. - @@ -25499,7 +24333,6 @@ Do not call this API on a #GSource that you did not create. Decreases the reference count of a source by one. If the resulting reference count is zero the source and associated memory will be destroyed. - @@ -25530,7 +24363,6 @@ idle may already have run and been removed by the time this function is called on its (now invalid) source ID. This source ID may have been reissued, leading to the operation being performed against the wrong source. - For historical reasons, this function always returns %TRUE @@ -25546,7 +24378,6 @@ wrong source. Removes a source from the default main loop context given the source functions and user data. If multiple sources exist with the same source functions and user data, only one will be destroyed. - %TRUE if a source was found and removed. @@ -25566,7 +24397,6 @@ same source functions and user data, only one will be destroyed. Removes a source from the default main loop context given the user data for the callback. If multiple sources exist with the same user data, only one will be destroyed. - %TRUE if a source was found and removed. @@ -25595,7 +24425,6 @@ idle may already have run and been removed by the time this function is called on its (now invalid) source ID. This source ID may have been reissued, leading to the operation being performed against the wrong source. - @@ -25614,10 +24443,8 @@ wrong source. The `GSourceCallbackFuncs` struct contains functions for managing callback objects. - - @@ -25630,7 +24457,6 @@ functions for managing callback objects. - @@ -25643,7 +24469,6 @@ functions for managing callback objects. - @@ -25667,7 +24492,6 @@ functions for managing callback objects. Dispose function for @source. See g_source_set_dispose_function() for details. - @@ -25681,7 +24505,6 @@ details. This is just a placeholder for #GClosureMarshal, which cannot be used here for dependency reasons. - @@ -25693,7 +24516,6 @@ g_timeout_add_full(), g_idle_add(), and g_idle_add_full(). When calling g_source_set_callback(), you may need to cast a function of a different type to this type. Use G_SOURCE_FUNC() to avoid warnings about incompatible function types. - %FALSE if the source should be removed. #G_SOURCE_CONTINUE and #G_SOURCE_REMOVE are more memorable names for the return value. @@ -25728,10 +24550,8 @@ any events need to be processed. It sets the returned timeout to -1 to indicate that it doesn't mind how long the poll() call blocks. In the check function, it tests the results of the poll() call to see if the required condition has been met, and returns %TRUE if so. - - @@ -25747,7 +24567,6 @@ required condition has been met, and returns %TRUE if so. - @@ -25760,7 +24579,6 @@ required condition has been met, and returns %TRUE if so. - @@ -25779,7 +24597,6 @@ required condition has been met, and returns %TRUE if so. - @@ -25797,9 +24614,7 @@ required condition has been met, and returns %TRUE if so. - - - + Specifies the type of the setup function passed to g_spawn_async(), g_spawn_sync() and g_spawn_async_with_pipes(), which can, in very @@ -25831,7 +24646,6 @@ If you need to set up the child environment differently from the parent, you should use g_get_environ(), g_environ_setenv(), and g_environ_unsetenv(), and then pass the complete environment list to the `g_spawn...` function. - @@ -25844,7 +24658,6 @@ list to the `g_spawn...` function. Error codes returned by spawning processes. - Fork failed due to lack of memory. @@ -25912,7 +24725,6 @@ list to the `g_spawn...` function. Flags passed to g_spawn_sync(), g_spawn_async() and g_spawn_async_with_pipes(). - no flags, default behaviour @@ -25962,11 +24774,9 @@ list to the `g_spawn...` function. system call, depending on the platform and/or compiler being used. See g_stat() for more information. - The GString struct contains the public fields of a GString. - points to the character data. It may move as text is added. The @str field is null-terminated and so @@ -25986,7 +24796,6 @@ See g_stat() for more information. Adds a string onto the end of a #GString, expanding it if necessary. - @string @@ -26005,7 +24814,6 @@ it if necessary. Adds a byte onto the end of a #GString, expanding it if necessary. - @string @@ -26031,7 +24839,6 @@ ensure that @val has at least @len addressable bytes. If @len is negative, @val must be nul-terminated and @len is considered to request the entire string length. This makes g_string_append_len() equivalent to g_string_append(). - @string @@ -26055,7 +24862,6 @@ makes g_string_append_len() equivalent to g_string_append(). Appends a formatted string onto the end of a #GString. This function is similar to g_string_printf() except that the text is appended to the #GString. - @@ -26077,7 +24883,6 @@ that the text is appended to the #GString. Converts a Unicode character into UTF-8, and appends it to the string. - @string @@ -26096,7 +24901,6 @@ to the string. Appends @unescaped to @string, escaping any characters that are reserved in URIs using URI-style escape sequences. - @string @@ -26126,7 +24930,6 @@ are reserved in URIs using URI-style escape sequences. This function is similar to g_string_append_printf() except that the arguments to the format string are passed as a va_list. - @@ -26147,7 +24950,6 @@ as a va_list. Converts all uppercase ASCII letters to lowercase ASCII letters. - passed-in @string pointer, with all the uppercase characters converted to lowercase in place, @@ -26163,7 +24965,6 @@ as a va_list. Converts all lowercase ASCII letters to uppercase ASCII letters. - passed-in @string pointer, with all the lowercase characters converted to uppercase in place, @@ -26182,7 +24983,6 @@ as a va_list. destroying any previous contents. It is rather like the standard strcpy() function, except that you do not have to worry about having enough space to copy the string. - @string @@ -26204,7 +25004,6 @@ have to worry about having enough space to copy the string. This function uses the locale-specific tolower() function, which is almost never the right thing. Use g_string_ascii_down() or g_utf8_strdown() instead. - the #GString @@ -26219,7 +25018,6 @@ have to worry about having enough space to copy the string. Compares two strings for equality, returning %TRUE if they are equal. For use with #GHashTable. - %TRUE if the strings are the same length and contain the same bytes @@ -26239,7 +25037,6 @@ For use with #GHashTable. Removes @len bytes from a #GString, starting at position @pos. The rest of the #GString is shifted down to fill the gap. - @string @@ -26265,7 +25062,6 @@ The rest of the #GString is shifted down to fill the gap. If @free_segment is %TRUE it also frees the character data. If it's %FALSE, the caller gains ownership of the buffer and must free it after use with g_free(). - the character data of @string (i.e. %NULL if @free_segment is %TRUE) @@ -26291,7 +25087,6 @@ Note that while #GString ensures that its buffer always has a trailing nul character (not reflected in its "len"), the returned #GBytes does not include this extra nul; i.e. it has length exactly equal to the "len" member. - A newly allocated #GBytes containing contents of @string; @string itself is freed @@ -26305,7 +25100,6 @@ equal to the "len" member. Creates a hash code for @str; for use with #GHashTable. - hash code for @str @@ -26320,7 +25114,6 @@ equal to the "len" member. Inserts a copy of a string into a #GString, expanding it if necessary. - @string @@ -26342,7 +25135,6 @@ expanding it if necessary. Inserts a byte into a #GString, expanding it if necessary. - @string @@ -26373,7 +25165,6 @@ If @len is negative, @val must be nul-terminated and @len is considered to request the entire string length. If @pos is -1, bytes are inserted at the end of the string. - @string @@ -26401,7 +25192,6 @@ If @pos is -1, bytes are inserted at the end of the string. Converts a Unicode character into UTF-8, and insert it into the string at the given position. - @string @@ -26424,7 +25214,6 @@ into the string at the given position. Overwrites part of a string, lengthening it if necessary. - @string @@ -26447,7 +25236,6 @@ into the string at the given position. Overwrites part of a string, lengthening it if necessary. This function will work with embedded nuls. - @string @@ -26474,7 +25262,6 @@ This function will work with embedded nuls. Adds a string on to the start of a #GString, expanding it if necessary. - @string @@ -26493,7 +25280,6 @@ expanding it if necessary. Adds a byte onto the start of a #GString, expanding it if necessary. - @string @@ -26519,7 +25305,6 @@ ensure that @val has at least @len addressable bytes. If @len is negative, @val must be nul-terminated and @len is considered to request the entire string length. This makes g_string_prepend_len() equivalent to g_string_prepend(). - @string @@ -26542,7 +25327,6 @@ makes g_string_prepend_len() equivalent to g_string_prepend(). Converts a Unicode character into UTF-8, and prepends it to the string. - @string @@ -26564,7 +25348,6 @@ This is similar to the standard sprintf() function, except that the #GString buffer automatically expands to contain the results. The previous contents of the #GString are destroyed. - @@ -26589,7 +25372,6 @@ the current length, the string will be truncated. If the length is greater than the current length, the contents of the newly added area are undefined. (However, as always, string->str[string->len] will be a nul byte.) - @string @@ -26607,7 +25389,6 @@ always, string->str[string->len] will be a nul byte.) Cuts off the end of the GString, leaving the first @len bytes. - @string @@ -26628,7 +25409,6 @@ always, string->str[string->len] will be a nul byte.) This function uses the locale-specific toupper() function, which is almost never the right thing. Use g_string_ascii_up() or g_utf8_strup() instead. - @string @@ -26644,7 +25424,6 @@ always, string->str[string->len] will be a nul byte.) Writes a formatted string into a #GString. This function is similar to g_string_printf() except that the arguments to the format string are passed as a va_list. - @@ -26667,12 +25446,10 @@ the arguments to the format string are passed as a va_list. An opaque data structure representing String Chunks. It should only be accessed by using the following functions. - Frees all strings contained within the #GStringChunk. After calling g_string_chunk_clear() it is not safe to access any of the strings which were contained within it. - @@ -26687,7 +25464,6 @@ access any of the strings which were contained within it. Frees all memory allocated by the #GStringChunk. After calling g_string_chunk_free() it is not safe to access any of the strings which were contained within it. - @@ -26710,7 +25486,6 @@ does not check for duplicates. Also strings added with g_string_chunk_insert() will not be searched by g_string_chunk_insert_const() when looking for duplicates. - a pointer to the copy of @string within the #GStringChunk @@ -26741,7 +25516,6 @@ should be done very carefully. Note that g_string_chunk_insert_const() will not return a pointer to a string added with g_string_chunk_insert(), even if they do match. - a pointer to the new or existing copy of @string within the #GStringChunk @@ -26768,7 +25542,6 @@ bytes. The characters in the returned string can be changed, if necessary, though you should not change anything after the end of the string. - a pointer to the copy of @string within the #GStringChunk @@ -26791,7 +25564,6 @@ though you should not change anything after the end of the string. Creates a new #GStringChunk. - a new #GStringChunk @@ -26830,38 +25602,31 @@ guaranteed to be stable API — always use a getter function to retrieve th The subdirectories may not be created by the test harness; as with normal calls to functions like g_get_user_cache_dir(), the caller must be prepared to create the directory if it doesn’t exist. - Evaluates to a time span of one day. - Evaluates to a time span of one hour. - Evaluates to a time span of one millisecond. - Evaluates to a time span of one minute. - Evaluates to a time span of one second. - Works like g_mutex_trylock(), but for a lock defined with #G_LOCK_DEFINE. - the name of the lock @@ -26870,10 +25635,8 @@ to create the directory if it doesn’t exist. An opaque structure representing a test case. - - @@ -26896,7 +25659,6 @@ to create the directory if it doesn’t exist. The type used for test case functions that take an extra pointer argument. - @@ -26924,7 +25686,6 @@ Note: as a general rule of automake, files that are generated only as part of the build-from-git process (but then are distributed with the tarball) always go in srcdir (even if doing a srcdir != builddir build from git) and are considered as distributed files. - a file that was included in the distribution tarball @@ -26943,7 +25704,6 @@ the test case. @fixture will be a pointer to the area of memory allocated by the test framework, of the size requested. If the requested size was zero then @fixture will be equal to @user_data. - @@ -26960,13 +25720,11 @@ zero then @fixture will be equal to @user_data. The type used for test case functions. - - @@ -26977,7 +25735,6 @@ zero then @fixture will be equal to @user_data. Internal function for gtester to free test log messages, no ABI guarantees provided. - @@ -26989,7 +25746,6 @@ zero then @fixture will be equal to @user_data. Internal function for gtester to retrieve test log messages, no ABI guarantees provided. - @@ -27001,7 +25757,6 @@ zero then @fixture will be equal to @user_data. Internal function for gtester to decode test log messages, no ABI guarantees provided. - @@ -27019,7 +25774,6 @@ zero then @fixture will be equal to @user_data. Internal function for gtester to decode test log messages, no ABI guarantees provided. - @@ -27027,7 +25781,6 @@ zero then @fixture will be equal to @user_data. Specifies the prototype of fatal log handler functions. - %TRUE if the program should abort, %FALSE otherwise @@ -27052,7 +25805,6 @@ zero then @fixture will be equal to @user_data. - @@ -27070,7 +25822,6 @@ zero then @fixture will be equal to @user_data. Internal function for gtester to free test log messages, no ABI guarantees provided. - @@ -27082,7 +25833,6 @@ zero then @fixture will be equal to @user_data. - @@ -27109,7 +25859,6 @@ zero then @fixture will be equal to @user_data. - @@ -27124,7 +25873,6 @@ zero then @fixture will be equal to @user_data. Note that in contrast with g_test_trap_fork(), the default is to not show stdout and stderr. - If this flag is given, the child process will inherit the parent's stdin. Otherwise, the child's @@ -27145,10 +25893,8 @@ not show stdout and stderr. An opaque structure representing a test suite. - Adds @test_case to @suite. - @@ -27165,7 +25911,6 @@ not show stdout and stderr. Adds @nestedsuite to @suite. - @@ -27187,7 +25932,6 @@ These flags determine what traps to set. #GTestTrapFlags is used only with g_test_trap_fork(), which is deprecated. g_test_trap_subprocess() uses #GTestSubprocessFlags. - Redirect stdout of the test child to `/dev/null` so it cannot be observed on the console during test @@ -27220,7 +25964,6 @@ explicitly. The structure is opaque -- none of its fields may be directly accessed. - This function creates a new thread. The new thread starts by invoking @func with the argument data. The thread will run until @func returns @@ -27249,7 +25992,6 @@ This behaviour changed in GLib 2.64: before threads on Windows were not inheriting the thread priority but were spawned with the default priority. Starting with GLib 2.64 the behaviour is now consistent between Windows and POSIX and all threads inherit their parent thread's priority. - the new #GThread @@ -27275,7 +26017,6 @@ it allows for the possibility of failure. If a thread can not be created (due to resource limits), @error is set and %NULL is returned. - the new #GThread, or %NULL if an error occurred @@ -27312,7 +26053,6 @@ g_thread_join() consumes the reference to the passed-in @thread. This will usually cause the #GThread struct and associated resources to be freed. Use g_thread_ref() to obtain an extra reference if you want to keep the GThread alive beyond the g_thread_join() call. - the return value of the thread @@ -27326,7 +26066,6 @@ want to keep the GThread alive beyond the g_thread_join() call. Increase the reference count on @thread. - a new reference to @thread @@ -27345,7 +26084,6 @@ resources associated with it. Note that each thread holds a reference to its #GThread while it is running, so it is safe to drop your own reference to it if you don't need it anymore. - @@ -27375,7 +26113,6 @@ You must only call g_thread_exit() from a thread that you created yourself with g_thread_new() or related APIs. You must not call this function from a thread created with another threading library or or from within a #GThreadPool. - @@ -27396,7 +26133,6 @@ were not created by GLib (i.e. those created by other threading APIs). This may be useful for thread identification purposes (i.e. comparisons) but you must not use GLib functions (such as g_thread_join()) on these threads. - the #GThread representing the current thread @@ -27407,7 +26143,6 @@ as g_thread_join()) on these threads. that other threads can run. This function is often used as a method to make busy wait less evil. - @@ -27415,7 +26150,6 @@ This function is often used as a method to make busy wait less evil. Possible errors of thread related functions. - a thread couldn't be created due to resource shortage. Try again later. @@ -27424,7 +26158,6 @@ This function is often used as a method to make busy wait less evil. Specifies the type of the @func functions passed to g_thread_new() or g_thread_try_new(). - the return value of the thread @@ -27440,7 +26173,6 @@ or g_thread_try_new(). The #GThreadPool struct represents a thread pool. It has three public read-only members, but the underlying struct is bigger, so you must not copy this struct. - the function to execute in the threads of this pool @@ -27468,7 +26200,6 @@ or only the currently running) are ready. Otherwise this function returns immediately. After calling this function @pool must not be used anymore. - @@ -27489,7 +26220,6 @@ After calling this function @pool must not be used anymore. Returns the maximal number of threads for @pool. - the maximal number of threads @@ -27503,7 +26233,6 @@ After calling this function @pool must not be used anymore. Returns the number of threads currently running in @pool. - the number of threads currently running @@ -27518,7 +26247,6 @@ After calling this function @pool must not be used anymore. Moves the item to the front of the queue of unprocessed items, so that it will be processed next. - %TRUE if the item was found and moved @@ -27549,7 +26277,6 @@ created. In that case @data is simply appended to the queue of work to do. Before version 2.32, this function did not return a success status. - %TRUE on success, %FALSE if an error occurred @@ -27586,7 +26313,6 @@ errors. An error can only occur when a new thread couldn't be created. Before version 2.32, this function did not return a success status. - %TRUE on success, %FALSE if an error occurred @@ -27613,7 +26339,6 @@ that threads are executed cannot be guaranteed 100%. Threads are scheduled by the operating system and are executed at random. It cannot be assumed that threads are executed in the order they are created. - @@ -27639,7 +26364,6 @@ created. Returns the number of tasks still unprocessed in @pool. - the number of unprocessed tasks @@ -27658,7 +26382,6 @@ being stopped. If this function returns 0, threads waiting in the thread pool for new work are not stopped. - the maximum @interval (milliseconds) to wait for new tasks in the thread pool before stopping the @@ -27668,7 +26391,6 @@ pool for new work are not stopped. Returns the maximal allowed number of unused threads. - the maximal number of unused threads @@ -27676,7 +26398,6 @@ pool for new work are not stopped. Returns the number of currently unused threads. - the number of currently unused threads @@ -27714,7 +26435,6 @@ errors. An error can only occur when @exclusive is set to %TRUE and not all @max_threads threads could be created. See #GThreadError for possible errors that may occur. Note, even in case of error a valid #GThreadPool is returned. - the new #GThreadPool @@ -27750,7 +26470,6 @@ except this is done on a per thread basis. By setting @interval to 0, idle threads will not be stopped. The default value is 15000 (15 seconds). - @@ -27768,7 +26487,6 @@ If @max_threads is -1, no limit is imposed on the number of unused threads. The default value is 2. - @@ -27783,7 +26501,6 @@ The default value is 2. Stops all currently unused threads. This does not change the maximal number of unused threads. This function can be used to regularly stop all unused threads e.g. from g_timeout_add(). - @@ -27798,7 +26515,6 @@ Second, if the time is in local time, specifies if it is local standard time or local daylight time. This is important for the case where the same local time occurs twice (during daylight savings time transitions, for example). - the time is in local standard time @@ -27820,7 +26536,6 @@ removed from a future version of GLib. A consequence of using `glong` for `tv_sec` is that on 32-bit systems `GTimeVal` is subject to the year 2038 problem. Use #GDateTime or #guint64 instead. - seconds @@ -27834,7 +26549,6 @@ problem. also be negative to decrease the value of @time_. #GTimeVal is not year-2038-safe. Use `guint64` for representing microseconds since the epoch, or use #GDateTime. - @@ -27886,7 +26600,6 @@ The return value of g_time_val_to_iso8601() has been nullable since GLib 2.54; before then, GLib would crash under the same conditions. #GTimeVal is not year-2038-safe. Use g_date_time_format_iso8601(dt) instead. - a newly allocated string containing an ISO 8601 date, or %NULL if @time_ was too large @@ -27919,7 +26632,6 @@ g_date_time_unref (dt); ]| #GTimeVal is not year-2038-safe. Use g_date_time_new_from_iso8601() instead. - %TRUE if the conversion was successful. @@ -27939,73 +26651,15 @@ g_date_time_unref (dt); #GTimeZone is an opaque structure whose members cannot be accessed directly. - - - Creates a #GTimeZone corresponding to @identifier. + + A version of g_time_zone_new_identifier() which returns the UTC time zone +if @identifier could not be parsed or loaded. -@identifier can either be an RFC3339/ISO 8601 time offset or -something that would pass as a valid value for the `TZ` environment -variable (including %NULL). - -In Windows, @identifier can also be the unlocalized name of a time -zone for standard time, for example "Pacific Standard Time". - -Valid RFC3339 time offsets are `"Z"` (for UTC) or -`"±hh:mm"`. ISO 8601 additionally specifies -`"±hhmm"` and `"±hh"`. Offsets are -time values to be added to Coordinated Universal Time (UTC) to get -the local time. - -In UNIX, the `TZ` environment variable typically corresponds -to the name of a file in the zoneinfo database, an absolute path to a file -somewhere else, or a string in -"std offset [dst [offset],start[/time],end[/time]]" (POSIX) format. -There are no spaces in the specification. The name of standard -and daylight savings time zone must be three or more alphabetic -characters. Offsets are time values to be added to local time to -get Coordinated Universal Time (UTC) and should be -`"[±]hh[[:]mm[:ss]]"`. Dates are either -`"Jn"` (Julian day with n between 1 and 365, leap -years not counted), `"n"` (zero-based Julian day -with n between 0 and 365) or `"Mm.w.d"` (day d -(0 <= d <= 6) of week w (1 <= w <= 5) of month m (1 <= m <= 12), day -0 is a Sunday). Times are in local wall clock time, the default is -02:00:00. - -In Windows, the "tzn[+|–]hh[:mm[:ss]][dzn]" format is used, but also -accepts POSIX format. The Windows format uses US rules for all time -zones; daylight savings time is 60 minutes behind the standard time -with date and time of change taken from Pacific Standard Time. -Offsets are time values to be added to the local time to get -Coordinated Universal Time (UTC). - -g_time_zone_new_local() calls this function with the value of the -`TZ` environment variable. This function itself is independent of -the value of `TZ`, but if @identifier is %NULL then `/etc/localtime` -will be consulted to discover the correct time zone on UNIX and the -registry will be consulted or GetTimeZoneInformation() will be used -to get the local time zone on Windows. - -If intervals are not available, only time zone rules from `TZ` -environment variable or other means, then they will be computed -from year 1900 to 2037. If the maximum year for the rules is -available and it is greater than 2037, then it will followed -instead. - -See -[RFC3339 §5.6](http://tools.ietf.org/html/rfc3339#section-5.6) -for a precise definition of valid RFC3339 time offsets -(the `time-offset` expansion) and ISO 8601 for the -full list of valid time offsets. See -[The GNU C Library manual](http://www.gnu.org/s/libc/manual/html_node/TZ-Variable.html) -for an explanation of the possible -values of the `TZ` environment variable. See -[Microsoft Time Zone Index Values](http://msdn.microsoft.com/en-us/library/ms912391%28v=winembedded.11%29.aspx) -for the list of time zones on Windows. - -You should release the return value by calling g_time_zone_unref() -when you are done with it. - +If you need to check whether @identifier was loaded successfully, use +g_time_zone_new_identifier(). + Use g_time_zone_new_identifier() instead, as it provides + error reporting. Change your code to handle a potentially %NULL return + value. the requested timezone @@ -28027,7 +26681,6 @@ the `TZ` environment variable (including the possibility of %NULL). You should release the return value by calling g_time_zone_unref() when you are done with it. - the local timezone @@ -28039,7 +26692,6 @@ in seconds. This is equivalent to calling g_time_zone_new() with a string in the form `[+|-]hh[:mm[:ss]]`. - a timezone at the given offset from UTC @@ -28059,7 +26711,6 @@ This is equivalent to calling g_time_zone_new() with a value like You should release the return value by calling g_time_zone_unref() when you are done with it. - the universal timezone @@ -28082,7 +26733,6 @@ non-existent times. If the non-existent local @time_ of 02:30 were requested on March 14th 2010 in Toronto then this function would adjust @time_ to be 03:00 and return the interval containing the adjusted time. - the interval containing @time_, never -1 @@ -28121,7 +26771,6 @@ It is still possible for this function to fail. In Toronto, for example, 02:00 on March 14th 2010 does not exist (due to the leap forward to begin daylight savings time). -1 is returned in that case. - the interval containing @time_, or -1 in case of failure @@ -28148,7 +26797,6 @@ case. For example, in Toronto this is currently "EST" during the winter months and "EDT" during the summer months when daylight savings time is in effect. - the time zone abbreviation, which belongs to @tz @@ -28173,7 +26821,6 @@ construction time will be returned. The identifier will be returned in the same format as provided at construction time: if provided as a time offset, that will be returned by this function. - identifier for this timezone @@ -28192,7 +26839,6 @@ of time in the time zone @tz. The offset is the number of seconds that you add to UTC time to arrive at local time for @tz (ie: negative numbers for time zones west of GMT, positive numbers for east). - the number of seconds that should be added to UTC to get the local time in @tz @@ -28212,7 +26858,6 @@ west of GMT, positive numbers for east). Determines if daylight savings time is in effect during a particular @interval of time in the time zone @tz. - %TRUE if daylight savings time is in effect @@ -28230,7 +26875,6 @@ west of GMT, positive numbers for east). Increases the reference count on @tz. - a new reference to @tz. @@ -28244,7 +26888,6 @@ west of GMT, positive numbers for east). Decreases the reference count on @tz. - @@ -28258,12 +26901,10 @@ west of GMT, positive numbers for east). Opaque datatype that records a start time. - Resumes a timer that has previously been stopped with g_timer_stop(). g_timer_stop() must be called before using this function. - @@ -28276,7 +26917,6 @@ function. Destroys a timer, freeing associated resources. - @@ -28294,7 +26934,6 @@ elapsed time between the time it was started and the time it was stopped. The return value is the number of seconds elapsed, including any fractional part. The @microseconds out parameter is essentially useless. - seconds elapsed as a floating point value, including any fractional part. @@ -28315,7 +26954,6 @@ essentially useless. Exposes whether the timer is currently active. - %TRUE if the timer is running, %FALSE otherwise @@ -28331,7 +26969,6 @@ essentially useless. This function is useless; it's fine to call g_timer_start() on an already-started timer to reset the start time, so g_timer_reset() serves no purpose. - @@ -28347,7 +26984,6 @@ serves no purpose. report the time since g_timer_start() was called. g_timer_new() automatically marks the start time, so no need to call g_timer_start() immediately after creating the timer. - @@ -28361,7 +26997,6 @@ g_timer_start() immediately after creating the timer. Marks an end time, so calls to g_timer_elapsed() will return the difference between this end time and the start time. - @@ -28375,7 +27010,6 @@ difference between this end time and the start time. Creates a new timer, and starts timing (i.e. g_timer_start() is implicitly called for you). - a new #GTimer. @@ -28385,7 +27019,6 @@ implicitly called for you). The possible types of token returned from each g_scanner_get_next_token() call. - the end of the file @@ -28458,7 +27091,6 @@ g_scanner_get_next_token() call. A union holding the value of the token. - token symbol value @@ -28511,7 +27143,6 @@ g_scanner_get_next_token() call. The type of functions which are used to translate user-visible strings, for <option>--help</option> output. - a translation of the string for the current locale. The returned string is owned by GLib and must not be freed. @@ -28533,7 +27164,6 @@ strings, for <option>--help</option> output. Each piece of memory that is pushed onto the stack is cast to a GTrashStack*. #GTrashStack is deprecated without replacement - pointer to the previous element of the stack, gets stored in the first `sizeof (gpointer)` @@ -28546,7 +27176,6 @@ is cast to a GTrashStack*. Note that execution of this function is of O(N) complexity where N denotes the number of items on the stack. #GTrashStack is deprecated without replacement - the height of the stack @@ -28562,7 +27191,6 @@ where N denotes the number of items on the stack. Returns the element at the top of a #GTrashStack which may be %NULL. #GTrashStack is deprecated without replacement - the element at the top of the stack @@ -28577,7 +27205,6 @@ which may be %NULL. Pops a piece of memory off a #GTrashStack. #GTrashStack is deprecated without replacement - the element at the top of the stack @@ -28592,7 +27219,6 @@ which may be %NULL. Pushes a piece of memory onto a #GTrashStack. #GTrashStack is deprecated without replacement - @@ -28611,7 +27237,6 @@ which may be %NULL. Specifies which nodes are visited during several of the tree functions, including g_node_traverse() and g_node_find(). - only leaf nodes should be visited. This name has been introduced in 2.6, for older version use @@ -28640,7 +27265,6 @@ functions, including g_node_traverse() and g_node_find(). passed the key and value of each node, together with the @user_data parameter passed to g_tree_traverse(). If the function returns %TRUE, the traversal is stopped. - %TRUE to stop the traversal @@ -28672,7 +27296,6 @@ illustrated here: ![](Sorted_binary_tree_postorder.svg) - Level order: F, B, G, A, D, I, C, E, H ![](Sorted_binary_tree_breadth-first_traversal.svg) - vists a node's left child first, then the node itself, then its right child. This is the one to use if you @@ -28698,7 +27321,6 @@ illustrated here: The GTree struct is an opaque data structure representing a [balanced binary tree][glib-Balanced-Binary-Trees]. It should be accessed only by using the following functions. - Removes all keys and values from the #GTree and decreases its reference count by one. If keys and/or values are dynamically @@ -28706,7 +27328,6 @@ allocated, you should either free them first or create the #GTree using g_tree_new_full(). In the latter case the destroy functions you supplied will be called on all keys and values before destroying the #GTree. - @@ -28726,7 +27347,6 @@ The tree may not be modified while iterating over it (you can't add/remove items). To remove all items matching a predicate, you need to add each item to a list in your #GTraverseFunc as you walk over the tree, then walk the list and remove each item. - @@ -28752,7 +27372,6 @@ the tree, then walk the list and remove each item. If the #GTree contains no nodes, the height is 0. If the #GTree contains only one root node the height is 1. If the root node has children the height is 2, etc. - the height of @tree @@ -28767,18 +27386,8 @@ If the root node has children the height is 2, etc. Inserts a key/value pair into a #GTree. -If the given key already exists in the #GTree its corresponding value -is set to the new value. If you supplied a @value_destroy_func when -creating the #GTree, the old value is freed using that function. If -you supplied a @key_destroy_func when creating the #GTree, the passed -key is freed using that function. - -The tree is automatically 'balanced' as new key/value pairs are added, -so that the distance from the root to every leaf is as small as possible. -The cost of maintaining a balanced tree while inserting new key/value -result in a O(n log(n)) operation where most of the other operations -are O(log(n)). - +Inserts a new key and value into a #GTree as g_tree_insert_node() does, +only this function does not return the inserted or set node. @@ -28801,7 +27410,6 @@ are O(log(n)). Gets the value corresponding to the given key. Since a #GTree is automatically balanced as key/value pairs are added, key lookup is O(log n) (where n is the number of key/value pairs in the tree). - the value corresponding to the key, or %NULL if the key was not found @@ -28823,7 +27431,6 @@ is O(log n) (where n is the number of key/value pairs in the tree). associated value. This is useful if you need to free the memory allocated for the original key, for example before calling g_tree_remove(). - %TRUE if the key was found in the #GTree @@ -28849,7 +27456,6 @@ g_tree_remove(). Gets the number of nodes in a #GTree. - the number of nodes in @tree @@ -28865,7 +27471,6 @@ g_tree_remove(). Increments the reference count of @tree by one. It is safe to call this function from any thread. - the passed in #GTree @@ -28888,7 +27493,6 @@ If the key does not exist in the #GTree, the function does nothing. The cost of maintaining a balanced tree while removing a key/value result in a O(n log(n)) operation where most of the other operations are O(log(n)). - %TRUE if the key was found (prior to 2.8, this function returned nothing) @@ -28906,16 +27510,8 @@ are O(log(n)). - Inserts a new key and value into a #GTree similar to g_tree_insert(). -The difference is that if the key already exists in the #GTree, it gets -replaced by the new key. If you supplied a @value_destroy_func when -creating the #GTree, the old value is freed using that function. If you -supplied a @key_destroy_func when creating the #GTree, the old key is -freed using that function. - -The tree is automatically 'balanced' as new key/value pairs are added, -so that the distance from the root to every leaf is as small as possible. - + Inserts a new key and value into a #GTree as g_tree_replace_node() does, +only this function does not return the inserted or set node. @@ -28944,7 +27540,6 @@ the result of g_tree_search(). If @search_func returns -1, searching will proceed among the key/value pairs that have a smaller key; if @search_func returns 1, searching will proceed among the key/value pairs that have a larger key. - the value corresponding to the found key, or %NULL if the key was not found @@ -28970,7 +27565,6 @@ pairs that have a larger key. the key and value destroy functions. If the key does not exist in the #GTree, the function does nothing. - %TRUE if the key was found (prior to 2.8, this function returned nothing) @@ -28993,7 +27587,6 @@ If the key does not exist in the #GTree, the function does nothing. If you just want to visit all nodes in sorted order, use g_tree_foreach() instead. If you really need to visit nodes in a different order, consider using an [n-ary tree][glib-N-ary-Trees]. - @@ -29025,7 +27618,6 @@ be destroyed (if destroy functions were specified) and all memory allocated by @tree will be released. It is safe to call this function from any thread. - @@ -29038,7 +27630,6 @@ It is safe to call this function from any thread. Creates a new #GTree. - a newly allocated #GTree @@ -29058,7 +27649,6 @@ It is safe to call this function from any thread. Creates a new #GTree like g_tree_new() and allows to specify functions to free the memory allocated for the key and value that get called when removing the entry from the #GTree. - a newly allocated #GTree @@ -29089,7 +27679,6 @@ removing the entry from the #GTree. Creates a new #GTree with a comparison function that accepts user data. See g_tree_new() for more details. - a newly allocated #GTree @@ -29110,7 +27699,6 @@ See g_tree_new() for more details. This macro can be used to mark a function declaration as unavailable. It must be placed before the function declaration. Use of a function that has been annotated with this macros will produce a compiler warning. - the major version that introduced the symbol @@ -29121,7 +27709,6 @@ that has been annotated with this macros will produce a compiler warning. - @@ -29130,7 +27717,6 @@ that has been annotated with this macros will produce a compiler warning. - @@ -29139,7 +27725,6 @@ that has been annotated with this macros will produce a compiler warning. - @@ -29148,7 +27733,6 @@ that has been annotated with this macros will produce a compiler warning. - @@ -29161,7 +27745,6 @@ that has been annotated with this macros will produce a compiler warning. decomposition of a single Unicode character. This is as defined by Unicode 6.1. - @@ -29172,7 +27755,6 @@ a true value. The compiler may use this information for optimizations. if (G_UNLIKELY (random () == 1)) g_print ("a random one"); ]| - the expression @@ -29182,7 +27764,6 @@ if (G_UNLIKELY (random () == 1)) Works like g_mutex_unlock(), but for a lock defined with #G_LOCK_DEFINE. - the name of the lock @@ -29192,19 +27773,16 @@ if (G_UNLIKELY (random () == 1)) Generic delimiters characters as defined in [RFC 3986](https://tools.ietf.org/html/rfc3986). Includes `:/?#[]@`. - Subcomponent delimiter characters as defined in [RFC 3986](https://tools.ietf.org/html/rfc3986). Includes `!$&'()*+,;=`. - Number of microseconds in one second (1 million). This macro is provided for code readability. - @@ -29214,7 +27792,6 @@ Since new unicode versions may add new types here, applications should be ready to handle unknown values. They may be regarded as %G_UNICODE_BREAK_UNKNOWN. See [Unicode Line Breaking Algorithm](http://www.unicode.org/unicode/reports/tr14/). - Mandatory Break (BK) @@ -29354,7 +27931,6 @@ and is interchangeable with #PangoScript. Note that new types may be added in the future. Applications should be ready to handle unknown values. See [Unicode Standard Annex #24: Script names](http://www.unicode.org/reports/tr24/). - a value never returned from g_unichar_get_script() @@ -29835,7 +28411,6 @@ See [Unicode Standard Annex #24: Script names](http://www.unicode.org/reports/tr These are the possible character classifications from the Unicode specification. See [Unicode Character Database](http://www.unicode.org/reports/tr44/#General_Category_Values). - General category "Other, Control" (Cc) @@ -29930,7 +28505,6 @@ See [Unicode Character Database](http://www.unicode.org/reports/tr44/#General_Ca The type of functions to be called when a UNIX fd watch source triggers. - %FALSE if the source should be removed @@ -30053,12 +28627,12 @@ g_filename_to_uri() if you want to properly convert between Note that there is no `g_uri_equal ()` function, because comparing URIs usefully requires scheme-specific knowledge that #GUri does -not have. For example, `http://example.com/` and -`http://EXAMPLE.COM:80` have exactly the same meaning according -to the HTTP specification, and `data:,foo` and -`data:;base64,Zm9v` resolve to the same thing according to the -`data:` URI specification. - +not have. #GUri can help with normalization if you use the various +encoded #GUriFlags as well as %G_URI_FLAGS_SCHEME_NORMALIZE however +it is not comprehensive. +For example, `data:,foo` and `data:;base64,Zm9v` resolve to the same +thing according to the `data:` URI specification which GLib does not +handle. Gets @uri's authentication parameters, which may contain `%`-encoding, depending on the flags with which @uri was created. @@ -30067,7 +28641,6 @@ be %NULL.) Depending on the URI scheme, g_uri_parse_params() may be useful for further parsing this information. - @uri's authentication parameters. @@ -30081,7 +28654,6 @@ further parsing this information. Gets @uri's flags set upon construction. - @uri's flags. @@ -30096,7 +28668,6 @@ further parsing this information. Gets @uri's fragment, which may contain `%`-encoding, depending on the flags with which @uri was created. - @uri's fragment. @@ -30118,8 +28689,7 @@ that address, without the brackets around it that are necessary in the string form of the URI. Note that in this case there may also be a scope ID attached to the address. Eg, `fe80::1234%``em1` (or `fe80::1234%``25em1` if the string is still encoded). - - + @uri's host. @@ -30134,7 +28704,6 @@ be a scope ID attached to the address. Eg, `fe80::1234%``em1` (or Gets @uri's password, which may contain `%`-encoding, depending on the flags with which @uri was created. (If @uri was not created with %G_URI_FLAGS_HAS_PASSWORD then this will be %NULL.) - @uri's password. @@ -30149,7 +28718,6 @@ with %G_URI_FLAGS_HAS_PASSWORD then this will be %NULL.) Gets @uri's path, which may contain `%`-encoding, depending on the flags with which @uri was created. - @uri's path. @@ -30163,7 +28731,6 @@ flags with which @uri was created. Gets @uri's port. - @uri's port, or `-1` if no port was specified. @@ -30181,7 +28748,6 @@ flags with which @uri was created. For queries consisting of a series of `name=value` parameters, #GUriParamsIter or g_uri_parse_params() may be useful. - @uri's query. @@ -30196,7 +28762,6 @@ For queries consisting of a series of `name=value` parameters, Gets @uri's scheme. Note that this will always be all-lowercase, regardless of the string or strings that @uri was created from. - @uri's scheme. @@ -30213,7 +28778,6 @@ regardless of the string or strings that @uri was created from. `%`-encoding, depending on the flags with which @uri was created. If @uri was not created with %G_URI_FLAGS_HAS_PASSWORD or %G_URI_FLAGS_HAS_AUTH_PARAMS, this is the same as g_uri_get_userinfo(). - @uri's user. @@ -30228,7 +28792,6 @@ If @uri was not created with %G_URI_FLAGS_HAS_PASSWORD or Gets @uri's userinfo, which may contain `%`-encoding, depending on the flags with which @uri was created. - @uri's userinfo. @@ -30245,9 +28808,8 @@ the flags with which @uri was created. [relative URI][relative-absolute-uris], resolves it relative to @base_uri. If the result is not a valid absolute URI, it will be discarded, and an error returned. - - a new #GUri. + a new #GUri, or NULL on error. @@ -30267,7 +28829,6 @@ returned. Increments the reference count of @uri by one. - @uri @@ -30292,10 +28853,9 @@ URI (according to RFC 3986). If @uri might contain sensitive details, such as authentication parameters, or private data in its query string, and the returned string is going to be logged, then consider using g_uri_to_string_partial() to redact parts. - - a string representing @uri, which the caller - must free. + a string representing @uri, + which the caller must free. @@ -30308,10 +28868,9 @@ logged, then consider using g_uri_to_string_partial() to redact parts. Returns a string representing @uri, subject to the options in @flags. See g_uri_to_string() and #GUriHideFlags for more details. - - a string representing @uri, which the caller - must free. + a string representing + @uri, which the caller must free. @@ -30330,7 +28889,6 @@ logged, then consider using g_uri_to_string_partial() to redact parts. When the reference count reaches zero, the resources allocated by @uri are freed - @@ -30346,7 +28904,6 @@ When the reference count reaches zero, the resources allocated by See also g_uri_build_with_user(), which allows specifying the components of the "userinfo" separately. - a new #GUri @@ -30395,7 +28952,6 @@ coherent with the passed values, in particular use `%`-encoded values with In contrast to g_uri_build(), this allows specifying the components of the ‘userinfo’ field separately. Note that @user must be non-%NULL if either @password or @auth_params is non-%NULL. - a new #GUri @@ -30460,10 +29016,9 @@ portions of a URI. Though technically incorrect, this will also allow escaping nul bytes as `%``00`. - - an escaped version of @unescaped. The returned - string should be freed when no longer needed. + an escaped version of @unescaped. + The returned string should be freed when no longer needed. @@ -30493,10 +29048,9 @@ escaped. But if you specify characters in @reserved_chars_allowed they are not escaped. This is useful for the "reserved" characters in the URI specification, since those are allowed unescaped in some portions of a URI. - - an escaped version of @unescaped. The returned string -should be freed when no longer needed. + an escaped version of @unescaped. The +returned string should be freed when no longer needed. @@ -30524,7 +29078,6 @@ If it’s not a valid URI, an error is returned explaining how it’s See g_uri_split(), and the definition of #GUriFlags, for more information on the effect of @flags. - %TRUE if @uri_string is a valid absolute URI, %FALSE on error. @@ -30555,7 +29108,6 @@ components of the ‘userinfo’ separately. %G_URI_FLAGS_HAS_PASSWORD and %G_URI_FLAGS_HAS_AUTH_PARAMS are ignored if set in @flags. - an absolute URI string @@ -30605,7 +29157,6 @@ of the ‘userinfo’ separately. It otherwise behaves the same. %G_URI_FLAGS_HAS_PASSWORD and %G_URI_FLAGS_HAS_AUTH_PARAMS are ignored if set in @flags. - an absolute URI string @@ -30659,7 +29210,6 @@ in @flags. Splits an URI list conforming to the text/uri-list mime type defined in RFC 2483 into individual URIs, discarding any comments. The URIs are not validated. - a newly allocated %NULL-terminated list of strings holding the individual URIs. The array should be freed @@ -30679,9 +29229,8 @@ discarding any comments. The URIs are not validated. Parses @uri_string according to @flags. If the result is not a valid [absolute URI][relative-absolute-uris], it will be discarded, and an error returned. - - a new #GUri. + a new #GUri, or NULL on error. @@ -30720,11 +29269,10 @@ the returned attributes. If @params cannot be parsed (for example, it contains two @separators characters in a row), then @error is set and %NULL is returned. - - A hash table of - attribute/value pairs, with both names and values fully-decoded; or %NULL - on error. + + A hash table of attribute/value pairs, with both names and values + fully-decoded; or %NULL on error. @@ -30762,7 +29310,6 @@ as: URI = scheme ":" hier-part [ "?" query ] [ "#" fragment ] ]| Common schemes include `file`, `https`, `svn+ssh`, etc. - The ‘scheme’ component of the URI, or %NULL on error. The returned string should be freed when no longer needed. @@ -30786,7 +29333,6 @@ Common schemes include `file`, `https`, `svn+ssh`, etc. Unlike g_uri_parse_scheme(), the returned scheme is normalized to all-lowercase and does not need to be freed. - The ‘scheme’ component of the URI, or %NULL on error. The returned string is normalized to all-lowercase, and @@ -30808,9 +29354,9 @@ discarded, and an error returned. (If @base_uri_string is %NULL, this just returns @uri_ref, or %NULL if @uri_ref is invalid or not absolute.) - - the resolved URI string. + the resolved URI string, +or NULL on error. @@ -30845,7 +29391,6 @@ Note that the %G_URI_FLAGS_HAS_PASSWORD and %G_URI_FLAGS_HAS_AUTH_PARAMS @flags are ignored by g_uri_split(), since it always returns only the full userinfo; use g_uri_split_with_user() if you want it split up. - %TRUE if @uri_ref parsed successfully, %FALSE on error. @@ -30904,7 +29449,6 @@ See the documentation for g_uri_split() for more details; this is mostly a wrapper around that function with simpler arguments. However, it will return an error if @uri_string is a relative URI, or does not contain a hostname component. - %TRUE if @uri_string parsed successfully, %FALSE on error. @@ -30948,7 +29492,6 @@ information on the effect of @flags. Note that @password will only be parsed out if @flags contains %G_URI_FLAGS_HAS_PASSWORD, and @auth_params will only be parsed out if @flags contains %G_URI_FLAGS_HAS_AUTH_PARAMS. - %TRUE if @uri_ref parsed successfully, %FALSE on error. @@ -31021,11 +29564,10 @@ character in @escaped_string, then that is an error and %NULL will be returned. This is useful if you want to avoid for instance having a slash being expanded in an escaped path element, which might confuse pathname handling. - - an unescaped version of @escaped_string or %NULL on - error (if decoding failed, using %G_URI_ERROR_FAILED error code). The - returned #GBytes should be unreffed when no longer needed. + an unescaped version of @escaped_string + or %NULL on error (if decoding failed, using %G_URI_ERROR_FAILED error + code). The returned #GBytes should be unreffed when no longer needed. @@ -31056,12 +29598,11 @@ escaped path element, which might confuse pathname handling. Note: `NUL` byte is not accepted in the output, in contrast to g_uri_unescape_bytes(). - - - an unescaped version of @escaped_string or %NULL on error. -The returned string should be freed when no longer needed. As a -special case if %NULL is given for @escaped_string, this function -will return %NULL. + + an unescaped version of @escaped_string, +or %NULL on error. The returned string should be freed when no longer +needed. As a special case if %NULL is given for @escaped_string, this +function will return %NULL. @@ -31089,10 +29630,9 @@ character appears as an escaped character in @escaped_string, then that is an error and %NULL will be returned. This is useful if you want to avoid for instance having a slash being expanded in an escaped path element, which might confuse pathname handling. - - - an unescaped version of @escaped_string. The returned string -should be freed when no longer needed. + + an unescaped version of @escaped_string. +The returned string should be freed when no longer needed. @@ -31108,9 +29648,8 @@ should be freed when no longer needed. - + Error codes returned by #GUri methods. - Generic error if no more specific error is available. See the error message for details. @@ -31150,7 +29689,6 @@ When parsing a URI, if you need to choose different flags based on the type of URI, you can use g_uri_peek_scheme() on the URI string to check the scheme first, and use that to decide what flags to parse it with. - No flags set. @@ -31200,7 +29738,6 @@ parse it with. g_uri_to_string_partial(). Note that %G_URI_HIDE_PASSWORD and %G_URI_HIDE_AUTH_PARAMS will only work if the #GUri was parsed with the corresponding flags. - No flags set. @@ -31223,7 +29760,6 @@ the corresponding flags. Flags modifying the way parameters are handled by g_uri_parse_params() and #GUriParamsIter. - No flags set. @@ -31248,7 +29784,6 @@ iterate over the attribute/value pairs of a URI query string. #GUriParamsIter structures are typically allocated on the stack and then initialized with g_uri_params_iter_init(). See the documentation for g_uri_params_iter_init() for a usage example. - @@ -31297,7 +29832,6 @@ while (g_uri_params_iter_next (&iter, &unowned_attr, &unowned_value, if (error) // handle parsing error ]| - @@ -31339,7 +29873,6 @@ attribute/value pair. Note that the same @attribute may be returned multiple times, since URIs allow repeated attributes. - %FALSE if the end of the parameters has been reached or an error was encountered. %TRUE otherwise. @@ -31371,7 +29904,6 @@ to retrieve the full path associated to the logical id. The #GUserDirectory enumeration can be extended at later date. Not every platform has a directory for every logical id in this enumeration. - the user's Desktop directory @@ -31416,7 +29948,6 @@ make sure that #GVariantBuilder is valid. |[ g_auto(GVariantBuilder) builder = G_VARIANT_BUILDER_INIT (G_VARIANT_TYPE_BYTESTRING); ]| - a const GVariantType* @@ -31444,7 +29975,6 @@ initialized with G_VARIANT_DICT_INIT(). g_autoptr(GVariant) variant = get_asv_variant (); g_auto(GVariantDict) dict = G_VARIANT_DICT_INIT (variant); ]| - a GVariant* @@ -31461,7 +29991,6 @@ type string. If in doubt, use g_variant_type_string_is_valid() to check if the string is valid. Since 2.24 - a well-formed #GVariantType type string @@ -31474,7 +30003,6 @@ Since 2.24 In order to use this function, you must include string.h yourself, because this macro may use memmove() and GLib does not include string.h for you. - the va_list variable to place a copy of @ap2 in @@ -31485,7 +30013,6 @@ string.h for you. - @@ -31501,7 +30028,6 @@ If the compiler is configured to warn about the use of deprecated functions, then using functions that were deprecated in version %GLIB_VERSION_MIN_REQUIRED or earlier will cause warnings (but using functions deprecated in later releases will not). - @@ -31514,7 +30040,7 @@ value pairs. A #GVariant is also immutable: once it's been created neither its type nor its content can be modified further. GVariant is useful whenever data needs to be serialized, for example when -sending method parameters in DBus, or when saving settings using GSettings. +sending method parameters in D-Bus, or when saving settings using GSettings. When creating a new #GVariant, you pass the data you want to store in it along with a string representing the type of data you wish to pass to it. @@ -31747,7 +30273,6 @@ bytes. If we were to have other dictionaries of the same type, we would use more memory for the serialised data and buffer management for those dictionaries, but the type information would be shared. - Creates a new #GVariant instance. @@ -31777,7 +30302,6 @@ new_variant = g_variant_new ("(t^as)", (guint64) some_flags, some_strings); ]| - a new floating #GVariant instance @@ -31809,7 +30333,6 @@ same as @child_type, if given. If the @children are floating references (see g_variant_ref_sink()), the new instance takes ownership of them as if via g_variant_ref_sink(). - a floating reference to a new #GVariant array @@ -31834,7 +30357,6 @@ new instance takes ownership of them as if via g_variant_ref_sink(). Creates a new boolean #GVariant instance -- either %TRUE or %FALSE. - a floating reference to a new boolean #GVariant instance @@ -31848,7 +30370,6 @@ new instance takes ownership of them as if via g_variant_ref_sink(). Creates a new byte #GVariant instance. - a floating reference to a new byte #GVariant instance @@ -31867,7 +30388,6 @@ string need not be valid UTF-8. The nul terminator character at the end of the string is stored in the array. - a floating reference to a new bytestring #GVariant instance @@ -31887,7 +30407,6 @@ the array. strings. If @length is -1 then @strv is %NULL-terminated. - a new floating #GVariant instance @@ -31911,7 +30430,6 @@ non-%NULL. @key must be a value of a basic type (ie: not a container). If the @key or @value are floating references (see g_variant_ref_sink()), the new instance takes ownership of them as if via g_variant_ref_sink(). - a floating reference to a new dictionary entry #GVariant @@ -31929,7 +30447,6 @@ the new instance takes ownership of them as if via g_variant_ref_sink(). Creates a new double #GVariant instance. - a floating reference to a new double #GVariant instance @@ -31955,7 +30472,6 @@ of a double-check that the form of the serialised data matches the caller's expectation. @n_elements must be the length of the @elements array. - a floating reference to a new array #GVariant instance @@ -31989,7 +30505,6 @@ A reference is taken on @bytes. The data in @bytes must be aligned appropriately for the @type being loaded. Otherwise this function will internally create a copy of the memory (since GLib 2.60) or (in older versions) fail and exit the process. - a new #GVariant with a floating reference @@ -32039,7 +30554,6 @@ Note: @data must be backed by memory that is aligned appropriately for the @type being loaded. Otherwise this function will internally create a copy of the memory (since GLib 2.60) or (in older versions) fail and exit the process. - a new floating #GVariant of type @type @@ -32079,7 +30593,6 @@ process. By convention, handles are indexes into an array of file descriptors that are sent alongside a D-Bus message. If you're not interacting with D-Bus, you probably don't need them. - a floating reference to a new handle #GVariant instance @@ -32093,7 +30606,6 @@ with D-Bus, you probably don't need them. Creates a new int16 #GVariant instance. - a floating reference to a new int16 #GVariant instance @@ -32107,7 +30619,6 @@ with D-Bus, you probably don't need them. Creates a new int32 #GVariant instance. - a floating reference to a new int32 #GVariant instance @@ -32121,7 +30632,6 @@ with D-Bus, you probably don't need them. Creates a new int64 #GVariant instance. - a floating reference to a new int64 #GVariant instance @@ -32144,7 +30654,6 @@ of @child. If @child is a floating reference (see g_variant_ref_sink()), the new instance takes ownership of @child. - a floating reference to a new #GVariant maybe instance @@ -32164,7 +30673,6 @@ instance takes ownership of @child. Creates a D-Bus object path #GVariant with the contents of @string. @string must be a valid D-Bus object path. Use g_variant_is_object_path() if you're not sure. - a floating reference to a new object path #GVariant instance @@ -32184,7 +30692,6 @@ Each string must be a valid #GVariant object path; see g_variant_is_object_path(). If @length is -1 then @strv is %NULL-terminated. - a new floating #GVariant instance @@ -32235,7 +30742,6 @@ You may not use this function to return, unmodified, a single #GVariant pointer from the argument list. ie: @format may not solely be anything along the lines of "%*", "%?", "\%r", or anything starting with "%@". - a new floating #GVariant instance @@ -32273,7 +30779,6 @@ returning control to the user that originally provided the pointer. At this point, the caller will have their own full reference to the result. This can also be done by adding the result to a container, or by passing it to another g_variant_new() call. - a new, usually floating, #GVariant @@ -32295,7 +30800,6 @@ or by passing it to another g_variant_new() call. This is similar to calling g_strdup_printf() and then g_variant_new_string() but it saves a temporary variable and an unnecessary copy. - a floating reference to a new string #GVariant instance @@ -32316,7 +30820,6 @@ unnecessary copy. Creates a D-Bus type signature #GVariant with the contents of @string. @string must be a valid D-Bus type signature. Use g_variant_is_signature() if you're not sure. - a floating reference to a new signature #GVariant instance @@ -32334,7 +30837,6 @@ g_variant_is_signature() if you're not sure. @string must be valid UTF-8, and must not be %NULL. To encode potentially-%NULL strings, use g_variant_new() with `ms` as the [format string][gvariant-format-strings-maybe-types]. - a floating reference to a new string #GVariant instance @@ -32351,7 +30853,6 @@ potentially-%NULL strings, use g_variant_new() with `ms` as the strings. If @length is -1 then @strv is %NULL-terminated. - a new floating #GVariant instance @@ -32381,7 +30882,6 @@ when it is no longer required. You must not modify or access @string in any other way after passing it to this function. It is even possible that @string is immediately freed. - a floating reference to a new string #GVariant instance @@ -32403,7 +30903,6 @@ If @n_children is 0 then the unit tuple is constructed. If the @children are floating references (see g_variant_ref_sink()), the new instance takes ownership of them as if via g_variant_ref_sink(). - a floating reference to a new #GVariant tuple @@ -32423,7 +30922,6 @@ new instance takes ownership of them as if via g_variant_ref_sink(). Creates a new uint16 #GVariant instance. - a floating reference to a new uint16 #GVariant instance @@ -32437,7 +30935,6 @@ new instance takes ownership of them as if via g_variant_ref_sink(). Creates a new uint32 #GVariant instance. - a floating reference to a new uint32 #GVariant instance @@ -32451,7 +30948,6 @@ new instance takes ownership of them as if via g_variant_ref_sink(). Creates a new uint64 #GVariant instance. - a floating reference to a new uint64 #GVariant instance @@ -32500,7 +30996,6 @@ returning control to the user that originally provided the pointer. At this point, the caller will have their own full reference to the result. This can also be done by adding the result to a container, or by passing it to another g_variant_new() call. - a new, usually floating, #GVariant @@ -32527,7 +31022,6 @@ variant containing the original value. If @child is a floating reference (see g_variant_ref_sink()), the new instance takes ownership of @child. - a floating reference to a new variant #GVariant instance @@ -32551,7 +31045,6 @@ contain multi-byte numeric data. That include strings, booleans, bytes and containers containing only these things (recursively). The returned value is always in normal form and is marked as trusted. - the byteswapped form of @value @@ -32578,7 +31071,6 @@ check fails then a g_critical() is printed and %FALSE is returned. This function is meant to be used by functions that wish to provide varargs accessors to #GVariant values of uncertain values (eg: g_variant_lookup() or g_menu_model_get_item_attribute()). - %TRUE if @format_string is safe to use @@ -32600,7 +31092,6 @@ g_variant_lookup() or g_menu_model_get_item_attribute()). Classifies @value according to its top-level type. - the #GVariantClass of @value @@ -32632,7 +31123,6 @@ the handling of incomparable values (ie: NaN) is undefined. If you only require an equality comparison, g_variant_equal() is more general. - negative value if a < b; zero if a = b; @@ -32655,7 +31145,6 @@ general. returning a constant string, the string is duplicated. The return value must be freed using g_free(). - a newly allocated string @@ -32686,7 +31175,6 @@ stored there. In any case, the resulting array will be For an empty array, @length will be set to 0 and a pointer to a %NULL pointer will be returned. - an array of strings @@ -32715,7 +31203,6 @@ is stored there. In any case, the resulting array will be For an empty array, @length will be set to 0 and a pointer to a %NULL pointer will be returned. - an array of strings @@ -32740,7 +31227,6 @@ a constant string, the string is duplicated. The string will always be UTF-8 encoded. The return value must be freed using g_free(). - a newly allocated string, UTF-8 encoded @@ -32767,7 +31253,6 @@ is stored there. In any case, the resulting array will be For an empty array, @length will be set to 0 and a pointer to a %NULL pointer will be returned. - an array of strings @@ -32790,7 +31275,6 @@ For an empty array, @length will be set to 0 and a pointer to a The types of @one and @two are #gconstpointer only to allow use of this function with #GHashTable. They must each be a #GVariant. - %TRUE if @one and @two are equal @@ -32823,7 +31307,6 @@ extended in the future. the values and also determines if the values are copied or borrowed, see the section on [GVariant format strings][gvariant-format-strings-pointers]. - @@ -32847,7 +31330,6 @@ see the section on It is an error to call this function with a @value of any type other than %G_VARIANT_TYPE_BOOLEAN. - %TRUE or %FALSE @@ -32864,7 +31346,6 @@ other than %G_VARIANT_TYPE_BOOLEAN. It is an error to call this function with a @value of any type other than %G_VARIANT_TYPE_BYTE. - a #guint8 @@ -32895,7 +31376,6 @@ It is an error to call this function with a @value that is not an array of bytes. The return value remains valid as long as @value exists. - the constant string @@ -32921,7 +31401,6 @@ stored there. In any case, the resulting array will be For an empty array, @length will be set to 0 and a pointer to a %NULL pointer will be returned. - an array of constant strings @@ -32949,7 +31428,6 @@ g_variant_get(). the values and also determines if the values are copied or borrowed, see the section on [GVariant format strings][gvariant-format-strings-pointers]. - @@ -32996,7 +31474,6 @@ instead of further nested children. #GVariant is guaranteed to handle nesting up to at least 64 levels. This function is O(1). - the child at the specified index @@ -33038,7 +31515,6 @@ implicitly (for instance "the file always contains a %G_VARIANT_TYPE_VARIANT and it is always in little-endian order") or explicitly (by storing the type and/or endianness in addition to the serialised data). - the serialised form of @value, or %NULL @@ -33055,7 +31531,6 @@ serialised data). The semantics of this function are exactly the same as g_variant_get_data(), except that the returned #GBytes holds a reference to the variant data. - A new #GBytes representing the variant data @@ -33072,7 +31547,6 @@ a reference to the variant data. It is an error to call this function with a @value of any type other than %G_VARIANT_TYPE_DOUBLE. - a #gdouble @@ -33111,7 +31585,6 @@ expectation. @n_elements, which must be non-%NULL, is set equal to the number of items in the array. - a pointer to the fixed array @@ -33143,7 +31616,6 @@ than %G_VARIANT_TYPE_HANDLE. By convention, handles are indexes into an array of file descriptors that are sent alongside a D-Bus message. If you're not interacting with D-Bus, you probably don't need them. - a #gint32 @@ -33160,7 +31632,6 @@ with D-Bus, you probably don't need them. It is an error to call this function with a @value of any type other than %G_VARIANT_TYPE_INT16. - a #gint16 @@ -33177,7 +31648,6 @@ other than %G_VARIANT_TYPE_INT16. It is an error to call this function with a @value of any type other than %G_VARIANT_TYPE_INT32. - a #gint32 @@ -33194,7 +31664,6 @@ other than %G_VARIANT_TYPE_INT32. It is an error to call this function with a @value of any type other than %G_VARIANT_TYPE_INT64. - a #gint64 @@ -33209,7 +31678,6 @@ other than %G_VARIANT_TYPE_INT64. Given a maybe-typed #GVariant instance, extract its value. If the value is Nothing, then this function returns %NULL. - the contents of @value, or %NULL @@ -33245,7 +31713,6 @@ the newly created #GVariant will be returned with a single non-floating reference. Typically, g_variant_take_ref() should be called on the return value from this function to guarantee ownership of a single non-floating reference to it. - a trusted #GVariant @@ -33268,7 +31735,6 @@ is stored there. In any case, the resulting array will be For an empty array, @length will be set to 0 and a pointer to a %NULL pointer will be returned. - an array of constant strings @@ -33298,7 +31764,6 @@ already been calculated (ie: this function has been called before) then this function is O(1). Otherwise, the size is calculated, an operation which is approximately O(n) in the number of values involved. - the serialised size of @value @@ -33329,7 +31794,6 @@ It is an error to call this function with a @value of any type other than those three. The return value remains valid as long as @value exists. - the constant string, UTF-8 encoded @@ -33357,7 +31821,6 @@ is stored there. In any case, the resulting array will be For an empty array, @length will be set to 0 and a pointer to a %NULL pointer will be returned. - an array of constant strings @@ -33380,7 +31843,6 @@ For an empty array, @length will be set to 0 and a pointer to a The return value is valid for the lifetime of @value and must not be freed. - a #GVariantType @@ -33396,7 +31858,6 @@ be freed. Returns the type string of @value. Unlike the result of calling g_variant_type_peek_string(), this string is nul-terminated. This string belongs to #GVariant and must not be freed. - the type string for the type of @value @@ -33413,7 +31874,6 @@ string belongs to #GVariant and must not be freed. It is an error to call this function with a @value of any type other than %G_VARIANT_TYPE_UINT16. - a #guint16 @@ -33430,7 +31890,6 @@ other than %G_VARIANT_TYPE_UINT16. It is an error to call this function with a @value of any type other than %G_VARIANT_TYPE_UINT32. - a #guint32 @@ -33447,7 +31906,6 @@ other than %G_VARIANT_TYPE_UINT32. It is an error to call this function with a @value of any type other than %G_VARIANT_TYPE_UINT64. - a #guint64 @@ -33484,7 +31942,6 @@ varargs call by the user. the values and also determines if the values are copied or borrowed, see the section on [GVariant format strings][gvariant-format-strings-pointers]. - @@ -33511,7 +31968,6 @@ see the section on Unboxes @value. The result is the #GVariant instance that was contained in @value. - the item contained in the variant @@ -33533,7 +31989,6 @@ function as a basis for building protocols or file formats. The type of @value is #gconstpointer only to allow use of this function with #GHashTable. @value must be a #GVariant. - a hash value corresponding to @value @@ -33547,7 +32002,6 @@ function with #GHashTable. @value must be a #GVariant. Checks if @value is a container. - %TRUE if @value is a container @@ -33569,7 +32023,6 @@ or g_variant_take_ref(). See g_variant_ref_sink() for more information about floating reference counts. - whether @value is floating @@ -33595,7 +32048,6 @@ this function will immediately return %TRUE. There may be implementation specific restrictions on deeply nested values. GVariant is guaranteed to handle nesting up to at least 64 levels. - %TRUE if @value is in normal form @@ -33609,7 +32061,6 @@ GVariant is guaranteed to handle nesting up to at least 64 levels. Checks if a value has a type matching the provided type. - %TRUE if the type of @value matches @type @@ -33634,7 +32085,6 @@ need it. A reference is taken to @value and will be released only when g_variant_iter_free() is called. - a new heap-allocated #GVariantIter @@ -33661,7 +32111,6 @@ see the section on This function is currently implemented with a linear scan. If you plan to do many lookups then #GVariantDict may be more efficient. - %TRUE if a value was unpacked @@ -33707,7 +32156,6 @@ value will have this type. This function is currently implemented with a linear scan. If you plan to do many lookups then #GVariantDict may be more efficient. - the value of the dictionary key, or %NULL @@ -33739,7 +32187,6 @@ array. For tuples it is the number of tuple items (which depends only on the type). For dictionary entries, it is always 2 This function is O(1). - the number of children in the container @@ -33758,7 +32205,6 @@ The format is described [here][gvariant-text]. If @type_annotate is %TRUE, then type information is included in the output. - a newly-allocated string holding the result. @@ -33780,7 +32226,6 @@ the output. If @string is non-%NULL then it is appended to and returned. Else, a new empty #GString is allocated and it is returned. - a #GString containing the string @@ -33803,7 +32248,6 @@ a new empty #GString is allocated and it is returned. Increases the reference count of @value. - the same @value @@ -33838,7 +32282,6 @@ at that point and the caller will not need to unreference it. This makes certain common styles of programming much easier while still maintaining normal refcounting semantics in situations where values are not floating. - the same @value @@ -33863,7 +32306,6 @@ serialised variant successfully, its type and (if the destination machine might be different) its endianness must also be available. This function is approximately O(n) in the size of @data. - @@ -33911,7 +32353,6 @@ reference. If g_variant_take_ref() runs first then the result will be that the floating reference is converted to a hard reference and an additional reference on top of that one is added. It is best to avoid this situation. - the same @value @@ -33926,7 +32367,6 @@ avoid this situation. Decreases the reference count of @value. When its reference count drops to 0, the memory used by the variant is freed. - @@ -33946,7 +32386,6 @@ A valid object path starts with `/` followed by zero or more sequences of characters separated by `/` characters. Each sequence must contain only the characters `[A-Z][a-z][0-9]_`. No sequence (including the one following the final `/` character) may be empty. - %TRUE if @string is a D-Bus object path @@ -33965,7 +32404,6 @@ passing it to g_variant_new_signature(). D-Bus type signatures consist of zero or more definite #GVariantType strings in sequence. - %TRUE if @string is a D-Bus type signature @@ -34013,7 +32451,6 @@ produced by g_variant_print()". There may be implementation specific restrictions on deeply nested values, which would result in a %G_VARIANT_PARSE_ERROR_RECURSION error. #GVariant is guaranteed to handle nesting up to at least 64 levels. - a non-floating reference to a #GVariant, or %NULL @@ -34067,7 +32504,6 @@ The format of the message may change in a future version. If @source_str was not nul-terminated when you passed it to g_variant_parse() then you must add nul termination before using this function. - the printed message @@ -34104,11 +32540,8 @@ following functions. #GVariantBuilder is not threadsafe in any way. Do not attempt to access it from more than one thread. - - - @@ -34137,7 +32570,6 @@ any other call. In most cases it is easier to place a #GVariantBuilder directly on the stack of the calling function and initialise it with g_variant_builder_init(). - a #GVariantBuilder @@ -34180,7 +32612,6 @@ make_pointless_dictionary (void) return g_variant_builder_end (&builder); } ]| - @@ -34226,7 +32657,6 @@ make_pointless_dictionary (void) return g_variant_builder_end (&builder); } ]| - @@ -34256,7 +32686,6 @@ a variant, etc. If @value is a floating reference (see g_variant_ref_sink()), the @builder instance takes ownership of @value. - @@ -34286,7 +32715,6 @@ This function leaves the #GVariantBuilder structure set to all-zeros. It is valid to call this function on either an initialised #GVariantBuilder or one that is set to all-zeros but it is not valid to call this function on uninitialised memory. - @@ -34304,7 +32732,6 @@ the most recent call to g_variant_builder_open(). It is an error to call this function in any way that would create an inconsistent value to be constructed (ie: too few values added to the subcontainer). - @@ -34333,7 +32760,6 @@ required). It is also an error to call this function if the builder was created with an indefinite array or maybe type and no children have been added; in this case it is impossible to infer the type of the empty array. - a new, floating, #GVariant @@ -34375,7 +32801,6 @@ with this function. If you ever pass a reference to a should assume that the person receiving that reference may try to use reference counting; you should use g_variant_builder_new() instead of this function. - @@ -34427,7 +32852,6 @@ g_variant_builder_close (&builder); output = g_variant_builder_end (&builder); ]| - @@ -34447,7 +32871,6 @@ output = g_variant_builder_end (&builder); Don't call this on stack-allocated #GVariantBuilder instances or bad things will happen. - a new reference to @builder @@ -34467,7 +32890,6 @@ associated with the #GVariantBuilder. Don't call this on stack-allocated #GVariantBuilder instances or bad things will happen. - @@ -34481,7 +32903,6 @@ things will happen. The range of possible top-level types of #GVariant instances. - The #GVariant is a boolean. @@ -34629,11 +33050,8 @@ key is not found. Each returns the new dictionary as a floating return result; } ]| - - - @@ -34663,7 +33081,6 @@ In some cases it may be easier to place a #GVariantDict directly on the stack of the calling function and initialise it with g_variant_dict_init(). This is particularly useful when you are using #GVariantDict to construct a #GVariant. - a #GVariantDict @@ -34691,7 +33108,6 @@ It is valid to call this function on either an initialised #GVariantDict or one that was previously cleared by an earlier call to g_variant_dict_clear() but it is not valid to call this function on uninitialised memory. - @@ -34704,7 +33120,6 @@ on uninitialised memory. Checks if @key exists in @dict. - %TRUE if @key is in @dict @@ -34728,7 +33143,6 @@ It is not permissible to use @dict in any way after this call except for reference counting operations (in the case of a heap-allocated #GVariantDict) or by reinitialising it with g_variant_dict_init() (in the case of stack-allocated). - a new, floating, #GVariant @@ -34757,7 +33171,6 @@ pass a reference to a #GVariantDict outside of the control of your own code then you should assume that the person receiving that reference may try to use reference counting; you should use g_variant_dict_new() instead of this function. - @@ -34777,7 +33190,6 @@ g_variant_dict_new() instead of this function. This call is a convenience wrapper that is exactly equivalent to calling g_variant_new() followed by g_variant_dict_insert_value(). - @@ -34804,7 +33216,6 @@ calling g_variant_new() followed by g_variant_dict_insert_value(). Inserts (or replaces) a key in a #GVariantDict. @value is consumed if it is floating. - @@ -34834,7 +33245,6 @@ value and returns %TRUE. @format_string determines the C types that are used for unpacking the values and also determines if the values are copied or borrowed, see the section on [GVariant format strings][gvariant-format-strings-pointers]. - %TRUE if a value was unpacked @@ -34870,7 +33280,6 @@ returned. If the key is found and the value has the correct type, it is returned. If @expected_type was specified then any non-%NULL return value will have this type. - the value of the dictionary key, or %NULL @@ -34895,7 +33304,6 @@ value will have this type. Don't call this on stack-allocated #GVariantDict instances or bad things will happen. - a new reference to @dict @@ -34909,7 +33317,6 @@ things will happen. Removes a key and its associated value from a #GVariantDict. - %TRUE if the key was found and removed @@ -34933,7 +33340,6 @@ associated with the #GVariantDict. Don't call this on stack-allocated #GVariantDict instances or bad things will happen. - @@ -34948,7 +33354,6 @@ things will happen. #GVariantIter is an opaque data structure and can only be accessed using the following functions. - @@ -34965,7 +33370,6 @@ need it. A reference is taken to the container that @iter is iterating over and will be related only when g_variant_iter_free() is called. - a new heap-allocated #GVariantIter @@ -34981,7 +33385,6 @@ and will be related only when g_variant_iter_free() is called. Frees a heap-allocated #GVariantIter. Only call this function on iterators that were returned by g_variant_iter_new() or g_variant_iter_copy(). - @@ -34999,7 +33402,6 @@ ignored. The iterator remains valid for as long as @value exists, and need not be freed in any way. - the number of items in @value @@ -35078,7 +33480,6 @@ the values and also determines if the values are copied or borrowed. See the section on [GVariant format strings][gvariant-format-strings-pointers]. - %TRUE if a value was unpacked, or %FALSE if there was no value @@ -35105,7 +33506,6 @@ iterating over. This is the total number of items -- not the number of items remaining. This function might be useful for preallocation of arrays. - the number of children in the container @@ -35159,7 +33559,6 @@ the values and also determines if the values are copied or borrowed. See the section on [GVariant format strings][gvariant-format-strings-pointers]. - %TRUE if a value was unpacked, or %FALSE if there as no value @@ -35207,7 +33606,6 @@ Here is an example for iterating with g_variant_iter_next_value(): } } ]| - a #GVariant, or %NULL @@ -35222,7 +33620,6 @@ Here is an example for iterating with g_variant_iter_next_value(): Error codes returned by parsing text-format GVariants. - generic error (unused) @@ -35309,7 +33706,7 @@ may only appear nested inside of arrays. Just as in D-Bus, GVariant types are described with strings ("type strings"). Subject to the differences mentioned above, these strings -are of the same form as those found in DBus. Note, however: D-Bus +are of the same form as those found in D-Bus. Note, however: D-Bus always works in terms of messages and therefore individual type strings appear nowhere in its interface. Instead, "signatures" are a concatenation of the strings of the type of each argument in a @@ -35429,7 +33826,6 @@ the value is any type at all. This is, by definition, a dictionary, so this type string corresponds to %G_VARIANT_TYPE_DICTIONARY. Note that, due to the restriction that the key of a dictionary entry must be a basic type, "{**}" is not a valid type string. - Creates a new #GVariantType corresponding to the type string given by @type_string. It is appropriate to call g_variant_type_free() on @@ -35437,7 +33833,6 @@ the return value. It is a programmer error to call this function with an invalid type string. Use g_variant_type_string_is_valid() if you are unsure. - a new #GVariantType @@ -35454,7 +33849,6 @@ string. Use g_variant_type_string_is_valid() if you are unsure. type @type. It is appropriate to call g_variant_type_free() on the return value. - a new array #GVariantType @@ -35473,7 +33867,6 @@ Since 2.24 of type @key and a value of type @value. It is appropriate to call g_variant_type_free() on the return value. - a new dictionary entry #GVariantType @@ -35496,7 +33889,6 @@ Since 2.24 type @type or Nothing. It is appropriate to call g_variant_type_free() on the return value. - a new maybe #GVariantType @@ -35517,7 +33909,6 @@ Since 2.24 @items is %NULL-terminated. It is appropriate to call g_variant_type_free() on the return value. - a new tuple #GVariantType @@ -35540,7 +33931,6 @@ Since 2.24 Makes a copy of a #GVariantType. It is appropriate to call g_variant_type_free() on the return value. @type may not be %NULL. - a new #GVariantType @@ -35558,7 +33948,6 @@ Since 2.24 Returns a newly-allocated copy of the type string corresponding to @type. The returned string is nul-terminated. It is appropriate to call g_free() on the return value. - the corresponding type string @@ -35576,7 +33965,6 @@ Since 2.24 Determines the element type of an array or maybe type. This function may only be used with array or maybe types. - the element type of @type @@ -35601,7 +33989,6 @@ subtypes, use g_variant_type_is_subtype_of(). The argument types of @type1 and @type2 are only #gconstpointer to allow use with #GHashTable without function pointer casting. For both arguments, a valid #GVariantType must be provided. - %TRUE if @type1 and @type2 are exactly equal @@ -35634,7 +34021,6 @@ the key. This call, together with g_variant_type_next() provides an iterator interface over tuple and dictionary entry types. - the first item type of @type, or %NULL @@ -35656,7 +34042,6 @@ type constructor functions. In the case that @type is %NULL, this function does nothing. Since 2.24 - @@ -35671,7 +34056,6 @@ Since 2.24 Returns the length of the type string corresponding to the given @type. This function must be used to determine the valid extent of the memory region returned by g_variant_type_peek_string(). - the length of the corresponding type string @@ -35691,7 +34075,6 @@ Since 2.24 The argument type of @type is only #gconstpointer to allow use with #GHashTable without function pointer casting. A valid #GVariantType must be provided. - the hash value @@ -35712,7 +34095,6 @@ type string for @type starts with an 'a'. This function returns %TRUE for any indefinite type for which every definite subtype is an array type -- %G_VARIANT_TYPE_ARRAY, for example. - %TRUE if @type is an array type @@ -35736,7 +34118,6 @@ Only a basic type may be used as the key of a dictionary entry. This function returns %FALSE for all indefinite types except %G_VARIANT_TYPE_BASIC. - %TRUE if @type is a basic type @@ -35759,7 +34140,6 @@ entry types plus the variant type. This function returns %TRUE for any indefinite type for which every definite subtype is a container -- %G_VARIANT_TYPE_ARRAY, for example. - %TRUE if @type is a container type @@ -35784,7 +34164,6 @@ this function on the result of g_variant_get_type() will always result in %TRUE being returned. Calling this function on an indefinite type like %G_VARIANT_TYPE_ARRAY, however, will result in %FALSE being returned. - %TRUE if @type is definite @@ -35805,7 +34184,6 @@ true if the type string for @type starts with a '{'. This function returns %TRUE for any indefinite type for which every definite subtype is a dictionary entry type -- %G_VARIANT_TYPE_DICT_ENTRY, for example. - %TRUE if @type is a dictionary entry type @@ -35826,7 +34204,6 @@ type string for @type starts with an 'm'. This function returns %TRUE for any indefinite type for which every definite subtype is a maybe type -- %G_VARIANT_TYPE_MAYBE, for example. - %TRUE if @type is a maybe type @@ -35846,7 +34223,6 @@ Since 2.24 This function returns %TRUE if @type is a subtype of @supertype. All types are considered to be subtypes of themselves. Aside from that, only indefinite types can have subtypes. - %TRUE if @type is a subtype of @supertype @@ -35872,7 +34248,6 @@ type string for @type starts with a '(' or if @type is This function returns %TRUE for any indefinite type for which every definite subtype is a tuple type -- %G_VARIANT_TYPE_TUPLE, for example. - %TRUE if @type is a tuple type @@ -35888,7 +34263,6 @@ Since 2.24 Determines if the given @type is the variant type. - %TRUE if @type is the variant type @@ -35908,7 +34282,6 @@ Since 2.24 This function may only be used with a dictionary entry type. Other than the additional restriction, this call is equivalent to g_variant_type_first(). - the key type of the dictionary entry @@ -35932,7 +34305,6 @@ but must not be used with the generic tuple type In the case of a dictionary entry type, this function will always return 2. - the number of items in @type @@ -35958,7 +34330,6 @@ returns the value type. If called on the value type of a dictionary entry then this call returns %NULL. For tuples, %NULL is returned when @type is the last item in a tuple. - the next #GVariantType after @type, or %NULL @@ -35978,7 +34349,6 @@ result is not nul-terminated; in order to determine its length you must call g_variant_type_get_string_length(). To get a nul-terminated string, see g_variant_type_dup_string(). - the corresponding type string (not nul-terminated) @@ -35996,7 +34366,6 @@ Since 2.24 Determines the value type of a dictionary entry type. This function may only be used with a dictionary entry type. - the value type of the dictionary entry @@ -36011,7 +34380,6 @@ Since 2.24 - @@ -36022,7 +34390,6 @@ Since 2.24 - @@ -36036,7 +34403,6 @@ Since 2.24 Checks if @type_string is a valid GVariant type string. This call is equivalent to calling g_variant_type_string_scan() and confirming that the following character is a nul terminator. - %TRUE if @type_string is exactly one valid type string @@ -36064,7 +34430,6 @@ string does not end before @limit then %FALSE is returned. For the simple case of checking if a string is a valid type string, see g_variant_type_string_is_valid(). - %TRUE if a valid type string was found @@ -36089,7 +34454,6 @@ see g_variant_type_string_is_valid(). Declares a type of function which takes no arguments and has no return value. It is used to specify the type function passed to g_atexit(). - @@ -36099,7 +34463,6 @@ function passed to g_atexit(). the actual DLL name that the code being compiled will be included in. On non-Windows platforms, expands to nothing. - empty or "static" @@ -36113,7 +34476,6 @@ On non-Windows platforms, expands to nothing. - @@ -36129,7 +34491,6 @@ Windows. Software that needs to handle file permissions on Windows more exactly should use the Win32 API. See your C library manual for more details about access(). - zero if the pathname refers to an existing file system object that has all the tested permissions, or -1 otherwise @@ -36173,7 +34534,6 @@ Thus it provides the same advantages and pitfalls as alloca(): Stack space allocated with alloca() in the same scope as a variable sized array will be freed together with the variable sized array upon exit of that scope, and not upon exit of the enclosing function scope. - number of bytes to allocate. @@ -36305,7 +34665,6 @@ size automatically if necessary. g_array_append_val() is a macro which uses a reference to the value parameter @v. This means that you cannot use it with literal values such as "27". You must use variables. - a #GArray @@ -36341,7 +34700,6 @@ This example reads from and writes to an array of integers: g_print ("Int at index 1 is %u; decrementing it\n", *my_int); *my_int = *my_int - 1; ]| - a #GArray @@ -36360,7 +34718,6 @@ This example reads from and writes to an array of integers: g_array_insert_val() is a macro which uses a reference to the value parameter @v. This means that you cannot use it with literal values such as "27". You must use variables. - a #GArray @@ -36384,7 +34741,6 @@ the new element. g_array_prepend_val() is a macro which uses a reference to the value parameter @v. This means that you cannot use it with literal values such as "27". You must use variables. - a #GArray @@ -36515,7 +34871,6 @@ An example using a #GPtrArray: Determines the numeric value of a character as a decimal digit. Differs from g_unichar_digit_value() because it takes a char, so there's no worry about sign extension if characters are signed. - If @c is a decimal digit (according to g_ascii_isdigit()), its numeric value. Otherwise, -1. @@ -36538,7 +34893,6 @@ the string back using g_ascii_strtod() gives the same machine-number guaranteed that the size of the resulting string will never be larger than @G_ASCII_DTOSTR_BUF_SIZE bytes, including the terminating nul character, which is always added. - The pointer to the buffer with the converted string. @@ -36568,7 +34922,6 @@ The returned buffer is guaranteed to be nul-terminated. If you just want to want to serialize the value into a string, use g_ascii_dtostr(). - The pointer to the buffer with the converted string. @@ -36602,7 +34955,6 @@ returning %FALSE for all non-ASCII characters. Also, unlike the standard library function, this takes a char, not an int, so don't call it on %EOF, but no need to cast to #guchar before passing a possibly non-ASCII character in. - any character @@ -36618,7 +34970,6 @@ returning %FALSE for all non-ASCII characters. Also, unlike the standard library function, this takes a char, not an int, so don't call it on %EOF, but no need to cast to #guchar before passing a possibly non-ASCII character in. - any character @@ -36634,7 +34985,6 @@ locale, returning %FALSE for all non-ASCII characters. Also, unlike the standard library function, this takes a char, not an int, so don't call it on %EOF, but no need to cast to #guchar before passing a possibly non-ASCII character in. - any character @@ -36647,7 +34997,6 @@ before passing a possibly non-ASCII character in. Unlike the standard C library isdigit() function, this takes a char, not an int, so don't call it on %EOF, but no need to cast to #guchar before passing a possibly non-ASCII character in. - any character @@ -36663,7 +35012,6 @@ returning %FALSE for all non-ASCII characters. Also, unlike the standard library function, this takes a char, not an int, so don't call it on %EOF, but no need to cast to #guchar before passing a possibly non-ASCII character in. - any character @@ -36679,7 +35027,6 @@ returning %FALSE for all non-ASCII characters. Also, unlike the standard library function, this takes a char, not an int, so don't call it on %EOF, but no need to worry about casting to #guchar before passing a possibly non-ASCII character in. - any character @@ -36695,7 +35042,6 @@ returning %FALSE for all non-ASCII characters. Also, unlike the standard library function, this takes a char, not an int, so don't call it on %EOF, but no need to cast to #guchar before passing a possibly non-ASCII character in. - any character @@ -36711,7 +35057,6 @@ returning %FALSE for all non-ASCII characters. Also, unlike the standard library function, this takes a char, not an int, so don't call it on %EOF, but no need to cast to #guchar before passing a possibly non-ASCII character in. - any character @@ -36727,7 +35072,6 @@ returning %FALSE for all non-ASCII characters. Also, unlike the standard library function, this takes a char, not an int, so don't call it on %EOF, but no need to cast to #guchar before passing a possibly non-ASCII character in. - any character @@ -36743,7 +35087,6 @@ returning %FALSE for all non-ASCII characters. Also, unlike the standard library function, this takes a char, not an int, so don't call it on %EOF, but no need to worry about casting to #guchar before passing a possibly non-ASCII character in. - any character @@ -36756,7 +35099,6 @@ to #guchar before passing a possibly non-ASCII character in. Unlike the standard C library isxdigit() function, this takes a char, not an int, so don't call it on %EOF, but no need to cast to #guchar before passing a possibly non-ASCII character in. - any character @@ -36779,7 +35121,6 @@ characters include all ASCII letters. If you compare two CP932 strings using this function, you will get false matches. Both @s1 and @s2 must be non-%NULL. - 0 if the strings match, a negative value if @s1 < @s2, or a positive value if @s1 > @s2. @@ -36798,7 +35139,6 @@ Both @s1 and @s2 must be non-%NULL. Converts all upper case ASCII letters to lower case ASCII letters. - a newly-allocated string, with all the upper case characters in @str converted to lower case, with semantics that @@ -36839,7 +35179,6 @@ bounds - %G_NUMBER_PARSER_ERROR_OUT_OF_BOUNDS. See g_ascii_strtoll() if you have more complex needs such as parsing a string which starts with a number, but then has other characters. - %TRUE if @str was a number, otherwise %FALSE. @@ -36890,7 +35229,6 @@ bounds - %G_NUMBER_PARSER_ERROR_OUT_OF_BOUNDS. See g_ascii_strtoull() if you have more complex needs such as parsing a string which starts with a number, but then has other characters. - %TRUE if @str was a number, otherwise %FALSE. @@ -36929,7 +35267,6 @@ characters as if they are not letters. The same warning as in g_ascii_strcasecmp() applies: Use this function only on strings known to be in encodings where bytes corresponding to ASCII letters always represent themselves. - 0 if the strings match, a negative value if @s1 < @s2, or a positive value if @s1 > @s2. @@ -36974,7 +35311,6 @@ zero is returned and %ERANGE is stored in %errno. This function resets %errno before calling strtod() so that you can reliably detect overflow and underflow. - the #gdouble value. @@ -37009,7 +35345,6 @@ If the base is outside the valid range, zero is returned, and `EINVAL` is stored in `errno`. If the string conversion fails, zero is returned, and @endptr returns @nptr (if @endptr is non-%NULL). - the #gint64 value or zero on error. @@ -37053,7 +35388,6 @@ If the base is outside the valid range, zero is returned, and `EINVAL` is stored in `errno`. If the string conversion fails, zero is returned, and @endptr returns @nptr (if @endptr is non-%NULL). - the #guint64 value or zero on error. @@ -37076,7 +35410,6 @@ If the string conversion fails, zero is returned, and @endptr returns Converts all lower case ASCII letters to upper case ASCII letters. - a newly allocated string, with all the lower case characters in @str converted to upper case, with semantics that @@ -37105,7 +35438,6 @@ letters in a particular character set. Also unlike the standard library function, this takes and returns a char, not an int, so don't call it on %EOF but no need to worry about casting to #guchar before passing a possibly non-ASCII character in. - the result of converting @c to lower case. If @c is not an ASCII upper case letter, @c is returned unchanged. @@ -37128,7 +35460,6 @@ letters in a particular character set. Also unlike the standard library function, this takes and returns a char, not an int, so don't call it on %EOF but no need to worry about casting to #guchar before passing a possibly non-ASCII character in. - the result of converting @c to upper case. If @c is not an ASCII lower case letter, @c is returned unchanged. @@ -37146,7 +35477,6 @@ before passing a possibly non-ASCII character in. digit. Differs from g_unichar_xdigit_value() because it takes a char, so there's no worry about sign extension if characters are signed. - If @c is a hex digit (according to g_ascii_isxdigit()), its numeric value. Otherwise, -1. @@ -37170,7 +35500,6 @@ not depend on any side effects from @expr. Similarly, it must not be used in unit tests, otherwise the unit tests will be ineffective if compiled with `G_DISABLE_ASSERT`. Use g_assert_true() and related macros in unit tests instead. - the expression to check @@ -37184,7 +35513,6 @@ The effect of `g_assert_cmpfloat (n1, op, n2)` is the same as `g_assert_true (n1 op n2)`. The advantage of this macro is that it can produce a message that includes the actual values of @n1 and @n2. - a floating point number @@ -37205,7 +35533,6 @@ The effect of `g_assert_cmpfloat_with_epsilon (n1, n2, epsilon)` is the same as `g_assert_true (abs (n1 - n2) < epsilon)`. The advantage of this macro is that it can produce a message that includes the actual values of @n1 and @n2. - a floating point number @@ -37224,7 +35551,6 @@ actual values of @n1 and @n2. This is a variant of g_assert_cmpuint() that displays the numbers in hexadecimal notation in the message. - an unsigned integer @@ -37245,7 +35571,6 @@ The effect of `g_assert_cmpint (n1, op, n2)` is the same as `g_assert_true (n1 op n2)`. The advantage of this macro is that it can produce a message that includes the actual values of @n1 and @n2. - an integer @@ -37274,7 +35599,6 @@ includes the actual values of @l1 and @l2. |[<!-- language="C" --> g_assert_cmpmem (buf->data, buf->len, expected, sizeof (expected)); ]| - pointer to a buffer @@ -37304,7 +35628,6 @@ includes the actual values of @s1 and @s2. |[<!-- language="C" --> g_assert_cmpstr (mystring, ==, "fubar"); ]| - a string (may be %NULL) @@ -37325,7 +35648,6 @@ The effect of `g_assert_cmpuint (n1, op, n2)` is the same as `g_assert_true (n1 op n2)`. The advantage of this macro is that it can produce a message that includes the actual values of @n1 and @n2. - an unsigned integer @@ -37348,7 +35670,6 @@ g_variant_equal(). The effect of `g_assert_cmpvariant (v1, v2)` is the same as `g_assert_true (g_variant_equal (v1, v2))`. The advantage of this macro is that it can produce a message that includes the actual values of @v1 and @v2. - pointer to a #GVariant @@ -37371,7 +35692,6 @@ error message and code. This can only be used to test for a specific error. If you want to test that @err is set, but don't care what it's set to, just use `g_assert_nonnull (err)`. - a #GError, possibly %NULL @@ -37396,7 +35716,6 @@ Note that unlike g_assert(), this macro is unaffected by whether conversely, g_assert() should not be used in tests. See g_test_set_nonfatal_assertions(). - the expression to check @@ -37414,7 +35733,6 @@ will contain the value of `errno` and its human-readable message from g_strerror(). This macro will clear the value of `errno` before executing @expr. - the expression to check @@ -37428,7 +35746,6 @@ The effect of `g_assert_no_error (err)` is the same as `g_assert_true (err == NULL)`. The advantage of this macro is that it can produce a message that includes the error message and code. - a #GError, possibly %NULL @@ -37447,7 +35764,6 @@ Note that unlike g_assert(), this macro is unaffected by whether conversely, g_assert() should not be used in tests. See g_test_set_nonfatal_assertions(). - the expression to check @@ -37466,7 +35782,6 @@ Note that unlike g_assert(), this macro is unaffected by whether conversely, g_assert() should not be used in tests. See g_test_set_nonfatal_assertions(). - the expression to check @@ -37485,7 +35800,6 @@ Note that unlike g_assert(), this macro is unaffected by whether conversely, g_assert() should not be used in tests. See g_test_set_nonfatal_assertions(). - the expression to check @@ -37493,7 +35807,6 @@ See g_test_set_nonfatal_assertions(). - @@ -37516,7 +35829,6 @@ See g_test_set_nonfatal_assertions(). - @@ -37539,7 +35851,6 @@ See g_test_set_nonfatal_assertions(). - @@ -37574,7 +35885,6 @@ See g_test_set_nonfatal_assertions(). - @@ -37606,7 +35916,6 @@ See g_test_set_nonfatal_assertions(). - @@ -37640,7 +35949,6 @@ See g_test_set_nonfatal_assertions(). Internal function used to print messages from the public g_assert() and g_assert_not_reached() macros. - @@ -37742,7 +36050,6 @@ As can be seen from the above, for portability it's best to avoid calling g_atexit() (or atexit()) except in the main executable of a program. It is best to avoid g_atexit(). - @@ -37762,8 +36069,10 @@ Think of this operation as an atomic version of This call acts as a full compiler and hardware memory barrier. Before version 2.30, this function did not return a value -(but g_atomic_int_exchange_and_add() did, and had the same meaning). - +(but g_atomic_int_exchange_and_add() did, and had the same meaning). + +While @atomic has a `volatile` qualifier, this is a historical artifact and +the pointer passed to it should not be `volatile`. the value of @atomic before the add, signed @@ -37786,8 +36095,10 @@ storing the result back in @atomic. This call acts as a full compiler and hardware memory barrier. Think of this operation as an atomic version of -`{ tmp = *atomic; *atomic &= val; return tmp; }`. - +`{ tmp = *atomic; *atomic &= val; return tmp; }`. + +While @atomic has a `volatile` qualifier, this is a historical artifact and +the pointer passed to it should not be `volatile`. the value of @atomic before the operation, unsigned @@ -37812,8 +36123,10 @@ This compare and exchange is done atomically. Think of this operation as an atomic version of `{ if (*atomic == oldval) { *atomic = newval; return TRUE; } else return FALSE; }`. -This call acts as a full compiler and hardware memory barrier. - +This call acts as a full compiler and hardware memory barrier. + +While @atomic has a `volatile` qualifier, this is a historical artifact and +the pointer passed to it should not be `volatile`. %TRUE if the exchange took place @@ -37839,8 +36152,10 @@ This call acts as a full compiler and hardware memory barrier. Think of this operation as an atomic version of `{ *atomic -= 1; return (*atomic == 0); }`. -This call acts as a full compiler and hardware memory barrier. - +This call acts as a full compiler and hardware memory barrier. + +While @atomic has a `volatile` qualifier, this is a historical artifact and +the pointer passed to it should not be `volatile`. %TRUE if the resultant value is zero @@ -37857,7 +36172,6 @@ This call acts as a full compiler and hardware memory barrier. value of the integer (which it now does). It is retained only for compatibility reasons. Don't use this function in new code. Use g_atomic_int_add() instead. - the value of @atomic before the add, signed @@ -37877,8 +36191,10 @@ compatibility reasons. Don't use this function in new code. Gets the current value of @atomic. This call acts as a full compiler and hardware -memory barrier (before the get). - +memory barrier (before the get). + +While @atomic has a `volatile` qualifier, this is a historical artifact and +the pointer passed to it should not be `volatile`. the value of the integer @@ -37895,8 +36211,10 @@ memory barrier (before the get). Think of this operation as an atomic version of `{ *atomic += 1; }`. -This call acts as a full compiler and hardware memory barrier. - +This call acts as a full compiler and hardware memory barrier. + +While @atomic has a `volatile` qualifier, this is a historical artifact and +the pointer passed to it should not be `volatile`. @@ -37914,8 +36232,10 @@ storing the result back in @atomic. Think of this operation as an atomic version of `{ tmp = *atomic; *atomic |= val; return tmp; }`. -This call acts as a full compiler and hardware memory barrier. - +This call acts as a full compiler and hardware memory barrier. + +While @atomic has a `volatile` qualifier, this is a historical artifact and +the pointer passed to it should not be `volatile`. the value of @atomic before the operation, unsigned @@ -37935,8 +36255,10 @@ This call acts as a full compiler and hardware memory barrier. Sets the value of @atomic to @newval. This call acts as a full compiler and hardware -memory barrier (after the set). - +memory barrier (after the set). + +While @atomic has a `volatile` qualifier, this is a historical artifact and +the pointer passed to it should not be `volatile`. @@ -37958,8 +36280,10 @@ storing the result back in @atomic. Think of this operation as an atomic version of `{ tmp = *atomic; *atomic ^= val; return tmp; }`. -This call acts as a full compiler and hardware memory barrier. - +This call acts as a full compiler and hardware memory barrier. + +While @atomic has a `volatile` qualifier, this is a historical artifact and +the pointer passed to it should not be `volatile`. the value of @atomic before the operation, unsigned @@ -38018,8 +36342,10 @@ perform the operations normally and then release the lock. Think of this operation as an atomic version of `{ tmp = *atomic; *atomic += val; return tmp; }`. -This call acts as a full compiler and hardware memory barrier. - +This call acts as a full compiler and hardware memory barrier. + +While @atomic has a `volatile` qualifier, this is a historical artifact and +the pointer passed to it should not be `volatile`. the value of @atomic before the add, signed @@ -38042,8 +36368,10 @@ storing the result back in @atomic. Think of this operation as an atomic version of `{ tmp = *atomic; *atomic &= val; return tmp; }`. -This call acts as a full compiler and hardware memory barrier. - +This call acts as a full compiler and hardware memory barrier. + +While @atomic has a `volatile` qualifier, this is a historical artifact and +the pointer passed to it should not be `volatile`. the value of @atomic before the operation, unsigned @@ -38068,8 +36396,10 @@ This compare and exchange is done atomically. Think of this operation as an atomic version of `{ if (*atomic == oldval) { *atomic = newval; return TRUE; } else return FALSE; }`. -This call acts as a full compiler and hardware memory barrier. - +This call acts as a full compiler and hardware memory barrier. + +While @atomic has a `volatile` qualifier, this is a historical artifact and +the pointer passed to it should not be `volatile`. %TRUE if the exchange took place @@ -38093,8 +36423,10 @@ This call acts as a full compiler and hardware memory barrier. Gets the current value of @atomic. This call acts as a full compiler and hardware -memory barrier (before the get). - +memory barrier (before the get). + +While @atomic has a `volatile` qualifier, this is a historical artifact and +the pointer passed to it should not be `volatile`. the value of the pointer @@ -38113,8 +36445,10 @@ storing the result back in @atomic. Think of this operation as an atomic version of `{ tmp = *atomic; *atomic |= val; return tmp; }`. -This call acts as a full compiler and hardware memory barrier. - +This call acts as a full compiler and hardware memory barrier. + +While @atomic has a `volatile` qualifier, this is a historical artifact and +the pointer passed to it should not be `volatile`. the value of @atomic before the operation, unsigned @@ -38134,8 +36468,10 @@ This call acts as a full compiler and hardware memory barrier. Sets the value of @atomic to @newval. This call acts as a full compiler and hardware -memory barrier (after the set). - +memory barrier (after the set). + +While @atomic has a `volatile` qualifier, this is a historical artifact and +the pointer passed to it should not be `volatile`. @@ -38157,8 +36493,10 @@ storing the result back in @atomic. Think of this operation as an atomic version of `{ tmp = *atomic; *atomic ^= val; return tmp; }`. -This call acts as a full compiler and hardware memory barrier. - +This call acts as a full compiler and hardware memory barrier. + +While @atomic has a `volatile` qualifier, this is a historical artifact and +the pointer passed to it should not be `volatile`. the value of @atomic before the operation, unsigned @@ -38176,7 +36514,6 @@ This call acts as a full compiler and hardware memory barrier. Atomically acquires a reference on the data pointed by @mem_block. - a pointer to the data, with its reference count increased @@ -38198,7 +36535,6 @@ zero. The allocated data is guaranteed to be suitably aligned for any built-in type. - a pointer to the allocated memory @@ -38221,7 +36557,6 @@ zero. The allocated data is guaranteed to be suitably aligned for any built-in type. - a pointer to the allocated memory @@ -38237,7 +36572,6 @@ built-in type. Allocates a new block of data with atomic reference counting semantics, and copies @block_size bytes of @mem_block into it. - a pointer to the allocated memory @@ -38256,7 +36590,6 @@ into it. Retrieves the size of the reference counted data pointed by @mem_block. - the size of the data, in bytes @@ -38275,7 +36608,6 @@ data with the size of the given @type. This macro calls g_atomic_rc_box_alloc() with `sizeof (@type)` and casts the returned pointer to a pointer of the given @type, avoiding a type cast in the source code. - the type to allocate, typically a structure name @@ -38290,7 +36622,6 @@ to zero. This macro calls g_atomic_rc_box_alloc0() with `sizeof (@type)` and casts the returned pointer to a pointer of the given @type, avoiding a type cast in the source code. - the type to allocate, typically a structure name @@ -38302,7 +36633,6 @@ avoiding a type cast in the source code. If the reference was the last one, it will free the resources allocated for @mem_block. - @@ -38319,7 +36649,6 @@ resources allocated for @mem_block. If the reference was the last one, it will call @clear_func to clear the contents of @mem_block, and then will free the resources allocated for @mem_block. - @@ -38336,7 +36665,6 @@ resources allocated for @mem_block. Atomically compares the current value of @arc with @val. - %TRUE if the reference count is the same as the given value @@ -38355,7 +36683,6 @@ resources allocated for @mem_block. Atomically decreases the reference count. - %TRUE if the reference count reached 0, and %FALSE otherwise @@ -38369,7 +36696,6 @@ resources allocated for @mem_block. Atomically increases the reference count. - @@ -38382,7 +36708,6 @@ resources allocated for @mem_block. Initializes a reference count variable. - @@ -38415,7 +36740,6 @@ Support for Base64 encoding has been added in GLib 2.12. Decode a sequence of Base-64 encoded text into binary data. Note that the returned binary data is not necessarily zero-terminated, so it should not be used as a character string. - newly allocated buffer containing the binary data @@ -38439,7 +36763,6 @@ so it should not be used as a character string. Decode a sequence of Base-64 encoded text into binary data by overwriting the input data. - The binary data that @text responds. This pointer is the same as the input @text. @@ -38468,7 +36791,6 @@ The output buffer must be large enough to fit all the data that will be written to it. Since base64 encodes 3 bytes in 4 chars you need at least: (@len / 4) * 3 + 3 bytes (+ 3 may be needed in case of non-zero state). - The number of bytes of output that was written @@ -38503,7 +36825,6 @@ state). Encode a sequence of binary data into its Base-64 stringified representation. - a newly allocated, zero-terminated Base-64 encoded string representing @data. The returned string must @@ -38531,7 +36852,6 @@ be written to it. It will need up to 4 bytes, or up to 5 bytes if line-breaking is enabled. The @out array will not be automatically nul-terminated. - The number of bytes of output that was written @@ -38577,7 +36897,6 @@ the same line. This avoids problems with long lines in the email system. Note however that it breaks the lines with `LF` characters, not `CR LF` sequences, so the result cannot be passed directly to SMTP or certain other protocols. - The number of bytes of output that was written @@ -38621,7 +36940,6 @@ string. that g_path_get_basename() allocates new memory for the returned string, unlike this function which returns a pointer into the argument. - the name of the file without any leading directory components @@ -38648,7 +36966,6 @@ between 0 and 31 then the result is undefined. This function accesses @address atomically. All other accesses to @address must be atomic in order for this function to work reliably. - @@ -38668,7 +36985,6 @@ reliably. from (but not including) @nth_bit upwards. Bits are numbered from 0 (least significant) to sizeof(#gulong) * 8 - 1 (31 or 63, usually). To start searching from the 0th bit, set @nth_bit to -1. - the index of the first bit set which is higher than @nth_bit, or -1 if no higher bits are set @@ -38691,7 +37007,6 @@ from (but not including) @nth_bit downwards. Bits are numbered from 0 (least significant) to sizeof(#gulong) * 8 - 1 (31 or 63, usually). To start searching from the last bit, set @nth_bit to -1 or GLIB_SIZEOF_LONG * 8. - the index of the first bit set which is lower than @nth_bit, or -1 if no lower bits are set @@ -38711,7 +37026,6 @@ usually). To start searching from the last bit, set @nth_bit to Gets the number of bits used to hold @number, e.g. if @number is 4, 3 bits are needed. - the number of bits used to hold @number @@ -38736,7 +37050,6 @@ between 0 and 31 then the result is undefined. This function accesses @address atomically. All other accesses to @address must be atomic in order for this function to work reliably. - %TRUE if the lock was acquired @@ -38760,7 +37073,6 @@ woken up. This function accesses @address atomically. All other accesses to @address must be atomic in order for this function to work reliably. - @@ -38836,7 +37148,6 @@ parameters (reading from left to right) is used. No attempt is made to force the resulting filename to be an absolute path. If the first element is a relative path, the result will be a relative path. - a newly-allocated string that must be freed with g_free(). @@ -38856,7 +37167,6 @@ be a relative path. Behaves exactly like g_build_filename(), but takes the path elements as a va_list. This function is mainly meant for language bindings. - a newly-allocated string that must be freed with g_free(). @@ -38877,7 +37187,6 @@ as a va_list. This function is mainly meant for language bindings. Behaves exactly like g_build_filename(), but takes the path elements as a string array, instead of varargs. This function is mainly meant for language bindings. - a newly-allocated string that must be freed with g_free(). @@ -38920,7 +37229,6 @@ of that element. Other than for determination of the number of leading and trailing copies of the separator, elements consisting only of copies of the separator are ignored. - a newly-allocated string that must be freed with g_free(). @@ -38945,7 +37253,6 @@ of the separator are ignored. Behaves exactly like g_build_path(), but takes the path elements as a string array, instead of varargs. This function is mainly meant for language bindings. - a newly-allocated string that must be freed with g_free(). @@ -38970,7 +37277,6 @@ meant for language bindings. %TRUE it frees the actual byte data. If the reference count of @array is greater than one, the #GByteArray wrapper is preserved but the size of @array will be set to zero. - the element data if @free_segment is %FALSE, otherwise %NULL. The element data should be freed using g_free(). @@ -38998,7 +37304,6 @@ will be set to zero. This is identical to using g_bytes_new_take() and g_byte_array_free() together. - a new immutable #GBytes representing same byte data that was in the array @@ -39015,7 +37320,6 @@ together. Creates a new #GByteArray with a reference count of 1. - the new #GByteArray @@ -39025,8 +37329,11 @@ together. Create byte array containing the data. The data will be owned by the array -and will be freed with g_free(), i.e. it could be allocated using g_strdup(). - +and will be freed with g_free(), i.e. it could be allocated using g_strdup(). + +Do not use it if @len is greater than %G_MAXUINT. #GByteArray +stores the length of its data in #guint, which may be shorter than +#gsize. a new #GByteArray @@ -39050,7 +37357,6 @@ and will be freed with g_free(), i.e. it could be allocated using g_strdup().Frees the data in the array and resets the size to zero, while the underlying array is preserved for use elsewhere and returned to the caller. - the element data, which should be freed using g_free(). @@ -39075,7 +37381,6 @@ to the caller. reference count drops to 0, all memory allocated by the array is released. This function is thread-safe and may be called from any thread. - @@ -39133,7 +37438,6 @@ This function never fails, and will canonicalize file paths even if they don't exist. No file system I/O is done. - a newly allocated string with the canonical file path @@ -39156,7 +37460,6 @@ to use the current working directory current directory of the process to @path. See your C library manual for more details about chdir(). - 0 on success, -1 if an error occurred. @@ -39184,7 +37487,6 @@ of the running library is newer than the version the running library must be binary compatible with the version @required_major.required_minor.@required_micro (same major version.) - %NULL if the GLib library is compatible with the given version, or a string describing the version mismatch. @@ -39241,7 +37543,6 @@ Support for checksums has been added in GLib 2.16 Gets the length in bytes of digests of type @checksum_type - the checksum length, or -1 if @checksum_type is not supported. @@ -39275,7 +37576,6 @@ This internally creates a main loop source using g_child_watch_source_new() and attaches it to the main loop context using g_source_attach(). You can do these steps manually if you need greater control. - the ID (greater than 0) of the event source. @@ -39322,7 +37622,6 @@ This internally creates a main loop source using g_child_watch_source_new() and attaches it to the main loop context using g_source_attach(). You can do these steps manually if you need greater control. - the ID (greater than 0) of the event source. @@ -39377,7 +37676,7 @@ due to limitations in POSIX process interfaces: * the application must not wait for @pid to exit by any other mechanism, including `waitpid(pid, ...)` or a second child-watch source for the same @pid -* the application must not ignore SIGCHILD +* the application must not ignore `SIGCHLD` If any of those conditions are not met, this and related APIs will not work correctly. This can often be diagnosed via a GLib warning @@ -39385,7 +37684,6 @@ stating that `ECHILD` was received by `waitpid`. Calling `waitpid` for specific processes other than @pid remains a valid thing to do. - the newly-created child watch source @@ -39401,7 +37699,6 @@ Windows a handle for a process (which doesn't have to be a child). If @err or *@err is %NULL, does nothing. Otherwise, calls g_error_free() on *@err and sets *@err to %NULL. - @@ -39417,7 +37714,6 @@ set to zero. A macro is also included that allows this function to be used without pointer casts. - @@ -39436,7 +37732,6 @@ pointer casts. Clears a pointer to a #GList, freeing it and, optionally, freeing its elements using @destroy. @list_ptr must be a valid pointer. If @list_ptr points to a null #GList, this does nothing. - @@ -39468,7 +37763,6 @@ or calling conventions, so you must ensure that your @destroy function is compatible with being called as `GDestroyNotify` using the standard calling convention for the platform that GLib was compiled for; otherwise the program will experience undefined behaviour. - @@ -39488,7 +37782,6 @@ will experience undefined behaviour. Clears a pointer to a #GSList, freeing it and, optionally, freeing its elements using @destroy. @slist_ptr must be a valid pointer. If @slist_ptr points to a null #GSList, this does nothing. - @@ -39513,7 +37806,6 @@ Besides using #GError, there is another major reason to prefer this function over the call provided by the system; on Unix, it will attempt to correctly handle %EINTR, which has platform-specific semantics. - %TRUE on success, %FALSE if there was an error. @@ -39531,10 +37823,11 @@ convenience wrapper for g_checksum_new(), g_checksum_get_string() and g_checksum_free(). The hexadecimal string returned will be in lower case. - - - the digest of the binary data as a string in hexadecimal. - The returned string should be freed with g_free() when done using it. + + the digest of the binary data as a + string in hexadecimal, or %NULL if g_checksum_new() fails for + @checksum_type. The returned string should be freed with g_free() when + done using it. @@ -39554,10 +37847,11 @@ convenience wrapper for g_checksum_new(), g_checksum_get_string() and g_checksum_free(). The hexadecimal string returned will be in lower case. - - - the digest of the binary data as a string in hexadecimal. - The returned string should be freed with g_free() when done using it. + + the digest of the binary data as a + string in hexadecimal, or %NULL if g_checksum_new() fails for + @checksum_type. The returned string should be freed with g_free() when + done using it. @@ -39581,9 +37875,9 @@ The hexadecimal string returned will be in lower case. Computes the checksum of a string. The hexadecimal string returned will be in lower case. - - - the checksum as a hexadecimal string. The returned string + + the checksum as a hexadecimal string, + or %NULL if g_checksum_new() fails for @checksum_type. The returned string should be freed with g_free() when done using it. @@ -39608,7 +37902,6 @@ convenience wrapper for g_hmac_new(), g_hmac_get_string() and g_hmac_unref(). The hexadecimal string returned will be in lower case. - the HMAC of the binary data as a string in hexadecimal. The returned string should be freed with g_free() when done using it. @@ -39635,7 +37928,6 @@ convenience wrapper for g_hmac_new(), g_hmac_get_string() and g_hmac_unref(). The hexadecimal string returned will be in lower case. - the HMAC of the binary data as a string in hexadecimal. The returned string should be freed with g_free() when done using it. @@ -39672,7 +37964,6 @@ The hexadecimal string returned will be in lower case. Computes the HMAC for a string. The hexadecimal string returned will be in lower case. - the HMAC as a hexadecimal string. The returned string should be freed with g_free() @@ -39813,7 +38104,6 @@ could combine with the base character.) Using extensions such as "//TRANSLIT" may not work (or may not work well) on many platforms. Consider using g_str_to_ascii() instead. - If the conversion was successful, a newly allocated buffer @@ -39887,7 +38177,6 @@ g_convert_with_iconv() or g_convert_with_fallback(). (An example of this is the GNU C converter for CP1255 which does not emit a base character until it knows that the next character is not a mark that could combine with the base character.) - If the conversion was successful, a newly allocated buffer @@ -39963,7 +38252,6 @@ specification, which leaves this behaviour implementation defined. Note that this is the same error code as is returned for an invalid byte sequence in the input character set. To get defined behaviour for conversion of unrepresentable characters, use g_convert_with_fallback(). - If the conversion was successful, a newly allocated buffer @@ -40042,7 +38330,6 @@ To remove all data elements from a datalist, use g_datalist_clear(). Frees all the data elements of the datalist. The data elements' destroy functions are called if they have been set. - @@ -40064,7 +38351,6 @@ not be called. @func can make changes to @datalist, but the iteration will not reflect changes made during the g_datalist_foreach() call, other than skipping over elements that are removed. - @@ -40086,7 +38372,6 @@ than skipping over elements that are removed. Gets a data element, using its string identifier. This is slower than g_datalist_id_get_data() because it compares strings. - the data element, or %NULL if it is not found. @@ -40106,7 +38391,6 @@ g_datalist_id_get_data() because it compares strings. Gets flags values packed in together with the datalist. See g_datalist_set_flags(). - the flags of the datalist @@ -40132,7 +38416,6 @@ 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. - the result of calling @dup_func on the value associated with @key_id in @datalist, or %NULL if not set. @@ -40160,7 +38443,6 @@ threads are using the same datalist and the same key. Retrieves the data element corresponding to @key_id. - the data element, or %NULL if it is not found. @@ -40179,7 +38461,6 @@ threads are using the same datalist and the same key. Removes an element, using its #GQuark identifier. - a datalist. @@ -40192,7 +38473,6 @@ threads are using the same datalist and the same key. Removes an element, without calling its destroy notification function. - the data previously stored at @key_id, or %NULL if none. @@ -40223,7 +38503,6 @@ the registered 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. - %TRUE if the existing value for @key_id was replaced by @newval, %FALSE otherwise. @@ -40260,7 +38539,6 @@ should not destroy the object in the normal way. Sets the data corresponding to the given #GQuark id. Any previous data with the same key is removed, and its destroy function is called. - a datalist. @@ -40279,7 +38557,6 @@ called. function to be called when the element is removed from the datalist. Any previous data with the same key is removed, and its destroy function is called. - @@ -40310,7 +38587,6 @@ function is called. Resets the datalist to %NULL. It does not free any memory or call any destroy functions. - @@ -40324,7 +38600,6 @@ any destroy functions. Removes an element using its string identifier. The data element's destroy function is called if it has been set. - a datalist. @@ -40336,7 +38611,6 @@ destroy function is called if it has been set. Removes an element, without calling its destroy notifier. - a datalist. @@ -40348,7 +38622,6 @@ destroy function is called if it has been set. Sets the data element corresponding to the given string identifier. - a datalist. @@ -40365,7 +38638,6 @@ destroy function is called if it has been set. Sets the data element corresponding to the given string identifier, and the function to be called when the data element is removed. - a datalist. @@ -40392,7 +38664,6 @@ a data list without using any additional space. It is not generally useful except in circumstances where space is very tight. (It is used in the base #GObject type, for example.) - @@ -40413,7 +38684,6 @@ example.) Turns off flag values for a data list. See g_datalist_unset_flags() - @@ -40435,7 +38705,6 @@ example.) Destroys the dataset, freeing all memory allocated, and calling any destroy functions set for data elements. - @@ -40455,7 +38724,6 @@ during invocation of this function, it should not be called. @func can make changes to the dataset, but the iteration will not reflect changes made during the g_dataset_foreach() call, other than skipping over elements that are removed. - @@ -40476,7 +38744,6 @@ than skipping over elements that are removed. Gets the data element corresponding to a string. - the location identifying the dataset. @@ -40488,7 +38755,6 @@ than skipping over elements that are removed. Gets the data element corresponding to a #GQuark. - the data element corresponding to the #GQuark, or %NULL if it is not found. @@ -40508,7 +38774,6 @@ than skipping over elements that are removed. Removes a data element from a dataset. The data element's destroy function is called if it has been set. - the location identifying the dataset. @@ -40521,7 +38786,6 @@ function is called if it has been set. Removes an element, without calling its destroy notification function. - the data previously stored at @key_id, or %NULL if none. @@ -40542,7 +38806,6 @@ function. Sets the data element associated with the given #GQuark id. Any previous data with the same key is removed, and its destroy function is called. - the location identifying the dataset. @@ -40560,7 +38823,6 @@ is called. the function to call when the data element is destroyed. Any previous data with the same key is removed, and its destroy function is called. - @@ -40589,7 +38851,6 @@ is called. Removes a data element corresponding to a string. Its destroy function is called if it has been set. - the location identifying the dataset. @@ -40601,7 +38862,6 @@ function is called if it has been set. Removes an element, without calling its destroy notifier. - the location identifying the dataset. @@ -40613,7 +38873,6 @@ function is called if it has been set. Sets the data corresponding to the given string identifier. - the location identifying the dataset. @@ -40629,7 +38888,6 @@ function is called if it has been set. Sets the data corresponding to the given string identifier, and the function to call when the data element is destroyed. - the location identifying the dataset. @@ -40721,277 +38979,7 @@ representation is valid. Sometimes neither is valid. Use the API. GLib also features #GDateTime which represents a precise time. - - Returns the number of days in a month, taking leap -years into account. - - - number of days in @month during the @year - - - - - month - - - - year - - - - - - Returns the number of weeks in the year, where weeks -are taken to start on Monday. Will be 52 or 53. The -date must be valid. (Years always have 52 7-day periods, -plus 1 or 2 extra days depending on whether it's a leap -year. This function is basically telling you how many -Mondays are in the year, i.e. there are 53 Mondays if -one of the extra days happens to be a Monday.) - - - number of Mondays in the year - - - - - a year - - - - - - Returns the number of weeks in the year, where weeks -are taken to start on Sunday. Will be 52 or 53. The -date must be valid. (Years always have 52 7-day periods, -plus 1 or 2 extra days depending on whether it's a leap -year. This function is basically telling you how many -Sundays are in the year, i.e. there are 53 Sundays if -one of the extra days happens to be a Sunday.) - - - the number of weeks in @year - - - - - year to count weeks in - - - - - - Returns %TRUE if the year is a leap year. - -For the purposes of this function, leap year is every year -divisible by 4 unless that year is divisible by 100. If it -is divisible by 100 it would be a leap year only if that year -is also divisible by 400. - - - %TRUE if the year is a leap year - - - - - year to check - - - - - - Generates a printed representation of the date, in a -[locale][setlocale]-specific way. -Works just like the platform's C library strftime() function, -but only accepts date-related formats; time-related formats -give undefined results. Date must be valid. Unlike strftime() -(which uses the locale encoding), works on a UTF-8 format -string and stores a UTF-8 result. - -This function does not provide any conversion specifiers in -addition to those implemented by the platform's C library. -For example, don't expect that using g_date_strftime() would -make the \%F provided by the C99 strftime() work on Windows -where the C library only complies to C89. - - - number of characters written to the buffer, or 0 the buffer was too small - - - - - destination buffer - - - - buffer size - - - - format string - - - - valid #GDate - - - - - - A comparison function for #GDateTimes that is suitable -as a #GCompareFunc. Both #GDateTimes must be non-%NULL. - - - -1, 0 or 1 if @dt1 is less than, equal to or greater - than @dt2. - - - - - first #GDateTime to compare - - - - second #GDateTime to compare - - - - - - Checks to see if @dt1 and @dt2 are equal. - -Equal here means that they represent the same moment after converting -them to the same time zone. - - - %TRUE if @dt1 and @dt2 are equal - - - - - a #GDateTime - - - - a #GDateTime - - - - - - Hashes @datetime into a #guint, suitable for use within #GHashTable. - - - a #guint containing the hash - - - - - a #GDateTime - - - - - - Returns %TRUE if the day of the month is valid (a day is valid if it's -between 1 and 31 inclusive). - - - %TRUE if the day is valid - - - - - day to check - - - - - - Returns %TRUE if the day-month-year triplet forms a valid, existing day -in the range of days #GDate understands (Year 1 or later, no more than -a few thousand years in the future). - - - %TRUE if the date is a valid one - - - - - day - - - - month - - - - year - - - - - - Returns %TRUE if the Julian day is valid. Anything greater than zero -is basically a valid Julian, though there is a 32-bit limit. - - - %TRUE if the Julian day is valid - - - - - Julian day to check - - - - - - Returns %TRUE if the month value is valid. The 12 #GDateMonth -enumeration values are the only valid months. - - - %TRUE if the month is valid - - - - - month - - - - - - Returns %TRUE if the weekday is valid. The seven #GDateWeekday enumeration -values are the only valid weekdays. - - - %TRUE if the weekday is valid - - - - - weekday - - - - - - Returns %TRUE if the year is valid. Any year greater than 0 is valid, -though there is a 16-bit limit to what #GDate will understand. - - - %TRUE if the year is valid - - - - - year - - - - - + #GDateTime is a structure that combines a Gregorian date and time into a single structure. It provides many conversion and methods to manipulate dates and times. Time precision is provided down to @@ -41018,12 +39006,215 @@ savings time transitions are either 23 or 25 hours in length). #GDateTime is available since GLib 2.26. + + Returns the number of days in a month, taking leap +years into account. + + number of days in @month during the @year + + + + + month + + + + year + + + + + + Returns the number of weeks in the year, where weeks +are taken to start on Monday. Will be 52 or 53. The +date must be valid. (Years always have 52 7-day periods, +plus 1 or 2 extra days depending on whether it's a leap +year. This function is basically telling you how many +Mondays are in the year, i.e. there are 53 Mondays if +one of the extra days happens to be a Monday.) + + number of Mondays in the year + + + + + a year + + + + + + Returns the number of weeks in the year, where weeks +are taken to start on Sunday. Will be 52 or 53. The +date must be valid. (Years always have 52 7-day periods, +plus 1 or 2 extra days depending on whether it's a leap +year. This function is basically telling you how many +Sundays are in the year, i.e. there are 53 Sundays if +one of the extra days happens to be a Sunday.) + + the number of weeks in @year + + + + + year to count weeks in + + + + + + Returns %TRUE if the year is a leap year. + +For the purposes of this function, leap year is every year +divisible by 4 unless that year is divisible by 100. If it +is divisible by 100 it would be a leap year only if that year +is also divisible by 400. + + %TRUE if the year is a leap year + + + + + year to check + + + + + + Generates a printed representation of the date, in a +[locale][setlocale]-specific way. +Works just like the platform's C library strftime() function, +but only accepts date-related formats; time-related formats +give undefined results. Date must be valid. Unlike strftime() +(which uses the locale encoding), works on a UTF-8 format +string and stores a UTF-8 result. + +This function does not provide any conversion specifiers in +addition to those implemented by the platform's C library. +For example, don't expect that using g_date_strftime() would +make the \%F provided by the C99 strftime() work on Windows +where the C library only complies to C89. + + number of characters written to the buffer, or 0 the buffer was too small + + + + + destination buffer + + + + buffer size + + + + format string + + + + valid #GDate + + + + + + Returns %TRUE if the day of the month is valid (a day is valid if it's +between 1 and 31 inclusive). + + %TRUE if the day is valid + + + + + day to check + + + + + + Returns %TRUE if the day-month-year triplet forms a valid, existing day +in the range of days #GDate understands (Year 1 or later, no more than +a few thousand years in the future). + + %TRUE if the date is a valid one + + + + + day + + + + month + + + + year + + + + + + Returns %TRUE if the Julian day is valid. Anything greater than zero +is basically a valid Julian, though there is a 32-bit limit. + + %TRUE if the Julian day is valid + + + + + Julian day to check + + + + + + Returns %TRUE if the month value is valid. The 12 #GDateMonth +enumeration values are the only valid months. + + %TRUE if the month is valid + + + + + month + + + + + + Returns %TRUE if the weekday is valid. The seven #GDateWeekday enumeration +values are the only valid weekdays. + + %TRUE if the weekday is valid + + + + + weekday + + + + + + Returns %TRUE if the year is valid. Any year greater than 0 is valid, +though there is a 16-bit limit to what #GDate will understand. + + %TRUE if the year is valid + + + + + year + + + + This is a variant of g_dgettext() that allows specifying a locale category instead of always using `LC_MESSAGES`. See g_dgettext() for more information about how this functions differs from calling dcgettext() directly. - the translated string for the given locale category @@ -41077,7 +39268,6 @@ cases the application should call textdomain() after initializing GTK+. Applications should normally not use this function directly, but use the _() macro for translations. - The translated string @@ -41106,7 +39296,6 @@ basename, no directory components are allowed. If template is Note that in contrast to g_mkdtemp() (and mkdtemp()) @tmpl is not modified, and might thus be a read-only literal string. - The actual name used. This string should be freed with g_free() when not needed any longer and is @@ -41130,7 +39319,6 @@ keys in a #GHashTable. This equality function is also appropriate for keys that are integers stored in pointers, such as `GINT_TO_POINTER (n)`. - %TRUE if the two keys match. @@ -41154,7 +39342,6 @@ when using opaque pointers compared by pointer value as keys in a This hash function is also appropriate for keys that are integers stored in pointers, such as `GINT_TO_POINTER (n)`. - a hash value corresponding to the key. @@ -41173,7 +39360,6 @@ translations for the current locale. See g_dgettext() for details of how this differs from dngettext() proper. - The translated string @@ -41204,7 +39390,6 @@ proper. It can be passed to g_hash_table_new() as the @key_equal_func parameter, when using non-%NULL pointers to doubles as keys in a #GHashTable. - %TRUE if the two keys match. @@ -41225,7 +39410,6 @@ parameter, when using non-%NULL pointers to doubles as keys in a It can be passed to g_hash_table_new() as the @hash_func parameter, It can be passed to g_hash_table_new() as the @hash_func parameter, when using non-%NULL pointers to doubles as keys in a #GHashTable. - a hash value corresponding to the key. @@ -41251,7 +39435,6 @@ with dgettext() proper. Applications should normally not use this function directly, but use the C_() macro for translations with context. - The translated string @@ -41284,7 +39467,6 @@ with dgettext() proper. This function differs from C_() in that it is not a macro and thus you may use non-string-literals as context and msgid arguments. - The translated string @@ -41308,7 +39490,6 @@ thus you may use non-string-literals as context and msgid arguments. Returns the value of the environment variable @variable in the provided list @envp. - the value of the environment variable, or %NULL if the environment variable is not set in @envp. The returned @@ -41334,7 +39515,6 @@ provided list @envp. Sets the environment variable @variable in the provided list @envp to @value. - the updated environment list. Free it using g_strfreev(). @@ -41370,7 +39550,6 @@ provided list @envp. Removes the environment variable @variable from the provided environment @envp. - the updated environment list. Free it using g_strfreev(). @@ -41684,14 +39863,14 @@ Summary of rules for use of #GError: - Do not report programming errors via #GError. - The last argument of a function that returns an error should - be a location where a #GError can be placed (i.e. "#GError** error"). - If #GError is used with varargs, the #GError** should be the last - argument before the "...". + be a location where a #GError can be placed (i.e. `GError **error`). + If #GError is used with varargs, the `GError**` should be the last + argument before the `...`. -- The caller may pass %NULL for the #GError** if they are not interested +- The caller may pass %NULL for the `GError**` if they are not interested in details of the exact error that occurred. -- If %NULL is passed for the #GError** argument, then errors should +- If %NULL is passed for the `GError**` argument, then errors should not be returned to the caller, but your function should still abort and return if an error occurs. That is, control flow should not be affected by whether the caller wants to get a #GError. @@ -41705,11 +39884,13 @@ Summary of rules for use of #GError: - If a #GError is reported, out parameters are not guaranteed to be set to any defined value. -- A #GError* must be initialized to %NULL before passing its address +- A `GError*` must be initialized to %NULL before passing its address to a function that can report errors. +- #GError structs must not be stack-allocated. + - "Piling up" errors is always a bug. That is, if you assign a - new #GError to a #GError* that is non-%NULL, thus overwriting + new #GError to a `GError*` that is non-%NULL, thus overwriting the previous error, it indicates that you should have aborted the operation instead of continuing. If you were able to continue, you should have cleared the previous error with g_clear_error(). @@ -41717,12 +39898,12 @@ Summary of rules for use of #GError: - By convention, if you return a boolean value indicating success then %TRUE means success and %FALSE means failure. Avoid creating - functions which have a boolean return value and a GError parameter, + functions which have a boolean return value and a #GError parameter, but where the boolean does something other than signal whether the - GError is set. Among other problems, it requires C callers to allocate - a temporary error. Instead, provide a "gboolean *" out parameter. + #GError is set. Among other problems, it requires C callers to allocate + a temporary error. Instead, provide a `gboolean *` out parameter. There are functions in GLib itself such as g_key_file_has_key() that - are deprecated because of this. If %FALSE is returned, the error must + are hard to use because of this. If %FALSE is returned, the error must be set to a non-%NULL value. One exception to this is that in situations that are already considered to be undefined behaviour (such as when a g_return_val_if_fail() check fails), the error need not be set. @@ -41739,7 +39920,122 @@ Summary of rules for use of #GError: - When implementing a function that can report errors, you may want to add a check at the top of your function that the error return location is either %NULL or contains a %NULL error (e.g. - `g_return_if_fail (error == NULL || *error == NULL);`). + `g_return_if_fail (error == NULL || *error == NULL);`). + +## Extended #GError Domains # {#gerror-extended-domains} + +Since GLib 2.68 it is possible to extend the #GError type. This is +done with the G_DEFINE_EXTENDED_ERROR() macro. To create an +extended #GError type do something like this in the header file: +|[<!-- language="C" --> +typedef enum +{ + MY_ERROR_BAD_REQUEST, +} MyError; +#define MY_ERROR (my_error_quark ()) +GQuark my_error_quark (void); +int +my_error_get_parse_error_id (GError *error); +const char * +my_error_get_bad_request_details (GError *error); +]| +and in implementation: +|[<!-- language="C" --> +typedef struct +{ + int parse_error_id; + char *bad_request_details; +} MyErrorPrivate; + +static void +my_error_private_init (MyErrorPrivate *priv) +{ + priv->parse_error_id = -1; + // No need to set priv->bad_request_details to NULL, + // the struct is initialized with zeros. +} + +static void +my_error_private_copy (const MyErrorPrivate *src_priv, MyErrorPrivate *dest_priv) +{ + dest_priv->parse_error_id = src_priv->parse_error_id; + dest_priv->bad_request_details = g_strdup (src_priv->bad_request_details); +} + +static void +my_error_private_clear (MyErrorPrivate *priv) +{ + g_free (priv->bad_request_details); +} + +// This defines the my_error_get_private and my_error_quark functions. +G_DEFINE_EXTENDED_ERROR (MyError, my_error) + +int +my_error_get_parse_error_id (GError *error) +{ + MyErrorPrivate *priv = my_error_get_private (error); + g_return_val_if_fail (priv != NULL, -1); + return priv->parse_error_id; +} + +const char * +my_error_get_bad_request_details (GError *error) +{ + MyErrorPrivate *priv = my_error_get_private (error); + g_return_val_if_fail (priv != NULL, NULL); + g_return_val_if_fail (error->code != MY_ERROR_BAD_REQUEST, NULL); + return priv->bad_request_details; +} + +static void +my_error_set_bad_request (GError **error, + const char *reason, + int error_id, + const char *details) +{ + MyErrorPrivate *priv; + g_set_error (error, MY_ERROR, MY_ERROR_BAD_REQUEST, "Invalid request: %s", reason); + if (error != NULL && *error != NULL) + { + priv = my_error_get_private (error); + g_return_val_if_fail (priv != NULL, NULL); + priv->parse_error_id = error_id; + priv->bad_request_details = g_strdup (details); + } +} +]| +An example of use of the error could be: +|[<!-- language="C" --> +gboolean +send_request (GBytes *request, GError **error) +{ + ParseFailedStatus *failure = validate_request (request); + if (failure != NULL) + { + my_error_set_bad_request (error, failure->reason, failure->error_id, failure->details); + parse_failed_status_free (failure); + return FALSE; + } + + return send_one (request, error); +} +]| + +Please note that if you are a library author and your library +exposes an existing error domain, then you can't make this error +domain an extended one without breaking ABI. This is because +earlier it was possible to create an error with this error domain +on the stack and then copy it with g_error_copy(). If the new +version of your library makes the error domain an extended one, +then g_error_copy() called by code that allocated the error on the +stack will try to copy more data than it used to, which will lead +to undefined behavior. You must not stack-allocate errors with an +extended error domain, and it is bad practice to stack-allocate any +other #GErrors. + +Extended error domains in unloadable plugins/modules are not +supported. Gets a #GFileError constant based on the passed-in @err_no. @@ -41750,7 +40046,6 @@ assume that all #GFileError values will exist. Normally a #GFileError value goes into a #GError returned from a function that manipulates files. So you would use g_file_error_from_errno() when constructing a #GError. - #GFileError corresponding to the given @errno @@ -41778,7 +40073,6 @@ stored in @contents will be nul-terminated, so for text files you can pass %FALSE and sets @error. The error domain is #G_FILE_ERROR. Possible error codes are those in the #GFileError enumeration. In the error case, @contents is set to %NULL and @length is set to zero. - %TRUE on success, %FALSE if an error occurred @@ -41818,7 +40112,6 @@ Upon success, and if @name_used is non-%NULL, the actual name used is returned in @name_used. This string should be freed with g_free() when not needed any longer. The returned name is in the GLib file name encoding. - A file handle (as from open()) to the file opened for reading and writing. The file is opened in binary mode on platforms @@ -41843,7 +40136,6 @@ name encoding. Reads the contents of the symbolic link @filename like the POSIX readlink() function. The returned string is in the encoding used for filenames. Use g_filename_to_utf8() to convert it to UTF-8. - A newly-allocated string with the contents of the symbolic link, or %NULL if an error occurred. @@ -41858,10 +40150,9 @@ for filenames. Use g_filename_to_utf8() to convert it to UTF-8. Writes all of @contents to a file named @filename. This is a convenience -wrapper around calling g_file_set_contents() with `flags` set to +wrapper around calling g_file_set_contents_full() with `flags` set to `G_FILE_SET_CONTENTS_CONSISTENT | G_FILE_SET_CONTENTS_ONLY_EXISTING` and `mode` set to `0666`. - %TRUE on success, %FALSE if an error occurred @@ -41939,7 +40230,6 @@ to 7 characters to @filename. If the file didn’t exist before and is created, it will be given the permissions from @mode. Otherwise, the permissions of the existing file may be changed to @mode depending on @flags, or they may remain unchanged. - %TRUE on success, %FALSE if an error occurred @@ -42012,7 +40302,6 @@ On Windows, there are no symlinks, so testing for %G_FILE_TEST_IS_EXECUTABLE will just check that the file exists and its name indicates that it is executable, checking for well-known extensions and those listed in the `PATHEXT` environment variable. - whether a test was %TRUE @@ -42046,7 +40335,6 @@ translation of well known locations can be done. This function is preferred over g_filename_display_name() if you know the whole path, as it allows translation. - a newly allocated string containing a rendition of the basename of the filename in valid UTF-8 @@ -42076,7 +40364,6 @@ encoding. If you know the whole pathname of the file you should use g_filename_display_basename(), since that allows location-based translation of filenames. - a newly allocated string containing a rendition of the filename in valid UTF-8 @@ -42093,7 +40380,6 @@ translation of filenames. Converts an escaped ASCII-encoded URI to a local filename in the encoding used for filenames. - a newly-allocated string holding the resulting filename, or %NULL on an error. @@ -42123,7 +40409,6 @@ argument is positive. A nul character found inside the string will result in error %G_CONVERT_ERROR_ILLEGAL_SEQUENCE. If the filename encoding is not UTF-8 and the conversion output contains a nul character, the error %G_CONVERT_ERROR_EMBEDDED_NUL is set and the function returns %NULL. - The converted string, or %NULL on an error. @@ -42160,7 +40445,6 @@ not UTF-8 and the conversion output contains a nul character, the error Converts an absolute filename to an escaped ASCII-encoded URI, with the path component following Section 3.3. of RFC 2396. - a newly-allocated string holding the resulting URI, or %NULL on an error. @@ -42192,7 +40476,6 @@ If the source encoding is not UTF-8 and the conversion output contains a nul character, the error %G_CONVERT_ERROR_EMBEDDED_NUL is set and the function returns %NULL. Use g_convert() to produce output that may contain embedded nul characters. - The converted string, or %NULL on an error. @@ -42277,7 +40560,6 @@ Windows 32-bit system directory, then in the Windows directory, and finally in the directories in the `PATH` environment variable. If the program is found, the return value contains the full name including the type suffix. - a newly-allocated string with the absolute path, or %NULL @@ -42304,7 +40586,6 @@ This string should be freed with g_free() when not needed any longer. See g_format_size_full() for more options about how the size might be formatted. - a newly-allocated formatted string containing a human readable file size @@ -42329,7 +40610,6 @@ The prefix units base is 1024 (i.e. 1 KB is 1024 bytes). This string should be freed with g_free() when not needed any longer. This function is broken due to its use of SI suffixes to denote IEC units. Use g_format_size() instead. - a newly-allocated formatted string containing a human readable file size @@ -42347,7 +40627,6 @@ This string should be freed with g_free() when not needed any longer. This function is similar to g_format_size() but allows for flags that modify the output. See #GFormatSizeFlags. - a newly-allocated formatted string containing a human readable file size @@ -42369,7 +40648,6 @@ that modify the output. See #GFormatSizeFlags. positional parameters, as specified in the Single Unix Specification. `glib/gprintf.h` must be explicitly included in order to use this function. - the number of bytes printed. @@ -42395,7 +40673,6 @@ positional parameters, as specified in the Single Unix Specification. If @mem is %NULL it simply returns, so there is no need to check @mem against %NULL before calling this function. - @@ -42414,7 +40691,6 @@ g_get_prgname(), which gets a non-localized name. If g_set_application_name() has not been called, returns the result of g_get_prgname() (which may be %NULL if g_set_prgname() has also not been called). - human-readable application name. May return %NULL @@ -42442,7 +40718,6 @@ case you can perhaps avoid calling g_convert(). The string returned in @charset is not allocated, and should not be freed. - %TRUE if the returned charset is UTF-8 @@ -42457,7 +40732,6 @@ freed. Gets the character set for the current locale. - a newly allocated string containing the name of the character set. This string must be freed with g_free(). @@ -42482,7 +40756,6 @@ case you can perhaps avoid calling g_convert(). The string returned in @charset is not allocated, and should not be freed. - %TRUE if the returned charset is UTF-8 @@ -42506,7 +40779,6 @@ Since GLib 2.40, this function will return the value of the "PWD" environment variable if it is set and it happens to be the same as the current directory. This can make a difference in the case that the current directory is the target of a symbolic link. - the current directory @@ -42518,7 +40790,6 @@ the current directory is the target of a symbolic link. You may find g_get_real_time() to be more convenient. #GTimeVal is not year-2038-safe. Use g_get_real_time() instead. - @@ -42540,7 +40811,6 @@ except portable. The return value is freshly allocated and it should be freed with g_strfreev() when it is no longer needed. - the list of environment variables @@ -42574,7 +40844,6 @@ The returned @charsets belong to GLib and must not be freed. Note that on Unix, regardless of the locale character set or `G_FILENAME_ENCODING` value, the actual file names present on a system might be in any random encoding or just gibberish. - %TRUE if the filename encoding is UTF-8. @@ -42610,7 +40879,6 @@ old behaviour (and if you don't wish to increase your GLib dependency to ensure that the new behaviour is in effect) then you should either directly check the `HOME` environment variable yourself or unset it before calling any functions in GLib. - the current user's home directory @@ -42631,7 +40899,6 @@ name can be determined, a default fixed string "localhost" is returned. The encoding of the returned string is UTF-8. - the host name of the machine. @@ -42649,7 +40916,6 @@ For example, if LANGUAGE=de:en_US, then the returned list is This function consults the environment variables `LANGUAGE`, `LC_ALL`, `LC_MESSAGES` and `LANG` to find the list of locales specified by the user. - a %NULL-terminated array of strings owned by GLib that must not be modified or freed. @@ -42669,7 +40935,6 @@ This function consults the environment variables `LANGUAGE`, `LC_ALL`, user. g_get_language_names() returns g_get_language_names_with_category("LC_MESSAGES"). - a %NULL-terminated array of strings owned by the thread g_get_language_names_with_category was called from. @@ -42701,7 +40966,6 @@ is `en_GB.UTF-8@euro`, `en_GB.UTF-8`, `en_GB@euro`, `en_GB`, `en.UTF-8@euro`, If you need the list of variants for the current locale, use g_get_language_names(). - a newly allocated array of newly allocated strings with the locale variants. Free with @@ -42728,7 +40992,6 @@ suspended. We try to use the clock that corresponds as closely as possible to the passage of time as measured by system calls such as poll() but it may not always be possible to do this. - the monotonic time, in microseconds @@ -42739,7 +41002,6 @@ may not always be possible to do this. schedule simultaneously for this process. This is intended to be used as a parameter to g_thread_pool_new() for CPU bound tasks and similar cases. - Number of schedulable threads, always greater than 0 @@ -42754,7 +41016,6 @@ like %G_OS_INFO_KEY_NAME or pass any UTF-8 string key name. For example, `/etc/os-release` provides a number of other less commonly used values that may be useful. No key is guaranteed to be provided, so the caller should always check if the result is %NULL. - The associated value for the requested key or %NULL if this information is not provided. @@ -42776,7 +41037,6 @@ g_application_run(). In case of GDK or GTK+ it is set in gdk_init(), which is called by gtk_init() and the #GtkApplication::startup handler. The program name is found by taking the last component of @argv[0]. - the name of the program, or %NULL if it has not been set yet. The returned string belongs @@ -42790,7 +41050,6 @@ entry in the `passwd` file. The encoding of the returned string is system-defined. (On Windows, it is, however, always UTF-8.) If the real user name cannot be determined, the string "Unknown" is returned. - the user's real name. @@ -42806,7 +41065,6 @@ that the return value is often more convenient than dealing with a You should only use this call if you are actually interested in the real wall-clock time. g_get_monotonic_time() is probably more useful for measuring intervals. - the number of microseconds since January 1, 1970 UTC. @@ -42829,8 +41087,10 @@ This folder is used for application data that is not user specific. For example, an application can store a spell-check dictionary, a database of clip art, or a log file in the CSIDL_COMMON_APPDATA folder. This information will not roam and is available -to anyone using the computer. - +to anyone using the computer. + +The return value is cached and modifying it at runtime is not supported, as +it’s not thread-safe to modify environment variables at runtime. a %NULL-terminated array of strings owned by GLib that must not be @@ -42871,8 +41131,10 @@ folder's name is "bin", its parent is used, otherwise the folder itself. Note that on Windows the returned list can vary depending on where -this function is called. - +this function is called. + +The return value is cached and modifying it at runtime is not supported, as +it’s not thread-safe to modify environment variables at runtime. a %NULL-terminated array of strings owned by GLib that must not be @@ -42897,7 +41159,6 @@ as a default. The encoding of the returned string is system-defined. On Windows, it is always UTF-8. The return value is never %NULL or the empty string. - the directory to use for temporary files. @@ -42916,8 +41177,10 @@ On Windows it follows XDG Base Directory Specification if `XDG_CACHE_HOME` is de If `XDG_CACHE_HOME` is undefined, the directory that serves as a common repository for temporary Internet files is used instead. A typical path is `C:\Documents and Settings\username\Local Settings\Temporary Internet Files`. -See the [documentation for `CSIDL_INTERNET_CACHE`](https://msdn.microsoft.com/en-us/library/windows/desktop/bb762494%28v=vs.85%29.aspx#csidl_internet_cache). - +See the [documentation for `CSIDL_INTERNET_CACHE`](https://msdn.microsoft.com/en-us/library/windows/desktop/bb762494%28v=vs.85%29.aspx#csidl_internet_cache). + +The return value is cached and modifying it at runtime is not supported, as +it’s not thread-safe to modify environment variables at runtime. a string owned by GLib that must not be modified or freed. @@ -42938,8 +41201,10 @@ If `XDG_CONFIG_HOME` is undefined, the folder to use for local (as opposed to roaming) application data is used instead. See the [documentation for `CSIDL_LOCAL_APPDATA`](https://msdn.microsoft.com/en-us/library/windows/desktop/bb762494%28v=vs.85%29.aspx#csidl_local_appdata). Note that in this case on Windows it will be the same -as what g_get_user_data_dir() returns. - +as what g_get_user_data_dir() returns. + +The return value is cached and modifying it at runtime is not supported, as +it’s not thread-safe to modify environment variables at runtime. a string owned by GLib that must not be modified or freed. @@ -42960,8 +41225,10 @@ is defined. If `XDG_DATA_HOME` is undefined, the folder to use for local (as opposed to roaming) application data is used instead. See the [documentation for `CSIDL_LOCAL_APPDATA`](https://msdn.microsoft.com/en-us/library/windows/desktop/bb762494%28v=vs.85%29.aspx#csidl_local_appdata). Note that in this case on Windows it will be the same -as what g_get_user_config_dir() returns. - +as what g_get_user_config_dir() returns. + +The return value is cached and modifying it at runtime is not supported, as +it’s not thread-safe to modify environment variables at runtime. a string owned by GLib that must not be modified or freed. @@ -42973,7 +41240,6 @@ as what g_get_user_config_dir() returns. string is system-defined. On UNIX, it might be the preferred file name encoding, or something else, and there is no guarantee that it is even consistent on a machine. On Windows, it is always UTF-8. - the user name of the current user. @@ -42989,8 +41255,10 @@ in the This is the directory specified in the `XDG_RUNTIME_DIR` environment variable. In the case that this variable is not set, we return the value of -g_get_user_cache_dir(), after verifying that it exists. - +g_get_user_cache_dir(), after verifying that it exists. + +The return value is cached and modifying it at runtime is not supported, as +it’s not thread-safe to modify environment variables at runtime. a string owned by GLib that must not be modified or freed. @@ -43008,7 +41276,6 @@ not been set up. Depending on the platform, the user might be able to change the path of the special directory without requiring the session to restart; GLib will not reflect any change once the special directories are loaded. - the path to the specified special directory, or %NULL if the logical id was not found. The returned string is owned by @@ -43030,7 +41297,6 @@ be in some consistent character set and encoding. On Windows, they are in UTF-8. On Windows, in case the environment variable's value contains references to other environment variables, they are expanded. - the value of the environment variable, or %NULL if the environment variable is not found. The returned string @@ -43058,6 +41324,19 @@ backward-compatibility with the old ASCII-only DNS, by defining an ASCII-Compatible Encoding of any given Unicode name, which can be used with non-IDN-aware applications and protocols. (For example, "Παν語.org" maps to "xn--4wa8awb4637h.org".) + + + #GStrvBuilder is a method of easily building dynamically sized +NULL-terminated string arrays. + +The following example shows how to build a two element array: + +|[<!-- language="C" --> + g_autoptr(GStrvBuilder) builder = g_strv_builder_new (); + g_strv_builder_add (builder, "hello"); + g_strv_builder_add (builder, "world"); + g_auto(GStrv) array = g_strv_builder_end (builder); +]| Most of GLib is intended to be portable; in contrast, this set of @@ -43084,7 +41363,6 @@ the discussion in the section description. Starting from GLib 2.40, this function returns a boolean value to indicate whether the newly added value was already in the hash table or not. - %TRUE if the key did not exist yet @@ -43105,7 +41383,6 @@ or not. Checks if @key is in @hash_table. - %TRUE if @key is in @hash_table, %FALSE otherwise. @@ -43131,7 +41408,6 @@ you should either free them first or create the #GHashTable with destroy notifiers using g_hash_table_new_full(). In the latter case the destroy functions you supplied will be called on all keys and values during the destruction phase. - @@ -43148,7 +41424,6 @@ destruction phase. This function is deprecated and will be removed in the next major release of GLib. It does nothing. - a #GHashTable @@ -43168,7 +41443,6 @@ key is freed using that function. Starting from GLib 2.40, this function returns a boolean value to indicate whether the newly added value was already in the hash table or not. - %TRUE if the key did not exist yet @@ -43196,7 +41470,6 @@ or not. distinguish between a key that is not present and one which is present and has the value %NULL. If you need this distinction, use g_hash_table_lookup_extended(). - the associated value, or %NULL if the key is not found @@ -43224,7 +41497,6 @@ for example before calling g_hash_table_remove(). You can actually pass %NULL for @lookup_key to test whether the %NULL key exists, provided the hash and equal functions of @hash_table are %NULL-safe. - %TRUE if the key was found in the #GHashTable @@ -43259,7 +41531,6 @@ If the #GHashTable was created using g_hash_table_new_full(), the key and value are freed using the supplied destroy functions, otherwise you have to make sure that any dynamically allocated values are freed yourself. - %TRUE if the key was found and removed from the #GHashTable @@ -43285,7 +41556,6 @@ If the #GHashTable was created using g_hash_table_new_full(), the keys and values are freed using the supplied destroy functions, otherwise you have to make sure that any dynamically allocated values are freed yourself. - @@ -43311,7 +41581,6 @@ If you supplied a @key_destroy_func when creating the Starting from GLib 2.40, this function returns a boolean value to indicate whether the newly added value was already in the hash table or not. - %TRUE if the key did not exist yet @@ -43336,7 +41605,6 @@ or not. Returns the number of elements contained in the #GHashTable. - the number of key/value pairs in the #GHashTable. @@ -43354,7 +41622,6 @@ or not. Removes a key and its associated value from a #GHashTable without calling the key and value destroy functions. - %TRUE if the key was found and removed from the #GHashTable @@ -43376,7 +41643,6 @@ calling the key and value destroy functions. Removes all keys and their associated values from a #GHashTable without calling the key and value destroy functions. - @@ -43401,7 +41667,6 @@ the caller of this method; as with g_hash_table_steal(). You can pass %NULL for @lookup_key, provided the hash and equal functions of @hash_table are %NULL-safe. - %TRUE if the key was found in the #GHashTable @@ -43433,7 +41698,6 @@ of @hash_table are %NULL-safe. This function is deprecated and will be removed in the next major release of GLib. It does nothing. - a #GHashTable @@ -43445,7 +41709,6 @@ release of GLib. It does nothing. If the reference count drops to 0, all keys and values will be destroyed, and all memory allocated by the hash table is released. This function is MT-safe and may be called from any thread. - @@ -43528,7 +41791,6 @@ in GLib 2.42. Support for SHA-384 was added in GLib 2.52. Appends a #GHook onto the end of a #GHookList. - a #GHookList @@ -43540,7 +41802,6 @@ in GLib 2.42. Support for SHA-384 was added in GLib 2.52. Destroys a #GHook, given its ID. - %TRUE if the #GHook was found in the #GHookList and destroyed @@ -43559,7 +41820,6 @@ in GLib 2.42. Support for SHA-384 was added in GLib 2.52. Removes one #GHook from a #GHookList, marking it inactive and calling g_hook_unref() on it. - @@ -43577,7 +41837,6 @@ inactive and calling g_hook_unref() on it. Calls the #GHookList @finalize_hook function if it exists, and frees the memory allocated for the #GHook. - @@ -43594,7 +41853,6 @@ and frees the memory allocated for the #GHook. Inserts a #GHook into a #GHookList, before a given #GHook. - @@ -43615,7 +41873,6 @@ and frees the memory allocated for the #GHook. Prepends a #GHook on the start of a #GHookList. - @@ -43634,7 +41891,6 @@ and frees the memory allocated for the #GHook. Decrements the reference count of a #GHook. If the reference count falls to 0, the #GHook is removed from the #GHookList and g_hook_free() is called to free it. - @@ -43663,7 +41919,6 @@ before displaying it to the user. Note that a hostname might contain a mix of encoded and unencoded segments, and so it is possible for g_hostname_is_non_ascii() and g_hostname_is_ascii_encoded() to both return %TRUE for a name. - %TRUE if @hostname contains any ASCII-encoded segments. @@ -43681,7 +41936,6 @@ segments. (Eg, "192.168.0.1".) Since 2.66, IPv6 addresses with a zone-id are accepted (RFC6874). - %TRUE if @hostname is an IP address @@ -43701,7 +41955,6 @@ before using it in non-IDN-aware contexts. Note that a hostname might contain a mix of encoded and unencoded segments, and so it is possible for g_hostname_is_non_ascii() and g_hostname_is_ascii_encoded() to both return %TRUE for a name. - %TRUE if @hostname contains any non-ASCII characters @@ -43717,10 +41970,9 @@ g_hostname_is_ascii_encoded() to both return %TRUE for a name. Converts @hostname to its canonical ASCII form; an ASCII-only string containing no uppercase letters and not ending with a trailing dot. - - - an ASCII hostname, which must be freed, or %NULL if -@hostname is in some way invalid. + + an ASCII hostname, which must be freed, + or %NULL if @hostname is in some way invalid. @@ -43738,10 +41990,9 @@ and not ending with a trailing dot. Of course if @hostname is not an internationalized hostname, then the canonical presentation form will be entirely ASCII. - - - a UTF-8 hostname, which must be freed, or %NULL if -@hostname is in some way invalid. + + a UTF-8 hostname, which must be freed, + or %NULL if @hostname is in some way invalid. @@ -43753,7 +42004,6 @@ the canonical presentation form will be entirely ASCII. Converts a 32-bit integer value from host to network byte order. - a 32-bit integer value in host byte order @@ -43762,7 +42012,6 @@ the canonical presentation form will be entirely ASCII. Converts a 16-bit integer value from host to network byte order. - a 16-bit integer value in host byte order @@ -43827,7 +42076,6 @@ set, is implementation defined. This function may return success (with a positive number of non-reversible conversions as replacement characters were used), or it may return -1 and set an error such as %EILSEQ, in such a situation. - count of non-reversible conversions, or -1 on error @@ -43862,7 +42110,6 @@ a native implementation. GLib provides g_convert() and g_locale_to_utf8() which are likely more convenient than the raw iconv wrappers. - a "conversion descriptor", or (GIConv)-1 if opening the converter failed. @@ -43894,7 +42141,6 @@ and attaches it to the global #GMainContext using g_source_attach(), so the callback will be invoked in whichever thread is running that main context. You can do these steps manually if you need greater control or to use a custom main context. - the ID (greater than 0) of the event source. @@ -43923,7 +42169,6 @@ and attaches it to the global #GMainContext using g_source_attach(), so the callback will be invoked in whichever thread is running that main context. You can do these steps manually if you need greater control or to use a custom main context. - the ID (greater than 0) of the event source. @@ -43950,7 +42195,6 @@ use a custom main context. Removes the idle function with the given data. - %TRUE if an idle source was found and removed. @@ -43970,7 +42214,6 @@ and must be added to one with g_source_attach() before it will be executed. Note that the default priority for idle sources is %G_PRIORITY_DEFAULT_IDLE, as compared to other sources which have a default priority of %G_PRIORITY_DEFAULT. - the newly-created idle source @@ -43982,7 +42225,6 @@ have a default priority of %G_PRIORITY_DEFAULT. It can be passed to g_hash_table_new() as the @key_equal_func parameter, when using non-%NULL pointers to 64-bit integers as keys in a #GHashTable. - %TRUE if the two keys match. @@ -44004,7 +42246,6 @@ parameter, when using non-%NULL pointers to 64-bit integers as keys in a It can be passed to g_hash_table_new() as the @hash_func parameter, when using non-%NULL pointers to 64-bit integer values as keys in a #GHashTable. - a hash value corresponding to the key. @@ -44026,7 +42267,6 @@ parameter, when using non-%NULL pointers to integers as keys in a Note that this function acts on pointers to #gint, not on #gint directly: if your hash table's keys are of the form `GINT_TO_POINTER (n)`, use g_direct_equal() instead. - %TRUE if the two keys match. @@ -44050,7 +42290,6 @@ when using non-%NULL pointers to integer values as keys in a #GHashTable. Note that this function acts on pointers to #gint, not on #gint directly: if your hash table's keys are of the form `GINT_TO_POINTER (n)`, use g_direct_hash() instead. - a hash value corresponding to the key. @@ -44071,7 +42310,6 @@ therefore @string must not be freed or modified. This function must not be used before library constructors have finished running. In particular, this means it cannot be used to initialize global variables in C++. - a canonical representation for the string @@ -44091,7 +42329,6 @@ using strcmp(). This function must not be used before library constructors have finished running. In particular, this means it cannot be used to initialize global variables in C++. - a canonical representation for the string @@ -44106,7 +42343,6 @@ variables in C++. Adds the #GIOChannel into the default main loop context with the default priority. - the event source id @@ -44137,7 +42373,6 @@ with the given priority. This internally creates a main loop source using g_io_create_watch() and attaches it to the main loop context with g_source_attach(). You can do these steps manually if you need greater control. - the event source id @@ -44171,7 +42406,6 @@ You can do these steps manually if you need greater control. Converts an `errno` error number to a #GIOChannelError. - a #GIOChannelError error number, e.g. %G_IO_CHANNEL_ERROR_INVAL. @@ -44204,7 +42438,6 @@ at the default priority. On Windows, polling a #GSource created to watch a channel for a socket puts the socket in non-blocking mode. This is a side-effect of the implementation and unavoidable. - a new #GSource @@ -44525,7 +42758,6 @@ To free the entire list, use g_slist_free(). A convenience macro to get the next element in a #GList. Note that it is considered perfectly acceptable to access @list->next directly. - an element in a #GList @@ -44536,7 +42768,6 @@ Note that it is considered perfectly acceptable to access A convenience macro to get the previous element in a #GList. Note that it is considered perfectly acceptable to access @list->prev directly. - an element in a #GList @@ -44552,7 +42783,6 @@ from the C library directly. On Windows, the strings in the environ array are in system codepage encoding, while in most of the typical use cases for environment variables in GLib-using programs you want the UTF-8 encoding that this function and g_getenv() provide. - a %NULL-terminated list of strings which must be freed with @@ -44572,7 +42802,6 @@ The input string shall not contain nul characters even if the @len argument is positive. A nul character found inside the string will result in error %G_CONVERT_ERROR_ILLEGAL_SEQUENCE. Use g_convert() to convert input that may contain embedded nul characters. - A newly-allocated buffer containing the converted string, @@ -44621,7 +42850,6 @@ If the source encoding is UTF-8, an embedded nul character is treated with the %G_CONVERT_ERROR_ILLEGAL_SEQUENCE error for backward compatibility with earlier versions of this library. Use g_convert() to produce output that may contain embedded nul characters. - The converted string, or %NULL on an error. @@ -44673,7 +42901,6 @@ manually. If [structured logging is enabled][using-structured-logging] this will output via the structured log writer function (see g_log_set_writer_func()). - @@ -44720,11 +42947,11 @@ environment variables: stderr is used for levels %G_LOG_LEVEL_ERROR, %G_LOG_LEVEL_CRITICAL, %G_LOG_LEVEL_WARNING and %G_LOG_LEVEL_MESSAGE. stdout is used for -the rest. +the rest, unless stderr was requested by +g_log_writer_default_set_use_stderr(). This has no effect if structured logging is enabled; see [Using Structured Logging][using-structured-logging]. - @@ -44753,7 +42980,6 @@ default "" application domain This has no effect if structured logging is enabled; see [Using Structured Logging][using-structured-logging]. - @@ -44786,7 +43012,6 @@ Structured log messages (using g_log_structured() and g_log_structured_array()) are fatal only if the default log writer is used; otherwise it is up to the writer function to determine which log messages are fatal. See [Using Structured Logging][using-structured-logging]. - the old fatal mask @@ -44807,7 +43032,6 @@ g_log_default_handler() as default log handler. This has no effect if structured logging is enabled; see [Using Structured Logging][using-structured-logging]. - the previous default log handler @@ -44837,7 +43061,6 @@ This function is mostly intended to be used with %G_LOG_LEVEL_CRITICAL. You should typically not set %G_LOG_LEVEL_WARNING, %G_LOG_LEVEL_MESSAGE, %G_LOG_LEVEL_INFO or %G_LOG_LEVEL_DEBUG as fatal except inside of test programs. - the old fatal mask for the log domain @@ -44884,7 +43107,6 @@ This example adds a log handler for all messages from GLib: g_log_set_handler ("GLib", G_LOG_LEVEL_MASK | G_LOG_FLAG_FATAL | G_LOG_FLAG_RECURSION, my_log_handler, NULL); ]| - the id of the new handler @@ -44917,7 +43139,6 @@ g_log_set_handler ("GLib", G_LOG_LEVEL_MASK | G_LOG_FLAG_FATAL This has no effect if structured logging is enabled; see [Using Structured Logging][using-structured-logging]. - the id of the new handler @@ -44959,7 +43180,6 @@ install a writer function, as there must be a single, central point where log messages are formatted and outputted. There can only be one writer function. It is an error to set more than one. - @@ -45058,7 +43278,6 @@ field for which printf()-style formatting is supported. The default writer function for `stdout` and `stderr` will automatically append a new-line character after the message, so you should not add one manually to the format string. - @@ -45090,7 +43309,6 @@ See g_log_structured() for more documentation. This assumes that @log_level is already present in @fields (typically as the `PRIORITY` field). - @@ -45114,7 +43332,6 @@ This assumes that @log_level is already present in @fields (typically as the - @@ -45157,7 +43374,6 @@ to the log writer as such. The size of the array should not be higher than g_variant_print() will be used to convert the value into a string. For more details on its usage and about the parameters, see g_log_structured(). - @@ -45193,8 +43409,11 @@ if no other is set using g_log_set_writer_func(). As with g_log_default_handler(), this function drops debug and informational messages unless their log domain (or `all`) is listed in the space-separated -`G_MESSAGES_DEBUG` environment variable. - +`G_MESSAGES_DEBUG` environment variable. + +g_log_writer_default() uses the mask set by g_log_set_always_fatal() to +determine which messages are fatal. When using a custom writer func instead it is +up to the writer function to determine which log messages are fatal. %G_LOG_WRITER_HANDLED on success, %G_LOG_WRITER_UNHANDLED otherwise @@ -45232,7 +43451,6 @@ unknown fields. The returned string does **not** have a trailing new-line character. It is encoded in the character set of the current locale, which is not necessarily UTF-8. - string containing the formatted log message, in the character set of the current locale @@ -45272,7 +43490,6 @@ the following construct without needing any additional error handling: |[<!-- language="C" --> is_journald = g_log_writer_is_journald (fileno (stderr)); ]| - %TRUE if @output_fd points to the journal, %FALSE otherwise @@ -45294,7 +43511,6 @@ This is suitable for use as a #GLogWriterFunc. If GLib has been compiled without systemd support, this function is still defined, but will always return %G_LOG_WRITER_UNHANDLED. - %G_LOG_WRITER_HANDLED on success, %G_LOG_WRITER_UNHANDLED otherwise @@ -45325,7 +43541,9 @@ defined, but will always return %G_LOG_WRITER_UNHANDLED. Format a structured log message and print it to either `stdout` or `stderr`, depending on its log level. %G_LOG_LEVEL_INFO and %G_LOG_LEVEL_DEBUG messages -are sent to `stdout`; all other log levels are sent to `stderr`. Only fields +are sent to `stdout`, or to `stderr` if requested by +g_log_writer_default_set_use_stderr(); +all other log levels are sent to `stderr`. Only fields which are understood by this function are included in the formatted string which is printed. @@ -45335,7 +43553,6 @@ in the output. A trailing new-line character is added to the log message when it is printed. This is suitable for use as a #GLogWriterFunc. - %G_LOG_WRITER_HANDLED on success, %G_LOG_WRITER_UNHANDLED otherwise @@ -45367,7 +43584,6 @@ This is suitable for use as a #GLogWriterFunc. Check whether the given @output_fd file descriptor supports ANSI color escape sequences. If so, they can safely be used when formatting log messages. - %TRUE if ANSI color escapes are supported, %FALSE otherwise @@ -45392,7 +43608,6 @@ manually. If [structured logging is enabled][using-structured-logging] this will output via the structured log writer function (see g_log_set_writer_func()). - @@ -45417,21 +43632,18 @@ application domain - - - @@ -45559,7 +43771,6 @@ invoked, which may be undesirable. used for main loop functions when a main loop is not explicitly specified, and corresponds to the "main" main loop. See also g_main_context_get_thread_default(). - the global default main context. @@ -45577,8 +43788,7 @@ always return %NULL if you are running in the default thread.) If you need to hold a reference on the context, use g_main_context_ref_thread_default() instead. - - + the thread-default #GMainContext, or %NULL if the thread-default context is the global default context. @@ -45591,7 +43801,6 @@ it with g_main_context_ref(). In addition, unlike g_main_context_get_thread_default(), if the thread-default context is the global default context, this will return that #GMainContext (with a ref added to it) rather than returning %NULL. - the thread-default #GMainContext. Unref with g_main_context_unref() when you are done with it. @@ -45600,8 +43809,7 @@ is the global default context, this will return that #GMainContext Returns the currently firing source for this thread. - - + The currently firing source or %NULL. @@ -45708,7 +43916,6 @@ following techniques: arbitrary callbacks. Instead, structure your code so that you simply return to the main loop and then get called again when there is more work to do. - The main loop recursion level in the current thread @@ -45717,7 +43924,6 @@ following techniques: Allocates @n_bytes bytes of memory. If @n_bytes is 0 it returns %NULL. - a pointer to the allocated memory @@ -45732,7 +43938,6 @@ If @n_bytes is 0 it returns %NULL. Allocates @n_bytes bytes of memory, initialized to 0's. If @n_bytes is 0 it returns %NULL. - a pointer to the allocated memory @@ -45747,7 +43952,6 @@ If @n_bytes is 0 it returns %NULL. This function is similar to g_malloc0(), allocating (@n_blocks * @n_block_bytes) bytes, but care is taken to detect possible overflow during multiplication. - a pointer to the allocated memory @@ -45766,7 +43970,6 @@ but care is taken to detect possible overflow during multiplication. This function is similar to g_malloc(), allocating (@n_blocks * @n_block_bytes) bytes, but care is taken to detect possible overflow during multiplication. - a pointer to the allocated memory @@ -45858,7 +44061,6 @@ attributes (of type %G_MARKUP_ERROR_INVALID_CONTENT) as well as parse errors for boolean-valued attributes (again of type %G_MARKUP_ERROR_INVALID_CONTENT). In all of these cases %FALSE will be returned and @error will be set as appropriate. - %TRUE if successful @@ -45916,7 +44118,6 @@ the range of &#x1; ... &#x1f; for all control sequences except for tabstop, newline and carriage return. The character references in this range are not valid XML 1.0, but they are valid XML 1.1 and will be accepted by the GMarkup parser. - a newly allocated string with the escaped text @@ -45951,7 +44152,6 @@ output = g_markup_printf_escaped ("<purchase>" "</purchase>", store, item); ]| - newly allocated result from formatting operation. Free with g_free(). @@ -45972,7 +44172,6 @@ output = g_markup_printf_escaped ("<purchase>" Formats the data in @args according to @format, escaping all string and character arguments in the fashion of g_markup_escape_text(). See g_markup_printf_escaped(). - newly allocated result from formatting operation. Free with g_free(). @@ -45997,7 +44196,6 @@ This function is useful for avoiding an extra copy of allocated memory returned by a non-GLib-based API. GLib always uses the system malloc, so this function always returns %TRUE. - if %TRUE, malloc() and g_malloc() can be mixed. @@ -46008,7 +44206,6 @@ returns %TRUE. no longer works. There are many other useful tools for memory profiling these days which can be used instead. Use other memory profiling tools instead - @@ -46020,7 +44217,6 @@ in GLib and GIO, because those use the GLib allocators before main is reached. Therefore this function is now deprecated and is just a stub. This function now does nothing. Use other memory profiling tools instead - @@ -46031,10 +44227,12 @@ profiling tools instead - + Allocates @byte_size bytes of memory, and copies @byte_size bytes into it from @mem. If @mem is %NULL it returns %NULL. - + Use g_memdup2() instead, as it accepts a #gsize argument + for @byte_size, avoiding the possibility of overflow in a #gsize → #guint + conversion a pointer to the newly-allocated copy of the memory, or %NULL if @mem is %NULL. @@ -46055,7 +44253,6 @@ from @mem. If @mem is %NULL it returns %NULL. Copies a block of memory @len bytes long, from @src to @dest. The source and destination areas may overlap. Just use memmove(). - the destination address to copy the bytes to. @@ -46263,7 +44460,8 @@ are listed in the `G_MESSAGES_DEBUG` environment variable (or it is set to It is recommended that custom log writer functions re-use the `G_MESSAGES_DEBUG` environment variable, rather than inventing a custom one, so that developers can re-use the same debugging techniques and tools across -projects. +projects. Since GLib 2.68, this can be implemented by dropping messages +for which g_log_writer_default_would_drop() returns %TRUE. ## Testing for Messages ## {#testing-for-messages} @@ -46306,7 +44504,6 @@ than the one under test). Create a directory if it doesn't already exist. Create intermediate parent directories as needed, too. - 0 if the directory already exists, or was successfully created. Returns -1 if an error occurred, with errno set. @@ -46339,7 +44536,6 @@ on Windows it should be in UTF-8. If you are going to be creating a temporary directory inside the directory returned by g_get_tmp_dir(), you might want to use g_dir_make_tmp() instead. - A pointer to @tmpl, which has been modified to hold the directory name. In case of errors, %NULL is @@ -46369,7 +44565,6 @@ should be in UTF-8. If you are going to be creating a temporary directory inside the directory returned by g_get_tmp_dir(), you might want to use g_dir_make_tmp() instead. - A pointer to @tmpl, which has been modified to hold the directory name. In case of errors, %NULL is @@ -46398,7 +44593,6 @@ sequence does not have to occur at the very end of the template. The X string will be modified to form the name of a file that didn't exist. The string should be in the GLib file name encoding. Most importantly, on Windows it should be in UTF-8. - A file handle (as from open()) to the file opened for reading and writing. The file is opened in binary @@ -46426,7 +44620,6 @@ template and you can pass a @mode and additional @flags. The X string will be modified to form the name of a file that didn't exist. The string should be in the GLib file name encoding. Most importantly, on Windows it should be in UTF-8. - A file handle (as from open()) to the file opened for reading and writing. The file handle should be @@ -46459,7 +44652,6 @@ Care is taken to avoid overflow when calculating the size of the allocated block Since the returned pointer is already casted to the right type, it is normally unnecessary to cast it explicitly, and doing so might hide memory allocation errors. - the type of the elements to allocate @@ -46478,7 +44670,6 @@ Care is taken to avoid overflow when calculating the size of the allocated block Since the returned pointer is already casted to the right type, it is normally unnecessary to cast it explicitly, and doing so might hide memory allocation errors. - the type of the elements to allocate. @@ -46490,7 +44681,6 @@ so might hide memory allocation errors. Wraps g_alloca() in a more typesafe manner. - Type of memory chunks to be allocated @@ -46502,7 +44692,6 @@ so might hide memory allocation errors. Inserts a #GNode as the last child of the given parent. - the #GNode to place the new #GNode under @@ -46514,7 +44703,6 @@ so might hide memory allocation errors. Inserts a new #GNode as the last child of the given parent. - the #GNode to place the new #GNode under @@ -46526,7 +44714,6 @@ so might hide memory allocation errors. Gets the first child of a #GNode. - a #GNode @@ -46535,7 +44722,6 @@ so might hide memory allocation errors. Inserts a new #GNode at the given position. - the #GNode to place the new #GNode under @@ -46551,7 +44737,6 @@ so might hide memory allocation errors. Inserts a new #GNode after the given sibling. - the #GNode to place the new #GNode under @@ -46566,7 +44751,6 @@ so might hide memory allocation errors. Inserts a new #GNode before the given sibling. - the #GNode to place the new #GNode under @@ -46581,7 +44765,6 @@ so might hide memory allocation errors. Gets the next sibling of a #GNode. - a #GNode @@ -46590,7 +44773,6 @@ so might hide memory allocation errors. Inserts a new #GNode as the first child of the given parent. - the #GNode to place the new #GNode under @@ -46602,7 +44784,6 @@ so might hide memory allocation errors. Gets the previous sibling of a #GNode. - a #GNode @@ -46611,7 +44792,6 @@ so might hide memory allocation errors. Converts a 32-bit integer value from network to host byte order. - a 32-bit integer value in network byte order @@ -46620,7 +44800,6 @@ so might hide memory allocation errors. Converts a 16-bit integer value from network to host byte order. - a 16-bit integer value in network byte order @@ -46629,7 +44808,6 @@ so might hide memory allocation errors. Set the pointer at the specified location to %NULL. - @@ -46704,7 +44882,6 @@ This function may cause different actions on non-UNIX platforms. On Windows consider using the `G_DEBUGGER` environment variable (see [Running GLib Applications](glib-running.html)) and calling g_on_error_stack_trace() instead. - @@ -46732,7 +44909,6 @@ g_on_error_query(). If called directly, it will raise an exception, which will crash the program. If the `G_DEBUGGER` environment variable is set, a debugger will be invoked to attach and handle that exception (see [Running GLib Applications](glib-running.html)). - @@ -46769,7 +44945,6 @@ Calling g_once() recursively on the same #GOnce struct in return my_once.retval; } ]| - a #GOnce structure @@ -46806,8 +44981,10 @@ like this: } // use initialization_value here -]| - +]| + +While @location has a `volatile` qualifier, this is a historical artifact and +the pointer passed to it should not be `volatile`. %TRUE if the initialization section should be entered, %FALSE and blocks otherwise @@ -46826,8 +45003,10 @@ like this: 0-initialized initialization variable, and an initialization value other than 0. Sets the variable to the initialization value, and releases concurrent threads blocking in g_once_init_enter() on this -initialization variable. - +initialization variable. + +While @location has a `volatile` qualifier, this is a historical artifact and +the pointer passed to it should not be `volatile`. @@ -47016,7 +45195,6 @@ corresponding to "foo" and "bar". If @string is equal to "help", all the available keys in @keys are printed out to standard error. - the combined set of bit flags. @@ -47047,7 +45225,6 @@ If @file_name ends with a directory separator it gets the component before the last slash. If @file_name consists only of directory separators (and on Windows, possibly a drive letter), a single separator is returned. If @file_name is empty, it gets ".". - a newly allocated string containing the last component of the filename @@ -47067,7 +45244,6 @@ is `/`. If the file name has no directory components "." is returned. The returned string should be freed when no longer needed. - the directory components of the file @@ -47104,7 +45280,6 @@ function, but they obviously are not relative to the normal current directory as returned by getcwd() or g_get_current_dir() either. Such paths should be avoided, or need to be handled using Windows-specific code. - %TRUE if @file_name is absolute @@ -47120,7 +45295,6 @@ Windows-specific code. Returns a pointer into @file_name after the root component, i.e. after the "/" in UNIX or "C:\" under Windows. If @file_name is not an absolute path it returns %NULL. - a pointer into @file_name after the root component @@ -47151,7 +45325,6 @@ Note also that the reverse of a UTF-8 encoded string can in general not be obtained by g_strreverse(). This works only if the string does not contain any multibyte characters. GLib offers the g_utf8_strreverse() function to reverse UTF-8 encoded strings. - %TRUE if @string matches @pspec @@ -47181,7 +45354,6 @@ g_utf8_strreverse() function to reverse UTF-8 encoded strings. function is to be called in a loop, it's more efficient to compile the pattern once with g_pattern_spec_new() and call g_pattern_match_string() repeatedly. - %TRUE if @string matches @pspec @@ -47201,7 +45373,6 @@ g_pattern_match_string() repeatedly. Matches a string against a compiled pattern. If the string is to be matched against more than one pattern, consider using g_pattern_match() instead while supplying the reversed string. - %TRUE if @string matches @pspec @@ -47239,7 +45410,6 @@ pointer-sized values). For portability reasons, you may only lock on the bottom 32 bits of the pointer. - @@ -47260,7 +45430,6 @@ other pointer-sized values). For portability reasons, you may only lock on the bottom 32 bits of the pointer. - %TRUE if the lock was acquired @@ -47282,7 +45451,6 @@ pointer-sized values). For portability reasons, you may only lock on the bottom 32 bits of the pointer. - @@ -47315,7 +45483,6 @@ file descriptor, but the situation is much more complicated on Windows. If you need to use g_poll() in code that has to run on Windows, the easiest solution is to construct all of your #GPollFDs with g_io_channel_win32_make_pollfd(). - the number of entries in @fds whose @revents fields were filled in, or 0 if the operation timed out, or -1 on error or @@ -47344,7 +45511,6 @@ nothing. If *@err is %NULL (ie: an error variable is present but there is no error condition) then also do nothing. - @@ -47374,7 +45540,6 @@ messages, since it may be redirected by applications to special purpose message windows or even files. Instead, libraries should use g_log(), g_log_structured(), or the convenience macros g_message(), g_warning() and g_error(). - @@ -47398,7 +45563,6 @@ new-line character. g_printerr() should not be used from within libraries. Instead g_log() or g_log_structured() should be used, or the convenience macros g_message(), g_warning() and g_error(). - @@ -47422,7 +45586,6 @@ new-line character to the message, so typically @format should end with its own new-line character. `glib/gprintf.h` must be explicitly included in order to use this function. - the number of bytes printed. @@ -47442,7 +45605,6 @@ own new-line character. Calculates the maximum space needed to store the output of the sprintf() function. - the maximum space needed to store the formatted string @@ -47467,7 +45629,6 @@ The error variable @dest points to must be %NULL. Note that @src is no longer valid after this call. If you want to keep using the same GError*, you need to set it to %NULL after calling this function on it. - @@ -47486,7 +45647,6 @@ after calling this function on it. If @dest is %NULL, free @src; otherwise, moves @src into *@dest. *@dest must be %NULL. After the move, add a prefix as with g_prefix_error(). - @@ -47517,7 +45677,6 @@ multiple times in @haystack, the index of the first instance is returned. This does pointer comparisons only. If you want to use more complex equality checks, such as string comparisons, use g_ptr_array_find_with_equal_func(). - %TRUE if @needle is one of the elements of @haystack @@ -47550,7 +45709,6 @@ the first instance is returned. @equal_func is called with the element from the array as its first parameter, and @needle as its second parameter. If @equal_func is %NULL, pointer equality is used. - %TRUE if @needle is one of the elements of @haystack @@ -47584,7 +45742,6 @@ equality is used. This does not perform bounds checking on the given @index_, so you are responsible for checking it against the array length. - a #GPtrArray @@ -47599,7 +45756,6 @@ so you are responsible for checking it against the array length. the comparison routine accepts a user data argument. This is guaranteed to be a stable sort since version 2.32. - @@ -47643,7 +45799,6 @@ function in GTK+ theme engines). This function must not be used before library constructors have finished running. In particular, this means it cannot be used to initialize global variables in C++. - the #GQuark identifying the string, or 0 if @string is %NULL @@ -47663,7 +45818,6 @@ using a copy of the string. This function must not be used before library constructors have finished running. In particular, this means it cannot be used to initialize global variables in C++. - the #GQuark identifying the string, or 0 if @string is %NULL @@ -47677,7 +45831,6 @@ variables in C++. Gets the string associated with the given #GQuark. - the string associated with the #GQuark @@ -47698,7 +45851,6 @@ use g_quark_from_string() or g_quark_from_static_string(). This function must not be used before library constructors have finished running. - the #GQuark associated with the string, or 0 if @string is %NULL or there is no #GQuark associated with it @@ -47763,7 +45915,6 @@ To free the entire queue, use g_queue_free(). Returns a random #gboolean from @rand_. This corresponds to an unbiased coin toss. - a #GRand @@ -47772,7 +45923,6 @@ This corresponds to an unbiased coin toss. Returns a random #gdouble equally distributed over the range [0..1). - a random number @@ -47781,7 +45931,6 @@ This corresponds to an unbiased coin toss. Returns a random #gdouble equally distributed over the range [@begin..@end). - a random number @@ -47800,7 +45949,6 @@ This corresponds to an unbiased coin toss. Return a random #guint32 equally distributed over the range [0..2^32-1]. - a random number @@ -47809,7 +45957,6 @@ This corresponds to an unbiased coin toss. Returns a random #gint32 equally distributed over the range [@begin..@end-1]. - a random number @@ -47874,7 +46021,6 @@ generated with Glib-2.0 that you need to reproduce exactly. Sets the seed for the global random number generator, which is used by the g_random_* functions, to @seed. - @@ -47887,7 +46033,6 @@ by the g_random_* functions, to @seed. Acquires a reference on the data pointed by @mem_block. - a pointer to the data, with its reference count increased @@ -47909,7 +46054,6 @@ zero. The allocated data is guaranteed to be suitably aligned for any built-in type. - a pointer to the allocated memory @@ -47932,7 +46076,6 @@ zero. The allocated data is guaranteed to be suitably aligned for any built-in type. - a pointer to the allocated memory @@ -47948,7 +46091,6 @@ built-in type. Allocates a new block of data with reference counting semantics, and copies @block_size bytes of @mem_block into it. - a pointer to the allocated memory @@ -47967,7 +46109,6 @@ into it. Retrieves the size of the reference counted data pointed by @mem_block. - the size of the data, in bytes @@ -47986,7 +46127,6 @@ the size of the given @type. This macro calls g_rc_box_alloc() with `sizeof (@type)` and casts the returned pointer to a pointer of the given @type, avoiding a type cast in the source code. - the type to allocate, typically a structure name @@ -48000,7 +46140,6 @@ the size of the given @type, and set its contents to zero. This macro calls g_rc_box_alloc0() with `sizeof (@type)` and casts the returned pointer to a pointer of the given @type, avoiding a type cast in the source code. - the type to allocate, typically a structure name @@ -48012,7 +46151,6 @@ avoiding a type cast in the source code. If the reference was the last one, it will free the resources allocated for @mem_block. - @@ -48029,7 +46167,6 @@ resources allocated for @mem_block. If the reference was the last one, it will call @clear_func to clear the contents of @mem_block, and then will free the resources allocated for @mem_block. - @@ -48173,7 +46310,6 @@ G_DEFINE_AUTOPTR_CLEANUP_FUNC (MyDataStruct, my_data_struct_release) have been moved. @mem may be %NULL, in which case it's considered to have zero-length. @n_bytes may be 0, in which case %NULL will be returned and @mem will be freed unless it is %NULL. - the new address of the allocated memory @@ -48192,7 +46328,6 @@ and @mem will be freed unless it is %NULL. This function is similar to g_realloc(), allocating (@n_blocks * @n_block_bytes) bytes, but care is taken to detect possible overflow during multiplication. - the new address of the allocated memory @@ -48214,7 +46349,6 @@ but care is taken to detect possible overflow during multiplication. Compares the current value of @rc with @val. - %TRUE if the reference count is the same as the given value @@ -48233,7 +46367,6 @@ but care is taken to detect possible overflow during multiplication. Decreases the reference count. - %TRUE if the reference count reached 0, and %FALSE otherwise @@ -48247,7 +46380,6 @@ but care is taken to detect possible overflow during multiplication. Increases the reference count. - @@ -48260,7 +46392,6 @@ but care is taken to detect possible overflow during multiplication. Initializes a reference count variable. - @@ -48273,7 +46404,6 @@ but care is taken to detect possible overflow during multiplication. Acquires a reference on a string. - the given string, with its reference count increased @@ -48287,7 +46417,6 @@ but care is taken to detect possible overflow during multiplication. Retrieves the length of @str. - the length of the given string, in bytes @@ -48302,7 +46431,6 @@ but care is taken to detect possible overflow during multiplication. Creates a new reference counted string and copies the contents of @str into it. - the newly created reference counted string @@ -48321,7 +46449,6 @@ into it. If you call this function multiple times with the same @str, or with the same contents of @str, it will return a new reference, instead of creating a new string. - the newly created reference counted string, or a new reference to an existing string @@ -48340,7 +46467,6 @@ into it, up to @len bytes. Since this function does not stop at nul bytes, it is the caller's responsibility to ensure that @str has at least @len addressable bytes. - the newly created reference counted string @@ -48359,7 +46485,6 @@ responsibility to ensure that @str has at least @len addressable bytes. Releases a reference on a string; if it was the last reference, the resources allocated by the string are freed as well. - @@ -48457,7 +46582,6 @@ for pattern references. For instance, replacement text 'foo\n' does not contain references and may be evaluated without information about actual match, but '\0\1' (whole match followed by first subpattern) requires valid #GMatchInfo object. - whether @replacement is a valid replacement string @@ -48485,7 +46609,6 @@ to compile a regex with embedded nul characters. For completeness, @length can be -1 for a nul-terminated string. In this case the output string will be of course equal to @string. - a newly-allocated escaped string @@ -48509,7 +46632,6 @@ function is useful to dynamically generate regular expressions. @string can contain nul characters that are replaced with "\0", in this case remember to specify the correct length of @string in @length. - a newly-allocated escaped string @@ -48538,7 +46660,6 @@ substrings, capture counts, and so on. If this function is to be called on the same @pattern more than once, it's more efficient to compile the pattern once with g_regex_new() and then use g_regex_match(). - %TRUE if the string matched, %FALSE otherwise @@ -48590,7 +46711,6 @@ A pattern that can match empty strings splits @string into separate characters wherever it matches the empty string between characters. For example splitting "ab c" using as a separator "\s*", you will get "a", "b" and "c". - a %NULL-terminated array of strings. Free it using g_strfreev() @@ -48626,7 +46746,6 @@ Due to thread safety issues this may cause leaking of strings that were previously returned from g_get_user_special_dir() that can't be freed. We ensure to only leak the data for the directories that actually changed value though. - @@ -48636,7 +46755,6 @@ the directories that actually changed value though. @n_structs elements of type @struct_type. It returns the new address of the memory, which may have been moved. Care is taken to avoid overflow when calculating the size of the allocated block. - the type of the elements to allocate @@ -48650,7 +46768,6 @@ Care is taken to avoid overflow when calculating the size of the allocated block - @@ -48659,7 +46776,6 @@ Care is taken to avoid overflow when calculating the size of the allocated block Internal function used to print messages from the public g_return_if_fail() and g_return_val_if_fail() macros. - @@ -48679,7 +46795,6 @@ and g_return_val_if_fail() macros. - @@ -48688,7 +46803,6 @@ and g_return_val_if_fail() macros. - @@ -48700,7 +46814,6 @@ deletes a directory from the filesystem. See your C library manual for more details about how rmdir() works on your system. - 0 if the directory was successfully removed, -1 if an error occurred @@ -48721,7 +46834,6 @@ general purpose lexical scanner. Adds a symbol to the default scope. Use g_scanner_scope_add_symbol() instead. - a #GScanner @@ -48737,7 +46849,6 @@ general purpose lexical scanner. Calls a function for each symbol in the default scope. Use g_scanner_scope_foreach_symbol() instead. - a #GScanner @@ -48753,7 +46864,6 @@ general purpose lexical scanner. There is no reason to use this macro, since it does nothing. This macro does nothing. - a #GScanner @@ -48763,7 +46873,6 @@ general purpose lexical scanner. Removes a symbol from the default scope. Use g_scanner_scope_remove_symbol() instead. - a #GScanner @@ -48776,7 +46885,6 @@ general purpose lexical scanner. There is no reason to use this macro, since it does nothing. This macro does nothing. - a #GScanner @@ -48829,7 +46937,6 @@ insertions. Returns the data that @iter points to. - the data that @iter points to @@ -48843,7 +46950,6 @@ insertions. Inserts a new item just before the item pointed to by @iter. - an iterator pointing to the new item @@ -48864,7 +46970,6 @@ insertions. After calling this function @dest will point to the position immediately after @src. It is allowed for @src and @dest to point into different sequences. - @@ -48889,7 +46994,6 @@ into by @begin and @end. If @dest is %NULL, the range indicated by @begin and @end is removed from the sequence. If @dest points to a place within the (@begin, @end) range, the range does not move. - @@ -48915,7 +47019,6 @@ guaranteed to be exactly in the middle. The @begin and @end iterators must both point to the same sequence and @begin must come before or be equal to @end in the sequence. - a #GSequenceIter pointing somewhere in the (@begin, @end) range @@ -48938,7 +47041,6 @@ end iterator to this function. If the sequence has a data destroy function associated with it, this function is called on the data for the removed item. - @@ -48954,7 +47056,6 @@ function is called on the data for the removed item. If the sequence has a data destroy function associated with it, this function is called on the data for the removed items. - @@ -48973,7 +47074,6 @@ function is called on the data for the removed items. Changes the data for the item pointed to by @iter to be @data. If the sequence has a data destroy function associated with it, that function is called on the existing data that @iter pointed to. - @@ -48991,7 +47091,6 @@ function is called on the existing data that @iter pointed to. Swaps the items pointed to by @a and @b. It is allowed for @a and @b to point into difference sequences. - @@ -49018,7 +47117,6 @@ be called once. The application name will be used in contexts such as error messages, or when displaying an application's name in the task list. - @@ -49032,7 +47130,6 @@ or when displaying an application's name in the task list. Does nothing if @err is %NULL; if @err is non-%NULL, then *@err must be %NULL. A new #GError is created and assigned to *@err. - @@ -49065,7 +47162,6 @@ must be %NULL. A new #GError is created and assigned to *@err. Unlike g_set_error(), @message is not a printf()-style format string. Use this function if @message contains text you don't have control over, that could include printf() escape sequences. - @@ -49099,7 +47195,6 @@ gdk_init(), which is called by gtk_init() and the taking the last component of @argv[0]. Note that for thread-safety reasons this function can only be called once. - @@ -49118,7 +47213,6 @@ the new handler. The default handler simply outputs the message to stdout. By providing your own handler you can redirect the output, to a GTK+ widget or a log file for example. - the old print handler @@ -49138,7 +47232,6 @@ the new handler. The default handler simply outputs the message to stderr. By providing your own handler you can redirect the output, to a GTK+ widget or a log file for example. - the old error message handler @@ -49170,7 +47263,6 @@ If you need to set up the environment for a child process, you can use g_get_environ() to get an environment array, modify that with g_environ_setenv() and g_environ_unsetenv(), and then pass that array directly to execvpe(), g_spawn_async(), or the like. - %FALSE if the environment variable couldn't be set. @@ -49215,7 +47307,6 @@ contains none of the unsupported shell expansions. If the input does contain such expansions, they are passed through literally. Possible errors are those from the #G_SHELL_ERROR domain. Free the returned vector with g_strfreev(). - %TRUE on success, %FALSE if error set @@ -49245,7 +47336,6 @@ the shell, for example, you should first quote it with this function. The return value must be freed with g_free(). The quoting style used is undefined (single or double quotes may be used). - quoted string @@ -49279,7 +47369,6 @@ literal string exactly. escape sequences are not allowed; not even like 'foo'\''bar'. Double quotes allow $, `, ", \, and newline to be escaped with backslash. Otherwise double quotes preserve things literally. - an unquoted string @@ -49298,7 +47387,6 @@ literally. If the operation is successful, %TRUE is returned. If the operation overflows then the state of @dest is undefined and %FALSE is returned. - a pointer to the #gsize destination @@ -49318,7 +47406,6 @@ returned. If the operation is successful, %TRUE is returned. If the operation overflows then the state of @dest is undefined and %FALSE is returned. - a pointer to the #gsize destination @@ -49341,7 +47428,6 @@ the alignment may be reduced in a libc dependent fashion. Note that the underlying slice allocation mechanism can be changed with the [`G_SLICE=always-malloc`][G_SLICE] environment variable. - a pointer to the allocated memory block, which will be %NULL if and only if @mem_size is 0 @@ -49359,7 +47445,6 @@ environment variable. the returned memory to 0. Note that the underlying slice allocation mechanism can be changed with the [`G_SLICE=always-malloc`][G_SLICE] environment variable. - a pointer to the allocated block, which will be %NULL if and only if @mem_size is 0 @@ -49377,7 +47462,6 @@ environment variable. and copies @block_size bytes into it from @mem_block. @mem_block must be non-%NULL if @block_size is non-zero. - a pointer to the allocated memory block, which will be %NULL if and only if @mem_size is 0 @@ -49406,7 +47490,6 @@ be changed with the [`G_SLICE=always-malloc`][G_SLICE] environment variable. This can never return %NULL. - the type to duplicate, typically a structure name @@ -49427,7 +47510,6 @@ Note that the exact release behaviour can be changed with the [`G_SLICE`][G_SLICE] for related debugging options. If @mem is %NULL, this macro does nothing. - the type of the block to free, typically a structure name @@ -49447,7 +47529,6 @@ can be changed with the [`G_DEBUG=gc-friendly`][G_DEBUG] environment variable, also see [`G_SLICE`][G_SLICE] for related debugging options. If @mem_block is %NULL, this function does nothing. - @@ -49473,7 +47554,6 @@ Note that the exact release behaviour can be changed with the [`G_SLICE`][G_SLICE] for related debugging options. If @mem_chain is %NULL, this function does nothing. - the type of the @mem_chain blocks @@ -49498,7 +47578,6 @@ Note that the exact release behaviour can be changed with the [`G_SLICE`][G_SLICE] for related debugging options. If @mem_chain is %NULL, this function does nothing. - @@ -49518,7 +47597,6 @@ If @mem_chain is %NULL, this function does nothing. - @@ -49529,7 +47607,6 @@ If @mem_chain is %NULL, this function does nothing. - @@ -49557,7 +47634,6 @@ environment variable. This can never return %NULL as the minimum allocation size from `sizeof (@type)` is 1 byte. - the type to allocate, typically a structure name @@ -49577,7 +47653,6 @@ environment variable. This can never return %NULL as the minimum allocation size from `sizeof (@type)` is 1 byte. - the type to allocate, typically a structure name @@ -49585,7 +47660,6 @@ This can never return %NULL as the minimum allocation size from - @@ -49602,7 +47676,6 @@ This can never return %NULL as the minimum allocation size from A convenience macro to get the next element in a #GSList. Note that it is considered perfectly acceptable to access @slist->next directly. - an element in a #GSList. @@ -49627,7 +47700,6 @@ traditional snprintf(), which returns the length of the output string. The format string may contain positional parameters, as specified in the Single Unix Specification. - the number of bytes which would be produced if the buffer was large enough. @@ -49674,7 +47746,6 @@ idle may already have run and been removed by the time this function is called on its (now invalid) source ID. This source ID may have been reissued, leading to the operation being performed against the wrong source. - For historical reasons, this function always returns %TRUE @@ -49690,7 +47761,6 @@ wrong source. Removes a source from the default main loop context given the source functions and user data. If multiple sources exist with the same source functions and user data, only one will be destroyed. - %TRUE if a source was found and removed. @@ -49710,7 +47780,6 @@ same source functions and user data, only one will be destroyed. Removes a source from the default main loop context given the user data for the callback. If multiple sources exist with the same user data, only one will be destroyed. - %TRUE if a source was found and removed. @@ -49739,7 +47808,6 @@ idle may already have run and been removed by the time this function is called on its (now invalid) source ID. This source ID may have been reissued, leading to the operation being performed against the wrong source. - @@ -49761,7 +47829,6 @@ size of a #GHashTable. The built-in array of primes ranges from 11 to 13845163 such that each prime is approximately 1.5-2 times the previous prime. - the smallest prime number from a built-in array of primes which is larger than @num @@ -49844,7 +47911,6 @@ windows on the right screen, you may want to use #GdkAppLaunchContext, Note that the returned @child_pid on Windows is a handle to the child process and not its identifier. Process handles and process identifiers are different concepts on Windows. - %TRUE on success, %FALSE if error is set @@ -49888,25 +47954,8 @@ are different concepts on Windows. - Identical to g_spawn_async_with_pipes() but instead of -creating pipes for the stdin/stdout/stderr, you can pass existing -file descriptors into this function through the @stdin_fd, -@stdout_fd and @stderr_fd parameters. The following @flags -also have their behaviour slightly tweaked as a result: - -%G_SPAWN_STDOUT_TO_DEV_NULL means that the child's standard output -will be discarded, instead of going to the same location as the parent's -standard output. If you use this flag, @standard_output must be -1. -%G_SPAWN_STDERR_TO_DEV_NULL means that the child's standard error -will be discarded, instead of going to the same location as the parent's -standard error. If you use this flag, @standard_error must be -1. -%G_SPAWN_CHILD_INHERITS_STDIN means that the child will inherit the parent's -standard input (by default, the child's standard input is attached to -/dev/null). If you use this flag, @standard_input must be -1. - -It is valid to pass the same fd in multiple parameters (e.g. you can pass -a single fd for both stdout and stderr). - + Identical to g_spawn_async_with_pipes_and_fds() but with `n_fds` set to zero, +so no FD assignments are used. %TRUE on success, %FALSE if an error was set @@ -49945,187 +47994,22 @@ a single fd for both stdout and stderr). - file descriptor to use for child's stdin, or -1 + file descriptor to use for child's stdin, or `-1` - file descriptor to use for child's stdout, or -1 + file descriptor to use for child's stdout, or `-1` - file descriptor to use for child's stderr, or -1 + file descriptor to use for child's stderr, or `-1` - Executes a child program asynchronously (your program will not -block waiting for the child to exit). The child program is -specified by the only argument that must be provided, @argv. -@argv should be a %NULL-terminated array of strings, to be passed -as the argument vector for the child. The first string in @argv -is of course the name of the program to execute. By default, the -name of the program must be a full path. If @flags contains the -%G_SPAWN_SEARCH_PATH flag, the `PATH` environment variable is -used to search for the executable. If @flags contains the -%G_SPAWN_SEARCH_PATH_FROM_ENVP flag, the `PATH` variable from -@envp is used to search for the executable. If both the -%G_SPAWN_SEARCH_PATH and %G_SPAWN_SEARCH_PATH_FROM_ENVP flags -are set, the `PATH` variable from @envp takes precedence over -the environment variable. - -If the program name is not a full path and %G_SPAWN_SEARCH_PATH flag is not -used, then the program will be run from the current directory (or -@working_directory, if specified); this might be unexpected or even -dangerous in some cases when the current directory is world-writable. - -On Windows, note that all the string or string vector arguments to -this function and the other g_spawn*() functions are in UTF-8, the -GLib file name encoding. Unicode characters that are not part of -the system codepage passed in these arguments will be correctly -available in the spawned program only if it uses wide character API -to retrieve its command line. For C programs built with Microsoft's -tools it is enough to make the program have a wmain() instead of -main(). wmain() has a wide character argument vector as parameter. - -At least currently, mingw doesn't support wmain(), so if you use -mingw to develop the spawned program, it should call -g_win32_get_command_line() to get arguments in UTF-8. - -On Windows the low-level child process creation API CreateProcess() -doesn't use argument vectors, but a command line. The C runtime -library's spawn*() family of functions (which g_spawn_async_with_pipes() -eventually calls) paste the argument vector elements together into -a command line, and the C runtime startup code does a corresponding -reconstruction of an argument vector from the command line, to be -passed to main(). Complications arise when you have argument vector -elements that contain spaces or double quotes. The `spawn*()` functions -don't do any quoting or escaping, but on the other hand the startup -code does do unquoting and unescaping in order to enable receiving -arguments with embedded spaces or double quotes. To work around this -asymmetry, g_spawn_async_with_pipes() will do quoting and escaping on -argument vector elements that need it before calling the C runtime -spawn() function. - -The returned @child_pid on Windows is a handle to the child -process, not its identifier. Process handles and process -identifiers are different concepts on Windows. - -@envp is a %NULL-terminated array of strings, where each string -has the form `KEY=VALUE`. This will become the child's environment. -If @envp is %NULL, the child inherits its parent's environment. - -@flags should be the bitwise OR of any flags you want to affect the -function's behaviour. The %G_SPAWN_DO_NOT_REAP_CHILD means that the -child will not automatically be reaped; you must use a child watch -(g_child_watch_add()) to be notified about the death of the child process, -otherwise it will stay around as a zombie process until this process exits. -Eventually you must call g_spawn_close_pid() on the @child_pid, in order to -free resources which may be associated with the child process. (On Unix, -using a child watch is equivalent to calling waitpid() or handling -the %SIGCHLD signal manually. On Windows, calling g_spawn_close_pid() -is equivalent to calling CloseHandle() on the process handle returned -in @child_pid). See g_child_watch_add(). - -Open UNIX file descriptors marked as `FD_CLOEXEC` will be automatically -closed in the child process. %G_SPAWN_LEAVE_DESCRIPTORS_OPEN means that -other open file descriptors will be inherited by the child; otherwise all -descriptors except stdin/stdout/stderr will be closed before calling exec() -in the child. %G_SPAWN_SEARCH_PATH means that @argv[0] need not be an -absolute path, it will be looked for in the `PATH` environment -variable. %G_SPAWN_SEARCH_PATH_FROM_ENVP means need not be an -absolute path, it will be looked for in the `PATH` variable from -@envp. If both %G_SPAWN_SEARCH_PATH and %G_SPAWN_SEARCH_PATH_FROM_ENVP -are used, the value from @envp takes precedence over the environment. -%G_SPAWN_STDOUT_TO_DEV_NULL means that the child's standard output -will be discarded, instead of going to the same location as the parent's -standard output. If you use this flag, @standard_output must be %NULL. -%G_SPAWN_STDERR_TO_DEV_NULL means that the child's standard error -will be discarded, instead of going to the same location as the parent's -standard error. If you use this flag, @standard_error must be %NULL. -%G_SPAWN_CHILD_INHERITS_STDIN means that the child will inherit the parent's -standard input (by default, the child's standard input is attached to -`/dev/null`). If you use this flag, @standard_input must be %NULL. -%G_SPAWN_FILE_AND_ARGV_ZERO means that the first element of @argv is -the file to execute, while the remaining elements are the actual -argument vector to pass to the file. Normally g_spawn_async_with_pipes() -uses @argv[0] as the file to execute, and passes all of @argv to the child. - -@child_setup and @user_data are a function and user data. On POSIX -platforms, the function is called in the child after GLib has -performed all the setup it plans to perform (including creating -pipes, closing file descriptors, etc.) but before calling exec(). -That is, @child_setup is called just before calling exec() in the -child. Obviously actions taken in this function will only affect -the child, not the parent. - -On Windows, there is no separate fork() and exec() functionality. -Child processes are created and run with a single API call, -CreateProcess(). There is no sensible thing @child_setup -could be used for on Windows so it is ignored and not called. - -If non-%NULL, @child_pid will on Unix be filled with the child's -process ID. You can use the process ID to send signals to the child, -or to use g_child_watch_add() (or waitpid()) if you specified the -%G_SPAWN_DO_NOT_REAP_CHILD flag. On Windows, @child_pid will be -filled with a handle to the child process only if you specified the -%G_SPAWN_DO_NOT_REAP_CHILD flag. You can then access the child -process using the Win32 API, for example wait for its termination -with the WaitFor*() functions, or examine its exit code with -GetExitCodeProcess(). You should close the handle with CloseHandle() -or g_spawn_close_pid() when you no longer need it. - -If non-%NULL, the @standard_input, @standard_output, @standard_error -locations will be filled with file descriptors for writing to the child's -standard input or reading from its standard output or standard error. -The caller of g_spawn_async_with_pipes() must close these file descriptors -when they are no longer in use. If these parameters are %NULL, the -corresponding pipe won't be created. - -If @standard_input is %NULL, the child's standard input is attached to -`/dev/null` unless %G_SPAWN_CHILD_INHERITS_STDIN is set. - -If @standard_error is NULL, the child's standard error goes to the same -location as the parent's standard error unless %G_SPAWN_STDERR_TO_DEV_NULL -is set. - -If @standard_output is NULL, the child's standard output goes to the same -location as the parent's standard output unless %G_SPAWN_STDOUT_TO_DEV_NULL -is set. - -@error can be %NULL to ignore errors, or non-%NULL to report errors. -If an error is set, the function returns %FALSE. Errors are reported -even if they occur in the child (for example if the executable in -@argv[0] is not found). Typically the `message` field of returned -errors should be displayed to users. Possible errors are those from -the #G_SPAWN_ERROR domain. - -If an error occurs, @child_pid, @standard_input, @standard_output, -and @standard_error will not be filled with valid values. - -If @child_pid is not %NULL and an error does not occur then the returned -process reference must be closed using g_spawn_close_pid(). - -On modern UNIX platforms, GLib can use an efficient process launching -codepath driven internally by posix_spawn(). This has the advantage of -avoiding the fork-time performance costs of cloning the parent process -address space, and avoiding associated memory overcommit checks that are -not relevant in the context of immediately executing a distinct process. -This optimized codepath will be used provided that the following conditions -are met: - -1. %G_SPAWN_DO_NOT_REAP_CHILD is set -2. %G_SPAWN_LEAVE_DESCRIPTORS_OPEN is set -3. %G_SPAWN_SEARCH_PATH_FROM_ENVP is not set -4. @working_directory is %NULL -5. @child_setup is %NULL -6. The program is of a recognised binary format, or has a shebang. Otherwise, GLib will have to execute the program through the shell, which is not done using the optimized codepath. - -If you are writing a GTK+ application, and the program you are spawning is a -graphical application too, then to ensure that the spawned program opens its -windows on the right screen, you may want to use #GdkAppLaunchContext, -#GAppLaunchContext, or set the %DISPLAY environment variable. - + Identical to g_spawn_async_with_pipes_and_fds() but with `n_fds` set to zero, +so no FD assignments are used. %TRUE on success, %FALSE if an error was set @@ -50218,7 +48102,6 @@ the available platform via a macro such as %G_OS_UNIX, and use WIFEXITED() and WEXITSTATUS() on @exit_status directly. Do not attempt to scan or parse the error message string; it may be translated and/or change in future versions of GLib. - %TRUE if child exited successfully, %FALSE otherwise (and @error will be set) @@ -50236,7 +48119,6 @@ change in future versions of GLib. which must be closed to prevent resource leaking. g_spawn_close_pid() is provided for this purpose. It should be used on all platforms, even though it doesn't do anything under UNIX. - @@ -50257,7 +48139,6 @@ consider using g_spawn_async() directly if appropriate. Possible errors are those from g_shell_parse_argv() and g_spawn_async(). The same concerns on Windows apply as for g_spawn_command_line_sync(). - %TRUE on success, %FALSE if error is set @@ -50292,7 +48173,6 @@ canonical Windows paths, like "c:\\program files\\app\\app.exe", as the backslashes will be eaten, and the space will act as a separator. You need to enclose such paths with single quotes, like "'c:\\program files\\app\\app.exe' 'e:\\folder\\argument.txt'". - %TRUE on success, %FALSE if an error was set @@ -50350,7 +48230,6 @@ If an error occurs, no data is returned in @standard_output, This function calls g_spawn_async_with_pipes() internally; see that function for full details on the other parameters and details on how these functions work on Windows. - %TRUE on success, %FALSE if an error was set @@ -50415,7 +48294,6 @@ risk of buffer overflow. `glib/gprintf.h` must be explicitly included in order to use this function. See also g_strdup_printf(). - the number of bytes printed. @@ -50487,7 +48365,6 @@ get_object (GObject **obj_out) 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. - a pointer to a pointer @@ -50499,7 +48376,6 @@ early error case and also in the case that %NULL was given for trailing nul, and return a pointer to the trailing nul byte. This is useful for concatenating multiple strings together without having to repeatedly scan for the end. - a pointer to trailing nul byte. @@ -50524,7 +48400,6 @@ if they are equal. It can be passed to g_hash_table_new() as the This function is typically used for hash table comparisons, but can be used for general purpose comparisons of non-%NULL strings. For a %NULL-safe string comparison function, see g_strcmp0(). - %TRUE if the two keys match @@ -50542,7 +48417,6 @@ comparison function, see g_strcmp0(). Looks whether the string @str begins with @prefix. - %TRUE if @str begins with @prefix, %FALSE otherwise. @@ -50560,7 +48434,6 @@ comparison function, see g_strcmp0(). Looks whether the string @str ends with @suffix. - %TRUE if @str end with @suffix, %FALSE otherwise. @@ -50591,7 +48464,6 @@ when using non-%NULL strings as keys in a #GHashTable. Note that this function may not be a perfect fit for all use cases. For example, it produces some hash collisions with strings as short as 2. - a hash value corresponding to the key @@ -50606,7 +48478,6 @@ as 2. Determines if a string is pure ASCII. A string is pure ASCII if it contains no bytes with the high bit set. - %TRUE if @str is ASCII @@ -50641,7 +48512,6 @@ As some examples, searching for ‘fred’ would match the potential h ‘Frédéric’ but not ‘Frederic’ (due to the one-directional nature of accent matching). Searching ‘fo’ would match ‘Foo’ and ‘Bar Foo Baz’, but not ‘SFO’ (because no word has ‘fo’ as a prefix). - %TRUE if @potential_hit is a hit @@ -50680,7 +48550,6 @@ If @from_locale is %NULL then the current locale is used. If you want to do translation for no specific locale, and you want it to be done independently of the currently locale, specify `"C"` for @from_locale. - a string in plain ASCII @@ -50712,7 +48581,6 @@ The number of ASCII alternatives that are generated and the method for doing so is unspecified, but @translit_locale (if specified) may improve the transliteration if the language of the source string is known. - the folded tokens @@ -50753,7 +48621,6 @@ In order to modify a copy, you may use `g_strdup()`: ... g_free (reformatted); ]| - @string @@ -50778,7 +48645,6 @@ In order to modify a copy, you may use `g_strdup()`: strcasecmp() function on platforms which support it. See g_strncasecmp() for a discussion of why this function is deprecated and how to replace it. - 0 if the strings match, a negative value if @s1 < @s2, or a positive value if @s1 > @s2. @@ -50805,7 +48671,6 @@ on statically allocated strings. The pointer to @string is returned to allow the nesting of functions. Also see g_strchug() and g_strstrip(). - @string @@ -50828,7 +48693,6 @@ statically allocated strings. The pointer to @string is returned to allow the nesting of functions. Also see g_strchomp() and g_strstrip(). - @string @@ -50844,7 +48708,6 @@ Also see g_strchomp() and g_strstrip(). Compares @str1 and @str2 like strcmp(). Handles %NULL gracefully by sorting it before non-%NULL strings. Comparing two %NULL pointers returns 0. - an integer less than, equal to, or greater than zero, if @str1 is <, == or > than @str2. @@ -50864,7 +48727,6 @@ Comparing two %NULL pointers returns 0. Replaces all escaped characters with their one byte equivalent. This function does the reverse conversion of g_strescape(). - a newly-allocated copy of @source with all escaped character compressed @@ -50887,7 +48749,6 @@ g_strconcat() will start appending random memory junk to your string. Note that this function is usually not the right function to use to assemble a translated message from pieces, since proper translation often requires the pieces to be reordered. - a newly-allocated string containing all the string arguments @@ -50919,7 +48780,6 @@ In order to modify a copy, you may use `g_strdup()`: ... g_free (reformatted); ]| - @string @@ -50945,7 +48805,6 @@ In order to modify a copy, you may use `g_strdup()`: This function is totally broken for the reasons discussed in the g_strncasecmp() docs - use g_ascii_strdown() or g_utf8_strdown() instead. - the string @@ -50961,7 +48820,6 @@ instead. Duplicates a string. If @str is %NULL it returns %NULL. The returned string should be freed with g_free() when no longer needed. - a newly-allocated copy of @str @@ -50982,7 +48840,6 @@ longer needed. The returned string is guaranteed to be non-NULL, unless @format contains `%lc` or `%ls` conversions, which can fail if no multibyte representation is available for the given character. - a newly-allocated string holding the result @@ -51011,7 +48868,6 @@ representation is available for the given character. See also g_vasprintf(), which offers the same functionality, but additionally returns the length of the allocated string. - a newly-allocated string holding the result @@ -51033,7 +48889,6 @@ additionally returns the length of the allocated string. the new array should be freed by first freeing each string, then the array itself. g_strfreev() does this for you. If called on a %NULL value, g_strdupv() simply returns %NULL. - a new %NULL-terminated array of strings. @@ -51066,7 +48921,6 @@ as soon as the call returns: g_strerror (saved_errno); ]| - a UTF-8 string describing the error code. If the error code is unknown, it returns a string like "unknown error (<code>)". @@ -51089,7 +48943,6 @@ replaced with a '\' followed by their octal representation. Characters supplied in @exceptions are not escaped. g_strcompress() does the reverse conversion. - a newly-allocated copy of @source with certain characters escaped. See above. @@ -51111,7 +48964,6 @@ g_strcompress() does the reverse conversion. string it contains. If @str_array is %NULL, this function simply returns. - @@ -51148,7 +49000,6 @@ not possible to free individual strings. Creates a new #GString, initialized with the given string. - the new #GString @@ -51169,7 +49020,6 @@ and can contain embedded nul bytes. Since this function does not stop at nul bytes, it is the caller's responsibility to ensure that @init has at least @len addressable bytes. - a new #GString @@ -51190,7 +49040,6 @@ bytes. bytes. This is useful if you are going to add a lot of text to the string and don't want it to be reallocated too often. - the new #GString @@ -51251,7 +49100,6 @@ and a guaranteed nul terminator. An auxiliary function for gettext() support (see Q_()). - @msgval, unless @msgval is identical to @msgid and contains a '|' character, in which case a pointer to @@ -51273,7 +49121,6 @@ and a guaranteed nul terminator. Joins a number of strings together to form one long string, with the optional @separator inserted between each of them. The returned string should be freed with g_free(). - a newly-allocated string containing all of the strings joined together, with @separator between them @@ -51299,7 +49146,6 @@ should be freed with g_free(). If @str_array has no items, the return value will be an empty string. If @str_array contains a single item, @separator will not appear in the resulting string. - a newly-allocated string containing all of the strings joined together, with @separator between them @@ -51331,7 +49177,6 @@ characters of dest to start with). Caveat: this is supposedly a more secure alternative to strcat() or strncat(), but for real security g_strconcat() is harder to mess up. - size of attempted result, which is MIN (dest_size, strlen (original dest)) + strlen (src), so if retval >= dest_size, @@ -51369,7 +49214,6 @@ returns the size of the attempted result, strlen (src), so if Caveat: strlcpy() is supposedly more secure than strcpy() or strncpy(), but if you really want to avoid screwups, g_strdup() is an even better idea. - length of @src @@ -51408,7 +49252,6 @@ the strings. which only works on ASCII and is not locale-sensitive, and g_utf8_casefold() followed by strcmp() on the resulting strings, which is good for case-insensitive sorting of UTF-8. - 0 if the strings match, a negative value if @s1 < @s2, or a positive value if @s1 > @s2. @@ -51438,7 +49281,6 @@ needed. To copy a number of characters from a UTF-8 encoded string, use g_utf8_strncpy() instead. - a newly-allocated buffer containing the first @n bytes of @str, nul-terminated @@ -51458,7 +49300,6 @@ use g_utf8_strncpy() instead. Creates a new string @length bytes long filled with @fill_char. The returned string should be freed when no longer needed. - a newly-allocated string filled the @fill_char @@ -51481,7 +49322,6 @@ The returned string should be freed when no longer needed. Note that g_strreverse() doesn't work on UTF-8 strings containing multibyte characters. For that purpose, use g_utf8_strreverse(). - the same pointer passed in as @string @@ -51496,7 +49336,6 @@ g_utf8_strreverse(). Searches the string @haystack for the last occurrence of the string @needle. - a pointer to the found occurrence, or %NULL if not found. @@ -51517,7 +49356,6 @@ of the string @needle. Searches the string @haystack for the last occurrence of the string @needle, limiting the length of the search to @haystack_len. - a pointer to the found occurrence, or %NULL if not found. @@ -51529,7 +49367,8 @@ to @haystack_len. - the maximum length of @haystack + the maximum length of @haystack in bytes. A length of -1 + can be used to mean "search the entire string", like g_strrstr(). @@ -51543,7 +49382,6 @@ to @haystack_len. You should use this function in preference to strsignal(), because it returns a string in UTF-8 encoding, and since not all platforms support the strsignal() function. - a UTF-8 string describing the signal. If the signal is unknown, it returns "unknown signal (<signum>)". @@ -51571,7 +49409,6 @@ special case is that being able to represent an empty vector is typically more useful than consistent handling of empty elements. If you do need to represent empty elements, you'll need to check for the empty string before calling g_strsplit(). - a newly-allocated %NULL-terminated array of strings. Use g_strfreev() to free it. @@ -51619,7 +49456,6 @@ before calling g_strsplit_set(). Note that this function works on bytes not characters, so it can't be used to delimit UTF-8 strings for anything but ASCII characters. - a newly-allocated %NULL-terminated array of strings. Use g_strfreev() to free it. @@ -51649,7 +49485,6 @@ to delimit UTF-8 strings for anything but ASCII characters. Searches the string @haystack for the first occurrence of the string @needle, limiting the length of the search to @haystack_len. - a pointer to the found occurrence, or %NULL if not found. @@ -51657,13 +49492,12 @@ to @haystack_len. - a string + a nul-terminated string - the maximum length of @haystack. Note that -1 is - a valid length, if @haystack is nul-terminated, meaning it will - search through the whole string. + the maximum length of @haystack in bytes. A length of -1 + can be used to mean "search the entire string", like `strstr()`. @@ -51675,7 +49509,6 @@ to @haystack_len. Removes leading and trailing whitespace from a string. See g_strchomp() and g_strchug(). - a string to remove the leading and trailing whitespace from @@ -51694,7 +49527,6 @@ you know that you must expect both locale formatted and C formatted numbers should you use this. Make sure that you don't pass strings such as comma separated lists of values, since the commas may be interpreted as a decimal point in some locales, causing unexpected results. - the #gdouble value. @@ -51716,7 +49548,6 @@ point in some locales, causing unexpected results. This function is totally broken for the reasons discussed in the g_strncasecmp() docs - use g_ascii_strup() or g_utf8_strup() instead. - the string @@ -51730,7 +49561,6 @@ point in some locales, causing unexpected results. Checks if @strv contains @str. @strv must not be %NULL. - %TRUE if @str is an element of @strv, according to g_str_equal(). @@ -51753,7 +49583,6 @@ of order, sort the arrays first (using g_qsort_with_data() or similar). Two empty arrays are considered equal. Neither @strv1 not @strv2 may be %NULL. - %TRUE if @strv1 and @strv2 are equal @@ -51770,7 +49599,6 @@ Two empty arrays are considered equal. Neither @strv1 not @strv2 may be - @@ -51778,7 +49606,6 @@ Two empty arrays are considered equal. Neither @strv1 not @strv2 may be Returns the length of the given %NULL-terminated string array @str_array. @str_array must not be %NULL. - length of @str_array. @@ -51798,7 +49625,6 @@ similar to g_test_create_case(). g_test_add() is implemented as a macro, so that the fsetup(), ftest() and fteardown() callbacks can expect a @Fixture pointer as their first argument in a type safe manner. They otherwise have type #GTestFixtureFunc. - The test path for a new test case. @@ -51834,7 +49660,6 @@ required via the `-p` command-line option or g_test_trap_subprocess(). No component of @testpath may start with a dot (`.`) if the %G_TEST_OPTION_ISOLATE_DIRS option is being used; and it is recommended to do so even if it isn’t. - @@ -51856,7 +49681,6 @@ do so even if it isn’t. Create a new test case, as with g_test_add_data_func(), but freeing @test_data after the test run is complete. - @@ -51892,7 +49716,6 @@ required via the `-p` command-line option or g_test_trap_subprocess(). No component of @testpath may start with a dot (`.`) if the %G_TEST_OPTION_ISOLATE_DIRS option is being used; and it is recommended to do so even if it isn’t. - @@ -51908,7 +49731,6 @@ do so even if it isn’t. - @@ -51934,7 +49756,6 @@ do so even if it isn’t. - @@ -51962,7 +49783,6 @@ assumed to be the empty string, so a full URI can be provided to g_test_bug() instead. See also: g_test_summary() - @@ -51988,7 +49808,6 @@ portion to @uri_pattern, or by replacing the special string If g_test_bug_base() is not called, bug URIs are formed solely from the value provided by g_test_bug(). - @@ -52022,7 +49841,6 @@ This allows for casual running of tests directly from the commandline in the srcdir == builddir case and should also support running of installed tests, assuming the data files have been installed in the same relative path as the test binary. - the path of the file, to be freed using g_free() @@ -52060,7 +49878,6 @@ fixture teardown is most useful if the same fixture type is used for multiple tests. In this cases, g_test_create_case() will be called with the same type of fixture (the @data_size argument), but varying @test_name and @data_test arguments. - a newly allocated #GTestCase. @@ -52094,7 +49911,6 @@ called with the same type of fixture (the @data_size argument), but varying Create a new test suite with the name @suite_name. - A newly allocated #GTestSuite instance. @@ -52141,7 +49957,6 @@ abort; use g_test_trap_subprocess() in this case. If messages at %G_LOG_LEVEL_DEBUG are emitted, but not explicitly expected via g_test_expect_message() then they will be ignored. - @@ -52174,7 +49989,6 @@ produce additional diagnostic messages or even continue running the test. If not called from inside a test, this function does nothing. - @@ -52190,7 +50004,6 @@ continuing after a failed assertion might be harmful. The return value of this function is only meaningful if it is called from inside a test function. - %TRUE if the test has failed @@ -52202,7 +50015,6 @@ specified by @file_type. This is approximately the same as calling g_test_build_filename("."), but you don't need to free the return value. - the path of the directory, owned by GLib @@ -52227,7 +50039,6 @@ It is safe to use this function from a thread inside of a testcase but you must ensure that all such uses occur before the main testcase function returns (ie: it is best to ensure that all threads have been joined). - the path, automatically freed at the end of the testcase @@ -52249,7 +50060,6 @@ joined). Get the toplevel test suite for the test path API. - the toplevel #GTestSuite @@ -52266,7 +50076,6 @@ produce additional diagnostic messages or even continue running the test. If not called from inside a test, this function does nothing. - @@ -52323,7 +50132,6 @@ g_test_init() will print an error and exit. This is to prevent no-op tests from being executed, as g_assert() is commonly (erroneously) used in unit tests, and is a no-op when compiled with `G_DISABLE_ASSERT`. Ensure your tests are compiled without `G_DISABLE_ASSERT` defined. - @@ -52366,7 +50174,6 @@ g_log_structured() or g_log_structured_array()). To change the fatal behaviour for specific log messages, programs must install a custom log writer function using g_log_set_writer_func().See [Using Structured Logging][using-structured-logging]. - @@ -52382,7 +50189,6 @@ writer function using g_log_set_writer_func().See - @@ -52398,7 +50204,6 @@ The test should generally strive to maximize the reported quantities (larger values are better than smaller ones), this and @maximized_quantity can determine sorting order for test result reports. - @@ -52419,7 +50224,6 @@ order for test result reports. Add a message to the test report. - @@ -52440,7 +50244,6 @@ The test should generally strive to minimize the reported quantities (smaller values are better than larger ones), this and @minimized_quantity can determine sorting order for test result reports. - @@ -52466,7 +50269,6 @@ to auto destruct allocated test resources at the end of a test run. Resources are released in reverse queue order, that means enqueueing callback A before callback B will cause B() to be called before A() during teardown. - @@ -52485,7 +50287,6 @@ A() during teardown. Enqueue a pointer to be released with g_free() during the next teardown phase. This is equivalent to calling g_test_queue_destroy() with a destroy callback of g_free(). - @@ -52500,7 +50301,6 @@ with a destroy callback of g_free(). Enqueue an object to be released with g_object_unref() during the next teardown phase. This is equivalent to calling g_test_queue_destroy() with a destroy callback of g_object_unref(). - the object to unref @@ -52510,7 +50310,6 @@ g_test_queue_destroy() with a destroy callback of g_object_unref(). Get a reproducible random floating point number, see g_test_rand_int() for details on test case random numbers. - a random number from the seeded random number generator. @@ -52519,7 +50318,6 @@ see g_test_rand_int() for details on test case random numbers. Get a reproducible random floating pointer number out of a specified range, see g_test_rand_int() for details on test case random numbers. - a number with @range_start <= number < @range_end. @@ -52545,7 +50343,6 @@ given when starting test programs. For individual test cases however, the random number generator is reseeded, to avoid dependencies between tests and to make --seed effective for all test cases. - a random number from the seeded random number generator. @@ -52554,7 +50351,6 @@ effective for all test cases. Get a reproducible random integer number out of a specified range, see g_test_rand_int() for details on test case random numbers. - a number with @begin <= number < @end. @@ -52603,7 +50399,6 @@ g_test_add(), which lets you specify setup and teardown functions. If all tests are skipped or marked as incomplete (expected failures), this function will return 0 if producing TAP output, or 77 (treated as "skip test" by Automake) otherwise. - 0 on success, 1 on failure (assuming it returns at all), 0 or 77 if all tests were skipped with g_test_skip() and/or @@ -52620,7 +50415,6 @@ information on the order that tests are run in. g_test_run_suite() or g_test_run() may only be called once in a program. - 0 on success @@ -52644,7 +50438,6 @@ Note that the g_assert_not_reached() and g_assert() macros are not affected by this. This function can only be called after g_test_init(). - @@ -52658,7 +50451,6 @@ produce additional diagnostic messages or even continue running the test. If not called from inside a test, this function does nothing. - @@ -52672,7 +50464,6 @@ If not called from inside a test, this function does nothing. Returns %TRUE (after g_test_init() has been called) if the test program is running under g_test_trap_subprocess(). - %TRUE if the test program is running under g_test_trap_subprocess(). @@ -52700,7 +50491,6 @@ test_array_sort (void) ]| See also: g_test_bug() - @@ -52714,7 +50504,6 @@ See also: g_test_bug() Get the time since the last start of the timer with g_test_timer_start(). - the time since the last start of the timer, as a double @@ -52722,7 +50511,6 @@ See also: g_test_bug() Report the last result of g_test_timer_elapsed(). - the last result of g_test_timer_elapsed(), as a double @@ -52731,7 +50519,6 @@ See also: g_test_bug() Start a timing test. Call g_test_timer_elapsed() when the task is supposed to be done. Call this function again to restart the timer. - @@ -52746,7 +50533,6 @@ g_assert() or g_error(). In these situations you should skip the entire test, including the call to g_test_trap_subprocess(), unless g_test_undefined() returns %TRUE to indicate that undefined behaviour may be tested. - a glob-style [pattern][glib-Glob-style-pattern-matching] @@ -52756,7 +50542,6 @@ behaviour may be tested. Assert that the stderr output of the last test subprocess does not match @serrpattern. See g_test_trap_subprocess(). - a glob-style [pattern][glib-Glob-style-pattern-matching] @@ -52766,7 +50551,6 @@ does not match @serrpattern. See g_test_trap_subprocess(). Assert that the stdout output of the last test subprocess matches @soutpattern. See g_test_trap_subprocess(). - a glob-style [pattern][glib-Glob-style-pattern-matching] @@ -52776,7 +50560,6 @@ does not match @serrpattern. See g_test_trap_subprocess(). Assert that the stdout output of the last test subprocess does not match @soutpattern. See g_test_trap_subprocess(). - a glob-style [pattern][glib-Glob-style-pattern-matching] @@ -52784,7 +50567,6 @@ does not match @soutpattern. See g_test_trap_subprocess(). - @@ -52841,7 +50623,6 @@ termination and validates child program outputs. This function is implemented only on Unix platforms, and is not always reliable due to problems inherent in fork-without-exec. Use g_test_trap_subprocess() instead. - %TRUE for the forked child and %FALSE for the executing parent process. @@ -52859,7 +50640,6 @@ fork-without-exec. Use g_test_trap_subprocess() instead. Check the result of the last g_test_trap_subprocess() call. - %TRUE if the last test subprocess terminated successfully. @@ -52867,7 +50647,6 @@ fork-without-exec. Use g_test_trap_subprocess() instead. Check the result of the last g_test_trap_subprocess() call. - %TRUE if the last test subprocess got killed due to a timeout. @@ -52935,7 +50714,6 @@ message. return g_test_run (); } ]| - @@ -53151,7 +50929,6 @@ You must only call g_thread_exit() from a thread that you created yourself with g_thread_new() or related APIs. You must not call this function from a thread created with another threading library or or from within a #GThreadPool. - @@ -53169,7 +50946,6 @@ being stopped. If this function returns 0, threads waiting in the thread pool for new work are not stopped. - the maximum @interval (milliseconds) to wait for new tasks in the thread pool before stopping the @@ -53179,7 +50955,6 @@ pool for new work are not stopped. Returns the maximal allowed number of unused threads. - the maximal number of unused threads @@ -53187,7 +50962,6 @@ pool for new work are not stopped. Returns the number of currently unused threads. - the number of currently unused threads @@ -53203,7 +50977,6 @@ except this is done on a per thread basis. By setting @interval to 0, idle threads will not be stopped. The default value is 15000 (15 seconds). - @@ -53221,7 +50994,6 @@ If @max_threads is -1, no limit is imposed on the number of unused threads. The default value is 2. - @@ -53236,7 +51008,6 @@ The default value is 2. Stops all currently unused threads. This does not change the maximal number of unused threads. This function can be used to regularly stop all unused threads e.g. from g_timeout_add(). - @@ -53282,7 +51053,6 @@ were not created by GLib (i.e. those created by other threading APIs). This may be useful for thread identification purposes (i.e. comparisons) but you must not use GLib functions (such as g_thread_join()) on these threads. - the #GThread representing the current thread @@ -53293,7 +51063,6 @@ as g_thread_join()) on these threads. that other threads can run. This function is often used as a method to make busy wait less evil. - @@ -53409,7 +51178,6 @@ g_date_time_unref (dt); ]| #GTimeVal is not year-2038-safe. Use g_date_time_new_from_iso8601() instead. - %TRUE if the conversion was successful. @@ -53456,7 +51224,6 @@ It is safe to call this function from any thread. The interval given is in terms of monotonic time, not wall clock time. See g_get_monotonic_time(). - the ID (greater than 0) of the event source. @@ -53502,7 +51269,6 @@ use a custom main context. The interval given is in terms of monotonic time, not wall clock time. See g_get_monotonic_time(). - the ID (greater than 0) of the event source. @@ -53554,7 +51320,6 @@ on how to handle the return value and memory management of @data. The interval given is in terms of monotonic time, not wall clock time. See g_get_monotonic_time(). - the ID (greater than 0) of the event source. @@ -53613,7 +51378,6 @@ It is safe to call this function from any thread. The interval given is in terms of monotonic time, not wall clock time. See g_get_monotonic_time(). - the ID (greater than 0) of the event source. @@ -53651,7 +51415,6 @@ executed. The interval given is in terms of monotonic time, not wall clock time. See g_get_monotonic_time(). - the newly-created timeout source @@ -53675,7 +51438,6 @@ in seconds. The interval given is in terms of monotonic time, not wall clock time. See g_get_monotonic_time(). - the newly-created timeout source @@ -53740,7 +51502,6 @@ extra pieces of memory, free() them and allocate them again later. Note that execution of this function is of O(N) complexity where N denotes the number of items on the stack. #GTrashStack is deprecated without replacement - the height of the stack @@ -53756,7 +51517,6 @@ where N denotes the number of items on the stack. Returns the element at the top of a #GTrashStack which may be %NULL. #GTrashStack is deprecated without replacement - the element at the top of the stack @@ -53771,7 +51531,6 @@ which may be %NULL. Pops a piece of memory off a #GTrashStack. #GTrashStack is deprecated without replacement - the element at the top of the stack @@ -53786,7 +51545,6 @@ which may be %NULL. Pushes a piece of memory onto a #GTrashStack. #GTrashStack is deprecated without replacement - @@ -53801,7 +51559,7 @@ which may be %NULL. - + The #GTree structure and its associated functions provide a sorted collection of key/value pairs optimized for searching and traversing in order. This means that most of the operations (access, search, @@ -53827,7 +51585,7 @@ the traversal, use g_tree_foreach(). To destroy a #GTree, use g_tree_destroy(). - + The #GNode struct and its associated functions provide a N-ary tree data structure, where nodes in the tree can contain arbitrary data. @@ -53862,7 +51620,6 @@ g_node_destroy(). Attempts to allocate @n_bytes, and returns %NULL on failure. Contrast with g_malloc(), which aborts the program on failure. - the allocated memory, or %NULL. @@ -53877,7 +51634,6 @@ Contrast with g_malloc(), which aborts the program on failure. Attempts to allocate @n_bytes, initialized to 0's, and returns %NULL on failure. Contrast with g_malloc0(), which aborts the program on failure. - the allocated memory, or %NULL @@ -53892,7 +51648,6 @@ failure. Contrast with g_malloc0(), which aborts the program on failure. This function is similar to g_try_malloc0(), allocating (@n_blocks * @n_block_bytes) bytes, but care is taken to detect possible overflow during multiplication. - the allocated memory, or %NULL @@ -53911,7 +51666,6 @@ but care is taken to detect possible overflow during multiplication. This function is similar to g_try_malloc(), allocating (@n_blocks * @n_block_bytes) bytes, but care is taken to detect possible overflow during multiplication. - the allocated memory, or %NULL. @@ -53932,7 +51686,6 @@ but care is taken to detect possible overflow during multiplication. %NULL on failure. Contrast with g_new(), which aborts the program on failure. The returned pointer is cast to a pointer to the given type. The function returns %NULL when @n_structs is 0 of if an overflow occurs. - the type of the elements to allocate @@ -53948,7 +51701,6 @@ to 0's, and returns %NULL on failure. Contrast with g_new0(), which aborts the program on failure. The returned pointer is cast to a pointer to the given type. The function returns %NULL when @n_structs is 0 or if an overflow occurs. - the type of the elements to allocate @@ -53964,7 +51716,6 @@ on failure. Contrast with g_realloc(), which aborts the program on failure. If @mem is %NULL, behaves the same as g_try_malloc(). - the allocated memory, or %NULL. @@ -53983,7 +51734,6 @@ If @mem is %NULL, behaves the same as g_try_malloc(). This function is similar to g_try_realloc(), allocating (@n_blocks * @n_block_bytes) bytes, but care is taken to detect possible overflow during multiplication. - the allocated memory, or %NULL. @@ -54009,7 +51759,6 @@ space for @n_structs elements of type @struct_type, and returns %NULL on failure. Contrast with g_renew(), which aborts the program on failure. It returns the new address of the memory, which may have been moved. The function returns %NULL if an overflow occurs. - the type of the elements to allocate @@ -54089,7 +51838,6 @@ any C99 compatible printf() implementation. Convert a string from UCS-4 to UTF-16. A 0 character will be added to the result after the converted text. - a pointer to a newly allocated UTF-16 string. This value must be freed with g_free(). If an error occurs, @@ -54123,7 +51871,6 @@ added to the result after the converted text. Convert a string from a 32-bit fixed width representation as UCS-4. to UTF-8. The result will be terminated with a 0 byte. - a pointer to a newly allocated UTF-8 string. This value must be freed with g_free(). If an error occurs, @@ -54161,7 +51908,6 @@ to UTF-8. The result will be terminated with a 0 byte. If the operation is successful, %TRUE is returned. If the operation overflows then the state of @dest is undefined and %FALSE is returned. - a pointer to the #guint64 destination @@ -54181,7 +51927,6 @@ returned. If the operation is successful, %TRUE is returned. If the operation overflows then the state of @dest is undefined and %FALSE is returned. - a pointer to the #guint64 destination @@ -54201,7 +51946,6 @@ returned. If the operation is successful, %TRUE is returned. If the operation overflows then the state of @dest is undefined and %FALSE is returned. - a pointer to the #guint destination @@ -54221,7 +51965,6 @@ returned. If the operation is successful, %TRUE is returned. If the operation overflows then the state of @dest is undefined and %FALSE is returned. - a pointer to the #guint destination @@ -54241,7 +51984,6 @@ g_utf8_get_char()). The break type is used to find word and line breaks ("text boundaries"), Pango implements the Unicode boundary resolution algorithms and normally you would use a function such as pango_break() instead of caring about break types yourself. - the break type of @c @@ -54255,7 +51997,6 @@ as pango_break() instead of caring about break types yourself. Determines the canonical combining class of a Unicode character. - the combining class of the character @@ -54284,7 +52025,6 @@ If @a and @b do not compose a new character, @ch is set to zero. See [UAX#15](http://unicode.org/reports/tr15/) for details. - %TRUE if the characters could be composed @@ -54328,7 +52068,6 @@ g_unichar_fully_decompose(). See [UAX#15](http://unicode.org/reports/tr15/) for details. - %TRUE if the character could be decomposed @@ -54351,7 +52090,6 @@ for details. Determines the numeric value of a character as a decimal digit. - If @c is a decimal digit (according to g_unichar_isdigit()), its numeric value. Otherwise, -1. @@ -54384,7 +52122,6 @@ as %G_UNICHAR_MAX_DECOMPOSITION_LENGTH. See [UAX#15](http://unicode.org/reports/tr15/) for details. - the length of the full decomposition. @@ -54418,7 +52155,6 @@ If @ch has the Unicode mirrored property and there is another unicode character that typically has a glyph that is the mirror image of @ch's glyph and @mirrored_ch is set, it puts that character in the address pointed to by @mirrored_ch. Otherwise the original character is put. - %TRUE if @ch has a mirrored character, %FALSE otherwise @@ -54442,7 +52178,6 @@ result is undefined. This function is equivalent to pango_script_for_unichar() and the two are interchangeable. - the #GUnicodeScript for the character. @@ -54458,7 +52193,6 @@ two are interchangeable. Determines whether a character is alphanumeric. Given some UTF-8 text, obtain a character value with g_utf8_get_char(). - %TRUE if @c is an alphanumeric character @@ -54474,7 +52208,6 @@ with g_utf8_get_char(). Determines whether a character is alphabetic (i.e. a letter). Given some UTF-8 text, obtain a character value with g_utf8_get_char(). - %TRUE if @c is an alphabetic character @@ -54490,7 +52223,6 @@ g_utf8_get_char(). Determines whether a character is a control character. Given some UTF-8 text, obtain a character value with g_utf8_get_char(). - %TRUE if @c is a control character @@ -54505,7 +52237,6 @@ g_utf8_get_char(). Determines if a given character is assigned in the Unicode standard. - %TRUE if the character has an assigned value @@ -54521,7 +52252,6 @@ standard. Determines whether a character is numeric (i.e. a digit). This covers ASCII 0-9 and also digits in other languages/scripts. Given some UTF-8 text, obtain a character value with g_utf8_get_char(). - %TRUE if @c is a digit @@ -54539,7 +52269,6 @@ some UTF-8 text, obtain a character value with g_utf8_get_char(). spaces). g_unichar_isprint() is similar, but returns %TRUE for spaces. Given some UTF-8 text, obtain a character value with g_utf8_get_char(). - %TRUE if @c is printable unless it's a space @@ -54555,7 +52284,6 @@ g_utf8_get_char(). Determines whether a character is a lowercase letter. Given some UTF-8 text, obtain a character value with g_utf8_get_char(). - %TRUE if @c is a lowercase letter @@ -54577,7 +52305,6 @@ Note: in most cases where isalpha characters are allowed, ismark characters should be allowed to as they are essential for writing most European languages as well as many non-Latin scripts. - %TRUE if @c is a mark character @@ -54594,7 +52321,6 @@ scripts. Unlike g_unichar_isgraph(), returns %TRUE for spaces. Given some UTF-8 text, obtain a character value with g_utf8_get_char(). - %TRUE if @c is printable @@ -54610,7 +52336,6 @@ g_utf8_get_char(). Determines whether a character is punctuation or a symbol. Given some UTF-8 text, obtain a character value with g_utf8_get_char(). - %TRUE if @c is a punctuation or symbol character @@ -54630,7 +52355,6 @@ character value with g_utf8_get_char(). (Note: don't use this to do word breaking; you have to use Pango or equivalent to get word breaking right, the algorithm is fairly complex.) - %TRUE if @c is a space character @@ -54649,7 +52373,6 @@ have three case variants instead of just two. The titlecase form is used at the beginning of a word where only the first letter is capitalized. The titlecase form of the DZ digraph is U+01F2 LATIN CAPITAL LETTTER D WITH SMALL LETTER Z. - %TRUE if the character is titlecase @@ -54663,7 +52386,6 @@ digraph is U+01F2 LATIN CAPITAL LETTTER D WITH SMALL LETTER Z. Determines if a character is uppercase. - %TRUE if @c is an uppercase character @@ -54678,7 +52400,6 @@ digraph is U+01F2 LATIN CAPITAL LETTTER D WITH SMALL LETTER Z. Determines if a character is typically rendered in a double-width cell. - %TRUE if the character is wide @@ -54701,7 +52422,6 @@ for details. If a character passes the g_unichar_iswide() test then it will also pass this test, but not the other way around. Note that some characters may pass both this test and g_unichar_iszerowidth(). - %TRUE if the character is wide in legacy East Asian locales @@ -54715,7 +52435,6 @@ pass both this test and g_unichar_iszerowidth(). Determines if a character is a hexadecimal digit. - %TRUE if the character is a hexadecimal digit @@ -54737,7 +52456,6 @@ A typical use of this function is with one of g_unichar_iswide() or g_unichar_iswide_cjk() to determine the number of cells a string occupies when displayed on a grid display (terminals). However, note that not all terminals support zero-width rendering of zero-width marks. - %TRUE if the character has zero width @@ -54751,7 +52469,6 @@ terminals support zero-width rendering of zero-width marks. Converts a single character to UTF-8. - number of bytes written @@ -54771,7 +52488,6 @@ terminals support zero-width rendering of zero-width marks. Converts a character to lower case. - the result of converting @c to lower case. If @c is not an upperlower or titlecase character, @@ -54787,7 +52503,6 @@ terminals support zero-width rendering of zero-width marks. Converts a character to the titlecase. - the result of converting @c to titlecase. If @c is not an uppercase or lowercase character, @@ -54803,7 +52518,6 @@ terminals support zero-width rendering of zero-width marks. Converts a character to uppercase. - the result of converting @c to uppercase. If @c is not a lowercase or titlecase character, @@ -54819,7 +52533,6 @@ terminals support zero-width rendering of zero-width marks. Classifies a Unicode character by type. - the type of the character. @@ -54835,7 +52548,6 @@ terminals support zero-width rendering of zero-width marks. Checks whether @ch is a valid Unicode character. Some possible integer values of @ch will not be valid. 0 is considered a valid character, though it's normally a string terminator. - %TRUE if @ch is a valid Unicode character @@ -54850,7 +52562,6 @@ character, though it's normally a string terminator. Determines the numeric value of a character as a hexadecimal digit. - If @c is a hex digit (according to g_unichar_isxdigit()), its numeric value. Otherwise, -1. @@ -54897,7 +52608,6 @@ on the Unicode Character Data tables, which are available from Computes the canonical decomposition of a Unicode character. Use the more flexible g_unichar_fully_decompose() instead. - a newly allocated string of Unicode characters. @result_len is set to the resulting length of the string. @@ -54919,7 +52629,6 @@ on the Unicode Character Data tables, which are available from This rearranges decomposed characters in the string according to their combining classes. See the Unicode manual for more information. - @@ -54944,7 +52653,6 @@ big-endian fashion. That is, the code expected for Arabic is See [Codes for the representation of names of scripts](http://unicode.org/iso15924/codelists.html) for details. - the Unicode script for @iso15924, or of %G_UNICODE_SCRIPT_INVALID_CODE if @iso15924 is zero and @@ -54968,7 +52676,6 @@ big-endian fashion. That is, the code returned for Arabic is See [Codes for the representation of names of scripts](http://unicode.org/iso15924/codelists.html) for details. - the ISO 15924 code for @script, encoded as an integer, of zero if @script is %G_UNICODE_SCRIPT_INVALID_CODE or @@ -55001,7 +52708,6 @@ The return value of this function can be passed to g_source_remove() to cancel the watch at any time that it exists. The source will never close the fd -- you must do it yourself. - the ID (greater than 0) of the event source @@ -55032,7 +52738,6 @@ The source will never close the fd -- you must do it yourself. This is the same as g_unix_fd_add(), except that it allows you to specify a non-default priority and a provide a #GDestroyNotify for @user_data. - the ID (greater than 0) of the event source @@ -55069,7 +52774,6 @@ specify a non-default priority and a provide a #GDestroyNotify for descriptor. The source will never close the fd -- you must do it yourself. - the newly created #GSource @@ -55097,7 +52801,6 @@ freed. This function is safe to call from multiple threads concurrently. You will need to include `pwd.h` to get the definition of `struct passwd`. - passwd entry, or %NULL on error; free the returned value with g_free() @@ -55119,7 +52822,6 @@ must still be done separately with fcntl(). This function does not take %O_CLOEXEC, it takes %FD_CLOEXEC as if for fcntl(); these are different on Linux/glibc. - %TRUE on success, %FALSE if not (and errno will be set). @@ -55139,7 +52841,6 @@ for fcntl(); these are different on Linux/glibc. Control the non-blocking state of the given file descriptor, according to @nonblock. On most systems this uses %O_NONBLOCK, but on some older ones may use %O_NDELAY. - %TRUE if successful @@ -55159,7 +52860,6 @@ on some older ones may use %O_NDELAY. A convenience function for g_unix_signal_source_new(), which attaches to the default #GMainContext. You can remove the watch using g_source_remove(). - An ID (greater than 0) for the event source @@ -55183,7 +52883,6 @@ using g_source_remove(). A convenience function for g_unix_signal_source_new(), which attaches to the default #GMainContext. You can remove the watch using g_source_remove(). - An ID (greater than 0) for the event source @@ -55236,7 +52935,6 @@ functions like sigprocmask() is not defined. The source will not initially be associated with any #GMainContext and must be added to one with g_source_attach() before it will be executed. - A newly created #GSource @@ -55257,7 +52955,6 @@ file is freed. See your C library manual for more details about unlink(). Note that on Windows, it is in general not possible to delete files that are open to some process, or mapped into memory. - 0 if the name was successfully deleted, -1 if an error occurred @@ -55289,7 +52986,6 @@ If you need to set up the environment for a child process, you can use g_get_environ() to get an environment array, modify that with g_environ_setenv() and g_environ_unsetenv(), and then pass that array directly to execvpe(), g_spawn_async(), or the like. - @@ -55306,7 +53002,6 @@ array directly to execvpe(), g_spawn_async(), or the like. See also g_uri_build_with_user(), which allows specifying the components of the "userinfo" separately. - a new #GUri @@ -55355,7 +53050,6 @@ coherent with the passed values, in particular use `%`-encoded values with In contrast to g_uri_build(), this allows specifying the components of the ‘userinfo’ field separately. Note that @user must be non-%NULL if either @password or @auth_params is non-%NULL. - a new #GUri @@ -55420,10 +53114,9 @@ portions of a URI. Though technically incorrect, this will also allow escaping nul bytes as `%``00`. - - an escaped version of @unescaped. The returned - string should be freed when no longer needed. + an escaped version of @unescaped. + The returned string should be freed when no longer needed. @@ -55453,10 +53146,9 @@ escaped. But if you specify characters in @reserved_chars_allowed they are not escaped. This is useful for the "reserved" characters in the URI specification, since those are allowed unescaped in some portions of a URI. - - an escaped version of @unescaped. The returned string -should be freed when no longer needed. + an escaped version of @unescaped. The +returned string should be freed when no longer needed. @@ -55484,7 +53176,6 @@ If it’s not a valid URI, an error is returned explaining how it’s See g_uri_split(), and the definition of #GUriFlags, for more information on the effect of @flags. - %TRUE if @uri_string is a valid absolute URI, %FALSE on error. @@ -55515,7 +53206,6 @@ components of the ‘userinfo’ separately. %G_URI_FLAGS_HAS_PASSWORD and %G_URI_FLAGS_HAS_AUTH_PARAMS are ignored if set in @flags. - an absolute URI string @@ -55565,7 +53255,6 @@ of the ‘userinfo’ separately. It otherwise behaves the same. %G_URI_FLAGS_HAS_PASSWORD and %G_URI_FLAGS_HAS_AUTH_PARAMS are ignored if set in @flags. - an absolute URI string @@ -55619,7 +53308,6 @@ in @flags. Splits an URI list conforming to the text/uri-list mime type defined in RFC 2483 into individual URIs, discarding any comments. The URIs are not validated. - a newly allocated %NULL-terminated list of strings holding the individual URIs. The array should be freed @@ -55639,9 +53327,8 @@ discarding any comments. The URIs are not validated. Parses @uri_string according to @flags. If the result is not a valid [absolute URI][relative-absolute-uris], it will be discarded, and an error returned. - - a new #GUri. + a new #GUri, or NULL on error. @@ -55680,11 +53367,10 @@ the returned attributes. If @params cannot be parsed (for example, it contains two @separators characters in a row), then @error is set and %NULL is returned. - - A hash table of - attribute/value pairs, with both names and values fully-decoded; or %NULL - on error. + + A hash table of attribute/value pairs, with both names and values + fully-decoded; or %NULL on error. @@ -55722,7 +53408,6 @@ as: URI = scheme ":" hier-part [ "?" query ] [ "#" fragment ] ]| Common schemes include `file`, `https`, `svn+ssh`, etc. - The ‘scheme’ component of the URI, or %NULL on error. The returned string should be freed when no longer needed. @@ -55746,7 +53431,6 @@ Common schemes include `file`, `https`, `svn+ssh`, etc. Unlike g_uri_parse_scheme(), the returned scheme is normalized to all-lowercase and does not need to be freed. - The ‘scheme’ component of the URI, or %NULL on error. The returned string is normalized to all-lowercase, and @@ -55768,9 +53452,9 @@ discarded, and an error returned. (If @base_uri_string is %NULL, this just returns @uri_ref, or %NULL if @uri_ref is invalid or not absolute.) - - the resolved URI string. + the resolved URI string, +or NULL on error. @@ -55805,7 +53489,6 @@ Note that the %G_URI_FLAGS_HAS_PASSWORD and %G_URI_FLAGS_HAS_AUTH_PARAMS @flags are ignored by g_uri_split(), since it always returns only the full userinfo; use g_uri_split_with_user() if you want it split up. - %TRUE if @uri_ref parsed successfully, %FALSE on error. @@ -55864,7 +53547,6 @@ See the documentation for g_uri_split() for more details; this is mostly a wrapper around that function with simpler arguments. However, it will return an error if @uri_string is a relative URI, or does not contain a hostname component. - %TRUE if @uri_string parsed successfully, %FALSE on error. @@ -55908,7 +53590,6 @@ information on the effect of @flags. Note that @password will only be parsed out if @flags contains %G_URI_FLAGS_HAS_PASSWORD, and @auth_params will only be parsed out if @flags contains %G_URI_FLAGS_HAS_AUTH_PARAMS. - %TRUE if @uri_ref parsed successfully, %FALSE on error. @@ -55981,11 +53662,10 @@ character in @escaped_string, then that is an error and %NULL will be returned. This is useful if you want to avoid for instance having a slash being expanded in an escaped path element, which might confuse pathname handling. - - an unescaped version of @escaped_string or %NULL on - error (if decoding failed, using %G_URI_ERROR_FAILED error code). The - returned #GBytes should be unreffed when no longer needed. + an unescaped version of @escaped_string + or %NULL on error (if decoding failed, using %G_URI_ERROR_FAILED error + code). The returned #GBytes should be unreffed when no longer needed. @@ -56016,12 +53696,11 @@ escaped path element, which might confuse pathname handling. Note: `NUL` byte is not accepted in the output, in contrast to g_uri_unescape_bytes(). - - - an unescaped version of @escaped_string or %NULL on error. -The returned string should be freed when no longer needed. As a -special case if %NULL is given for @escaped_string, this function -will return %NULL. + + an unescaped version of @escaped_string, +or %NULL on error. The returned string should be freed when no longer +needed. As a special case if %NULL is given for @escaped_string, this +function will return %NULL. @@ -56049,10 +53728,9 @@ character appears as an escaped character in @escaped_string, then that is an error and %NULL will be returned. This is useful if you want to avoid for instance having a slash being expanded in an escaped path element, which might confuse pathname handling. - - - an unescaped version of @escaped_string. The returned string -should be freed when no longer needed. + + an unescaped version of @escaped_string. +The returned string should be freed when no longer needed. @@ -56074,7 +53752,6 @@ There are 1 million microseconds per second (represented by the #G_USEC_PER_SEC macro). g_usleep() may have limited precision, depending on hardware and operating system; don't rely on the exact length of the sleep. - @@ -56088,7 +53765,6 @@ length of the sleep. Convert a string from UTF-16 to UCS-4. The result will be nul-terminated. - a pointer to a newly allocated UCS-4 string. This value must be freed with g_free(). If an error occurs, @@ -56133,8 +53809,7 @@ Further note that this function does not validate the result string; it may e.g. include embedded NUL characters. The only validation done by this function is to ensure that the input can be correctly interpreted as UTF-16, i.e. it doesn't contain -things unpaired surrogates. - +unpaired surrogates or partial character sequences. a pointer to a newly allocated UTF-8 string. This value must be freed with g_free(). If an error occurs, @@ -56178,7 +53853,6 @@ ordering, though it is a fairly good one. Getting this exactly right would require a more sophisticated collation function that takes case sensitivity into account. GLib does not currently provide such a function. - a newly allocated string, that is a case independent form of @str. @@ -56202,7 +53876,6 @@ When sorting a large number of strings, it will be significantly faster to obtain collation keys with g_utf8_collate_key() and compare the keys with strcmp() when sorting instead of sorting the original strings. - < 0 if @str1 compares before @str2, 0 if they compare equal, > 0 if @str1 compares after @str2. @@ -56229,7 +53902,6 @@ with strcmp() will always be the same as comparing the two original keys with g_utf8_collate(). Note that this function depends on the [current locale][setlocale]. - a newly allocated string. This string should be freed with g_free() when you are done with it. @@ -56258,7 +53930,6 @@ would like to treat numbers intelligently so that "file1" "file10" "file5" is sorted as "file1" "file5" "file10". Note that this function depends on the [current locale][setlocale]. - a newly allocated string. This string should be freed with g_free() when you are done with it. @@ -56286,7 +53957,6 @@ If @end is %NULL, the return value will never be %NULL: if the end of the string is reached, a pointer to the terminating nul byte is returned. If @end is non-%NULL, the return value will be %NULL if the end of the string is reached. - a pointer to the found character or %NULL if @end is set and is reached @@ -56312,7 +53982,6 @@ UTF-8 characters are present in @str before @p. @p does not have to be at the beginning of a UTF-8 character. No check is made to see if the character found is actually valid other than it starts with an appropriate byte. - a pointer to the found character or %NULL. @@ -56335,7 +54004,6 @@ If @p does not point to a valid UTF-8 encoded character, results are undefined. If you are not sure that the bytes are complete valid Unicode characters, you should use g_utf8_get_char_validated() instead. - the resulting character @@ -56356,7 +54024,6 @@ overlong encodings of valid characters. Note that g_utf8_get_char_validated() returns (gunichar)-2 if @max_len is positive and any of the bytes in the first UTF-8 character sequence are nul. - the resulting character. If @p points to a partial sequence at the end of a string that could begin a valid @@ -56386,7 +54053,6 @@ a string that was incorrectly declared to be UTF-8, and you need a valid UTF-8 version of it that can be logged or displayed to the user, with the assumption that it is close enough to ASCII or UTF-8 to be mostly readable as-is. - a valid UTF-8 string whose content resembles @str @@ -56410,7 +54076,6 @@ You would use this macro to iterate over a string character by character. The macro returns the start of the next UTF-8 character. Before using this macro, use g_utf8_validate() to validate strings that may contain invalid UTF-8. - Pointer to the start of a valid UTF-8 character @@ -56443,7 +54108,6 @@ than a maximally decomposed form. This is often useful if you intend to convert the string to a legacy encoding or pass it to a system with less capable Unicode handling. - a newly allocated string, that is the normalized form of @str, or %NULL if @str @@ -56479,7 +54143,6 @@ Therefore you should be sure that @offset is within string boundaries before calling that function. Call g_utf8_strlen() when unsure. This limitation exists as this function is called frequently during text rendering and therefore has to be as fast as possible. - the resulting pointer @@ -56501,7 +54164,6 @@ character offset. Since 2.10, this function allows @pos to be before @str, and returns a negative offset in this case. - the resulting character offset @@ -56524,7 +54186,6 @@ a negative offset in this case. is made to see if the character found is actually valid other than it starts with an appropriate byte. If @p might be the first character of the string, you must use g_utf8_find_prev_char() instead. - a pointer to the found character @@ -56540,7 +54201,6 @@ character of the string, you must use g_utf8_find_prev_char() instead. Finds the leftmost occurrence of the given Unicode character in a UTF-8 encoded string, while limiting the search to @len bytes. If @len is -1, allow unbounded search. - %NULL if the string does not contain the character, otherwise, a pointer to the start of the leftmost occurrence @@ -56567,7 +54227,6 @@ If @len is -1, allow unbounded search. to lowercase. The exact manner that this is done depends on the current locale, and may result in the number of characters in the string changing. - a newly allocated string, with all characters converted to lowercase. @@ -56588,7 +54247,6 @@ characters in the string changing. Computes the length of the string in characters, not including the terminating nul character. If the @max'th byte falls in the middle of a character, the last (partial) character is not counted. - the length of the string in characters @@ -56616,7 +54274,6 @@ text before trying to use UTF-8 utility functions with it.) Note you must ensure @dest is at least 4 * @n to fit the largest possible UTF-8 characters - @dest @@ -56640,7 +54297,6 @@ largest possible UTF-8 characters Find the rightmost occurrence of the given Unicode character in a UTF-8 encoded string, while limiting the search to @len bytes. If @len is -1, allow unbounded search. - %NULL if the string does not contain the character, otherwise, a pointer to the start of the rightmost occurrence @@ -56676,7 +54332,6 @@ for display purposes. Note that unlike g_strreverse(), this function returns newly-allocated memory, which should be freed with g_free() when no longer needed. - a newly-allocated string which is the reverse of @str @@ -56699,7 +54354,6 @@ to uppercase. The exact manner that this is done depends on the current locale, and may result in the number of characters in the string increasing. (For instance, the German ess-zet will be changed to SS.) - a newly allocated string, with all characters converted to uppercase. @@ -56719,7 +54373,6 @@ German ess-zet will be changed to SS.) Copies a substring out of a UTF-8 encoded string. The substring will contain @end_pos - @start_pos characters. - a newly allocated copy of the requested substring. Free with g_free() when no longer needed. @@ -56744,7 +54397,6 @@ The substring will contain @end_pos - @start_pos characters. Convert a string from UTF-8 to a 32-bit fixed width representation as UCS-4. A trailing 0 character will be added to the string after the converted text. - a pointer to a newly allocated UCS-4 string. This value must be freed with g_free(). If an error occurs, @@ -56784,7 +54436,6 @@ representation as UCS-4, assuming valid UTF-8 input. This function is roughly twice as fast as g_utf8_to_ucs4() but does no error checking on the input. A trailing 0 character will be added to the string after the converted text. - a pointer to a newly allocated UCS-4 string. This value must be freed with g_free(). @@ -56810,7 +54461,6 @@ will be added to the string after the converted text. Convert a string from UTF-8 to UTF-16. A 0 character will be added to the result after the converted text. - a pointer to a newly allocated UTF-16 string. This value must be freed with g_free(). If an error occurs, @@ -56858,7 +54508,6 @@ Returns %TRUE if all of @str was valid. Many GLib and GTK+ routines require valid UTF-8 as input; so data read from a file or the network should be checked with g_utf8_validate() before doing anything else with it. - %TRUE if the text was valid UTF-8 @@ -56885,7 +54534,6 @@ doing anything else with it. As with g_utf8_validate(), but @max_len must be set, and hence this function will always return %FALSE if any of the bytes of @str are nul. - %TRUE if the text was valid UTF-8 @@ -56931,7 +54579,6 @@ The function accepts the following syntax: Note that hyphens are required within the UUID string itself, as per the aforementioned RFC. - %TRUE if @str is a valid UUID, %FALSE otherwise. @@ -56947,14 +54594,12 @@ as per the aforementioned RFC. Generates a random UUID (RFC 4122 version 4) as a string. It has the same randomness guarantees as #GRand, so must not be used for cryptographic purposes such as key generation, nonces, salts or one-time pads. - A string that should be freed with g_free(). - @@ -56968,7 +54613,6 @@ A valid object path starts with `/` followed by zero or more sequences of characters separated by `/` characters. Each sequence must contain only the characters `[A-Z][a-z][0-9]_`. No sequence (including the one following the final `/` character) may be empty. - %TRUE if @string is a D-Bus object path @@ -56987,7 +54631,6 @@ passing it to g_variant_new_signature(). D-Bus type signatures consist of zero or more definite #GVariantType strings in sequence. - %TRUE if @string is a D-Bus type signature @@ -57035,7 +54678,6 @@ produced by g_variant_print()". There may be implementation specific restrictions on deeply nested values, which would result in a %G_VARIANT_PARSE_ERROR_RECURSION error. #GVariant is guaranteed to handle nesting up to at least 64 levels. - a non-floating reference to a #GVariant, or %NULL @@ -57089,7 +54731,6 @@ The format of the message may change in a future version. If @source_str was not nul-terminated when you passed it to g_variant_parse() then you must add nul termination before using this function. - the printed message @@ -57118,7 +54759,6 @@ function. - @@ -57129,7 +54769,6 @@ function. - @@ -57143,7 +54782,6 @@ function. Checks if @type_string is a valid GVariant type string. This call is equivalent to calling g_variant_type_string_scan() and confirming that the following character is a nul terminator. - %TRUE if @type_string is exactly one valid type string @@ -57171,7 +54809,6 @@ string does not end before @limit then %FALSE is returned. For the simple case of checking if a string is a valid type string, see g_variant_type_string_is_valid(). - %TRUE if a valid type string was found @@ -57203,7 +54840,6 @@ The returned value in @string is guaranteed to be non-NULL, unless multibyte representation is available for the given character. `glib/gprintf.h` must be explicitly included in order to use this function. - the number of bytes printed. @@ -57246,7 +54882,6 @@ GLib whose API you want to use. positional parameters, as specified in the Single Unix Specification. `glib/gprintf.h` must be explicitly included in order to use this function. - the number of bytes printed. @@ -57272,7 +54907,6 @@ positional parameters, as specified in the Single Unix Specification. positional parameters, as specified in the Single Unix Specification. `glib/gprintf.h` must be explicitly included in order to use this function. - the number of bytes printed. @@ -57307,7 +54941,6 @@ vsnprintf(), which returns the length of the output string. The format string may contain positional parameters, as specified in the Single Unix Specification. - the number of bytes which would be produced if the buffer was large enough. @@ -57325,7 +54958,7 @@ the Single Unix Specification. a standard printf() format string, but notice - string precision pitfalls][string-precision] + [string precision pitfalls][string-precision] @@ -57339,7 +54972,6 @@ the Single Unix Specification. positional parameters, as specified in the Single Unix Specification. `glib/gprintf.h` must be explicitly included in order to use this function. - the number of bytes printed. @@ -57362,7 +54994,6 @@ positional parameters, as specified in the Single Unix Specification. Logs a warning if the expression is not true. - the expression to check @@ -57372,7 +55003,6 @@ positional parameters, as specified in the Single Unix Specification. Internal function used to print messages from the public g_warn_if_reached() and g_warn_if_fail() macros. - diff --git a/rust-bindings/rust/gir-files/GObject-2.0.gir b/rust-bindings/rust/gir-files/GObject-2.0.gir index 6811195f..edaf7b3a 100644 --- a/rust-bindings/rust/gir-files/GObject-2.0.gir +++ b/rust-bindings/rust/gir-files/GObject-2.0.gir @@ -13,20 +13,17 @@ arrays of parameter values to signal emissions into C language callback invocations. It is merely an alias to #GClosureMarshal since the #GClosure mechanism takes over responsibility of actual function invocation for the signal system. - This is the signature of va_list marshaller functions, an optional marshaller that can be used in some situations to avoid marshalling the signal argument into GValues. - A numerical value which represents the unique identifier of a registered type. - @@ -89,7 +86,6 @@ name of the form `TypeNamePrivate`. It is safe to call the `_get_instance_private` function on %NULL or invalid objects since it's only adding an offset to the instance pointer. In that case the returned pointer must not be dereferenced. - the name of the type in CamelCase @@ -104,7 +100,6 @@ G_ADD_PRIVATE() for details, it is similar but for static types. Note that this macro can only be used together with the G_DEFINE_DYNAMIC_TYPE_EXTENDED macros, since it depends on variable names from that macro. - the name of the type in CamelCase @@ -112,7 +107,6 @@ names from that macro. - @@ -124,7 +118,6 @@ of a derived types class structure that were setup from the corresponding GBaseInitFunc() function. Class finalization basically works the inverse way in which class initialization is performed. See GClassInitFunc() for a discussion of the class initialization process. - @@ -144,7 +137,6 @@ For example, class members (such as strings) that are not sufficiently handled by a plain memory copy of the parent class into the derived class have to be altered. See GClassInitFunc() for a discussion of the class initialization process. - @@ -235,7 +227,6 @@ binding, source, and target instances to drop. #GBinding is available since GObject 2.26 Retrieves the flags passed when constructing the #GBinding. - the #GBindingFlags used by the #GBinding @@ -247,11 +238,21 @@ binding, source, and target instances to drop. - - Retrieves the #GObject instance used as the source of the binding. - - - the source #GObject + + Retrieves the #GObject instance used as the source of the binding. + +A #GBinding can outlive the source #GObject as the binding does not hold a +strong reference to the source. If the source is destroyed before the +binding then this function will return %NULL. + +Use g_binding_dup_source() if the source or binding are used from different +threads as otherwise the pointer returned from this function might become +invalid if the source is finalized from another thread in the meantime. + Use g_binding_dup_source() for a safer version of this +function. + + the source #GObject, or %NULL if the + source does not exist any more. @@ -264,7 +265,6 @@ binding, source, and target instances to drop. Retrieves the name of the property of #GBinding:source used as the source of the binding. - the name of the source property @@ -276,11 +276,21 @@ of the binding. - - Retrieves the #GObject instance used as the target of the binding. - - - the target #GObject + + Retrieves the #GObject instance used as the target of the binding. + +A #GBinding can outlive the target #GObject as the binding does not hold a +strong reference to the target. If the target is destroyed before the +binding then this function will return %NULL. + +Use g_binding_dup_target() if the target or binding are used from different +threads as otherwise the pointer returned from this function might become +invalid if the target is finalized from another thread in the meantime. + Use g_binding_dup_target() for a safer version of this +function. + + the target #GObject, or %NULL if the + target does not exist any more. @@ -293,7 +303,6 @@ of the binding. Retrieves the name of the property of #GBinding:target used as the target of the binding. - the name of the target property @@ -310,15 +319,18 @@ of the binding. property expressed by @binding. This function will release the reference that is being held on -the @binding instance; if you want to hold on to the #GBinding instance -after calling g_binding_unbind(), you will need to hold a reference -to it. - +the @binding instance if the binding is still bound; if you want to hold on +to the #GBinding instance after calling g_binding_unbind(), you will need +to hold a reference to it. + +Note however that this function does not take ownership of @binding, it +only unrefs the reference that was initially created by +g_object_bind_property() and is owned by the binding. - + a #GBinding @@ -387,7 +399,6 @@ is the @source_property on the @source object, and @to_value is the @target_property on the @target object. If this is the @transform_from function of a %G_BINDING_BIDIRECTIONAL binding, then those roles are reversed. - %TRUE if the transformation was successful, and %FALSE otherwise @@ -415,7 +426,6 @@ then those roles are reversed. This function is provided by the user and should produce a copy of the passed in boxed structure. - The newly created copy of the boxed structure. @@ -430,7 +440,6 @@ of the passed in boxed structure. This function is provided by the user and should free the boxed structure passed. - @@ -443,7 +452,6 @@ structure passed. Cast a function pointer to a #GCallback. - a function pointer. @@ -453,7 +461,6 @@ structure passed. Checks whether the user data of the #GCClosure should be passed as the first parameter to the callback. See g_cclosure_new_swap(). - a #GCClosure @@ -462,7 +469,6 @@ first parameter to the callback. See g_cclosure_new_swap(). A #GCClosure is a specialization of #GClosure for C function callbacks. - the #GClosure @@ -476,7 +482,6 @@ first parameter to the callback. See g_cclosure_new_swap(). 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(). - @@ -514,7 +519,6 @@ accumulator, such as g_signal_accumulator_true_handled(). The #GVaClosureMarshal equivalent to g_cclosure_marshal_BOOLEAN__BOXED_BOXED(). - @@ -560,7 +564,6 @@ accumulator, such as g_signal_accumulator_true_handled(). A marshaller for a #GCClosure with a callback of type `gboolean (*callback) (gpointer instance, gint arg1, gpointer user_data)` where the #gint parameter denotes a flags type. - @@ -594,7 +597,6 @@ denotes a flags type. The #GVaClosureMarshal equivalent to g_cclosure_marshal_BOOLEAN__FLAGS(). - @@ -639,7 +641,6 @@ denotes a flags type. A marshaller for a #GCClosure with a callback of type `gchar* (*callback) (gpointer instance, GObject *arg1, gpointer arg2, gpointer user_data)`. - @@ -673,7 +674,6 @@ denotes a flags type. The #GVaClosureMarshal equivalent to g_cclosure_marshal_STRING__OBJECT_POINTER(). - @@ -718,7 +718,6 @@ denotes a flags type. A marshaller for a #GCClosure with a callback of type `void (*callback) (gpointer instance, gboolean arg1, gpointer user_data)`. - @@ -752,7 +751,6 @@ denotes a flags type. The #GVaClosureMarshal equivalent to g_cclosure_marshal_VOID__BOOLEAN(). - @@ -797,7 +795,6 @@ denotes a flags type. A marshaller for a #GCClosure with a callback of type `void (*callback) (gpointer instance, GBoxed *arg1, gpointer user_data)`. - @@ -831,7 +828,6 @@ denotes a flags type. The #GVaClosureMarshal equivalent to g_cclosure_marshal_VOID__BOXED(). - @@ -876,7 +872,6 @@ denotes a flags type. A marshaller for a #GCClosure with a callback of type `void (*callback) (gpointer instance, gchar arg1, gpointer user_data)`. - @@ -910,7 +905,6 @@ denotes a flags type. The #GVaClosureMarshal equivalent to g_cclosure_marshal_VOID__CHAR(). - @@ -955,7 +949,6 @@ denotes a flags type. A marshaller for a #GCClosure with a callback of type `void (*callback) (gpointer instance, gdouble arg1, gpointer user_data)`. - @@ -989,7 +982,6 @@ denotes a flags type. The #GVaClosureMarshal equivalent to g_cclosure_marshal_VOID__DOUBLE(). - @@ -1034,7 +1026,6 @@ denotes a flags type. A marshaller for a #GCClosure with a callback of type `void (*callback) (gpointer instance, gint arg1, gpointer user_data)` where the #gint parameter denotes an enumeration type.. - @@ -1068,7 +1059,6 @@ denotes a flags type. The #GVaClosureMarshal equivalent to g_cclosure_marshal_VOID__ENUM(). - @@ -1113,7 +1103,6 @@ denotes a flags type. A marshaller for a #GCClosure with a callback of type `void (*callback) (gpointer instance, gint arg1, gpointer user_data)` where the #gint parameter denotes a flags type. - @@ -1147,7 +1136,6 @@ denotes a flags type. The #GVaClosureMarshal equivalent to g_cclosure_marshal_VOID__FLAGS(). - @@ -1192,7 +1180,6 @@ denotes a flags type. A marshaller for a #GCClosure with a callback of type `void (*callback) (gpointer instance, gfloat arg1, gpointer user_data)`. - @@ -1226,7 +1213,6 @@ denotes a flags type. The #GVaClosureMarshal equivalent to g_cclosure_marshal_VOID__FLOAT(). - @@ -1271,7 +1257,6 @@ denotes a flags type. A marshaller for a #GCClosure with a callback of type `void (*callback) (gpointer instance, gint arg1, gpointer user_data)`. - @@ -1305,7 +1290,6 @@ denotes a flags type. The #GVaClosureMarshal equivalent to g_cclosure_marshal_VOID__INT(). - @@ -1350,7 +1334,6 @@ denotes a flags type. A marshaller for a #GCClosure with a callback of type `void (*callback) (gpointer instance, glong arg1, gpointer user_data)`. - @@ -1384,7 +1367,6 @@ denotes a flags type. The #GVaClosureMarshal equivalent to g_cclosure_marshal_VOID__LONG(). - @@ -1429,7 +1411,6 @@ denotes a flags type. A marshaller for a #GCClosure with a callback of type `void (*callback) (gpointer instance, GObject *arg1, gpointer user_data)`. - @@ -1463,7 +1444,6 @@ denotes a flags type. The #GVaClosureMarshal equivalent to g_cclosure_marshal_VOID__OBJECT(). - @@ -1508,7 +1488,6 @@ denotes a flags type. A marshaller for a #GCClosure with a callback of type `void (*callback) (gpointer instance, GParamSpec *arg1, gpointer user_data)`. - @@ -1542,7 +1521,6 @@ denotes a flags type. The #GVaClosureMarshal equivalent to g_cclosure_marshal_VOID__PARAM(). - @@ -1587,7 +1565,6 @@ denotes a flags type. A marshaller for a #GCClosure with a callback of type `void (*callback) (gpointer instance, gpointer arg1, gpointer user_data)`. - @@ -1621,7 +1598,6 @@ denotes a flags type. The #GVaClosureMarshal equivalent to g_cclosure_marshal_VOID__POINTER(). - @@ -1666,7 +1642,6 @@ denotes a flags type. A marshaller for a #GCClosure with a callback of type `void (*callback) (gpointer instance, const gchar *arg1, gpointer user_data)`. - @@ -1700,7 +1675,6 @@ denotes a flags type. The #GVaClosureMarshal equivalent to g_cclosure_marshal_VOID__STRING(). - @@ -1745,7 +1719,6 @@ denotes a flags type. A marshaller for a #GCClosure with a callback of type `void (*callback) (gpointer instance, guchar arg1, gpointer user_data)`. - @@ -1779,7 +1752,6 @@ denotes a flags type. The #GVaClosureMarshal equivalent to g_cclosure_marshal_VOID__UCHAR(). - @@ -1824,7 +1796,6 @@ denotes a flags type. A marshaller for a #GCClosure with a callback of type `void (*callback) (gpointer instance, guint arg1, gpointer user_data)`. - @@ -1859,7 +1830,6 @@ denotes a flags type. A marshaller for a #GCClosure with a callback of type `void (*callback) (gpointer instance, guint arg1, gpointer arg2, gpointer user_data)`. - @@ -1893,7 +1863,6 @@ denotes a flags type. The #GVaClosureMarshal equivalent to g_cclosure_marshal_VOID__UINT_POINTER(). - @@ -1937,7 +1906,6 @@ denotes a flags type. The #GVaClosureMarshal equivalent to g_cclosure_marshal_VOID__UINT(). - @@ -1982,7 +1950,6 @@ denotes a flags type. A marshaller for a #GCClosure with a callback of type `void (*callback) (gpointer instance, gulong arg1, gpointer user_data)`. - @@ -2016,7 +1983,6 @@ denotes a flags type. The #GVaClosureMarshal equivalent to g_cclosure_marshal_VOID__ULONG(). - @@ -2061,7 +2027,6 @@ denotes a flags type. A marshaller for a #GCClosure with a callback of type `void (*callback) (gpointer instance, GVariant *arg1, gpointer user_data)`. - @@ -2095,7 +2060,6 @@ denotes a flags type. The #GVaClosureMarshal equivalent to g_cclosure_marshal_VOID__VARIANT(). - @@ -2140,7 +2104,6 @@ denotes a flags type. A marshaller for a #GCClosure with a callback of type `void (*callback) (gpointer instance, gpointer user_data)`. - @@ -2174,7 +2137,6 @@ denotes a flags type. The #GVaClosureMarshal equivalent to g_cclosure_marshal_VOID__VOID(). - @@ -2222,7 +2184,6 @@ denotes a flags type. Normally this function is not passed explicitly to g_signal_new(), but used automatically by GLib when specifying a %NULL marshaller. - @@ -2261,7 +2222,6 @@ but used automatically by GLib when specifying a %NULL marshaller. A generic #GVaClosureMarshal function implemented via [libffi](http://sourceware.org/libffi/). - @@ -2309,7 +2269,6 @@ but used automatically by GLib when specifying a %NULL marshaller. the last parameter. @destroy_data will be called as a finalize notifier on the #GClosure. - a floating reference to a new #GCClosure @@ -2335,7 +2294,6 @@ calls g_object_watch_closure() on @object and the created closure. This function is useful when you have a callback closely associated with a #GObject, and want the callback to no longer run after the object is is freed. - a new #GCClosure @@ -2357,7 +2315,6 @@ and calls g_object_watch_closure() on @object and the created closure. This function is useful when you have a callback closely associated with a #GObject, and want the callback to no longer run after the object is is freed. - a new #GCClosure @@ -2378,7 +2335,6 @@ after the object is is freed. the first parameter. @destroy_data will be called as a finalize notifier on the #GClosure. - a floating reference to a new #GCClosure @@ -2401,7 +2357,6 @@ the first parameter. Check if the closure still needs a marshaller. See g_closure_set_marshal(). - a #GClosure @@ -2414,7 +2369,6 @@ The count includes the meta marshaller, the finalize and invalidate notifiers and the marshal guards. Note that each guard counts as two notifiers. See g_closure_set_meta_marshal(), g_closure_add_finalize_notifier(), g_closure_add_invalidate_notifier() and g_closure_add_marshal_guards(). - a #GClosure @@ -2427,7 +2381,6 @@ signatures. This doesn't mean that all callback functions must take no parameters and return void. The required signature of a callback function is determined by the context in which is used (e.g. the signal to which it is connected). Use G_CALLBACK() to cast the callback function to a #GCallback. - @@ -2440,7 +2393,6 @@ Also, specification of a GClassFinalizeFunc() in the #GTypeInfo structure of a static type is invalid, because classes of static types will never be finalized (they are artificially kept alive when their reference count drops to zero). - @@ -2551,7 +2503,6 @@ is called to complete the initialization process with the static members Corresponding finalization counter parts to the GBaseInitFunc() functions have to be provided to release allocated resources at class finalization time. - @@ -2610,7 +2561,6 @@ callback function/data pointer combination: - g_closure_invalidate() and invalidation notifiers allow callbacks to be automatically removed when the objects they point to go away. - @@ -2647,7 +2597,6 @@ callback function/data pointer combination: - @@ -2684,7 +2633,6 @@ callback function/data pointer combination: @data field of the closure and calls g_object_watch_closure() on @object and the created closure. This function is mainly useful when implementing new types of closures. - a newly allocated #GClosure @@ -2739,7 +2687,6 @@ MyClosure *my_closure_new (gpointer data) return my_closure; } ]| - a floating reference to a new #GClosure @@ -2763,7 +2710,6 @@ notifiers on a single closure are invoked in unspecified order. If a single call to g_closure_unref() results in the closure being both invalidated and finalized, then the invalidate notifiers will be run before the finalize notifiers. - @@ -2787,7 +2733,6 @@ be run before the finalize notifiers. @closure is invalidated with g_closure_invalidate(). Invalidation notifiers are invoked before finalization notifiers, in an unspecified order. - @@ -2811,7 +2756,6 @@ unspecified order. closure callback, respectively. This is typically used to protect the extra arguments for the duration of the callback. See g_object_watch_closure() for an example of marshal guards. - @@ -2854,7 +2798,6 @@ that you've previously called g_closure_ref(). Note that g_closure_invalidate() will also be called when the reference count of a closure drops to zero (unless it has already been invalidated before). - @@ -2867,7 +2810,6 @@ been invalidated before). Invokes the closure, i.e. executes the callback represented by the @closure. - @@ -2903,7 +2845,6 @@ been invalidated before). Increments the reference count on a closure to force it staying alive while the caller holds a pointer to it. - The @closure passed in, for convenience @@ -2919,7 +2860,6 @@ alive while the caller holds a pointer to it. Removes a finalization notifier. Notice that notifiers are automatically removed after they are run. - @@ -2943,7 +2883,6 @@ Notice that notifiers are automatically removed after they are run. Removes an invalidation notifier. Notice that notifiers are automatically removed after they are run. - @@ -2970,7 +2909,6 @@ information to the marshaller. (See g_closure_set_meta_marshal().) For GObject's C predefined marshallers (the g_cclosure_marshal_*() functions), what it provides is a callback function to use instead of @closure->callback. - @@ -3000,7 +2938,6 @@ g_signal_type_cclosure_new()) retrieve the callback function from a fixed offset in the class structure. The meta marshaller retrieves the right callback and passes it to the marshaller as the @marshal_data argument. - @@ -3061,7 +2998,6 @@ foo_notify_set_closure (GClosure *closure) Because g_closure_sink() may decrement the reference count of a closure (if it hasn't been called on @closure yet) just like g_closure_unref(), g_closure_ref() should be called prior to this function. - @@ -3077,7 +3013,6 @@ g_closure_ref() should be called prior to this function. Decrements the reference count of a closure after it was previously incremented by the same caller. If no other callers are using the closure, then the closure will be destroyed and freed. - @@ -3091,7 +3026,6 @@ closure, then the closure will be destroyed and freed. The type used for marshaller functions. - @@ -3134,7 +3068,6 @@ closure, then the closure will be destroyed and freed. The type used for the various notification callbacks which can be registered on closures. - @@ -3150,7 +3083,6 @@ on closures. - @@ -3161,7 +3093,6 @@ on closures. The connection flags are used to specify the behaviour of a signal's connection. - whether the handler should be called before or after the default handler of the signal. @@ -3236,7 +3167,6 @@ structures, use G_DECLARE_FINAL_TYPE(). If you must use G_DECLARE_DERIVABLE_TYPE() you should be sure to include some padding at the bottom of your class structure to leave space for the addition of future virtual functions. - The name of the new type, in camel case (like GtkWidget) @@ -3311,7 +3241,6 @@ G_DECLARE_FINAL_TYPE() to G_DECLARE_DERIVABLE_TYPE() without breaking API or ABI should therefore use G_DECLARE_FINAL_TYPE() until you are sure that it makes sense for your class to be subclassed. Once a class structure has been exposed it is not possible to change its size or remove or reorder items without breaking the API and/or ABI. - The name of the new type, in camel case (like GtkWidget) @@ -3378,7 +3307,6 @@ manually define this as a macro for yourself. The declaration of the _get_type() function is the first thing emitted by the macro. This allows this macro to be used in the usual way with export control and API versioning macros. - The name of the new type, in camel case (like GtkWidget) @@ -3402,7 +3330,6 @@ to be used in the usual way with export control and API versioning macros. A convenience macro for type implementations. Similar to G_DEFINE_TYPE(), but defines an abstract type. See G_DEFINE_TYPE_EXTENDED() for an example. - The name of the new type, in Camel case. @@ -3422,7 +3349,6 @@ Similar to G_DEFINE_TYPE_WITH_CODE(), but defines an abstract type and allows you to insert custom code into the *_get_type() function, e.g. interface implementations via G_IMPLEMENT_INTERFACE(). See G_DEFINE_TYPE_EXTENDED() for an example. - The name of the new type, in Camel case. @@ -3442,7 +3368,6 @@ See G_DEFINE_TYPE_EXTENDED() for an example. Similar to G_DEFINE_TYPE_WITH_PRIVATE(), but defines an abstract type. See G_DEFINE_TYPE_EXTENDED() for an example. - The name of the new type, in Camel case. @@ -3459,7 +3384,6 @@ See G_DEFINE_TYPE_EXTENDED() for an example. A convenience macro for boxed type implementations, which defines a type_name_get_type() function registering the boxed type. - The name of the new type, in Camel case @@ -3491,7 +3415,6 @@ G_DEFINE_BOXED_TYPE_WITH_CODE (GdkRectangle, gdk_rectangle, Similarly to the %G_DEFINE_TYPE family of macros, the #GType of the newly defined boxed type is exposed in the `g_define_type_id` variable. - The name of the new type, in Camel case @@ -3520,7 +3443,6 @@ it defines a `*_get_type()` and a static `*_register_type()` functions for use in your `module_init()`. See G_DEFINE_DYNAMIC_TYPE_EXTENDED() for an example. - The name of the new type, in Camel case. @@ -3595,7 +3517,6 @@ gtk_gadget_register_type (GTypeModule *type_module) } } ]| - The name of the new type, in Camel case. @@ -3629,7 +3550,6 @@ The initialization function has signature the full #GInterfaceInitFunc signature, for brevity and convenience. If you need to use an initialization function with an `iface_data` argument, you must write the #GTypeInterface definitions manually. - The name of the new type, in Camel case. @@ -3650,7 +3570,6 @@ G_DEFINE_INTERFACE(), but allows you to insert custom code into the via G_IMPLEMENT_INTERFACE(), or additional prerequisite types. See G_DEFINE_TYPE_EXTENDED() for a similar example using G_DEFINE_TYPE_WITH_CODE(). - The name of the new type, in Camel case. @@ -3670,7 +3589,6 @@ G_DEFINE_TYPE_WITH_CODE(). A convenience macro for pointer type implementations, which defines a type_name_get_type() function registering the pointer type. - The name of the new type, in Camel case @@ -3685,7 +3603,6 @@ type_name_get_type() function registering the pointer type. A convenience macro for pointer type implementations. Similar to G_DEFINE_POINTER_TYPE(), but allows to insert custom code into the type_name_get_type() function. - The name of the new type, in Camel case @@ -3705,7 +3622,6 @@ initialization function, an instance initialization function (see #GTypeInfo for information about these) and a static variable named `t_n_parent_class` pointing to the parent class. Furthermore, it defines a *_get_type() function. See G_DEFINE_TYPE_EXTENDED() for an example. - The name of the new type, in Camel case. @@ -3782,7 +3698,6 @@ gtk_gadget_get_type (void) The only pieces which have to be manually provided are the definitions of the instance and class structure and the definitions of the instance and class init functions. - The name of the new type, in Camel case. @@ -3807,7 +3722,6 @@ class init functions. Similar to G_DEFINE_TYPE(), but allows you to insert custom code into the *_get_type() function, e.g. interface implementations via G_IMPLEMENT_INTERFACE(). See G_DEFINE_TYPE_EXTENDED() for an example. - The name of the new type, in Camel case. @@ -3838,7 +3752,6 @@ The private instance data can be retrieved using the automatically generated getter function `t_n_get_instance_private()`. See also: G_ADD_PRIVATE() - The name of the new type, in Camel case. @@ -3854,7 +3767,6 @@ See also: G_ADD_PRIVATE() Casts a derived #GEnumClass structure into a #GEnumClass structure. - a valid #GEnumClass @@ -3863,7 +3775,6 @@ See also: G_ADD_PRIVATE() Get the type identifier from a given #GEnumClass structure. - a #GEnumClass @@ -3872,7 +3783,6 @@ See also: G_ADD_PRIVATE() Get the static type name from a given #GEnumClass structure. - a #GEnumClass @@ -3882,7 +3792,6 @@ See also: G_ADD_PRIVATE() The class of an enumeration type holds information about its possible values. - the parent class @@ -3908,7 +3817,6 @@ possible values. A structure which contains a single enum value, its name, and its nickname. - the enum value @@ -3924,7 +3832,6 @@ nickname. Casts a derived #GFlagsClass structure into a #GFlagsClass structure. - a valid #GFlagsClass @@ -3933,7 +3840,6 @@ nickname. Get the type identifier from a given #GFlagsClass structure. - a #GFlagsClass @@ -3942,7 +3848,6 @@ nickname. Get the static type name from a given #GFlagsClass structure. - a #GFlagsClass @@ -3952,7 +3857,6 @@ nickname. The class of a flags type holds information about its possible values. - the parent class @@ -3974,7 +3878,6 @@ possible values. A structure which contains a single flags value, its name, and its nickname. - the flags value @@ -3995,7 +3898,6 @@ See G_DEFINE_TYPE_EXTENDED() for an example. Note that this macro can only be used together with the G_DEFINE_TYPE_* macros, since it depends on variable names from those macros. - The #GType of the interface to add @@ -4013,7 +3915,6 @@ for an example. Note that this macro can only be used together with the G_DEFINE_DYNAMIC_TYPE_EXTENDED macros, since it depends on variable names from that macro. - The #GType of the interface to add @@ -4027,7 +3928,6 @@ names from that macro. Casts a #GInitiallyUnowned or derived pointer into a (GInitiallyUnowned*) pointer. Depending on the current debugging level, this function may invoke certain runtime checks to identify invalid casts. - Object which is subject to casting. @@ -4037,7 +3937,6 @@ certain runtime checks to identify invalid casts. Casts a derived #GInitiallyUnownedClass structure into a #GInitiallyUnownedClass structure. - a valid #GInitiallyUnownedClass @@ -4046,7 +3945,6 @@ certain runtime checks to identify invalid casts. Get the class structure associated to a #GInitiallyUnowned instance. - a #GInitiallyUnowned instance. @@ -4054,7 +3952,6 @@ certain runtime checks to identify invalid casts. - @@ -4063,7 +3960,6 @@ certain runtime checks to identify invalid casts. Checks whether @class "is a" valid #GEnumClass structure of type %G_TYPE_ENUM or derived. - a #GEnumClass @@ -4073,7 +3969,6 @@ or derived. Checks whether @class "is a" valid #GFlagsClass structure of type %G_TYPE_FLAGS or derived. - a #GFlagsClass @@ -4082,7 +3977,6 @@ or derived. Checks whether a valid #GTypeInstance pointer is of type %G_TYPE_INITIALLY_UNOWNED. - Instance to check for being a %G_TYPE_INITIALLY_UNOWNED. @@ -4092,7 +3986,6 @@ or derived. Checks whether @class "is a" valid #GInitiallyUnownedClass structure of type %G_TYPE_INITIALLY_UNOWNED or derived. - a #GInitiallyUnownedClass @@ -4101,7 +3994,6 @@ or derived. Checks whether a valid #GTypeInstance pointer is of type %G_TYPE_OBJECT. - Instance to check for being a %G_TYPE_OBJECT. @@ -4111,7 +4003,6 @@ or derived. Checks whether @class "is a" valid #GObjectClass structure of type %G_TYPE_OBJECT or derived. - a #GObjectClass @@ -4121,7 +4012,6 @@ or derived. Checks whether @pspec "is a" valid #GParamSpec structure of type %G_TYPE_PARAM or derived. - a #GParamSpec @@ -4130,7 +4020,6 @@ or derived. Checks whether the given #GParamSpec is of type %G_TYPE_PARAM_BOOLEAN. - a valid #GParamSpec instance @@ -4139,7 +4028,6 @@ or derived. Checks whether the given #GParamSpec is of type %G_TYPE_PARAM_BOXED. - a valid #GParamSpec instance @@ -4148,7 +4036,6 @@ or derived. Checks whether the given #GParamSpec is of type %G_TYPE_PARAM_CHAR. - a valid #GParamSpec instance @@ -4158,7 +4045,6 @@ or derived. Checks whether @pclass "is a" valid #GParamSpecClass structure of type %G_TYPE_PARAM or derived. - a #GParamSpecClass @@ -4167,7 +4053,6 @@ or derived. Checks whether the given #GParamSpec is of type %G_TYPE_PARAM_DOUBLE. - a valid #GParamSpec instance @@ -4176,7 +4061,6 @@ or derived. Checks whether the given #GParamSpec is of type %G_TYPE_PARAM_ENUM. - a valid #GParamSpec instance @@ -4185,7 +4069,6 @@ or derived. Checks whether the given #GParamSpec is of type %G_TYPE_PARAM_FLAGS. - a valid #GParamSpec instance @@ -4194,7 +4077,6 @@ or derived. Checks whether the given #GParamSpec is of type %G_TYPE_PARAM_FLOAT. - a valid #GParamSpec instance @@ -4203,7 +4085,6 @@ or derived. Checks whether the given #GParamSpec is of type %G_TYPE_PARAM_GTYPE. - a #GParamSpec @@ -4212,7 +4093,6 @@ or derived. Checks whether the given #GParamSpec is of type %G_TYPE_PARAM_INT. - a valid #GParamSpec instance @@ -4221,7 +4101,6 @@ or derived. Checks whether the given #GParamSpec is of type %G_TYPE_PARAM_INT64. - a valid #GParamSpec instance @@ -4230,7 +4109,6 @@ or derived. Checks whether the given #GParamSpec is of type %G_TYPE_PARAM_LONG. - a valid #GParamSpec instance @@ -4239,7 +4117,6 @@ or derived. Checks whether the given #GParamSpec is of type %G_TYPE_PARAM_OBJECT. - a valid #GParamSpec instance @@ -4248,7 +4125,6 @@ or derived. Checks whether the given #GParamSpec is of type %G_TYPE_PARAM_OVERRIDE. - a #GParamSpec @@ -4257,7 +4133,6 @@ or derived. Checks whether the given #GParamSpec is of type %G_TYPE_PARAM_PARAM. - a valid #GParamSpec instance @@ -4266,7 +4141,6 @@ or derived. Checks whether the given #GParamSpec is of type %G_TYPE_PARAM_POINTER. - a valid #GParamSpec instance @@ -4275,7 +4149,6 @@ or derived. Checks whether the given #GParamSpec is of type %G_TYPE_PARAM_STRING. - a valid #GParamSpec instance @@ -4284,7 +4157,6 @@ or derived. Checks whether the given #GParamSpec is of type %G_TYPE_PARAM_UCHAR. - a valid #GParamSpec instance @@ -4293,7 +4165,6 @@ or derived. Checks whether the given #GParamSpec is of type %G_TYPE_PARAM_UINT. - a valid #GParamSpec instance @@ -4302,7 +4173,6 @@ or derived. Checks whether the given #GParamSpec is of type %G_TYPE_PARAM_UINT64. - a valid #GParamSpec instance @@ -4311,7 +4181,6 @@ or derived. Checks whether the given #GParamSpec is of type %G_TYPE_PARAM_ULONG. - a valid #GParamSpec instance @@ -4320,7 +4189,6 @@ or derived. Checks whether the given #GParamSpec is of type %G_TYPE_PARAM_UNICHAR. - a valid #GParamSpec instance @@ -4330,7 +4198,6 @@ or derived. Checks whether the given #GParamSpec is of type %G_TYPE_PARAM_VALUE_ARRAY. Use #GArray instead of #GValueArray - a valid #GParamSpec instance @@ -4339,7 +4206,6 @@ or derived. Checks whether the given #GParamSpec is of type %G_TYPE_PARAM_VARIANT. - a #GParamSpec @@ -4347,28 +4213,24 @@ or derived. - - - - @@ -4376,7 +4238,6 @@ or derived. Checks if @value is a valid and initialized #GValue structure. - A #GValue structure. @@ -4387,7 +4248,6 @@ or derived. All the fields in the GInitiallyUnowned structure are private to the #GInitiallyUnowned implementation and should never be accessed directly. - @@ -4400,7 +4260,6 @@ accessed directly. The class structure for the GInitiallyUnowned type. - the parent class @@ -4412,7 +4271,6 @@ accessed directly. - @@ -4431,7 +4289,6 @@ accessed directly. - @@ -4453,7 +4310,6 @@ accessed directly. - @@ -4475,7 +4331,6 @@ accessed directly. - @@ -4488,7 +4343,6 @@ accessed directly. - @@ -4501,7 +4355,6 @@ accessed directly. - @@ -4520,7 +4373,6 @@ accessed directly. - @@ -4537,7 +4389,6 @@ accessed directly. - @@ -4569,7 +4420,6 @@ belongs to the type the current initializer was introduced for. The extended members of @instance are guaranteed to have been filled with zeros before this function is called. - @@ -4589,7 +4439,6 @@ zeros before this function is called. A callback function used by the type system to finalize an interface. This function should destroy any internal data and release any resources allocated by the corresponding GInterfaceInitFunc() function. - @@ -4607,7 +4456,6 @@ allocated by the corresponding GInterfaceInitFunc() function. A structure that provides information to the type system which is used specifically for managing interface types. - location of the interface initialization function @@ -4628,7 +4476,6 @@ allocate any resources required by the interface. The members of @iface_data are guaranteed to have been filled with zeros before this function is called. - @@ -4647,7 +4494,6 @@ zeros before this function is called. Casts a #GObject or derived pointer into a (GObject*) pointer. Depending on the current debugging level, this function may invoke certain runtime checks to identify invalid casts. - Object which is subject to casting. @@ -4656,7 +4502,6 @@ certain runtime checks to identify invalid casts. Casts a derived #GObjectClass structure into a #GObjectClass structure. - a valid #GObjectClass @@ -4665,7 +4510,6 @@ certain runtime checks to identify invalid casts. Return the name of a class structure's type. - a valid #GObjectClass @@ -4674,7 +4518,6 @@ certain runtime checks to identify invalid casts. Get the type id of a class structure. - a valid #GObjectClass @@ -4683,7 +4526,6 @@ certain runtime checks to identify invalid casts. Get the class structure associated to a #GObject instance. - a #GObject instance. @@ -4692,7 +4534,6 @@ certain runtime checks to identify invalid casts. Get the type id of an object. - Object to return the type id for. @@ -4701,7 +4542,6 @@ certain runtime checks to identify invalid casts. Get the name of an object's type. - Object to return the type name for. @@ -4711,7 +4551,6 @@ certain runtime checks to identify invalid casts. This macro should be used to emit a standard warning about unexpected properties in set_property() and get_property() implementations. - the #GObject on which set_property() or get_property() was called @@ -4725,7 +4564,6 @@ properties in set_property() and get_property() implementations. - @@ -4740,7 +4578,6 @@ properties in set_property() and get_property() implementations. All the fields in the GObject structure are private to the #GObject implementation and should never be accessed directly. - Creates a new instance of a #GObject subtype and sets its properties. @@ -4762,7 +4599,6 @@ make use of the %G_GINT64_CONSTANT or %G_GUINT64_CONSTANT macros. Similarly, #gfloat is promoted to #gdouble, so you must ensure that the value you provide is a #gdouble, even for a property of type #gfloat. - a new instance of @object_type @@ -4789,7 +4625,6 @@ you provide is a #gdouble, even for a property of type #gfloat. Construction parameters (see #G_PARAM_CONSTRUCT, #G_PARAM_CONSTRUCT_ONLY) which are not explicitly specified are set to their default values. - a new instance of @object_type @@ -4817,7 +4652,6 @@ and the names and values correspond by index. Construction parameters (see %G_PARAM_CONSTRUCT, %G_PARAM_CONSTRUCT_ONLY) which are not explicitly specified are set to their default values. - a new instance of @object_type @@ -4853,7 +4687,6 @@ Construction parameters (see #G_PARAM_CONSTRUCT, #G_PARAM_CONSTRUCT_ONLY) which are not explicitly specified are set to their default values. Use g_object_new_with_properties() instead. deprecated. See #GParameter for more information. - a new instance of @object_type @@ -4877,7 +4710,6 @@ deprecated. See #GParameter for more information. - @@ -4896,7 +4728,6 @@ interface. Generally, the interface vtable passed in as @g_iface will be the default vtable from g_type_default_interface_ref(), or, if you know the interface has already been loaded, g_type_default_interface_peek(). - the #GParamSpec for the property of the interface with the name @property_name, or %NULL if no @@ -4932,7 +4763,6 @@ vtable initialization function (the @class_init member of been called for any object types implementing this interface. If @pspec is a floating reference, it will be consumed. - @@ -4954,7 +4784,6 @@ If @pspec is a floating reference, it will be consumed. vtable passed in as @g_iface will be the default vtable from g_type_default_interface_ref(), or, if you know the interface has already been loaded, g_type_default_interface_peek(). - a pointer to an array of pointers to #GParamSpec @@ -4978,7 +4807,6 @@ already been loaded, g_type_default_interface_peek(). - @@ -4989,7 +4817,6 @@ already been loaded, g_type_default_interface_peek(). - @@ -5006,7 +4833,6 @@ already been loaded, g_type_default_interface_peek(). - @@ -5017,7 +4843,6 @@ already been loaded, g_type_default_interface_peek(). - @@ -5028,7 +4853,6 @@ already been loaded, g_type_default_interface_peek(). - @@ -5058,7 +4882,6 @@ Note that emission of the notify signal may be blocked with g_object_freeze_notify(). In this case, the signal emissions are queued and will be emitted (in reverse order) when g_object_thaw_notify() is called. - @@ -5073,7 +4896,6 @@ called. - @@ -5121,7 +4943,6 @@ however if there are multiple toggle references to an object, none of them will ever be notified until all but one are removed. For this reason, you should only ever use a toggle reference if there is important state in the proxy object. - @@ -5152,7 +4973,6 @@ Note that as with g_object_weak_ref(), the weak references created by this method are not thread-safe: they cannot safely be used in one thread if the object's last g_object_unref() might happen in another thread. Use #GWeakRef if thread-safety is required. - @@ -5190,8 +5010,14 @@ The binding will automatically be removed when either the @source or the @source and the @target you can just call g_object_unref() on the returned #GBinding instance. +Removing the binding by calling g_object_unref() on it must only be done if +the binding, @source and @target are only used from a single thread and it +is clear that both @source and @target outlive the binding. Especially it +is not safe to rely on this if the binding, @source or @target can be +finalized from different threads. Keep another reference to the binding and +use g_binding_unbind() instead to be on the safe side. + A #GObject can have multiple bindings. - the #GBinding instance representing the binding between the two #GObject instances. The binding is released @@ -5247,7 +5073,6 @@ and @transform_from transformation functions; the @notify function will be called once, when the binding is removed. If you need different data for each transformation function, please use g_object_bind_property_with_closures() instead. - the #GBinding instance representing the binding between the two #GObject instances. The binding is released @@ -5305,7 +5130,6 @@ the binding. This function is the language bindings friendly version of g_object_bind_property_full(), using #GClosures instead of function pointers. - the #GBinding instance representing the binding between the two #GObject instances. The binding is released @@ -5369,7 +5193,6 @@ The signal specs expected by this function have the form "signal::destroy", gtk_widget_destroyed, &menu->toplevel, NULL); ]| - @object @@ -5398,7 +5221,6 @@ The signal specs expected by this function have the form "any_signal", which means to disconnect any signal with matching callback and data, or "any_signal::signal_name", which only disconnects the signal named "signal_name". - @@ -5434,7 +5256,6 @@ 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. - the result of calling @dup_func on the value associated with @key on @object, or %NULL if not set. @@ -5476,7 +5297,6 @@ 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. - the result of calling @dup_func on the value associated with @quark on @object, or %NULL if not set. @@ -5508,7 +5328,6 @@ object. a [floating][floating-ref] object reference. Doing this is seldom required: all #GInitiallyUnowneds are created with a floating reference which usually just needs to be sunken by calling g_object_ref_sink(). - @@ -5529,7 +5348,6 @@ object is frozen. This is necessary for accessors that modify multiple properties to prevent premature notification while the object is still being modified. - @@ -5567,7 +5385,6 @@ of three properties: an integer, a string and an object: g_free (strval); g_object_unref (objval); ]| - @@ -5589,7 +5406,6 @@ of three properties: an integer, a string and an object: Gets a named field from the objects table of associations (see g_object_set_data()). - the data if found, or %NULL if no such data exists. @@ -5623,7 +5439,6 @@ responsible for freeing the memory by calling g_value_unset(). Note that g_object_get_property() is really intended for language bindings, g_object_get() is much more convenient for C programming. - @@ -5645,7 +5460,6 @@ bindings, g_object_get() is much more convenient for C programming. This function gets back user data pointers stored via g_object_set_qdata(). - The user data pointer set, or %NULL @@ -5669,7 +5483,6 @@ is responsible for freeing the memory in the appropriate manner for the type, for instance by calling g_free() or g_object_unref(). See g_object_get(). - @@ -5694,7 +5507,6 @@ See g_object_get(). Obtained properties will be set to @values. All properties must be valid. Warnings will be emitted and undefined behaviour may result if invalid properties are passed in. - @@ -5723,7 +5535,6 @@ properties are passed in. Checks whether @object has a [floating][floating-ref] reference. - %TRUE if @object has a floating reference @@ -5746,7 +5557,6 @@ Note that emission of the notify signal may be blocked with g_object_freeze_notify(). In this case, the signal emissions are queued and will be emitted (in reverse order) when g_object_thaw_notify() is called. - @@ -5800,7 +5610,6 @@ and then notify a change on the "foo" property with: |[<!-- language="C" --> g_object_notify_by_pspec (self, properties[PROP_FOO]); ]| - @@ -5822,7 +5631,6 @@ Since GLib 2.56, if `GLIB_VERSION_MAX_ALLOWED` is 2.56 or greater, the type of @object will be propagated to the return type (using the GCC typeof() extension), so any casting the caller needs to do on the return type must be explicit. - the same @object @@ -5846,7 +5654,6 @@ adds a new normal reference increasing the reference count by one. Since GLib 2.56, the type of @object will be propagated to the return type under the same conditions as for g_object_ref(). - @object @@ -5861,7 +5668,6 @@ under the same conditions as for g_object_ref(). Removes a reference added with g_object_add_toggle_ref(). The reference count of the object is decreased by one. - @@ -5886,7 +5692,6 @@ reference count of the object is decreased by one. Removes a weak reference from @object that was previously added using g_object_add_weak_pointer(). The @weak_pointer_location has to match the one used with g_object_add_weak_pointer(). - @@ -5919,7 +5724,6 @@ should not destroy the object in the normal way. See g_object_set_data() for guidance on using a small, bounded set of values for @key. - %TRUE if the existing value for @key was replaced by @newval, %FALSE otherwise. @@ -5966,7 +5770,6 @@ the registered destroy notify for it (passed out in @old_destroy). It’s up to the caller to free this as needed, which may or may not include using @old_destroy as sometimes replacement should not destroy the object in the normal way. - %TRUE if the existing value for @quark was replaced by @newval, %FALSE otherwise. @@ -6004,7 +5807,6 @@ should not destroy the object in the normal way. reference cycles. This function should only be called from object system implementations. - @@ -6026,7 +5828,6 @@ properties of type #gint64 or #guint64 must be 64 bits wide, using the Note that the "notify" signals are queued and only emitted (in reverse order) after all properties have been set. See g_object_freeze_notify(). - @@ -6057,7 +5858,6 @@ Internally, the @key is converted to a #GQuark using g_quark_from_string(). This means a copy of @key is kept permanently (even after @object has been finalized) — so it is recommended to only use a small, bounded set of values for @key in your program, to avoid the #GQuark storage growing unbounded. - @@ -6082,7 +5882,6 @@ for when the association is destroyed, either by setting it to a different value or when the object is destroyed. Note that the @destroy callback is not called if @data is %NULL. - @@ -6107,7 +5906,6 @@ Note that the @destroy callback is not called if @data is %NULL. Sets a property on an object. - @@ -6135,7 +5933,6 @@ until the @object is finalized. Setting a previously set user data pointer, overrides (frees) the old pointer set, using #NULL as pointer essentially removes the data stored. - @@ -6160,7 +5957,6 @@ a void (*destroy) (gpointer) function may be specified which is called with @data as argument when the @object is finalized, or the data is being overwritten by a call to g_object_set_qdata() with the same @quark. - @@ -6186,7 +5982,6 @@ with the same @quark. Sets properties on an object. - @@ -6211,7 +6006,6 @@ with the same @quark. Properties to be set will be taken from @values. All properties must be valid. Warnings will be emitted and undefined behaviour may result if invalid properties are passed in. - @@ -6241,7 +6035,6 @@ properties are passed in. Remove a specified datum from the object's data associations, without invoking the association's destroy handler. - the data if found, or %NULL if no such data exists. @@ -6294,7 +6087,6 @@ Using g_object_get_qdata() in the above example, instead of g_object_steal_qdata() would have left the destroy function set, and thus the partial string list would have been freed upon g_object_set_qdata_full(). - The user data pointer set, or %NULL @@ -6320,7 +6112,6 @@ Duplicate notifications for each property are squashed so that at most one in which they have been queued. It is an error to call this function when the freeze count is zero. - @@ -6339,7 +6130,6 @@ If the pointer to the #GObject may be reused in future (for example, if it is an instance variable of another object), it is recommended to clear the pointer to %NULL rather than retain a dangling pointer to a potentially invalid #GObject instance. Use g_clear_object() for this. - @@ -6360,7 +6150,6 @@ added as marshal guards to the @closure, to ensure that an extra reference count is held on @object during invocation of the @closure. Usually, this function will be called on closures that use this @object as closure data. - @@ -6377,7 +6166,7 @@ use this @object as closure data. Adds a weak reference callback to an object. Weak references are -used for notification when an object is finalized. They are called +used for notification when an object is disposed. They are called "weak references" because they allow you to safely hold a pointer to an object without calling g_object_ref() (g_object_ref() adds a strong reference, that is, forces the object to stay alive). @@ -6386,7 +6175,6 @@ Note that the weak references created by this method are not thread-safe: they cannot safely be used in one thread if the object's last g_object_unref() might happen in another thread. Use #GWeakRef if thread-safety is required. - @@ -6407,7 +6195,6 @@ Use #GWeakRef if thread-safety is required. Removes a weak reference callback to an object. - @@ -6497,7 +6284,6 @@ my_singleton_constructor (GType type, return object; } ]| - the parent class @@ -6509,7 +6295,6 @@ my_singleton_constructor (GType type, - @@ -6528,7 +6313,6 @@ my_singleton_constructor (GType type, - @@ -6550,7 +6334,6 @@ my_singleton_constructor (GType type, - @@ -6572,7 +6355,6 @@ my_singleton_constructor (GType type, - @@ -6585,7 +6367,6 @@ my_singleton_constructor (GType type, - @@ -6598,7 +6379,6 @@ my_singleton_constructor (GType type, - @@ -6617,7 +6397,6 @@ my_singleton_constructor (GType type, - @@ -6634,7 +6413,6 @@ my_singleton_constructor (GType type, - @@ -6655,7 +6433,6 @@ my_singleton_constructor (GType type, Looks up the #GParamSpec for a property of a class. - the #GParamSpec for the property, or %NULL if the class doesn't have a property of that name @@ -6734,7 +6511,6 @@ my_object_set_foo (MyObject *self, gint foo) } } ]| - @@ -6767,7 +6543,6 @@ use of properties on the same type on other threads. Note that it is possible to redefine a property in a derived class, by installing a property with the same name. This can be useful at times, e.g. to change the range of allowed values or the default value. - @@ -6788,7 +6563,6 @@ e.g. to change the range of allowed values or the default value. Get an array of #GParamSpec* for all properties of a class. - an array of #GParamSpec* which should be freed after use @@ -6824,7 +6598,6 @@ instead, so that the @param_id field of the #GParamSpec will be correct. For virtually all uses, this makes no difference. If you need to get the overridden property, you can call g_param_spec_get_redirect_target(). - @@ -6849,7 +6622,6 @@ g_param_spec_get_redirect_target(). The GObjectConstructParam struct is an auxiliary structure used to hand #GParamSpec/#GValue pairs to the @constructor of a #GObjectClass. - the #GParamSpec of the construct parameter @@ -6861,7 +6633,6 @@ a #GObjectClass. The type of the @finalize function of #GObjectClass. - @@ -6874,7 +6645,6 @@ a #GObjectClass. The type of the @get_property function of #GObjectClass. - @@ -6900,7 +6670,6 @@ a #GObjectClass. The type of the @set_property function of #GObjectClass. - @@ -6926,13 +6695,11 @@ a #GObjectClass. Mask containing the bits of #GParamSpec.flags which are reserved for GLib. - Casts a derived #GParamSpec object (e.g. of type #GParamSpecInt) into a #GParamSpec object. - a valid #GParamSpec @@ -6941,7 +6708,6 @@ a #GParamSpec object. Cast a #GParamSpec instance into a #GParamSpecBoolean. - a valid #GParamSpec instance @@ -6950,7 +6716,6 @@ a #GParamSpec object. Cast a #GParamSpec instance into a #GParamSpecBoxed. - a valid #GParamSpec instance @@ -6959,7 +6724,6 @@ a #GParamSpec object. Cast a #GParamSpec instance into a #GParamSpecChar. - a valid #GParamSpec instance @@ -6968,7 +6732,6 @@ a #GParamSpec object. Casts a derived #GParamSpecClass structure into a #GParamSpecClass structure. - a valid #GParamSpecClass @@ -6977,7 +6740,6 @@ a #GParamSpec object. Cast a #GParamSpec instance into a #GParamSpecDouble. - a valid #GParamSpec instance @@ -6986,7 +6748,6 @@ a #GParamSpec object. Cast a #GParamSpec instance into a #GParamSpecEnum. - a valid #GParamSpec instance @@ -6995,7 +6756,6 @@ a #GParamSpec object. Cast a #GParamSpec instance into a #GParamSpecFlags. - a valid #GParamSpec instance @@ -7004,7 +6764,6 @@ a #GParamSpec object. Cast a #GParamSpec instance into a #GParamSpecFloat. - a valid #GParamSpec instance @@ -7013,7 +6772,6 @@ a #GParamSpec object. Retrieves the #GParamSpecClass of a #GParamSpec. - a valid #GParamSpec @@ -7022,7 +6780,6 @@ a #GParamSpec object. Casts a #GParamSpec into a #GParamSpecGType. - a #GParamSpec @@ -7031,7 +6788,6 @@ a #GParamSpec object. Cast a #GParamSpec instance into a #GParamSpecInt. - a valid #GParamSpec instance @@ -7040,7 +6796,6 @@ a #GParamSpec object. Cast a #GParamSpec instance into a #GParamSpecInt64. - a valid #GParamSpec instance @@ -7049,7 +6804,6 @@ a #GParamSpec object. Cast a #GParamSpec instance into a #GParamSpecLong. - a valid #GParamSpec instance @@ -7058,7 +6812,6 @@ a #GParamSpec object. Casts a #GParamSpec instance into a #GParamSpecObject. - a valid #GParamSpec instance @@ -7067,7 +6820,6 @@ a #GParamSpec object. Casts a #GParamSpec into a #GParamSpecOverride. - a #GParamSpec @@ -7076,7 +6828,6 @@ a #GParamSpec object. Casts a #GParamSpec instance into a #GParamSpecParam. - a valid #GParamSpec instance @@ -7085,7 +6836,6 @@ a #GParamSpec object. Casts a #GParamSpec instance into a #GParamSpecPointer. - a valid #GParamSpec instance @@ -7094,7 +6844,6 @@ a #GParamSpec object. Casts a #GParamSpec instance into a #GParamSpecString. - a valid #GParamSpec instance @@ -7103,7 +6852,6 @@ a #GParamSpec object. Retrieves the #GType of this @pspec. - a valid #GParamSpec @@ -7112,7 +6860,6 @@ a #GParamSpec object. Retrieves the #GType name of this @pspec. - a valid #GParamSpec @@ -7121,7 +6868,6 @@ a #GParamSpec object. Cast a #GParamSpec instance into a #GParamSpecUChar. - a valid #GParamSpec instance @@ -7130,7 +6876,6 @@ a #GParamSpec object. Cast a #GParamSpec instance into a #GParamSpecUInt. - a valid #GParamSpec instance @@ -7139,7 +6884,6 @@ a #GParamSpec object. Cast a #GParamSpec instance into a #GParamSpecUInt64. - a valid #GParamSpec instance @@ -7148,7 +6892,6 @@ a #GParamSpec object. Cast a #GParamSpec instance into a #GParamSpecULong. - a valid #GParamSpec instance @@ -7157,7 +6900,6 @@ a #GParamSpec object. Cast a #GParamSpec instance into a #GParamSpecUnichar. - a valid #GParamSpec instance @@ -7167,7 +6909,6 @@ a #GParamSpec object. Cast a #GParamSpec instance into a #GParamSpecValueArray. Use #GArray instead of #GValueArray - a valid #GParamSpec instance @@ -7176,7 +6917,6 @@ a #GParamSpec object. Retrieves the #GType to initialize a #GValue for this parameter. - a valid #GParamSpec @@ -7185,7 +6925,6 @@ a #GParamSpec object. Casts a #GParamSpec into a #GParamSpecVariant. - a #GParamSpec @@ -7196,13 +6935,11 @@ a #GParamSpec object. #GParamFlags value alias for %G_PARAM_STATIC_NAME | %G_PARAM_STATIC_NICK | %G_PARAM_STATIC_BLURB. Since 2.13.0 - Minimum shift count to be used for user defined flags, to be stored in #GParamSpec.flags. The maximum allowed is 10. - @@ -7212,7 +6949,6 @@ structure for @TypeName. Note that this macro can only be used together with the G_DEFINE_TYPE_* and G_ADD_PRIVATE() macros, since it depends on variable names from those macros. - the name of the type in CamelCase @@ -7235,7 +6971,6 @@ structure for @TypeName. Note that this macro can only be used together with the G_DEFINE_TYPE_* and G_ADD_PRIVATE() macros, since it depends on variable names from those macros. - the name of the type in CamelCase @@ -7255,7 +6990,6 @@ structure for @TypeName. Note that this macro can only be used together with the G_DEFINE_TYPE_* and G_ADD_PRIVATE() macros, since it depends on variable names from those macros. - the name of the type in CamelCase @@ -7268,7 +7002,6 @@ those macros. Through the #GParamFlags flag values, certain aspects of parameters can be configured. See also #G_PARAM_STATIC_STRINGS. - the parameter is readable @@ -7336,7 +7069,6 @@ for signal naming (see g_signal_new()). When creating and looking up a #GParamSpec, either separator can be used, but they cannot be mixed. Using `-` is considerably more efficient, and is the ‘canonical form’. Using `_` is discouraged. - Creates a new #GParamSpec instance. @@ -7349,9 +7081,9 @@ strings associated with them, the @nick, which should be suitable for use as a label for the property in a property editor, and the @blurb, which should be a somewhat longer description, suitable for e.g. a tooltip. The @nick and @blurb should ideally be localized. - - a newly allocated #GParamSpec instance + (transfer floating): a newly allocated + #GParamSpec instance, which is initially floating @@ -7384,7 +7116,6 @@ before actually trying to create them. See [canonical parameter names][canonical-parameter-names] for details of the rules for valid names. - %TRUE if @name is a valid property name, %FALSE otherwise. @@ -7397,7 +7128,6 @@ the rules for valid names. - @@ -7408,7 +7138,6 @@ the rules for valid names. - @@ -7422,7 +7151,6 @@ the rules for valid names. - @@ -7436,7 +7164,6 @@ the rules for valid names. - @@ -7454,8 +7181,7 @@ the rules for valid names. Get the short description of a #GParamSpec. - - + the short description of @pspec. @@ -7470,7 +7196,6 @@ the rules for valid names. Gets the default value of @pspec as a pointer to a #GValue. The #GValue will remain valid for the life of @pspec. - a pointer to a #GValue which must not be modified @@ -7487,7 +7212,6 @@ The #GValue will remain valid for the life of @pspec. The name is always an "interned" string (as per g_intern_string()). This allows for pointer-value comparisons. - the name of @pspec. @@ -7501,7 +7225,6 @@ This allows for pointer-value comparisons. Gets the GQuark for the name. - the GQuark for @pspec->name. @@ -7515,7 +7238,6 @@ This allows for pointer-value comparisons. Get the nickname of a #GParamSpec. - the nickname of @pspec. @@ -7529,7 +7251,6 @@ This allows for pointer-value comparisons. Gets back user data pointers stored via g_param_spec_set_qdata(). - the user data pointer set, or %NULL @@ -7553,8 +7274,7 @@ type while preserving all the properties from the parent type. Redirection is established by creating a property of type #GParamSpecOverride. See g_object_class_override_property() for an example of the use of this capability. - - + paramspec to which requests on this paramspec should be redirected, or %NULL if none. @@ -7568,8 +7288,7 @@ for an example of the use of this capability. Increments the reference count of @pspec. - - + the #GParamSpec that was passed into this function @@ -7582,8 +7301,7 @@ for an example of the use of this capability. Convenience function to ref and sink a #GParamSpec. - - + the #GParamSpec that was passed into this function @@ -7601,7 +7319,6 @@ g_quark_from_static_string()), and the pointer can be gotten back from the @pspec with g_param_spec_get_qdata(). Setting a previously set user data pointer, overrides (frees) the old pointer set, using %NULL as pointer essentially removes the data stored. - @@ -7626,7 +7343,6 @@ a `void (*destroy) (gpointer)` function may be specified which is called with @data as argument when the @pspec is finalized, or the data is being overwritten by a call to g_param_spec_set_qdata() with the same @quark. - @@ -7643,7 +7359,7 @@ g_param_spec_set_qdata() with the same @quark. an opaque user data pointer - + function to invoke with @data as argument, when @data needs to be freed @@ -7658,7 +7374,6 @@ someone calls `g_param_spec_ref (pspec); g_param_spec_sink (pspec);` in sequence on it, taking over the initial reference count (thus ending up with a @pspec that has a reference count of 1 still, but is not flagged "floating" anymore). - @@ -7674,7 +7389,6 @@ count of 1 still, but is not flagged "floating" anymore). and removes the @data from @pspec without invoking its destroy() function (if any was set). Usually, calling this function is only required to update user data pointers with a destroy notifier. - the user data pointer set, or %NULL @@ -7692,7 +7406,6 @@ required to update user data pointers with a destroy notifier. Decrements the reference count of a @pspec. - @@ -7780,7 +7493,6 @@ required to update user data pointers with a destroy notifier. The class structure for the GParamSpec type. Normally, GParamSpec classes are filled by g_param_type_register_static(). - the parent class @@ -7791,7 +7503,6 @@ g_param_type_register_static(). - @@ -7804,7 +7515,6 @@ g_param_type_register_static(). - @@ -7820,7 +7530,6 @@ g_param_type_register_static(). - @@ -7836,7 +7545,6 @@ g_param_type_register_static(). - @@ -8050,10 +7758,8 @@ properties. quickly accessed by owner and name. The implementation of the #GObject property system uses such a pool to store the #GParamSpecs of the properties all object types. - Inserts a #GParamSpec in the pool. - @@ -8075,7 +7781,6 @@ types. Gets an array of all #GParamSpecs owned by @owner_type in the pool. - a newly allocated array containing pointers to all #GParamSpecs @@ -8102,7 +7807,6 @@ the pool. Gets an #GList of all #GParamSpecs owned by @owner_type in the pool. - a #GList of all #GParamSpecs owned by @owner_type in @@ -8124,8 +7828,7 @@ the pool. Looks up a #GParamSpec in the pool. - - + The found #GParamSpec, or %NULL if no matching #GParamSpec was found. @@ -8152,7 +7855,6 @@ matching #GParamSpec was found. Removes a #GParamSpec from the pool. - @@ -8167,15 +7869,14 @@ matching #GParamSpec was found. - + Creates a new #GParamSpecPool. If @type_prefixing is %TRUE, lookups in the newly created pool will allow to specify the owner as a colon-separated prefix of the property name, like "GtkContainer:border-width". This feature is deprecated, so you should always set @type_prefixing to %FALSE. - - + a newly allocated #GParamSpecPool. @@ -8227,7 +7928,6 @@ The initialized structure is passed to the g_param_type_register_static() The type system will perform a deep copy of this structure, so its memory does not need to be persistent across invocation of g_param_type_register_static(). - Size of the instance (object) structure. @@ -8238,7 +7938,6 @@ g_param_type_register_static(). - @@ -8255,7 +7954,6 @@ g_param_type_register_static(). - @@ -8268,7 +7966,6 @@ g_param_type_register_static(). - @@ -8284,7 +7981,6 @@ g_param_type_register_static(). - @@ -8300,7 +7996,6 @@ g_param_type_register_static(). - @@ -8450,7 +8145,6 @@ values compare equal. The GParameter struct is an auxiliary structure used to hand parameter name/value pairs to g_object_newv(). This type is not introspectable. - the parameter name @@ -8462,12 +8156,10 @@ to hand parameter name/value pairs to g_object_newv(). A mask for all #GSignalFlags bits. - A mask for all #GSignalMatchType bits. - @@ -8477,7 +8169,6 @@ during a signal emission. The signal accumulator is specified at signal creation time, if it is left %NULL, no accumulation of callback return values is performed. The return value of signal emissions is then the value returned by the last callback. - The accumulator function returns whether the signal emission should be aborted. Returning %FALSE means to abort the @@ -8510,7 +8201,6 @@ allows you to tie a hook to the signal type, so that it will trap all emissions of that signal, from any object. You may not attach these to signals created with the #G_SIGNAL_NO_HOOKS flag. - whether it wants to stay connected. If it returns %FALSE, the signal hook is disconnected (and destroyed). @@ -8543,7 +8233,6 @@ You may not attach these to signals created with the #G_SIGNAL_NO_HOOKS flag.The signal flags are used to specify a signal's behaviour, the overall signal description outlines how especially the RUN flags control the stages of a signal emission. - Invoke the object method handler in the first emission stage. @@ -8586,7 +8275,6 @@ stages of a signal emission. The #GSignalInvocationHint structure is used to pass on additional information to callbacks during a signal emission. - The signal id of the signal invoking the callback @@ -8606,7 +8294,6 @@ to callbacks during a signal emission. The match types specify what g_signal_handlers_block_matched(), g_signal_handlers_unblock_matched() and g_signal_handlers_disconnect_matched() match signals by. - The signal id must be equal. @@ -8629,7 +8316,6 @@ match signals by. A structure holding in-depth information for a specific signal. It is filled in by the g_signal_query() function. - The signal id of the signal being queried, or 0 if the signal to be queried was unknown. @@ -8674,7 +8360,6 @@ and issues a warning if this is not the case. Returns @g_class casted to a pointer to @c_type. %NULL is not a valid class structure. This macro should only be used in type implementations. - Location of a #GTypeClass structure @@ -8692,7 +8377,6 @@ This macro should only be used in type implementations. @g_type. If @g_class is %NULL, %FALSE will be returned. This macro should only be used in type implementations. - Location of a #GTypeClass structure @@ -8708,7 +8392,6 @@ otherwise issues a warning and returns %FALSE. %NULL is not a valid #GTypeInstance. This macro should only be used in type implementations. - Location of a #GTypeInstance structure @@ -8723,7 +8406,6 @@ to a pointer to @c_type. No warning will be issued if @instance is %NULL, and %NULL will be returned. This macro should only be used in type implementations. - Location of a #GTypeInstance structure @@ -8741,7 +8423,6 @@ This macro should only be used in type implementations. If @instance is %NULL, %FALSE will be returned. This macro should only be used in type implementations. - Location of a #GTypeInstance structure. @@ -8756,7 +8437,6 @@ This macro should only be used in type implementations. @instance is %NULL, %FALSE will be returned. This macro should only be used in type implementations. - Location of a #GTypeInstance structure. @@ -8771,7 +8451,6 @@ This macro should only be used in type implementations. of a value type. This macro should only be used in type implementations. - a #GValue @@ -8783,7 +8462,6 @@ This macro should only be used in type implementations. of type @g_type. This macro should only be used in type implementations. - a #GValue @@ -8799,7 +8477,6 @@ The private structure must have been registered in the get_type() function with g_type_add_class_private(). This macro should only be used in type implementations. - the class of a type deriving from @private_type @@ -8814,14 +8491,12 @@ This macro should only be used in type implementations. A bit in the type number that's supposed to be left untouched. - Get the type identifier from a given @class structure. This macro should only be used in type implementations. - Location of a valid #GTypeClass structure @@ -8832,7 +8507,6 @@ This macro should only be used in type implementations. Get the type identifier from a given @instance structure. This macro should only be used in type implementations. - Location of a valid #GTypeInstance structure @@ -8843,7 +8517,6 @@ This macro should only be used in type implementations. Get the type identifier from a given @interface structure. This macro should only be used in type implementations. - Location of a valid #GTypeInterface structure @@ -8854,7 +8527,6 @@ This macro should only be used in type implementations. The fundamental type which is the ancestor of @type. Fundamental types are types that serve as ultimate bases for the derived types, thus they are the roots of distinct inheritance hierarchies. - A #GType value. @@ -8864,17 +8536,14 @@ thus they are the roots of distinct inheritance hierarchies. An integer constant that represents the number of identifiers reserved for types that are assigned at compile-time. - Shift value used in converting numbers to type IDs. - Checks if @type has a #GTypeValueTable. - A #GType value @@ -8889,7 +8558,6 @@ Note that while calling a GInstanceInitFunc(), the class pointer gets modified, so it might not always return the expected pointer. This macro should only be used in type implementations. - Location of the #GTypeInstance structure @@ -8906,7 +8574,6 @@ This macro should only be used in type implementations. Get the interface structure for interface @g_type of a given @instance. This macro should only be used in type implementations. - Location of the #GTypeInstance structure @@ -8927,7 +8594,6 @@ class_init function with g_type_class_add_private(). This macro should only be used in type implementations. Use %G_ADD_PRIVATE and the generated `your_type_get_instance_private()` function instead - the instance of a type deriving from @private_type @@ -8944,7 +8610,6 @@ This macro should only be used in type implementations. Checks if @type is an abstract type. An abstract type cannot be instantiated and is normally used as an abstract base class for derived classes. - A #GType value @@ -8952,7 +8617,6 @@ derived classes. - @@ -8960,7 +8624,6 @@ derived classes. Checks if @type is a classed type. - A #GType value @@ -8970,7 +8633,6 @@ derived classes. Checks if @type is a deep derivable type. A deep derivable type can be used as the base class of a deep (multi-level) class hierarchy. - A #GType value @@ -8980,7 +8642,6 @@ can be used as the base class of a deep (multi-level) class hierarchy. Checks if @type is a derivable type. A derivable type can be used as the base class of a flat (single-level) class hierarchy. - A #GType value @@ -8991,7 +8652,6 @@ be used as the base class of a flat (single-level) class hierarchy. Checks if @type is derived (or in object-oriented terminology: inherited) from another type (this holds true for all non-fundamental types). - A #GType value @@ -9000,7 +8660,6 @@ types). Checks whether @type "is a" %G_TYPE_ENUM. - a #GType ID. @@ -9009,7 +8668,6 @@ types). Checks whether @type "is a" %G_TYPE_FLAGS. - a #GType ID. @@ -9018,7 +8676,6 @@ types). Checks if @type is a fundamental type. - A #GType value @@ -9028,7 +8685,6 @@ types). Checks if @type can be instantiated. Instantiation is the process of creating an instance (object) of this type. - A #GType value @@ -9043,7 +8699,6 @@ to the interface). GLib interfaces are somewhat analogous to Java interfaces and C++ classes containing only pure virtual functions, with the difference that GType interfaces are not derivable (but see g_type_interface_add_prerequisite() for an alternative). - A #GType value @@ -9052,7 +8707,6 @@ g_type_interface_add_prerequisite() for an alternative). Check if the passed in type id is a %G_TYPE_OBJECT or derived from it. - Type id to check @@ -9061,7 +8715,6 @@ g_type_interface_add_prerequisite() for an alternative). Checks whether @type "is a" %G_TYPE_PARAM. - a #GType ID @@ -9072,7 +8725,6 @@ g_type_interface_add_prerequisite() for an alternative). Checks whether the passed in type ID can be used for g_value_init(). That is, this macro checks whether this type provides an implementation of the #GTypeValueTable functions required for a type to create a #GValue of. - A #GType value. @@ -9083,7 +8735,6 @@ of the #GTypeValueTable functions required for a type to create a #GValue of.Checks if @type is an abstract value type. An abstract value type introduces a value table, but can't be used for g_value_init() and is normally used as an abstract base type for derived value types. - A #GType value @@ -9092,7 +8743,6 @@ an abstract base type for derived value types. Checks if @type is a value type and can be used with g_value_init(). - A #GType value @@ -9103,7 +8753,6 @@ an abstract base type for derived value types. Get the type ID for the fundamental type number @x. Use g_type_fundamental_next() instead of this macro to create new fundamental types. - the fundamental type number. @@ -9111,42 +8760,36 @@ types. - - - - - - @@ -9155,35 +8798,29 @@ types. First fundamental type number to create a new fundamental type id with G_TYPE_MAKE_FUNDAMENTAL() reserved for BSE. - Last fundamental type number reserved for BSE. - First fundamental type number to create a new fundamental type id with G_TYPE_MAKE_FUNDAMENTAL() reserved for GLib. - Last fundamental type number reserved for GLib. - First available fundamental type number to create new fundamental type id with G_TYPE_MAKE_FUNDAMENTAL(). - A callback function used for notification when the state of a toggle reference changes. See g_object_add_toggle_ref(). - @@ -9205,12 +8842,9 @@ of a toggle reference changes. See g_object_add_toggle_ref(). - - - + An opaque structure used as the base of all classes. - @@ -9279,7 +8913,6 @@ my_object_get_some_field (MyObject *my_object) ]| Use the G_ADD_PRIVATE() macro with the `G_DEFINE_*` family of macros to add instance private data to a type - @@ -9304,7 +8937,6 @@ class in order to get the private data for the type represented by You can only call this function after you have registered a private data area for @g_class using g_type_class_add_private(). - the offset, in bytes @@ -9317,7 +8949,6 @@ data area for @g_class using g_type_class_add_private(). - @@ -9339,7 +8970,6 @@ class will always exist. This function is essentially equivalent to: g_type_class_peek (g_type_parent (G_TYPE_FROM_CLASS (g_class))) - the parent class of @g_class @@ -9358,7 +8988,6 @@ g_type_class_peek (g_type_parent (G_TYPE_FROM_CLASS (g_class))) Once the last reference count of a class has been released, classes may be finalized by the type system, so further dereferencing of a class pointer after g_type_class_unref() are invalid. - @@ -9374,7 +9003,6 @@ class pointer after g_type_class_unref() are invalid. implementations. It unreferences a class without consulting the chain of #GTypeClassCacheFuncs, avoiding the recursion which would occur otherwise. - @@ -9386,7 +9014,6 @@ otherwise. - @@ -9405,7 +9032,6 @@ except that the classes reference count isn't incremented. As a consequence, this function may return %NULL if the class of the type passed in does not currently exist (hasn't been referenced before). - the #GTypeClass structure for the given type ID or %NULL if the class does not @@ -9422,7 +9048,6 @@ referenced before). A more efficient version of g_type_class_peek() which works only for static types. - the #GTypeClass structure for the given type ID or %NULL if the class does not @@ -9440,7 +9065,6 @@ static types. Increments the reference count of the class structure belonging to @type. This function will demand-create the class if it doesn't exist already. - the #GTypeClass structure for the given type ID @@ -9464,7 +9088,6 @@ g_type_class_unref_uncached() instead. The functions have to check the class id passed in to figure whether they actually want to cache the class of this type, since all classes are routed through the same #GTypeClassCacheFunc chain. - %TRUE to stop further #GTypeClassCacheFuncs from being called, %FALSE to continue @@ -9489,7 +9112,6 @@ is now deprecated. If you need to enable debugging features, use the GOBJECT_DEBUG environment variable. g_type_init() is now done automatically - Print no messages @@ -9508,7 +9130,6 @@ environment variable. Bit masks used to check or determine characteristics of a type. - Indicates an abstract type. No instances can be created for an abstract type @@ -9522,7 +9143,6 @@ environment variable. Bit masks used to check or determine specific characteristics of a fundamental type. - Indicates a classed type @@ -9539,7 +9159,6 @@ fundamental type. A structure that provides information to the type system which is used specifically for managing fundamental types. - #GTypeFundamentalFlags describing the characteristics of the fundamental type @@ -9555,7 +9174,6 @@ The initialized structure is passed to the g_type_register_static() function g_type_plugin_complete_type_info()). The type system will perform a deep copy of this structure, so its memory does not need to be persistent across invocation of g_type_register_static(). - Size of the class structure (required for interface, classed and instantiatable types) @@ -9607,12 +9225,10 @@ across invocation of g_type_register_static(). An opaque structure used as the base of all type instances. - - @@ -9628,7 +9244,6 @@ across invocation of g_type_register_static(). An opaque structure used as the base of all interface types. - @@ -9640,7 +9255,6 @@ across invocation of g_type_register_static(). of the instance type to which @g_iface belongs. This is useful when deriving the implementation of an interface from the parent type and then possibly overriding some methods. - the corresponding #GTypeInterface structure of the parent type of the @@ -9661,7 +9275,6 @@ This means that any type implementing @interface_type must also implement @prerequisite_type. Prerequisites can be thought of as an alternative to interface derivation (which GType doesn't support). An interface can have at most one instantiatable prerequisite type. - @@ -9681,7 +9294,6 @@ at most one instantiatable prerequisite type. @interface_type which has been added to @instance_type, or %NULL if @interface_type has not been added to @instance_type or does not have a #GTypePlugin structure. See g_type_add_interface_dynamic(). - the #GTypePlugin for the dynamic interface @interface_type of @instance_type @@ -9701,7 +9313,6 @@ not have a #GTypePlugin structure. See g_type_add_interface_dynamic(). Returns the #GTypeInterface structure of an interface to which the passed in class conforms. - the #GTypeInterface structure of @iface_type if implemented by @instance_class, %NULL @@ -9721,7 +9332,6 @@ passed in class conforms. Returns the prerequisites of an interfaces type. - a newly-allocated zero-terminated array of #GType containing @@ -9746,7 +9356,6 @@ passed in class conforms. A callback called after an interface vtable is initialized. See g_type_add_interface_check(). - @@ -9789,10 +9398,8 @@ implementations it contains, g_type_module_unuse() is called. loading and unloading. To create a particular module type you must derive from #GTypeModule and implement the load and unload functions in #GTypeModuleClass. - - @@ -9803,7 +9410,6 @@ in #GTypeModuleClass. - @@ -9823,7 +9429,6 @@ not be unloaded. Since 2.56 if @module is %NULL this will call g_type_add_interface_static() instead. This can be used when making a static build of the module. - @@ -9857,7 +9462,6 @@ not be unloaded. Since 2.56 if @module is %NULL this will call g_type_register_static() instead. This can be used when making a static build of the module. - the new or existing type ID @@ -9891,7 +9495,6 @@ not be unloaded. Since 2.56 if @module is %NULL this will call g_type_register_static() instead. This can be used when making a static build of the module. - the new or existing type ID @@ -9929,7 +9532,6 @@ not be unloaded. Since 2.56 if @module is %NULL this will call g_type_register_static() instead. This can be used when making a static build of the module. - the new or existing type ID @@ -9959,7 +9561,6 @@ instead. This can be used when making a static build of the module. Sets the name for a #GTypeModule - @@ -9980,7 +9581,6 @@ result is zero, the module will be unloaded. (However, the #GTypeModule will not be freed, and types associated with the #GTypeModule are not unregistered. Once a #GTypeModule is initialized, it must exist forever.) - @@ -9996,7 +9596,6 @@ initialized, it must exist forever.) use count was zero before, the plugin will be loaded. If loading the plugin fails, the use count is reset to its prior value. - %FALSE if the plugin needed to be loaded and loading the plugin failed. @@ -10033,14 +9632,12 @@ its prior value. In order to implement dynamic loading of types based on #GTypeModule, the @load and @unload functions in #GTypeModuleClass must be implemented. - the parent class - @@ -10053,7 +9650,6 @@ the @load and @unload functions in #GTypeModuleClass must be implemented. - @@ -10066,7 +9662,6 @@ the @load and @unload functions in #GTypeModuleClass must be implemented. - @@ -10074,7 +9669,6 @@ the @load and @unload functions in #GTypeModuleClass must be implemented. - @@ -10082,7 +9676,6 @@ the @load and @unload functions in #GTypeModuleClass must be implemented. - @@ -10090,7 +9683,6 @@ the @load and @unload functions in #GTypeModuleClass must be implemented. - @@ -10149,7 +9741,6 @@ unloading. It even handles multiple registered types per module. Calls the @complete_interface_info function from the #GTypePluginClass of @plugin. There should be no need to use this function outside of the GObject type system itself. - @@ -10159,7 +9750,7 @@ function outside of the GObject type system itself. - the #GType of an instantiable type to which the interface + the #GType of an instantiatable type to which the interface is added @@ -10177,7 +9768,6 @@ function outside of the GObject type system itself. Calls the @complete_type_info function from the #GTypePluginClass of @plugin. There should be no need to use this function outside of the GObject type system itself. - @@ -10204,7 +9794,6 @@ type system itself. Calls the @unuse_plugin function from the #GTypePluginClass of @plugin. There should be no need to use this function outside of the GObject type system itself. - @@ -10219,7 +9808,6 @@ the GObject type system itself. Calls the @use_plugin function from the #GTypePluginClass of @plugin. There should be no need to use this function outside of the GObject type system itself. - @@ -10234,7 +9822,6 @@ the GObject type system itself. The #GTypePlugin interface is used by the type system in order to handle the lifecycle of dynamically loaded types. - @@ -10261,7 +9848,6 @@ the lifecycle of dynamically loaded types. The type of the @complete_interface_info function of #GTypePluginClass. - @@ -10287,7 +9873,6 @@ the lifecycle of dynamically loaded types. The type of the @complete_type_info function of #GTypePluginClass. - @@ -10312,7 +9897,6 @@ the lifecycle of dynamically loaded types. The type of the @unuse_plugin function of #GTypePluginClass. - @@ -10326,7 +9910,6 @@ the lifecycle of dynamically loaded types. The type of the @use_plugin function of #GTypePluginClass, which gets called to increase the use count of @plugin. - @@ -10340,7 +9923,6 @@ to increase the use count of @plugin. A structure holding information for a specific type. It is filled in by the g_type_query() function. - the #GType value of the type @@ -10361,10 +9943,8 @@ It is filled in by the g_type_query() function. The #GTypeValueTable provides the functions required by the #GValue implementation, to serve as a container for values of a type. - - @@ -10377,7 +9957,6 @@ implementation, to serve as a container for values of a type. - @@ -10390,7 +9969,6 @@ implementation, to serve as a container for values of a type. - @@ -10406,7 +9984,6 @@ implementation, to serve as a container for values of a type. - @@ -10434,7 +10011,6 @@ implementation, to serve as a container for values of a type. - @@ -10462,7 +10038,6 @@ implementation, to serve as a container for values of a type. - @@ -10488,7 +10063,6 @@ implementation, to serve as a container for values of a type. Note that this function should only be used from source code that implements or has internal knowledge of the implementation of @type. - location of the #GTypeValueTable associated with @type or %NULL if there is no #GTypeValueTable associated with @type @@ -10506,7 +10080,6 @@ that implements or has internal knowledge of the implementation of Checks if @value holds (or contains) a value of @type. This macro will also check for @value != %NULL and issue a warning if the check fails. - A #GValue structure. @@ -10518,7 +10091,6 @@ warning if the check fails. Checks whether the given #GValue can hold values of type %G_TYPE_BOOLEAN. - a valid #GValue structure @@ -10528,7 +10100,6 @@ warning if the check fails. Checks whether the given #GValue can hold values derived from type %G_TYPE_BOXED. - a valid #GValue structure @@ -10537,7 +10108,6 @@ from type %G_TYPE_BOXED. Checks whether the given #GValue can hold values of type %G_TYPE_CHAR. - a valid #GValue structure @@ -10546,7 +10116,6 @@ from type %G_TYPE_BOXED. Checks whether the given #GValue can hold values of type %G_TYPE_DOUBLE. - a valid #GValue structure @@ -10555,7 +10124,6 @@ from type %G_TYPE_BOXED. Checks whether the given #GValue can hold values derived from type %G_TYPE_ENUM. - a valid #GValue structure @@ -10564,7 +10132,6 @@ from type %G_TYPE_BOXED. Checks whether the given #GValue can hold values derived from type %G_TYPE_FLAGS. - a valid #GValue structure @@ -10573,7 +10140,6 @@ from type %G_TYPE_BOXED. Checks whether the given #GValue can hold values of type %G_TYPE_FLOAT. - a valid #GValue structure @@ -10582,7 +10148,6 @@ from type %G_TYPE_BOXED. Checks whether the given #GValue can hold values of type %G_TYPE_GTYPE. - a valid #GValue structure @@ -10591,7 +10156,6 @@ from type %G_TYPE_BOXED. Checks whether the given #GValue can hold values of type %G_TYPE_INT. - a valid #GValue structure @@ -10600,7 +10164,6 @@ from type %G_TYPE_BOXED. Checks whether the given #GValue can hold values of type %G_TYPE_INT64. - a valid #GValue structure @@ -10609,7 +10172,6 @@ from type %G_TYPE_BOXED. Checks whether the given #GValue can hold values of type %G_TYPE_LONG. - a valid #GValue structure @@ -10618,7 +10180,6 @@ from type %G_TYPE_BOXED. Checks whether the given #GValue can hold values derived from type %G_TYPE_OBJECT. - a valid #GValue structure @@ -10627,7 +10188,6 @@ from type %G_TYPE_BOXED. Checks whether the given #GValue can hold values derived from type %G_TYPE_PARAM. - a valid #GValue structure @@ -10636,7 +10196,6 @@ from type %G_TYPE_BOXED. Checks whether the given #GValue can hold values of type %G_TYPE_POINTER. - a valid #GValue structure @@ -10645,7 +10204,6 @@ from type %G_TYPE_BOXED. Checks whether the given #GValue can hold values of type %G_TYPE_STRING. - a valid #GValue structure @@ -10654,7 +10212,6 @@ from type %G_TYPE_BOXED. Checks whether the given #GValue can hold values of type %G_TYPE_UCHAR. - a valid #GValue structure @@ -10663,7 +10220,6 @@ from type %G_TYPE_BOXED. Checks whether the given #GValue can hold values of type %G_TYPE_UINT. - a valid #GValue structure @@ -10672,7 +10228,6 @@ from type %G_TYPE_BOXED. Checks whether the given #GValue can hold values of type %G_TYPE_UINT64. - a valid #GValue structure @@ -10681,7 +10236,6 @@ from type %G_TYPE_BOXED. Checks whether the given #GValue can hold values of type %G_TYPE_ULONG. - a valid #GValue structure @@ -10690,7 +10244,6 @@ from type %G_TYPE_BOXED. Checks whether the given #GValue can hold values of type %G_TYPE_VARIANT. - a valid #GValue structure @@ -10700,12 +10253,10 @@ from type %G_TYPE_BOXED. For string values, indicates that the string contained is canonical and will exist for the duration of the process. See g_value_set_interned_string(). - Checks whether @value contains a string which is canonical. - a valid #GValue structure @@ -10717,12 +10268,10 @@ exist for the duration of the process. See g_value_set_interned_string(). but used verbatim. This does not affect ref-counted types like objects. This does not affect usage of g_value_copy(), the data will be copied if it is not ref-counted. - Get the type identifier of @value. - A #GValue structure. @@ -10731,7 +10280,6 @@ be copied if it is not ref-counted. Gets the type name of @value. - A #GValue structure. @@ -10742,7 +10290,6 @@ be copied if it is not ref-counted. This is the signature of va_list marshaller functions, an optional marshaller that can be used in some situations to avoid marshalling the signal argument into GValues. - @@ -10794,7 +10341,6 @@ types. #GValue users cannot make any assumptions about how data is stored within the 2 element @data union, and the @g_type member should only be accessed through the G_VALUE_TYPE() macro. - @@ -10805,7 +10351,6 @@ only be accessed through the G_VALUE_TYPE() macro. Copies the value of @src_value into @dest_value. - @@ -10825,7 +10370,6 @@ only be accessed through the G_VALUE_TYPE() macro. the boxed value is duplicated and needs to be later freed with g_boxed_free(), e.g. like: g_boxed_free (G_VALUE_TYPE (@value), return_value); - boxed contents of @value @@ -10841,7 +10385,6 @@ return_value); Get the contents of a %G_TYPE_OBJECT derived #GValue, increasing its reference count. If the contents of the #GValue are %NULL, then %NULL will be returned. - object content of @value, should be unreferenced when no longer needed. @@ -10857,10 +10400,9 @@ its reference count. If the contents of the #GValue are %NULL, then Get the contents of a %G_TYPE_PARAM #GValue, increasing its reference count. - - - #GParamSpec content of @value, should be unreferenced when - no longer needed. + + #GParamSpec content of @value, should be + unreferenced when no longer needed. @@ -10872,7 +10414,6 @@ reference count. Get a copy the contents of a %G_TYPE_STRING #GValue. - a newly allocated copy of the string content of @value @@ -10887,7 +10428,6 @@ reference count. Get the contents of a variant #GValue, increasing its refcount. The returned #GVariant is never floating. - variant contents of @value (may be %NULL); should be unreffed using g_variant_unref() when no longer needed @@ -10903,7 +10443,6 @@ reference count. Determines if @value will fit inside the size of a pointer value. This is an internal function introduced mainly for C marshallers. - %TRUE if @value will fit inside a pointer value. @@ -10917,7 +10456,6 @@ This is an internal function introduced mainly for C marshallers. Get the contents of a %G_TYPE_BOOLEAN #GValue. - boolean contents of @value @@ -10931,7 +10469,6 @@ This is an internal function introduced mainly for C marshallers. Get the contents of a %G_TYPE_BOXED derived #GValue. - boxed contents of @value @@ -10949,7 +10486,6 @@ type is unsigned, such as ARM and PowerPC. See g_value_get_schar(). Get the contents of a %G_TYPE_CHAR #GValue. This function's return type is broken, see g_value_get_schar() - character contents of @value @@ -10963,7 +10499,6 @@ Get the contents of a %G_TYPE_CHAR #GValue. Get the contents of a %G_TYPE_DOUBLE #GValue. - double contents of @value @@ -10977,7 +10512,6 @@ Get the contents of a %G_TYPE_CHAR #GValue. Get the contents of a %G_TYPE_ENUM #GValue. - enum contents of @value @@ -10991,7 +10525,6 @@ Get the contents of a %G_TYPE_CHAR #GValue. Get the contents of a %G_TYPE_FLAGS #GValue. - flags contents of @value @@ -11005,7 +10538,6 @@ Get the contents of a %G_TYPE_CHAR #GValue. Get the contents of a %G_TYPE_FLOAT #GValue. - float contents of @value @@ -11019,7 +10551,6 @@ Get the contents of a %G_TYPE_CHAR #GValue. Get the contents of a %G_TYPE_GTYPE #GValue. - the #GType stored in @value @@ -11033,7 +10564,6 @@ Get the contents of a %G_TYPE_CHAR #GValue. Get the contents of a %G_TYPE_INT #GValue. - integer contents of @value @@ -11047,7 +10577,6 @@ Get the contents of a %G_TYPE_CHAR #GValue. Get the contents of a %G_TYPE_INT64 #GValue. - 64bit integer contents of @value @@ -11061,7 +10590,6 @@ Get the contents of a %G_TYPE_CHAR #GValue. Get the contents of a %G_TYPE_LONG #GValue. - long integer contents of @value @@ -11075,7 +10603,6 @@ Get the contents of a %G_TYPE_CHAR #GValue. Get the contents of a %G_TYPE_OBJECT derived #GValue. - object contents of @value @@ -11089,7 +10616,6 @@ Get the contents of a %G_TYPE_CHAR #GValue. Get the contents of a %G_TYPE_PARAM #GValue. - #GParamSpec content of @value @@ -11103,7 +10629,6 @@ Get the contents of a %G_TYPE_CHAR #GValue. Get the contents of a pointer #GValue. - pointer contents of @value @@ -11117,7 +10642,6 @@ Get the contents of a %G_TYPE_CHAR #GValue. Get the contents of a %G_TYPE_CHAR #GValue. - signed 8 bit integer contents of @value @@ -11131,7 +10655,6 @@ Get the contents of a %G_TYPE_CHAR #GValue. Get the contents of a %G_TYPE_STRING #GValue. - string content of @value @@ -11145,7 +10668,6 @@ Get the contents of a %G_TYPE_CHAR #GValue. Get the contents of a %G_TYPE_UCHAR #GValue. - unsigned character contents of @value @@ -11159,7 +10681,6 @@ Get the contents of a %G_TYPE_CHAR #GValue. Get the contents of a %G_TYPE_UINT #GValue. - unsigned integer contents of @value @@ -11173,7 +10694,6 @@ Get the contents of a %G_TYPE_CHAR #GValue. Get the contents of a %G_TYPE_UINT64 #GValue. - unsigned 64bit integer contents of @value @@ -11187,7 +10707,6 @@ Get the contents of a %G_TYPE_CHAR #GValue. Get the contents of a %G_TYPE_ULONG #GValue. - unsigned long integer contents of @value @@ -11201,7 +10720,6 @@ Get the contents of a %G_TYPE_CHAR #GValue. Get the contents of a variant #GValue. - variant contents of @value (may be %NULL) @@ -11215,7 +10733,6 @@ Get the contents of a %G_TYPE_CHAR #GValue. Initializes @value with the default value of @type. - the #GValue structure that has been passed in @@ -11239,7 +10756,6 @@ Note: The @value will be initialised with the exact type of @instance. If you wish to set the @value's type to a different GType (such as a parent class GType), you need to manually call g_value_init() and g_value_set_instance(). - @@ -11258,7 +10774,6 @@ g_value_init() and g_value_set_instance(). Returns the value contents as pointer. This function asserts that g_value_fits_pointer() returned %TRUE for the passed in value. This is an internal function introduced mainly for C marshallers. - the value contents as pointer @@ -11273,7 +10788,6 @@ This is an internal function introduced mainly for C marshallers. Clears the current value in @value and resets it to the default value (as if the value had just been initialized). - the #GValue structure that has been passed in @@ -11287,7 +10801,6 @@ This is an internal function introduced mainly for C marshallers. Set the contents of a %G_TYPE_BOOLEAN #GValue to @v_boolean. - @@ -11304,7 +10817,6 @@ This is an internal function introduced mainly for C marshallers. Set the contents of a %G_TYPE_BOXED derived #GValue to @v_boxed. - @@ -11322,7 +10834,6 @@ This is an internal function introduced mainly for C marshallers. This is an internal function introduced mainly for C marshallers. Use g_value_take_boxed() instead. - @@ -11340,7 +10851,6 @@ This is an internal function introduced mainly for C marshallers. Set the contents of a %G_TYPE_CHAR #GValue to @v_char. This function's input type is broken, see g_value_set_schar() - @@ -11357,7 +10867,6 @@ This is an internal function introduced mainly for C marshallers. Set the contents of a %G_TYPE_DOUBLE #GValue to @v_double. - @@ -11374,7 +10883,6 @@ This is an internal function introduced mainly for C marshallers. Set the contents of a %G_TYPE_ENUM #GValue to @v_enum. - @@ -11391,7 +10899,6 @@ This is an internal function introduced mainly for C marshallers. Set the contents of a %G_TYPE_FLAGS #GValue to @v_flags. - @@ -11408,7 +10915,6 @@ This is an internal function introduced mainly for C marshallers. Set the contents of a %G_TYPE_FLOAT #GValue to @v_float. - @@ -11425,7 +10931,6 @@ This is an internal function introduced mainly for C marshallers. Set the contents of a %G_TYPE_GTYPE #GValue to @v_gtype. - @@ -11443,7 +10948,6 @@ This is an internal function introduced mainly for C marshallers. Sets @value from an instantiatable type via the value_table's collect_value() function. - @@ -11460,7 +10964,6 @@ value_table's collect_value() function. Set the contents of a %G_TYPE_INT #GValue to @v_int. - @@ -11477,7 +10980,6 @@ value_table's collect_value() function. Set the contents of a %G_TYPE_INT64 #GValue to @v_int64. - @@ -11496,7 +10998,6 @@ value_table's collect_value() function. Set the contents of a %G_TYPE_STRING #GValue to @v_string. The string is assumed to be static and interned (canonical, for example from g_intern_string()), and is thus not duplicated when setting the #GValue. - @@ -11513,7 +11014,6 @@ g_intern_string()), and is thus not duplicated when setting the #GValue. Set the contents of a %G_TYPE_LONG #GValue to @v_long. - @@ -11540,7 +11040,6 @@ need it), use g_value_take_object() instead. It is important that your #GValue holds a reference to @v_object (either its own, or one it has taken) to ensure that the object won't be destroyed while the #GValue still exists). - @@ -11558,7 +11057,6 @@ the #GValue still exists). This is an internal function introduced mainly for C marshallers. Use g_value_take_object() instead. - @@ -11575,7 +11073,6 @@ the #GValue still exists). Set the contents of a %G_TYPE_PARAM #GValue to @param. - @@ -11593,7 +11090,6 @@ the #GValue still exists). This is an internal function introduced mainly for C marshallers. Use g_value_take_param() instead. - @@ -11610,7 +11106,6 @@ the #GValue still exists). Set the contents of a pointer #GValue to @v_pointer. - @@ -11627,7 +11122,6 @@ the #GValue still exists). Set the contents of a %G_TYPE_CHAR #GValue to @v_char. - @@ -11646,7 +11140,6 @@ the #GValue still exists). Set the contents of a %G_TYPE_BOXED derived #GValue to @v_boxed. The boxed value is assumed to be static, and is thus not duplicated when setting the #GValue. - @@ -11668,7 +11161,6 @@ when setting the #GValue. If the the string is a canonical string, using g_value_set_interned_string() is more appropriate. - @@ -11685,7 +11177,6 @@ is more appropriate. Set the contents of a %G_TYPE_STRING #GValue to @v_string. - @@ -11703,7 +11194,6 @@ is more appropriate. This is an internal function introduced mainly for C marshallers. Use g_value_take_string() instead. - @@ -11720,7 +11210,6 @@ is more appropriate. Set the contents of a %G_TYPE_UCHAR #GValue to @v_uchar. - @@ -11737,7 +11226,6 @@ is more appropriate. Set the contents of a %G_TYPE_UINT #GValue to @v_uint. - @@ -11754,7 +11242,6 @@ is more appropriate. Set the contents of a %G_TYPE_UINT64 #GValue to @v_uint64. - @@ -11771,7 +11258,6 @@ is more appropriate. Set the contents of a %G_TYPE_ULONG #GValue to @v_ulong. - @@ -11789,7 +11275,6 @@ is more appropriate. Set the contents of a variant #GValue to @variant. If the variant is floating, it is consumed. - @@ -11808,7 +11293,6 @@ If the variant is floating, it is consumed. Sets the contents of a %G_TYPE_BOXED derived #GValue to @v_boxed and takes over the ownership of the caller’s reference to @v_boxed; the caller doesn’t have to unref it any more. - @@ -11831,7 +11315,6 @@ count of the object is not increased). If you want the #GValue to hold its own reference to @v_object, use g_value_set_object() instead. - @@ -11850,7 +11333,6 @@ g_value_set_object() instead. Sets the contents of a %G_TYPE_PARAM #GValue to @param and takes over the ownership of the caller’s reference to @param; the caller doesn’t have to unref it any more. - @@ -11867,7 +11349,6 @@ doesn’t have to unref it any more. Sets the contents of a %G_TYPE_STRING #GValue to @v_string. - @@ -11895,7 +11376,6 @@ If you want the #GValue to hold its own reference to @variant, use g_value_set_variant() instead. This is an internal function introduced mainly for C marshallers. - @@ -11918,7 +11398,6 @@ value types might incur precision lossage. Especially transformations into strings might reveal seemingly arbitrary results and shouldn't be relied upon for production code (such as rcfile value or object property serialization). - Whether a transformation rule was found and could be applied. Upon failing transformations, @dest_value is left untouched. @@ -11940,7 +11419,6 @@ as rcfile value or object property serialization). this releases all resources associated with this GValue. An unset value is the same as an uninitialized (zero-filled) #GValue structure. - @@ -11955,7 +11433,6 @@ structure. Registers a value transformation function for use in g_value_transform(). A previously registered transformation function for @src_type and @dest_type will be replaced. - @@ -11978,7 +11455,6 @@ will be replaced. Returns whether a #GValue of type @src_type can be copied into a #GValue of type @dest_type. - %TRUE if g_value_copy() is possible with @src_type and @dest_type. @@ -11999,7 +11475,6 @@ a #GValue of type @dest_type. of type @src_type into values of type @dest_type. Note that for the types to be transformable, they must be compatible or a transformation function must be registered. - %TRUE if the transformation is possible, %FALSE otherwise. @@ -12018,7 +11493,6 @@ transformation function must be registered. A #GValueArray contains an array of #GValue elements. - number of values contained in the array @@ -12035,7 +11509,6 @@ transformation function must be registered. for @n_prealloced elements. New arrays always contain 0 elements, regardless of the value of @n_prealloced. Use #GArray and g_array_sized_new() instead. - a newly allocated #GValueArray with 0 values @@ -12051,7 +11524,6 @@ regardless of the value of @n_prealloced. Insert a copy of @value as last element of @value_array. If @value is %NULL, an uninitialized value is appended. Use #GArray and g_array_append_val() instead. - the #GValueArray passed in as @value_array @@ -12071,7 +11543,6 @@ regardless of the value of @n_prealloced. Construct an exact copy of a #GValueArray by duplicating all its contents. Use #GArray and g_array_ref() instead. - Newly allocated copy of #GValueArray @@ -12086,7 +11557,6 @@ contents. Free a #GValueArray including its contents. Use #GArray and g_array_unref() instead. - @@ -12100,7 +11570,6 @@ contents. Return a pointer to the value at @index_ containd in @value_array. Use g_array_index() instead. - pointer to a value at @index_ in @value_array @@ -12120,7 +11589,6 @@ contents. Insert a copy of @value at specified position into @value_array. If @value is %NULL, an uninitialized value is inserted. Use #GArray and g_array_insert_val() instead. - the #GValueArray passed in as @value_array @@ -12144,7 +11612,6 @@ is %NULL, an uninitialized value is inserted. Insert a copy of @value as first element of @value_array. If @value is %NULL, an uninitialized value is prepended. Use #GArray and g_array_prepend_val() instead. - the #GValueArray passed in as @value_array @@ -12163,7 +11630,6 @@ is %NULL, an uninitialized value is inserted. Remove the value at position @index_ from @value_array. Use #GArray and g_array_remove_index() instead. - the #GValueArray passed in as @value_array @@ -12187,7 +11653,6 @@ the semantics of #GCompareFunc. The current implementation uses the same sorting algorithm as standard C qsort() function. Use #GArray and g_array_sort(). - the #GValueArray passed in as @value_array @@ -12210,7 +11675,6 @@ to the semantics of #GCompareDataFunc. The current implementation uses the same sorting algorithm as standard C qsort() function. Use #GArray and g_array_sort_with_data(). - the #GValueArray passed in as @value_array @@ -12236,7 +11700,6 @@ C qsort() function. g_value_register_transform_func(). @dest_value will be initialized to the correct destination type. - @@ -12256,7 +11719,6 @@ g_value_register_transform_func(). triggered when the object is finalized. Since the object is already being finalized when the #GWeakNotify is called, there's not much you could do with the object, apart from e.g. using its address as hash-index or the like. - @@ -12292,9 +11754,7 @@ before it was disposed will continue to point to %NULL. If #GWeakRefs are taken after the object is disposed and re-referenced, they will continue to point to it until its refcount goes back to zero, at which point they too will be invalidated. - - @@ -12305,7 +11765,6 @@ After this call, the #GWeakRef is left in an undefined state. You should only call this on a #GWeakRef that previously had g_weak_ref_init() called on it. - @@ -12327,7 +11786,6 @@ its last reference at the same time in a different thread. The caller should release the resulting reference in the usual way, by using g_object_unref(). - the object pointed to by @weak_ref, or %NULL if it was empty @@ -12350,7 +11808,6 @@ This function should always be matched with a call to g_weak_ref_clear(). It is not necessary to use this function for a #GWeakRef in static storage because it will already be properly initialised. Just use g_weak_ref_set() directly. - @@ -12372,7 +11829,6 @@ properly initialised. Just use g_weak_ref_set() directly. You must own a strong reference on @object while calling this function. - @@ -12426,7 +11882,6 @@ If assertions are disabled via `G_DISABLE_ASSERT`, this macro just calls g_object_unref() without any further checks. This macro should only be used in regression tests. - an object @@ -12435,7 +11890,6 @@ This macro should only be used in regression tests. Provide a copy of a boxed structure @src_boxed which is of type @boxed_type. - The newly created copy of the boxed structure. @@ -12454,7 +11908,6 @@ This macro should only be used in regression tests. Free the boxed structure @boxed which is of type @boxed_type. - @@ -12473,7 +11926,6 @@ This macro should only be used in regression tests. This function creates a new %G_TYPE_BOXED derived type id for a new boxed type with name @name. Boxed type handling functions have to be provided to copy and free opaque boxed structures of this type. - New %G_TYPE_BOXED derived type id for @name. @@ -12498,7 +11950,6 @@ provided to copy and free opaque boxed structures of this type. 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(). - @@ -12538,7 +11989,6 @@ accumulator, such as g_signal_accumulator_true_handled(). A marshaller for a #GCClosure with a callback of type `gboolean (*callback) (gpointer instance, gint arg1, gpointer user_data)` where the #gint parameter denotes a flags type. - @@ -12573,7 +12023,6 @@ denotes a flags type. A marshaller for a #GCClosure with a callback of type `gchar* (*callback) (gpointer instance, GObject *arg1, gpointer arg2, gpointer user_data)`. - @@ -12608,7 +12057,6 @@ denotes a flags type. A marshaller for a #GCClosure with a callback of type `void (*callback) (gpointer instance, gboolean arg1, gpointer user_data)`. - @@ -12643,7 +12091,6 @@ denotes a flags type. A marshaller for a #GCClosure with a callback of type `void (*callback) (gpointer instance, GBoxed *arg1, gpointer user_data)`. - @@ -12678,7 +12125,6 @@ denotes a flags type. A marshaller for a #GCClosure with a callback of type `void (*callback) (gpointer instance, gchar arg1, gpointer user_data)`. - @@ -12713,7 +12159,6 @@ denotes a flags type. A marshaller for a #GCClosure with a callback of type `void (*callback) (gpointer instance, gdouble arg1, gpointer user_data)`. - @@ -12748,7 +12193,6 @@ denotes a flags type. A marshaller for a #GCClosure with a callback of type `void (*callback) (gpointer instance, gint arg1, gpointer user_data)` where the #gint parameter denotes an enumeration type.. - @@ -12783,7 +12227,6 @@ denotes a flags type. A marshaller for a #GCClosure with a callback of type `void (*callback) (gpointer instance, gint arg1, gpointer user_data)` where the #gint parameter denotes a flags type. - @@ -12818,7 +12261,6 @@ denotes a flags type. A marshaller for a #GCClosure with a callback of type `void (*callback) (gpointer instance, gfloat arg1, gpointer user_data)`. - @@ -12853,7 +12295,6 @@ denotes a flags type. A marshaller for a #GCClosure with a callback of type `void (*callback) (gpointer instance, gint arg1, gpointer user_data)`. - @@ -12888,7 +12329,6 @@ denotes a flags type. A marshaller for a #GCClosure with a callback of type `void (*callback) (gpointer instance, glong arg1, gpointer user_data)`. - @@ -12923,7 +12363,6 @@ denotes a flags type. A marshaller for a #GCClosure with a callback of type `void (*callback) (gpointer instance, GObject *arg1, gpointer user_data)`. - @@ -12958,7 +12397,6 @@ denotes a flags type. A marshaller for a #GCClosure with a callback of type `void (*callback) (gpointer instance, GParamSpec *arg1, gpointer user_data)`. - @@ -12993,7 +12431,6 @@ denotes a flags type. A marshaller for a #GCClosure with a callback of type `void (*callback) (gpointer instance, gpointer arg1, gpointer user_data)`. - @@ -13028,7 +12465,6 @@ denotes a flags type. A marshaller for a #GCClosure with a callback of type `void (*callback) (gpointer instance, const gchar *arg1, gpointer user_data)`. - @@ -13063,7 +12499,6 @@ denotes a flags type. A marshaller for a #GCClosure with a callback of type `void (*callback) (gpointer instance, guchar arg1, gpointer user_data)`. - @@ -13098,7 +12533,6 @@ denotes a flags type. A marshaller for a #GCClosure with a callback of type `void (*callback) (gpointer instance, guint arg1, gpointer user_data)`. - @@ -13133,7 +12567,6 @@ denotes a flags type. A marshaller for a #GCClosure with a callback of type `void (*callback) (gpointer instance, guint arg1, gpointer arg2, gpointer user_data)`. - @@ -13168,7 +12601,6 @@ denotes a flags type. A marshaller for a #GCClosure with a callback of type `void (*callback) (gpointer instance, gulong arg1, gpointer user_data)`. - @@ -13203,7 +12635,6 @@ denotes a flags type. A marshaller for a #GCClosure with a callback of type `void (*callback) (gpointer instance, GVariant *arg1, gpointer user_data)`. - @@ -13238,7 +12669,6 @@ denotes a flags type. A marshaller for a #GCClosure with a callback of type `void (*callback) (gpointer instance, gpointer user_data)`. - @@ -13276,7 +12706,6 @@ denotes a flags type. Normally this function is not passed explicitly to g_signal_new(), but used automatically by GLib when specifying a %NULL marshaller. - @@ -13317,7 +12746,6 @@ but used automatically by GLib when specifying a %NULL marshaller. the last parameter. @destroy_data will be called as a finalize notifier on the #GClosure. - a floating reference to a new #GCClosure @@ -13343,7 +12771,6 @@ calls g_object_watch_closure() on @object and the created closure. This function is useful when you have a callback closely associated with a #GObject, and want the callback to no longer run after the object is is freed. - a new #GCClosure @@ -13365,7 +12792,6 @@ and calls g_object_watch_closure() on @object and the created closure. This function is useful when you have a callback closely associated with a #GObject, and want the callback to no longer run after the object is is freed. - a new #GCClosure @@ -13386,7 +12812,6 @@ after the object is is freed. the first parameter. @destroy_data will be called as a finalize notifier on the #GClosure. - a floating reference to a new #GCClosure @@ -13417,7 +12842,6 @@ pointer is set to %NULL. A macro is also included that allows this function to be used without pointer casts. - @@ -13435,9 +12859,8 @@ connected to. The @handler_id_ptr is then set to zero, which is never a valid ha If the handler ID is 0 then this function does nothing. -A macro is also included that allows this function to be used without -pointer casts. - +There is also a macro version of this function so that the code +will be inlined. @@ -13447,7 +12870,8 @@ pointer casts. - The instance to remove the signal handler from. + The instance to remove the signal handler from. + This pointer may be %NULL or invalid, if the handler ID is zero. @@ -13464,7 +12888,6 @@ and the pointer is set to %NULL. A macro is also included that allows this function to be used without pointer casts. The function itself is static inline, so its address may vary between compilation units. - The memory address of a pointer @@ -13492,7 +12915,6 @@ my_enum_complete_type_info (GTypePlugin *plugin, g_enum_complete_type_info (type, info, values); } ]| - @@ -13515,8 +12937,7 @@ my_enum_complete_type_info (GTypePlugin *plugin, Returns the #GEnumValue for a value. - - + the #GEnumValue for @value, or %NULL if @value is not a member of the enumeration @@ -13534,8 +12955,7 @@ my_enum_complete_type_info (GTypePlugin *plugin, Looks up a #GEnumValue by name. - - + the #GEnumValue with name @name, or %NULL if the enumeration doesn't have a member with that name @@ -13554,8 +12974,7 @@ my_enum_complete_type_info (GTypePlugin *plugin, Looks up a #GEnumValue by nickname. - - + the #GEnumValue with nickname @nick, or %NULL if the enumeration doesn't have a member with that nickname @@ -13578,7 +12997,6 @@ my_enum_complete_type_info (GTypePlugin *plugin, It is normally more convenient to let [glib-mkenums][glib-mkenums], generate a my_enum_get_type() function from a usual C enumeration definition than to write one yourself using g_enum_register_static(). - The new type identifier. @@ -13602,7 +13020,6 @@ definition than to write one yourself using g_enum_register_static(). This is intended to be used for debugging purposes. The format of the output may change in the future. - a newly-allocated text string @@ -13651,7 +13068,6 @@ g_type_class_unref (enum_class); This function is meant to be called from the complete_type_info() function of a #GTypePlugin implementation, see the example for g_enum_complete_type_info() above. - @@ -13674,8 +13090,7 @@ g_enum_complete_type_info() above. Returns the first #GFlagsValue which is set in @value. - - + the first #GFlagsValue which is set in @value, or %NULL if none is set @@ -13693,8 +13108,7 @@ g_enum_complete_type_info() above. Looks up a #GFlagsValue by name. - - + the #GFlagsValue with name @name, or %NULL if there is no flag with that name @@ -13712,8 +13126,7 @@ g_enum_complete_type_info() above. Looks up a #GFlagsValue by nickname. - - + the #GFlagsValue with nickname @nick, or %NULL if there is no flag with that nickname @@ -13735,7 +13148,6 @@ g_enum_complete_type_info() above. It is normally more convenient to let [glib-mkenums][glib-mkenums] generate a my_flags_get_type() function from a usual C enumeration definition than to write one yourself using g_flags_register_static(). - The new type identifier. @@ -13759,7 +13171,6 @@ sorted. Any extra bits will be shown at the end as a hexadecimal number. This is intended to be used for debugging purposes. The format of the output may change in the future. - a newly-allocated text string @@ -13906,7 +13317,6 @@ character must be a letter (a–z or A–Z) or an underscore (‘ characters can be letters, numbers or any of ‘-_+’. - @@ -13921,8 +13331,8 @@ support. Signals are described in detail [here][gobject-Signals]. For a tutorial on implementing a new GObject class, see [How to define and implement a new GObject][howto-gobject]. For a list of naming conventions for GObjects and their methods, see the [GType conventions][gtype-conventions]. -For the high-level concepts behind GObject, read [Instantiable classed types: -Objects][gtype-instantiable-classed]. +For the high-level concepts behind GObject, read [Instantiatable classed types: +Objects][gtype-instantiatable-classed]. ## Floating references # {#floating-ref} @@ -14008,7 +13418,6 @@ values, and to allow for more values to be added in future without breaking API. See g_param_spec_internal() for details on property names. - a newly created parameter specification @@ -14041,7 +13450,6 @@ See g_param_spec_internal() for details on property names. derived property. See g_param_spec_internal() for details on property names. - a newly created parameter specification @@ -14071,7 +13479,6 @@ See g_param_spec_internal() for details on property names. Creates a new #GParamSpecChar instance specifying a %G_TYPE_CHAR property. - a newly created parameter specification @@ -14112,7 +13519,6 @@ See g_param_spec_internal() for details on property names. property. See g_param_spec_internal() for details on property names. - a newly created parameter specification @@ -14153,7 +13559,6 @@ See g_param_spec_internal() for details on property names. property. See g_param_spec_internal() for details on property names. - a newly created parameter specification @@ -14190,7 +13595,6 @@ See g_param_spec_internal() for details on property names. property. See g_param_spec_internal() for details on property names. - a newly created parameter specification @@ -14226,7 +13630,6 @@ See g_param_spec_internal() for details on property names. Creates a new #GParamSpecFloat instance specifying a %G_TYPE_FLOAT property. See g_param_spec_internal() for details on property names. - a newly created parameter specification @@ -14267,7 +13670,6 @@ See g_param_spec_internal() for details on property names. %G_TYPE_GTYPE property. See g_param_spec_internal() for details on property names. - a newly created parameter specification @@ -14300,7 +13702,6 @@ See g_param_spec_internal() for details on property names. Creates a new #GParamSpecInt instance specifying a %G_TYPE_INT property. See g_param_spec_internal() for details on property names. - a newly created parameter specification @@ -14340,7 +13741,6 @@ See g_param_spec_internal() for details on property names. Creates a new #GParamSpecInt64 instance specifying a %G_TYPE_INT64 property. See g_param_spec_internal() for details on property names. - a newly created parameter specification @@ -14380,7 +13780,6 @@ See g_param_spec_internal() for details on property names. Creates a new #GParamSpecLong instance specifying a %G_TYPE_LONG property. See g_param_spec_internal() for details on property names. - a newly created parameter specification @@ -14421,7 +13820,6 @@ See g_param_spec_internal() for details on property names. derived property. See g_param_spec_internal() for details on property names. - a newly created parameter specification @@ -14453,7 +13851,6 @@ See g_param_spec_internal() for details on property names. Creates a new property of type #GParamSpecOverride. This is used to direct operations to another paramspec, and will not be directly useful unless you are implementing a new base type similar to GObject. - the newly created #GParamSpec @@ -14474,7 +13871,6 @@ useful unless you are implementing a new base type similar to GObject. property. See g_param_spec_internal() for details on property names. - a newly created parameter specification @@ -14508,7 +13904,6 @@ Where possible, it is better to use g_param_spec_object() or g_param_spec_boxed() to expose memory management information. See g_param_spec_internal() for details on property names. - a newly created parameter specification @@ -14532,30 +13927,10 @@ See g_param_spec_internal() for details on property names. - - Creates a new #GParamSpecPool. - -If @type_prefixing is %TRUE, lookups in the newly created pool will -allow to specify the owner as a colon-separated prefix of the -property name, like "GtkContainer:border-width". This feature is -deprecated, so you should always set @type_prefixing to %FALSE. - - - a newly allocated #GParamSpecPool. - - - - - Whether the pool will support type-prefixed property names. - - - - Creates a new #GParamSpecString instance. See g_param_spec_internal() for details on property names. - a newly created parameter specification @@ -14585,7 +13960,6 @@ See g_param_spec_internal() for details on property names. Creates a new #GParamSpecUChar instance specifying a %G_TYPE_UCHAR property. - a newly created parameter specification @@ -14625,7 +13999,6 @@ See g_param_spec_internal() for details on property names. Creates a new #GParamSpecUInt instance specifying a %G_TYPE_UINT property. See g_param_spec_internal() for details on property names. - a newly created parameter specification @@ -14666,7 +14039,6 @@ See g_param_spec_internal() for details on property names. property. See g_param_spec_internal() for details on property names. - a newly created parameter specification @@ -14707,7 +14079,6 @@ See g_param_spec_internal() for details on property names. property. See g_param_spec_internal() for details on property names. - a newly created parameter specification @@ -14749,7 +14120,6 @@ property. #GValue structures for this property can be accessed with g_value_set_uint() and g_value_get_uint(). See g_param_spec_internal() for details on property names. - a newly created parameter specification @@ -14784,7 +14154,6 @@ See g_param_spec_internal() for details on property names. can be accessed with g_value_set_boxed() and g_value_get_boxed(). See g_param_spec_internal() for details on property names. - a newly created parameter specification @@ -14820,7 +14189,6 @@ property. If @default_value is floating, it is consumed. See g_param_spec_internal() for details on property names. - the newly created #GParamSpec @@ -14858,7 +14226,6 @@ See g_param_spec_internal() for details on property names. #G_TYPE_PARAM. The type system uses the information contained in the #GParamSpecTypeInfo structure pointed to by @info to manage the #GParamSpec type and its instances. - The new type identifier. @@ -14882,7 +14249,6 @@ transformed @dest_value complied to @pspec without modifications. See also g_value_type_transformable(), g_value_transform() and g_param_value_validate(). - %TRUE if transformation and validation were successful, %FALSE otherwise and @dest_value is left untouched. @@ -14910,7 +14276,6 @@ without modifications Checks whether @value contains the default value as specified in @pspec. - whether @value contains the canonical default for this @pspec @@ -14928,7 +14293,6 @@ without modifications Sets @value to its default value as specified in @pspec. - @@ -14964,7 +14328,6 @@ that integers stored in @value may not be smaller than -42 and not be greater than +42. If @value contains an integer outside of this range, it is modified accordingly, so the resulting value will fit into the range -42 .. +42. - whether modifying @value was necessary to ensure validity @@ -14984,7 +14347,6 @@ range -42 .. +42. Compares @value1 with @value2 according to @pspec, and return -1, 0 or +1, if @value1 is found to be less than, equal to or greater than @value2, respectively. - -1, 0 or +1, for a less than, equal to or greater than result @@ -15007,7 +14369,6 @@ respectively. Creates a new %G_TYPE_POINTER derived type id for a new pointer type with name @name. - a new %G_TYPE_POINTER derived type id for @name. @@ -15044,7 +14405,6 @@ One convenient usage of this function is in implementing property setters: g_object_notify (foo, "bar"); } ]| - a pointer to a #GObject reference @@ -15081,7 +14441,6 @@ One convenient usage of this function is in implementing property setters: g_object_notify (foo, "bar"); } ]| - the memory address of a pointer @@ -15103,7 +14462,6 @@ usually want the signal connection to override the class handler). This accumulator will use the return value from the first signal handler that is run as the return value for the signal and not run any further handlers (ie: the first handler "wins"). - standard #GSignalAccumulator result @@ -15135,7 +14493,6 @@ callbacks will be invoked, while a return of %FALSE allows the emission to continue. The idea here is that a %TRUE return indicates that the callback handled the signal, and no further handling is needed. - standard #GSignalAccumulator result @@ -15163,7 +14520,6 @@ handling is needed. Adds an emission hook for a signal, which will get called for any emission of that signal, independent of the instance. This is possible only for signals which don't have #G_SIGNAL_NO_HOOKS flag set. - the hook id, for later use with g_signal_remove_emission_hook(). @@ -15181,11 +14537,11 @@ for signals which don't have #G_SIGNAL_NO_HOOKS flag set. a #GSignalEmissionHook function. - + user data for @hook_func. - + a #GDestroyNotify for @hook_data. @@ -15196,7 +14552,6 @@ for signals which don't have #G_SIGNAL_NO_HOOKS flag set. be called from an overridden class closure; see g_signal_override_class_closure() and g_signal_override_class_handler(). - @@ -15220,7 +14575,6 @@ g_signal_override_class_handler(). only be called from an overridden class closure; see g_signal_override_class_closure() and g_signal_override_class_handler(). - @@ -15245,7 +14599,6 @@ The handler will be called before the default handler of the signal. See [memory management of signal handlers][signal-memory-management] for details on how to handle the return value and memory management of @data. - the instance to connect to. @@ -15265,7 +14618,6 @@ details on how to handle the return value and memory management of @data. Connects a #GCallback function to a signal for a particular object. The handler will be called after the default handler of the signal. - the instance to connect to. @@ -15283,7 +14635,6 @@ The handler will be called after the default handler of the signal. Connects a closure to a signal for a particular object. - the handler ID (always greater than 0 for successful connections) @@ -15310,7 +14661,6 @@ The handler will be called after the default handler of the signal. Connects a closure to a signal for a particular object. - the handler ID (always greater than 0 for successful connections) @@ -15345,7 +14695,6 @@ to g_signal_connect(), but allows to provide a #GClosureNotify for the data which will be called when the signal handler is disconnected and no longer used. Specify @connect_flags if you need `..._after()` or `..._swapped()` variants of this function. - the handler ID (always greater than 0 for successful connections) @@ -15363,11 +14712,11 @@ used. Specify @connect_flags if you need `..._after()` or the #GCallback to connect. - + data to pass to @c_handler calls. - + a #GClosureNotify for @data. @@ -15386,7 +14735,6 @@ When the @gobject is destroyed the signal handler will be automatically disconnected. Note that this is not currently threadsafe (ie: emitting a signal while @gobject is being destroyed in another thread is not safe). - the handler id. @@ -15442,7 +14790,6 @@ button_clicked_cb (GtkButton *button, GtkWidget *other_widget) g_signal_connect (button, "clicked", (GCallback) button_clicked_cb, other_widget); ]| - the instance to connect to. @@ -15463,7 +14810,6 @@ g_signal_connect (button, "clicked", Note that g_signal_emit() resets the return value to the default if no handlers are connected, in contrast to g_signal_emitv(). - @@ -15493,7 +14839,6 @@ if no handlers are connected, in contrast to g_signal_emitv(). Note that g_signal_emit_by_name() resets the return value to the default if no handlers are connected, in contrast to g_signal_emitv(). - @@ -15519,7 +14864,6 @@ if no handlers are connected, in contrast to g_signal_emitv(). Note that g_signal_emit_valist() resets the return value to the default if no handlers are connected, in contrast to g_signal_emitv(). - @@ -15550,7 +14894,6 @@ if no handlers are connected, in contrast to g_signal_emitv(). Note that g_signal_emitv() doesn't change @return_value if no handlers are connected, in contrast to g_signal_emit() and g_signal_emit_valist(). - @@ -15581,9 +14924,9 @@ specified signal returns a value, but may be ignored otherwise. Returns the invocation hint of the innermost signal emission of instance. - - - the invocation hint of the innermost signal emission. + + the invocation hint of the innermost + signal emission, or %NULL if not found. @@ -15602,7 +14945,6 @@ blocked before to become active again. The @handler_id has to be a valid signal handler id, connected to a signal of @instance. - @@ -15624,7 +14966,6 @@ connected to. The @handler_id becomes invalid and may be reused. The @handler_id has to be a valid signal handler id, connected to a signal of @instance. - @@ -15645,7 +14986,6 @@ The criteria mask is passed as an OR-ed combination of #GSignalMatchType flags, and the criteria values are passed as arguments. The match @mask has to be non-0 for successful matches. If no handler was found, 0 is returned. - A valid non-0 signal handler id for a successful match. @@ -15676,7 +15016,7 @@ If no handler was found, 0 is returned. The C closure callback of the handler (useless for non-C closures). - + The closure data of the handler's closure. @@ -15684,7 +15024,6 @@ If no handler was found, 0 is returned. Returns whether @handler_id is the ID of a handler connected to @instance. - whether @handler_id identifies a handler connected to @instance. @@ -15714,7 +15053,6 @@ proceeded yet). The @handler_id has to be a valid id of a signal handler that is connected to a signal of @instance and is currently blocked. - @@ -15731,7 +15069,6 @@ connected to a signal of @instance and is currently blocked. Blocks all handlers on an instance that match @func and @data. - The instance to block handlers from. @@ -15752,7 +15089,6 @@ Passing at least one of the %G_SIGNAL_MATCH_CLOSURE, %G_SIGNAL_MATCH_FUNC or %G_SIGNAL_MATCH_DATA match flags is required for successful matches. If no handlers were found, 0 is returned, the number of blocked handlers otherwise. - The number of handlers that matched. @@ -15783,7 +15119,7 @@ otherwise. The C closure callback of the handlers (useless for non-C closures). - + The closure data of the handlers' closures. @@ -15793,7 +15129,6 @@ otherwise. Destroy all signal handlers of a type instance. This function is an implementation detail of the #GObject dispose implementation, and should not be used outside of the type system. - @@ -15806,7 +15141,6 @@ and should not be used outside of the type system. Disconnects all handlers on an instance that match @data. - The instance to remove handlers from @@ -15818,7 +15152,6 @@ and should not be used outside of the type system. Disconnects all handlers on an instance that match @func and @data. - The instance to remove handlers from. @@ -15840,7 +15173,6 @@ passed as arguments. Passing at least one of the %G_SIGNAL_MATCH_DATA match flags is required for successful matches. If no handlers were found, 0 is returned, the number of disconnected handlers otherwise. - The number of handlers that matched. @@ -15871,7 +15203,7 @@ disconnected handlers otherwise. The C closure callback of the handlers (useless for non-C closures). - + The closure data of the handlers' closures. @@ -15879,7 +15211,6 @@ disconnected handlers otherwise. Unblocks all handlers on an instance that match @func and @data. - The instance to unblock handlers from. @@ -15901,7 +15232,6 @@ or %G_SIGNAL_MATCH_DATA match flags is required for successful matches. If no handlers were found, 0 is returned, the number of unblocked handlers otherwise. The match criteria should not apply to any handlers that are not currently blocked. - The number of handlers that matched. @@ -15932,7 +15262,7 @@ not currently blocked. The C closure callback of the handlers (useless for non-C closures). - + The closure data of the handlers' closures. @@ -15955,7 +15285,6 @@ One example of when you might use this is when the arguments to the signal are difficult to compute. A class implementor may opt to not emit the signal if no one is attached anyway, thus saving the cost of building the arguments. - %TRUE if a handler is connected to the signal, %FALSE otherwise. @@ -15987,7 +15316,6 @@ which need to be validated at run-time before actually trying to create them. See [canonical parameter names][canonical-parameter-names] for details of the rules for valid names. The rules for signal names are the same as those for property names. - %TRUE if @name is a valid signal name, %FALSE otherwise. @@ -16003,7 +15331,6 @@ for property names. Lists the signals by id that a certain instance or interface type created. Further information about the signals can be acquired through g_signal_query(). - Newly allocated array of signal IDs. @@ -16033,7 +15360,6 @@ example, using g_type_class_ref()) for this function to work, as signals are always installed during class initialization. See g_signal_new() for details on allowed signal names. - the signal's identifying number, or 0 if no signal was found. @@ -16053,8 +15379,7 @@ See g_signal_new() for details on allowed signal names. Given the signal's identifier, finds its name. Two different signals may have the same name, if they have differing types. - - + the signal name, or %NULL if the signal number was invalid. @@ -16090,7 +15415,6 @@ instead of g_cclosure_marshal_generic(). If @c_marshaller is non-%NULL, you need to also specify a va_marshaller using g_signal_set_va_marshaller() or the generic va_marshaller will be used. - the signal id @@ -16117,11 +15441,11 @@ be used. not associate a class method slot with this signal. - + the accumulator for this signal; may be %NULL. - + user data for the @accumulator. @@ -16162,7 +15486,6 @@ See g_signal_new() for information about signal names. If c_marshaller is %NULL, g_cclosure_marshal_generic() will be used as the marshaller for this signal. - the signal id @@ -16183,17 +15506,17 @@ the marshaller for this signal. %G_SIGNAL_RUN_FIRST or %G_SIGNAL_RUN_LAST. - + a #GCallback which acts as class implementation of this signal. Used to invoke a class method generically. Pass %NULL to not associate a class method with this signal. - + the accumulator for this signal; may be %NULL. - + user data for the @accumulator. @@ -16224,7 +15547,6 @@ See g_signal_new() for details on allowed signal names. If c_marshaller is %NULL, g_cclosure_marshal_generic() will be used as the marshaller for this signal. - the signal id @@ -16245,15 +15567,15 @@ the marshaller for this signal. %G_SIGNAL_RUN_FIRST or %G_SIGNAL_RUN_LAST. - + The closure to invoke on signal emission; may be %NULL. - + the accumulator for this signal; may be %NULL. - + user data for the @accumulator. @@ -16284,7 +15606,6 @@ See g_signal_new() for details on allowed signal names. If c_marshaller is %NULL, g_cclosure_marshal_generic() will be used as the marshaller for this signal. - the signal id @@ -16314,7 +15635,7 @@ the marshaller for this signal. the accumulator for this signal; may be %NULL - + user data for the @accumulator @@ -16333,9 +15654,9 @@ the marshaller for this signal. the length of @param_types - + an array of types, one for - each parameter + each parameter (may be %NULL if @n_params is zero) @@ -16350,7 +15671,6 @@ from the type to which the signal belongs. See g_signal_chain_from_overridden() and g_signal_chain_from_overridden_handler() for how to chain up to the parent class closure from inside the overridden one. - @@ -16379,7 +15699,6 @@ type to which the signal belongs. See g_signal_chain_from_overridden() and g_signal_chain_from_overridden_handler() for how to chain up to the parent class closure from inside the overridden one. - @@ -16402,7 +15721,6 @@ parent class closure from inside the overridden one. Internal function to parse a signal name into its @signal_id and @detail quark. - Whether the signal name could successfully be parsed and @signal_id_p and @detail_p contain valid return values. @@ -16437,7 +15755,6 @@ structure to hold signal-specific information. If an invalid signal id is passed in, the @signal_id member of the #GSignalQuery is 0. All members filled into the #GSignalQuery structure should be considered constant and have to be left untouched. - @@ -16455,7 +15772,6 @@ be considered constant and have to be left untouched. Deletes an emission hook. - @@ -16476,7 +15792,6 @@ be considered constant and have to be left untouched. 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. - @@ -16503,7 +15818,6 @@ This will prevent the default method from running, if the signal was flag). Prints a warning if used on a signal which isn't being emitted. - @@ -16527,7 +15841,6 @@ Prints a warning if used on a signal which isn't being emitted. This is just like g_signal_stop_emission() except it will look up the signal id for you. - @@ -16546,7 +15859,6 @@ signal id for you. Creates a new closure which invokes the function found at the offset @struct_offset in the class structure of the interface or classed type identified by @itype. - a floating reference to a new #GCClosure @@ -16655,7 +15967,6 @@ disconnected for some reason. If the source is not one of the standard GLib types, the @closure_callback and @closure_marshal fields of the #GSourceFuncs structure must have been filled in with pointers to appropriate functions. - @@ -16681,7 +15992,6 @@ If the source is not one of the standard GLib types, the @closure_callback and @closure_marshal fields of the #GSourceFuncs structure must have been filled in with pointers to appropriate functions. - @@ -16697,7 +16007,6 @@ functions. #GValue. The main purpose of this function is to describe #GValue contents for debugging output, the way in which the contents are described may change between different GLib versions. - Newly allocated string. @@ -16717,7 +16026,6 @@ until one of them returns %TRUE. The functions have to check the class id passed in to figure whether they actually want to cache the class of this type, since all classes are routed through the same #GTypeClassCacheFunc chain. - @@ -16743,7 +16051,6 @@ This function should be called in the type's get_type() function after the type is registered. The private structure can be retrieved using the G_TYPE_CLASS_GET_PRIVATE() macro. - @@ -16759,7 +16066,6 @@ G_TYPE_CLASS_GET_PRIVATE() macro. - @@ -16782,7 +16088,6 @@ that depends on the interfaces of a class. For instance, the implementation of #GObject uses this facility to check that an object implements all of the properties that are defined on its interfaces. - @@ -16799,16 +16104,15 @@ interfaces. - Adds @interface_type to the dynamic @instantiable_type. The information + Adds @interface_type to the dynamic @instance_type. The information contained in the #GTypePlugin structure pointed to by @plugin is used to manage the relationship. - - #GType value of an instantiable type + #GType value of an instantiatable type @@ -16822,16 +16126,15 @@ is used to manage the relationship. - Adds @interface_type to the static @instantiable_type. + Adds @interface_type to the static @instance_type. The information contained in the #GInterfaceInfo structure pointed to by @info is used to manage the relationship. - - #GType value of an instantiable type + #GType value of an instantiatable type @@ -16846,7 +16149,6 @@ pointed to by @info is used to manage the relationship. - @@ -16860,7 +16162,6 @@ pointed to by @info is used to manage the relationship. - @@ -16876,7 +16177,6 @@ pointed to by @info is used to manage the relationship. Private helper function to aid implementation of the G_TYPE_CHECK_INSTANCE() macro. - %TRUE if @instance is valid, %FALSE otherwise @@ -16889,7 +16189,6 @@ G_TYPE_CHECK_INSTANCE() macro. - @@ -16903,7 +16202,6 @@ G_TYPE_CHECK_INSTANCE() macro. - @@ -16917,7 +16215,6 @@ G_TYPE_CHECK_INSTANCE() macro. - @@ -16931,7 +16228,6 @@ G_TYPE_CHECK_INSTANCE() macro. - @@ -16942,7 +16238,6 @@ G_TYPE_CHECK_INSTANCE() macro. - @@ -16953,7 +16248,6 @@ G_TYPE_CHECK_INSTANCE() macro. - @@ -16969,7 +16263,6 @@ G_TYPE_CHECK_INSTANCE() macro. Return a newly allocated and 0-terminated array of type IDs, listing the child types of @type. - Newly allocated and 0-terminated array of child types, free with g_free() @@ -16990,7 +16283,6 @@ the child types of @type. - @@ -17009,7 +16301,6 @@ except that the classes reference count isn't incremented. As a consequence, this function may return %NULL if the class of the type passed in does not currently exist (hasn't been referenced before). - the #GTypeClass structure for the given type ID or %NULL if the class does not @@ -17026,7 +16317,6 @@ referenced before). A more efficient version of g_type_class_peek() which works only for static types. - the #GTypeClass structure for the given type ID or %NULL if the class does not @@ -17044,7 +16334,6 @@ static types. Increments the reference count of the class structure belonging to @type. This function will demand-create the class if it doesn't exist already. - the #GTypeClass structure for the given type ID @@ -17074,7 +16363,6 @@ with zeros. Note: Do not use this function, unless you're implementing a fundamental type. Also language bindings should not use this function, but g_object_new() instead. - an allocated and initialized instance, subject to further treatment by the fundamental type implementation @@ -17090,7 +16378,6 @@ function, but g_object_new() instead. If the interface type @g_type is currently in use, returns its default interface vtable. - the default vtable for the interface, or %NULL if the type is not currently @@ -17115,7 +16402,6 @@ the type (the @base_init and @class_init members of #GTypeInfo). Calling g_type_default_interface_ref() is useful when you want to make sure that signals and properties for an interface have been installed. - the default vtable for the interface; call g_type_default_interface_unref() @@ -17135,7 +16421,6 @@ interface default vtable @g_iface. If the type is dynamic, then when no one is using the interface and all references have been released, the finalize function for the interface's default vtable (the @class_finalize member of #GTypeInfo) will be called. - @@ -17150,7 +16435,6 @@ vtable (the @class_finalize member of #GTypeInfo) will be called. Returns the length of the ancestry of the passed in type. This includes the type itself, so that e.g. a fundamental type has depth 1. - the depth of @type @@ -17175,7 +16459,6 @@ which _get_type() methods do on the first call). As a result, if you write a bare call to a _get_type() macro, it may get optimized out by the compiler. Using g_type_ensure() guarantees that the type's _get_type() method is called. - @@ -17192,7 +16475,6 @@ the type, if there is one. Like g_type_create_instance(), this function is reserved for implementors of fundamental types. - @@ -17208,7 +16490,6 @@ implementors of fundamental types. has been registered under this name (this is the preferred method to find out by name whether a specific type has been registered yet). - corresponding type ID or 0 @@ -17223,7 +16504,6 @@ yet). Internal function, used to extract the fundamental type ID portion. Use G_TYPE_FUNDAMENTAL() instead. - fundamental type ID @@ -17240,7 +16520,6 @@ Use G_TYPE_FUNDAMENTAL() instead. register a new fundamental type with g_type_register_fundamental(). The returned type ID represents the highest currently registered fundamental type identifier. - the next available fundamental type ID to be registered, or 0 if the type system ran out of fundamental type IDs @@ -17252,7 +16531,6 @@ fundamental type identifier. this is only available if GLib is built with debugging support and the instance_count debug flag is set (by setting the GOBJECT_DEBUG variable to include instance-count). - the number of instances allocated of the given type; if instance counts are not available, returns 0. @@ -17267,7 +16545,6 @@ variable to include instance-count). Returns the #GTypePlugin structure for @type. - the corresponding plugin if @type is a dynamic type, %NULL otherwise @@ -17287,7 +16564,6 @@ with g_type_set_qdata(). Note that this does not take subtyping into account; data attached to one type with g_type_set_qdata() cannot be retrieved from a subtype using g_type_get_qdata(). - the data, or %NULL if no data was found @@ -17309,7 +16585,6 @@ of registered types. Any time a type is registered this serial changes, which means you can cache information based on type lookups (such as g_type_from_name()) and know if the cache is still valid at a later time by comparing the current serial with the one at the type lookup. - An unsigned int, representing the state of type registrations @@ -17320,7 +16595,6 @@ time by comparing the current serial with the one at the type lookup. the type system is initialised automatically and this function does nothing. the type system is now initialised automatically - @@ -17333,7 +16607,6 @@ and this function does nothing. If you need to enable debugging features, use the GOBJECT_DEBUG environment variable. the type system is now initialised automatically - @@ -17351,7 +16624,6 @@ This means that any type implementing @interface_type must also implement @prerequisite_type. Prerequisites can be thought of as an alternative to interface derivation (which GType doesn't support). An interface can have at most one instantiatable prerequisite type. - @@ -17371,7 +16643,6 @@ at most one instantiatable prerequisite type. @interface_type which has been added to @instance_type, or %NULL if @interface_type has not been added to @instance_type or does not have a #GTypePlugin structure. See g_type_add_interface_dynamic(). - the #GTypePlugin for the dynamic interface @interface_type of @instance_type @@ -17391,7 +16662,6 @@ not have a #GTypePlugin structure. See g_type_add_interface_dynamic(). Returns the #GTypeInterface structure of an interface to which the passed in class conforms. - the #GTypeInterface structure of @iface_type if implemented by @instance_class, %NULL @@ -17411,7 +16681,6 @@ passed in class conforms. Returns the prerequisites of an interfaces type. - a newly-allocated zero-terminated array of #GType containing @@ -17435,7 +16704,6 @@ passed in class conforms. Return a newly allocated and 0-terminated array of type IDs, listing the interface types that @type conforms to. - Newly allocated and 0-terminated array of interface types, free with g_free() @@ -17459,18 +16727,17 @@ the interface types that @type conforms to. If @is_a_type is a derivable type, check whether @type is a descendant of @is_a_type. If @is_a_type is an interface, check whether @type conforms to it. - %TRUE if @type is a @is_a_type - type to check anchestry for + type to check ancestry for - possible anchestor of @type or interface that @type + possible ancestor of @type or interface that @type could conform to @@ -17482,7 +16749,6 @@ function (like all other GType API) cannot cope with invalid type IDs. %G_TYPE_INVALID may be passed to this function, as may be any other validly registered type ID, but randomized type IDs should not be passed in and will most likely lead to a crash. - static type name or %NULL @@ -17495,7 +16761,6 @@ not be passed in and will most likely lead to a crash. - @@ -17506,7 +16771,6 @@ not be passed in and will most likely lead to a crash. - @@ -17518,15 +16782,14 @@ not be passed in and will most likely lead to a crash. Given a @leaf_type and a @root_type which is contained in its -anchestry, return the type that @root_type is the immediate parent +ancestry, return the type that @root_type is the immediate parent of. In other words, this function determines the type that is derived directly from @root_type which is also a base class of @leaf_type. Given a root type and a leaf type, this function can be used to determine the types and order in which the leaf type is descended from the root type. - - immediate child of @root_type and anchestor of @leaf_type + immediate child of @root_type and ancestor of @leaf_type @@ -17543,7 +16806,6 @@ descended from the root type. Return the direct parent type of the passed in type. If the passed in type has no parent, i.e. is a fundamental type, 0 is returned. - the parent type @@ -17557,7 +16819,6 @@ in type has no parent, i.e. is a fundamental type, 0 is returned. Get the corresponding quark of the type IDs name. - the type names quark or 0 @@ -17576,7 +16837,6 @@ type-specific information. If an invalid #GType is passed in, the @type member of the #GTypeQuery is 0. All members filled into the #GTypeQuery structure should be considered constant and have to be left untouched. - @@ -17598,7 +16858,6 @@ left untouched. #GTypePlugin structure pointed to by @plugin to manage the type and its instances (if not abstract). The value of @flags determines the nature (e.g. abstract or not) of the type. - the new type identifier or #G_TYPE_INVALID if registration failed @@ -17630,7 +16889,6 @@ The type system uses the information contained in the #GTypeInfo structure pointed to by @info and the #GTypeFundamentalInfo structure pointed to by @finfo to manage the type and its instances. The value of @flags determines additional characteristics of the fundamental type. - the predefined type identifier @@ -17664,7 +16922,6 @@ additional characteristics of the fundamental type. #GTypeInfo structure pointed to by @info to manage the type and its instances (if not abstract). The value of @flags determines the nature (e.g. abstract or not) of the type. - the new type identifier @@ -17693,7 +16950,6 @@ instances (if not abstract). The value of @flags determines the nature @parent_type. The value of @flags determines the nature (e.g. abstract or not) of the type. It works by filling a #GTypeInfo struct and calling g_type_register_static(). - the new type identifier @@ -17733,7 +16989,6 @@ struct and calling g_type_register_static(). Removes a previously installed #GTypeClassCacheFunc. The cache maintained by @cache_func has to be empty when calling g_type_remove_class_cache_func() to avoid leaks. - @@ -17751,7 +17006,6 @@ g_type_remove_class_cache_func() to avoid leaks. Removes an interface check function added with g_type_add_interface_check(). - @@ -17768,7 +17022,6 @@ g_type_add_interface_check(). Attaches arbitrary data to a type. - @@ -17788,7 +17041,6 @@ g_type_add_interface_check(). - @@ -17807,7 +17059,6 @@ g_type_add_interface_check(). Note that this function should only be used from source code that implements or has internal knowledge of the implementation of @type. - location of the #GTypeValueTable associated with @type or %NULL if there is no #GTypeValueTable associated with @type @@ -17847,7 +17098,6 @@ can be replaced by: Registers a value transformation function for use in g_value_transform(). A previously registered transformation function for @src_type and @dest_type will be replaced. - @@ -17870,7 +17120,6 @@ will be replaced. Returns whether a #GValue of type @src_type can be copied into a #GValue of type @dest_type. - %TRUE if g_value_copy() is possible with @src_type and @dest_type. @@ -17891,7 +17140,6 @@ a #GValue of type @dest_type. of type @src_type into values of type @dest_type. Note that for the types to be transformable, they must be compatible or a transformation function must be registered. - %TRUE if the transformation is possible, %FALSE otherwise. diff --git a/rust-bindings/rust/gir-files/Gio-2.0.gir b/rust-bindings/rust/gir-files/Gio-2.0.gir index f6192524..6c39646b 100644 --- a/rust-bindings/rust/gir-files/Gio-2.0.gir +++ b/rust-bindings/rust/gir-files/Gio-2.0.gir @@ -19,154 +19,132 @@ and/or use gtk-doc annotations. --> - - - - - - - - - - - - - - - - - - - - - - @@ -202,7 +180,6 @@ safety and for the state being enabled. Probably the only useful thing to do with a #GAction is to put it inside of a #GSimpleActionGroup. - Checks if @action_name is valid. @@ -211,7 +188,6 @@ plus '-' and '.'. The empty string is not a valid action name. It is an error to call this function with a non-utf8 @action_name. @action_name must not be %NULL. - %TRUE if @action_name is valid @@ -248,7 +224,6 @@ two sets of parens, for example: "app.action((1,2,3))". A string target can be specified this way as well: "app.action('target')". For strings, this third format must be used if * target value is empty or contains characters other than alphanumerics, '-' and '.'. - %TRUE if successful, else %FALSE with @error set @@ -279,7 +254,6 @@ and @target_value by that function. See that function for the types of strings that will be printed by this function. - a detailed format string @@ -303,7 +277,6 @@ the parameter type given at construction time). If the parameter type was %NULL then @parameter must also be %NULL. If the @parameter GVariant is floating, it is consumed. - @@ -329,7 +302,6 @@ its state or may change its state to something other than @value. See g_action_get_state_hint(). If the @value GVariant is floating, it is consumed. - @@ -349,7 +321,6 @@ If the @value GVariant is floating, it is consumed. An action must be enabled in order to be activated or in order to have its state changed from outside callers. - whether the action is enabled @@ -363,7 +334,6 @@ have its state changed from outside callers. Queries the name of @action. - the name of the action @@ -384,7 +354,6 @@ given to that function must be of the type returned by this function. In the case that this function returns %NULL, you must not give any #GVariant, but %NULL instead. - the parameter type @@ -405,8 +374,7 @@ given by g_action_get_state_type(). The return value (if non-%NULL) should be freed with g_variant_unref() when it is no longer required. - - + the current state of the action @@ -436,7 +404,6 @@ within the range may fail. The return value (if non-%NULL) should be freed with g_variant_unref() when it is no longer required. - the state range hint @@ -461,7 +428,6 @@ given as the state. All calls to g_action_change_state() must give a If the action is not stateful (e.g. created with g_simple_action_new()) then this function will return %NULL. In that case, g_action_get_state() will return %NULL and you must not call g_action_change_state(). - the state type, if the action is stateful @@ -481,7 +447,6 @@ the parameter type given at construction time). If the parameter type was %NULL then @parameter must also be %NULL. If the @parameter GVariant is floating, it is consumed. - @@ -507,7 +472,6 @@ its state or may change its state to something other than @value. See g_action_get_state_hint(). If the @value GVariant is floating, it is consumed. - @@ -527,7 +491,6 @@ If the @value GVariant is floating, it is consumed. An action must be enabled in order to be activated or in order to have its state changed from outside callers. - whether the action is enabled @@ -541,7 +504,6 @@ have its state changed from outside callers. Queries the name of @action. - the name of the action @@ -562,7 +524,6 @@ given to that function must be of the type returned by this function. In the case that this function returns %NULL, you must not give any #GVariant, but %NULL instead. - the parameter type @@ -583,8 +544,7 @@ given by g_action_get_state_type(). The return value (if non-%NULL) should be freed with g_variant_unref() when it is no longer required. - - + the current state of the action @@ -614,7 +574,6 @@ within the range may fail. The return value (if non-%NULL) should be freed with g_variant_unref() when it is no longer required. - the state range hint @@ -639,7 +598,6 @@ given as the state. All calls to g_action_change_state() must give a If the action is not stateful (e.g. created with g_simple_action_new()) then this function will return %NULL. In that case, g_action_get_state() will return %NULL and you must not call g_action_change_state(). - the state type, if the action is stateful @@ -690,14 +648,12 @@ after @name are optional. Additional optional fields may be added in the future. See g_action_map_add_action_entries() for an example. - the name of the action - @@ -730,7 +686,6 @@ See g_action_map_add_action_entries() for an example. - @@ -799,12 +754,10 @@ the virtual functions g_action_group_list_actions() and g_action_group_query_action(). The other virtual functions should not be implemented - their "wrappers" are actually implemented with calls to g_action_group_query_action(). - Emits the #GActionGroup::action-added signal on @action_group. This function should only be called by #GActionGroup implementations. - @@ -823,7 +776,6 @@ This function should only be called by #GActionGroup implementations. Emits the #GActionGroup::action-enabled-changed signal on @action_group. This function should only be called by #GActionGroup implementations. - @@ -846,7 +798,6 @@ This function should only be called by #GActionGroup implementations. Emits the #GActionGroup::action-removed signal on @action_group. This function should only be called by #GActionGroup implementations. - @@ -865,7 +816,6 @@ This function should only be called by #GActionGroup implementations. Emits the #GActionGroup::action-state-changed signal on @action_group. This function should only be called by #GActionGroup implementations. - @@ -890,8 +840,34 @@ This function should only be called by #GActionGroup implementations. If the action is expecting a parameter, then the correct type of parameter must be given as @parameter. If the action is expecting no parameters then @parameter must be %NULL. See -g_action_group_get_action_parameter_type(). - +g_action_group_get_action_parameter_type(). + +If the #GActionGroup implementation supports asynchronous remote +activation over D-Bus, this call may return before the relevant +D-Bus traffic has been sent, or any replies have been received. In +order to block on such asynchronous activation calls, +g_dbus_connection_flush() should be called prior to the code, which +depends on the result of the action activation. Without flushing +the D-Bus connection, there is no guarantee that the action would +have been activated. + +The following code which runs in a remote app instance, shows an +example of a "quit" action being activated on the primary app +instance over D-Bus. Here g_dbus_connection_flush() is called +before `exit()`. Without g_dbus_connection_flush(), the "quit" action +may fail to be activated on the primary instance. + +|[<!-- language="C" --> +// call "quit" action on primary instance +g_action_group_activate_action (G_ACTION_GROUP (app), "quit", NULL); + +// make sure the action is activated now +g_dbus_connection_flush (...); + +g_debug ("application has been terminated. exiting."); + +exit (0); +]| @@ -922,7 +898,6 @@ its state or may change its state to something other than @value. See g_action_group_get_action_state_hint(). If the @value GVariant is floating, it is consumed. - @@ -946,7 +921,6 @@ If the @value GVariant is floating, it is consumed. An action must be enabled in order to be activated or in order to have its state changed from outside callers. - whether or not the action is currently enabled @@ -976,7 +950,6 @@ In the case that this function returns %NULL, you must not give any The parameter type of a particular action will never change but it is possible for an action to be removed and for a new action to be added with the same name but a different parameter type. - the parameter type @@ -1001,7 +974,6 @@ given by g_action_group_get_action_state_type(). The return value (if non-%NULL) should be freed with g_variant_unref() when it is no longer required. - the current state of the action @@ -1036,7 +1008,6 @@ within the range may fail. The return value (if non-%NULL) should be freed with g_variant_unref() when it is no longer required. - the state range hint @@ -1069,7 +1040,6 @@ and you must not call g_action_group_change_action_state(). The state type of a particular action will never change but it is possible for an action to be removed and for a new action to be added with the same name but a different state type. - the state type, if the action is stateful @@ -1087,7 +1057,6 @@ with the same name but a different state type. Checks if the named action exists within @action_group. - whether the named action exists @@ -1108,7 +1077,6 @@ with the same name but a different state type. The caller is responsible for freeing the list with g_strfreev() when it is no longer required. - a %NULL-terminated array of the names of the actions in the group @@ -1151,7 +1119,6 @@ If the action exists, %TRUE is returned and any of the requested fields (as indicated by having a non-%NULL reference passed in) are filled. If the action doesn't exist, %FALSE is returned and the fields may or may not have been modified. - %TRUE if the action exists, else %FALSE @@ -1191,7 +1158,6 @@ fields may or may not have been modified. Emits the #GActionGroup::action-added signal on @action_group. This function should only be called by #GActionGroup implementations. - @@ -1210,7 +1176,6 @@ This function should only be called by #GActionGroup implementations. Emits the #GActionGroup::action-enabled-changed signal on @action_group. This function should only be called by #GActionGroup implementations. - @@ -1233,7 +1198,6 @@ This function should only be called by #GActionGroup implementations. Emits the #GActionGroup::action-removed signal on @action_group. This function should only be called by #GActionGroup implementations. - @@ -1252,7 +1216,6 @@ This function should only be called by #GActionGroup implementations. Emits the #GActionGroup::action-state-changed signal on @action_group. This function should only be called by #GActionGroup implementations. - @@ -1277,8 +1240,34 @@ This function should only be called by #GActionGroup implementations. If the action is expecting a parameter, then the correct type of parameter must be given as @parameter. If the action is expecting no parameters then @parameter must be %NULL. See -g_action_group_get_action_parameter_type(). - +g_action_group_get_action_parameter_type(). + +If the #GActionGroup implementation supports asynchronous remote +activation over D-Bus, this call may return before the relevant +D-Bus traffic has been sent, or any replies have been received. In +order to block on such asynchronous activation calls, +g_dbus_connection_flush() should be called prior to the code, which +depends on the result of the action activation. Without flushing +the D-Bus connection, there is no guarantee that the action would +have been activated. + +The following code which runs in a remote app instance, shows an +example of a "quit" action being activated on the primary app +instance over D-Bus. Here g_dbus_connection_flush() is called +before `exit()`. Without g_dbus_connection_flush(), the "quit" action +may fail to be activated on the primary instance. + +|[<!-- language="C" --> +// call "quit" action on primary instance +g_action_group_activate_action (G_ACTION_GROUP (app), "quit", NULL); + +// make sure the action is activated now +g_dbus_connection_flush (...); + +g_debug ("application has been terminated. exiting."); + +exit (0); +]| @@ -1309,7 +1298,6 @@ its state or may change its state to something other than @value. See g_action_group_get_action_state_hint(). If the @value GVariant is floating, it is consumed. - @@ -1333,7 +1321,6 @@ If the @value GVariant is floating, it is consumed. An action must be enabled in order to be activated or in order to have its state changed from outside callers. - whether or not the action is currently enabled @@ -1363,7 +1350,6 @@ In the case that this function returns %NULL, you must not give any The parameter type of a particular action will never change but it is possible for an action to be removed and for a new action to be added with the same name but a different parameter type. - the parameter type @@ -1388,7 +1374,6 @@ given by g_action_group_get_action_state_type(). The return value (if non-%NULL) should be freed with g_variant_unref() when it is no longer required. - the current state of the action @@ -1423,7 +1408,6 @@ within the range may fail. The return value (if non-%NULL) should be freed with g_variant_unref() when it is no longer required. - the state range hint @@ -1456,7 +1440,6 @@ and you must not call g_action_group_change_action_state(). The state type of a particular action will never change but it is possible for an action to be removed and for a new action to be added with the same name but a different state type. - the state type, if the action is stateful @@ -1474,7 +1457,6 @@ with the same name but a different state type. Checks if the named action exists within @action_group. - whether the named action exists @@ -1495,7 +1477,6 @@ with the same name but a different state type. The caller is responsible for freeing the list with g_strfreev() when it is no longer required. - a %NULL-terminated array of the names of the actions in the group @@ -1538,7 +1519,6 @@ If the action exists, %TRUE is returned and any of the requested fields (as indicated by having a non-%NULL reference passed in) are filled. If the action doesn't exist, %FALSE is returned and the fields may or may not have been modified. - %TRUE if the action exists, else %FALSE @@ -1637,13 +1617,11 @@ is still visible and can be queried from the signal handler. The virtual function table for #GActionGroup. - - whether the named action exists @@ -1662,7 +1640,6 @@ is still visible and can be queried from the signal handler. - a %NULL-terminated array of the names of the actions in the group @@ -1680,7 +1657,6 @@ actions in the group - whether or not the action is currently enabled @@ -1699,7 +1675,6 @@ actions in the group - the parameter type @@ -1718,7 +1693,6 @@ actions in the group - the state type, if the action is stateful @@ -1737,7 +1711,6 @@ actions in the group - the state range hint @@ -1756,7 +1729,6 @@ actions in the group - the current state of the action @@ -1775,7 +1747,6 @@ actions in the group - @@ -1797,7 +1768,6 @@ actions in the group - @@ -1819,7 +1789,6 @@ actions in the group - @@ -1837,7 +1806,6 @@ actions in the group - @@ -1855,7 +1823,6 @@ actions in the group - @@ -1877,7 +1844,6 @@ actions in the group - @@ -1899,7 +1865,6 @@ actions in the group - %TRUE if the action exists, else %FALSE @@ -1939,13 +1904,11 @@ actions in the group The virtual function table for #GAction. - - the name of the action @@ -1960,7 +1923,6 @@ actions in the group - the parameter type @@ -1975,7 +1937,6 @@ actions in the group - the state type, if the action is stateful @@ -1990,7 +1951,6 @@ actions in the group - the state range hint @@ -2005,7 +1965,6 @@ actions in the group - whether the action is enabled @@ -2020,8 +1979,7 @@ actions in the group - - + the current state of the action @@ -2035,7 +1993,6 @@ actions in the group - @@ -2053,7 +2010,6 @@ actions in the group - @@ -2080,7 +2036,6 @@ names of actions from various action groups to unique, prefixed names (e.g. by prepending "app." or "win."). This is the motivation for the 'Map' part of the interface name. - Adds an action to the @action_map. @@ -2088,7 +2043,6 @@ If the action map already contains an action with the same name as @action then the old action is dropped from the action map. The action map takes its own reference on @action. - @@ -2107,8 +2061,7 @@ The action map takes its own reference on @action. Looks up the action with the name @action_name in @action_map. If no such action exists, returns %NULL. - - + a #GAction, or %NULL @@ -2127,7 +2080,6 @@ If no such action exists, returns %NULL. Removes the named action from the action map. If no action of this name is in the map then nothing happens. - @@ -2149,7 +2101,6 @@ If the action map already contains an action with the same name as @action then the old action is dropped from the action map. The action map takes its own reference on @action. - @@ -2202,7 +2153,6 @@ create_action_group (void) return G_ACTION_GROUP (group); } ]| - @@ -2232,8 +2182,7 @@ create_action_group (void) Looks up the action with the name @action_name in @action_map. If no such action exists, returns %NULL. - - + a #GAction, or %NULL @@ -2252,7 +2201,6 @@ If no such action exists, returns %NULL. Removes the named action from the action map. If no action of this name is in the map then nothing happens. - @@ -2270,14 +2218,12 @@ If no action of this name is in the map then nothing happens. The virtual function table for #GActionMap. - - - + a #GAction, or %NULL @@ -2295,7 +2241,6 @@ If no action of this name is in the map then nothing happens. - @@ -2313,7 +2258,6 @@ If no action of this name is in the map then nothing happens. - @@ -2379,7 +2323,6 @@ application. It should be noted that it's generally not safe for applications to rely on the format of a particular URIs. Different launcher applications (e.g. file managers) may have different ideas of what a given URI means. - Creates a new #GAppInfo from the given information. @@ -2388,7 +2331,6 @@ Note that for @commandline, the quoting rules of the Exec key of the are applied. For example, if the @commandline contains percent-encoded URIs, the percent-character must be doubled in order to prevent it from being swallowed by Exec key unquoting. See the specification for exact quoting rules. - new #GAppInfo for given command. @@ -2417,7 +2359,6 @@ For desktop files, this includes applications that have of `OnlyShowIn` or `NotShowIn`. See g_app_info_should_show(). The returned list does not include applications which have the `Hidden` key set. - a newly allocated #GList of references to #GAppInfos. @@ -2430,7 +2371,6 @@ the `Hidden` key set. including the recommended and fallback #GAppInfos. See g_app_info_get_recommended_for_type() and g_app_info_get_fallback_for_type(). - #GList of #GAppInfos for given @content_type or %NULL on error. @@ -2447,7 +2387,6 @@ g_app_info_get_fallback_for_type(). Gets the default #GAppInfo for a given content type. - #GAppInfo for given @content_type or %NULL on error. @@ -2470,7 +2409,6 @@ g_app_info_get_fallback_for_type(). the given URI scheme. A URI scheme is the initial part of the URI, up to but not including the ':', e.g. "http", "ftp" or "sip". - #GAppInfo for given @uri_scheme or %NULL on error. @@ -2487,7 +2425,6 @@ of the URI, up to but not including the ':', e.g. "http", Gets a list of fallback #GAppInfos for a given content type, i.e. those applications which claim to support the given content type by MIME type subclassing and not directly. - #GList of #GAppInfos for given @content_type or %NULL on error. @@ -2509,7 +2446,6 @@ and not by MIME type subclassing. Note that the first application of the list is the last used one, i.e. the last one for which g_app_info_set_as_last_used_for_type() has been called. - #GList of #GAppInfos for given @content_type or %NULL on error. @@ -2533,7 +2469,6 @@ required. The D-Bus–activated applications don't have to be started if your application terminates too soon after this function. To prevent this, use g_app_info_launch_default_for_uri_async() instead. - %TRUE on success, %FALSE on error. @@ -2560,7 +2495,6 @@ dialog to the user. This is also useful if you want to be sure that the D-Bus–activated applications are really started before termination and if you are interested in receiving error information from their activation. - @@ -2589,7 +2523,6 @@ in receiving error information from their activation. Finishes an asynchronous launch-default-for-uri operation. - %TRUE if the launch was successful, %FALSE if @error is set @@ -2607,7 +2540,6 @@ g_app_info_set_as_default_for_type(), g_app_info_set_as_default_for_extension(), g_app_info_add_supports_type() or g_app_info_remove_supports_type(). - @@ -2621,7 +2553,6 @@ g_app_info_remove_supports_type(). Adds a content type to the application information to indicate the application is capable of opening files with the given content type. - %TRUE on success, %FALSE on error. @@ -2640,7 +2571,6 @@ application is capable of opening files with the given content type. Obtains the information whether the #GAppInfo can be deleted. See g_app_info_delete(). - %TRUE if @appinfo can be deleted @@ -2654,7 +2584,6 @@ See g_app_info_delete(). Checks if a supported content type can be removed from an application. - %TRUE if it is possible to remove supported content types from a given @appinfo, %FALSE if not. @@ -2673,7 +2602,6 @@ See g_app_info_delete(). On some platforms, there may be a difference between user-defined #GAppInfos which can be deleted, and system-wide ones which cannot. See g_app_info_can_delete(). - %TRUE if @appinfo has been deleted @@ -2687,7 +2615,6 @@ See g_app_info_can_delete(). Creates a duplicate of a #GAppInfo. - a duplicate of @appinfo. @@ -2702,10 +2629,9 @@ See g_app_info_can_delete(). Checks if two #GAppInfos are equal. -Note that the check <emphasis>may not</emphasis> compare each individual +Note that the check *may not* compare each individual field, and only does an identity check. In case detecting changes in the contents is needed, program code must additionally compare relevant fields. - %TRUE if @appinfo1 is equal to @appinfo2. %FALSE otherwise. @@ -2721,21 +2647,24 @@ contents is needed, program code must additionally compare relevant fields. - - - - + + Gets the commandline with which the application will be +started. + + a string containing the @appinfo's commandline, + or %NULL if this information is not available + + a #GAppInfo Gets a human-readable description of an installed application. - - + a string containing a description of the application @appinfo, or %NULL if none. @@ -2750,7 +2679,6 @@ application @appinfo, or %NULL if none. Gets the display name of the application. The display name is often more descriptive to the user than the name itself. - the display name of the application for @appinfo, or the name if no display name is available. @@ -2763,21 +2691,23 @@ no display name is available. - - + + Gets the executable's name for the installed application. - + a string containing the @appinfo's application +binaries name + + a #GAppInfo Gets the icon for the application. - - + the default #GIcon for @appinfo or %NULL if there is no default icon. @@ -2797,8 +2727,7 @@ desktop file id from the xdg menu specification. Note that the returned ID may be %NULL, depending on how the @appinfo has been constructed. - - + a string containing the application's ID. @@ -2811,7 +2740,6 @@ the @appinfo has been constructed. Gets the installed name of the application. - the name of the application for @appinfo. @@ -2830,7 +2758,6 @@ will return %NULL. This function does not take in consideration associations added with g_app_info_add_supports_type(), but only those exported directly by the application. - a list of content types. @@ -2873,7 +2800,6 @@ process. This can be used to ignore `GIO_LAUNCHED_DESKTOP_FILE`, should it be inherited by further processes. The `DISPLAY` and `DESKTOP_STARTUP_ID` environment variables are also set, based on information provided in @context. - %TRUE on successful launch, %FALSE otherwise. @@ -2906,7 +2832,6 @@ To launch the application without arguments pass a %NULL @uris list. Note that even if the launch is successful the application launched can fail to start if it runs into problems during startup. There is no way to detect this. - %TRUE on successful launch, %FALSE otherwise. @@ -2935,7 +2860,6 @@ The @callback is invoked immediately after the application launch, but it waits for activation in case of D-Bus–activated applications and also provides extended error information for sandboxed applications, see notes for g_app_info_launch_default_for_uri_async(). - @@ -2970,7 +2894,6 @@ g_app_info_launch_default_for_uri_async(). Finishes a g_app_info_launch_uris_async() operation. - %TRUE on successful launch, %FALSE otherwise. @@ -2988,7 +2911,6 @@ g_app_info_launch_default_for_uri_async(). Removes a supported type from an application, if possible. - %TRUE on success, %FALSE on error. @@ -3006,7 +2928,6 @@ g_app_info_launch_default_for_uri_async(). Sets the application as the default handler for the given file extension. - %TRUE on success, %FALSE on error. @@ -3025,7 +2946,6 @@ g_app_info_launch_default_for_uri_async(). Sets the application as the default handler for a given type. - %TRUE on success, %FALSE on error. @@ -3046,7 +2966,6 @@ g_app_info_launch_default_for_uri_async(). This will make the application appear as first in the list returned by g_app_info_get_recommended_for_type(), regardless of the default application for that content type. - %TRUE on success, %FALSE on error. @@ -3065,7 +2984,6 @@ application for that content type. Checks if the application info should be shown in menus that list available applications. - %TRUE if the @appinfo should be shown, %FALSE otherwise. @@ -3079,7 +2997,6 @@ list available applications. Checks if the application accepts files as arguments. - %TRUE if the @appinfo supports files. @@ -3093,7 +3010,6 @@ list available applications. Checks if the application supports reading files and directories from URIs. - %TRUE if the @appinfo supports URIs. @@ -3108,7 +3024,6 @@ list available applications. Adds a content type to the application information to indicate the application is capable of opening files with the given content type. - %TRUE on success, %FALSE on error. @@ -3127,7 +3042,6 @@ application is capable of opening files with the given content type. Obtains the information whether the #GAppInfo can be deleted. See g_app_info_delete(). - %TRUE if @appinfo can be deleted @@ -3141,7 +3055,6 @@ See g_app_info_delete(). Checks if a supported content type can be removed from an application. - %TRUE if it is possible to remove supported content types from a given @appinfo, %FALSE if not. @@ -3160,7 +3073,6 @@ See g_app_info_delete(). On some platforms, there may be a difference between user-defined #GAppInfos which can be deleted, and system-wide ones which cannot. See g_app_info_can_delete(). - %TRUE if @appinfo has been deleted @@ -3174,7 +3086,6 @@ See g_app_info_can_delete(). Creates a duplicate of a #GAppInfo. - a duplicate of @appinfo. @@ -3189,10 +3100,9 @@ See g_app_info_can_delete(). Checks if two #GAppInfos are equal. -Note that the check <emphasis>may not</emphasis> compare each individual +Note that the check *may not* compare each individual field, and only does an identity check. In case detecting changes in the contents is needed, program code must additionally compare relevant fields. - %TRUE if @appinfo1 is equal to @appinfo2. %FALSE otherwise. @@ -3211,8 +3121,7 @@ contents is needed, program code must additionally compare relevant fields. Gets the commandline with which the application will be started. - - + a string containing the @appinfo's commandline, or %NULL if this information is not available @@ -3226,8 +3135,7 @@ started. Gets a human-readable description of an installed application. - - + a string containing a description of the application @appinfo, or %NULL if none. @@ -3242,7 +3150,6 @@ application @appinfo, or %NULL if none. Gets the display name of the application. The display name is often more descriptive to the user than the name itself. - the display name of the application for @appinfo, or the name if no display name is available. @@ -3257,7 +3164,6 @@ no display name is available. Gets the executable's name for the installed application. - a string containing the @appinfo's application binaries name @@ -3272,8 +3178,7 @@ binaries name Gets the icon for the application. - - + the default #GIcon for @appinfo or %NULL if there is no default icon. @@ -3293,8 +3198,7 @@ desktop file id from the xdg menu specification. Note that the returned ID may be %NULL, depending on how the @appinfo has been constructed. - - + a string containing the application's ID. @@ -3307,7 +3211,6 @@ the @appinfo has been constructed. Gets the installed name of the application. - the name of the application for @appinfo. @@ -3326,7 +3229,6 @@ will return %NULL. This function does not take in consideration associations added with g_app_info_add_supports_type(), but only those exported directly by the application. - a list of content types. @@ -3369,7 +3271,6 @@ process. This can be used to ignore `GIO_LAUNCHED_DESKTOP_FILE`, should it be inherited by further processes. The `DISPLAY` and `DESKTOP_STARTUP_ID` environment variables are also set, based on information provided in @context. - %TRUE on successful launch, %FALSE otherwise. @@ -3402,7 +3303,6 @@ To launch the application without arguments pass a %NULL @uris list. Note that even if the launch is successful the application launched can fail to start if it runs into problems during startup. There is no way to detect this. - %TRUE on successful launch, %FALSE otherwise. @@ -3431,7 +3331,6 @@ The @callback is invoked immediately after the application launch, but it waits for activation in case of D-Bus–activated applications and also provides extended error information for sandboxed applications, see notes for g_app_info_launch_default_for_uri_async(). - @@ -3466,7 +3365,6 @@ g_app_info_launch_default_for_uri_async(). Finishes a g_app_info_launch_uris_async() operation. - %TRUE on successful launch, %FALSE otherwise. @@ -3484,7 +3382,6 @@ g_app_info_launch_default_for_uri_async(). Removes a supported type from an application, if possible. - %TRUE on success, %FALSE on error. @@ -3502,7 +3399,6 @@ g_app_info_launch_default_for_uri_async(). Sets the application as the default handler for the given file extension. - %TRUE on success, %FALSE on error. @@ -3521,7 +3417,6 @@ g_app_info_launch_default_for_uri_async(). Sets the application as the default handler for a given type. - %TRUE on success, %FALSE on error. @@ -3542,7 +3437,6 @@ g_app_info_launch_default_for_uri_async(). This will make the application appear as first in the list returned by g_app_info_get_recommended_for_type(), regardless of the default application for that content type. - %TRUE on success, %FALSE on error. @@ -3561,7 +3455,6 @@ application for that content type. Checks if the application info should be shown in menus that list available applications. - %TRUE if the @appinfo should be shown, %FALSE otherwise. @@ -3575,7 +3468,6 @@ list available applications. Checks if the application accepts files as arguments. - %TRUE if the @appinfo supports files. @@ -3589,7 +3481,6 @@ list available applications. Checks if the application supports reading files and directories from URIs. - %TRUE if the @appinfo supports URIs. @@ -3619,14 +3510,12 @@ list available applications. Application Information interface, for operating system portability. - The parent interface. - a duplicate of @appinfo. @@ -3641,7 +3530,6 @@ list available applications. - %TRUE if @appinfo1 is equal to @appinfo2. %FALSE otherwise. @@ -3660,8 +3548,7 @@ list available applications. - - + a string containing the application's ID. @@ -3675,7 +3562,6 @@ list available applications. - the name of the application for @appinfo. @@ -3690,8 +3576,7 @@ list available applications. - - + a string containing a description of the application @appinfo, or %NULL if none. @@ -3706,12 +3591,14 @@ application @appinfo, or %NULL if none. - - + a string containing the @appinfo's application +binaries name + + a #GAppInfo @@ -3719,8 +3606,7 @@ application @appinfo, or %NULL if none. - - + the default #GIcon for @appinfo or %NULL if there is no default icon. @@ -3735,7 +3621,6 @@ if there is no default icon. - %TRUE on successful launch, %FALSE otherwise. @@ -3760,7 +3645,6 @@ if there is no default icon. - %TRUE if the @appinfo supports URIs. @@ -3775,7 +3659,6 @@ if there is no default icon. - %TRUE if the @appinfo supports files. @@ -3790,7 +3673,6 @@ if there is no default icon. - %TRUE on successful launch, %FALSE otherwise. @@ -3815,7 +3697,6 @@ if there is no default icon. - %TRUE if the @appinfo should be shown, %FALSE otherwise. @@ -3830,7 +3711,6 @@ if there is no default icon. - %TRUE on success, %FALSE on error. @@ -3849,7 +3729,6 @@ if there is no default icon. - %TRUE on success, %FALSE on error. @@ -3869,7 +3748,6 @@ if there is no default icon. - %TRUE on success, %FALSE on error. @@ -3888,7 +3766,6 @@ if there is no default icon. - %TRUE if it is possible to remove supported content types from a given @appinfo, %FALSE if not. @@ -3904,7 +3781,6 @@ if there is no default icon. - %TRUE on success, %FALSE on error. @@ -3923,7 +3799,6 @@ if there is no default icon. - %TRUE if @appinfo can be deleted @@ -3938,7 +3813,6 @@ if there is no default icon. - %TRUE if @appinfo has been deleted @@ -3953,12 +3827,14 @@ if there is no default icon. - - - + + a string containing the @appinfo's commandline, + or %NULL if this information is not available + + a #GAppInfo @@ -3966,7 +3842,6 @@ if there is no default icon. - the display name of the application for @appinfo, or the name if no display name is available. @@ -3982,7 +3857,6 @@ no display name is available. - %TRUE on success, %FALSE on error. @@ -4001,7 +3875,6 @@ no display name is available. - a list of content types. @@ -4019,7 +3892,6 @@ no display name is available. - @@ -4055,7 +3927,6 @@ no display name is available. - %TRUE on successful launch, %FALSE otherwise. @@ -4101,7 +3972,6 @@ applications (as reported by g_app_info_get_all()) may have changed. You must only call g_object_unref() on the return value from under the same main context as you created it. - a reference to a #GAppInfoMonitor @@ -4119,11 +3989,9 @@ or removed applications). Integrating the launch with the launching application. This is used to handle for instance startup notification and launching the new application on the same screen as the launching window. - Creates a new application launch context. This is not normally used, instead you instantiate a subclass of this, such as #GdkAppLaunchContext. - a #GAppLaunchContext. @@ -4133,8 +4001,7 @@ instead you instantiate a subclass of this, such as #GdkAppLaunchContext. Gets the display string for the @context. This is used to ensure new applications are started on the same display as the launching application, by setting the `DISPLAY` environment variable. - - + a display string for the display. @@ -4161,8 +4028,7 @@ application, by setting the `DISPLAY` environment variable. Startup notification IDs are defined in the [FreeDesktop.Org Startup Notifications standard](http://standards.freedesktop.org/startup-notification-spec/startup-notification-latest.txt). - - + a startup notification ID for the application, or %NULL if not supported. @@ -4187,7 +4053,6 @@ Startup notification IDs are defined in the Called when an application has failed to launch, so that it can cancel the application startup notification started in g_app_launch_context_get_startup_notify_id(). - @@ -4203,7 +4068,6 @@ the application startup notification started in g_app_launch_context_get_startup - @@ -4223,8 +4087,7 @@ the application startup notification started in g_app_launch_context_get_startup Gets the display string for the @context. This is used to ensure new applications are started on the same display as the launching application, by setting the `DISPLAY` environment variable. - - + a display string for the display. @@ -4250,7 +4113,6 @@ application, by setting the `DISPLAY` environment variable. the child process when @context is used to launch an application. This is a %NULL-terminated array of strings, where each string has the form `KEY=VALUE`. - the child's environment @@ -4271,8 +4133,7 @@ the form `KEY=VALUE`. Startup notification IDs are defined in the [FreeDesktop.Org Startup Notifications standard](http://standards.freedesktop.org/startup-notification-spec/startup-notification-latest.txt). - - + a startup notification ID for the application, or %NULL if not supported. @@ -4297,7 +4158,6 @@ Startup notification IDs are defined in the Called when an application has failed to launch, so that it can cancel the application startup notification started in g_app_launch_context_get_startup_notify_id(). - @@ -4315,7 +4175,6 @@ the application startup notification started in g_app_launch_context_get_startup Arranges for @variable to be set to @value in the child's environment when @context is used to launch an application. - @@ -4337,7 +4196,6 @@ environment when @context is used to launch an application. Arranges for @variable to be unset in the child's environment when @context is used to launch an application. - @@ -4394,14 +4252,12 @@ platform-specific data about this launch. On UNIX, at least the - - - + a display string for the display. @@ -4425,8 +4281,7 @@ platform-specific data about this launch. On UNIX, at least the - - + a startup notification ID for the application, or %NULL if not supported. @@ -4451,7 +4306,6 @@ platform-specific data about this launch. On UNIX, at least the - @@ -4469,7 +4323,6 @@ platform-specific data about this launch. On UNIX, at least the - @@ -4488,7 +4341,6 @@ platform-specific data about this launch. On UNIX, at least the - @@ -4496,7 +4348,6 @@ platform-specific data about this launch. On UNIX, at least the - @@ -4504,7 +4355,6 @@ platform-specific data about this launch. On UNIX, at least the - @@ -4512,16 +4362,13 @@ platform-specific data about this launch. On UNIX, at least the - - - - + A #GApplication is the foundation of an application. It wraps some low-level platform-specific services and is intended to act as the @@ -4637,7 +4484,6 @@ For an example of using actions with GApplication, see For an example of using extra D-Bus hooks with GApplication, see [gapplication-example-dbushooks.c](https://git.gnome.org/browse/glib/tree/gio/tests/gapplication-example-dbushooks.c). - @@ -4648,7 +4494,6 @@ g_application_id_is_valid(). If no application ID is given then some features of #GApplication (most notably application uniqueness) will be disabled. - a new #GApplication instance @@ -4672,8 +4517,7 @@ the default when it is created. You can exercise more control over this by using g_application_set_default(). If there is no default application then %NULL is returned. - - + the default application for this process, or %NULL @@ -4724,7 +4568,6 @@ hyphen/minus characters they should be replaced by underscores, and if it contains leading digits they should be escaped by prepending an underscore. For example, if the owner of 7-zip.org used an application identifier for an archiving application, it might be named `org._7_zip.Archiver`. - %TRUE if @application_id is valid @@ -4743,7 +4586,6 @@ In essence, this results in the #GApplication::activate signal being emitted in the primary instance. The application must be registered before calling this function. - @@ -4755,7 +4597,6 @@ The application must be registered before calling this function. - @@ -4769,7 +4610,6 @@ The application must be registered before calling this function. - @@ -4783,7 +4623,6 @@ The application must be registered before calling this function. - @@ -4797,7 +4636,6 @@ The application must be registered before calling this function. - @@ -4811,7 +4649,6 @@ The application must be registered before calling this function. - @@ -4828,7 +4665,6 @@ The application must be registered before calling this function. - @@ -4845,7 +4681,6 @@ The application must be registered before calling this function. - @@ -4869,7 +4704,6 @@ variable which can used to set the exit status that is returned from g_application_run(). See g_application_run() for more details on #GApplication startup. - %TRUE if the commandline has been completely handled @@ -4892,7 +4726,6 @@ See g_application_run() for more details on #GApplication startup. - @@ -4917,7 +4750,6 @@ for this functionality, you should use "". The application must be registered before calling this function and it must have the %G_APPLICATION_HANDLES_OPEN flag set. - @@ -4943,7 +4775,6 @@ and it must have the %G_APPLICATION_HANDLES_OPEN flag set. - @@ -4954,7 +4785,6 @@ and it must have the %G_APPLICATION_HANDLES_OPEN flag set. - @@ -4965,7 +4795,6 @@ and it must have the %G_APPLICATION_HANDLES_OPEN flag set. - @@ -4976,7 +4805,6 @@ and it must have the %G_APPLICATION_HANDLES_OPEN flag set. - @@ -4993,7 +4821,6 @@ In essence, this results in the #GApplication::activate signal being emitted in the primary instance. The application must be registered before calling this function. - @@ -5018,7 +4845,6 @@ be sent to the primary instance. See g_application_add_main_option_entries() for more details. See #GOptionEntry for more documentation of the arguments. - @@ -5109,7 +4935,6 @@ the options with g_variant_dict_lookup(): - for %G_OPTION_ARG_FILENAME, use `^&ay` - for %G_OPTION_ARG_STRING_ARRAY, use `^a&s` - for %G_OPTION_ARG_FILENAME_ARRAY, use `^a&ay` - @@ -5153,7 +4978,6 @@ Calling this function will cause the options in the supplied option group to be parsed, but it does not cause you to be "opted in" to the new functionality whereby unrecognised options are rejected even if %G_APPLICATION_HANDLES_COMMAND_LINE was given. - @@ -5175,7 +4999,6 @@ new functionality whereby unrecognised options are rejected even if The binding holds a reference to @application while it is active, but not to @object. Instead, the binding is destroyed when @object is finalized. - @@ -5196,8 +5019,7 @@ finalized. Gets the unique identifier for @application. - - + the identifier for @application, owned by @application @@ -5222,8 +5044,7 @@ normally be in use but we were unable to connect to the bus. This function must not be called before the application has been registered. See g_application_get_is_registered(). - - + a #GDBusConnection, or %NULL @@ -5249,8 +5070,7 @@ normally be in use but we were unable to connect to the bus. This function must not be called before the application has been registered. See g_application_get_is_registered(). - - + the object path, or %NULL @@ -5265,7 +5085,6 @@ registered. See g_application_get_is_registered(). Gets the flags for @application. See #GApplicationFlags. - the flags for @application @@ -5282,7 +5101,6 @@ See #GApplicationFlags. This is the amount of time (in milliseconds) after the last call to g_application_release() before the application stops running. - the timeout, in milliseconds @@ -5297,7 +5115,6 @@ g_application_release() before the application stops running. Gets the application's current busy state, as set through g_application_mark_busy() or g_application_bind_busy_property(). - %TRUE if @application is currently marked as busy @@ -5314,7 +5131,6 @@ g_application_mark_busy() or g_application_bind_busy_property(). An application is registered if g_application_register() has been successfully called. - %TRUE if @application is registered @@ -5337,7 +5153,6 @@ performed by the primary instance. The value of this property cannot be accessed before g_application_register() has been called. See g_application_get_is_registered(). - %TRUE if @application is remote @@ -5353,7 +5168,6 @@ g_application_get_is_registered(). Gets the resource base path of @application. See g_application_set_resource_base_path() for more information. - the base resource path, if one is set @@ -5373,7 +5187,6 @@ continue to run. For example, g_application_hold() is called by GTK+ when a toplevel window is on the screen. To cancel the hold, call g_application_release(). - @@ -5395,7 +5208,6 @@ use that information to indicate the state to the user (e.g. with a spinner). To cancel the busy indication, use g_application_unmark_busy(). - @@ -5421,7 +5233,6 @@ for this functionality, you should use "". The application must be registered before calling this function and it must have the %G_APPLICATION_HANDLES_OPEN flag set. - @@ -5460,7 +5271,6 @@ through gtk_application_add_window().) The result of calling g_application_run() again after it returns is unspecified. - @@ -5502,7 +5312,6 @@ is set appropriately. Note: the return value of this function is not an indicator that this instance is or is not the primary instance of the application. See g_application_get_is_remote() for that. - %TRUE if registration succeeded @@ -5525,7 +5334,6 @@ When the use count reaches zero, the application will stop running. Never call this function except to cancel the effect of a previous call to g_application_hold(). - @@ -5612,7 +5420,6 @@ approach is suitable for use by most graphical applications but should not be used from applications like editors that need precise control over when processes invoked via the commandline will exit and what their exit status will be. - the exit status @@ -5662,7 +5469,6 @@ notifications without an id. If @notification is no longer relevant, it can be withdrawn with g_application_withdraw_notification(). - @@ -5689,7 +5495,6 @@ mix use of this API with use of #GActionMap on the same @application or things will go very badly wrong. This function is known to introduce buggy behaviour (ie: signals not emitted on changes to the action group), so you should really use #GActionMap instead. - @@ -5712,7 +5517,6 @@ been registered. If non-%NULL, the application id must be valid. See g_application_id_is_valid(). - @@ -5734,7 +5538,6 @@ by g_application_get_default(). This function does not take its own reference on @application. If @application is destroyed then the default application will revert back to %NULL. - @@ -5752,7 +5555,6 @@ The flags can only be modified if @application has not yet been registered. See #GApplicationFlags. - @@ -5776,7 +5578,6 @@ g_application_release() before the application stops running. This call has no side effects of its own. The value set here is only used for next time g_application_release() drops the use count to zero. Any timeouts currently in progress are not impacted. - @@ -5795,7 +5596,6 @@ zero. Any timeouts currently in progress are not impacted. Adds a description to the @application option context. See g_option_context_set_description() for more information. - @@ -5818,7 +5618,6 @@ This function registers the argument to be passed to g_option_context_new() when the internal #GOptionContext of @application is created. See g_option_context_new() for more information about @parameter_string. - @@ -5838,7 +5637,6 @@ See g_option_context_new() for more information about @parameter_string. Adds a summary to the @application option context. See g_option_context_set_summary() for more information. - @@ -5888,7 +5686,6 @@ a sub-class of #GApplication you should either set the this function during the instance initialization. Alternatively, you can call this function in the #GApplicationClass.startup virtual function, before chaining up to the parent implementation. - @@ -5907,7 +5704,6 @@ before chaining up to the parent implementation. Destroys a binding between @property and the busy state of @application that was previously created with g_application_bind_busy_property(). - @@ -5934,7 +5730,6 @@ to other processes. This function must only be called to cancel the effect of a previous call to g_application_mark_busy(). - @@ -5959,7 +5754,6 @@ the sent notification. Note that notifications are dismissed when the user clicks on one of the buttons in a notification or triggers its default action, so there is no need to explicitly withdraw the notification in that case. - @@ -6137,13 +5931,11 @@ after registration. See g_application_register(). Virtual function table for #GApplication. - - @@ -6156,7 +5948,6 @@ after registration. See g_application_register(). - @@ -6170,7 +5961,6 @@ after registration. See g_application_register(). - @@ -6198,7 +5988,6 @@ after registration. See g_application_register(). - @@ -6214,7 +6003,6 @@ after registration. See g_application_register(). - %TRUE if the commandline has been completely handled @@ -6239,7 +6027,6 @@ after registration. See g_application_register(). - @@ -6255,7 +6042,6 @@ after registration. See g_application_register(). - @@ -6271,7 +6057,6 @@ after registration. See g_application_register(). - @@ -6287,7 +6072,6 @@ after registration. See g_application_register(). - @@ -6300,7 +6084,6 @@ after registration. See g_application_register(). - @@ -6313,7 +6096,6 @@ after registration. See g_application_register(). - @@ -6326,7 +6108,6 @@ after registration. See g_application_register(). - @@ -6345,7 +6126,6 @@ after registration. See g_application_register(). - @@ -6364,7 +6144,6 @@ after registration. See g_application_register(). - @@ -6380,7 +6159,6 @@ after registration. See g_application_register(). - @@ -6552,20 +6330,18 @@ hold the application until you are done with the commandline. The complete example can be found here: [gapplication-example-cmdline3.c](https://git.gnome.org/browse/glib/tree/gio/tests/gapplication-example-cmdline3.c) - Gets the stdin of the invoking process. The #GInputStream can be used to read data passed to the standard input of the invoking process. This doesn't work on all platforms. Presently, it is only available -on UNIX when using a DBus daemon capable of passing file descriptors. +on UNIX when using a D-Bus daemon capable of passing file descriptors. If stdin is not available then %NULL will be returned. In the future, support may be expanded to other platforms. You must only call this function once per commandline invocation. - - + a #GInputStream for stdin @@ -6577,7 +6353,6 @@ You must only call this function once per commandline invocation. - @@ -6591,7 +6366,6 @@ You must only call this function once per commandline invocation. - @@ -6611,7 +6385,6 @@ of the invocation of @cmdline. This differs from g_file_new_for_commandline_arg() in that it resolves relative pathnames using the current working directory of the invoking process rather than the local process. - a new #GFile @@ -6639,7 +6412,6 @@ use g_option_context_parse_strv(). The return value is %NULL-terminated and should be freed using g_strfreev(). - the string array containing the arguments (the argv) @@ -6667,7 +6439,6 @@ directory, so this may be %NULL. The return value should not be modified or freed and is valid for as long as @cmdline exists. - the current directory, or %NULL @@ -6695,7 +6466,6 @@ long as @cmdline exists. See g_application_command_line_getenv() if you are only interested in the value of a single environment variable. - the environment strings, or %NULL if they were not sent @@ -6713,7 +6483,6 @@ in the value of a single environment variable. Gets the exit status of @cmdline. See g_application_command_line_set_exit_status() for more information. - the exit status @@ -6727,7 +6496,6 @@ g_application_command_line_set_exit_status() for more information. Determines if @cmdline represents a remote invocation. - %TRUE if the invocation was remote @@ -6749,7 +6517,6 @@ modified from your GApplication::handle-local-options handler. If no options were sent then an empty dictionary is returned so that you don't need to check for %NULL. - a #GVariantDict with the options @@ -6770,7 +6537,6 @@ information like the current working directory and the startup notification ID. For local invocation, it will be %NULL. - the platform data, or %NULL @@ -6788,13 +6554,12 @@ For local invocation, it will be %NULL. The #GInputStream can be used to read data passed to the standard input of the invoking process. This doesn't work on all platforms. Presently, it is only available -on UNIX when using a DBus daemon capable of passing file descriptors. +on UNIX when using a D-Bus daemon capable of passing file descriptors. If stdin is not available then %NULL will be returned. In the future, support may be expanded to other platforms. You must only call this function once per commandline invocation. - - + a #GInputStream for stdin @@ -6817,8 +6582,7 @@ to invocation messages from other applications). The return value should not be modified or freed and is valid for as long as @cmdline exists. - - + the value of the variable, or %NULL if unset or unsent @@ -6840,7 +6604,6 @@ invoking process. If @cmdline is a local invocation then this is exactly equivalent to g_print(). If @cmdline is remote then this is equivalent to calling g_print() in the invoking process. - @@ -6866,7 +6629,6 @@ invoking process. If @cmdline is a local invocation then this is exactly equivalent to g_printerr(). If @cmdline is remote then this is equivalent to calling g_printerr() in the invoking process. - @@ -6907,7 +6669,6 @@ increased to a non-zero value) then the application is considered to have been 'successful' in a certain sense, and the exit status is always zero. If the application use count is zero, though, the exit status of the local #GApplicationCommandLine is used. - @@ -6944,13 +6705,11 @@ status of the local #GApplicationCommandLine is used. The #GApplicationCommandLineClass-struct contains private data only. - - @@ -6966,7 +6725,6 @@ contains private data only. - @@ -6982,8 +6740,7 @@ contains private data only. - - + a #GInputStream for stdin @@ -7001,9 +6758,7 @@ contains private data only. - - - + Flags used to define the behaviour of a #GApplication. @@ -7064,9 +6819,7 @@ contains private data only. Since: 2.60 - - - + #GAskPasswordFlags are used to request specific information from the user, or to notify the user of their choices in an authentication @@ -7190,7 +6943,6 @@ foo_async_initable_iface_init (gpointer g_iface, iface->init_finish = foo_init_finish; } ]| - Helper function for constructing #GAsyncInitable object. This is similar to g_object_new() but also initializes the object asynchronously. @@ -7198,7 +6950,6 @@ similar to g_object_new() but also initializes the object asynchronously. When the initialization is finished, @callback will be called. You can then call g_async_initable_new_finish() to get the new object and check for any errors. - @@ -7244,7 +6995,6 @@ asynchronously. When the initialization is finished, @callback will be called. You can then call g_async_initable_new_finish() to get the new object and check for any errors. - @@ -7290,7 +7040,6 @@ then call g_async_initable_new_finish() to get the new object and check for any errors. Use g_object_new_with_properties() and g_async_initable_init_async() instead. See #GParameter for more information. - @@ -7363,7 +7112,6 @@ implementation of this method will run the g_initable_init() function in a thread, so if you want to support asynchronous initialization via threads, just implement the #GAsyncInitable interface without overriding any interface methods. - @@ -7393,7 +7141,6 @@ any interface methods. Finishes asynchronous initialization and returns the result. See g_async_initable_init_async(). - %TRUE if successful. If an error has occurred, this function will return %FALSE and set @error appropriately if present. @@ -7447,7 +7194,6 @@ implementation of this method will run the g_initable_init() function in a thread, so if you want to support asynchronous initialization via threads, just implement the #GAsyncInitable interface without overriding any interface methods. - @@ -7477,7 +7223,6 @@ any interface methods. Finishes asynchronous initialization and returns the result. See g_async_initable_init_async(). - %TRUE if successful. If an error has occurred, this function will return %FALSE and set @error appropriately if present. @@ -7497,7 +7242,6 @@ will return %FALSE and set @error appropriately if present. Finishes the async construction for the various g_async_initable_new calls, returning the created object or %NULL on error. - a newly created #GObject, or %NULL on error. Free with g_object_unref(). @@ -7518,14 +7262,12 @@ calls, returning the created object or %NULL on error. Provides an interface for asynchronous initializing object such that initialization may fail. - The parent interface. - @@ -7555,7 +7297,6 @@ initialization may fail. - %TRUE if successful. If an error has occurred, this function will return %FALSE and set @error appropriately if present. @@ -7583,7 +7324,6 @@ iteration of the where the #GTask was created. All other users of #GAsyncReadyCallback must likewise call it asynchronously in a later iteration of the main context. - @@ -7687,10 +7427,8 @@ I/O scheduling. Priorities are integers, with lower numbers indicating higher priority. It is recommended to choose priorities between %G_PRIORITY_LOW and %G_PRIORITY_HIGH, with %G_PRIORITY_DEFAULT as a default. - Gets the source object from a #GAsyncResult. - a new reference to the source object for the @res, or %NULL if there is none. @@ -7705,7 +7443,6 @@ as a default. Gets the user data from a #GAsyncResult. - the user data for @res. @@ -7720,7 +7457,6 @@ as a default. Checks if @res has the given @source_tag (generally a function pointer indicating the function @res was created by). - %TRUE if @res has the indicated @source_tag, %FALSE if not. @@ -7739,7 +7475,6 @@ pointer indicating the function @res was created by). Gets the source object from a #GAsyncResult. - a new reference to the source object for the @res, or %NULL if there is none. @@ -7754,7 +7489,6 @@ pointer indicating the function @res was created by). Gets the user data from a #GAsyncResult. - the user data for @res. @@ -7769,7 +7503,6 @@ pointer indicating the function @res was created by). Checks if @res has the given @source_tag (generally a function pointer indicating the function @res was created by). - %TRUE if @res has the indicated @source_tag, %FALSE if not. @@ -7797,7 +7530,6 @@ error returns themselves rather than calling into the virtual method. This should not be used in new code; #GAsyncResult errors that are set by virtual methods should also be extracted by virtual methods, to enable subclasses to chain up correctly. - %TRUE if @error is has been filled in with an error from @res, %FALSE if not. @@ -7813,14 +7545,12 @@ to enable subclasses to chain up correctly. Interface definition for #GAsyncResult. - The parent interface. - the user data for @res. @@ -7835,7 +7565,6 @@ to enable subclasses to chain up correctly. - a new reference to the source object for the @res, or %NULL if there is none. @@ -7851,7 +7580,6 @@ to enable subclasses to chain up correctly. - %TRUE if @res has the indicated @source_tag, %FALSE if not. @@ -7871,49 +7599,42 @@ to enable subclasses to chain up correctly. - - - - - - - @@ -7934,12 +7655,10 @@ g_buffered_input_stream_get_buffer_size(). To change the size of a buffered input stream's buffer, use g_buffered_input_stream_set_buffer_size(). Note that the buffer's size cannot be reduced below the size of the data within the buffer. - Creates a new #GInputStream from the given @base_stream, with a buffer set to the default size (4 kilobytes). - a #GInputStream for the given @base_stream. @@ -7954,7 +7673,6 @@ a buffer set to the default size (4 kilobytes). Creates a new #GBufferedInputStream from the given @base_stream, with a buffer set to @size. - a #GInputStream. @@ -7995,7 +7713,6 @@ On error -1 is returned and @error is set accordingly. For the asynchronous, non-blocking, version of this function, see g_buffered_input_stream_fill_async(). - the number of bytes read into @stream's buffer, up to @count, or -1 on error. @@ -8023,7 +7740,6 @@ version of this function, see g_buffered_input_stream_fill(). If @count is -1 then the attempted read size is equal to the number of bytes that are required to fill the buffer. - @@ -8056,7 +7772,6 @@ of bytes that are required to fill the buffer. Finishes an asynchronous read. - a #gssize of the read stream, or `-1` on an error. @@ -8097,7 +7812,6 @@ On error -1 is returned and @error is set accordingly. For the asynchronous, non-blocking, version of this function, see g_buffered_input_stream_fill_async(). - the number of bytes read into @stream's buffer, up to @count, or -1 on error. @@ -8125,7 +7839,6 @@ version of this function, see g_buffered_input_stream_fill(). If @count is -1 then the attempted read size is equal to the number of bytes that are required to fill the buffer. - @@ -8158,7 +7871,6 @@ of bytes that are required to fill the buffer. Finishes an asynchronous read. - a #gssize of the read stream, or `-1` on an error. @@ -8176,7 +7888,6 @@ of bytes that are required to fill the buffer. Gets the size of the available data within the stream. - size of the available stream. @@ -8190,7 +7901,6 @@ of bytes that are required to fill the buffer. Gets the size of the input buffer. - the current buffer size. @@ -8205,7 +7915,6 @@ of bytes that are required to fill the buffer. Peeks in the buffer, copying data of size @count into @buffer, offset @offset bytes. - a #gsize of the number of bytes peeked, or -1 on error. @@ -8236,7 +7945,6 @@ offset @offset bytes. Returns the buffer with the currently available bytes. The returned buffer must not be modified and will become invalid when reading from the stream or filling the buffer. - read-only buffer @@ -8269,7 +7977,6 @@ operation was partially finished when the operation was cancelled the partial result will be returned, without an error. On error -1 is returned and @error is set accordingly. - the byte read from the @stream, or -1 on end of stream or error. @@ -8289,7 +7996,6 @@ On error -1 is returned and @error is set accordingly. Sets the size of the internal buffer of @stream to @size, or to the size of the contents of the buffer. The buffer can never be resized smaller than its current contents. - @@ -8315,13 +8021,11 @@ smaller than its current contents. - - the number of bytes read into @stream's buffer, up to @count, or -1 on error. @@ -8345,7 +8049,6 @@ smaller than its current contents. - @@ -8379,7 +8082,6 @@ smaller than its current contents. - a #gssize of the read stream, or `-1` on an error. @@ -8398,7 +8100,6 @@ smaller than its current contents. - @@ -8406,7 +8107,6 @@ smaller than its current contents. - @@ -8414,7 +8114,6 @@ smaller than its current contents. - @@ -8422,7 +8121,6 @@ smaller than its current contents. - @@ -8430,16 +8128,13 @@ smaller than its current contents. - - - - + Buffered output stream implements #GFilterOutputStream and provides for buffered writes. @@ -8455,11 +8150,9 @@ g_buffered_output_stream_get_buffer_size(). To change the size of a buffered output stream's buffer, use g_buffered_output_stream_set_buffer_size(). Note that the buffer's size cannot be reduced below the size of the data within the buffer. - Creates a new buffered output stream for a base stream. - a #GOutputStream for the given @base_stream. @@ -8473,7 +8166,6 @@ size cannot be reduced below the size of the data within the buffer. Creates a new buffered output stream with a given buffer size. - a #GOutputStream with an internal buffer set to @size. @@ -8491,7 +8183,6 @@ size cannot be reduced below the size of the data within the buffer. Checks if the buffer automatically grows as data is added. - %TRUE if the @stream's buffer automatically grows, %FALSE otherwise. @@ -8506,7 +8197,6 @@ size cannot be reduced below the size of the data within the buffer. Gets the size of the buffer in the @stream. - the current size of the buffer. @@ -8523,7 +8213,6 @@ size cannot be reduced below the size of the data within the buffer. If @auto_grow is true, then each write will just make the buffer larger, and you must manually flush the buffer to actually write out the data to the underlying stream. - @@ -8540,7 +8229,6 @@ the data to the underlying stream. Sets the size of the internal buffer to @size. - @@ -8569,13 +8257,11 @@ the data to the underlying stream. - - @@ -8583,19 +8269,15 @@ the data to the underlying stream. - - - - + Invoked when a connection to a message bus has been obtained. - @@ -8616,7 +8298,6 @@ the data to the underlying stream. Invoked when the name is acquired. - @@ -8637,7 +8318,6 @@ the data to the underlying stream. Invoked when the name being watched is known to have to have an owner. - @@ -8662,7 +8342,6 @@ the data to the underlying stream. Invoked when the name is lost or @connection has been closed. - @@ -8705,7 +8384,6 @@ return an error from g_bus_own_name() rather than entering the waiting queue for This is also invoked when the #GDBusConnection on which the watch was established has been closed. In that case, @connection will be %NULL. - @@ -8757,11 +8435,13 @@ png) to be used as icon. - Creates a new icon for a bytes. - + Creates a new icon for a bytes. + +This cannot fail, but loading and interpreting the bytes may fail later on +(for example, if g_loadable_icon_load() is called) if the image is invalid. a #GIcon for the given - @bytes, or %NULL on error. + @bytes. @@ -8773,9 +8453,8 @@ png) to be used as icon. Gets the #GBytes associated with the given @icon. - - a #GBytes, or %NULL. + a #GBytes. @@ -8791,119 +8470,102 @@ png) to be used as icon. - - - - - - - - - - - - - - - - - @@ -8913,7 +8575,6 @@ png) to be used as icon. GCancellable is a thread-safe operation cancellation stack used throughout GIO to allow for cancellation of synchronous and asynchronous operations. - Creates a new #GCancellable object. @@ -8923,7 +8584,6 @@ and pass it to the operations. One #GCancellable can be used in multiple consecutive operations or in multiple concurrent operations. - a #GCancellable. @@ -8931,7 +8591,6 @@ operations or in multiple concurrent operations. Gets the top cancellable from the stack. - a #GCancellable from the top of the stack, or %NULL if the stack is empty. @@ -8939,7 +8598,6 @@ of the stack, or %NULL if the stack is empty. - @@ -8966,7 +8624,6 @@ 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 the application returns to the main loop. - @@ -8996,7 +8653,6 @@ Since GLib 2.40, the lock protecting @cancellable is not held when @callback is invoked. This lifts a restriction in place for earlier GLib versions which now makes it easier to write cleanup code that unconditionally invokes e.g. g_cancellable_cancel(). - The id of the signal handler or 0 if @cancellable has already been cancelled. @@ -9036,7 +8692,6 @@ details on how to use this. If @cancellable is %NULL or @handler_id is `0` this function does nothing. - @@ -9065,7 +8720,6 @@ g_cancellable_release_fd() to free up resources allocated for the returned file descriptor. See also g_cancellable_make_pollfd(). - A valid file descriptor. `-1` if the file descriptor is not supported, or on errors. @@ -9080,7 +8734,6 @@ is not supported, or on errors. Checks if a cancellable job has been cancelled. - %TRUE if @cancellable is cancelled, FALSE if called with %NULL or if item is not cancelled. @@ -9112,7 +8765,6 @@ these cases is to ignore the @cancellable. You are not supposed to read from the fd yourself, just check for readable status. Reading to unset the readable status is done with g_cancellable_reset(). - %TRUE if @pollfd was successfully initialized, %FALSE on failure to prepare the cancellable. @@ -9132,7 +8784,6 @@ with g_cancellable_reset(). Pops @cancellable off the cancellable stack (verifying that @cancellable is on the top of the stack). - @@ -9152,7 +8803,6 @@ code that does not allow you to pass down the cancellable object. This is typically called automatically by e.g. #GFile operations, so you rarely have to call this yourself. - @@ -9173,7 +8823,6 @@ when the @cancellable is finalized. However, the @cancellable will block scarce file descriptors until it is finalized if this function is not called. This can cause the application to run out of file descriptors when many #GCancellables are used at the same time. - @@ -9196,7 +8845,6 @@ as this function might tempt you to do. The recommended practice is to drop the reference to a cancellable after cancelling it, and let it die with the outstanding async operations. You should create a fresh cancellable for further async operations. - @@ -9210,7 +8858,6 @@ create a fresh cancellable for further async operations. If the @cancellable is cancelled, sets the error to notify that the operation was cancelled. - %TRUE if @cancellable was cancelled, %FALSE if it was not @@ -9232,7 +8879,6 @@ For convenience, you can call this with a %NULL #GCancellable, in which case the source will never trigger. The new #GSource will hold a reference to the #GCancellable. - the new #GSource. @@ -9308,13 +8954,11 @@ cancellable signal should not do something that can block. - - @@ -9327,7 +8971,6 @@ cancellable signal should not do something that can block. - @@ -9335,7 +8978,6 @@ cancellable signal should not do something that can block. - @@ -9343,7 +8985,6 @@ cancellable signal should not do something that can block. - @@ -9351,7 +8992,6 @@ cancellable signal should not do something that can block. - @@ -9359,20 +8999,16 @@ cancellable signal should not do something that can block. - - - - + This is the function type of the callback used for the #GSource returned by g_cancellable_source_new(). - it should return %FALSE if the source should be removed. @@ -9391,12 +9027,10 @@ returned by g_cancellable_source_new(). #GCharsetConverter is an implementation of #GConverter based on GIConv. - Creates a new #GCharsetConverter. - a new #GCharsetConverter or %NULL on error. @@ -9414,7 +9048,6 @@ GIConv. Gets the number of fallbacks that @converter has applied so far. - the number of fallbacks that @converter has applied @@ -9428,7 +9061,6 @@ GIConv. Gets the #GCharsetConverter:use-fallback property. - %TRUE if fallbacks are used by @converter @@ -9442,7 +9074,6 @@ GIConv. Sets the #GCharsetConverter:use-fallback property. - @@ -9468,7 +9099,6 @@ GIConv. - @@ -9481,7 +9111,6 @@ stateful and may fail at any place. Some example conversions are: character set conversion, compression, decompression and regular expression replace. - This is the main operation used when converting data. It is to be called multiple times in a loop, and each time it will do some work, i.e. @@ -9565,7 +9194,6 @@ Flushing is not always possible (like if a charset converter flushes at a partial multibyte sequence). Converters are supposed to try to produce as much output as possible and then return an error (typically %G_IO_ERROR_PARTIAL_INPUT). - a #GConverterResult, %G_CONVERTER_ERROR on error. @@ -9615,7 +9243,6 @@ to produce as much output as possible and then return an error Resets all internal state in the converter, making it behave as if it was just created. If the converter has any internal state that would produce output then that output is lost. - @@ -9709,7 +9336,6 @@ Flushing is not always possible (like if a charset converter flushes at a partial multibyte sequence). Converters are supposed to try to produce as much output as possible and then return an error (typically %G_IO_ERROR_PARTIAL_INPUT). - a #GConverterResult, %G_CONVERTER_ERROR on error. @@ -9759,7 +9385,6 @@ to produce as much output as possible and then return an error Resets all internal state in the converter, making it behave as if it was just created. If the converter has any internal state that would produce output then that output is lost. - @@ -9787,14 +9412,12 @@ state that would produce output then that output is lost. Provides an interface for converting data from one type to another type. The conversion can be stateful and may fail at any place. - The parent interface. - a #GConverterResult, %G_CONVERTER_ERROR on error. @@ -9843,7 +9466,6 @@ and may fail at any place. - @@ -9862,11 +9484,9 @@ conversion of data of various types during reading. As of GLib 2.34, #GConverterInputStream implements #GPollableInputStream. - Creates a new converter input stream for the @base_stream. - a new #GInputStream. @@ -9884,7 +9504,6 @@ As of GLib 2.34, #GConverterInputStream implements Gets the #GConverter that is used by @converter_stream. - the converter of the converter input stream @@ -9907,13 +9526,11 @@ As of GLib 2.34, #GConverterInputStream implements - - @@ -9921,7 +9538,6 @@ As of GLib 2.34, #GConverterInputStream implements - @@ -9929,7 +9545,6 @@ As of GLib 2.34, #GConverterInputStream implements - @@ -9937,7 +9552,6 @@ As of GLib 2.34, #GConverterInputStream implements - @@ -9945,27 +9559,22 @@ As of GLib 2.34, #GConverterInputStream implements - - - - + Converter output stream implements #GOutputStream and allows conversion of data of various types during reading. As of GLib 2.34, #GConverterOutputStream implements #GPollableOutputStream. - Creates a new converter output stream for the @base_stream. - a new #GOutputStream. @@ -9983,7 +9592,6 @@ As of GLib 2.34, #GConverterOutputStream implements Gets the #GConverter that is used by @converter_stream. - the converter of the converter output stream @@ -10006,13 +9614,11 @@ As of GLib 2.34, #GConverterOutputStream implements - - @@ -10020,7 +9626,6 @@ As of GLib 2.34, #GConverterOutputStream implements - @@ -10028,7 +9633,6 @@ As of GLib 2.34, #GConverterOutputStream implements - @@ -10036,7 +9640,6 @@ As of GLib 2.34, #GConverterOutputStream implements - @@ -10044,16 +9647,13 @@ As of GLib 2.34, #GConverterOutputStream implements - - - - + Results returned from g_converter_convert(). @@ -10104,11 +9704,9 @@ This corresponds to %G_CREDENTIALS_TYPE_OPENBSD_SOCKPEERCRED. On Solaris (including OpenSolaris and its derivatives), the native credential type is a `ucred_t`. This corresponds to %G_CREDENTIALS_TYPE_SOLARIS_UCRED. - Creates a new #GCredentials object with credentials matching the the current process. - A #GCredentials. Free with g_object_unref(). @@ -10121,12 +9719,11 @@ the current process. It is a programming error (which will cause a warning to be logged) to use this method if there is no #GCredentials support for the OS or if @native_type isn't supported by the OS. - - The pointer to native credentials or %NULL if the -operation there is no #GCredentials support for the OS or if -@native_type isn't supported by the OS. Do not free the returned -data, it is owned by @credentials. + The pointer to native credentials or + %NULL if there is no #GCredentials support for the OS or if @native_type + isn't supported by the OS. Do not free the returned data, it is owned + by @credentials. @@ -10148,9 +9745,8 @@ This operation can fail if #GCredentials is not supported on the OS or if the native credentials type does not contain information about the UNIX process ID (for example this is the case for %G_CREDENTIALS_TYPE_APPLE_XUCRED). - - The UNIX process ID, or -1 if @error is set. + The UNIX process ID, or `-1` if @error is set. @@ -10167,9 +9763,8 @@ method is only available on UNIX platforms. This operation can fail if #GCredentials is not supported on the OS or if the native credentials type does not contain information about the UNIX user. - - The UNIX user identifier or -1 if @error is set. + The UNIX user identifier or `-1` if @error is set. @@ -10184,7 +9779,6 @@ about the UNIX user. This operation can fail if #GCredentials is not supported on the the OS. - %TRUE if @credentials and @other_credentials has the same user, %FALSE otherwise or if @error is set. @@ -10208,7 +9802,6 @@ into @credentials. It is a programming error (which will cause a warning to be logged) to use this method if there is no #GCredentials support for the OS or if @native_type isn't supported by the OS. - @@ -10235,7 +9828,6 @@ This operation can fail if #GCredentials is not supported on the OS or if the native credentials type does not contain information about the UNIX user. It can also fail if the OS does not allow the use of "spoofed" credentials. - %TRUE if @uid was set, %FALSE if error is set. @@ -10255,7 +9847,6 @@ use of "spoofed" credentials. Creates a human-readable textual representation of @credentials that can be used in logging and debug messages. The format of the returned string may change in future GLib release. - A string that should be freed with g_free(). @@ -10270,7 +9861,6 @@ returned string may change in future GLib release. Class structure for #GCredentials. - Enumeration describing different kinds of native credential types. @@ -10297,287 +9887,246 @@ returned string may change in future GLib release. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - @@ -10603,7 +10152,6 @@ This call is non-blocking. The returned action group may or may not already be filled in. The correct thing to do is connect the signals for the action group to monitor for changes and then to call g_action_group_list_actions() to get the initial list. - a #GDBusActionGroup @@ -10627,7 +10175,6 @@ g_action_group_list_actions() to get the initial list. Information about an annotation. - The reference count or -1 if statically allocated. @@ -10649,7 +10196,6 @@ g_action_group_list_actions() to get the initial list. If @info is statically allocated does nothing. Otherwise increases the reference count. - The same @info. @@ -10665,7 +10211,6 @@ the reference count. If @info is statically allocated, does nothing. Otherwise decreases the reference count of @info. When its reference count drops to 0, the memory used is freed. - @@ -10680,8 +10225,7 @@ the memory used is freed. Looks up the value of an annotation. The cost of this function is O(n) in number of annotations. - - + The value or %NULL if not found. Do not free, it is owned by @annotations. @@ -10701,7 +10245,6 @@ The cost of this function is O(n) in number of annotations. Information about an argument for a method or a signal. - The reference count or -1 if statically allocated. @@ -10723,7 +10266,6 @@ The cost of this function is O(n) in number of annotations. If @info is statically allocated does nothing. Otherwise increases the reference count. - The same @info. @@ -10739,7 +10281,6 @@ the reference count. If @info is statically allocated, does nothing. Otherwise decreases the reference count of @info. When its reference count drops to 0, the memory used is freed. - @@ -10788,7 +10329,9 @@ By default, a #GDBusServer or server-side #GDBusConnection will accept connections from any successfully authenticated user (but not from anonymous connections using the `ANONYMOUS` mechanism). If you only want to allow D-Bus connections from processes owned by the same uid -as the server, you would use a signal handler like the following: +as the server, since GLib 2.68, you should use the +%G_DBUS_SERVER_FLAGS_AUTHENTICATION_REQUIRE_SAME_USER flag. It’s equivalent +to the following signal handler: |[<!-- language="C" --> static gboolean @@ -10814,7 +10357,6 @@ on_authorize_authenticated_peer (GDBusAuthObserver *observer, ]| Creates a new #GDBusAuthObserver object. - A #GDBusAuthObserver. Free with g_object_unref(). @@ -10822,7 +10364,6 @@ on_authorize_authenticated_peer (GDBusAuthObserver *observer, Emits the #GDBusAuthObserver::allow-mechanism signal on @observer. - %TRUE if @mechanism can be used to authenticate the other peer, %FALSE if not. @@ -10840,7 +10381,6 @@ on_authorize_authenticated_peer (GDBusAuthObserver *observer, Emits the #GDBusAuthObserver::authorize-authenticated-peer signal on @observer. - %TRUE if the peer is authorized, %FALSE if not. @@ -10971,7 +10511,6 @@ Here is an example for exporting a #GObject: Finishes an operation started with g_dbus_connection_new(). - a #GDBusConnection or %NULL if @error is set. Free with g_object_unref(). @@ -10987,10 +10526,9 @@ Here is an example for exporting a #GObject: Finishes an operation started with g_dbus_connection_new_for_address(). - - a #GDBusConnection or %NULL if @error is set. Free with - g_object_unref(). + a #GDBusConnection or %NULL if @error is set. + Free with g_object_unref(). @@ -11010,18 +10548,18 @@ which must be in the This constructor can only be used to initiate client-side connections - use g_dbus_connection_new_sync() if you need to act as the server. In particular, @flags cannot contain the -%G_DBUS_CONNECTION_FLAGS_AUTHENTICATION_SERVER or -%G_DBUS_CONNECTION_FLAGS_AUTHENTICATION_ALLOW_ANONYMOUS flags. +%G_DBUS_CONNECTION_FLAGS_AUTHENTICATION_SERVER, +%G_DBUS_CONNECTION_FLAGS_AUTHENTICATION_ALLOW_ANONYMOUS or +%G_DBUS_CONNECTION_FLAGS_AUTHENTICATION_REQUIRE_SAME_USER flags. This is a synchronous failable constructor. See g_dbus_connection_new_for_address() for the asynchronous version. If @observer is not %NULL it may be used to control the authentication process. - - a #GDBusConnection or %NULL if @error is set. Free with - g_object_unref(). + a #GDBusConnection or %NULL if @error is set. + Free with g_object_unref(). @@ -11059,9 +10597,9 @@ authentication process. This is a synchronous failable constructor. See g_dbus_connection_new() for the asynchronous version. - - a #GDBusConnection or %NULL if @error is set. Free with g_object_unref(). + a #GDBusConnection or %NULL if @error is set. + Free with g_object_unref(). @@ -11108,7 +10646,6 @@ operation. This is an asynchronous failable constructor. See g_dbus_connection_new_sync() for the synchronous version. - @@ -11152,8 +10689,9 @@ which must be in the This constructor can only be used to initiate client-side connections - use g_dbus_connection_new() if you need to act as the server. In particular, @flags cannot contain the -%G_DBUS_CONNECTION_FLAGS_AUTHENTICATION_SERVER or -%G_DBUS_CONNECTION_FLAGS_AUTHENTICATION_ALLOW_ANONYMOUS flags. +%G_DBUS_CONNECTION_FLAGS_AUTHENTICATION_SERVER, +%G_DBUS_CONNECTION_FLAGS_AUTHENTICATION_ALLOW_ANONYMOUS or +%G_DBUS_CONNECTION_FLAGS_AUTHENTICATION_REQUIRE_SAME_USER flags. When the operation is finished, @callback will be invoked. You can then call g_dbus_connection_new_for_address_finish() to get the result of @@ -11165,7 +10703,6 @@ authentication process. This is an asynchronous failable constructor. See g_dbus_connection_new_for_address_sync() for the synchronous version. - @@ -11224,7 +10761,6 @@ method from) at some point after @user_data is no longer needed. (It is not guaranteed to be called synchronously when the filter is removed, and may be called after @connection has been destroyed.) - a filter identifier that can be used with g_dbus_connection_remove_filter() @@ -11296,7 +10832,6 @@ function. If @callback is %NULL then the D-Bus method call message will be sent with the %G_DBUS_MESSAGE_FLAGS_NO_REPLY_EXPECTED flag set. - @@ -11359,10 +10894,9 @@ the %G_DBUS_MESSAGE_FLAGS_NO_REPLY_EXPECTED flag set. Finishes an operation started with g_dbus_connection_call(). - - %NULL if @error is set. Otherwise a #GVariant tuple with - return values. Free with g_variant_unref(). + %NULL if @error is set. Otherwise a non-floating + #GVariant tuple with return values. Free with g_variant_unref(). @@ -11413,10 +10947,9 @@ This allows convenient 'inline' use of g_variant_new(), e.g.: The calling thread is blocked until a reply is received. See g_dbus_connection_call() for the asynchronous version of this method. - - %NULL if @error is set. Otherwise a #GVariant tuple with - return values. Free with g_variant_unref(). + %NULL if @error is set. Otherwise a non-floating + #GVariant tuple with return values. Free with g_variant_unref(). @@ -11468,8 +11001,19 @@ this method. Like g_dbus_connection_call() but also takes a #GUnixFDList object. +The file descriptors normally correspond to %G_VARIANT_TYPE_HANDLE +values in the body of the message. For example, if a message contains +two file descriptors, @fd_list would have length 2, and +`g_variant_new_handle (0)` and `g_variant_new_handle (1)` would appear +somewhere in the body of the message (not necessarily in that order!) +to represent the file descriptors at indexes 0 and 1 respectively. + +When designing D-Bus APIs that are intended to be interoperable, +please note that non-GDBus implementations of D-Bus can usually only +access file descriptors if they are referenced in this way by a +value of type %G_VARIANT_TYPE_HANDLE in the body of the message. + This method is only available on UNIX. - @@ -11534,11 +11078,21 @@ This method is only available on UNIX. - Finishes an operation started with g_dbus_connection_call_with_unix_fd_list(). - + Finishes an operation started with g_dbus_connection_call_with_unix_fd_list(). + +The file descriptors normally correspond to %G_VARIANT_TYPE_HANDLE +values in the body of the message. For example, +if g_variant_get_handle() returns 5, that is intended to be a reference +to the file descriptor that can be accessed by +`g_unix_fd_list_get (*out_fd_list, 5, ...)`. + +When designing D-Bus APIs that are intended to be interoperable, +please note that non-GDBus implementations of D-Bus can usually only +access file descriptors if they are referenced in this way by a +value of type %G_VARIANT_TYPE_HANDLE in the body of the message. - %NULL if @error is set. Otherwise a #GVariant tuple with - return values. Free with g_variant_unref(). + %NULL if @error is set. Otherwise a non-floating + #GVariant tuple with return values. Free with g_variant_unref(). @@ -11559,12 +11113,13 @@ This method is only available on UNIX. Like g_dbus_connection_call_sync() but also takes and returns #GUnixFDList objects. +See g_dbus_connection_call_with_unix_fd_list() and +g_dbus_connection_call_with_unix_fd_list_finish() for more details. This method is only available on UNIX. - - %NULL if @error is set. Otherwise a #GVariant tuple with - return values. Free with g_variant_unref(). + %NULL if @error is set. Otherwise a non-floating + #GVariant tuple with return values. Free with g_variant_unref(). @@ -11646,7 +11201,6 @@ of the thread you are calling this method from. You can then call g_dbus_connection_close_finish() to get the result of the operation. See g_dbus_connection_close_sync() for the synchronous version. - @@ -11672,7 +11226,6 @@ version. Finishes an operation started with g_dbus_connection_close(). - %TRUE if the operation succeeded, %FALSE if @error is set @@ -11694,7 +11247,6 @@ version. until this is done. See g_dbus_connection_close() for the asynchronous version of this method and more details about what it does. - %TRUE if the operation succeeded, %FALSE if @error is set @@ -11718,7 +11270,6 @@ If the parameters GVariant is floating, it is consumed. This can only fail if @parameters is not compatible with the D-Bus protocol (%G_IO_ERROR_INVALID_ARGUMENT), or if @connection has been closed (%G_IO_ERROR_CLOSED). - %TRUE unless @error is set @@ -11774,7 +11325,6 @@ Since incoming action activations and state change requests are rather likely to cause changes on the action group, this effectively limits a given action group to being exported from only one main context. - the ID of the export (never zero), or 0 in case of failure @@ -11807,7 +11357,6 @@ returned (with @error set accordingly). You can unexport the menu model using g_dbus_connection_unexport_menu_model() with the return value of this function. - the ID of the export (never zero), or 0 in case of failure @@ -11842,7 +11391,6 @@ of the thread you are calling this method from. You can then call g_dbus_connection_flush_finish() to get the result of the operation. See g_dbus_connection_flush_sync() for the synchronous version. - @@ -11868,7 +11416,6 @@ version. Finishes an operation started with g_dbus_connection_flush(). - %TRUE if the operation succeeded, %FALSE if @error is set @@ -11890,7 +11437,6 @@ version. until this is done. See g_dbus_connection_flush() for the asynchronous version of this method and more details about what it does. - %TRUE if the operation succeeded, %FALSE if @error is set @@ -11908,7 +11454,6 @@ does. Gets the capabilities negotiated with the remote peer - zero or more flags from the #GDBusCapabilityFlags enumeration @@ -11924,7 +11469,6 @@ does. Gets whether the process is terminated when @connection is closed by the remote peer. See #GDBusConnection:exit-on-close for more details. - whether the process is terminated when @connection is closed by the remote peer @@ -11939,7 +11483,6 @@ closed by the remote peer. See Gets the flags used to construct this connection - zero or more flags from the #GDBusConnectionFlags enumeration @@ -11954,7 +11497,6 @@ closed by the remote peer. See The GUID of the peer performing the role of server when authenticating. See #GDBusConnection:guid for more details. - The GUID. Do not free this string, it is owned by @connection. @@ -11973,7 +11515,6 @@ the current thread. This includes messages sent via both low-level API such as g_dbus_connection_send_message() as well as high-level API such as g_dbus_connection_emit_signal(), g_dbus_connection_call() or g_dbus_proxy_call(). - the last used serial or zero when no message has been sent within the current thread @@ -11996,7 +11537,6 @@ authentication process. In a message bus setup, the message bus is always the server and each application is a client. So this method will always return %NULL for message bus clients. - a #GCredentials or %NULL if not available. Do not free this object, it is owned by @connection. @@ -12015,7 +11555,6 @@ each application is a client. So this method will always return While the #GDBusConnection is active, it will interact with this stream from a worker thread, so it is not safe to interact with the stream directly. - the stream used for IO @@ -12031,7 +11570,6 @@ the stream directly. Gets the unique name of @connection as assigned by the message bus. This can also be used to figure out if @connection is a message bus connection. - the unique name or %NULL if @connection is not a message bus connection. Do not free this string, it is owned by @@ -12047,7 +11585,6 @@ message bus connection. Gets whether @connection is closed. - %TRUE if the connection is closed, %FALSE otherwise @@ -12098,7 +11635,6 @@ reference count is -1, see g_dbus_interface_info_ref()) for as long as the object is exported. Also note that @vtable will be copied. See this [server][gdbus-server] for an example of how to use this method. - 0 if @error is set, otherwise a registration id (never 0) that can be used with g_dbus_connection_unregister_object() @@ -12134,9 +11670,8 @@ See this [server][gdbus-server] for an example of how to use this method. Version of g_dbus_connection_register_object() using closures instead of a #GDBusInterfaceVTable for easier binding in other languages. - - 0 if @error is set, otherwise a registration id (never 0) + 0 if @error is set, otherwise a registration ID (never 0) that can be used with g_dbus_connection_unregister_object() . @@ -12202,10 +11737,9 @@ registration. See this [server][gdbus-subtree-server] for an example of how to use this method. - - 0 if @error is set, otherwise a subtree registration id (never 0) -that can be used with g_dbus_connection_unregister_subtree() . + 0 if @error is set, otherwise a subtree registration ID (never 0) +that can be used with g_dbus_connection_unregister_subtree() @@ -12245,7 +11779,6 @@ after calling g_dbus_connection_remove_filter(), so you cannot just free data that the filter might be using. Instead, you should pass a #GDestroyNotify to g_dbus_connection_add_filter(), which will be called when it is guaranteed that the data is no longer needed. - @@ -12268,7 +11801,9 @@ Unless @flags contain the will be assigned by @connection and set on @message via g_dbus_message_set_serial(). If @out_serial is not %NULL, then the serial number used will be written to this location prior to -submitting the message to the underlying transport. +submitting the message to the underlying transport. While it has a `volatile` +qualifier, this is a historical artifact and the argument passed to it should +not be `volatile`. If @connection is closed then the operation will fail with %G_IO_ERROR_CLOSED. If @message is not well-formed, @@ -12280,7 +11815,6 @@ UNIX file descriptors. Note that @message must be unlocked, unless @flags contain the %G_DBUS_SEND_MESSAGE_FLAGS_PRESERVE_SERIAL flag. - %TRUE if the message was well-formed and queued for transmission, %FALSE if @error is set @@ -12314,7 +11848,9 @@ Unless @flags contain the will be assigned by @connection and set on @message via g_dbus_message_set_serial(). If @out_serial is not %NULL, then the serial number used will be written to this location prior to -submitting the message to the underlying transport. +submitting the message to the underlying transport. While it has a `volatile` +qualifier, this is a historical artifact and the argument passed to it should +not be `volatile`. If @connection is closed then the operation will fail with %G_IO_ERROR_CLOSED. If @cancellable is canceled, the operation will @@ -12334,7 +11870,6 @@ Note that @message must be unlocked, unless @flags contain the See this [server][gdbus-server] and [client][gdbus-unix-fd-client] for an example of how to use this low-level API to send and receive UNIX file descriptors. - @@ -12387,7 +11922,6 @@ g_dbus_message_to_gerror() to transcode this to a #GError. See this [server][gdbus-server] and [client][gdbus-unix-fd-client] for an example of how to use this low-level API to send and receive UNIX file descriptors. - a locked #GDBusMessage or %NULL if @error is set @@ -12415,7 +11949,9 @@ Unless @flags contain the will be assigned by @connection and set on @message via g_dbus_message_set_serial(). If @out_serial is not %NULL, then the serial number used will be written to this location prior to -submitting the message to the underlying transport. +submitting the message to the underlying transport. While it has a `volatile` +qualifier, this is a historical artifact and the argument passed to it should +not be `volatile`. If @connection is closed then the operation will fail with %G_IO_ERROR_CLOSED. If @cancellable is canceled, the operation will @@ -12433,7 +11969,6 @@ UNIX file descriptors. Note that @message must be unlocked, unless @flags contain the %G_DBUS_SEND_MESSAGE_FLAGS_PRESERVE_SERIAL flag. - a locked #GDBusMessage that is the reply to @message or %NULL if @error is set @@ -12479,7 +12014,6 @@ all of a user's applications to quit when their bus connection goes away. If you are setting @exit_on_close to %FALSE for the shared session bus connection, you should make sure that your application exits when the user session ends. - @@ -12545,7 +12079,6 @@ The returned subscription identifier is an opaque value which is guaranteed to never be zero. This function can never fail. - a subscription identifier that can be used with g_dbus_connection_signal_unsubscribe() @@ -12610,7 +12143,6 @@ until the #GDestroyNotify function passed to g_dbus_connection_signal_subscribe() is called, in order to avoid memory leaks through callbacks queued on the #GMainContext after it’s stopped being iterated. - @@ -12631,7 +12163,6 @@ iterated. %G_DBUS_CONNECTION_FLAGS_DELAY_MESSAGE_PROCESSING, this method starts processing messages. Does nothing on if @connection wasn't created with this flag or if the method has already been called. - @@ -12649,7 +12180,6 @@ g_dbus_connection_export_action_group(). It is an error to call this function with an ID that wasn't returned from g_dbus_connection_export_action_group() or to call it with the same ID more than once. - @@ -12671,7 +12201,6 @@ g_dbus_connection_export_menu_model(). It is an error to call this function with an ID that wasn't returned from g_dbus_connection_export_menu_model() or to call it with the same ID more than once. - @@ -12688,7 +12217,6 @@ same ID more than once. Unregisters an object. - %TRUE if the object was unregistered, %FALSE otherwise @@ -12707,7 +12235,6 @@ same ID more than once. Unregisters a subtree. - %TRUE if the subtree was unregistered, %FALSE otherwise @@ -12761,7 +12288,7 @@ authenticating. If you are constructing a #GDBusConnection and pass %G_DBUS_CONNECTION_FLAGS_AUTHENTICATION_SERVER in the -#GDBusConnection:flags property then you MUST also set this +#GDBusConnection:flags property then you **must** also set this property to a valid guid. If you are constructing a #GDBusConnection and pass @@ -13004,9 +12531,9 @@ on the wire back to a #GError using g_dbus_error_new_for_dbus_error(). This function is typically only used in object mappings to put a #GError on the wire. Regular applications should not use it. - - A D-Bus error name (never %NULL). Free with g_free(). + A D-Bus error name (never %NULL). + Free with g_free(). @@ -13023,10 +12550,9 @@ This function is guaranteed to return a D-Bus error name for all #GErrors returned from functions handling remote method calls (e.g. g_dbus_connection_call_finish()) unless g_dbus_error_strip_remote_error() has been used on @error. - - - an allocated string or %NULL if the D-Bus error name - could not be found. Free with g_free(). + + an allocated string or %NULL if the + D-Bus error name could not be found. Free with g_free(). @@ -13039,7 +12565,6 @@ g_dbus_error_strip_remote_error() has been used on @error. Checks if @error represents an error received via D-Bus from a remote peer. If so, use g_dbus_error_get_remote_error() to get the name of the error. - %TRUE if @error represents an error from a remote peer, %FALSE otherwise. @@ -13079,7 +12604,6 @@ returned #GError using the g_dbus_error_get_remote_error() function This function is typically only used in object mappings to prepare #GError instances for applications. Regular applications should not use it. - An allocated #GError. Free with g_error_free(). @@ -13106,7 +12630,6 @@ it. This is typically done in the routine that returns the #GQuark for an error domain. - %TRUE if the association was created, %FALSE if it already exists. @@ -13128,8 +12651,10 @@ exists. - Helper function for associating a #GError error domain with D-Bus error names. - + Helper function for associating a #GError error domain with D-Bus error names. + +While @quark_volatile has a `volatile` qualifier, this is a historical +artifact and the argument passed to it should not be `volatile`. @@ -13158,7 +12683,6 @@ exists. Does nothing if @error is %NULL. Otherwise sets *@error to a new #GError created with g_dbus_error_new_for_dbus_error() with @dbus_error_message prepend with @format (unless %NULL). - @@ -13187,7 +12711,6 @@ with @dbus_error_message prepend with @format (unless %NULL). Like g_dbus_error_set_dbus_error() but intended for language bindings. - @@ -13221,7 +12744,6 @@ message field in @error will correspond exactly to what was received on the wire. This is typically used when presenting errors to the end user. - %TRUE if information was stripped, %FALSE otherwise. @@ -13235,7 +12757,6 @@ This is typically used when presenting errors to the end user. Destroys an association previously set up with g_dbus_error_register_error(). - %TRUE if the association was destroyed, %FALSE if it wasn't found. @@ -13258,7 +12779,6 @@ This is typically used when presenting errors to the end user. Struct used in g_dbus_error_register_error_domain(). - An error code. @@ -13272,11 +12792,9 @@ This is typically used when presenting errors to the end user. The #GDBusInterface type is the base type for D-Bus interfaces both on the service side (see #GDBusInterfaceSkeleton) and client side (see #GDBusProxy). - Gets the #GDBusObject that @interface_ belongs to, if any. - - + A #GDBusObject or %NULL. The returned reference should be freed with g_object_unref(). @@ -13291,7 +12809,6 @@ reference should be freed with g_object_unref(). Gets D-Bus introspection information for the D-Bus interface implemented by @interface_. - A #GDBusInterfaceInfo. Do not free. @@ -13309,8 +12826,7 @@ implemented by @interface_. It is not safe to use the returned object if @interface_ or the returned object is being used from other threads. See g_dbus_interface_dup_object() for a thread-safe alternative. - - + A #GDBusObject or %NULL. The returned reference belongs to @interface_ and should not be freed. @@ -13326,7 +12842,6 @@ g_dbus_interface_dup_object() for a thread-safe alternative. Sets the #GDBusObject for @interface_ to @object. Note that @interface_ will hold a weak reference to @object. - @@ -13343,8 +12858,7 @@ Note that @interface_ will hold a weak reference to @object. Gets the #GDBusObject that @interface_ belongs to, if any. - - + A #GDBusObject or %NULL. The returned reference should be freed with g_object_unref(). @@ -13359,7 +12873,6 @@ reference should be freed with g_object_unref(). Gets D-Bus introspection information for the D-Bus interface implemented by @interface_. - A #GDBusInterfaceInfo. Do not free. @@ -13377,8 +12890,7 @@ implemented by @interface_. It is not safe to use the returned object if @interface_ or the returned object is being used from other threads. See g_dbus_interface_dup_object() for a thread-safe alternative. - - + A #GDBusObject or %NULL. The returned reference belongs to @interface_ and should not be freed. @@ -13394,7 +12906,6 @@ g_dbus_interface_dup_object() for a thread-safe alternative. Sets the #GDBusObject for @interface_ to @object. Note that @interface_ will hold a weak reference to @object. - @@ -13412,7 +12923,6 @@ Note that @interface_ will hold a weak reference to @object. The type of the @get_property function in #GDBusInterfaceVTable. - A #GVariant with the value for @property_name or %NULL if @error is set. If the returned #GVariant is floating, it is @@ -13452,14 +12962,12 @@ Note that @interface_ will hold a weak reference to @object. Base type for D-Bus interfaces. - The parent interface. - A #GDBusInterfaceInfo. Do not free. @@ -13474,8 +12982,7 @@ Note that @interface_ will hold a weak reference to @object. - - + A #GDBusObject or %NULL. The returned reference belongs to @interface_ and should not be freed. @@ -13490,7 +12997,6 @@ Note that @interface_ will hold a weak reference to @object. - @@ -13508,8 +13014,7 @@ Note that @interface_ will hold a weak reference to @object. - - + A #GDBusObject or %NULL. The returned reference should be freed with g_object_unref(). @@ -13525,7 +13030,6 @@ reference should be freed with g_object_unref(). Information about a D-Bus interface. - The reference count or -1 if statically allocated. @@ -13569,7 +13073,6 @@ used and its use count is increased. Note that @info cannot be modified until g_dbus_interface_info_cache_release() is called. - @@ -13584,7 +13087,6 @@ g_dbus_interface_info_cache_release() is called. Decrements the usage count for the cache for @info built by g_dbus_interface_info_cache_build() (if any) and frees the resources used by the cache if the usage count drops to zero. - @@ -13602,7 +13104,6 @@ This function is typically used for generating introspection XML documents at run-time for handling the `org.freedesktop.DBus.Introspectable.Introspect` method. - @@ -13626,8 +13127,7 @@ method. The cost of this function is O(n) in number of methods unless g_dbus_interface_info_cache_build() has been used on @info. - - + A #GDBusMethodInfo or %NULL if not found. Do not free, it is owned by @info. @@ -13647,8 +13147,7 @@ g_dbus_interface_info_cache_build() has been used on @info. The cost of this function is O(n) in number of properties unless g_dbus_interface_info_cache_build() has been used on @info. - - + A #GDBusPropertyInfo or %NULL if not found. Do not free, it is owned by @info. @@ -13668,8 +13167,7 @@ g_dbus_interface_info_cache_build() has been used on @info. The cost of this function is O(n) in number of signals unless g_dbus_interface_info_cache_build() has been used on @info. - - + A #GDBusSignalInfo or %NULL if not found. Do not free, it is owned by @info. @@ -13687,7 +13185,6 @@ g_dbus_interface_info_cache_build() has been used on @info. If @info is statically allocated does nothing. Otherwise increases the reference count. - The same @info. @@ -13703,7 +13200,6 @@ the reference count. If @info is statically allocated, does nothing. Otherwise decreases the reference count of @info. When its reference count drops to 0, the memory used is freed. - @@ -13717,7 +13213,6 @@ the memory used is freed. The type of the @method_call function in #GDBusInterfaceVTable. - @@ -13758,7 +13253,6 @@ the memory used is freed. The type of the @set_property function in #GDBusInterfaceVTable. - %TRUE if the property was set to @value, %FALSE if @error is set. @@ -13800,7 +13294,6 @@ the memory used is freed. Abstract base class for D-Bus interfaces on the service side. - If @interface_ has outstanding changes, request for these changes to be @@ -13811,7 +13304,6 @@ changes and emit the `org.freedesktop.DBus.Properties.PropertiesChanged` signal later (e.g. in an idle handler). This technique is useful for collapsing multiple property changes into one. - @@ -13823,7 +13315,6 @@ for collapsing multiple property changes into one. - @@ -13839,7 +13330,6 @@ for collapsing multiple property changes into one. Gets D-Bus introspection information for the D-Bus interface implemented by @interface_. - A #GDBusInterfaceInfo (never %NULL). Do not free. @@ -13853,7 +13343,6 @@ implemented by @interface_. Gets all D-Bus properties for @interface_. - A #GVariant of type ['a{sv}'][G-VARIANT-TYPE-VARDICT:CAPS]. @@ -13871,7 +13360,6 @@ Free with g_variant_unref(). Gets the interface vtable for the D-Bus interface implemented by @interface_. The returned function pointers should expect @interface_ itself to be passed as @user_data. - A #GDBusInterfaceVTable (never %NULL). @@ -13891,7 +13379,6 @@ onto multiple connections however the @object_path provided must be the same for all connections. Use g_dbus_interface_skeleton_unexport() to unexport the object. - %TRUE if the interface was exported on @connection, otherwise %FALSE with @error set. @@ -13921,7 +13408,6 @@ changes and emit the `org.freedesktop.DBus.Properties.PropertiesChanged` signal later (e.g. in an idle handler). This technique is useful for collapsing multiple property changes into one. - @@ -13934,8 +13420,7 @@ for collapsing multiple property changes into one. Gets the first connection that @interface_ is exported on, if any. - - + A #GDBusConnection or %NULL if @interface_ is not exported anywhere. Do not free, the object belongs to @interface_. @@ -13949,7 +13434,6 @@ not exported anywhere. Do not free, the object belongs to @interface_. Gets a list of the connections that @interface_ is exported on. - A list of all the connections that @interface_ is exported on. The returned @@ -13969,7 +13453,6 @@ not exported anywhere. Do not free, the object belongs to @interface_. Gets the #GDBusInterfaceSkeletonFlags that describes what the behavior of @interface_ - One or more flags from the #GDBusInterfaceSkeletonFlags enumeration. @@ -13984,7 +13467,6 @@ of @interface_ Gets D-Bus introspection information for the D-Bus interface implemented by @interface_. - A #GDBusInterfaceInfo (never %NULL). Do not free. @@ -13998,8 +13480,7 @@ implemented by @interface_. Gets the object path that @interface_ is exported on, if any. - - + A string owned by @interface_ or %NULL if @interface_ is not exported anywhere. Do not free, the string belongs to @interface_. @@ -14013,7 +13494,6 @@ anywhere. Do not free, the string belongs to @interface_. Gets all D-Bus properties for @interface_. - A #GVariant of type ['a{sv}'][G-VARIANT-TYPE-VARDICT:CAPS]. @@ -14031,7 +13511,6 @@ Free with g_variant_unref(). Gets the interface vtable for the D-Bus interface implemented by @interface_. The returned function pointers should expect @interface_ itself to be passed as @user_data. - A #GDBusInterfaceVTable (never %NULL). @@ -14045,7 +13524,6 @@ itself to be passed as @user_data. Checks if @interface_ is exported on @connection. - %TRUE if @interface_ is exported on @connection, %FALSE otherwise. @@ -14063,7 +13541,6 @@ itself to be passed as @user_data. Sets flags describing what the behavior of @skeleton should be. - @@ -14083,7 +13560,6 @@ itself to be passed as @user_data. To unexport @interface_ from only a single connection, use g_dbus_interface_skeleton_unexport_from_connection() - @@ -14099,7 +13575,6 @@ g_dbus_interface_skeleton_unexport_from_connection() To stop exporting on all connections the interface is exported on, use g_dbus_interface_skeleton_unexport(). - @@ -14172,14 +13647,12 @@ to was exported in. Class structure for #GDBusInterfaceSkeleton. - The parent class. - A #GDBusInterfaceInfo (never %NULL). Do not free. @@ -14194,7 +13667,6 @@ to was exported in. - A #GDBusInterfaceVTable (never %NULL). @@ -14209,7 +13681,6 @@ to was exported in. - A #GVariant of type ['a{sv}'][G-VARIANT-TYPE-VARDICT:CAPS]. @@ -14226,7 +13697,6 @@ Free with g_variant_unref(). - @@ -14245,7 +13715,6 @@ Free with g_variant_unref(). - @@ -14277,9 +13746,7 @@ Free with g_variant_unref(). use locking to access data structures used by other threads. - - - + Virtual table for handling properties and method calls for a D-Bus interface. @@ -14322,7 +13789,6 @@ If you have writable properties specified in your interface info, you must ensure that you either provide a non-%NULL @set_property() function or provide an implementation of the `Set` call. If implementing the call, you must return the value of type %G_VARIANT_TYPE_UNIT. - Function for handling incoming method calls. @@ -14354,7 +13820,6 @@ All signals on the menu model (and any linked models) are reported with respect to this context. All calls on the returned menu model (and linked models) must also originate from this same context, with the thread default main context unchanged. - a #GDBusMenuModel object. Free with g_object_unref(). @@ -14382,7 +13847,6 @@ the thread default main context unchanged. on a #GDBusConnection. Creates a new empty #GDBusMessage. - A #GDBusMessage. Free with g_object_unref(). @@ -14395,7 +13859,6 @@ g_dbus_message_get_byte_order(). If the @blob cannot be parsed, contains invalid fields, or contains invalid headers, %G_IO_ERROR_INVALID_ARGUMENT will be returned. - A new #GDBusMessage or %NULL if @error is set. Free with g_object_unref(). @@ -14420,7 +13883,6 @@ g_object_unref(). Creates a new #GDBusMessage for a method call. - A #GDBusMessage. Free with g_object_unref(). @@ -14446,7 +13908,6 @@ g_object_unref(). Creates a new #GDBusMessage for a signal emission. - A #GDBusMessage. Free with g_object_unref(). @@ -14469,7 +13930,6 @@ g_object_unref(). Utility function to calculate how many bytes are needed to completely deserialize the D-Bus message stored at @blob. - Number of bytes needed or -1 if @error is set (e.g. if @blob contains invalid data or not enough data is available to @@ -14496,7 +13956,6 @@ to not be locked. This operation can fail if e.g. @message contains file descriptors and the per-process or system-wide open files limit is reached. - A new #GDBusMessage or %NULL if @error is set. Free with g_object_unref(). @@ -14511,8 +13970,7 @@ and the per-process or system-wide open files limit is reached. Convenience to get the first item in the body of @message. - - + The string item or %NULL if the first item in the body of @message is not a string. @@ -14526,8 +13984,7 @@ and the per-process or system-wide open files limit is reached. Gets the body of a message. - - + A #GVariant or %NULL if the body is empty. Do not free, it is owned by @message. @@ -14541,7 +13998,6 @@ empty. Do not free, it is owned by @message. Gets the byte order of @message. - The byte order. @@ -14555,8 +14011,7 @@ empty. Do not free, it is owned by @message. Convenience getter for the %G_DBUS_MESSAGE_HEADER_FIELD_DESTINATION header field. - - + The value. @@ -14569,8 +14024,7 @@ empty. Do not free, it is owned by @message. Convenience getter for the %G_DBUS_MESSAGE_HEADER_FIELD_ERROR_NAME header field. - - + The value. @@ -14583,7 +14037,6 @@ empty. Do not free, it is owned by @message. Gets the flags for @message. - Flags that are set (typically values from the #GDBusMessageFlags enumeration bitwise ORed together). @@ -14600,7 +14053,6 @@ empty. Do not free, it is owned by @message. The caller is responsible for checking the type of the returned #GVariant matches what is expected. - A #GVariant with the value if the header was found, %NULL otherwise. Do not free, it is owned by @message. @@ -14619,7 +14071,6 @@ otherwise. Do not free, it is owned by @message. Gets an array of all header fields on @message that are set. - An array of header fields terminated by %G_DBUS_MESSAGE_HEADER_FIELD_INVALID. Each element @@ -14637,8 +14088,7 @@ is a #guchar. Free with g_free(). Convenience getter for the %G_DBUS_MESSAGE_HEADER_FIELD_INTERFACE header field. - - + The value. @@ -14653,7 +14103,6 @@ is a #guchar. Free with g_free(). Checks whether @message is locked. To monitor changes to this value, conncet to the #GObject::notify signal to listen for changes on the #GDBusMessage:locked property. - %TRUE if @message is locked, %FALSE otherwise. @@ -14667,8 +14116,7 @@ on the #GDBusMessage:locked property. Convenience getter for the %G_DBUS_MESSAGE_HEADER_FIELD_MEMBER header field. - - + The value. @@ -14681,7 +14129,6 @@ on the #GDBusMessage:locked property. Gets the type of @message. - A 8-bit unsigned integer (typically a value from the #GDBusMessageType enumeration). @@ -14695,7 +14142,6 @@ on the #GDBusMessage:locked property. Convenience getter for the %G_DBUS_MESSAGE_HEADER_FIELD_NUM_UNIX_FDS header field. - The value. @@ -14709,8 +14155,7 @@ on the #GDBusMessage:locked property. Convenience getter for the %G_DBUS_MESSAGE_HEADER_FIELD_PATH header field. - - + The value. @@ -14723,7 +14168,6 @@ on the #GDBusMessage:locked property. Convenience getter for the %G_DBUS_MESSAGE_HEADER_FIELD_REPLY_SERIAL header field. - The value. @@ -14737,8 +14181,7 @@ on the #GDBusMessage:locked property. Convenience getter for the %G_DBUS_MESSAGE_HEADER_FIELD_SENDER header field. - - + The value. @@ -14751,7 +14194,6 @@ on the #GDBusMessage:locked property. Gets the serial for @message. - A #guint32. @@ -14765,7 +14207,6 @@ on the #GDBusMessage:locked property. Convenience getter for the %G_DBUS_MESSAGE_HEADER_FIELD_SIGNATURE header field. - The value. @@ -14780,9 +14221,14 @@ on the #GDBusMessage:locked property. Gets the UNIX file descriptors associated with @message, if any. -This method is only available on UNIX. - - +This method is only available on UNIX. + +The file descriptors normally correspond to %G_VARIANT_TYPE_HANDLE +values in the body of the message. For example, +if g_variant_get_handle() returns 5, that is intended to be a reference +to the file descriptor that can be accessed by +`g_unix_fd_list_get (list, 5, ...)`. + A #GUnixFDList or %NULL if no file descriptors are associated. Do not free, this object is owned by @message. @@ -14796,7 +14242,6 @@ associated. Do not free, this object is owned by @message. If @message is locked, does nothing. Otherwise locks the message. - @@ -14809,7 +14254,6 @@ associated. Do not free, this object is owned by @message. Creates a new #GDBusMessage that is an error reply to @method_call_message. - A #GDBusMessage. Free with g_object_unref(). @@ -14836,7 +14280,6 @@ create a reply message to. Creates a new #GDBusMessage that is an error reply to @method_call_message. - A #GDBusMessage. Free with g_object_unref(). @@ -14859,7 +14302,6 @@ create a reply message to. Like g_dbus_message_new_method_error() but intended for language bindings. - A #GDBusMessage. Free with g_object_unref(). @@ -14886,7 +14328,6 @@ create a reply message to. Creates a new #GDBusMessage that is a reply to @method_call_message. - #GDBusMessage. Free with g_object_unref(). @@ -14932,7 +14373,6 @@ Body: () UNIX File Descriptors: fd 12: dev=0:10,mode=020620,ino=5,uid=500,gid=5,rdev=136:2,size=0,atime=1273085037,mtime=1273085851,ctime=1272982635 ]| - A string that should be freed with g_free(). @@ -14954,7 +14394,6 @@ UNIX File Descriptors: type string of @body (or cleared if @body is %NULL). If @body is floating, @message assumes ownership of @body. - @@ -14971,7 +14410,6 @@ If @body is floating, @message assumes ownership of @body. Sets the byte order of @message. - @@ -14988,7 +14426,6 @@ If @body is floating, @message assumes ownership of @body. Convenience setter for the %G_DBUS_MESSAGE_HEADER_FIELD_DESTINATION header field. - @@ -14997,7 +14434,7 @@ If @body is floating, @message assumes ownership of @body. A #GDBusMessage. - + The value to set. @@ -15005,12 +14442,11 @@ If @body is floating, @message assumes ownership of @body. Convenience setter for the %G_DBUS_MESSAGE_HEADER_FIELD_ERROR_NAME header field. - - + A #GDBusMessage. @@ -15022,7 +14458,6 @@ If @body is floating, @message assumes ownership of @body. Sets the flags to set on @message. - @@ -15042,7 +14477,6 @@ enumeration bitwise ORed together). Sets a header field on @message. If @value is floating, @message assumes ownership of @value. - @@ -15063,7 +14497,6 @@ If @value is floating, @message assumes ownership of @value. Convenience setter for the %G_DBUS_MESSAGE_HEADER_FIELD_INTERFACE header field. - @@ -15072,7 +14505,7 @@ If @value is floating, @message assumes ownership of @value. A #GDBusMessage. - + The value to set. @@ -15080,7 +14513,6 @@ If @value is floating, @message assumes ownership of @value. Convenience setter for the %G_DBUS_MESSAGE_HEADER_FIELD_MEMBER header field. - @@ -15089,7 +14521,7 @@ If @value is floating, @message assumes ownership of @value. A #GDBusMessage. - + The value to set. @@ -15097,7 +14529,6 @@ If @value is floating, @message assumes ownership of @value. Sets @message to be of @type. - @@ -15114,7 +14545,6 @@ If @value is floating, @message assumes ownership of @value. Convenience setter for the %G_DBUS_MESSAGE_HEADER_FIELD_NUM_UNIX_FDS header field. - @@ -15131,7 +14561,6 @@ If @value is floating, @message assumes ownership of @value. Convenience setter for the %G_DBUS_MESSAGE_HEADER_FIELD_PATH header field. - @@ -15140,7 +14569,7 @@ If @value is floating, @message assumes ownership of @value. A #GDBusMessage. - + The value to set. @@ -15148,7 +14577,6 @@ If @value is floating, @message assumes ownership of @value. Convenience setter for the %G_DBUS_MESSAGE_HEADER_FIELD_REPLY_SERIAL header field. - @@ -15165,7 +14593,6 @@ If @value is floating, @message assumes ownership of @value. Convenience setter for the %G_DBUS_MESSAGE_HEADER_FIELD_SENDER header field. - @@ -15174,7 +14601,7 @@ If @value is floating, @message assumes ownership of @value. A #GDBusMessage. - + The value to set. @@ -15182,7 +14609,6 @@ If @value is floating, @message assumes ownership of @value. Sets the serial for @message. - @@ -15199,7 +14625,6 @@ If @value is floating, @message assumes ownership of @value. Convenience setter for the %G_DBUS_MESSAGE_HEADER_FIELD_SIGNATURE header field. - @@ -15208,7 +14633,7 @@ If @value is floating, @message assumes ownership of @value. A #GDBusMessage. - + The value to set. @@ -15220,8 +14645,12 @@ side-effect the %G_DBUS_MESSAGE_HEADER_FIELD_NUM_UNIX_FDS header field is set to the number of fds in @fd_list (or cleared if @fd_list is %NULL). -This method is only available on UNIX. - +This method is only available on UNIX. + +When designing D-Bus APIs that are intended to be interoperable, +please note that non-GDBus implementations of D-Bus can usually only +access file descriptors if they are referenced by a value of type +%G_VARIANT_TYPE_HANDLE in the body of the message. @@ -15239,7 +14668,6 @@ This method is only available on UNIX. Serializes @message to a blob. The byte order returned by g_dbus_message_get_byte_order() will be used. - A pointer to a valid binary D-Bus message of @out_size bytes generated by @message @@ -15271,7 +14699,6 @@ Otherwise this method encodes the error in @message as a #GError using g_dbus_error_set_dbus_error() using the information in the %G_DBUS_MESSAGE_HEADER_FIELD_ERROR_NAME header field of @message as well as the first string item in @message's body. - %TRUE if @error was set, %FALSE otherwise. @@ -15356,7 +14783,6 @@ descriptors, not compatible with @connection), then a warning is logged to standard error. Applications can check this ahead of time using g_dbus_message_to_blob() passing a #GDBusCapabilityFlags value obtained from @connection. - A #GDBusMessage that will be freed with g_object_unref() or %NULL to drop the message. Passive filter @@ -15454,7 +14880,6 @@ authorization. Since 2.46. Information about a method on an D-Bus interface. - The reference count or -1 if statically allocated. @@ -15484,7 +14909,6 @@ authorization. Since 2.46. If @info is statically allocated does nothing. Otherwise increases the reference count. - The same @info. @@ -15500,7 +14924,6 @@ the reference count. If @info is statically allocated, does nothing. Otherwise decreases the reference count of @info. When its reference count drops to 0, the memory used is freed. - @@ -15522,7 +14945,6 @@ it as an argument to the handle_method_call() function in a #GDBusInterfaceVTable that was passed to g_dbus_connection_register_object(). Gets the #GDBusConnection the method was invoked on. - A #GDBusConnection. Do not free, it is owned by @invocation. @@ -15541,7 +14963,6 @@ If this method call is a property Get, Set or GetAll call that has been redirected to the method call handler then "org.freedesktop.DBus.Properties" will be returned. See #GDBusInterfaceVTable for more information. - A string. Do not free, it is owned by @invocation. @@ -15562,7 +14983,6 @@ descriptor passing, that cannot be properly expressed in the See this [server][gdbus-server] and [client][gdbus-unix-fd-client] for an example of how to use this low-level API to send and receive UNIX file descriptors. - #GDBusMessage. Do not free, it is owned by @invocation. @@ -15581,8 +15001,7 @@ If this method invocation is a property Get, Set or GetAll call that has been redirected to the method call handler then %NULL will be returned. See g_dbus_method_invocation_get_property_info() and #GDBusInterfaceVTable for more information. - - + A #GDBusMethodInfo or %NULL. Do not free, it is owned by @invocation. @@ -15595,7 +15014,6 @@ returned. See g_dbus_method_invocation_get_property_info() and Gets the name of the method that was invoked. - A string. Do not free, it is owned by @invocation. @@ -15609,7 +15027,6 @@ returned. See g_dbus_method_invocation_get_property_info() and Gets the object path the method was invoked on. - A string. Do not free, it is owned by @invocation. @@ -15624,7 +15041,6 @@ returned. See g_dbus_method_invocation_get_property_info() and Gets the parameters of the method invocation. If there are no input parameters then this will return a GVariant with 0 children rather than NULL. - A #GVariant tuple. Do not unref this because it is owned by @invocation. @@ -15648,8 +15064,7 @@ property_set() vtable pointers being unset. See #GDBusInterfaceVTable for more information. If the call was GetAll, %NULL will be returned. - - + a #GDBusPropertyInfo or %NULL @@ -15662,7 +15077,6 @@ If the call was GetAll, %NULL will be returned. Gets the bus name that invoked the method. - A string. Do not free, it is owned by @invocation. @@ -15676,7 +15090,6 @@ If the call was GetAll, %NULL will be returned. Gets the @user_data #gpointer passed to g_dbus_connection_register_object(). - A #gpointer. @@ -15694,7 +15107,6 @@ If the call was GetAll, %NULL will be returned. This method will take ownership of @invocation. See #GDBusInterfaceVTable for more information about the ownership of @invocation. - @@ -15734,7 +15146,6 @@ This method will take ownership of @invocation. See Since 2.48, if the method call requested for a reply not to be sent then this call will free @invocation but otherwise do nothing (as per the recommendations of the D-Bus specification). - @@ -15767,7 +15178,6 @@ the recommendations of the D-Bus specification). This method will take ownership of @invocation. See #GDBusInterfaceVTable for more information about the ownership of @invocation. - @@ -15797,7 +15207,6 @@ language bindings. This method will take ownership of @invocation. See #GDBusInterfaceVTable for more information about the ownership of @invocation. - @@ -15831,7 +15240,6 @@ instead of the error domain, error code and message. This method will take ownership of @invocation. See #GDBusInterfaceVTable for more information about the ownership of @invocation. - @@ -15879,7 +15287,6 @@ Since 2.48, if the method call requested for a reply not to be sent then this call will sink @parameters and free @invocation, but otherwise do nothing (as per the recommendations of the D-Bus specification). - @@ -15902,7 +15309,6 @@ This method is only available on UNIX. This method will take ownership of @invocation. See #GDBusInterfaceVTable for more information about the ownership of @invocation. - @@ -15928,7 +15334,6 @@ of @error so the caller does not need to free it. This method will take ownership of @invocation. See #GDBusInterfaceVTable for more information about the ownership of @invocation. - @@ -15946,7 +15351,6 @@ This method will take ownership of @invocation. See Information about nodes in a remote object hierarchy. - The reference count or -1 if statically allocated. @@ -15982,7 +15386,6 @@ The introspection XML must contain exactly one top-level Note that this routine is using a [GMarkup][glib-Simple-XML-Subset-Parser.description]-based parser that only accepts a subset of valid XML documents. - A #GDBusNodeInfo structure or %NULL if @error is set. Free with g_dbus_node_info_unref(). @@ -16000,7 +15403,6 @@ with g_dbus_node_info_unref(). This function is typically used for generating introspection XML documents at run-time for handling the `org.freedesktop.DBus.Introspectable.Introspect` method. - @@ -16023,8 +15425,7 @@ handling the `org.freedesktop.DBus.Introspectable.Introspect` method. Looks up information about an interface. The cost of this function is O(n) in number of interfaces. - - + A #GDBusInterfaceInfo or %NULL if not found. Do not free, it is owned by @info. @@ -16042,7 +15443,6 @@ The cost of this function is O(n) in number of interfaces. If @info is statically allocated does nothing. Otherwise increases the reference count. - The same @info. @@ -16058,7 +15458,6 @@ the reference count. If @info is statically allocated, does nothing. Otherwise decreases the reference count of @info. When its reference count drops to 0, the memory used is freed. - @@ -16075,12 +15474,10 @@ the memory used is freed. the service side (see #GDBusObjectSkeleton) and the client side (see #GDBusObjectProxy). It is essentially just a container of interfaces. - Gets the D-Bus interface with name @interface_name associated with @object, if any. - - + %NULL if not found, otherwise a #GDBusInterface that must be freed with g_object_unref(). @@ -16098,7 +15495,6 @@ interfaces. Gets the D-Bus interfaces associated with @object. - A list of #GDBusInterface instances. The returned list must be freed by g_list_free() after each element has been freed @@ -16116,7 +15512,6 @@ interfaces. Gets the object path for @object. - A string owned by @object. Do not free. @@ -16129,7 +15524,6 @@ interfaces. - @@ -16143,7 +15537,6 @@ interfaces. - @@ -16159,8 +15552,7 @@ interfaces. Gets the D-Bus interface with name @interface_name associated with @object, if any. - - + %NULL if not found, otherwise a #GDBusInterface that must be freed with g_object_unref(). @@ -16178,7 +15570,6 @@ interfaces. Gets the D-Bus interfaces associated with @object. - A list of #GDBusInterface instances. The returned list must be freed by g_list_free() after each element has been freed @@ -16196,7 +15587,6 @@ interfaces. Gets the object path for @object. - A string owned by @object. Do not free. @@ -16235,14 +15625,12 @@ interfaces. Base object type for D-Bus objects. - The parent interface. - A string owned by @object. Do not free. @@ -16257,7 +15645,6 @@ interfaces. - A list of #GDBusInterface instances. The returned list must be freed by g_list_free() after each element has been freed @@ -16276,8 +15663,7 @@ interfaces. - - + %NULL if not found, otherwise a #GDBusInterface that must be freed with g_object_unref(). @@ -16296,7 +15682,6 @@ interfaces. - @@ -16312,7 +15697,6 @@ interfaces. - @@ -16335,11 +15719,9 @@ interface. See #GDBusObjectManagerClient for the client-side implementation and #GDBusObjectManagerServer for the service-side implementation. - Gets the interface proxy for @interface_name at @object_path, if any. - A #GDBusInterface instance or %NULL. Free with g_object_unref(). @@ -16362,7 +15744,6 @@ any. Gets the #GDBusObjectProxy at @object_path, if any. - A #GDBusObject or %NULL. Free with g_object_unref(). @@ -16381,7 +15762,6 @@ any. Gets the object path that @manager is for. - A string owned by @manager. Do not free. @@ -16395,7 +15775,6 @@ any. Gets all #GDBusObject objects known to @manager. - A list of #GDBusObject objects. The returned list should be freed with @@ -16413,7 +15792,6 @@ any. - @@ -16430,7 +15808,6 @@ any. - @@ -16447,7 +15824,6 @@ any. - @@ -16461,7 +15837,6 @@ any. - @@ -16477,7 +15852,6 @@ any. Gets the interface proxy for @interface_name at @object_path, if any. - A #GDBusInterface instance or %NULL. Free with g_object_unref(). @@ -16500,7 +15874,6 @@ any. Gets the #GDBusObjectProxy at @object_path, if any. - A #GDBusObject or %NULL. Free with g_object_unref(). @@ -16519,7 +15892,6 @@ any. Gets the object path that @manager is for. - A string owned by @manager. Do not free. @@ -16533,7 +15905,6 @@ any. Gets all #GDBusObject objects known to @manager. - A list of #GDBusObject objects. The returned list should be freed with @@ -16689,13 +16060,11 @@ in. Additionally, the #GDBusObjectProxy and #GDBusProxy objects originating from the #GDBusObjectManagerClient object will be created in the same context and, consequently, will deliver signals in the same main loop. - Finishes an operation started with g_dbus_object_manager_client_new(). - A #GDBusObjectManagerClient object or %NULL if @error is set. Free @@ -16711,7 +16080,6 @@ same main loop. Finishes an operation started with g_dbus_object_manager_client_new_for_bus(). - A #GDBusObjectManagerClient object or %NULL if @error is set. Free @@ -16732,7 +16100,6 @@ of a #GDBusConnection. This is a synchronous failable constructor - the calling thread is blocked until a reply is received. See g_dbus_object_manager_client_new_for_bus() for the asynchronous version. - A #GDBusObjectManagerClient object or %NULL if @error is set. Free @@ -16780,7 +16147,6 @@ for the asynchronous version. This is a synchronous failable constructor - the calling thread is blocked until a reply is received. See g_dbus_object_manager_client_new() for the asynchronous version. - A #GDBusObjectManagerClient object or %NULL if @error is set. Free @@ -16831,7 +16197,6 @@ ready, @callback will be invoked in the of the thread you are calling this method from. You can then call g_dbus_object_manager_client_new_finish() to get the result. See g_dbus_object_manager_client_new_sync() for the synchronous version. - @@ -16888,7 +16253,6 @@ ready, @callback will be invoked in the of the thread you are calling this method from. You can then call g_dbus_object_manager_client_new_for_bus_finish() to get the result. See g_dbus_object_manager_client_new_for_bus_sync() for the synchronous version. - @@ -16936,7 +16300,6 @@ g_dbus_object_manager_client_new_for_bus_sync() for the synchronous version. - @@ -16959,7 +16322,6 @@ g_dbus_object_manager_client_new_for_bus_sync() for the synchronous version. - @@ -16986,7 +16348,6 @@ g_dbus_object_manager_client_new_for_bus_sync() for the synchronous version. Gets the #GDBusConnection used by @manager. - A #GDBusConnection object. Do not free, the object belongs to @manager. @@ -17001,7 +16362,6 @@ g_dbus_object_manager_client_new_for_bus_sync() for the synchronous version. Gets the flags that @manager was constructed with. - Zero of more flags from the #GDBusObjectManagerClientFlags enumeration. @@ -17017,7 +16377,6 @@ enumeration. Gets the name that @manager is for, or %NULL if not a message bus connection. - A unique or well-known name. Do not free, the string belongs to @manager. @@ -17035,7 +16394,6 @@ belongs to @manager. no-one currently owns that name. You can connect to the #GObject::notify signal to track changes to the #GDBusObjectManagerClient:name-owner property. - The name owner or %NULL if no name owner exists. Free with g_free(). @@ -17171,14 +16529,12 @@ that @manager was constructed in. Class structure for #GDBusObjectManagerClient. - The parent class. - @@ -17206,7 +16562,6 @@ that @manager was constructed in. - @@ -17247,19 +16602,15 @@ that @manager was constructed in. be used in managers for well-known names. - - - + Base type for D-Bus object managers. - The parent interface. - A string owned by @manager. Do not free. @@ -17274,7 +16625,6 @@ that @manager was constructed in. - A list of #GDBusObject objects. The returned list should be freed with @@ -17294,7 +16644,6 @@ that @manager was constructed in. - A #GDBusObject or %NULL. Free with g_object_unref(). @@ -17314,7 +16663,6 @@ that @manager was constructed in. - A #GDBusInterface instance or %NULL. Free with g_object_unref(). @@ -17338,7 +16686,6 @@ that @manager was constructed in. - @@ -17354,7 +16701,6 @@ that @manager was constructed in. - @@ -17370,7 +16716,6 @@ that @manager was constructed in. - @@ -17389,7 +16734,6 @@ that @manager was constructed in. - @@ -17430,7 +16774,6 @@ See #GDBusObjectManagerClient for the client-side code that is intended to be used with #GDBusObjectManagerServer or any D-Bus object implementing the org.freedesktop.DBus.ObjectManager interface. - Creates a new #GDBusObjectManagerServer object. @@ -17440,7 +16783,6 @@ use g_dbus_object_manager_server_set_connection(). Normally you want to export all of your objects before doing so to avoid [InterfacesAdded](http://dbus.freedesktop.org/doc/dbus-specification.html#standard-interfaces-objectmanager) signals being emitted. - A #GDBusObjectManagerServer object. Free with g_object_unref(). @@ -17463,7 +16805,6 @@ object path for @manager. Note that @manager will take a reference on @object for as long as it is exported. - @@ -17483,7 +16824,6 @@ it is exported. the form _N (with N being a natural number) to @object's object path if an object with the given path already exists. As such, the #GDBusObjectProxy:g-object-path property of @object may be modified. - @@ -17500,7 +16840,6 @@ if an object with the given path already exists. As such, the Gets the #GDBusConnection used by @manager. - A #GDBusConnection object or %NULL if @manager isn't exported on a connection. The returned object should @@ -17516,7 +16855,6 @@ if an object with the given path already exists. As such, the Returns whether @object is currently exported on @manager. - %TRUE if @object is exported @@ -17535,7 +16873,6 @@ if an object with the given path already exists. As such, the Exports all objects managed by @manager on @connection. If @connection is %NULL, stops exporting objects. - @@ -17556,7 +16893,6 @@ does nothing. Note that @object_path must be in the hierarchy rooted by the object path for @manager. - %TRUE if object at @object_path was removed, %FALSE otherwise. @@ -17589,7 +16925,6 @@ object path for @manager. Class structure for #GDBusObjectManagerServer. - The parent class. @@ -17600,20 +16935,16 @@ object path for @manager. - - - + A #GDBusObjectProxy is an object used to represent a remote object with one or more D-Bus interfaces. Normally, you don't instantiate a #GDBusObjectProxy yourself - typically #GDBusObjectManagerClient is used to obtain it. - Creates a new #GDBusObjectProxy for the given connection and object path. - a new #GDBusObjectProxy @@ -17631,7 +16962,6 @@ object path. Gets the connection that @proxy is for. - A #GDBusConnection. Do not free, the object is owned by @proxy. @@ -17661,7 +16991,6 @@ object path. Class structure for #GDBusObjectProxy. - The parent class. @@ -17672,20 +17001,16 @@ object path. - - - + A #GDBusObjectSkeleton instance is essentially a group of D-Bus interfaces. The set of exported interfaces on the object may be dynamic and change at runtime. This type is intended to be used with #GDBusObjectManager. - Creates a new #GDBusObjectSkeleton. - A #GDBusObjectSkeleton. Free with g_object_unref(). @@ -17698,7 +17023,6 @@ This type is intended to be used with #GDBusObjectManager. - @@ -17722,7 +17046,6 @@ interface name, it is removed before @interface_ is added. Note that @object takes its own reference on @interface_ and holds it until removed. - @@ -17741,7 +17064,6 @@ it until removed. This method simply calls g_dbus_interface_skeleton_flush() on all interfaces belonging to @object. See that method for when flushing is useful. - @@ -17754,7 +17076,6 @@ is useful. Removes @interface_ from @object. - @@ -17774,7 +17095,6 @@ is useful. If no D-Bus interface of the given interface exists, this function does nothing. - @@ -17791,7 +17111,6 @@ does nothing. Sets the object path for @object. - @@ -17843,14 +17162,12 @@ The default class handler just returns %TRUE. Class structure for #GDBusObjectSkeleton. - The parent class. - @@ -17873,12 +17190,9 @@ The default class handler just returns %TRUE. - - - + Information about a D-Bus property on a D-Bus interface. - The reference count or -1 if statically allocated. @@ -17904,7 +17218,6 @@ The default class handler just returns %TRUE. If @info is statically allocated does nothing. Otherwise increases the reference count. - The same @info. @@ -17920,7 +17233,6 @@ the reference count. If @info is statically allocated, does nothing. Otherwise decreases the reference count of @info. When its reference count drops to 0, the memory used is freed. - @@ -17982,13 +17294,11 @@ of the thread where the instance was constructed. An example using a proxy for a well-known name can be found in [gdbus-example-watch-proxy.c](https://git.gnome.org/browse/glib/tree/gio/tests/gdbus-example-watch-proxy.c) - Finishes creating a #GDBusProxy. - A #GDBusProxy or %NULL if @error is set. Free with g_object_unref(). @@ -18003,7 +17313,6 @@ An example using a proxy for a well-known name can be found in Finishes creating a #GDBusProxy. - A #GDBusProxy or %NULL if @error is set. Free with g_object_unref(). @@ -18020,7 +17329,6 @@ An example using a proxy for a well-known name can be found in Like g_dbus_proxy_new_sync() but takes a #GBusType instead of a #GDBusConnection. #GDBusProxy is used in this [example][gdbus-wellknown-proxy]. - A #GDBusProxy or %NULL if error is set. Free with g_object_unref(). @@ -18081,7 +17389,6 @@ This is a synchronous failable constructor. See g_dbus_proxy_new() and g_dbus_proxy_new_finish() for the asynchronous version. #GDBusProxy is used in this [example][gdbus-wellknown-proxy]. - A #GDBusProxy or %NULL if error is set. Free with g_object_unref(). @@ -18146,7 +17453,6 @@ g_dbus_proxy_new_finish() to get the result. See g_dbus_proxy_new_sync() and for a synchronous version of this constructor. #GDBusProxy is used in this [example][gdbus-wellknown-proxy]. - @@ -18193,7 +17499,6 @@ See g_dbus_proxy_new_sync() and for a synchronous version of this constructor. Like g_dbus_proxy_new() but takes a #GBusType instead of a #GDBusConnection. #GDBusProxy is used in this [example][gdbus-wellknown-proxy]. - @@ -18237,7 +17542,6 @@ See g_dbus_proxy_new_sync() and for a synchronous version of this constructor. - @@ -18254,7 +17558,6 @@ See g_dbus_proxy_new_sync() and for a synchronous version of this constructor. - @@ -18316,7 +17619,6 @@ version of this method. If @callback is %NULL then the D-Bus method call message will be sent with the %G_DBUS_MESSAGE_FLAGS_NO_REPLY_EXPECTED flag set. - @@ -18359,7 +17661,6 @@ care about the result of the method invocation. Finishes an operation started with g_dbus_proxy_call(). - %NULL if @error is set. Otherwise a #GVariant tuple with return values. Free with g_variant_unref(). @@ -18411,7 +17712,6 @@ method. If @proxy has an expected interface (see #GDBusProxy:g-interface-info) and @method_name is referenced by it, then the return value is checked against the return type. - %NULL if @error is set. Otherwise a #GVariant tuple with return values. Free with g_variant_unref(). @@ -18450,7 +17750,6 @@ return values. Free with g_variant_unref(). Like g_dbus_proxy_call() but also takes a #GUnixFDList object. This method is only available on UNIX. - @@ -18497,7 +17796,6 @@ care about the result of the method invocation. Finishes an operation started with g_dbus_proxy_call_with_unix_fd_list(). - %NULL if @error is set. Otherwise a #GVariant tuple with return values. Free with g_variant_unref(). @@ -18522,7 +17820,6 @@ return values. Free with g_variant_unref(). Like g_dbus_proxy_call_sync() but also takes and returns #GUnixFDList objects. This method is only available on UNIX. - %NULL if @error is set. Otherwise a #GVariant tuple with return values. Free with g_variant_unref(). @@ -18572,7 +17869,6 @@ blocking IO. If @proxy has an expected interface (see #GDBusProxy:g-interface-info) and @property_name is referenced by it, then @value is checked against the type of the property. - A reference to the #GVariant instance that holds the value for @property_name or %NULL if the value is not in @@ -18592,7 +17888,6 @@ it, then @value is checked against the type of the property. Gets the names of all cached properties on @proxy. - A %NULL-terminated array of strings or %NULL if @@ -18611,7 +17906,6 @@ it, then @value is checked against the type of the property. Gets the connection @proxy is for. - A #GDBusConnection owned by @proxy. Do not free. @@ -18629,7 +17923,6 @@ passed as @timeout_msec in the g_dbus_proxy_call() and g_dbus_proxy_call_sync() functions. See the #GDBusProxy:g-default-timeout property for more details. - Timeout to use for @proxy. @@ -18643,7 +17936,6 @@ See the #GDBusProxy:g-default-timeout property for more details. Gets the flags that @proxy was constructed with. - Flags from the #GDBusProxyFlags enumeration. @@ -18659,7 +17951,6 @@ See the #GDBusProxy:g-default-timeout property for more details. Returns the #GDBusInterfaceInfo, if any, specifying the interface that @proxy conforms to. See the #GDBusProxy:g-interface-info property for more details. - A #GDBusInterfaceInfo or %NULL. Do not unref the returned object, it is owned by @proxy. @@ -18674,7 +17965,6 @@ property for more details. Gets the D-Bus interface name @proxy is for. - A string owned by @proxy. Do not free. @@ -18688,7 +17978,6 @@ property for more details. Gets the name that @proxy was constructed for. - A string owned by @proxy. Do not free. @@ -18705,7 +17994,6 @@ property for more details. no-one currently owns that name. You may connect to the #GObject::notify signal to track changes to the #GDBusProxy:g-name-owner property. - The name owner or %NULL if no name owner exists. Free with g_free(). @@ -18720,7 +18008,6 @@ no-one currently owns that name. You may connect to the Gets the object path @proxy is for. - A string owned by @proxy. Do not free. @@ -18766,7 +18053,6 @@ transmitting the same (long) array every time the property changes, it is more efficient to only transmit the delta using e.g. signals `ChatroomParticipantJoined(String name)` and `ChatroomParticipantParted(String name)`. - @@ -18791,7 +18077,6 @@ passed as @timeout_msec in the g_dbus_proxy_call() and g_dbus_proxy_call_sync() functions. See the #GDBusProxy:g-default-timeout property for more details. - @@ -18810,7 +18095,6 @@ See the #GDBusProxy:g-default-timeout property for more details. Ensure that interactions with @proxy conform to the given interface. See the #GDBusProxy:g-interface-info property for more details. - @@ -18955,13 +18239,11 @@ This signal corresponds to the Class structure for #GDBusProxy. - - @@ -18980,7 +18262,6 @@ This signal corresponds to the - @@ -19032,9 +18313,7 @@ autostarted by a method call. This flag is only meaningful in proxies for well-k and only if %G_DBUS_PROXY_FLAGS_DO_NOT_AUTO_START is not also specified. - - - + Function signature for a function used to determine the #GType to use for an interface proxy (if @interface_name is not %NULL) or @@ -19043,7 +18322,6 @@ object proxy (if @interface_name is %NULL). This function is called in the [thread-default main loop][g-main-context-push-thread-default] that @manager was constructed in. - A #GType to use for the remote object. The returned type must be a #GDBusProxy or #GDBusObjectProxy -derived @@ -19090,13 +18368,15 @@ implement the org.freedesktop.DBus interface. To just export an object on a well-known name on a message bus, such as the session or system bus, you should instead use g_bus_own_name(). -An example of peer-to-peer communication with G-DBus can be found +An example of peer-to-peer communication with GDBus can be found in [gdbus-example-peer.c](https://git.gnome.org/browse/glib/tree/gio/tests/gdbus-example-peer.c). Note that a minimal #GDBusServer will accept connections from any peer. In many use-cases it will be necessary to add a #GDBusAuthObserver that only accepts connections that have successfully authenticated -as the same user that is running the #GDBusServer. +as the same user that is running the #GDBusServer. Since GLib 2.68 this can +be achieved more simply by passing the +%G_DBUS_SERVER_FLAGS_AUTHENTICATION_REQUIRE_SAME_USER flag to the server. Creates a new D-Bus server that listens on the first address in @@ -19119,7 +18399,6 @@ g_dbus_server_start(). This is a synchronous failable constructor. There is currently no asynchronous version. - A #GDBusServer or %NULL if @error is set. Free with g_object_unref(). @@ -19152,7 +18431,6 @@ g_object_unref(). Gets a [D-Bus address](https://dbus.freedesktop.org/doc/dbus-specification.html#addresses) string that can be used by clients to connect to @server. - A D-Bus address string. Do not free, the string is owned by @server. @@ -19167,7 +18445,6 @@ by @server. Gets the flags for @server. - A set of flags from the #GDBusServerFlags enumeration. @@ -19181,7 +18458,6 @@ by @server. Gets the GUID for @server. - A D-Bus GUID. Do not free this string, it is owned by @server. @@ -19195,7 +18471,6 @@ by @server. Gets whether @server is active. - %TRUE if server is active, %FALSE otherwise. @@ -19209,7 +18484,6 @@ by @server. Starts @server. - @@ -19222,7 +18496,6 @@ by @server. Stops @server. - @@ -19309,7 +18582,6 @@ authentication method. Signature for callback function used in g_dbus_connection_signal_subscribe(). - @@ -19367,7 +18639,6 @@ or one of the paths is a subpath of the other. Information about a signal on a D-Bus interface. - The reference count or -1 if statically allocated. @@ -19391,7 +18662,6 @@ or one of the paths is a subpath of the other. If @info is statically allocated does nothing. Otherwise increases the reference count. - The same @info. @@ -19407,7 +18677,6 @@ the reference count. If @info is statically allocated, does nothing. Otherwise decreases the reference count of @info. When its reference count drops to 0, the memory used is freed. - @@ -19424,7 +18693,6 @@ the memory used is freed. Subtrees are flat. @node, if non-%NULL, is always exactly one segment of the object path (ie: it never contains a slash). - A #GDBusInterfaceVTable or %NULL if you don't want to handle the methods. @@ -19472,7 +18740,6 @@ Hierarchies are not supported; the items that you return should not contain the '/' character. The return value will be freed with g_strfreev(). - A newly allocated array of strings for node names that are children of @object_path. @@ -19528,7 +18795,6 @@ The difference between returning %NULL and an array containing zero items is that the standard DBus interfaces will returned to the remote introspector in the empty array case, but not in the %NULL case. - A %NULL-terminated array of pointers to #GDBusInterfaceInfo, or %NULL. @@ -19558,7 +18824,6 @@ case. Virtual table for handling subtrees registered with g_dbus_connection_register_subtree(). - Function for enumerating child nodes. @@ -19578,28 +18843,24 @@ case. - - - - @@ -19610,25 +18871,21 @@ case. [Extending GIO][extending-gio]. The #GDesktopAppInfoLookup interface is deprecated and unused by GIO. - - - - @@ -19636,46 +18893,39 @@ case. The string used to obtain a Unix device path with g_drive_get_identifier(). - - - - - - - @@ -19684,11 +18934,9 @@ case. Data input stream implements #GInputStream and includes functions for reading structured data directly from a binary input stream. - Creates a new data input stream for the @base_stream. - a new #GDataInputStream. @@ -19702,7 +18950,6 @@ reading structured data directly from a binary input stream. Gets the byte order for the data input stream. - the @stream's current #GDataStreamByteOrder. @@ -19716,7 +18963,6 @@ reading structured data directly from a binary input stream. Gets the current newline type for the @stream. - #GDataStreamNewlineType for the given @stream. @@ -19730,7 +18976,6 @@ reading structured data directly from a binary input stream. Reads an unsigned 8-bit/1-byte value from @stream. - an unsigned 8-bit/1-byte value read from the @stream or `0` if an error occurred. @@ -19752,7 +18997,6 @@ if an error occurred. In order to get the correct byte order for this read operation, see g_data_input_stream_get_byte_order() and g_data_input_stream_set_byte_order(). - a signed 16-bit/2-byte value read from @stream or `0` if an error occurred. @@ -19778,7 +19022,6 @@ see g_data_input_stream_get_byte_order() and g_data_input_stream_set_byte_order( If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. - a signed 32-bit/4-byte value read from the @stream or `0` if an error occurred. @@ -19804,7 +19047,6 @@ see g_data_input_stream_get_byte_order() and g_data_input_stream_set_byte_order( If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. - a signed 64-bit/8-byte value read from @stream or `0` if an error occurred. @@ -19829,7 +19071,6 @@ be UTF-8, and may in fact have embedded NUL characters. If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. - a NUL terminated byte array with the line that was read in @@ -19863,7 +19104,6 @@ an error to have two outstanding calls to this function. When the operation is finished, @callback will be called. You can then call g_data_input_stream_read_line_finish() to get the result of the operation. - @@ -19895,7 +19135,6 @@ the result of the operation. g_data_input_stream_read_line_async(). Note the warning about string encoding in g_data_input_stream_read_line() applies here as well. - a NUL-terminated byte array with the line that was read in @@ -19925,7 +19164,6 @@ well. Finish an asynchronous call started by g_data_input_stream_read_line_async(). - a string with the line that was read in (without the newlines). Set @length to a #gsize to @@ -19956,7 +19194,6 @@ g_data_input_stream_read_line_async(). If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. - a NUL terminated UTF-8 string with the line that was read in (without the newlines). Set @@ -19987,7 +19224,6 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. In order to get the correct byte order for this read operation, see g_data_input_stream_get_byte_order() and g_data_input_stream_set_byte_order(). - an unsigned 16-bit/2-byte value read from the @stream or `0` if an error occurred. @@ -20013,7 +19249,6 @@ see g_data_input_stream_get_byte_order() and g_data_input_stream_set_byte_order( If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. - an unsigned 32-bit/4-byte value read from the @stream or `0` if an error occurred. @@ -20039,7 +19274,6 @@ see g_data_input_stream_get_byte_order(). If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. - an unsigned 64-bit/8-byte read from @stream or `0` if an error occurred. @@ -20070,7 +19304,6 @@ g_data_input_stream_read_upto() instead, but note that that function does not consume the stop character. Use g_data_input_stream_read_upto() instead, which has more consistent behaviour regarding the stop character. - a string with the data that was read before encountering any of the stop characters. Set @length to @@ -20115,7 +19348,6 @@ will be marked as deprecated in a future release. Use g_data_input_stream_read_upto_async() instead. Use g_data_input_stream_read_upto_async() instead, which has more consistent behaviour regarding the stop character. - @@ -20151,7 +19383,6 @@ g_data_input_stream_read_upto_async() instead. g_data_input_stream_read_until_async(). Use g_data_input_stream_read_upto_finish() instead, which has more consistent behaviour regarding the stop character. - a string with the data that was read before encountering any of the stop characters. Set @length to @@ -20187,7 +19418,6 @@ Note that @stop_chars may contain '\0' if @stop_chars_len is specified. The returned string will always be nul-terminated on success. - a string with the data that was read before encountering any of the stop characters. Set @length to @@ -20234,7 +19464,6 @@ specified. When the operation is finished, @callback will be called. You can then call g_data_input_stream_read_upto_finish() to get the result of the operation. - @@ -20279,7 +19508,6 @@ have to use g_data_input_stream_read_byte() to get it before calling g_data_input_stream_read_upto_async() again. The returned string will always be nul-terminated on success. - a string with the data that was read before encountering any of the stop characters. Set @length to @@ -20305,7 +19533,6 @@ The returned string will always be nul-terminated on success. This function sets the byte order for the given @stream. All subsequent reads from the @stream will be read in the given @order. - @@ -20326,7 +19553,6 @@ reads from the @stream will be read in the given @order. Note that using G_DATA_STREAM_NEWLINE_TYPE_ANY is slightly unsafe. If a read chunk ends in "CR" we must read an additional byte to know if this is "CR" or "CR LF", and this might block if there is no more data available. - @@ -20355,13 +19581,11 @@ chunk ends in "CR" we must read an additional byte to know if this is "CR" or - - @@ -20369,7 +19593,6 @@ chunk ends in "CR" we must read an additional byte to know if this is "CR" or - @@ -20377,7 +19600,6 @@ chunk ends in "CR" we must read an additional byte to know if this is "CR" or - @@ -20385,7 +19607,6 @@ chunk ends in "CR" we must read an additional byte to know if this is "CR" or - @@ -20393,24 +19614,19 @@ chunk ends in "CR" we must read an additional byte to know if this is "CR" or - - - - + Data output stream implements #GOutputStream and includes functions for writing data directly to an output stream. - Creates a new data output stream for @base_stream. - #GDataOutputStream. @@ -20424,7 +19640,6 @@ writing data directly to an output stream. Gets the byte order for the stream. - the #GDataStreamByteOrder for the @stream. @@ -20438,7 +19653,6 @@ writing data directly to an output stream. Puts a byte into the output stream. - %TRUE if @data was successfully added to the @stream. @@ -20460,7 +19674,6 @@ writing data directly to an output stream. Puts a signed 16-bit integer into the output stream. - %TRUE if @data was successfully added to the @stream. @@ -20482,7 +19695,6 @@ writing data directly to an output stream. Puts a signed 32-bit integer into the output stream. - %TRUE if @data was successfully added to the @stream. @@ -20504,7 +19716,6 @@ writing data directly to an output stream. Puts a signed 64-bit integer into the stream. - %TRUE if @data was successfully added to the @stream. @@ -20526,7 +19737,6 @@ writing data directly to an output stream. Puts a string into the output stream. - %TRUE if @string was successfully added to the @stream. @@ -20548,7 +19758,6 @@ writing data directly to an output stream. Puts an unsigned 16-bit integer into the output stream. - %TRUE if @data was successfully added to the @stream. @@ -20570,7 +19779,6 @@ writing data directly to an output stream. Puts an unsigned 32-bit integer into the stream. - %TRUE if @data was successfully added to the @stream. @@ -20592,7 +19800,6 @@ writing data directly to an output stream. Puts an unsigned 64-bit integer into the stream. - %TRUE if @data was successfully added to the @stream. @@ -20614,7 +19821,6 @@ writing data directly to an output stream. Sets the byte order of the data output stream to @order. - @@ -20642,13 +19848,11 @@ multi-byte entities (such as integers) to the stream. - - @@ -20656,7 +19860,6 @@ multi-byte entities (such as integers) to the stream. - @@ -20664,7 +19867,6 @@ multi-byte entities (such as integers) to the stream. - @@ -20672,7 +19874,6 @@ multi-byte entities (such as integers) to the stream. - @@ -20680,16 +19881,13 @@ multi-byte entities (such as integers) to the stream. - - - - + #GDataStreamByteOrder is used to ensure proper endianness of streaming data sources across various machine architectures. @@ -20766,7 +19964,6 @@ received in each I/O operation. Like most other APIs in GLib, #GDatagramBased is not inherently thread safe. To use a #GDatagramBased concurrently from multiple threads, you must implement your own locking. - Checks on the readiness of @datagram_based to perform operations. The operations specified in @condition are checked for and masked against the @@ -20804,7 +20001,6 @@ conditions will always be set in the output if they are true. Apart from these flags, the output is guaranteed to be masked by @condition. This call never blocks. - the #GIOCondition mask of the current state @@ -20827,7 +20023,6 @@ This call never blocks. If @cancellable is cancelled before the condition is met, or if @timeout is reached before the condition is met, then %FALSE is returned and @error is set appropriately (%G_IO_ERROR_CANCELLED or %G_IO_ERROR_TIMED_OUT). - %TRUE if the condition was met, %FALSE otherwise @@ -20867,7 +20062,6 @@ cause the source to trigger, reporting the current condition (which is likely 0 unless cancellation happened at the same time as a condition change). You can check for this in the callback using g_cancellable_is_cancelled(). - a newly allocated #GSource @@ -20938,7 +20132,6 @@ be returned if zero messages could be received; otherwise the number of messages successfully received before the error will be returned. If @cancellable is cancelled, %G_IO_ERROR_CANCELLED is returned as with any other error. - number of messages received, or -1 on error. Note that the number of messages received may be smaller than @num_messages if @timeout is @@ -21019,7 +20212,6 @@ On error -1 is returned and @error is set accordingly. An error will only be returned if zero messages could be sent; otherwise the number of messages successfully sent before the error will be returned. If @cancellable is cancelled, %G_IO_ERROR_CANCELLED is returned as with any other error. - number of messages sent, or -1 on error. Note that the number of messages sent may be smaller than @num_messages if @timeout is zero @@ -21094,7 +20286,6 @@ conditions will always be set in the output if they are true. Apart from these flags, the output is guaranteed to be masked by @condition. This call never blocks. - the #GIOCondition mask of the current state @@ -21117,7 +20308,6 @@ This call never blocks. If @cancellable is cancelled before the condition is met, or if @timeout is reached before the condition is met, then %FALSE is returned and @error is set appropriately (%G_IO_ERROR_CANCELLED or %G_IO_ERROR_TIMED_OUT). - %TRUE if the condition was met, %FALSE otherwise @@ -21157,7 +20347,6 @@ cause the source to trigger, reporting the current condition (which is likely 0 unless cancellation happened at the same time as a condition change). You can check for this in the callback using g_cancellable_is_cancelled(). - a newly allocated #GSource @@ -21228,7 +20417,6 @@ be returned if zero messages could be received; otherwise the number of messages successfully received before the error will be returned. If @cancellable is cancelled, %G_IO_ERROR_CANCELLED is returned as with any other error. - number of messages received, or -1 on error. Note that the number of messages received may be smaller than @num_messages if @timeout is @@ -21309,7 +20497,6 @@ On error -1 is returned and @error is set accordingly. An error will only be returned if zero messages could be sent; otherwise the number of messages successfully sent before the error will be returned. If @cancellable is cancelled, %G_IO_ERROR_CANCELLED is returned as with any other error. - number of messages sent, or -1 on error. Note that the number of messages sent may be smaller than @num_messages if @timeout is zero @@ -21354,14 +20541,12 @@ following the Berkeley sockets API. The interface methods are thin wrappers around the corresponding virtual methods, and no pre-processing of inputs is implemented — so implementations of this API must handle all functionality documented in the interface methods. - The parent interface. - number of messages received, or -1 on error. Note that the number of messages received may be smaller than @num_messages if @timeout is @@ -21403,7 +20588,6 @@ documented in the interface methods. - number of messages sent, or -1 on error. Note that the number of messages sent may be smaller than @num_messages if @timeout is zero @@ -21444,7 +20628,6 @@ documented in the interface methods. - a newly allocated #GSource @@ -21467,7 +20650,6 @@ documented in the interface methods. - the #GIOCondition mask of the current state @@ -21486,7 +20668,6 @@ documented in the interface methods. - %TRUE if the condition was met, %FALSE otherwise @@ -21516,7 +20697,6 @@ documented in the interface methods. This is the function type of the callback used for the #GSource returned by g_datagram_based_create_source(). - %G_SOURCE_REMOVE if the source should be removed, %G_SOURCE_CONTINUE otherwise @@ -21544,7 +20724,6 @@ desktop files. Note that `<gio/gdesktopappinfo.h>` belongs to the UNIX-specific GIO interfaces, thus you have to use the `gio-unix-2.0.pc` pkg-config file when using it. - Creates a new #GDesktopAppInfo based on a desktop file id. @@ -21558,7 +20737,6 @@ prefix-to-subdirectory mapping that is described in the [Menu Spec](http://standards.freedesktop.org/menu-spec/latest/) (i.e. a desktop id of kde-foo.desktop will match `/usr/share/applications/kde/foo.desktop`). - a new #GDesktopAppInfo, or %NULL if no desktop file with that id exists. @@ -21573,7 +20751,6 @@ prefix-to-subdirectory mapping that is described in the Creates a new #GDesktopAppInfo. - a new #GDesktopAppInfo or %NULL on error. @@ -21588,7 +20765,6 @@ prefix-to-subdirectory mapping that is described in the Creates a new #GDesktopAppInfo. - a new #GDesktopAppInfo or %NULL on error. @@ -21605,7 +20781,6 @@ prefix-to-subdirectory mapping that is described in the An application implements an interface if that interface is listed in the Implements= line of the desktop file of the application. - a list of #GDesktopAppInfo objects. @@ -21636,7 +20811,6 @@ the executable referenced by a result exists), and so it is possible for g_desktop_app_info_new() to return %NULL when passed an app ID returned by this function. It is expected that calling code will do this when subsequently creating a #GDesktopAppInfo for each result. - a list of strvs. Free each item with g_strfreev() and free the outer @@ -21664,7 +20838,6 @@ desktop entry fields. Should be called only once; subsequent calls are ignored. do not use this API. Since 2.42 the value of the `XDG_CURRENT_DESKTOP` environment variable will be used. - @@ -21681,7 +20854,6 @@ action" specified by @action_name. This corresponds to the "Name" key within the keyfile group for the action. - the locale-specific action name @@ -21702,7 +20874,6 @@ action. Looks up a boolean value in the keyfile backing @info. The @key is looked up in the "Desktop Entry" group. - the boolean value, or %FALSE if the key is not found @@ -21721,8 +20892,7 @@ The @key is looked up in the "Desktop Entry" group. Gets the categories from the desktop file. - - + The unparsed Categories key from the desktop file; i.e. no attempt is made to split it by ';' or validate it. @@ -21738,8 +20908,7 @@ The @key is looked up in the "Desktop Entry" group. When @info was created from a known filename, return it. In some situations such as the #GDesktopAppInfo returned from g_desktop_app_info_new_from_keyfile(), this function will return %NULL. - - + The full path to the file for @info, or %NULL if not known. @@ -21752,9 +20921,8 @@ g_desktop_app_info_new_from_keyfile(), this function will return %NULL. - Gets the generic name from the destkop file. - - + Gets the generic name from the desktop file. + The value of the GenericName key @@ -21768,7 +20936,6 @@ g_desktop_app_info_new_from_keyfile(), this function will return %NULL. A desktop file is hidden if the Hidden key in it is set to True. - %TRUE if hidden, %FALSE otherwise. @@ -21782,7 +20949,6 @@ set to True. Gets the keywords from the desktop file. - The value of the Keywords key @@ -21801,7 +20967,6 @@ set to True. translated to the current locale. The @key is looked up in the "Desktop Entry" group. - a newly allocated string, or %NULL if the key is not found @@ -21822,7 +20987,6 @@ The @key is looked up in the "Desktop Entry" group. Gets the value of the NoDisplay key, which helps determine if the application info should be shown in menus. See #G_KEY_FILE_DESKTOP_KEY_NO_DISPLAY and g_app_info_should_show(). - The value of the NoDisplay key @@ -21846,7 +21010,6 @@ but this is not recommended. Note that g_app_info_should_show() for @info will include this check (with %NULL for @desktop_env) as well as additional checks. - %TRUE if the @info should be shown in @desktop_env according to the `OnlyShowIn` and `NotShowIn` keys, %FALSE @@ -21868,8 +21031,7 @@ otherwise. Retrieves the StartupWMClass field from @info. This represents the WM_CLASS property of the main window of the application, if launched through @info. - - + the startup WM class, or %NULL if none is set in the desktop file. @@ -21885,8 +21047,7 @@ in the desktop file. Looks up a string value in the keyfile backing @info. The @key is looked up in the "Desktop Entry" group. - - + a newly allocated string, or %NULL if the key is not found @@ -21906,7 +21067,6 @@ The @key is looked up in the "Desktop Entry" group. Looks up a string list value in the keyfile backing @info. The @key is looked up in the "Desktop Entry" group. - a %NULL-terminated string array or %NULL if the specified @@ -21933,7 +21093,6 @@ The @key is looked up in the "Desktop Entry" group. Returns whether @key exists in the "Desktop Entry" group of the keyfile backing @info. - %TRUE if the @key exists @@ -21965,7 +21124,6 @@ actions, as per the desktop file specification. As with g_app_info_launch() there is no way to detect failures that occur while using this function. - @@ -22001,7 +21159,6 @@ optimized posix_spawn() codepath to be used. If application launching occurs via some other mechanism (eg: D-Bus activation) then @spawn_flags, @user_setup, @user_setup_data, @pid_callback and @pid_callback_data are ignored. - %TRUE on successful launch, %FALSE otherwise. @@ -22051,7 +21208,6 @@ of the launched process. If application launching occurs via some non-spawn mechanism (e.g. D-Bus activation) then @stdin_fd, @stdout_fd and @stderr_fd are ignored. - %TRUE on successful launch, %FALSE otherwise. @@ -22112,7 +21268,6 @@ desktop file, as per the desktop file specification. As per the specification, this is the list of actions that are explicitly listed in the "Actions" key of the [Desktop Entry] group. - a list of strings, always non-%NULL @@ -22132,7 +21287,6 @@ explicitly listed in the "Actions" key of the [Desktop Entry] group. - @@ -22142,7 +21296,6 @@ explicitly listed in the "Actions" key of the [Desktop Entry] group. using the following functions. The #GDesktopAppInfoLookup interface is deprecated and unused by GIO. - Gets the default application for launching applications using this URI scheme for a particular #GDesktopAppInfoLookup @@ -22154,7 +21307,6 @@ in a GIO module. There is no reason for applications to use it directly. Applications should use g_app_info_get_default_for_uri_scheme(). The #GDesktopAppInfoLookup interface is deprecated and unused by GIO. - #GAppInfo for given @uri_scheme or %NULL on error. @@ -22182,7 +21334,6 @@ in a GIO module. There is no reason for applications to use it directly. Applications should use g_app_info_get_default_for_uri_scheme(). The #GDesktopAppInfoLookup interface is deprecated and unused by GIO. - #GAppInfo for given @uri_scheme or %NULL on error. @@ -22203,13 +21354,11 @@ directly. Applications should use g_app_info_get_default_for_uri_scheme(). Interface that is used by backends to associate default handlers with URI schemes. - - #GAppInfo for given @uri_scheme or %NULL on error. @@ -22232,7 +21381,6 @@ handlers with URI schemes. During invocation, g_desktop_app_info_launch_uris_as_manager() may create one or more child processes. This callback is invoked once for each, providing the process ID. - @@ -22278,10 +21426,8 @@ file manager, use g_drive_get_start_stop_type(). For porting from GnomeVFS note that there is no equivalent of #GDrive in that API. - Checks if a drive can be ejected. - %TRUE if the @drive can be ejected, %FALSE otherwise. @@ -22295,7 +21441,6 @@ For porting from GnomeVFS note that there is no equivalent of Checks if a drive can be polled for media changes. - %TRUE if the @drive can be polled for media changes, %FALSE otherwise. @@ -22310,7 +21455,6 @@ For porting from GnomeVFS note that there is no equivalent of Checks if a drive can be started. - %TRUE if the @drive can be started, %FALSE otherwise. @@ -22324,7 +21468,6 @@ For porting from GnomeVFS note that there is no equivalent of Checks if a drive can be started degraded. - %TRUE if the @drive can be started degraded, %FALSE otherwise. @@ -22338,7 +21481,6 @@ For porting from GnomeVFS note that there is no equivalent of Checks if a drive can be stopped. - %TRUE if the @drive can be stopped, %FALSE otherwise. @@ -22351,7 +21493,6 @@ For porting from GnomeVFS note that there is no equivalent of - @@ -22362,7 +21503,6 @@ For porting from GnomeVFS note that there is no equivalent of - @@ -22379,7 +21519,6 @@ When the operation is finished, @callback will be called. You can then call g_drive_eject_finish() to obtain the result of the operation. Use g_drive_eject_with_operation() instead. - @@ -22407,7 +21546,6 @@ result of the operation. - @@ -22420,7 +21558,6 @@ result of the operation. Finishes ejecting a drive. Use g_drive_eject_with_operation_finish() instead. - %TRUE if the drive has been ejected successfully, %FALSE otherwise. @@ -22441,7 +21578,6 @@ result of the operation. Ejects a drive. This is an asynchronous operation, and is finished by calling g_drive_eject_with_operation_finish() with the @drive and #GAsyncResult data returned in the @callback. - @@ -22476,7 +21612,6 @@ and #GAsyncResult data returned in the @callback. Finishes ejecting a drive. If any errors occurred during the operation, @error will be set to contain the errors and %FALSE will be returned. - %TRUE if the drive was successfully ejected. %FALSE otherwise. @@ -22496,7 +21631,6 @@ and #GAsyncResult data returned in the @callback. Gets the kinds of identifiers that @drive has. Use g_drive_get_identifier() to obtain the identifiers themselves. - a %NULL-terminated array of strings containing kinds of identifiers. Use g_strfreev() @@ -22514,7 +21648,6 @@ themselves. Gets the icon for @drive. - #GIcon for the @drive. Free the returned object with g_object_unref(). @@ -22531,7 +21664,6 @@ themselves. Gets the identifier of the given kind for @drive. The only identifier currently available is #G_DRIVE_IDENTIFIER_KIND_UNIX_DEVICE. - a newly allocated string containing the requested identifier, or %NULL if the #GDrive @@ -22551,7 +21683,6 @@ identifier currently available is Gets the name of @drive. - a string containing @drive's name. The returned string should be freed when no longer needed. @@ -22566,7 +21697,6 @@ identifier currently available is Gets the sort key for @drive, if any. - Sorting key for @drive or %NULL if no such key is available. @@ -22580,7 +21710,6 @@ identifier currently available is Gets a hint about how a drive can be started/stopped. - A value from the #GDriveStartStopType enumeration. @@ -22594,7 +21723,6 @@ identifier currently available is Gets the icon for @drive. - symbolic #GIcon for the @drive. Free the returned object with g_object_unref(). @@ -22612,7 +21740,6 @@ identifier currently available is The returned list should be freed with g_list_free(), after its elements have been unreffed with g_object_unref(). - #GList containing any #GVolume objects on the given @drive. @@ -22630,7 +21757,6 @@ its elements have been unreffed with g_object_unref(). Checks if the @drive has media. Note that the OS may not be polling the drive for media changes; see g_drive_is_media_check_automatic() for more details. - %TRUE if @drive has media, %FALSE otherwise. @@ -22644,7 +21770,6 @@ for more details. Check if @drive has any mountable volumes. - %TRUE if the @drive contains volumes, %FALSE otherwise. @@ -22658,7 +21783,6 @@ for more details. Checks if @drive is capable of automatically detecting media changes. - %TRUE if the @drive is capable of automatically detecting media changes, %FALSE otherwise. @@ -22673,7 +21797,6 @@ for more details. Checks if the @drive supports removable media. - %TRUE if @drive supports removable media, %FALSE otherwise. @@ -22688,7 +21811,6 @@ for more details. Checks if the #GDrive and/or its media is considered removable by the user. See g_drive_is_media_removable(). - %TRUE if @drive and/or its media is considered removable, %FALSE otherwise. @@ -22706,7 +21828,6 @@ See g_drive_is_media_removable(). When the operation is finished, @callback will be called. You can then call g_drive_poll_for_media_finish() to obtain the result of the operation. - @@ -22731,7 +21852,6 @@ result of the operation. Finishes an operation started with g_drive_poll_for_media() on a drive. - %TRUE if the drive has been poll_for_mediaed successfully, %FALSE otherwise. @@ -22754,7 +21874,6 @@ result of the operation. When the operation is finished, @callback will be called. You can then call g_drive_start_finish() to obtain the result of the operation. - @@ -22788,7 +21907,6 @@ result of the operation. Finishes starting a drive. - %TRUE if the drive has been started successfully, %FALSE otherwise. @@ -22811,7 +21929,6 @@ result of the operation. When the operation is finished, @callback will be called. You can then call g_drive_stop_finish() to obtain the result of the operation. - @@ -22844,7 +21961,6 @@ result of the operation. - @@ -22856,7 +21972,6 @@ result of the operation. Finishes stopping a drive. - %TRUE if the drive has been stopped successfully, %FALSE otherwise. @@ -22875,7 +21990,6 @@ result of the operation. Checks if a drive can be ejected. - %TRUE if the @drive can be ejected, %FALSE otherwise. @@ -22889,7 +22003,6 @@ result of the operation. Checks if a drive can be polled for media changes. - %TRUE if the @drive can be polled for media changes, %FALSE otherwise. @@ -22904,7 +22017,6 @@ result of the operation. Checks if a drive can be started. - %TRUE if the @drive can be started, %FALSE otherwise. @@ -22918,7 +22030,6 @@ result of the operation. Checks if a drive can be started degraded. - %TRUE if the @drive can be started degraded, %FALSE otherwise. @@ -22932,7 +22043,6 @@ result of the operation. Checks if a drive can be stopped. - %TRUE if the @drive can be stopped, %FALSE otherwise. @@ -22951,7 +22061,6 @@ When the operation is finished, @callback will be called. You can then call g_drive_eject_finish() to obtain the result of the operation. Use g_drive_eject_with_operation() instead. - @@ -22981,7 +22090,6 @@ result of the operation. Finishes ejecting a drive. Use g_drive_eject_with_operation_finish() instead. - %TRUE if the drive has been ejected successfully, %FALSE otherwise. @@ -23002,7 +22110,6 @@ result of the operation. Ejects a drive. This is an asynchronous operation, and is finished by calling g_drive_eject_with_operation_finish() with the @drive and #GAsyncResult data returned in the @callback. - @@ -23037,7 +22144,6 @@ and #GAsyncResult data returned in the @callback. Finishes ejecting a drive. If any errors occurred during the operation, @error will be set to contain the errors and %FALSE will be returned. - %TRUE if the drive was successfully ejected. %FALSE otherwise. @@ -23057,7 +22163,6 @@ and #GAsyncResult data returned in the @callback. Gets the kinds of identifiers that @drive has. Use g_drive_get_identifier() to obtain the identifiers themselves. - a %NULL-terminated array of strings containing kinds of identifiers. Use g_strfreev() @@ -23075,7 +22180,6 @@ themselves. Gets the icon for @drive. - #GIcon for the @drive. Free the returned object with g_object_unref(). @@ -23092,7 +22196,6 @@ themselves. Gets the identifier of the given kind for @drive. The only identifier currently available is #G_DRIVE_IDENTIFIER_KIND_UNIX_DEVICE. - a newly allocated string containing the requested identifier, or %NULL if the #GDrive @@ -23112,7 +22215,6 @@ identifier currently available is Gets the name of @drive. - a string containing @drive's name. The returned string should be freed when no longer needed. @@ -23127,7 +22229,6 @@ identifier currently available is Gets the sort key for @drive, if any. - Sorting key for @drive or %NULL if no such key is available. @@ -23141,7 +22242,6 @@ identifier currently available is Gets a hint about how a drive can be started/stopped. - A value from the #GDriveStartStopType enumeration. @@ -23155,7 +22255,6 @@ identifier currently available is Gets the icon for @drive. - symbolic #GIcon for the @drive. Free the returned object with g_object_unref(). @@ -23173,7 +22272,6 @@ identifier currently available is The returned list should be freed with g_list_free(), after its elements have been unreffed with g_object_unref(). - #GList containing any #GVolume objects on the given @drive. @@ -23191,7 +22289,6 @@ its elements have been unreffed with g_object_unref(). Checks if the @drive has media. Note that the OS may not be polling the drive for media changes; see g_drive_is_media_check_automatic() for more details. - %TRUE if @drive has media, %FALSE otherwise. @@ -23205,7 +22302,6 @@ for more details. Check if @drive has any mountable volumes. - %TRUE if the @drive contains volumes, %FALSE otherwise. @@ -23219,7 +22315,6 @@ for more details. Checks if @drive is capable of automatically detecting media changes. - %TRUE if the @drive is capable of automatically detecting media changes, %FALSE otherwise. @@ -23234,7 +22329,6 @@ for more details. Checks if the @drive supports removable media. - %TRUE if @drive supports removable media, %FALSE otherwise. @@ -23249,7 +22343,6 @@ for more details. Checks if the #GDrive and/or its media is considered removable by the user. See g_drive_is_media_removable(). - %TRUE if @drive and/or its media is considered removable, %FALSE otherwise. @@ -23267,7 +22360,6 @@ See g_drive_is_media_removable(). When the operation is finished, @callback will be called. You can then call g_drive_poll_for_media_finish() to obtain the result of the operation. - @@ -23292,7 +22384,6 @@ result of the operation. Finishes an operation started with g_drive_poll_for_media() on a drive. - %TRUE if the drive has been poll_for_mediaed successfully, %FALSE otherwise. @@ -23315,7 +22406,6 @@ result of the operation. When the operation is finished, @callback will be called. You can then call g_drive_start_finish() to obtain the result of the operation. - @@ -23349,7 +22439,6 @@ result of the operation. Finishes starting a drive. - %TRUE if the drive has been started successfully, %FALSE otherwise. @@ -23372,7 +22461,6 @@ result of the operation. When the operation is finished, @callback will be called. You can then call g_drive_stop_finish() to obtain the result of the operation. - @@ -23406,7 +22494,6 @@ result of the operation. Finishes stopping a drive. - %TRUE if the drive has been stopped successfully, %FALSE otherwise. @@ -23455,14 +22542,12 @@ been pressed. Interface for creating #GDrive implementations. - The parent interface. - @@ -23475,7 +22560,6 @@ been pressed. - @@ -23488,7 +22572,6 @@ been pressed. - @@ -23501,7 +22584,6 @@ been pressed. - a string containing @drive's name. The returned string should be freed when no longer needed. @@ -23517,7 +22599,6 @@ been pressed. - #GIcon for the @drive. Free the returned object with g_object_unref(). @@ -23533,7 +22614,6 @@ been pressed. - %TRUE if the @drive contains volumes, %FALSE otherwise. @@ -23548,7 +22628,6 @@ been pressed. - #GList containing any #GVolume objects on the given @drive. @@ -23565,7 +22644,6 @@ been pressed. - %TRUE if @drive supports removable media, %FALSE otherwise. @@ -23580,7 +22658,6 @@ been pressed. - %TRUE if @drive has media, %FALSE otherwise. @@ -23595,7 +22672,6 @@ been pressed. - %TRUE if the @drive is capable of automatically detecting media changes, %FALSE otherwise. @@ -23611,7 +22687,6 @@ been pressed. - %TRUE if the @drive can be ejected, %FALSE otherwise. @@ -23626,7 +22701,6 @@ been pressed. - %TRUE if the @drive can be polled for media changes, %FALSE otherwise. @@ -23642,7 +22716,6 @@ been pressed. - @@ -23672,7 +22745,6 @@ been pressed. - %TRUE if the drive has been ejected successfully, %FALSE otherwise. @@ -23692,7 +22764,6 @@ been pressed. - @@ -23718,7 +22789,6 @@ been pressed. - %TRUE if the drive has been poll_for_mediaed successfully, %FALSE otherwise. @@ -23738,7 +22808,6 @@ been pressed. - a newly allocated string containing the requested identifier, or %NULL if the #GDrive @@ -23759,7 +22828,6 @@ been pressed. - a %NULL-terminated array of strings containing kinds of identifiers. Use g_strfreev() @@ -23778,7 +22846,6 @@ been pressed. - A value from the #GDriveStartStopType enumeration. @@ -23793,7 +22860,6 @@ been pressed. - %TRUE if the @drive can be started, %FALSE otherwise. @@ -23808,7 +22874,6 @@ been pressed. - %TRUE if the @drive can be started degraded, %FALSE otherwise. @@ -23823,7 +22888,6 @@ been pressed. - @@ -23858,7 +22922,6 @@ been pressed. - %TRUE if the drive has been started successfully, %FALSE otherwise. @@ -23878,7 +22941,6 @@ been pressed. - %TRUE if the @drive can be stopped, %FALSE otherwise. @@ -23893,7 +22955,6 @@ been pressed. - @@ -23928,7 +22989,6 @@ been pressed. - %TRUE if the drive has been stopped successfully, %FALSE otherwise. @@ -23948,7 +23008,6 @@ been pressed. - @@ -23961,7 +23020,6 @@ been pressed. - @@ -23996,7 +23054,6 @@ been pressed. - %TRUE if the drive was successfully ejected. %FALSE otherwise. @@ -24015,7 +23072,6 @@ been pressed. - Sorting key for @drive or %NULL if no such key is available. @@ -24030,7 +23086,6 @@ been pressed. - symbolic #GIcon for the @drive. Free the returned object with g_object_unref(). @@ -24046,7 +23101,6 @@ been pressed. - %TRUE if @drive and/or its media is considered removable, %FALSE otherwise. @@ -24095,13 +23149,11 @@ been pressed. #GDtlsClientConnection is the client-side subclass of #GDtlsConnection, representing a client-side DTLS connection. - Creates a new #GDtlsClientConnection wrapping @base_socket which is assumed to communicate with the server identified by @server_identity. - the new #GDtlsClientConnection, or %NULL on error @@ -24126,7 +23178,6 @@ Otherwise, it will be %NULL. Each item in the list is a #GByteArray which contains the complete subject DN of the certificate authority. - the list of CA DNs. You should unref each element with g_byte_array_unref() and then @@ -24146,7 +23197,6 @@ the free the list with g_list_free(). Gets @conn's expected server identity - a #GSocketConnectable describing the expected server identity, or %NULL if the expected identity is not @@ -24162,7 +23212,6 @@ known. Gets @conn's validation flags - the validation flags @@ -24179,7 +23228,6 @@ known. servers on virtual hosts which certificate to present, and also to let @conn know what name to look for in the certificate when performing %G_TLS_CERTIFICATE_BAD_IDENTITY validation, if enabled. - @@ -24198,7 +23246,6 @@ performing %G_TLS_CERTIFICATE_BAD_IDENTITY validation, if enabled. Sets @conn's validation flags, to override the default set of checks performed when validating a server certificate. By default, %G_TLS_CERTIFICATE_VALIDATE_ALL is used. - @@ -24252,7 +23299,6 @@ overrides the default via #GDtlsConnection::accept-certificate. vtable for a #GDtlsClientConnection implementation. - The parent interface. @@ -24278,10 +23324,8 @@ on their base #GDatagramBased if it is a #GSocket — it is up to the calle do that if they wish. If they do not, and g_socket_close() is called on the base socket, the #GDtlsConnection will not raise a %G_IO_ERROR_NOT_CONNECTED error on further I/O. - - @@ -24298,7 +23342,6 @@ error on further I/O. - @@ -24324,7 +23367,6 @@ If the peer did not use the ALPN extension, or did not advertise a protocol that matched one of @conn's protocols, or the TLS backend does not support ALPN, then this will be %NULL. See g_dtls_connection_set_advertised_protocols(). - the negotiated protocol, or %NULL @@ -24363,7 +23405,6 @@ the initial handshake will no longer do anything. #GDtlsConnection::accept_certificate may be emitted during the handshake. - success or failure @@ -24382,7 +23423,6 @@ handshake. Asynchronously performs a TLS handshake on @conn. See g_dtls_connection_handshake() for more information. - @@ -24412,7 +23452,6 @@ g_dtls_connection_handshake() for more information. Finish an asynchronous TLS handshake operation. See g_dtls_connection_handshake() for more information. - %TRUE on success, %FALSE on failure, in which case @error will be set. @@ -24440,7 +23479,6 @@ of @protocols will disable ALPN negotiation. See [IANA TLS ALPN Protocol IDs](https://www.iana.org/assignments/tls-extensiontype-values/tls-extensiontype-values.xhtml#alpn-protocol-ids) for a list of registered protocol IDs. - @@ -24475,7 +23513,6 @@ is equivalent to calling g_dtls_connection_close(). If @cancellable is cancelled, the #GDtlsConnection may be left partially-closed and any pending untransmitted data may be lost. Call g_dtls_connection_shutdown() again to complete closing the #GDtlsConnection. - %TRUE on success, %FALSE otherwise @@ -24502,7 +23539,6 @@ g_dtls_connection_shutdown() again to complete closing the #GDtlsConnection. Asynchronously shut down part or all of the DTLS connection. See g_dtls_connection_shutdown() for more information. - @@ -24540,7 +23576,6 @@ g_dtls_connection_shutdown() for more information. Finish an asynchronous TLS shutdown operation. See g_dtls_connection_shutdown() for more information. - %TRUE on success, %FALSE on failure, in which case @error will be set @@ -24577,7 +23612,6 @@ released as early as possible. If @cancellable is cancelled, the #GDtlsConnection may be left partially-closed and any pending untransmitted data may be lost. Call g_dtls_connection_close() again to complete closing the #GDtlsConnection. - %TRUE on success, %FALSE otherwise @@ -24596,7 +23630,6 @@ g_dtls_connection_close() again to complete closing the #GDtlsConnection. Asynchronously close the DTLS connection. See g_dtls_connection_close() for more information. - @@ -24626,7 +23659,6 @@ more information. Finish an asynchronous TLS close operation. See g_dtls_connection_close() for more information. - %TRUE on success, %FALSE on failure, in which case @error will be set @@ -24646,7 +23678,6 @@ case @error will be set Used by #GDtlsConnection implementations to emit the #GDtlsConnection::accept-certificate signal. - %TRUE if one of the signal handlers has returned %TRUE to accept @peer_cert @@ -24670,7 +23701,6 @@ case @error will be set Gets @conn's certificate, as set by g_dtls_connection_set_certificate(). - @conn's certificate, or %NULL @@ -24696,7 +23726,6 @@ is supported by the TLS backend). It does not guarantee that the data will be available though. That could happen if TLS connection does not support @type or the binding data is not available yet due to additional negotiation or input required. - %TRUE on success, %FALSE otherwise @@ -24722,7 +23751,6 @@ negotiation or input required. Gets the certificate database that @conn uses to verify peer certificates. See g_dtls_connection_set_database(). - the certificate database that @conn uses or %NULL @@ -24738,7 +23766,6 @@ peer certificates. See g_dtls_connection_set_database(). Get the object that will be used to interact with the user. It will be used for things like prompting the user for passwords. If %NULL is returned, then no user interaction will occur for this connection. - The interaction object. @@ -24758,7 +23785,6 @@ If the peer did not use the ALPN extension, or did not advertise a protocol that matched one of @conn's protocols, or the TLS backend does not support ALPN, then this will be %NULL. See g_dtls_connection_set_advertised_protocols(). - the negotiated protocol, or %NULL @@ -24774,7 +23800,6 @@ g_dtls_connection_set_advertised_protocols(). Gets @conn's peer's certificate after the handshake has completed or failed. (It is not set during the emission of #GDtlsConnection::accept-certificate.) - @conn's peer's certificate, or %NULL @@ -24790,7 +23815,6 @@ or failed. (It is not set during the emission of Gets the errors associated with validating @conn's peer's certificate, after the handshake has completed or failed. (It is not set during the emission of #GDtlsConnection::accept-certificate.) - @conn's peer's certificate errors @@ -24808,7 +23832,6 @@ g_dtls_connection_set_rehandshake_mode() for details. Changing the rehandshake mode is no longer required for compatibility. Also, rehandshaking has been removed from the TLS protocol in TLS 1.3. - %G_TLS_REHANDSHAKE_SAFELY @@ -24824,7 +23847,6 @@ g_dtls_connection_set_rehandshake_mode() for details. Tests whether or not @conn expects a proper TLS close notification when the connection is closed. See g_dtls_connection_set_require_close_notify() for details. - %TRUE if @conn requires a proper TLS close notification. @@ -24863,7 +23885,6 @@ the initial handshake will no longer do anything. #GDtlsConnection::accept_certificate may be emitted during the handshake. - success or failure @@ -24882,7 +23903,6 @@ handshake. Asynchronously performs a TLS handshake on @conn. See g_dtls_connection_handshake() for more information. - @@ -24912,7 +23932,6 @@ g_dtls_connection_handshake() for more information. Finish an asynchronous TLS handshake operation. See g_dtls_connection_handshake() for more information. - %TRUE on success, %FALSE on failure, in which case @error will be set. @@ -24940,7 +23959,6 @@ of @protocols will disable ALPN negotiation. See [IANA TLS ALPN Protocol IDs](https://www.iana.org/assignments/tls-extensiontype-values/tls-extensiontype-values.xhtml#alpn-protocol-ids) for a list of registered protocol IDs. - @@ -24977,7 +23995,6 @@ or without a certificate; in that case, if you don't provide a certificate, you can tell that the server requested one by the fact that g_dtls_client_connection_get_accepted_cas() will return non-%NULL.) - @@ -25001,7 +24018,6 @@ peer certificate validation will always set the #GDtlsConnection::accept-certificate will always be emitted on client-side connections, unless that bit is not set in #GDtlsClientConnection:validation-flags). - @@ -25023,7 +24039,6 @@ for things like prompting the user for passwords. The @interaction argument will normally be a derived subclass of #GTlsInteraction. %NULL can also be provided if no user interaction should occur for this connection. - @@ -25046,7 +24061,6 @@ rekey operations. Changing the rehandshake mode is no longer required for compatibility. Also, rehandshaking has been removed from the TLS protocol in TLS 1.3. - @@ -25087,7 +24101,6 @@ connection; when the application calls g_dtls_connection_close_async() on setting of this property. If you explicitly want to do an unclean close, you can close @conn's #GDtlsConnection:base-socket rather than closing @conn itself. - @@ -25119,7 +24132,6 @@ is equivalent to calling g_dtls_connection_close(). If @cancellable is cancelled, the #GDtlsConnection may be left partially-closed and any pending untransmitted data may be lost. Call g_dtls_connection_shutdown() again to complete closing the #GDtlsConnection. - %TRUE on success, %FALSE otherwise @@ -25146,7 +24158,6 @@ g_dtls_connection_shutdown() again to complete closing the #GDtlsConnection. Asynchronously shut down part or all of the DTLS connection. See g_dtls_connection_shutdown() for more information. - @@ -25184,7 +24195,6 @@ g_dtls_connection_shutdown() for more information. Finish an asynchronous TLS shutdown operation. See g_dtls_connection_shutdown() for more information. - %TRUE on success, %FALSE on failure, in which case @error will be set @@ -25320,14 +24330,12 @@ no one else overrides it. Virtual method table for a #GDtlsConnection implementation. - The parent interface. - @@ -25346,7 +24354,6 @@ no one else overrides it. - success or failure @@ -25365,7 +24372,6 @@ no one else overrides it. - @@ -25395,7 +24401,6 @@ no one else overrides it. - %TRUE on success, %FALSE on failure, in which case @error will be set. @@ -25415,7 +24420,6 @@ case @error will be set. - %TRUE on success, %FALSE otherwise @@ -25442,7 +24446,6 @@ case @error will be set. - @@ -25480,7 +24483,6 @@ case @error will be set. - %TRUE on success, %FALSE on failure, in which case @error will be set @@ -25500,7 +24502,6 @@ case @error will be set - @@ -25521,7 +24522,6 @@ case @error will be set - the negotiated protocol, or %NULL @@ -25536,7 +24536,6 @@ case @error will be set - @@ -25559,12 +24558,10 @@ case @error will be set #GDtlsServerConnection is the server-side subclass of #GDtlsConnection, representing a server-side DTLS connection. - Creates a new #GDtlsServerConnection wrapping @base_socket. - the new #GDtlsServerConnection, or %NULL on error @@ -25590,49 +24587,42 @@ rehandshake with a different mode from the initial handshake. vtable for a #GDtlsServerConnection implementation. - The parent interface. - - - - - - @@ -25645,11 +24635,9 @@ It can than be added to a #GEmblemedIcon. Currently, only metainformation about the emblem's origin is supported. More may be added in the future. - Creates a new emblem for @icon. - a new #GEmblem. @@ -25663,7 +24651,6 @@ supported. More may be added in the future. Creates a new emblem for @icon. - a new #GEmblem. @@ -25681,7 +24668,6 @@ supported. More may be added in the future. Gives back the icon from @emblem. - a #GIcon. The returned object belongs to the emblem and should not be modified or freed. @@ -25696,7 +24682,6 @@ supported. More may be added in the future. Gets the origin of the emblem. - the origin of the emblem @@ -25715,9 +24700,7 @@ supported. More may be added in the future. - - - + GEmblemOrigin is used to add information about the origin of the emblem to #GEmblem. @@ -25741,11 +24724,9 @@ icon is ensured via g_emblemed_icon_add_emblem(). Note that #GEmblemedIcon allows no control over the position of the emblems. See also #GEmblem for more information. - Creates a new emblemed icon for @icon with the emblem @emblem. - a new #GIcon @@ -25763,7 +24744,6 @@ of the emblems. See also #GEmblem for more information. Adds @emblem to the #GList of #GEmblems. - @@ -25780,7 +24760,6 @@ of the emblems. See also #GEmblem for more information. Removes all the emblems from @icon. - @@ -25793,7 +24772,6 @@ of the emblems. See also #GEmblem for more information. Gets the list of emblems for the @icon. - a #GList of #GEmblems that is owned by @emblemed @@ -25810,7 +24788,6 @@ of the emblems. See also #GEmblem for more information. Gets the main icon for @emblemed. - a #GIcon that is owned by @emblemed @@ -25833,37 +24810,30 @@ of the emblems. See also #GEmblem for more information. - - - - + - - - - @@ -25873,28 +24843,24 @@ of the emblems. See also #GEmblem for more information. A key in the "access" namespace for checking deletion privileges. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN. This attribute will be %TRUE if the user is able to delete the file. - A key in the "access" namespace for getting execution privileges. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN. This attribute will be %TRUE if the user is able to execute the file. - A key in the "access" namespace for getting read privileges. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN. This attribute will be %TRUE if the user is able to read the file. - A key in the "access" namespace for checking renaming privileges. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN. This attribute will be %TRUE if the user is able to rename the file. - @@ -25902,14 +24868,12 @@ This attribute will be %TRUE if the user is able to rename the file. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN. This attribute will be %TRUE if the user is able to move the file to the trash. - A key in the "access" namespace for getting write privileges. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN. This attribute will be %TRUE if the user is able to write to the file. - @@ -25917,7 +24881,6 @@ This attribute will be %TRUE if the user is able to write to the file. is set. This attribute is %TRUE if the archive flag is set. This attribute is only available for DOS file systems. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN. - @@ -25927,7 +24890,6 @@ This attribute is %TRUE if file is a reparse point of type [IO_REPARSE_TAG_MOUNT_POINT](https://msdn.microsoft.com/en-us/library/dd541667.aspx). This attribute is only available for DOS file systems. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN. - @@ -25935,7 +24897,6 @@ Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN. is set. This attribute is %TRUE if the backup flag is set. This attribute is only available for DOS file systems. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN. - @@ -25944,55 +24905,47 @@ This value is 0 for files that are not reparse points. See the [Reparse Tags](https://msdn.microsoft.com/en-us/library/dd541667.aspx) page for possible reparse tag values. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32. - A key in the "etag" namespace for getting the value of the file's entity tag. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING. - A key in the "filesystem" namespace for getting the number of bytes of free space left on the file system. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT64. - A key in the "filesystem" namespace for checking if the file system is read only. Is set to %TRUE if the file system is read only. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN. - A key in the "filesystem" namespace for checking if the file system is remote. Is set to %TRUE if the file system is remote. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN. - A key in the "filesystem" namespace for getting the total size (in bytes) of the file system, used in g_file_query_filesystem_info(). Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT64. - A key in the "filesystem" namespace for getting the file system's type. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING. - A key in the "filesystem" namespace for getting the number of bytes of used on the file system. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT64. - @@ -26000,14 +24953,12 @@ file system. Corresponding #GFileAttributeType is application whether it should preview (e.g. thumbnail) files on the file system. The value for this key contain a #GFilesystemPreviewType. - A key in the "gvfs" namespace that gets the name of the current GVFS backend in use. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING. - @@ -26015,7 +24966,6 @@ GVFS backend in use. Corresponding #GFileAttributeType is Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING. An example use would be during listing files, to avoid recursive directory scanning. - @@ -26024,101 +24974,85 @@ Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING. An example use would be during drag and drop to see if the source and target are on the same filesystem (default to move) or not (default to copy). - A key in the "mountable" namespace for checking if a file (of type G_FILE_TYPE_MOUNTABLE) can be ejected. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN. - A key in the "mountable" namespace for checking if a file (of type G_FILE_TYPE_MOUNTABLE) is mountable. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN. - A key in the "mountable" namespace for checking if a file (of type G_FILE_TYPE_MOUNTABLE) can be polled. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN. - A key in the "mountable" namespace for checking if a file (of type G_FILE_TYPE_MOUNTABLE) can be started. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN. - A key in the "mountable" namespace for checking if a file (of type G_FILE_TYPE_MOUNTABLE) can be started degraded. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN. - A key in the "mountable" namespace for checking if a file (of type G_FILE_TYPE_MOUNTABLE) can be stopped. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN. - A key in the "mountable" namespace for checking if a file (of type G_FILE_TYPE_MOUNTABLE) is unmountable. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN. - A key in the "mountable" namespace for getting the HAL UDI for the mountable file. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING. - A key in the "mountable" namespace for checking if a file (of type G_FILE_TYPE_MOUNTABLE) is automatically polled for media. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN. - A key in the "mountable" namespace for getting the #GDriveStartStopType. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32. - A key in the "mountable" namespace for getting the unix device. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32. - A key in the "mountable" namespace for getting the unix device file. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING. - A key in the "owner" namespace for getting the file owner's group. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING. - A key in the "owner" namespace for getting the user name of the file's owner. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING. - A key in the "owner" namespace for getting the real name of the user that owns the file. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING. - @@ -26127,14 +25061,12 @@ used to get preview of the file. For example, it may be a low resolution thumbnail without metadata. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_OBJECT. The value for this key should contain a #GIcon. - A key in the "recent" namespace for getting time, when the metadata for the file in `recent:///` was last changed. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_INT64. - @@ -26142,7 +25074,6 @@ file in `recent:///` was last changed. Corresponding #GFileAttributeType is context. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING. Note that this attribute is only available if GLib has been built with SELinux support. - @@ -26151,14 +25082,12 @@ that is consumed by the file (in bytes). This will generally be larger than the file size (due to block size overhead) but can occasionally be smaller (for example, for sparse files). Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT64. - A key in the "standard" namespace for getting the content type of the file. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING. The value for this key should contain a valid content type. - @@ -26170,7 +25099,6 @@ might have a different encoding. If the filename is not a valid string in the encoding selected for the filesystem it is in then the copy name will not be set. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING. - @@ -26182,7 +25110,6 @@ for a file in the trash. This is useful for instance as the window title when displaying a directory or for a bookmarks menu. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING. - @@ -26190,7 +25117,6 @@ Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING. A display name is guaranteed to be in UTF-8 and can thus be displayed in the UI. It is guaranteed to be set on every file. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING. - @@ -26201,7 +25127,6 @@ might contain information you don't want in the new filename (such as "(invalid unicode)" if the filename was in an invalid encoding). Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING. - @@ -26210,26 +25135,22 @@ The fast content type isn't as reliable as the regular one, as it only uses the filename to guess it, but it is faster to calculate than the regular content type. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING. - A key in the "standard" namespace for getting the icon for the file. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_OBJECT. The value for this key should contain a #GIcon. - A key in the "standard" namespace for checking if a file is a backup file. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN. - A key in the "standard" namespace for checking if a file is hidden. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN. - @@ -26238,13 +25159,11 @@ Typically the actual type is something else, if we followed the symlink to get the type. On Windows NTFS mountpoints are considered to be symlinks as well. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN. - A key in the "standard" namespace for checking if a file is virtual. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN. - @@ -26254,7 +25173,6 @@ indicate that the URI is not persistent. Applications should look at #G_FILE_ATTRIBUTE_STANDARD_SYMLINK_TARGET for the persistent URI. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN. - @@ -26265,13 +25183,11 @@ every file. Use #G_FILE_ATTRIBUTE_STANDARD_DISPLAY_NAME if you need to display the name in a user interface. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BYTE_STRING. - A key in the "standard" namespace for getting the file's size (in bytes). Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT64. - @@ -26281,42 +25197,36 @@ An example use would be in file managers, which would use this key to set the order files are displayed. Files with smaller sort order should be sorted first, and files without sort order as if sort order was zero. - A key in the "standard" namespace for getting the symbolic icon for the file. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_OBJECT. The value for this key should contain a #GIcon. - A key in the "standard" namespace for getting the symlink target, if the file is a symlink. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BYTE_STRING. - A key in the "standard" namespace for getting the target URI for the file, in the case of %G_FILE_TYPE_SHORTCUT or %G_FILE_TYPE_MOUNTABLE files. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING. - A key in the "standard" namespace for storing file types. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32. The value for this key should contain a #GFileType. - A key in the "thumbnail" namespace for checking if thumbnailing failed. This attribute is %TRUE if thumbnailing failed. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN. - @@ -26328,14 +25238,12 @@ If %G_FILE_ATTRIBUTE_THUMBNAILING_FAILED is %TRUE and this attribute is %FALSE, it indicates that thumbnailing may be attempted again and may succeed. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN. - A key in the "thumbnail" namespace for getting the path to the thumbnail image. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BYTE_STRING. - @@ -26343,7 +25251,6 @@ image. Corresponding #GFileAttributeType is accessed. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT64, and contains the time since the file was last accessed, in seconds since the UNIX epoch. - @@ -26351,7 +25258,6 @@ file was last accessed, in seconds since the UNIX epoch. the file was last accessed. This should be used in conjunction with #G_FILE_ATTRIBUTE_TIME_ACCESS. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32. - @@ -26361,7 +25267,6 @@ and contains the time since the file was last changed, in seconds since the UNIX epoch. This corresponds to the traditional UNIX ctime. - @@ -26369,7 +25274,6 @@ This corresponds to the traditional UNIX ctime. the file was last changed. This should be used in conjunction with #G_FILE_ATTRIBUTE_TIME_CHANGED. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32. - @@ -26380,7 +25284,6 @@ epoch. This may correspond to Linux stx_btime, FreeBSD st_birthtim, NetBSD st_birthtime or NTFS ctime. - @@ -26388,7 +25291,6 @@ st_birthtime or NTFS ctime. the file was created. This should be used in conjunction with #G_FILE_ATTRIBUTE_TIME_CREATED. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32. - @@ -26396,7 +25298,6 @@ the file was created. This should be used in conjunction with modified. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT64, and contains the time since the file was modified, in seconds since the UNIX epoch. - @@ -26404,7 +25305,6 @@ file was modified, in seconds since the UNIX epoch. the file was last modified. This should be used in conjunction with #G_FILE_ATTRIBUTE_TIME_MODIFIED. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32. - @@ -26412,14 +25312,12 @@ the file was last modified. This should be used in conjunction with items in `trash:///`, will return the date and time when the file was trashed. The format of the returned string is YYYY-MM-DDThh:mm:ss. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING. - A key in the "trash" namespace. When requested against `trash:///` returns the number of (toplevel) items in the trash folder. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32. - @@ -26427,21 +25325,18 @@ Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32. items in `trash:///`, will return the original path to the file before it was trashed. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BYTE_STRING. - A key in the "unix" namespace for getting the number of blocks allocated for the file. This attribute is only available for UNIX file systems. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT64. - A key in the "unix" namespace for getting the block size for the file system. This attribute is only available for UNIX file systems. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32. - @@ -26449,21 +25344,18 @@ Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32. file is located on (see stat() documentation). This attribute is only available for UNIX file systems. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32. - A key in the "unix" namespace for getting the group ID for the file. This attribute is only available for UNIX file systems. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32. - A key in the "unix" namespace for getting the inode of the file. This attribute is only available for UNIX file systems. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT64. - @@ -26472,7 +25364,6 @@ UNIX mount point. This attribute is %TRUE if the file is a UNIX mount point. Since 2.58, `/` is considered to be a mount point. This attribute is only available for UNIX file systems. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN. - @@ -26482,7 +25373,6 @@ documentation for `lstat()`: this attribute is equivalent to the `st_mode` member of `struct stat`, and includes both the file type and permissions. This attribute is only available for UNIX file systems. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32. - @@ -26490,7 +25380,6 @@ Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32. for a file. See lstat() documentation. This attribute is only available for UNIX file systems. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32. - @@ -26498,221 +25387,189 @@ for UNIX file systems. Corresponding #GFileAttributeType is (if it is a special file). See lstat() documentation. This attribute is only available for UNIX file systems. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32. - A key in the "unix" namespace for getting the user ID for the file. This attribute is only available for UNIX file systems. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - @@ -26800,14 +25657,12 @@ has been modified from the version on the file system. See the HTTP 1.1 [specification](http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html) for HTTP Etag headers, which are a very similar concept. - Constructs a #GFile from a series of elements using the correct separator for filenames. Using this function is equivalent to calling g_build_filename(), followed by g_file_new_for_path() on the result. - a new #GFile @@ -26838,7 +25693,6 @@ the commandline. #GApplication also uses UTF-8 but g_application_command_line_create_file_for_arg() may be more useful for you there. It is also always possible to use this function with #GOptionContext arguments of type %G_OPTION_ARG_FILENAME. - a new #GFile. Free the returned object with g_object_unref(). @@ -26863,7 +25717,6 @@ This is useful if the commandline argument was given in a context other than the invocation of the current process. See also g_application_command_line_create_file_for_arg(). - a new #GFile @@ -26883,7 +25736,6 @@ See also g_application_command_line_create_file_for_arg(). Constructs a #GFile for a given path. This operation never fails, but the returned object might not support any I/O operation if @path is malformed. - a new #GFile for the given @path. Free the returned object with g_object_unref(). @@ -26902,7 +25754,6 @@ operation if @path is malformed. fails, but the returned object might not support any I/O operation if @uri is malformed or if the uri type is not supported. - a new #GFile for the given @uri. Free the returned object with g_object_unref(). @@ -26926,7 +25777,6 @@ directory components. If it is %NULL, a default template is used. Unlike the other #GFile constructors, this will return %NULL if a temporary file could not be created. - a new #GFile. Free the returned object with g_object_unref(). @@ -26949,7 +25799,6 @@ a temporary file could not be created. given by g_file_get_parse_name()). This operation never fails, but the returned object might not support any I/O operation if the @parse_name cannot be parsed. - a new #GFile. @@ -26979,7 +25828,6 @@ Some file systems don't allow all file names, and may return an %G_IO_ERROR_INVALID_FILENAME error. If the file is a directory the %G_IO_ERROR_IS_DIRECTORY error will be returned. Other errors are possible too, and depend on what kind of filesystem the file is on. - a #GFileOutputStream, or %NULL on error. Free the returned object with g_object_unref(). @@ -27010,7 +25858,6 @@ the synchronous version of this call. When the operation is finished, @callback will be called. You can then call g_file_append_to_finish() to get the result of the operation. - @@ -27046,7 +25893,6 @@ of the operation. Finishes an asynchronous file append operation started with g_file_append_to_async(). - a valid #GFileOutputStream or %NULL on error. @@ -27105,7 +25951,6 @@ If the source is a directory and the target does not exist, or If you are interested in copying the #GFile object itself (not the on-disk file), see g_file_dup(). - %TRUE on success, %FALSE otherwise. @@ -27150,7 +25995,6 @@ run in. When the operation is finished, @callback will be called. You can then call g_file_copy_finish() to get the result of the operation. - @@ -27197,7 +26041,6 @@ g_file_copy_finish() to get the result of the operation. Finishes copying the file started with g_file_copy_async(). - a %TRUE on success, %FALSE on error. @@ -27233,7 +26076,6 @@ allow all file names, and may return an %G_IO_ERROR_INVALID_FILENAME error, and if the name is to long %G_IO_ERROR_FILENAME_TOO_LONG will be returned. Other errors are possible too, and depend on what kind of filesystem the file is on. - a #GFileOutputStream for the newly created file, or %NULL on error. @@ -27266,7 +26108,6 @@ the synchronous version of this call. When the operation is finished, @callback will be called. You can then call g_file_create_finish() to get the result of the operation. - @@ -27302,7 +26143,6 @@ of the operation. Finishes an asynchronous file create operation started with g_file_create_async(). - a #GFileOutputStream or %NULL on error. Free the returned object with g_object_unref(). @@ -27343,7 +26183,6 @@ kind of filesystem the file is on. Note that in many non-local file cases read and write streams are not supported, so make sure you really need to do read and write streaming, rather than just opening for reading or writing. - a #GFileIOStream for the newly created file, or %NULL on error. @@ -27376,7 +26215,6 @@ the synchronous version of this call. When the operation is finished, @callback will be called. You can then call g_file_create_readwrite_finish() to get the result of the operation. - @@ -27412,7 +26250,6 @@ the result of the operation. Finishes an asynchronous file create operation started with g_file_create_readwrite_async(). - a #GFileIOStream or %NULL on error. Free the returned object with g_object_unref(). @@ -27451,7 +26288,6 @@ if (!g_file_delete (my_file, my_cancellable, &local_error) && If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. - %TRUE if the file was deleted. %FALSE otherwise. @@ -27472,7 +26308,6 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. Asynchronously delete a file. If the @file is a directory, it will only be deleted if it is empty. This has the same semantics as g_unlink(). - @@ -27503,7 +26338,6 @@ g_unlink(). Finishes deleting a file started with g_file_delete_async(). - %TRUE if the file was deleted. %FALSE otherwise. @@ -27530,7 +26364,6 @@ within the same thread, use g_object_ref() to increment the existing object reference count. This call does no blocking I/O. - a new #GFile that is a duplicate of the given #GFile. @@ -27553,7 +26386,6 @@ If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. Use g_file_eject_mountable_with_operation() instead. - @@ -27587,7 +26419,6 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. g_file_eject_mountable(). Use g_file_eject_mountable_with_operation_finish() instead. - %TRUE if the @file was ejected successfully. %FALSE otherwise. @@ -27613,7 +26444,6 @@ g_file_eject_mountable_with_operation_finish(). If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. - @@ -27650,7 +26480,6 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. Finishes an asynchronous eject operation started by g_file_eject_mountable_with_operation(). - %TRUE if the @file was ejected successfully. %FALSE otherwise. @@ -27691,7 +26520,6 @@ returned. If the file does not exist, the %G_IO_ERROR_NOT_FOUND error will be returned. If the file is not a directory, the %G_IO_ERROR_NOT_DIRECTORY error will be returned. Other errors are possible too. - A #GFileEnumerator if successful, %NULL on error. Free the returned object with g_object_unref(). @@ -27728,7 +26556,6 @@ the synchronous version of this call. When the operation is finished, @callback will be called. You can then call g_file_enumerate_children_finish() to get the result of the operation. - @@ -27768,7 +26595,6 @@ the operation. Finishes an async enumerate children operation. See g_file_enumerate_children_async(). - a #GFileEnumerator or %NULL if an error occurred. @@ -27794,7 +26620,6 @@ file on the filesystem due to various forms of filename aliasing. This call does no blocking I/O. - %TRUE if @file1 and @file2 are equal. @@ -27820,7 +26645,6 @@ This call does no blocking I/O. If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. - a #GMount where the @file is located or %NULL on error. @@ -27848,7 +26672,6 @@ the synchronous version of this call. When the operation is finished, @callback will be called. You can then call g_file_find_enclosing_mount_finish() to get the result of the operation. - @@ -27880,7 +26703,6 @@ get the result of the operation. Finishes an asynchronous find mount request. See g_file_find_enclosing_mount_async(). - #GMount for given @file or %NULL on error. Free the returned object with g_object_unref(). @@ -27897,13 +26719,29 @@ See g_file_find_enclosing_mount_async(). - - - - + + Gets the base name (the last component of the path) for a given #GFile. + +If called for the top level of a system (such as the filesystem root +or a uri like sftp://host/) it will return a single directory separator +(and on Windows, possibly a drive letter). + +The base name is a byte string (not UTF-8). It has no defined encoding +or rules other than it may not contain zero bytes. If you want to use +filenames in a user interface you should use the display name that you +can get by requesting the %G_FILE_ATTRIBUTE_STANDARD_DISPLAY_NAME +attribute with g_file_query_info(). + +This call does no blocking I/O. + + string containing the #GFile's + base name, or %NULL if given #GFile is invalid. The returned string + should be freed with g_free() when no longer needed. + + input #GFile @@ -27917,7 +26755,6 @@ user interface, for instance when you select a directory and type a filename in the file selector. This call does no blocking I/O. - a #GFile to the specified child, or %NULL if the display name couldn't be converted. @@ -27941,7 +26778,6 @@ If the @file represents the root directory of the file system, then %NULL will be returned. This call does no blocking I/O. - a #GFile structure to the parent of the given #GFile or %NULL if there is no parent. Free @@ -27970,7 +26806,6 @@ to UTF-8 the pathname is used, otherwise the IRI is used (a form of URI that allows UTF-8 characters unescaped). This call does no blocking I/O. - a string containing the #GFile's parse name. The returned string should be freed with g_free() @@ -27984,27 +26819,42 @@ This call does no blocking I/O. - - - - + + Gets the local pathname for #GFile, if one exists. If non-%NULL, this is +guaranteed to be an absolute, canonical path. It might contain symlinks. + +This call does no blocking I/O. + + string containing the #GFile's path, + or %NULL if no such path exists. The returned string should be freed + with g_free() when no longer needed. + + input #GFile - - - - + + Gets the path for @descendant relative to @parent. + +This call does no blocking I/O. + + string with the relative path from + @descendant to @parent, or %NULL if @descendant doesn't have @parent as + prefix. The returned string should be freed with g_free() when + no longer needed. + + input #GFile + input #GFile @@ -28013,9 +26863,9 @@ This call does no blocking I/O. Gets the URI for the @file. This call does no blocking I/O. - - a string containing the #GFile's URI. + a string containing the #GFile's URI. If the #GFile was constructed + with an invalid URI, an invalid URI is returned. The returned string should be freed with g_free() when no longer needed. @@ -28035,12 +26885,14 @@ URI = scheme ":" hier-part [ "?" query ] [ "#" fragment ] ]| Common schemes include "file", "http", "ftp", etc. +The scheme can be different from the one used to construct the #GFile, +in that it might be replaced with one that is logically equivalent to the #GFile. + This call does no blocking I/O. - - + a string containing the URI scheme for the given - #GFile. The returned string should be freed with g_free() - when no longer needed. + #GFile or %NULL if the #GFile was constructed with an invalid URI. The + returned string should be freed with g_free() when no longer needed. @@ -28054,7 +26906,6 @@ This call does no blocking I/O. Checks to see if a #GFile has a given URI scheme. This call does no blocking I/O. - %TRUE if #GFile's backend supports the given URI scheme, %FALSE if URI scheme is %NULL, @@ -28076,7 +26927,6 @@ This call does no blocking I/O. Creates a hash value for a #GFile. This call does no blocking I/O. - 0 if @file is not a valid #GFile, otherwise an integer that can be used as hash value for the #GFile. @@ -28103,7 +26953,6 @@ filesystem via a userspace filesystem (FUSE), in these cases this call will return %FALSE, but g_file_get_path() will still return a native path. This call does no blocking I/O. - %TRUE if @file is native @@ -28130,7 +26979,6 @@ For a local #GFile the newly created directory will have the default If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. - %TRUE on successful creation, %FALSE otherwise. @@ -28149,7 +26997,6 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. Asynchronously creates a directory. - @@ -28181,7 +27028,6 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. Finishes an asynchronous directory creation, started with g_file_make_directory_async(). - %TRUE on successful directory creation, %FALSE otherwise. @@ -28204,7 +27050,6 @@ g_file_make_directory_async(). If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. - %TRUE on the creation of a new symlink, %FALSE otherwise. @@ -28245,7 +27090,6 @@ in a user interface. periodic progress updates while scanning. See the documentation for #GFileMeasureProgressCallback for information about when and how the callback will be invoked. - %TRUE if successful, with the out parameters set. %FALSE otherwise, with @error set. @@ -28291,7 +27135,6 @@ callback will be invoked. This is the asynchronous version of g_file_measure_disk_usage(). See there for more information. - @@ -28334,7 +27177,6 @@ there for more information. Collects the results from an earlier call to g_file_measure_disk_usage_async(). See g_file_measure_disk_usage() for more information. - %TRUE if successful, with the out parameters set. %FALSE otherwise, with @error set. @@ -28376,7 +27218,6 @@ It does not make sense for @flags to contain directories. It is not possible to monitor all the files in a directory for changes made via hard links; if you want to do this then you must register individual watches with g_file_monitor(). - a #GFileMonitor for the given @file, or %NULL on error. @@ -28414,7 +27255,6 @@ changes made through the filename contained in @file to be reported. Using this flag may result in an increase in resource usage, and may not have any effect depending on the #GFileMonitor backend and/or filesystem type. - a #GFileMonitor for the given @file, or %NULL on error. @@ -28448,7 +27288,6 @@ g_file_mount_enclosing_volume_finish(). If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. - @@ -28484,7 +27323,6 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. Finishes a mount operation started by g_file_mount_enclosing_volume(). - %TRUE if successful. If an error has occurred, this function will return %FALSE and set @error @@ -28514,7 +27352,6 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. When the operation is finished, @callback will be called. You can then call g_file_mount_mountable_finish() to get the result of the operation. - @@ -28553,7 +27390,6 @@ the result of the operation. Finish an asynchronous mount operation that was started with g_file_mount_mountable(). - a #GFile or %NULL on error. Free the returned object with g_object_unref(). @@ -28604,7 +27440,6 @@ If the source is a directory and the target does not exist, or #G_FILE_COPY_OVERWRITE is specified and the target is a file, then the %G_IO_ERROR_WOULD_RECURSE error may be returned (if the native move operation isn't available). - %TRUE on successful move, %FALSE otherwise. @@ -28656,7 +27491,6 @@ what kind of filesystem the file is on. Note that in many non-local file cases read and write streams are not supported, so make sure you really need to do read and write streaming, rather than just opening for reading or writing. - #GFileIOStream or %NULL on error. Free the returned object with g_object_unref(). @@ -28682,7 +27516,6 @@ the synchronous version of this call. When the operation is finished, @callback will be called. You can then call g_file_open_readwrite_finish() to get the result of the operation. - @@ -28714,7 +27547,6 @@ the result of the operation. Finishes an asynchronous file read operation started with g_file_open_readwrite_async(). - a #GFileIOStream or %NULL on error. Free the returned object with g_object_unref(). @@ -28741,7 +27573,6 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. When the operation is finished, @callback will be called. You can then call g_file_mount_mountable_finish() to get the result of the operation. - @@ -28770,7 +27601,6 @@ the result of the operation. Finish an asynchronous poll operation that was polled with g_file_poll_mountable(). - %TRUE if the operation finished successfully. %FALSE otherwise. @@ -28802,7 +27632,6 @@ This call does no I/O, as it works purely on names. As such it can sometimes return %FALSE even if @file is inside a @prefix (from a filesystem point of view), because the prefix of @file is an alias of @prefix. - %TRUE if the @file's parent, grandparent, etc is @prefix, %FALSE otherwise. @@ -28845,7 +27674,6 @@ returned. If the file does not exist, the %G_IO_ERROR_NOT_FOUND error will be returned. Other errors are possible too, and depend on what kind of filesystem the file is on. - a #GFileInfo or %NULL if there was an error. Free the returned object with g_object_unref(). @@ -28879,7 +27707,6 @@ synchronous version of this call. When the operation is finished, @callback will be called. You can then call g_file_query_info_finish() to get the result of the operation. - @@ -28915,7 +27742,6 @@ operation. Finishes an asynchronous filesystem info query. See g_file_query_filesystem_info_async(). - #GFileInfo for given @file or %NULL on error. @@ -28964,7 +27790,6 @@ about the symlink itself will be returned. If the file does not exist, the %G_IO_ERROR_NOT_FOUND error will be returned. Other errors are possible too, and depend on what kind of filesystem the file is on. - a #GFileInfo for the given @file, or %NULL on error. Free the returned object with g_object_unref(). @@ -29000,7 +27825,6 @@ version of this call. When the operation is finished, @callback will be called. You can then call g_file_query_info_finish() to get the result of the operation. - @@ -29040,7 +27864,6 @@ then call g_file_query_info_finish() to get the result of the operation. Finishes an asynchronous file info query. See g_file_query_info_async(). - #GFileInfo for given @file or %NULL on error. Free the returned object with @@ -29069,7 +27892,6 @@ specific file may not support a specific attribute. If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. - a #GFileAttributeInfoList describing the settable attributes. When you are done with it, release it with @@ -29096,7 +27918,6 @@ attributes (in the "xattr" namespace). If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. - a #GFileAttributeInfoList describing the writable namespaces. When you are done with it, release it with @@ -29124,7 +27945,6 @@ the synchronous version of this call. When the operation is finished, @callback will be called. You can then call g_file_read_finish() to get the result of the operation. - @@ -29156,7 +27976,6 @@ of the operation. Finishes an asynchronous file read operation started with g_file_read_async(). - a #GFileInputStream or %NULL on error. Free the returned object with g_object_unref(). @@ -29185,7 +28004,6 @@ If the file does not exist, the %G_IO_ERROR_NOT_FOUND error will be returned. If the file is a directory, the %G_IO_ERROR_IS_DIRECTORY error will be returned. Other errors are possible too, and depend on what kind of filesystem the file is on. - #GFileInputStream or %NULL on error. Free the returned object with g_object_unref(). @@ -29244,7 +28062,6 @@ file systems don't allow all file names, and may return an %G_IO_ERROR_INVALID_FILENAME error, and if the name is to long %G_IO_ERROR_FILENAME_TOO_LONG will be returned. Other errors are possible too, and depend on what kind of filesystem the file is on. - a #GFileOutputStream or %NULL on error. Free the returned object with g_object_unref(). @@ -29285,7 +28102,6 @@ the synchronous version of this call. When the operation is finished, @callback will be called. You can then call g_file_replace_finish() to get the result of the operation. - @@ -29330,7 +28146,6 @@ of the operation. Finishes an asynchronous file replace operation started with g_file_replace_async(). - a #GFileOutputStream, or %NULL on error. Free the returned object with g_object_unref(). @@ -29358,7 +28173,6 @@ same thing but returns an output stream only. Note that in many non-local file cases read and write streams are not supported, so make sure you really need to do read and write streaming, rather than just opening for reading or writing. - a #GFileIOStream or %NULL on error. Free the returned object with g_object_unref(). @@ -29400,7 +28214,6 @@ the synchronous version of this call. When the operation is finished, @callback will be called. You can then call g_file_replace_readwrite_finish() to get the result of the operation. - @@ -29445,7 +28258,6 @@ the result of the operation. Finishes an asynchronous file replace operation started with g_file_replace_readwrite_async(). - a #GFileIOStream, or %NULL on error. Free the returned object with g_object_unref(). @@ -29466,7 +28278,6 @@ g_file_replace_readwrite_async(). Resolves a relative path for @file to an absolute path. This call does no blocking I/O. - #GFile to the resolved path. %NULL if @relative_path is %NULL or if @file is invalid. @@ -29493,7 +28304,6 @@ Some attributes can be unset by setting @type to If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. - %TRUE if the attribute was set, %FALSE otherwise. @@ -29536,7 +28346,6 @@ which is the synchronous version of this call. When the operation is finished, @callback will be called. You can then call g_file_set_attributes_finish() to get the result of the operation. - @@ -29574,7 +28383,6 @@ the result of the operation. Finishes setting an attribute started in g_file_set_attributes_async(). - %TRUE if the attributes were set correctly, %FALSE otherwise. @@ -29607,7 +28415,6 @@ also detect further errors. If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. - %FALSE if there was any error, %TRUE otherwise. @@ -29648,7 +28455,6 @@ On success the resulting converted filename is returned. If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. - a #GFile specifying what @file was renamed to, or %NULL if there was an error. @@ -29680,7 +28486,6 @@ the synchronous version of this call. When the operation is finished, @callback will be called. You can then call g_file_set_display_name_finish() to get the result of the operation. - @@ -29716,7 +28521,6 @@ the result of the operation. Finishes setting a display name started with g_file_set_display_name_async(). - a #GFile or %NULL on error. Free the returned object with g_object_unref(). @@ -29745,7 +28549,6 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. When the operation is finished, @callback will be called. You can then call g_file_mount_mountable_finish() to get the result of the operation. - @@ -29781,7 +28584,6 @@ the result of the operation. Finish an asynchronous start operation that was started with g_file_start_mountable(). - %TRUE if the operation finished successfully. %FALSE otherwise. @@ -29808,7 +28610,6 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. When the operation is finished, @callback will be called. You can then call g_file_stop_mountable_finish() to get the result of the operation. - @@ -29847,7 +28648,6 @@ the result of the operation. Finish an asynchronous stop operation that was started with g_file_stop_mountable(). - %TRUE if the operation finished successfully. %FALSE otherwise. @@ -29875,7 +28675,6 @@ mounts, the %G_IO_ERROR_NOT_SUPPORTED error will be returned in that case. If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. - %TRUE on successful trash, %FALSE otherwise. @@ -29894,7 +28693,6 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. Asynchronously sends @file to the Trash location, if possible. - @@ -29926,7 +28724,6 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. Finishes an asynchronous file trashing operation, started with g_file_trash_async(). - %TRUE on successful trash, %FALSE otherwise. @@ -29953,7 +28750,6 @@ When the operation is finished, @callback will be called. You can then call g_file_unmount_mountable_finish() to get the result of the operation. Use g_file_unmount_mountable_with_operation() instead. - @@ -29989,7 +28785,6 @@ Finish an asynchronous unmount operation that was started with g_file_unmount_mountable(). Use g_file_unmount_mountable_with_operation_finish() instead. - %TRUE if the operation finished successfully. %FALSE otherwise. @@ -30016,7 +28811,6 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. When the operation is finished, @callback will be called. You can then call g_file_unmount_mountable_finish() to get the result of the operation. - @@ -30056,7 +28850,6 @@ see g_file_unmount_mountable_with_operation() for details. Finish an asynchronous unmount operation that was started with g_file_unmount_mountable_with_operation(). - %TRUE if the operation finished successfully. %FALSE otherwise. @@ -30091,7 +28884,6 @@ Some file systems don't allow all file names, and may return an %G_IO_ERROR_INVALID_FILENAME error. If the file is a directory the %G_IO_ERROR_IS_DIRECTORY error will be returned. Other errors are possible too, and depend on what kind of filesystem the file is on. - a #GFileOutputStream, or %NULL on error. Free the returned object with g_object_unref(). @@ -30122,7 +28914,6 @@ the synchronous version of this call. When the operation is finished, @callback will be called. You can then call g_file_append_to_finish() to get the result of the operation. - @@ -30158,7 +28949,6 @@ of the operation. Finishes an asynchronous file append operation started with g_file_append_to_async(). - a valid #GFileOutputStream or %NULL on error. @@ -30217,7 +29007,6 @@ If the source is a directory and the target does not exist, or If you are interested in copying the #GFile object itself (not the on-disk file), see g_file_dup(). - %TRUE on success, %FALSE otherwise. @@ -30262,7 +29051,6 @@ run in. When the operation is finished, @callback will be called. You can then call g_file_copy_finish() to get the result of the operation. - @@ -30316,7 +29104,6 @@ those that are copies in a normal file copy operation if #G_FILE_COPY_ALL_METADATA is specified in @flags, then all the metadata that is possible to copy is copied. This is useful when implementing move by copy + delete source. - %TRUE if the attributes were copied successfully, %FALSE otherwise. @@ -30344,7 +29131,6 @@ is useful when implementing move by copy + delete source. Finishes copying the file started with g_file_copy_async(). - a %TRUE on success, %FALSE on error. @@ -30380,7 +29166,6 @@ allow all file names, and may return an %G_IO_ERROR_INVALID_FILENAME error, and if the name is to long %G_IO_ERROR_FILENAME_TOO_LONG will be returned. Other errors are possible too, and depend on what kind of filesystem the file is on. - a #GFileOutputStream for the newly created file, or %NULL on error. @@ -30413,7 +29198,6 @@ the synchronous version of this call. When the operation is finished, @callback will be called. You can then call g_file_create_finish() to get the result of the operation. - @@ -30449,7 +29233,6 @@ of the operation. Finishes an asynchronous file create operation started with g_file_create_async(). - a #GFileOutputStream or %NULL on error. Free the returned object with g_object_unref(). @@ -30490,7 +29273,6 @@ kind of filesystem the file is on. Note that in many non-local file cases read and write streams are not supported, so make sure you really need to do read and write streaming, rather than just opening for reading or writing. - a #GFileIOStream for the newly created file, or %NULL on error. @@ -30523,7 +29305,6 @@ the synchronous version of this call. When the operation is finished, @callback will be called. You can then call g_file_create_readwrite_finish() to get the result of the operation. - @@ -30559,7 +29340,6 @@ the result of the operation. Finishes an asynchronous file create operation started with g_file_create_readwrite_async(). - a #GFileIOStream or %NULL on error. Free the returned object with g_object_unref(). @@ -30598,7 +29378,6 @@ if (!g_file_delete (my_file, my_cancellable, &local_error) && If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. - %TRUE if the file was deleted. %FALSE otherwise. @@ -30619,7 +29398,6 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. Asynchronously delete a file. If the @file is a directory, it will only be deleted if it is empty. This has the same semantics as g_unlink(). - @@ -30650,7 +29428,6 @@ g_unlink(). Finishes deleting a file started with g_file_delete_async(). - %TRUE if the file was deleted. %FALSE otherwise. @@ -30677,7 +29454,6 @@ within the same thread, use g_object_ref() to increment the existing object reference count. This call does no blocking I/O. - a new #GFile that is a duplicate of the given #GFile. @@ -30700,7 +29476,6 @@ If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. Use g_file_eject_mountable_with_operation() instead. - @@ -30734,7 +29509,6 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. g_file_eject_mountable(). Use g_file_eject_mountable_with_operation_finish() instead. - %TRUE if the @file was ejected successfully. %FALSE otherwise. @@ -30760,7 +29534,6 @@ g_file_eject_mountable_with_operation_finish(). If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. - @@ -30797,7 +29570,6 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. Finishes an asynchronous eject operation started by g_file_eject_mountable_with_operation(). - %TRUE if the @file was ejected successfully. %FALSE otherwise. @@ -30838,7 +29610,6 @@ returned. If the file does not exist, the %G_IO_ERROR_NOT_FOUND error will be returned. If the file is not a directory, the %G_IO_ERROR_NOT_DIRECTORY error will be returned. Other errors are possible too. - A #GFileEnumerator if successful, %NULL on error. Free the returned object with g_object_unref(). @@ -30875,7 +29646,6 @@ the synchronous version of this call. When the operation is finished, @callback will be called. You can then call g_file_enumerate_children_finish() to get the result of the operation. - @@ -30915,7 +29685,6 @@ the operation. Finishes an async enumerate children operation. See g_file_enumerate_children_async(). - a #GFileEnumerator or %NULL if an error occurred. @@ -30941,7 +29710,6 @@ file on the filesystem due to various forms of filename aliasing. This call does no blocking I/O. - %TRUE if @file1 and @file2 are equal. @@ -30967,7 +29735,6 @@ This call does no blocking I/O. If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. - a #GMount where the @file is located or %NULL on error. @@ -30995,7 +29762,6 @@ the synchronous version of this call. When the operation is finished, @callback will be called. You can then call g_file_find_enclosing_mount_finish() to get the result of the operation. - @@ -31027,7 +29793,6 @@ get the result of the operation. Finishes an asynchronous find mount request. See g_file_find_enclosing_mount_async(). - #GMount for given @file or %NULL on error. Free the returned object with g_object_unref(). @@ -31058,7 +29823,6 @@ can get by requesting the %G_FILE_ATTRIBUTE_STANDARD_DISPLAY_NAME attribute with g_file_query_info(). This call does no blocking I/O. - string containing the #GFile's base name, or %NULL if given #GFile is invalid. The returned string @@ -31080,7 +29844,6 @@ you can still have a #GFile that points to it. You can use this for instance to create that file. This call does no blocking I/O. - a #GFile to a child specified by @name. Free the returned object with g_object_unref(). @@ -31106,7 +29869,6 @@ user interface, for instance when you select a directory and type a filename in the file selector. This call does no blocking I/O. - a #GFile to the specified child, or %NULL if the display name couldn't be converted. @@ -31130,7 +29892,6 @@ If the @file represents the root directory of the file system, then %NULL will be returned. This call does no blocking I/O. - a #GFile structure to the parent of the given #GFile or %NULL if there is no parent. Free @@ -31159,7 +29920,6 @@ to UTF-8 the pathname is used, otherwise the IRI is used (a form of URI that allows UTF-8 characters unescaped). This call does no blocking I/O. - a string containing the #GFile's parse name. The returned string should be freed with g_free() @@ -31178,7 +29938,6 @@ This call does no blocking I/O. guaranteed to be an absolute, canonical path. It might contain symlinks. This call does no blocking I/O. - string containing the #GFile's path, or %NULL if no such path exists. The returned string should be freed @@ -31196,7 +29955,6 @@ This call does no blocking I/O. Gets the path for @descendant relative to @parent. This call does no blocking I/O. - string with the relative path from @descendant to @parent, or %NULL if @descendant doesn't have @parent as @@ -31219,9 +29977,9 @@ This call does no blocking I/O. Gets the URI for the @file. This call does no blocking I/O. - - a string containing the #GFile's URI. + a string containing the #GFile's URI. If the #GFile was constructed + with an invalid URI, an invalid URI is returned. The returned string should be freed with g_free() when no longer needed. @@ -31241,12 +29999,14 @@ URI = scheme ":" hier-part [ "?" query ] [ "#" fragment ] ]| Common schemes include "file", "http", "ftp", etc. +The scheme can be different from the one used to construct the #GFile, +in that it might be replaced with one that is logically equivalent to the #GFile. + This call does no blocking I/O. - - + a string containing the URI scheme for the given - #GFile. The returned string should be freed with g_free() - when no longer needed. + #GFile or %NULL if the #GFile was constructed with an invalid URI. The + returned string should be freed with g_free() when no longer needed. @@ -31262,7 +30022,6 @@ This call does no blocking I/O. If @parent is %NULL then this function returns %TRUE if @file has any parent at all. If @parent is non-%NULL then %TRUE is only returned if @file is an immediate child of @parent. - %TRUE if @file is an immediate child of @parent (or any parent in the case that @parent is %NULL). @@ -31294,7 +30053,6 @@ This call does no I/O, as it works purely on names. As such it can sometimes return %FALSE even if @file is inside a @prefix (from a filesystem point of view), because the prefix of @file is an alias of @prefix. - %TRUE if the @file's parent, grandparent, etc is @prefix, %FALSE otherwise. @@ -31315,7 +30073,6 @@ of @prefix. Checks to see if a #GFile has a given URI scheme. This call does no blocking I/O. - %TRUE if #GFile's backend supports the given URI scheme, %FALSE if URI scheme is %NULL, @@ -31337,7 +30094,6 @@ This call does no blocking I/O. Creates a hash value for a #GFile. This call does no blocking I/O. - 0 if @file is not a valid #GFile, otherwise an integer that can be used as hash value for the #GFile. @@ -31364,7 +30120,6 @@ filesystem via a userspace filesystem (FUSE), in these cases this call will return %FALSE, but g_file_get_path() will still return a native path. This call does no blocking I/O. - %TRUE if @file is native @@ -31388,7 +30143,6 @@ For resources, @etag_out will be set to %NULL. The data contained in the resulting #GBytes is always zero-terminated, but this is not included in the #GBytes length. The resulting #GBytes should be freed with g_bytes_unref() when no longer in use. - a #GBytes or %NULL and @error is set @@ -31420,7 +30174,6 @@ g_file_load_contents_async() and g_bytes_new_take(). asynchronous operation. See g_file_load_bytes() for more information. - @@ -31454,7 +30207,6 @@ this is not included in the #GBytes length. The resulting #GBytes should be freed with g_bytes_unref() when no longer in use. See g_file_load_bytes() for more information. - a #GBytes or %NULL and @error is set @@ -31484,7 +30236,6 @@ needed. If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. - %TRUE if the @file's contents were successfully loaded. %FALSE if there were errors. @@ -31510,7 +30261,7 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. or %NULL if the length is not needed - + a location to place the current entity tag for the file, or %NULL if the entity tag is not needed @@ -31531,7 +30282,6 @@ the @callback. If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. - @@ -31560,7 +30310,6 @@ The contents are placed in @contents, and @length is set to the size of the @contents string. The @contents should be freed with g_free() when no longer needed. If @etag_out is present, it will be set to the new entity tag for the @file. - %TRUE if the load was successful. If %FALSE and @error is present, it will be set appropriately. @@ -31586,7 +30335,7 @@ set to the new entity tag for the @file. or %NULL if the length is not needed - + a location to place the current entity tag for the file, or %NULL if the entity tag is not needed @@ -31605,7 +30354,6 @@ both the @read_more_callback and the @callback. If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. - @@ -31641,7 +30389,6 @@ with g_file_load_partial_contents_async(). The data is always zero-terminated, but this is not included in the resultant @length. The returned @contents should be freed with g_free() when no longer needed. - %TRUE if the load was successful. If %FALSE and @error is present, it will be set appropriately. @@ -31667,7 +30414,7 @@ needed. or %NULL if the length is not needed - + a location to place the current entity tag for the file, or %NULL if the entity tag is not needed @@ -31689,7 +30436,6 @@ For a local #GFile the newly created directory will have the default If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. - %TRUE on successful creation, %FALSE otherwise. @@ -31708,7 +30454,6 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. Asynchronously creates a directory. - @@ -31740,7 +30485,6 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. Finishes an asynchronous directory creation, started with g_file_make_directory_async(). - %TRUE on successful directory creation, %FALSE otherwise. @@ -31770,7 +30514,6 @@ For a local #GFile the newly created directories will have the default If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. - %TRUE if all directories have been successfully created, %FALSE otherwise. @@ -31795,7 +30538,6 @@ otherwise. If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. - %TRUE on the creation of a new symlink, %FALSE otherwise. @@ -31836,7 +30578,6 @@ in a user interface. periodic progress updates while scanning. See the documentation for #GFileMeasureProgressCallback for information about when and how the callback will be invoked. - %TRUE if successful, with the out parameters set. %FALSE otherwise, with @error set. @@ -31882,7 +30623,6 @@ callback will be invoked. This is the asynchronous version of g_file_measure_disk_usage(). See there for more information. - @@ -31925,7 +30665,6 @@ there for more information. Collects the results from an earlier call to g_file_measure_disk_usage_async(). See g_file_measure_disk_usage() for more information. - %TRUE if successful, with the out parameters set. %FALSE otherwise, with @error set. @@ -31961,7 +30700,6 @@ depending on the type of the file. If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. - a #GFileMonitor for the given @file, or %NULL on error. @@ -31997,7 +30735,6 @@ It does not make sense for @flags to contain directories. It is not possible to monitor all the files in a directory for changes made via hard links; if you want to do this then you must register individual watches with g_file_monitor(). - a #GFileMonitor for the given @file, or %NULL on error. @@ -32035,7 +30772,6 @@ changes made through the filename contained in @file to be reported. Using this flag may result in an increase in resource usage, and may not have any effect depending on the #GFileMonitor backend and/or filesystem type. - a #GFileMonitor for the given @file, or %NULL on error. @@ -32069,7 +30805,6 @@ g_file_mount_enclosing_volume_finish(). If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. - @@ -32105,7 +30840,6 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. Finishes a mount operation started by g_file_mount_enclosing_volume(). - %TRUE if successful. If an error has occurred, this function will return %FALSE and set @error @@ -32135,7 +30869,6 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. When the operation is finished, @callback will be called. You can then call g_file_mount_mountable_finish() to get the result of the operation. - @@ -32174,7 +30907,6 @@ the result of the operation. Finish an asynchronous mount operation that was started with g_file_mount_mountable(). - a #GFile or %NULL on error. Free the returned object with g_object_unref(). @@ -32225,7 +30957,6 @@ If the source is a directory and the target does not exist, or #G_FILE_COPY_OVERWRITE is specified and the target is a file, then the %G_IO_ERROR_WOULD_RECURSE error may be returned (if the native move operation isn't available). - %TRUE on successful move, %FALSE otherwise. @@ -32277,7 +31008,6 @@ what kind of filesystem the file is on. Note that in many non-local file cases read and write streams are not supported, so make sure you really need to do read and write streaming, rather than just opening for reading or writing. - #GFileIOStream or %NULL on error. Free the returned object with g_object_unref(). @@ -32303,7 +31033,6 @@ the synchronous version of this call. When the operation is finished, @callback will be called. You can then call g_file_open_readwrite_finish() to get the result of the operation. - @@ -32335,7 +31064,6 @@ the result of the operation. Finishes an asynchronous file read operation started with g_file_open_readwrite_async(). - a #GFileIOStream or %NULL on error. Free the returned object with g_object_unref(). @@ -32360,7 +31088,6 @@ also avoids an extra duplicated string when possible, so will be generally more efficient. This call does no blocking I/O. - string containing the #GFile's path, or %NULL if no such path exists. The returned string is owned by @file. @@ -32383,7 +31110,6 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. When the operation is finished, @callback will be called. You can then call g_file_mount_mountable_finish() to get the result of the operation. - @@ -32412,7 +31138,6 @@ the result of the operation. Finish an asynchronous poll operation that was polled with g_file_poll_mountable(). - %TRUE if the operation finished successfully. %FALSE otherwise. @@ -32436,7 +31161,6 @@ application to handle the file specified by @file. If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. - a #GAppInfo if the handle was found, %NULL if there were errors. @@ -32456,7 +31180,6 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. Async version of g_file_query_default_handler(). - @@ -32485,7 +31208,6 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. Finishes a g_file_query_default_handler_async() operation. - a #GAppInfo if the handle was found, %NULL if there were errors. @@ -32526,7 +31248,6 @@ for instance to make a menu item sensitive/insensitive, so that you don't have to fool users that something is possible and then just show an error dialog. If you do this, you should make sure to also handle the errors that can happen due to races when you execute the operation. - %TRUE if the file exists (and can be detected without error), %FALSE otherwise (or if cancelled). @@ -32550,7 +31271,6 @@ implemented using g_file_query_info() and as such does blocking I/O. The primary use case of this method is to check if a file is a regular file, directory, or symlink. - The #GFileType of the file and #G_FILE_TYPE_UNKNOWN if the file does not exist @@ -32598,7 +31318,6 @@ returned. If the file does not exist, the %G_IO_ERROR_NOT_FOUND error will be returned. Other errors are possible too, and depend on what kind of filesystem the file is on. - a #GFileInfo or %NULL if there was an error. Free the returned object with g_object_unref(). @@ -32632,7 +31351,6 @@ synchronous version of this call. When the operation is finished, @callback will be called. You can then call g_file_query_info_finish() to get the result of the operation. - @@ -32668,7 +31386,6 @@ operation. Finishes an asynchronous filesystem info query. See g_file_query_filesystem_info_async(). - #GFileInfo for given @file or %NULL on error. @@ -32717,7 +31434,6 @@ about the symlink itself will be returned. If the file does not exist, the %G_IO_ERROR_NOT_FOUND error will be returned. Other errors are possible too, and depend on what kind of filesystem the file is on. - a #GFileInfo for the given @file, or %NULL on error. Free the returned object with g_object_unref(). @@ -32753,7 +31469,6 @@ version of this call. When the operation is finished, @callback will be called. You can then call g_file_query_info_finish() to get the result of the operation. - @@ -32793,7 +31508,6 @@ then call g_file_query_info_finish() to get the result of the operation. Finishes an asynchronous file info query. See g_file_query_info_async(). - #GFileInfo for given @file or %NULL on error. Free the returned object with @@ -32822,7 +31536,6 @@ specific file may not support a specific attribute. If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. - a #GFileAttributeInfoList describing the settable attributes. When you are done with it, release it with @@ -32849,7 +31562,6 @@ attributes (in the "xattr" namespace). If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. - a #GFileAttributeInfoList describing the writable namespaces. When you are done with it, release it with @@ -32880,7 +31592,6 @@ If the file does not exist, the %G_IO_ERROR_NOT_FOUND error will be returned. If the file is a directory, the %G_IO_ERROR_IS_DIRECTORY error will be returned. Other errors are possible too, and depend on what kind of filesystem the file is on. - #GFileInputStream or %NULL on error. Free the returned object with g_object_unref(). @@ -32906,7 +31617,6 @@ the synchronous version of this call. When the operation is finished, @callback will be called. You can then call g_file_read_finish() to get the result of the operation. - @@ -32938,7 +31648,6 @@ of the operation. Finishes an asynchronous file read operation started with g_file_read_async(). - a #GFileInputStream or %NULL on error. Free the returned object with g_object_unref(). @@ -32997,7 +31706,6 @@ file systems don't allow all file names, and may return an %G_IO_ERROR_INVALID_FILENAME error, and if the name is to long %G_IO_ERROR_FILENAME_TOO_LONG will be returned. Other errors are possible too, and depend on what kind of filesystem the file is on. - a #GFileOutputStream or %NULL on error. Free the returned object with g_object_unref(). @@ -33038,7 +31746,6 @@ the synchronous version of this call. When the operation is finished, @callback will be called. You can then call g_file_replace_finish() to get the result of the operation. - @@ -33097,7 +31804,6 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. The returned @new_etag can be used to verify that the file hasn't changed the next time it is saved over. - %TRUE if successful. If an error has occurred, this function will return %FALSE and set @error appropriately if present. @@ -33131,7 +31837,7 @@ changed the next time it is saved over. a set of #GFileCreateFlags - + a location to a new [entity tag][gfile-etag] for the document. This should be freed with g_free() when no longer needed, or %NULL @@ -33163,7 +31869,6 @@ Note that no copy of @contents will be made, so it must stay valid until @callback is called. See g_file_replace_contents_bytes_async() for a #GBytes version that will automatically hold a reference to the contents (without copying) for the duration of the call. - @@ -33217,7 +31922,6 @@ content without waiting for the callback. When this operation has completed, @callback will be called with @user_user data, and the operation can be finalized with g_file_replace_contents_finish(). - @@ -33260,7 +31964,6 @@ g_file_replace_contents_finish(). Finishes an asynchronous replace of the given @file. See g_file_replace_contents_async(). Sets @new_etag to the new entity tag for the document, if present. - %TRUE on success, %FALSE on failure. @@ -33274,7 +31977,7 @@ tag for the document, if present. a #GAsyncResult - + a location of a new [entity tag][gfile-etag] for the document. This should be freed with g_free() when it is no longer needed, or %NULL @@ -33285,7 +31988,6 @@ tag for the document, if present. Finishes an asynchronous file replace operation started with g_file_replace_async(). - a #GFileOutputStream, or %NULL on error. Free the returned object with g_object_unref(). @@ -33313,7 +32015,6 @@ same thing but returns an output stream only. Note that in many non-local file cases read and write streams are not supported, so make sure you really need to do read and write streaming, rather than just opening for reading or writing. - a #GFileIOStream or %NULL on error. Free the returned object with g_object_unref(). @@ -33355,7 +32056,6 @@ the synchronous version of this call. When the operation is finished, @callback will be called. You can then call g_file_replace_readwrite_finish() to get the result of the operation. - @@ -33400,7 +32100,6 @@ the result of the operation. Finishes an asynchronous file replace operation started with g_file_replace_readwrite_async(). - a #GFileIOStream, or %NULL on error. Free the returned object with g_object_unref(). @@ -33421,7 +32120,6 @@ g_file_replace_readwrite_async(). Resolves a relative path for @file to an absolute path. This call does no blocking I/O. - #GFile to the resolved path. %NULL if @relative_path is %NULL or if @file is invalid. @@ -33448,7 +32146,6 @@ Some attributes can be unset by setting @type to If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. - %TRUE if the attribute was set, %FALSE otherwise. @@ -33490,7 +32187,6 @@ returning %FALSE. If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. - %TRUE if the @attribute was successfully set to @value in the @file, %FALSE otherwise. @@ -33527,7 +32223,6 @@ If @attribute is of a different type, this operation will fail. If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. - %TRUE if the @attribute was successfully set to @value in the @file, %FALSE otherwise. @@ -33564,7 +32259,6 @@ If @attribute is of a different type, this operation will fail. If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. - %TRUE if the @attribute was successfully set, %FALSE otherwise. @@ -33600,7 +32294,6 @@ If @attribute is of a different type, this operation will fail. If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. - %TRUE if the @attribute was successfully set, %FALSE otherwise. @@ -33636,7 +32329,6 @@ If @attribute is of a different type, this operation will fail. If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. - %TRUE if the @attribute was successfully set to @value in the @file, %FALSE otherwise. @@ -33673,7 +32365,6 @@ If @attribute is of a different type, this operation will fail. If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. - %TRUE if the @attribute was successfully set to @value in the @file, %FALSE otherwise. @@ -33712,7 +32403,6 @@ which is the synchronous version of this call. When the operation is finished, @callback will be called. You can then call g_file_set_attributes_finish() to get the result of the operation. - @@ -33750,7 +32440,6 @@ the result of the operation. Finishes setting an attribute started in g_file_set_attributes_async(). - %TRUE if the attributes were set correctly, %FALSE otherwise. @@ -33783,7 +32472,6 @@ also detect further errors. If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. - %FALSE if there was any error, %TRUE otherwise. @@ -33824,7 +32512,6 @@ On success the resulting converted filename is returned. If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. - a #GFile specifying what @file was renamed to, or %NULL if there was an error. @@ -33856,7 +32543,6 @@ the synchronous version of this call. When the operation is finished, @callback will be called. You can then call g_file_set_display_name_finish() to get the result of the operation. - @@ -33892,7 +32578,6 @@ the result of the operation. Finishes setting a display name started with g_file_set_display_name_async(). - a #GFile or %NULL on error. Free the returned object with g_object_unref(). @@ -33921,7 +32606,6 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. When the operation is finished, @callback will be called. You can then call g_file_mount_mountable_finish() to get the result of the operation. - @@ -33957,7 +32641,6 @@ the result of the operation. Finish an asynchronous start operation that was started with g_file_start_mountable(). - %TRUE if the operation finished successfully. %FALSE otherwise. @@ -33984,7 +32667,6 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. When the operation is finished, @callback will be called. You can then call g_file_stop_mountable_finish() to get the result of the operation. - @@ -34023,7 +32705,6 @@ the result of the operation. Finish an asynchronous stop operation that was started with g_file_stop_mountable(). - %TRUE if the operation finished successfully. %FALSE otherwise. @@ -34045,7 +32726,6 @@ with g_file_stop_mountable(). [thread-default contexts][g-main-context-push-thread-default-context]. If this returns %FALSE, you cannot perform asynchronous operations on @file in a thread that has a thread-default context. - Whether or not @file supports thread-default contexts. @@ -34068,7 +32748,6 @@ mounts, the %G_IO_ERROR_NOT_SUPPORTED error will be returned in that case. If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. - %TRUE on successful trash, %FALSE otherwise. @@ -34087,7 +32766,6 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. Asynchronously sends @file to the Trash location, if possible. - @@ -34119,7 +32797,6 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. Finishes an asynchronous file trashing operation, started with g_file_trash_async(). - %TRUE on successful trash, %FALSE otherwise. @@ -34146,7 +32823,6 @@ When the operation is finished, @callback will be called. You can then call g_file_unmount_mountable_finish() to get the result of the operation. Use g_file_unmount_mountable_with_operation() instead. - @@ -34182,7 +32858,6 @@ Finish an asynchronous unmount operation that was started with g_file_unmount_mountable(). Use g_file_unmount_mountable_with_operation_finish() instead. - %TRUE if the operation finished successfully. %FALSE otherwise. @@ -34209,7 +32884,6 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. When the operation is finished, @callback will be called. You can then call g_file_unmount_mountable_finish() to get the result of the operation. - @@ -34249,7 +32923,6 @@ see g_file_unmount_mountable_with_operation() for details. Finish an asynchronous unmount operation that was started with g_file_unmount_mountable_with_operation(). - %TRUE if the operation finished successfully. %FALSE otherwise. @@ -34269,7 +32942,6 @@ with g_file_unmount_mountable_with_operation(). Information about a specific attribute. - the name of the attribute. @@ -34298,7 +32970,6 @@ with g_file_unmount_mountable_with_operation(). Acts as a lightweight registry for possible valid file attributes. The registry stores Key-Value pair formats as #GFileAttributeInfos. - an array of #GFileAttributeInfos. @@ -34309,7 +32980,6 @@ The registry stores Key-Value pair formats as #GFileAttributeInfos. Creates a new file attribute info list. - a #GFileAttributeInfoList. @@ -34318,7 +32988,6 @@ The registry stores Key-Value pair formats as #GFileAttributeInfos. Adds a new attribute with @name to the @list, setting its @type and @flags. - @@ -34343,7 +33012,6 @@ its @type and @flags. Makes a duplicate of a file attribute info list. - a copy of the given @list. @@ -34357,7 +33025,6 @@ its @type and @flags. Gets the file attribute with the name @name from @list. - a #GFileAttributeInfo for the @name, or %NULL if an attribute isn't found. @@ -34376,7 +33043,6 @@ attribute isn't found. References a file attribute info list. - #GFileAttributeInfoList or %NULL on error. @@ -34391,7 +33057,6 @@ attribute isn't found. Removes a reference from the given @list. If the reference count falls to zero, the @list is deleted. - @@ -34405,7 +33070,6 @@ falls to zero, the @list is deleted. Determines if a string matches a file attribute. - Creates a new file attribute matcher, which matches attributes against a given string. #GFileAttributeMatchers are reference @@ -34426,7 +33090,6 @@ The wildcard "*" may be used to match all keys and namespaces, or standard namespace. - `"standard::type,unix::*"`: matches the type key in the standard namespace and all keys in the unix namespace. - a #GFileAttributeMatcher @@ -34445,7 +33108,6 @@ matcher was created with "standard::*" and @ns is "standard", or if matcher was using "*" and namespace is anything.) TODO: this is awkwardly worded. - %TRUE if the matcher matches all of the entries in the given @ns, %FALSE otherwise. @@ -34464,7 +33126,6 @@ in the given @ns, %FALSE otherwise. Gets the next matched attribute from a #GFileAttributeMatcher. - a string containing the next attribute or, %NULL if no more attribute exist. @@ -34481,7 +33142,6 @@ no more attribute exist. Checks if an attribute will be matched by an attribute matcher. If the matcher was created with the "*" matching string, this function will always return %TRUE. - %TRUE if @attribute matches @matcher. %FALSE otherwise. @@ -34500,7 +33160,6 @@ will always return %TRUE. Checks if a attribute matcher only matches a given attribute. Always returns %FALSE if "*" was used when creating the matcher. - %TRUE if the matcher only matches @attribute. %FALSE otherwise. @@ -34518,7 +33177,6 @@ returns %FALSE if "*" was used when creating the matcher. References a file attribute matcher. - a #GFileAttributeMatcher. @@ -34539,18 +33197,17 @@ attribute when the @matcher matches the whole namespace - or remove a namespace or attribute when the matcher matches everything. This is a limitation of the current implementation, but may be fixed in the future. - - + A file attribute matcher matching all attributes of @matcher that are not matched by @subtract - + Matcher to subtract from - + The matcher to subtract @@ -34561,7 +33218,6 @@ in the future. equal to the format passed to g_file_attribute_matcher_new(). The output however, might not be identical, as the matcher may decide to use a different order or omit needless parts. - a string describing the attributes the matcher matches against or %NULL if @matcher was %NULL. @@ -34577,7 +33233,6 @@ decide to use a different order or omit needless parts. Unreferences @matcher. If the reference count falls below 1, the @matcher is automatically freed. - @@ -34687,10 +33342,8 @@ the @matcher is automatically freed. Note that `<gio/gfiledescriptorbased.h>` belongs to the UNIX-specific GIO interfaces, thus you have to use the `gio-unix-2.0.pc` pkg-config file when using it. - Gets the underlying file descriptor. - The file descriptor @@ -34704,7 +33357,6 @@ file when using it. Gets the underlying file descriptor. - The file descriptor @@ -34719,14 +33371,12 @@ file when using it. An interface for file descriptor based io objects. - The parent interface. - The file descriptor @@ -34767,7 +33417,6 @@ To close a #GFileEnumerator, use g_file_enumerator_close(), or its asynchronous version, g_file_enumerator_close_async(). Once a #GFileEnumerator is closed, no further actions may be performed on it, and it should be freed with g_object_unref(). - Asynchronously closes the file enumerator. @@ -34775,7 +33424,6 @@ If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned in g_file_enumerator_close_finish(). - @@ -34813,7 +33461,6 @@ return %FALSE. If @cancellable was not %NULL, then the operation may have been cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be set, and %FALSE will be returned. - %TRUE if the close operation has finished successfully. @@ -34830,7 +33477,6 @@ returned. - @@ -34855,7 +33501,6 @@ order of returned files. On error, returns %NULL and sets @error to the error. If the enumerator is at the end, %NULL will be returned and @error will be unset. - A #GFileInfo or %NULL on error or end of enumerator. Free the returned object with @@ -34893,7 +33538,6 @@ result in %G_IO_ERROR_PENDING errors. Any outstanding i/o request with higher priority (lower numerical value) will be executed before an outstanding request with lower priority. Default priority is %G_PRIORITY_DEFAULT. - @@ -34926,7 +33570,6 @@ priority is %G_PRIORITY_DEFAULT. Finishes the asynchronous operation started with g_file_enumerator_next_files_async(). - a #GList of #GFileInfos. You must free the list with g_list_free() and unref the infos with g_object_unref() when you're @@ -34953,7 +33596,6 @@ enumerator return %G_IO_ERROR_CLOSED on all calls. This will be automatically called when the last reference is dropped, but you might want to call this function to make sure resources are released as early as possible. - #TRUE on success or #FALSE on error. @@ -34976,7 +33618,6 @@ If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned in g_file_enumerator_close_finish(). - @@ -35014,7 +33655,6 @@ return %FALSE. If @cancellable was not %NULL, then the operation may have been cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be set, and %FALSE will be returned. - %TRUE if the close operation has finished successfully. @@ -35041,7 +33681,6 @@ This is a convenience method that's equivalent to: GFile *child = g_file_get_child (g_file_enumerator_get_container (enumr), name); ]| - a #GFile for the #GFileInfo passed it. @@ -35060,7 +33699,6 @@ This is a convenience method that's equivalent to: Get the #GFile container which is being enumerated. - the #GFile which is being enumerated. @@ -35074,7 +33712,6 @@ This is a convenience method that's equivalent to: Checks if the file enumerator has pending operations. - %TRUE if the @enumerator has pending operations. @@ -35088,7 +33725,6 @@ This is a convenience method that's equivalent to: Checks if the file enumerator has been closed. - %TRUE if the @enumerator is closed. @@ -35139,7 +33775,6 @@ while (TRUE) out: g_object_unref (direnum); // Note: frees the last @info ]| - @@ -35174,7 +33809,6 @@ order of returned files. On error, returns %NULL and sets @error to the error. If the enumerator is at the end, %NULL will be returned and @error will be unset. - A #GFileInfo or %NULL on error or end of enumerator. Free the returned object with @@ -35212,7 +33846,6 @@ result in %G_IO_ERROR_PENDING errors. Any outstanding i/o request with higher priority (lower numerical value) will be executed before an outstanding request with lower priority. Default priority is %G_PRIORITY_DEFAULT. - @@ -35245,7 +33878,6 @@ priority is %G_PRIORITY_DEFAULT. Finishes the asynchronous operation started with g_file_enumerator_next_files_async(). - a #GList of #GFileInfos. You must free the list with g_list_free() and unref the infos with g_object_unref() when you're @@ -35267,7 +33899,6 @@ priority is %G_PRIORITY_DEFAULT. Sets the file enumerator as having pending operations. - @@ -35293,13 +33924,11 @@ priority is %G_PRIORITY_DEFAULT. - - A #GFileInfo or %NULL on error or end of enumerator. Free the returned object with @@ -35320,7 +33949,6 @@ priority is %G_PRIORITY_DEFAULT. - @@ -35336,7 +33964,6 @@ priority is %G_PRIORITY_DEFAULT. - @@ -35370,7 +33997,6 @@ priority is %G_PRIORITY_DEFAULT. - a #GList of #GFileInfos. You must free the list with g_list_free() and unref the infos with g_object_unref() when you're @@ -35393,7 +34019,6 @@ priority is %G_PRIORITY_DEFAULT. - @@ -35423,7 +34048,6 @@ priority is %G_PRIORITY_DEFAULT. - %TRUE if the close operation has finished successfully. @@ -35442,7 +34066,6 @@ priority is %G_PRIORITY_DEFAULT. - @@ -35450,7 +34073,6 @@ priority is %G_PRIORITY_DEFAULT. - @@ -35458,7 +34080,6 @@ priority is %G_PRIORITY_DEFAULT. - @@ -35466,7 +34087,6 @@ priority is %G_PRIORITY_DEFAULT. - @@ -35474,7 +34094,6 @@ priority is %G_PRIORITY_DEFAULT. - @@ -35482,7 +34101,6 @@ priority is %G_PRIORITY_DEFAULT. - @@ -35490,16 +34108,13 @@ priority is %G_PRIORITY_DEFAULT. - - - - + GFileIOStream provides io streams that both read and write to the same file handle. @@ -35521,10 +34136,8 @@ stream, use g_seekable_truncate(). The default implementation of all the #GFileIOStream operations and the implementation of #GSeekable just call into the same operations on the output stream. - - @@ -35535,7 +34148,6 @@ on the output stream. - @@ -35549,8 +34161,7 @@ on the output stream. Gets the entity tag for the file when it has been written. This must be called after the stream has been written and closed, as the etag can change while writing. - - + the entity tag for the stream. @@ -35579,7 +34190,6 @@ If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be set, and %NULL will be returned. - a #GFileInfo for the @stream, or %NULL on error. @@ -35606,7 +34216,6 @@ finish the operation with g_file_io_stream_query_info_finish(). For the synchronous version of this function, see g_file_io_stream_query_info(). - @@ -35640,7 +34249,6 @@ g_file_io_stream_query_info(). Finalizes the asynchronous query started by g_file_io_stream_query_info_async(). - A #GFileInfo for the finished query. @@ -35657,7 +34265,6 @@ by g_file_io_stream_query_info_async(). - @@ -35677,7 +34284,6 @@ by g_file_io_stream_query_info_async(). - @@ -35688,7 +34294,6 @@ by g_file_io_stream_query_info_async(). - @@ -35708,8 +34313,7 @@ by g_file_io_stream_query_info_async(). Gets the entity tag for the file when it has been written. This must be called after the stream has been written and closed, as the etag can change while writing. - - + the entity tag for the stream. @@ -35738,7 +34342,6 @@ If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be set, and %NULL will be returned. - a #GFileInfo for the @stream, or %NULL on error. @@ -35765,7 +34368,6 @@ finish the operation with g_file_io_stream_query_info_finish(). For the synchronous version of this function, see g_file_io_stream_query_info(). - @@ -35799,7 +34401,6 @@ g_file_io_stream_query_info(). Finalizes the asynchronous query started by g_file_io_stream_query_info_async(). - A #GFileInfo for the finished query. @@ -35823,13 +34424,11 @@ by g_file_io_stream_query_info_async(). - - @@ -35842,7 +34441,6 @@ by g_file_io_stream_query_info_async(). - @@ -35855,7 +34453,6 @@ by g_file_io_stream_query_info_async(). - @@ -35877,7 +34474,6 @@ by g_file_io_stream_query_info_async(). - @@ -35890,7 +34486,6 @@ by g_file_io_stream_query_info_async(). - @@ -35909,7 +34504,6 @@ by g_file_io_stream_query_info_async(). - a #GFileInfo for the @stream, or %NULL on error. @@ -35932,7 +34526,6 @@ by g_file_io_stream_query_info_async(). - @@ -35966,7 +34559,6 @@ by g_file_io_stream_query_info_async(). - A #GFileInfo for the finished query. @@ -35985,8 +34577,7 @@ by g_file_io_stream_query_info_async(). - - + the entity tag for the stream. @@ -36000,7 +34591,6 @@ by g_file_io_stream_query_info_async(). - @@ -36008,7 +34598,6 @@ by g_file_io_stream_query_info_async(). - @@ -36016,7 +34605,6 @@ by g_file_io_stream_query_info_async(). - @@ -36024,7 +34612,6 @@ by g_file_io_stream_query_info_async(). - @@ -36032,25 +34619,20 @@ by g_file_io_stream_query_info_async(). - - - - + #GFileIcon specifies an icon by pointing to an image file to be used as icon. - Creates a new icon for a file. - a #GIcon for the given @file, or %NULL on error. @@ -36065,9 +34647,8 @@ to be used as icon. Gets the #GFile associated with the given @icon. - - a #GFile, or %NULL. + a #GFile. @@ -36082,19 +34663,15 @@ to be used as icon. - - - + An interface for writing VFS file handles. - The parent interface. - a new #GFile that is a duplicate of the given #GFile. @@ -36110,7 +34687,6 @@ to be used as icon. - 0 if @file is not a valid #GFile, otherwise an integer that can be used as hash value for the #GFile. @@ -36128,7 +34704,6 @@ to be used as icon. - %TRUE if @file1 and @file2 are equal. @@ -36147,7 +34722,6 @@ to be used as icon. - %TRUE if @file is native @@ -36162,7 +34736,6 @@ to be used as icon. - %TRUE if #GFile's backend supports the given URI scheme, %FALSE if URI scheme is %NULL, @@ -36183,11 +34756,10 @@ to be used as icon. - - + a string containing the URI scheme for the given - #GFile. The returned string should be freed with g_free() - when no longer needed. + #GFile or %NULL if the #GFile was constructed with an invalid URI. The + returned string should be freed with g_free() when no longer needed. @@ -36200,12 +34772,15 @@ to be used as icon. - - - + + string containing the #GFile's + base name, or %NULL if given #GFile is invalid. The returned string + should be freed with g_free() when no longer needed. + + input #GFile @@ -36213,12 +34788,15 @@ to be used as icon. - - - + + string containing the #GFile's path, + or %NULL if no such path exists. The returned string should be freed + with g_free() when no longer needed. + + input #GFile @@ -36226,9 +34804,9 @@ to be used as icon. - - a string containing the #GFile's URI. + a string containing the #GFile's URI. If the #GFile was constructed + with an invalid URI, an invalid URI is returned. The returned string should be freed with g_free() when no longer needed. @@ -36243,7 +34821,6 @@ to be used as icon. - a string containing the #GFile's parse name. The returned string should be freed with g_free() @@ -36260,7 +34837,6 @@ to be used as icon. - a #GFile structure to the parent of the given #GFile or %NULL if there is no parent. Free @@ -36277,7 +34853,6 @@ to be used as icon. - %TRUE if the @file's parent, grandparent, etc is @prefix, %FALSE otherwise. @@ -36297,15 +34872,20 @@ to be used as icon. - - - + + string with the relative path from + @descendant to @parent, or %NULL if @descendant doesn't have @parent as + prefix. The returned string should be freed with g_free() when + no longer needed. + + input #GFile + input #GFile @@ -36313,7 +34893,6 @@ to be used as icon. - #GFile to the resolved path. %NULL if @relative_path is %NULL or if @file is invalid. @@ -36334,7 +34913,6 @@ to be used as icon. - a #GFile to the specified child, or %NULL if the display name couldn't be converted. @@ -36355,7 +34933,6 @@ to be used as icon. - A #GFileEnumerator if successful, %NULL on error. Free the returned object with g_object_unref(). @@ -36384,7 +34961,6 @@ to be used as icon. - @@ -36424,7 +35000,6 @@ to be used as icon. - a #GFileEnumerator or %NULL if an error occurred. @@ -36445,7 +35020,6 @@ to be used as icon. - a #GFileInfo for the given @file, or %NULL on error. Free the returned object with g_object_unref(). @@ -36474,7 +35048,6 @@ to be used as icon. - @@ -36514,7 +35087,6 @@ to be used as icon. - #GFileInfo for given @file or %NULL on error. Free the returned object with @@ -36535,7 +35107,6 @@ to be used as icon. - a #GFileInfo or %NULL if there was an error. Free the returned object with g_object_unref(). @@ -36560,7 +35131,6 @@ to be used as icon. - @@ -36596,7 +35166,6 @@ to be used as icon. - #GFileInfo for given @file or %NULL on error. @@ -36617,7 +35186,6 @@ to be used as icon. - a #GMount where the @file is located or %NULL on error. @@ -36639,7 +35207,6 @@ to be used as icon. - @@ -36671,7 +35238,6 @@ to be used as icon. - #GMount for given @file or %NULL on error. Free the returned object with g_object_unref(). @@ -36691,7 +35257,6 @@ to be used as icon. - a #GFile specifying what @file was renamed to, or %NULL if there was an error. @@ -36717,7 +35282,6 @@ to be used as icon. - @@ -36753,7 +35317,6 @@ to be used as icon. - a #GFile or %NULL on error. Free the returned object with g_object_unref(). @@ -36773,7 +35336,6 @@ to be used as icon. - a #GFileAttributeInfoList describing the settable attributes. When you are done with it, release it with @@ -36795,7 +35357,6 @@ to be used as icon. - @@ -36803,7 +35364,6 @@ to be used as icon. - @@ -36811,7 +35371,6 @@ to be used as icon. - a #GFileAttributeInfoList describing the writable namespaces. When you are done with it, release it with @@ -36833,7 +35392,6 @@ to be used as icon. - @@ -36841,7 +35399,6 @@ to be used as icon. - @@ -36849,7 +35406,6 @@ to be used as icon. - %TRUE if the attribute was set, %FALSE otherwise. @@ -36886,7 +35442,6 @@ to be used as icon. - %FALSE if there was any error, %TRUE otherwise. @@ -36914,7 +35469,6 @@ to be used as icon. - @@ -36953,7 +35507,6 @@ to be used as icon. - %TRUE if the attributes were set correctly, %FALSE otherwise. @@ -36976,7 +35529,6 @@ to be used as icon. - #GFileInputStream or %NULL on error. Free the returned object with g_object_unref(). @@ -36996,7 +35548,6 @@ to be used as icon. - @@ -37028,7 +35579,6 @@ to be used as icon. - a #GFileInputStream or %NULL on error. Free the returned object with g_object_unref(). @@ -37048,7 +35598,6 @@ to be used as icon. - a #GFileOutputStream, or %NULL on error. Free the returned object with g_object_unref(). @@ -37073,7 +35622,6 @@ to be used as icon. - @@ -37109,7 +35657,6 @@ to be used as icon. - a valid #GFileOutputStream or %NULL on error. @@ -37130,7 +35677,6 @@ to be used as icon. - a #GFileOutputStream for the newly created file, or %NULL on error. @@ -37156,7 +35702,6 @@ to be used as icon. - @@ -37192,7 +35737,6 @@ to be used as icon. - a #GFileOutputStream or %NULL on error. Free the returned object with g_object_unref(). @@ -37212,7 +35756,6 @@ to be used as icon. - a #GFileOutputStream or %NULL on error. Free the returned object with g_object_unref(). @@ -37246,7 +35789,6 @@ to be used as icon. - @@ -37291,7 +35833,6 @@ to be used as icon. - a #GFileOutputStream, or %NULL on error. Free the returned object with g_object_unref(). @@ -37311,7 +35852,6 @@ to be used as icon. - %TRUE if the file was deleted. %FALSE otherwise. @@ -37331,7 +35871,6 @@ to be used as icon. - @@ -37363,7 +35902,6 @@ to be used as icon. - %TRUE if the file was deleted. %FALSE otherwise. @@ -37382,7 +35920,6 @@ to be used as icon. - %TRUE on successful trash, %FALSE otherwise. @@ -37402,7 +35939,6 @@ to be used as icon. - @@ -37434,7 +35970,6 @@ to be used as icon. - %TRUE on successful trash, %FALSE otherwise. @@ -37453,7 +35988,6 @@ to be used as icon. - %TRUE on successful creation, %FALSE otherwise. @@ -37473,7 +36007,6 @@ to be used as icon. - @@ -37505,7 +36038,6 @@ to be used as icon. - %TRUE on successful directory creation, %FALSE otherwise. @@ -37524,7 +36056,6 @@ to be used as icon. - %TRUE on the creation of a new symlink, %FALSE otherwise. @@ -37549,7 +36080,6 @@ to be used as icon. - @@ -37557,7 +36087,6 @@ to be used as icon. - @@ -37565,7 +36094,6 @@ to be used as icon. - %TRUE on success, %FALSE otherwise. @@ -37602,7 +36130,6 @@ to be used as icon. - @@ -37650,7 +36177,6 @@ to be used as icon. - a %TRUE on success, %FALSE on error. @@ -37669,7 +36195,6 @@ to be used as icon. - %TRUE on successful move, %FALSE otherwise. @@ -37707,7 +36232,6 @@ to be used as icon. - @@ -37715,7 +36239,6 @@ to be used as icon. - @@ -37723,7 +36246,6 @@ to be used as icon. - @@ -37760,7 +36282,6 @@ to be used as icon. - a #GFile or %NULL on error. Free the returned object with g_object_unref(). @@ -37780,7 +36301,6 @@ to be used as icon. - @@ -37812,7 +36332,6 @@ to be used as icon. - %TRUE if the operation finished successfully. %FALSE otherwise. @@ -37832,7 +36351,6 @@ to be used as icon. - @@ -37864,7 +36382,6 @@ to be used as icon. - %TRUE if the @file was ejected successfully. %FALSE otherwise. @@ -37884,7 +36401,6 @@ to be used as icon. - @@ -37921,7 +36437,6 @@ to be used as icon. - %TRUE if successful. If an error has occurred, this function will return %FALSE and set @error @@ -37942,7 +36457,6 @@ to be used as icon. - a #GFileMonitor for the given @file, or %NULL on error. @@ -37968,7 +36482,6 @@ to be used as icon. - a #GFileMonitor for the given @file, or %NULL on error. @@ -37994,7 +36507,6 @@ to be used as icon. - #GFileIOStream or %NULL on error. Free the returned object with g_object_unref(). @@ -38014,7 +36526,6 @@ to be used as icon. - @@ -38046,7 +36557,6 @@ to be used as icon. - a #GFileIOStream or %NULL on error. Free the returned object with g_object_unref(). @@ -38066,7 +36576,6 @@ to be used as icon. - a #GFileIOStream for the newly created file, or %NULL on error. @@ -38092,7 +36601,6 @@ to be used as icon. - @@ -38128,7 +36636,6 @@ to be used as icon. - a #GFileIOStream or %NULL on error. Free the returned object with g_object_unref(). @@ -38148,7 +36655,6 @@ to be used as icon. - a #GFileIOStream or %NULL on error. Free the returned object with g_object_unref(). @@ -38182,7 +36688,6 @@ to be used as icon. - @@ -38227,7 +36732,6 @@ to be used as icon. - a #GFileIOStream, or %NULL on error. Free the returned object with g_object_unref(). @@ -38247,7 +36751,6 @@ to be used as icon. - @@ -38281,7 +36784,6 @@ to be used as icon. - %TRUE if the operation finished successfully. %FALSE otherwise. @@ -38301,7 +36803,6 @@ otherwise. - @@ -38338,7 +36839,6 @@ otherwise. - %TRUE if the operation finished successfully. %FALSE otherwise. @@ -38362,7 +36862,6 @@ otherwise. - @@ -38399,7 +36898,6 @@ otherwise. - %TRUE if the operation finished successfully. %FALSE otherwise. @@ -38419,7 +36917,6 @@ otherwise. - @@ -38456,7 +36953,6 @@ otherwise. - %TRUE if the @file was ejected successfully. %FALSE otherwise. @@ -38476,7 +36972,6 @@ otherwise. - @@ -38503,7 +36998,6 @@ otherwise. - %TRUE if the operation finished successfully. %FALSE otherwise. @@ -38523,7 +37017,6 @@ otherwise. - %TRUE if successful, with the out parameters set. %FALSE otherwise, with @error set. @@ -38567,7 +37060,6 @@ otherwise. - @@ -38609,7 +37101,6 @@ otherwise. - %TRUE if successful, with the out parameters set. %FALSE otherwise, with @error set. @@ -38665,10 +37156,8 @@ of a particular file at runtime. #GFileAttributeMatcher allows for searching through a #GFileInfo for attributes. - Creates a new file info structure. - a #GFileInfo. @@ -38676,7 +37165,6 @@ attributes. Clears the status information from @info. - @@ -38690,7 +37178,6 @@ attributes. First clears all of the [GFileAttribute][gio-GFileAttribute] of @dest_info, and then copies all of the file attributes from @src_info to @dest_info. - @@ -38707,7 +37194,6 @@ and then copies all of the file attributes from @src_info to @dest_info. Duplicates a file info structure. - a duplicate #GFileInfo of @other. @@ -38723,7 +37209,6 @@ and then copies all of the file attributes from @src_info to @dest_info. Gets the value of a attribute, formatted as a string. This escapes things as needed to make the string valid UTF-8. - a UTF-8 string associated with the given @attribute, or %NULL if the attribute wasn’t set. @@ -38744,7 +37229,6 @@ UTF-8. Gets the value of a boolean attribute. If the attribute does not contain a boolean value, %FALSE will be returned. - the boolean value contained within the attribute. @@ -38763,7 +37247,6 @@ contain a boolean value, %FALSE will be returned. Gets the value of a byte string attribute. If the attribute does not contain a byte string, %NULL will be returned. - the contents of the @attribute value as a byte string, or %NULL otherwise. @@ -38782,7 +37265,6 @@ not contain a byte string, %NULL will be returned. Gets the attribute type, value and status for an attribute key. - %TRUE if @info has an attribute named @attribute, %FALSE otherwise. @@ -38816,7 +37298,6 @@ not contain a byte string, %NULL will be returned. Gets a signed 32-bit integer contained within the attribute. If the attribute does not contain a signed 32-bit integer, or is invalid, 0 will be returned. - a signed 32-bit integer from the attribute. @@ -38836,7 +37317,6 @@ attribute does not contain a signed 32-bit integer, or is invalid, Gets a signed 64-bit integer contained within the attribute. If the attribute does not contain a signed 64-bit integer, or is invalid, 0 will be returned. - a signed 64-bit integer from the attribute. @@ -38855,7 +37335,6 @@ attribute does not contain a signed 64-bit integer, or is invalid, Gets the value of a #GObject attribute. If the attribute does not contain a #GObject, %NULL will be returned. - a #GObject associated with the given @attribute, or %NULL otherwise. @@ -38874,7 +37353,6 @@ or %NULL otherwise. Gets the attribute status for an attribute key. - a #GFileAttributeStatus for the given @attribute, or %G_FILE_ATTRIBUTE_STATUS_UNSET if the key is invalid. @@ -38894,7 +37372,6 @@ or %NULL otherwise. Gets the value of a string attribute. If the attribute does not contain a string, %NULL will be returned. - the contents of the @attribute value as a UTF-8 string, or %NULL otherwise. @@ -38914,7 +37391,6 @@ or %NULL otherwise. Gets the value of a stringv attribute. If the attribute does not contain a stringv, %NULL will be returned. - the contents of the @attribute value as a stringv, or %NULL otherwise. Do not free. These returned strings are UTF-8. @@ -38935,7 +37411,6 @@ or %NULL otherwise. Do not free. These returned strings are UTF-8. Gets the attribute type for an attribute key. - a #GFileAttributeType for the given @attribute, or %G_FILE_ATTRIBUTE_TYPE_INVALID if the key is not set. @@ -38956,7 +37431,6 @@ or %NULL otherwise. Do not free. These returned strings are UTF-8. Gets an unsigned 32-bit integer contained within the attribute. If the attribute does not contain an unsigned 32-bit integer, or is invalid, 0 will be returned. - an unsigned 32-bit integer from the attribute. @@ -38976,7 +37450,6 @@ attribute does not contain an unsigned 32-bit integer, or is invalid, Gets a unsigned 64-bit integer contained within the attribute. If the attribute does not contain an unsigned 64-bit integer, or is invalid, 0 will be returned. - a unsigned 64-bit integer from the attribute. @@ -38994,7 +37467,6 @@ attribute does not contain an unsigned 64-bit integer, or is invalid, Gets the file's content type. - a string containing the file's content type, or %NULL if unknown. @@ -39011,7 +37483,6 @@ or %NULL if unknown. Returns the #GDateTime representing the deletion date of the file, as available in G_FILE_ATTRIBUTE_TRASH_DELETION_DATE. If the G_FILE_ATTRIBUTE_TRASH_DELETION_DATE attribute is unset, %NULL is returned. - a #GDateTime, or %NULL. @@ -39025,7 +37496,6 @@ G_FILE_ATTRIBUTE_TRASH_DELETION_DATE attribute is unset, %NULL is returned. Gets a display name for a file. This is guaranteed to always be set. - a string containing the display name. @@ -39039,7 +37509,6 @@ G_FILE_ATTRIBUTE_TRASH_DELETION_DATE attribute is unset, %NULL is returned. Gets the edit name for a file. - a string containing the edit name. @@ -39054,8 +37523,7 @@ G_FILE_ATTRIBUTE_TRASH_DELETION_DATE attribute is unset, %NULL is returned. Gets the [entity tag][gfile-etag] for a given #GFileInfo. See %G_FILE_ATTRIBUTE_ETAG_VALUE. - - + a string containing the value of the "etag:value" attribute. @@ -39069,7 +37537,6 @@ G_FILE_ATTRIBUTE_TRASH_DELETION_DATE attribute is unset, %NULL is returned. Gets a file's type (whether it is a regular file, symlink, etc). This is different from the file's content type, see g_file_info_get_content_type(). - a #GFileType for the given file. @@ -39083,8 +37550,7 @@ This is different from the file's content type, see g_file_info_get_content_type Gets the icon for a file. - - + #GIcon for the given @info. @@ -39097,7 +37563,6 @@ This is different from the file's content type, see g_file_info_get_content_type Checks if a file is a backup file. - %TRUE if file is a backup file, %FALSE otherwise. @@ -39111,7 +37576,6 @@ This is different from the file's content type, see g_file_info_get_content_type Checks if a file is hidden. - %TRUE if the file is a hidden file, %FALSE otherwise. @@ -39125,7 +37589,6 @@ This is different from the file's content type, see g_file_info_get_content_type Checks if a file is a symlink. - %TRUE if the given @info is a symlink. @@ -39144,7 +37607,6 @@ This is different from the file's content type, see g_file_info_get_content_type This requires the %G_FILE_ATTRIBUTE_TIME_MODIFIED attribute. If %G_FILE_ATTRIBUTE_TIME_MODIFIED_USEC is provided, the resulting #GDateTime will have microsecond precision. - modification time, or %NULL if unknown @@ -39161,7 +37623,6 @@ will have microsecond precision. in @result. Use g_file_info_get_modification_date_time() instead, as #GTimeVal is deprecated due to the year 2038 problem. - @@ -39178,7 +37639,6 @@ in @result. Gets the name for a file. This is guaranteed to always be set. - a string containing the file name. @@ -39191,10 +37651,11 @@ in @result. - Gets the file's size. - + Gets the file's size (in bytes). The size is retrieved through the value of +the %G_FILE_ATTRIBUTE_STANDARD_SIZE attribute and is converted +from #guint64 to #goffset before returning the result. - a #goffset containing the file's size. + a #goffset containing the file's size (in bytes). @@ -39207,7 +37668,6 @@ in @result. Gets the value of the sort_order attribute from the #GFileInfo. See %G_FILE_ATTRIBUTE_STANDARD_SORT_ORDER. - a #gint32 containing the value of the "standard::sort_order" attribute. @@ -39221,8 +37681,7 @@ See %G_FILE_ATTRIBUTE_STANDARD_SORT_ORDER. Gets the symbolic icon for a file. - - + #GIcon for the given @info. @@ -39235,8 +37694,7 @@ See %G_FILE_ATTRIBUTE_STANDARD_SORT_ORDER. Gets the symlink target for a given #GFileInfo. - - + a string containing the symlink target. @@ -39249,7 +37707,6 @@ See %G_FILE_ATTRIBUTE_STANDARD_SORT_ORDER. Checks if a file info structure has an attribute named @attribute. - %TRUE if @info has an attribute named @attribute, %FALSE otherwise. @@ -39269,7 +37726,6 @@ See %G_FILE_ATTRIBUTE_STANDARD_SORT_ORDER. Checks if a file info structure has an attribute in the specified @name_space. - %TRUE if @info has an attribute in @name_space, %FALSE otherwise. @@ -39288,7 +37744,6 @@ specified @name_space. Lists the file info structure's attributes. - a null-terminated array of strings of all of the possible attribute @@ -39311,7 +37766,6 @@ types for the given @name_space, or %NULL on error. Removes all cases of @attribute from @info if it exists. - @@ -39329,7 +37783,6 @@ types for the given @name_space, or %NULL on error. Sets the @attribute to contain the given value, if possible. To unset the attribute, use %G_FILE_ATTRIBUTE_TYPE_INVALID for @type. - @@ -39355,7 +37808,6 @@ attribute, use %G_FILE_ATTRIBUTE_TYPE_INVALID for @type. Sets the @attribute to contain the given @attr_value, if possible. - @@ -39377,7 +37829,6 @@ if possible. Sets the @attribute to contain the given @attr_value, if possible. - @@ -39399,7 +37850,6 @@ if possible. Sets the @attribute to contain the given @attr_value, if possible. - @@ -39421,7 +37871,6 @@ if possible. Sets the @attribute to contain the given @attr_value, if possible. - @@ -39442,7 +37891,6 @@ if possible. Sets @mask on @info to match specific attribute types. - @@ -39460,7 +37908,6 @@ if possible. Sets the @attribute to contain the given @attr_value, if possible. - @@ -39486,7 +37933,6 @@ or similar functions. The attribute must exist in @info for this to work. Otherwise %FALSE is returned and @info is unchanged. - %TRUE if the status was changed, %FALSE if the key was not set. @@ -39509,7 +37955,6 @@ is returned and @info is unchanged. Sets the @attribute to contain the given @attr_value, if possible. - @@ -39533,7 +37978,6 @@ if possible. if possible. Sinze: 2.22 - @@ -39558,7 +38002,6 @@ Sinze: 2.22 Sets the @attribute to contain the given @attr_value, if possible. - @@ -39580,7 +38023,6 @@ if possible. Sets the @attribute to contain the given @attr_value, if possible. - @@ -39602,7 +38044,6 @@ if possible. Sets the content type attribute for a given #GFileInfo. See %G_FILE_ATTRIBUTE_STANDARD_CONTENT_TYPE. - @@ -39620,7 +38061,6 @@ See %G_FILE_ATTRIBUTE_STANDARD_CONTENT_TYPE. Sets the display name for the current #GFileInfo. See %G_FILE_ATTRIBUTE_STANDARD_DISPLAY_NAME. - @@ -39638,7 +38078,6 @@ See %G_FILE_ATTRIBUTE_STANDARD_DISPLAY_NAME. Sets the edit name for the current file. See %G_FILE_ATTRIBUTE_STANDARD_EDIT_NAME. - @@ -39656,7 +38095,6 @@ See %G_FILE_ATTRIBUTE_STANDARD_EDIT_NAME. Sets the file type in a #GFileInfo to @type. See %G_FILE_ATTRIBUTE_STANDARD_TYPE. - @@ -39674,7 +38112,6 @@ See %G_FILE_ATTRIBUTE_STANDARD_TYPE. Sets the icon for a given #GFileInfo. See %G_FILE_ATTRIBUTE_STANDARD_ICON. - @@ -39692,7 +38129,6 @@ See %G_FILE_ATTRIBUTE_STANDARD_ICON. Sets the "is_hidden" attribute in a #GFileInfo according to @is_hidden. See %G_FILE_ATTRIBUTE_STANDARD_IS_HIDDEN. - @@ -39710,7 +38146,6 @@ See %G_FILE_ATTRIBUTE_STANDARD_IS_HIDDEN. Sets the "is_symlink" attribute in a #GFileInfo according to @is_symlink. See %G_FILE_ATTRIBUTE_STANDARD_IS_SYMLINK. - @@ -39729,7 +38164,6 @@ See %G_FILE_ATTRIBUTE_STANDARD_IS_SYMLINK. Sets the %G_FILE_ATTRIBUTE_TIME_MODIFIED and %G_FILE_ATTRIBUTE_TIME_MODIFIED_USEC attributes in the file info to the given date/time value. - @@ -39750,7 +38184,6 @@ given date/time value. given time value. Use g_file_info_set_modification_date_time() instead, as #GTimeVal is deprecated due to the year 2038 problem. - @@ -39768,7 +38201,6 @@ given time value. Sets the name attribute for the current #GFileInfo. See %G_FILE_ATTRIBUTE_STANDARD_NAME. - @@ -39786,7 +38218,6 @@ See %G_FILE_ATTRIBUTE_STANDARD_NAME. Sets the %G_FILE_ATTRIBUTE_STANDARD_SIZE attribute in the file info to the given size. - @@ -39804,7 +38235,6 @@ to the given size. Sets the sort order attribute in the file info structure. See %G_FILE_ATTRIBUTE_STANDARD_SORT_ORDER. - @@ -39822,7 +38252,6 @@ to the given size. Sets the symbolic icon for a given #GFileInfo. See %G_FILE_ATTRIBUTE_STANDARD_SYMBOLIC_ICON. - @@ -39840,7 +38269,6 @@ See %G_FILE_ATTRIBUTE_STANDARD_SYMBOLIC_ICON. Sets the %G_FILE_ATTRIBUTE_STANDARD_SYMLINK_TARGET attribute in the file info to the given symlink target. - @@ -39858,7 +38286,6 @@ to the given symlink target. Unsets a mask set by g_file_info_set_attribute_mask(), if one is set. - @@ -39870,9 +38297,7 @@ is set. - - - + GFileInputStream provides input streams that take their content from a file. @@ -39883,10 +38308,8 @@ filesystem of the file allows it. To find the position of a file input stream, use g_seekable_tell(). To find out if a file input stream supports seeking, use g_seekable_can_seek(). To position a file input stream, use g_seekable_seek(). - - @@ -39902,7 +38325,6 @@ while querying the stream. For the asynchronous (non-blocking) version of this function, see g_file_input_stream_query_info_async(). While the stream is blocked, the stream will set the pending flag internally, and any other operations on the stream will fail with %G_IO_ERROR_PENDING. - a #GFileInfo, or %NULL on error. @@ -39934,7 +38356,6 @@ see g_file_input_stream_query_info(). If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be set - @@ -39967,7 +38388,6 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be set Finishes an asynchronous info query operation. - #GFileInfo. @@ -39984,7 +38404,6 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be set - @@ -40004,7 +38423,6 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be set - @@ -40020,7 +38438,6 @@ while querying the stream. For the asynchronous (non-blocking) version of this function, see g_file_input_stream_query_info_async(). While the stream is blocked, the stream will set the pending flag internally, and any other operations on the stream will fail with %G_IO_ERROR_PENDING. - a #GFileInfo, or %NULL on error. @@ -40052,7 +38469,6 @@ see g_file_input_stream_query_info(). If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be set - @@ -40085,7 +38501,6 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be set Finishes an asynchronous info query operation. - #GFileInfo. @@ -40109,13 +38524,11 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be set - - @@ -40128,7 +38541,6 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be set - @@ -40141,7 +38553,6 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be set - @@ -40163,7 +38574,6 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be set - a #GFileInfo, or %NULL on error. @@ -40186,7 +38596,6 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be set - @@ -40220,7 +38629,6 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be set - #GFileInfo. @@ -40239,7 +38647,6 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be set - @@ -40247,7 +38654,6 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be set - @@ -40255,7 +38661,6 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be set - @@ -40263,7 +38668,6 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be set - @@ -40271,16 +38675,13 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be set - - - - + Flags that can be used with g_file_measure_disk_usage(). @@ -40330,7 +38731,6 @@ ideally about once every 200ms. The last progress callback may or may not be equal to the final result. Always check the async result to get the final value. - @@ -40372,10 +38772,8 @@ of the thread that the monitor was created in (though if the global default main context is blocked, this may cause notifications to be blocked even if the thread-default context is still running). - Cancels a file monitor. - always %TRUE @@ -40388,7 +38786,6 @@ context is still running). - @@ -40409,7 +38806,6 @@ context is still running). Cancels a file monitor. - always %TRUE @@ -40429,7 +38825,6 @@ implementations only. Implementations are responsible to call this method from the [thread-default main context][g-main-context-push-thread-default] of the thread that the monitor was created in. - @@ -40454,7 +38849,6 @@ thread that the monitor was created in. Returns whether the monitor is canceled. - %TRUE if monitor is canceled. %FALSE otherwise. @@ -40469,7 +38863,6 @@ thread that the monitor was created in. Sets the rate limit to which the @monitor will report consecutive change events to the same file. - @@ -40546,13 +38939,11 @@ In all the other cases, @other_file will be set to #NULL. - - @@ -40574,7 +38965,6 @@ In all the other cases, @other_file will be set to #NULL. - always %TRUE @@ -40589,7 +38979,6 @@ In all the other cases, @other_file will be set to #NULL. - @@ -40597,7 +38986,6 @@ In all the other cases, @other_file will be set to #NULL. - @@ -40605,7 +38993,6 @@ In all the other cases, @other_file will be set to #NULL. - @@ -40613,7 +39000,6 @@ In all the other cases, @other_file will be set to #NULL. - @@ -40621,7 +39007,6 @@ In all the other cases, @other_file will be set to #NULL. - @@ -40698,9 +39083,7 @@ In all the other cases, @other_file will be set to #NULL. events to be emitted when possible. Since: 2.46. - - - + GFileOutputStream provides output streams that write their content to a file. @@ -40716,10 +39099,8 @@ g_seekable_can_seek().To position a file output stream, use g_seekable_seek(). To find out if a file output stream supports truncating, use g_seekable_can_truncate(). To truncate a file output stream, use g_seekable_truncate(). - - @@ -40730,7 +39111,6 @@ stream, use g_seekable_truncate(). - @@ -40744,8 +39124,7 @@ stream, use g_seekable_truncate(). Gets the entity tag for the file when it has been written. This must be called after the stream has been written and closed, as the etag can change while writing. - - + the entity tag for the stream. @@ -40774,7 +39153,6 @@ If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be set, and %NULL will be returned. - a #GFileInfo for the @stream, or %NULL on error. @@ -40801,7 +39179,6 @@ finish the operation with g_file_output_stream_query_info_finish(). For the synchronous version of this function, see g_file_output_stream_query_info(). - @@ -40835,7 +39212,6 @@ g_file_output_stream_query_info(). Finalizes the asynchronous query started by g_file_output_stream_query_info_async(). - A #GFileInfo for the finished query. @@ -40852,7 +39228,6 @@ by g_file_output_stream_query_info_async(). - @@ -40872,7 +39247,6 @@ by g_file_output_stream_query_info_async(). - @@ -40883,7 +39257,6 @@ by g_file_output_stream_query_info_async(). - @@ -40903,8 +39276,7 @@ by g_file_output_stream_query_info_async(). Gets the entity tag for the file when it has been written. This must be called after the stream has been written and closed, as the etag can change while writing. - - + the entity tag for the stream. @@ -40933,7 +39305,6 @@ If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be set, and %NULL will be returned. - a #GFileInfo for the @stream, or %NULL on error. @@ -40960,7 +39331,6 @@ finish the operation with g_file_output_stream_query_info_finish(). For the synchronous version of this function, see g_file_output_stream_query_info(). - @@ -40994,7 +39364,6 @@ g_file_output_stream_query_info(). Finalizes the asynchronous query started by g_file_output_stream_query_info_async(). - A #GFileInfo for the finished query. @@ -41018,13 +39387,11 @@ by g_file_output_stream_query_info_async(). - - @@ -41037,7 +39404,6 @@ by g_file_output_stream_query_info_async(). - @@ -41050,7 +39416,6 @@ by g_file_output_stream_query_info_async(). - @@ -41072,7 +39437,6 @@ by g_file_output_stream_query_info_async(). - @@ -41085,7 +39449,6 @@ by g_file_output_stream_query_info_async(). - @@ -41104,7 +39467,6 @@ by g_file_output_stream_query_info_async(). - a #GFileInfo for the @stream, or %NULL on error. @@ -41127,7 +39489,6 @@ by g_file_output_stream_query_info_async(). - @@ -41161,7 +39522,6 @@ by g_file_output_stream_query_info_async(). - A #GFileInfo for the finished query. @@ -41180,8 +39540,7 @@ by g_file_output_stream_query_info_async(). - - + the entity tag for the stream. @@ -41195,7 +39554,6 @@ by g_file_output_stream_query_info_async(). - @@ -41203,7 +39561,6 @@ by g_file_output_stream_query_info_async(). - @@ -41211,7 +39568,6 @@ by g_file_output_stream_query_info_async(). - @@ -41219,7 +39575,6 @@ by g_file_output_stream_query_info_async(). - @@ -41227,21 +39582,17 @@ by g_file_output_stream_query_info_async(). - - - - + When doing file operations that may take a while, such as moving a file or copying a file, a progress callback is used to pass how far along that operation is to the application. - @@ -41274,7 +39625,6 @@ far along that operation is to the application. it may become necessary to determine if any more data from the file should be loaded. A #GFileReadMoreCallback function facilitates this by returning %TRUE if more data should be read, or %FALSE otherwise. - %TRUE if more data should be read back. %FALSE otherwise. @@ -41333,17 +39683,14 @@ which is why all Windows symlinks will continue to be reported as Completes partial file and directory names given a partial string by looking in the file system for clues. Can return a list of possible completion strings for widget implementations. - Creates a new filename completer. - a #GFilenameCompleter. - @@ -41355,11 +39702,10 @@ completion strings for widget implementations. Obtains a completion for @initial_text from @completer. - - - a completed string, or %NULL if no completion exists. - This string is not owned by GIO, so remember to g_free() it - when finished. + + a completed string, or %NULL if no + completion exists. This string is not owned by GIO, so remember to g_free() + it when finished. @@ -41375,7 +39721,6 @@ completion strings for widget implementations. Gets an array of completion strings for a given initial text. - array of strings with possible completions for @initial_text. This array must be freed by g_strfreev() when finished. @@ -41397,7 +39742,6 @@ This array must be freed by g_strfreev() when finished. If @dirs_only is %TRUE, @completer will only complete directory names, and not file names. - @@ -41420,13 +39764,11 @@ complete directory names, and not file names. - - @@ -41439,7 +39781,6 @@ complete directory names, and not file names. - @@ -41447,7 +39788,6 @@ complete directory names, and not file names. - @@ -41455,7 +39795,6 @@ complete directory names, and not file names. - @@ -41481,10 +39820,8 @@ previewed in a file manager. Returned as the value of the key kind of filtering operation on a base stream. Typical examples of filtering operations are character set conversion, compression and byte order flipping. - Gets the base stream for the filter stream. - a #GInputStream. @@ -41499,7 +39836,6 @@ and byte order flipping. Returns whether the base stream will be closed when @stream is closed. - %TRUE if the base stream will be closed. @@ -41513,7 +39849,6 @@ closed. Sets whether the base stream will be closed when @stream is closed. - @@ -41542,13 +39877,11 @@ closed. - - @@ -41556,7 +39889,6 @@ closed. - @@ -41564,7 +39896,6 @@ closed. - @@ -41576,10 +39907,8 @@ closed. kind of filtering operation on a base stream. Typical examples of filtering operations are character set conversion, compression and byte order flipping. - Gets the base stream for the filter stream. - a #GOutputStream. @@ -41594,7 +39923,6 @@ and byte order flipping. Returns whether the base stream will be closed when @stream is closed. - %TRUE if the base stream will be closed. @@ -41608,7 +39936,6 @@ closed. Sets whether the base stream will be closed when @stream is closed. - @@ -41637,13 +39964,11 @@ closed. - - @@ -41651,7 +39976,6 @@ closed. - @@ -41659,7 +39983,6 @@ closed. - @@ -41667,112 +39990,96 @@ closed. - - - - - - - - - - - - - - - - @@ -41958,13 +40265,11 @@ See also #GPollableReturn for a cheaper way of returning #GIOExtension is an opaque data structure and can only be accessed using the following functions. - Gets the name under which @extension was registered. Note that the same type may be registered as extension for multiple extension points, under different names. - the name of @extension. @@ -41978,7 +40283,6 @@ for multiple extension points, under different names. Gets the priority with which @extension was registered. - the priority of @extension @@ -41992,7 +40296,6 @@ for multiple extension points, under different names. Gets the type associated with @extension. - the type of @extension @@ -42007,7 +40310,6 @@ for multiple extension points, under different names. Gets a reference to the class for the type that is associated with @extension. - the #GTypeClass for the type of @extension @@ -42023,10 +40325,8 @@ associated with @extension. #GIOExtensionPoint is an opaque data structure and can only be accessed using the following functions. - Finds a #GIOExtension for an extension point by name. - the #GIOExtension for @extension_point that has the given name, or %NULL if there is no extension with that name @@ -42046,7 +40346,6 @@ using the following functions. Gets a list of all extensions that implement this extension point. The list is sorted by priority, beginning with the highest priority. - a #GList of #GIOExtensions. The list is owned by GIO and should not be @@ -42064,7 +40363,6 @@ The list is sorted by priority, beginning with the highest priority. Gets the required type for @extension_point. - the #GType that all implementations must have, or #G_TYPE_INVALID if the extension point has no required type @@ -42080,7 +40378,6 @@ The list is sorted by priority, beginning with the highest priority. Sets the required type for @extension_point to @type. All implementations must henceforth have this type. - @@ -42101,7 +40398,6 @@ All implementations must henceforth have this type. If @type has already been registered as an extension for this extension point, the existing #GIOExtension object is returned. - a #GIOExtension object for #GType @@ -42127,7 +40423,6 @@ extension point, the existing #GIOExtension object is returned. Looks up an existing extension point. - the #GIOExtensionPoint, or %NULL if there is no registered extension point with the given name. @@ -42142,7 +40437,6 @@ extension point, the existing #GIOExtension object is returned. Registers an extension point. - the new #GIOExtensionPoint. This object is owned by GIO and should not be freed. @@ -42160,12 +40454,10 @@ extension point, the existing #GIOExtension object is returned. Provides an interface and default functions for loading and unloading modules. This is used internally to make GIO extensible, but can also be used by others to implement module loading. - Creates a new GIOModule that will load the specific shared library when in use. - a #GIOModule from given @filename, or %NULL on error. @@ -42210,7 +40502,6 @@ throughout. For example, `libgiognutls-helper.so` becomes `gnutls_helper`. Using the new symbol names avoids name clashes when building modules statically. The old symbol names continue to be supported, but cannot be used for static builds. - A %NULL-terminated array of strings, listing the supported extension points of the module. The array @@ -42234,7 +40525,6 @@ throughout. For example, `libgiognutls-helper.so` becomes `gnutls_helper`. Using the new symbol names avoids name clashes when building modules statically. The old symbol names continue to be supported, but cannot be used for static builds. - @@ -42258,7 +40548,6 @@ throughout. For example, `libgiognutls-helper.so` becomes `gnutls_helper`. Using the new symbol names avoids name clashes when building modules statically. The old symbol names continue to be supported, but cannot be used for static builds. - @@ -42270,21 +40559,17 @@ for static builds. - - - + Represents a scope for loading IO modules. A scope can be used for blocking duplicate modules, or blocking a module you don't want to load. The scope can be used with g_io_modules_load_all_in_directory_with_scope() or g_io_modules_scan_all_in_directory_with_scope(). - Block modules with the given @basename from being loaded when this scope is used with g_io_modules_scan_all_in_directory_with_scope() or g_io_modules_load_all_in_directory_with_scope(). - @@ -42301,7 +40586,6 @@ or g_io_modules_load_all_in_directory_with_scope(). Free a module scope. - @@ -42319,7 +40603,6 @@ blocking duplicate modules, or blocking a module you don't want to load. Specify the %G_IO_MODULE_SCOPE_BLOCK_DUPLICATES flag to block modules which have the same base name as a module that has already been seen in this scope. - the new module scope @@ -42345,13 +40628,11 @@ in this scope. Opaque class for defining and scheduling IO jobs. - Used from an I/O job to send a callback to be run in the thread that the job was started from, waiting for the result (and thus blocking the I/O job). Use g_main_context_invoke(). - The return value of @func @@ -42386,7 +40667,6 @@ on to this function you have to ensure that it is not freed before @func is called, either by passing %NULL as @notify to g_io_scheduler_push_job() or by using refcounting for @user_data. Use g_main_context_invoke(). - @@ -42415,7 +40695,6 @@ g_io_scheduler_push_job() or by using refcounting for @user_data. Long-running jobs should periodically check the @cancellable to see if they have been cancelled. - %TRUE if this function should be called again to complete the job, %FALSE if the job is complete (or cancelled) @@ -42483,10 +40762,8 @@ application code may only run operations on the base (wrapped) stream when the wrapper stream is idle. Note that the semantics of such operations may not be well-defined due to the state the wrapper stream leaves the base stream in (though they are guaranteed not to crash). - Finishes an asynchronous io stream splice operation. - %TRUE on success, %FALSE otherwise. @@ -42509,7 +40786,6 @@ For behaviour details see g_io_stream_close(). The asynchronous methods have a default fallback that uses threads to implement asynchronicity, so they are optional for inheriting classes. However, if you override one you must override all. - @@ -42538,7 +40814,6 @@ classes. However, if you override one you must override all. Closes a stream. - %TRUE if stream was successfully closed, %FALSE otherwise. @@ -42555,7 +40830,6 @@ classes. However, if you override one you must override all. - @@ -42571,7 +40845,6 @@ classes. However, if you override one you must override all. Gets the input stream for this object. This is used for reading. - a #GInputStream, owned by the #GIOStream. Do not free. @@ -42587,7 +40860,6 @@ Do not free. Gets the output stream for this object. This is used for writing. - a #GOutputStream, owned by the #GIOStream. Do not free. @@ -42602,7 +40874,6 @@ Do not free. Clears the pending flag on @stream. - @@ -42647,7 +40918,6 @@ can use a faster close that doesn't block to e.g. check errors. The default implementation of this method just calls close on the individual input/output streams. - %TRUE on success, %FALSE on failure @@ -42674,7 +40944,6 @@ For behaviour details see g_io_stream_close(). The asynchronous methods have a default fallback that uses threads to implement asynchronicity, so they are optional for inheriting classes. However, if you override one you must override all. - @@ -42703,7 +40972,6 @@ classes. However, if you override one you must override all. Closes a stream. - %TRUE if stream was successfully closed, %FALSE otherwise. @@ -42722,7 +40990,6 @@ classes. However, if you override one you must override all. Gets the input stream for this object. This is used for reading. - a #GInputStream, owned by the #GIOStream. Do not free. @@ -42738,7 +41005,6 @@ Do not free. Gets the output stream for this object. This is used for writing. - a #GOutputStream, owned by the #GIOStream. Do not free. @@ -42753,7 +41019,6 @@ Do not free. Checks if a stream has pending actions. - %TRUE if @stream has pending actions. @@ -42767,7 +41032,6 @@ Do not free. Checks if a stream is closed. - %TRUE if the stream is closed. @@ -42783,7 +41047,6 @@ Do not free. Sets @stream to have actions pending. If the pending flag is already set or @stream is closed, it will return %FALSE and set @error. - %TRUE if pending was previously unset and is now set. @@ -42803,7 +41066,6 @@ already set or @stream is closed, it will return %FALSE and set When the operation is finished @callback will be called. You can then call g_io_stream_splice_finish() to get the result of the operation. - @@ -42854,17 +41116,13 @@ result of the operation. - - - + - - a #GInputStream, owned by the #GIOStream. Do not free. @@ -42880,7 +41138,6 @@ Do not free. - a #GOutputStream, owned by the #GIOStream. Do not free. @@ -42896,7 +41153,6 @@ Do not free. - @@ -42912,7 +41168,6 @@ Do not free. - @@ -42942,7 +41197,6 @@ Do not free. - %TRUE if stream was successfully closed, %FALSE otherwise. @@ -42961,7 +41215,6 @@ Do not free. - @@ -42969,7 +41222,6 @@ Do not free. - @@ -42977,7 +41229,6 @@ Do not free. - @@ -42985,7 +41236,6 @@ Do not free. - @@ -42993,7 +41243,6 @@ Do not free. - @@ -43001,7 +41250,6 @@ Do not free. - @@ -43009,7 +41257,6 @@ Do not free. - @@ -43017,7 +41264,6 @@ Do not free. - @@ -43025,7 +41271,6 @@ Do not free. - @@ -43033,16 +41278,13 @@ Do not free. - - - - + GIOStreamSpliceFlags determine how streams should be spliced. @@ -43062,1652 +41304,1416 @@ Do not free. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - @@ -44742,11 +42748,9 @@ implements #GLoadableIcon. Additionally, you must provide an implementation of g_icon_serialize() that gives a result that is understood by g_icon_deserialize(), yielding one of the built-in icon types. - Deserializes a #GIcon previously serialized using g_icon_serialize(). - - + a #GIcon, or %NULL when deserialization fails. @@ -44759,7 +42763,6 @@ types. Gets a hash for an icon. - a #guint containing a hash for the @icon, suitable for use in a #GHashTable or similar data structure. @@ -44779,7 +42782,6 @@ use in a #GHashTable or similar data structure. If your application or library provides one or more #GIcon implementations you need to ensure that each #GType is registered with the type system prior to calling g_icon_new_for_string(). - An object implementing the #GIcon interface or %NULL if @error is set. @@ -44794,7 +42796,6 @@ with the type system prior to calling g_icon_new_for_string(). Checks if two icons are equal. - %TRUE if @icon1 is equal to @icon2. %FALSE otherwise. @@ -44812,7 +42813,6 @@ with the type system prior to calling g_icon_new_for_string(). Gets a hash for an icon. - a #guint containing a hash for the @icon, suitable for use in a #GHashTable or similar data structure. @@ -44831,8 +42831,7 @@ back by calling g_icon_deserialize() on the returned value. As serialization will avoid using raw icon data when possible, it only makes sense to transfer the #GVariant between processes on the same machine, (as opposed to over the network), and within the same file system namespace. - - + a #GVariant, or %NULL when serialization fails. The #GVariant will not be floating. @@ -44860,7 +42859,6 @@ in the following two cases - If @icon is a #GThemedIcon with exactly one name and no fallbacks, the encoding is simply the name (such as `network-server`). - An allocated NUL-terminated UTF8 string or %NULL if @icon can't be serialized. Use g_free() to free. @@ -44883,7 +42881,6 @@ in the following two cases Checks if two icons are equal. - %TRUE if @icon1 is equal to @icon2. %FALSE otherwise. @@ -44905,8 +42902,7 @@ back by calling g_icon_deserialize() on the returned value. As serialization will avoid using raw icon data when possible, it only makes sense to transfer the #GVariant between processes on the same machine, (as opposed to over the network), and within the same file system namespace. - - + a #GVariant, or %NULL when serialization fails. The #GVariant will not be floating. @@ -44934,7 +42930,6 @@ in the following two cases - If @icon is a #GThemedIcon with exactly one name and no fallbacks, the encoding is simply the name (such as `network-server`). - An allocated NUL-terminated UTF8 string or %NULL if @icon can't be serialized. Use g_free() to free. @@ -44952,14 +42947,12 @@ in the following two cases GIconIface is used to implement GIcon types for various different systems. See #GThemedIcon and #GLoadableIcon for examples of how to implement this interface. - The parent interface. - a #guint containing a hash for the @icon, suitable for use in a #GHashTable or similar data structure. @@ -44975,7 +42968,6 @@ use in a #GHashTable or similar data structure. - %TRUE if @icon1 is equal to @icon2. %FALSE otherwise. @@ -44994,7 +42986,6 @@ use in a #GHashTable or similar data structure. - An allocated NUL-terminated UTF8 string or %NULL if @icon can't be serialized. Use g_free() to free. @@ -45018,7 +43009,6 @@ use in a #GHashTable or similar data structure. - @@ -45037,8 +43027,7 @@ use in a #GHashTable or similar data structure. - - + a #GVariant, or %NULL when serialization fails. The #GVariant will not be floating. @@ -45062,11 +43051,9 @@ g_resolver_lookup_by_address_async() to look up the hostname for a To actually connect to a remote host, you will need a #GInetSocketAddress (which includes a #GInetAddress as well as a port number). - Creates a #GInetAddress for the "any" address (unassigned/"don't care") for @family. - a new #GInetAddress corresponding to the "any" address for @family. @@ -45084,7 +43071,6 @@ for @family. Creates a new #GInetAddress from the given @family and @bytes. @bytes should be 4 bytes for %G_SOCKET_FAMILY_IPV4 and 16 bytes for %G_SOCKET_FAMILY_IPV6. - a new #GInetAddress corresponding to @family and @bytes. Free the returned object with g_object_unref(). @@ -45105,7 +43091,6 @@ for @family. Parses @string as an IP address and creates a new #GInetAddress. - a new #GInetAddress corresponding to @string, or %NULL if @string could not be parsed. @@ -45121,7 +43106,6 @@ to @string, or %NULL if @string could not be parsed. Creates a #GInetAddress for the loopback address for @family. - a new #GInetAddress corresponding to the loopback address for @family. @@ -45137,7 +43121,6 @@ for @family. Gets the raw binary address data from @address. - a pointer to an internal array of the bytes in @address, which should not be modified, stored, or freed. The size of this @@ -45153,7 +43136,6 @@ array can be gotten with g_inet_address_get_native_size(). Converts @address to string form. - a representation of @address as a string, which should be freed after use. @@ -45168,7 +43150,6 @@ freed after use. Checks if two #GInetAddress instances are equal, e.g. the same address. - %TRUE if @address and @other_address are equal, %FALSE otherwise. @@ -45186,7 +43167,6 @@ freed after use. Gets @address's family - @address's family @@ -45200,7 +43180,6 @@ freed after use. Tests whether @address is the "any" address for its family. - %TRUE if @address is the "any" address for its family. @@ -45216,7 +43195,6 @@ freed after use. Tests whether @address is a link-local address (that is, if it identifies a host on a local network that is not connected to the Internet). - %TRUE if @address is a link-local address. @@ -45230,7 +43208,6 @@ Internet). Tests whether @address is the loopback address for its family. - %TRUE if @address is the loopback address for its family. @@ -45244,7 +43221,6 @@ Internet). Tests whether @address is a global multicast address. - %TRUE if @address is a global multicast address. @@ -45258,7 +43234,6 @@ Internet). Tests whether @address is a link-local multicast address. - %TRUE if @address is a link-local multicast address. @@ -45272,7 +43247,6 @@ Internet). Tests whether @address is a node-local multicast address. - %TRUE if @address is a node-local multicast address. @@ -45286,7 +43260,6 @@ Internet). Tests whether @address is an organization-local multicast address. - %TRUE if @address is an organization-local multicast address. @@ -45300,7 +43273,6 @@ Internet). Tests whether @address is a site-local multicast address. - %TRUE if @address is a site-local multicast address. @@ -45314,7 +43286,6 @@ Internet). Tests whether @address is a multicast address. - %TRUE if @address is a multicast address. @@ -45331,7 +43302,6 @@ Internet). (that is, the address identifies a host on a local network that can not be reached directly from the Internet, but which may have outgoing Internet connectivity via a NAT or firewall). - %TRUE if @address is a site-local address. @@ -45346,7 +43316,6 @@ outgoing Internet connectivity via a NAT or firewall). Gets the size of the native raw binary address for @address. This is the size of the data that you get from g_inet_address_to_bytes(). - the number of bytes used for the native version of @address. @@ -45360,7 +43329,6 @@ is the size of the data that you get from g_inet_address_to_bytes(). Gets the raw binary address data from @address. - a pointer to an internal array of the bytes in @address, which should not be modified, stored, or freed. The size of this @@ -45376,7 +43344,6 @@ array can be gotten with g_inet_address_get_native_size(). Converts @address to string form. - a representation of @address as a string, which should be freed after use. @@ -45453,13 +43420,11 @@ See g_inet_address_get_is_loopback(). - - a representation of @address as a string, which should be freed after use. @@ -45475,7 +43440,6 @@ freed after use. - a pointer to an internal array of the bytes in @address, which should not be modified, stored, or freed. The size of this @@ -45496,12 +43460,10 @@ array can be gotten with g_inet_address_get_native_size(). described by a base address and a length indicating how many bits of the base address are relevant for matching purposes. These are often given in string form. Eg, "10.0.0.0/8", or "fe80::/10". - Creates a new #GInetAddressMask representing all addresses whose first @length bits match @addr. - a new #GInetAddressMask, or %NULL on error @@ -45522,7 +43484,6 @@ first @length bits match @addr. creates a new #GInetAddressMask. The length, if present, is delimited by a "/". If it is not present, then the length is assumed to be the full length of the address. - a new #GInetAddressMask corresponding to @string, or %NULL on error. @@ -45537,7 +43498,6 @@ on error. Tests if @mask and @mask2 are the same mask. - whether @mask and @mask2 are the same mask @@ -45555,7 +43515,6 @@ on error. Gets @mask's base address - @mask's base address @@ -45569,7 +43528,6 @@ on error. Gets the #GSocketFamily of @mask's address - the #GSocketFamily of @mask's address @@ -45583,7 +43541,6 @@ on error. Gets @mask's length - @mask's length @@ -45597,7 +43554,6 @@ on error. Tests if @address falls within the range described by @mask. - whether @address falls within the range described by @mask. @@ -45616,7 +43572,6 @@ on error. Converts @mask back to its corresponding string form. - a string corresponding to @mask. @@ -45645,25 +43600,18 @@ on error. - - - - - - - + + An IPv4 or IPv6 socket address; that is, the combination of a #GInetAddress and a port number. - Creates a new #GInetSocketAddress for @address and @port. - a new #GInetSocketAddress @@ -45684,7 +43632,6 @@ on error. If @address is an IPv6 address, it can also contain a scope ID (separated from the address by a `%`). - a new #GInetSocketAddress, or %NULL if @address cannot be parsed. @@ -45703,7 +43650,6 @@ or %NULL if @address cannot be parsed. Gets @address's #GInetAddress. - the #GInetAddress for @address, which must be g_object_ref()'d if it will be stored @@ -45719,7 +43665,6 @@ g_object_ref()'d if it will be stored Gets the `sin6_flowinfo` field from @address, which must be an IPv6 address. - the flowinfo field @@ -45733,7 +43678,6 @@ which must be an IPv6 address. Gets @address's port. - the port for @address @@ -45748,7 +43692,6 @@ which must be an IPv6 address. Gets the `sin6_scope_id` field from @address, which must be an IPv6 address. - the scope id field @@ -45781,14 +43724,11 @@ which must be an IPv6 address. - - - - + #GInitable is implemented by objects that can fail during initialization. If an object implements this interface then @@ -45814,12 +43754,10 @@ For bindings in languages where the native constructor supports exceptions the binding could check for objects implementing %GInitable during normal construction and automatically initialize them, throwing an exception on failure. - Helper function for constructing #GInitable object. This is similar to g_object_new() but also initializes the object and returns %NULL, setting an error on failure. - a newly allocated #GObject, or %NULL on error @@ -45855,7 +43793,6 @@ and returns %NULL, setting an error on failure. Helper function for constructing #GInitable object. This is similar to g_object_new_valist() but also initializes the object and returns %NULL, setting an error on failure. - a newly allocated #GObject, or %NULL on error @@ -45887,7 +43824,6 @@ similar to g_object_newv() but also initializes the object and returns %NULL, setting an error on failure. Use g_object_new_with_properties() and g_initable_init() instead. See #GParameter for more information. - a newly allocated #GObject, or %NULL on error @@ -45953,7 +43889,6 @@ it is designed to be used via the singleton pattern, with a In this pattern, a caller would expect to be able to call g_initable_init() on the result of g_object_new(), regardless of whether it is in fact a new instance. - %TRUE if successful. If an error has occurred, this function will return %FALSE and set @error appropriately if present. @@ -46009,7 +43944,6 @@ it is designed to be used via the singleton pattern, with a In this pattern, a caller would expect to be able to call g_initable_init() on the result of g_object_new(), regardless of whether it is in fact a new instance. - %TRUE if successful. If an error has occurred, this function will return %FALSE and set @error appropriately if present. @@ -46030,14 +43964,12 @@ instance. Provides an interface for initializing object such that initialization may fail. - The parent interface. - %TRUE if successful. If an error has occurred, this function will return %FALSE and set @error appropriately if present. @@ -46076,7 +44008,6 @@ this array, which may be zero. Flags relevant to this message will be returned in @flags. For example, `MSG_EOR` or `MSG_TRUNC`. - return location for a #GSocketAddress, or %NULL @@ -46128,7 +44059,6 @@ See the documentation for #GIOStream for details of thread safety of streaming APIs. All of these functions have async variants too. - Requests an asynchronous closes of the stream, releasing resources related to it. When the operation is finished @callback will be called. @@ -46140,7 +44070,6 @@ For behaviour details see g_input_stream_close(). The asynchronous methods have a default fallback that uses threads to implement asynchronicity, so they are optional for inheriting classes. However, if you override one you must override all. - @@ -46169,7 +44098,6 @@ override one you must override all. Finishes closing a stream asynchronously, started from g_input_stream_close_async(). - %TRUE if the stream was closed successfully. @@ -46186,7 +44114,6 @@ override one you must override all. - @@ -46223,7 +44150,6 @@ priority is %G_PRIORITY_DEFAULT. The asynchronous methods have a default fallback that uses threads to implement asynchronicity, so they are optional for inheriting classes. However, if you override one you must override all. - @@ -46264,7 +44190,6 @@ of the request. Finishes an asynchronous stream read operation. - number of bytes read in, or -1 on error, or 0 on end of file. @@ -46281,7 +44206,6 @@ of the request. - @@ -46315,7 +44239,6 @@ triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. If an operation was partially finished when the operation was cancelled the partial result will be returned, without an error. - Number of bytes skipped, or -1 on error @@ -46359,7 +44282,6 @@ Default priority is %G_PRIORITY_DEFAULT. The asynchronous methods have a default fallback that uses threads to implement asynchronicity, so they are optional for inheriting classes. However, if you override one, you must override all. - @@ -46392,7 +44314,6 @@ However, if you override one, you must override all. Finishes a stream skip operation. - the size of the bytes skipped, or `-1` on error. @@ -46410,7 +44331,6 @@ However, if you override one, you must override all. Clears the pending flag on @stream. - @@ -46445,7 +44365,6 @@ triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. Cancelling a close will still leave the stream closed, but some streams can use a faster close that doesn't block to e.g. check errors. - %TRUE on success, %FALSE on failure @@ -46472,7 +44391,6 @@ For behaviour details see g_input_stream_close(). The asynchronous methods have a default fallback that uses threads to implement asynchronicity, so they are optional for inheriting classes. However, if you override one you must override all. - @@ -46501,7 +44419,6 @@ override one you must override all. Finishes closing a stream asynchronously, started from g_input_stream_close_async(). - %TRUE if the stream was closed successfully. @@ -46519,7 +44436,6 @@ override one you must override all. Checks if an input stream has pending actions. - %TRUE if @stream has pending actions. @@ -46533,7 +44449,6 @@ override one you must override all. Checks if an input stream is closed. - %TRUE if the stream is closed. @@ -46567,7 +44482,6 @@ operation was partially finished when the operation was cancelled the partial result will be returned, without an error. On error -1 is returned and @error is set accordingly. - Number of bytes read, or -1 on error, or 0 on end of file. @@ -46614,7 +44528,6 @@ use #GError, if this function returns %FALSE (and sets @error) then read before the error was encountered. This functionality is only available from C. If you need it from another language then you must write your own loop around g_input_stream_read(). - %TRUE on success, %FALSE if there was an error @@ -46656,7 +44569,6 @@ Call g_input_stream_read_all_finish() to collect the result. Any outstanding I/O request with higher priority (lower numerical value) will be executed before an outstanding request with lower priority. Default priority is %G_PRIORITY_DEFAULT. - @@ -46704,7 +44616,6 @@ use #GError, if this function returns %FALSE (and sets @error) then read before the error was encountered. This functionality is only available from C. If you need it from another language then you must write your own loop around g_input_stream_read_async(). - %TRUE on success, %FALSE if there was an error @@ -46748,7 +44659,6 @@ priority is %G_PRIORITY_DEFAULT. The asynchronous methods have a default fallback that uses threads to implement asynchronicity, so they are optional for inheriting classes. However, if you override one you must override all. - @@ -46811,7 +44721,6 @@ operation was partially finished when the operation was cancelled the partial result will be returned, without an error. On error %NULL is returned and @error is set accordingly. - a new #GBytes, or %NULL on error @@ -46853,7 +44762,6 @@ many bytes as requested. Zero is returned on end of file (or if Any outstanding I/O request with higher priority (lower numerical value) will be executed before an outstanding request with lower priority. Default priority is %G_PRIORITY_DEFAULT. - @@ -46886,7 +44794,6 @@ priority. Default priority is %G_PRIORITY_DEFAULT. Finishes an asynchronous stream read-into-#GBytes operation. - the newly-allocated #GBytes, or %NULL on error @@ -46904,7 +44811,6 @@ priority. Default priority is %G_PRIORITY_DEFAULT. Finishes an asynchronous stream read operation. - number of bytes read in, or -1 on error, or 0 on end of file. @@ -46924,7 +44830,6 @@ priority. Default priority is %G_PRIORITY_DEFAULT. Sets @stream to have actions pending. If the pending flag is already set or @stream is closed, it will return %FALSE and set @error. - %TRUE if pending was previously unset and is now set. @@ -46951,7 +44856,6 @@ triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. If an operation was partially finished when the operation was cancelled the partial result will be returned, without an error. - Number of bytes skipped, or -1 on error @@ -46995,7 +44899,6 @@ Default priority is %G_PRIORITY_DEFAULT. The asynchronous methods have a default fallback that uses threads to implement asynchronicity, so they are optional for inheriting classes. However, if you override one, you must override all. - @@ -47028,7 +44931,6 @@ However, if you override one, you must override all. Finishes a stream skip operation. - the size of the bytes skipped, or `-1` on error. @@ -47052,13 +44954,11 @@ However, if you override one, you must override all. - - @@ -47080,7 +44980,6 @@ However, if you override one, you must override all. - Number of bytes skipped, or -1 on error @@ -47103,7 +45002,6 @@ However, if you override one, you must override all. - @@ -47119,7 +45017,6 @@ However, if you override one, you must override all. - @@ -47161,7 +45058,6 @@ of the request. - number of bytes read in, or -1 on error, or 0 on end of file. @@ -47180,7 +45076,6 @@ of the request. - @@ -47214,7 +45109,6 @@ of the request. - the size of the bytes skipped, or `-1` on error. @@ -47233,7 +45127,6 @@ of the request. - @@ -47263,7 +45156,6 @@ of the request. - %TRUE if the stream was closed successfully. @@ -47282,7 +45174,6 @@ of the request. - @@ -47290,7 +45181,6 @@ of the request. - @@ -47298,7 +45188,6 @@ of the request. - @@ -47306,7 +45195,6 @@ of the request. - @@ -47314,22 +45202,18 @@ of the request. - - - - + Structure used for scatter/gather data input. You generally pass in an array of #GInputVectors and the operation will store the read data starting in the first buffer, switching to the next as needed. - Pointer to a buffer where data will be written. @@ -47340,14 +45224,12 @@ first buffer, switching to the next as needed. - - @@ -47401,14 +45283,12 @@ thread in which it is appropriate to use it depends on the particular implementation, but typically it will be from the thread that owns the [thread-default main context][g-main-context-push-thread-default] in effect at the time that the model was created. - Get the item at @position. If @position is greater than the number of items in @list, %NULL is returned. %NULL is never returned for an index that is smaller than the length of the list. See g_list_model_get_n_items(). - the object at @position. @@ -47431,7 +45311,6 @@ implementation of that interface. The item type of a #GListModel can not change during the life of the model. - the #GType of the items contained in @list. @@ -47449,7 +45328,6 @@ model. Depending on the model implementation, calling this function may be less efficient than iterating the list with increasing values for @position until g_list_model_get_item() returns %NULL. - the number of items in @list. @@ -47467,7 +45345,6 @@ items in @list, %NULL is returned. %NULL is never returned for an index that is smaller than the length of the list. See g_list_model_get_n_items(). - the item at @position. @@ -47490,7 +45367,6 @@ implementation of that interface. The item type of a #GListModel can not change during the life of the model. - the #GType of the items contained in @list. @@ -47508,7 +45384,6 @@ model. Depending on the model implementation, calling this function may be less efficient than iterating the list with increasing values for @position until g_list_model_get_item() returns %NULL. - the number of items in @list. @@ -47526,7 +45401,6 @@ items in @list, %NULL is returned. %NULL is never returned for an index that is smaller than the length of the list. See g_list_model_get_n_items(). - the object at @position. @@ -47563,7 +45437,6 @@ Stated another way: in general, it is assumed that code making a series of accesses to the model via the API, without returning to the mainloop, and without calling other code, will continue to view the same contents of the model. - @@ -47614,14 +45487,12 @@ in the model change. The virtual function table for #GListModel. - parent #GTypeInterface - the #GType of the items contained in @list. @@ -47636,7 +45507,6 @@ in the model change. - the number of items in @list. @@ -47651,7 +45521,6 @@ in the model change. - the object at @position. @@ -47675,12 +45544,10 @@ items in memory. It provides insertions, deletions, and lookups in logarithmic time with a fast path for the common case of iterating the list linearly. - Creates a new #GListStore with items of type @item_type. @item_type must be a subclass of #GObject. - a new #GListStore @@ -47699,7 +45566,6 @@ This function takes a ref on @item. Use g_list_store_splice() to append multiple items at the same time efficiently. - @@ -47721,7 +45587,6 @@ not be set, and this method will return %FALSE. If you need to compare the two items with a custom comparison function, use g_list_store_find_with_equal_func() with a custom #GEqualFunc instead. - Whether @store contains @item. If it was found, @position will be set to the position where @item occurred for the first time. @@ -47747,7 +45612,6 @@ set to the position where @item occurred for the first time. comparing them with @compare_func until the first occurrence of @item which matches. If @item was not found, then @position will not be set, and this method will return %FALSE. - Whether @store contains @item. If it was found, @position will be set to the position where @item occurred for the first time. @@ -47781,7 +45645,6 @@ This function takes a ref on @item. Use g_list_store_splice() to insert multiple items at the same time efficiently. - @@ -47809,7 +45672,6 @@ result is undefined. Usually you would approach this by only ever inserting items by way of this function. This function takes a ref on @item. - the position at which @item was inserted @@ -47839,7 +45701,6 @@ smaller than the current length of the list. Use g_list_store_splice() to remove multiple items at the same time efficiently. - @@ -47856,7 +45717,6 @@ efficiently. Removes all items from @store. - @@ -47869,7 +45729,6 @@ efficiently. Sort the items in @store according to @compare_func. - @@ -47902,7 +45761,6 @@ This function takes a ref on each item in @additions. The parameters @position and @n_removals must be correct (ie: @position + @n_removals must be less than or equal to the length of the list at the time this function is called). - @@ -47938,7 +45796,6 @@ subclasses of #GObject. - @@ -47946,12 +45803,10 @@ subclasses of #GObject. Extends the #GIcon interface and adds the ability to load icons from streams. - Loads a loadable icon. For the asynchronous version of this function, see g_loadable_icon_load_async(). - a #GInputStream to read the icon from. @@ -47981,7 +45836,6 @@ ignore. Loads an icon asynchronously. To finish this function, see g_loadable_icon_load_finish(). For the synchronous, blocking version of this function, see g_loadable_icon_load(). - @@ -48011,7 +45865,6 @@ version of this function, see g_loadable_icon_load(). Finishes an asynchronous icon load started in g_loadable_icon_load_async(). - a #GInputStream to read the icon from. @@ -48035,7 +45888,6 @@ version of this function, see g_loadable_icon_load(). Loads a loadable icon. For the asynchronous version of this function, see g_loadable_icon_load_async(). - a #GInputStream to read the icon from. @@ -48065,7 +45917,6 @@ ignore. Loads an icon asynchronously. To finish this function, see g_loadable_icon_load_finish(). For the synchronous, blocking version of this function, see g_loadable_icon_load(). - @@ -48095,7 +45946,6 @@ version of this function, see g_loadable_icon_load(). Finishes an asynchronous icon load started in g_loadable_icon_load_async(). - a #GInputStream to read the icon from. @@ -48119,14 +45969,12 @@ version of this function, see g_loadable_icon_load(). Interface for icons that can be loaded as a stream. - The parent interface. - a #GInputStream to read the icon from. @@ -48155,7 +46003,6 @@ ignore. - @@ -48186,7 +46033,6 @@ ignore. - a #GInputStream to read the icon from. @@ -48210,28 +46056,24 @@ ignore. - - - - @@ -48240,39 +46082,33 @@ ignore. Extension point for memory usage monitoring functionality. See [Extending GIO][extending-gio]. - - - - - - @@ -48285,13 +46121,11 @@ action resides. For example, "win." for window-specific actions and "app." for application-wide actions. See also g_menu_model_get_item_attribute() and g_menu_item_set_attribute(). - The menu item attribute that holds the namespace for all action names in menus that are linked from this item. - @@ -48302,25 +46136,21 @@ The icon is stored in the format returned by g_icon_serialize(). This attribute is intended only to represent 'noun' icons such as favicons for a webpage, or application icons. It should not be used for 'verbs' (ie: stock icons). - - - - @@ -48328,7 +46158,6 @@ for 'verbs' (ie: stock icons). The menu item attribute which holds the label of the item. - @@ -48336,32 +46165,27 @@ for 'verbs' (ie: stock icons). will be activated. See also g_menu_item_set_action_and_target() - - - - - @@ -48373,67 +46197,57 @@ menu will usually be shown in place of the menu item, using the item's label as a header. See also g_menu_item_set_link(). - The name of the link that associates a menu item with a submenu. See also g_menu_item_set_link(). - - - - - - - - - @@ -48445,12 +46259,10 @@ memory chunks as input for GIO streaming input operations. As of GLib 2.34, #GMemoryInputStream implements #GPollableInputStream. - Creates a new empty #GMemoryInputStream. - a new #GInputStream @@ -48458,7 +46270,6 @@ As of GLib 2.34, #GMemoryInputStream implements Creates a new #GMemoryInputStream with data from the given @bytes. - new #GInputStream read from @bytes @@ -48472,7 +46283,6 @@ As of GLib 2.34, #GMemoryInputStream implements Creates a new #GMemoryInputStream with data in memory of a given size. - new #GInputStream read from @data of @len bytes. @@ -48496,7 +46306,6 @@ As of GLib 2.34, #GMemoryInputStream implements Appends @bytes to data that can be read from the input stream. - @@ -48513,7 +46322,6 @@ As of GLib 2.34, #GMemoryInputStream implements Appends @data to data that can be read from the input stream - @@ -48546,13 +46354,11 @@ As of GLib 2.34, #GMemoryInputStream implements - - @@ -48560,7 +46366,6 @@ As of GLib 2.34, #GMemoryInputStream implements - @@ -48568,7 +46373,6 @@ As of GLib 2.34, #GMemoryInputStream implements - @@ -48576,7 +46380,6 @@ As of GLib 2.34, #GMemoryInputStream implements - @@ -48584,16 +46387,13 @@ As of GLib 2.34, #GMemoryInputStream implements - - - - + #GMemoryMonitor will monitor system memory and suggest to the application when to free memory so as to leave more room for other applications. @@ -48640,18 +46440,15 @@ monitor_low_memory (void) Don't forget to disconnect the #GMemoryMonitor::low-memory-warning signal, and unref the #GMemoryMonitor itself when exiting. - Gets a reference to the default #GMemoryMonitor for the system. - a new reference to the default #GMemoryMonitor - @@ -48682,14 +46479,12 @@ details. The virtual function table for #GMemoryMonitor. - The parent interface. - @@ -48735,7 +46530,6 @@ memory chunks as output for GIO streaming output operations. As of GLib 2.34, #GMemoryOutputStream trivially implements #GPollableOutputStream: it always polls as ready. - @@ -48780,7 +46574,6 @@ stream2 = g_memory_output_stream_new (NULL, 0, g_realloc, g_free); data = malloc (200); stream3 = g_memory_output_stream_new (data, 200, NULL, free); ]| - A newly created #GMemoryOutputStream object. @@ -48809,7 +46602,6 @@ stream3 = g_memory_output_stream_new (data, 200, NULL, free); Creates a new #GMemoryOutputStream, using g_realloc() and g_free() for memory allocation. - @@ -48819,7 +46611,6 @@ for memory allocation. Note that the returned pointer may become invalid on the next write or truncate operation on the stream. - pointer to the stream's data, or %NULL if the data has been stolen @@ -48835,7 +46626,6 @@ write or truncate operation on the stream. Returns the number of bytes from the start up to including the last byte written in the stream that has not been truncated away. - the number of bytes written to the stream @@ -48863,7 +46653,6 @@ stream and further writes will return %G_IO_ERROR_NO_SPACE. In any case, if you want the number of bytes currently written to the stream, use g_memory_output_stream_get_data_size(). - the number of bytes allocated for the data buffer @@ -48878,7 +46667,6 @@ stream, use g_memory_output_stream_get_data_size(). Returns data from the @ostream as a #GBytes. @ostream must be closed before calling this function. - the stream's data @@ -48897,7 +46685,6 @@ freed using the free function set in @ostream's #GMemoryOutputStream:destroy-function property. @ostream must be closed before calling this function. - the stream's data, or %NULL if it has previously been stolen @@ -48938,13 +46725,11 @@ freed using the free function set in @ostream's - - @@ -48952,7 +46737,6 @@ freed using the free function set in @ostream's - @@ -48960,7 +46744,6 @@ freed using the free function set in @ostream's - @@ -48968,7 +46751,6 @@ freed using the free function set in @ostream's - @@ -48976,16 +46758,13 @@ freed using the free function set in @ostream's - - - - + #GMenu is a simple implementation of #GMenuModel. You populate a #GMenu by adding #GMenuItem instances to it. @@ -48999,7 +46778,6 @@ g_menu_insert_submenu(). Creates a new #GMenu. The new menu has no items. - a new #GMenu @@ -49009,7 +46787,6 @@ The new menu has no items. Convenience function for appending a normal menu item to the end of @menu. Combine g_menu_item_new() and g_menu_insert_item() for a more flexible alternative. - @@ -49032,7 +46809,6 @@ flexible alternative. Appends @item to the end of @menu. See g_menu_insert_item() for more information. - @@ -49051,7 +46827,6 @@ See g_menu_insert_item() for more information. Convenience function for appending a section menu item to the end of @menu. Combine g_menu_item_new_section() and g_menu_insert_item() for a more flexible alternative. - @@ -49074,7 +46849,6 @@ more flexible alternative. Convenience function for appending a submenu menu item to the end of @menu. Combine g_menu_item_new_submenu() and g_menu_insert_item() for a more flexible alternative. - @@ -49102,7 +46876,6 @@ longer be used. This function causes g_menu_model_is_mutable() to begin returning %FALSE, which has some positive performance implications. - @@ -49117,7 +46890,6 @@ This function causes g_menu_model_is_mutable() to begin returning Convenience function for inserting a normal menu item into @menu. Combine g_menu_item_new() and g_menu_insert_item() for a more flexible alternative. - @@ -49158,7 +46930,6 @@ There are many convenience functions to take care of common cases. See g_menu_insert(), g_menu_insert_section() and g_menu_insert_submenu() as well as "prepend" and "append" variants of each of these functions. - @@ -49181,7 +46952,6 @@ each of these functions. Convenience function for inserting a section menu item into @menu. Combine g_menu_item_new_section() and g_menu_insert_item() for a more flexible alternative. - @@ -49208,7 +46978,6 @@ flexible alternative. Convenience function for inserting a submenu menu item into @menu. Combine g_menu_item_new_submenu() and g_menu_insert_item() for a more flexible alternative. - @@ -49235,7 +47004,6 @@ flexible alternative. Convenience function for prepending a normal menu item to the start of @menu. Combine g_menu_item_new() and g_menu_insert_item() for a more flexible alternative. - @@ -49258,7 +47026,6 @@ flexible alternative. Prepends @item to the start of @menu. See g_menu_insert_item() for more information. - @@ -49277,7 +47044,6 @@ See g_menu_insert_item() for more information. Convenience function for prepending a section menu item to the start of @menu. Combine g_menu_item_new_section() and g_menu_insert_item() for a more flexible alternative. - @@ -49300,7 +47066,6 @@ a more flexible alternative. Convenience function for prepending a submenu menu item to the start of @menu. Combine g_menu_item_new_submenu() and g_menu_insert_item() for a more flexible alternative. - @@ -49330,7 +47095,6 @@ less than the number of items in the menu. It is not possible to remove items by identity since items are added to the menu simply by copying their links and attributes (ie: identity of the item itself is not preserved). - @@ -49347,7 +47111,6 @@ identity of the item itself is not preserved). Removes all items in the menu. - @@ -49362,7 +47125,6 @@ identity of the item itself is not preserved). #GMenuAttributeIter is an opaque structure type. You must access it using the functions below. - This function combines g_menu_attribute_iter_next() with g_menu_attribute_iter_get_name() and g_menu_attribute_iter_get_value(). @@ -49379,7 +47141,6 @@ return the same values again. The value returned in @name remains valid for as long as the iterator remains at the current position. The value returned in @value must be unreffed using g_variant_unref() when it is no longer in use. - %TRUE on success, or %FALSE if there is no additional attribute @@ -49405,7 +47166,6 @@ be unreffed using g_variant_unref() when it is no longer in use. a string. The iterator is not advanced. - the name of the attribute @@ -49433,7 +47193,6 @@ return the same values again. The value returned in @name remains valid for as long as the iterator remains at the current position. The value returned in @value must be unreffed using g_variant_unref() when it is no longer in use. - %TRUE on success, or %FALSE if there is no additional attribute @@ -49458,7 +47217,6 @@ be unreffed using g_variant_unref() when it is no longer in use. Gets the value of the attribute at the current iterator position. The iterator is not advanced. - the value of the current attribute @@ -49480,7 +47238,6 @@ attributes. You must call this function when you first acquire the iterator to advance it to the first attribute (and determine if the first attribute exists at all). - %TRUE on success, or %FALSE when there are no more attributes @@ -49500,13 +47257,11 @@ attribute exists at all). - - %TRUE on success, or %FALSE if there is no additional attribute @@ -49529,9 +47284,7 @@ attribute exists at all). - - - + #GMenuItem is an opaque structure type. You must access it using the functions below. @@ -49544,7 +47297,6 @@ new item. If @detailed_action is non-%NULL it is used to set the "action" and possibly the "target" attribute of the new item. See g_menu_item_set_detailed_action() for more information. - a new #GMenuItem @@ -49566,7 +47318,6 @@ g_menu_item_set_detailed_action() for more information. @item_index must be valid (ie: be sure to call g_menu_model_get_n_items() first). - a new #GMenuItem. @@ -49643,7 +47394,6 @@ purpose of understanding what is really going on). </item> </menu> ]| - a new #GMenuItem @@ -49664,7 +47414,6 @@ purpose of understanding what is really going on). This is a convenience API around g_menu_item_new() and g_menu_item_set_submenu(). - a new #GMenuItem @@ -49690,7 +47439,6 @@ value into the positional parameters and %TRUE is returned. If the attribute does not exist, or it does exist but has the wrong type, then the positional parameters are ignored and %FALSE is returned. - %TRUE if the named attribute was found with the expected type @@ -49721,8 +47469,7 @@ returned. If @expected_type is specified and the attribute does not have this type, %NULL is returned. %NULL is also returned if the attribute simply does not exist. - - + the attribute value, or %NULL @@ -49743,8 +47490,7 @@ simply does not exist. Queries the named @link on @menu_item. - - + the link, or %NULL @@ -49779,7 +47525,6 @@ works with string-typed targets. See also g_menu_item_set_action_and_target_value() for a description of the semantics of the action and target attributes. - @@ -49839,7 +47584,6 @@ state is equal to the value of the @target property. See g_menu_item_set_action_and_target() or g_menu_item_set_detailed_action() for two equivalent calls that are probably more convenient for most uses. - @@ -49876,7 +47620,6 @@ and the named attribute is unset. See also g_menu_item_set_attribute_value() for an equivalent call that directly accepts a #GVariant. - @@ -49919,7 +47662,6 @@ the @value #GVariant is floating, it is consumed. See also g_menu_item_set_attribute() for a more convenient way to do the same. - @@ -49950,7 +47692,6 @@ slightly less convenient) alternatives. See also g_menu_item_set_action_and_target_value() for a description of the semantics of the action and target attributes. - @@ -49978,7 +47719,6 @@ menu items corresponding to verbs (eg: stock icons for 'Save' or 'Quit'). If @icon is %NULL then the icon is unset. - @@ -49998,7 +47738,6 @@ If @icon is %NULL then the icon is unset. If @label is non-%NULL it is used as the label for the menu item. If it is %NULL then the label attribute is unset. - @@ -50024,7 +47763,6 @@ is no guarantee that clients will be able to make sense of them. Link types are restricted to lowercase characters, numbers and '-'. Furthermore, the names must begin with a lowercase character, must not end with a '-', and must not contain consecutive dashes. - @@ -50051,7 +47789,6 @@ exactly as it sounds: the items from @section become a direct part of the menu that @menu_item is added to. See g_menu_item_new_section() for more information about what it means for a menu item to be a section. - @@ -50074,7 +47811,6 @@ link is unset. The effect of having one menu appear as a submenu of another is exactly as it sounds. - @@ -50093,7 +47829,6 @@ exactly as it sounds. #GMenuLinkIter is an opaque structure type. You must access it using the functions below. - This function combines g_menu_link_iter_next() with g_menu_link_iter_get_name() and g_menu_link_iter_get_value(). @@ -50109,7 +47844,6 @@ same values again. The value returned in @out_link remains valid for as long as the iterator remains at the current position. The value returned in @value must be unreffed using g_object_unref() when it is no longer in use. - %TRUE on success, or %FALSE if there is no additional link @@ -50133,7 +47867,6 @@ be unreffed using g_object_unref() when it is no longer in use. Gets the name of the link at the current iterator position. The iterator is not advanced. - the type of the link @@ -50160,7 +47893,6 @@ same values again. The value returned in @out_link remains valid for as long as the iterator remains at the current position. The value returned in @value must be unreffed using g_object_unref() when it is no longer in use. - %TRUE on success, or %FALSE if there is no additional link @@ -50184,7 +47916,6 @@ be unreffed using g_object_unref() when it is no longer in use. Gets the linked #GMenuModel at the current iterator position. The iterator is not advanced. - the #GMenuModel that is linked to @@ -50205,7 +47936,6 @@ link. You must call this function when you first acquire the iterator to advance it to the first link (and determine if the first link exists at all). - %TRUE on success, or %FALSE when there are no more links @@ -50225,13 +47955,11 @@ at all). - - %TRUE on success, or %FALSE if there is no additional link @@ -50253,9 +47981,7 @@ at all). - - - + #GMenuModel represents the contents of a menu -- an ordered list of menu items. The items are associated with actions, which can be @@ -50370,7 +48096,6 @@ have a target value. Selecting that menu item will result in activation of the action with the target value as the parameter. The menu item should be rendered as "selected" when the state of the action is equal to the target value of the menu item. - Queries the item at position @item_index in @model for the attribute specified by @attribute. @@ -50383,8 +48108,7 @@ expected type is unspecified) then the value is returned. If the attribute does not exist, or does not match the expected type then %NULL is returned. - - + the value of the attribute @@ -50410,7 +48134,6 @@ then %NULL is returned. Gets all the attributes associated with the item in the menu model. - @@ -50438,8 +48161,7 @@ specified by @link. If the link exists, the linked #GMenuModel is returned. If the link does not exist, %NULL is returned. - - + the linked #GMenuModel, or %NULL @@ -50460,7 +48182,6 @@ does not exist, %NULL is returned. Gets all the links associated with the item in the menu model. - @@ -50484,7 +48205,6 @@ does not exist, %NULL is returned. Query the number of items in @model. - the number of items @@ -50501,7 +48221,6 @@ does not exist, %NULL is returned. An immutable #GMenuModel will never emit the #GMenuModel::items-changed signal. Consumers of the model may make optimisations accordingly. - %TRUE if the model is mutable (ie: "items-changed" may be emitted). @@ -50519,7 +48238,6 @@ signal. Consumers of the model may make optimisations accordingly. the item at position @item_index in @model. You must free the iterator with g_object_unref() when you are done. - a new #GMenuAttributeIter @@ -50540,7 +48258,6 @@ You must free the iterator with g_object_unref() when you are done. position @item_index in @model. You must free the iterator with g_object_unref() when you are done. - a new #GMenuLinkIter @@ -50573,7 +48290,6 @@ g_variant_get(), followed by a g_variant_unref(). As such, @format_string must make a complete copy of the data (since the #GVariant may go away after the call to g_variant_unref()). In particular, no '&' characters are allowed in @format_string. - %TRUE if the named attribute was found with the expected type @@ -50614,8 +48330,7 @@ expected type is unspecified) then the value is returned. If the attribute does not exist, or does not match the expected type then %NULL is returned. - - + the value of the attribute @@ -50645,8 +48360,7 @@ specified by @link. If the link exists, the linked #GMenuModel is returned. If the link does not exist, %NULL is returned. - - + the linked #GMenuModel, or %NULL @@ -50667,7 +48381,6 @@ does not exist, %NULL is returned. Query the number of items in @model. - the number of items @@ -50684,7 +48397,6 @@ does not exist, %NULL is returned. An immutable #GMenuModel will never emit the #GMenuModel::items-changed signal. Consumers of the model may make optimisations accordingly. - %TRUE if the model is mutable (ie: "items-changed" may be emitted). @@ -50713,7 +48425,6 @@ The implementation must dispatch this call directly from a mainloop entry and not in response to calls -- particularly those from the #GMenuModel API. Said another way: the menu must not change while user code is running without returning to the mainloop. - @@ -50741,7 +48452,6 @@ user code is running without returning to the mainloop. the item at position @item_index in @model. You must free the iterator with g_object_unref() when you are done. - a new #GMenuAttributeIter @@ -50762,7 +48472,6 @@ You must free the iterator with g_object_unref() when you are done. position @item_index in @model. You must free the iterator with g_object_unref() when you are done. - a new #GMenuLinkIter @@ -50825,13 +48534,11 @@ reported. The signal is emitted after the modification. - - %TRUE if the model is mutable (ie: "items-changed" may be emitted). @@ -50847,7 +48554,6 @@ reported. The signal is emitted after the modification. - the number of items @@ -50862,7 +48568,6 @@ reported. The signal is emitted after the modification. - @@ -50887,7 +48592,6 @@ reported. The signal is emitted after the modification. - a new #GMenuAttributeIter @@ -50906,8 +48610,7 @@ reported. The signal is emitted after the modification. - - + the value of the attribute @@ -50934,7 +48637,6 @@ reported. The signal is emitted after the modification. - @@ -50959,7 +48661,6 @@ reported. The signal is emitted after the modification. - a new #GMenuLinkIter @@ -50978,8 +48679,7 @@ reported. The signal is emitted after the modification. - - + the linked #GMenuModel, or %NULL @@ -51000,9 +48700,7 @@ reported. The signal is emitted after the modification. - - - + The #GMount interface represents user-visible mounts. Note, when porting from GnomeVFS, #GMount is the moral equivalent of #GnomeVFSVolume. @@ -51023,10 +48721,8 @@ callback should then call g_mount_unmount_with_operation_finish() with the #GMou and the #GAsyncResult data to see if the operation was completed successfully. If an @error is present when g_mount_unmount_with_operation_finish() is called, then it will be filled with any error information. - Checks if @mount can be ejected. - %TRUE if the @mount can be ejected. @@ -51040,7 +48736,6 @@ is called, then it will be filled with any error information. Checks if @mount can be unmounted. - %TRUE if the @mount can be unmounted. @@ -51053,7 +48748,6 @@ is called, then it will be filled with any error information. - @@ -51068,7 +48762,6 @@ is called, then it will be filled with any error information. finished by calling g_mount_eject_finish() with the @mount and #GAsyncResult data returned in the @callback. Use g_mount_eject_with_operation() instead. - @@ -51099,7 +48792,6 @@ and #GAsyncResult data returned in the @callback. Finishes ejecting a mount. If any errors occurred during the operation, @error will be set to contain the errors and %FALSE will be returned. Use g_mount_eject_with_operation_finish() instead. - %TRUE if the mount was successfully ejected. %FALSE otherwise. @@ -51119,7 +48811,6 @@ and #GAsyncResult data returned in the @callback. Ejects a mount. This is an asynchronous operation, and is finished by calling g_mount_eject_with_operation_finish() with the @mount and #GAsyncResult data returned in the @callback. - @@ -51154,7 +48845,6 @@ and #GAsyncResult data returned in the @callback. Finishes ejecting a mount. If any errors occurred during the operation, @error will be set to contain the errors and %FALSE will be returned. - %TRUE if the mount was successfully ejected. %FALSE otherwise. @@ -51174,7 +48864,6 @@ and #GAsyncResult data returned in the @callback. Gets the default location of @mount. The default location of the given @mount is a path that reflects the main entry point for the user (e.g. the home directory, or the root of the volume). - a #GFile. The returned object should be unreffed with @@ -51193,7 +48882,6 @@ the home directory, or the root of the volume). This is a convenience method for getting the #GVolume and then using that object to get the #GDrive. - a #GDrive or %NULL if @mount is not associated with a volume or a drive. @@ -51210,7 +48898,6 @@ using that object to get the #GDrive. Gets the icon for @mount. - a #GIcon. The returned object should be unreffed with @@ -51226,7 +48913,6 @@ using that object to get the #GDrive. Gets the name of @mount. - the name for the given @mount. The returned string should be freed with g_free() @@ -51242,7 +48928,6 @@ using that object to get the #GDrive. Gets the root directory on @mount. - a #GFile. The returned object should be unreffed with @@ -51258,7 +48943,6 @@ using that object to get the #GDrive. Gets the sort key for @mount, if any. - Sorting key for @mount or %NULL if no such key is available. @@ -51272,7 +48956,6 @@ using that object to get the #GDrive. Gets the symbolic icon for @mount. - a #GIcon. The returned object should be unreffed with @@ -51291,7 +48974,6 @@ using that object to get the #GDrive. the file system UUID for the mount in question and should be considered an opaque string. Returns %NULL if there is no UUID available. - the UUID for @mount or %NULL if no UUID can be computed. @@ -51308,7 +48990,6 @@ available. Gets the volume for the @mount. - a #GVolume or %NULL if @mount is not associated with a volume. @@ -51335,7 +49016,6 @@ This is an asynchronous operation (see g_mount_guess_content_type_sync() for the synchronous version), and is finished by calling g_mount_guess_content_type_finish() with the @mount and #GAsyncResult data returned in the @callback. - @@ -51369,7 +49049,6 @@ during the operation, @error will be set to contain the errors and %FALSE will be returned. In particular, you may get an %G_IO_ERROR_NOT_SUPPORTED if the mount does not support content guessing. - a %NULL-terminated array of content types or %NULL on error. Caller should free this array with g_strfreev() when done with it. @@ -51398,7 +49077,6 @@ specification for more on x-content types. This is a synchronous operation and as such may block doing IO; see g_mount_guess_content_type() for the asynchronous version. - a %NULL-terminated array of content types or %NULL on error. Caller should free this array with g_strfreev() when done with it. @@ -51423,7 +49101,6 @@ see g_mount_guess_content_type() for the asynchronous version. - @@ -51443,7 +49120,6 @@ of the volume has been changed, as these may need a remount to take affect. While this is semantically equivalent with unmounting and then remounting not all backends might need to actually be unmounted. - @@ -51478,7 +49154,6 @@ unmounted. Finishes remounting a mount. If any errors occurred during the operation, @error will be set to contain the errors and %FALSE will be returned. - %TRUE if the mount was successfully remounted. %FALSE otherwise. @@ -51499,7 +49174,6 @@ unmounted. finished by calling g_mount_unmount_finish() with the @mount and #GAsyncResult data returned in the @callback. Use g_mount_unmount_with_operation() instead. - @@ -51530,7 +49204,6 @@ and #GAsyncResult data returned in the @callback. Finishes unmounting a mount. If any errors occurred during the operation, @error will be set to contain the errors and %FALSE will be returned. Use g_mount_unmount_with_operation_finish() instead. - %TRUE if the mount was successfully unmounted. %FALSE otherwise. @@ -51550,7 +49223,6 @@ and #GAsyncResult data returned in the @callback. Unmounts a mount. This is an asynchronous operation, and is finished by calling g_mount_unmount_with_operation_finish() with the @mount and #GAsyncResult data returned in the @callback. - @@ -51585,7 +49257,6 @@ and #GAsyncResult data returned in the @callback. Finishes unmounting a mount. If any errors occurred during the operation, @error will be set to contain the errors and %FALSE will be returned. - %TRUE if the mount was successfully unmounted. %FALSE otherwise. @@ -51602,7 +49273,6 @@ and #GAsyncResult data returned in the @callback. - @@ -51614,7 +49284,6 @@ and #GAsyncResult data returned in the @callback. Checks if @mount can be ejected. - %TRUE if the @mount can be ejected. @@ -51628,7 +49297,6 @@ and #GAsyncResult data returned in the @callback. Checks if @mount can be unmounted. - %TRUE if the @mount can be unmounted. @@ -51645,7 +49313,6 @@ and #GAsyncResult data returned in the @callback. finished by calling g_mount_eject_finish() with the @mount and #GAsyncResult data returned in the @callback. Use g_mount_eject_with_operation() instead. - @@ -51676,7 +49343,6 @@ and #GAsyncResult data returned in the @callback. Finishes ejecting a mount. If any errors occurred during the operation, @error will be set to contain the errors and %FALSE will be returned. Use g_mount_eject_with_operation_finish() instead. - %TRUE if the mount was successfully ejected. %FALSE otherwise. @@ -51696,7 +49362,6 @@ and #GAsyncResult data returned in the @callback. Ejects a mount. This is an asynchronous operation, and is finished by calling g_mount_eject_with_operation_finish() with the @mount and #GAsyncResult data returned in the @callback. - @@ -51731,7 +49396,6 @@ and #GAsyncResult data returned in the @callback. Finishes ejecting a mount. If any errors occurred during the operation, @error will be set to contain the errors and %FALSE will be returned. - %TRUE if the mount was successfully ejected. %FALSE otherwise. @@ -51751,7 +49415,6 @@ and #GAsyncResult data returned in the @callback. Gets the default location of @mount. The default location of the given @mount is a path that reflects the main entry point for the user (e.g. the home directory, or the root of the volume). - a #GFile. The returned object should be unreffed with @@ -51770,7 +49433,6 @@ the home directory, or the root of the volume). This is a convenience method for getting the #GVolume and then using that object to get the #GDrive. - a #GDrive or %NULL if @mount is not associated with a volume or a drive. @@ -51787,7 +49449,6 @@ using that object to get the #GDrive. Gets the icon for @mount. - a #GIcon. The returned object should be unreffed with @@ -51803,7 +49464,6 @@ using that object to get the #GDrive. Gets the name of @mount. - the name for the given @mount. The returned string should be freed with g_free() @@ -51819,7 +49479,6 @@ using that object to get the #GDrive. Gets the root directory on @mount. - a #GFile. The returned object should be unreffed with @@ -51835,7 +49494,6 @@ using that object to get the #GDrive. Gets the sort key for @mount, if any. - Sorting key for @mount or %NULL if no such key is available. @@ -51849,7 +49507,6 @@ using that object to get the #GDrive. Gets the symbolic icon for @mount. - a #GIcon. The returned object should be unreffed with @@ -51868,7 +49525,6 @@ using that object to get the #GDrive. the file system UUID for the mount in question and should be considered an opaque string. Returns %NULL if there is no UUID available. - the UUID for @mount or %NULL if no UUID can be computed. @@ -51885,7 +49541,6 @@ available. Gets the volume for the @mount. - a #GVolume or %NULL if @mount is not associated with a volume. @@ -51912,7 +49567,6 @@ This is an asynchronous operation (see g_mount_guess_content_type_sync() for the synchronous version), and is finished by calling g_mount_guess_content_type_finish() with the @mount and #GAsyncResult data returned in the @callback. - @@ -51946,7 +49600,6 @@ during the operation, @error will be set to contain the errors and %FALSE will be returned. In particular, you may get an %G_IO_ERROR_NOT_SUPPORTED if the mount does not support content guessing. - a %NULL-terminated array of content types or %NULL on error. Caller should free this array with g_strfreev() when done with it. @@ -51975,7 +49628,6 @@ specification for more on x-content types. This is a synchronous operation and as such may block doing IO; see g_mount_guess_content_type() for the asynchronous version. - a %NULL-terminated array of content types or %NULL on error. Caller should free this array with g_strfreev() when done with it. @@ -52023,7 +49675,6 @@ root) that would shadow the original mount. The proxy monitor in GVfs 2.26 and later, automatically creates and manage shadow mounts (and shadows the underlying mount) if the activation root on a #GVolume is set. - %TRUE if @mount is shadowed. @@ -52045,7 +49696,6 @@ of the volume has been changed, as these may need a remount to take affect. While this is semantically equivalent with unmounting and then remounting not all backends might need to actually be unmounted. - @@ -52080,7 +49730,6 @@ unmounted. Finishes remounting a mount. If any errors occurred during the operation, @error will be set to contain the errors and %FALSE will be returned. - %TRUE if the mount was successfully remounted. %FALSE otherwise. @@ -52101,7 +49750,6 @@ unmounted. #GVolumeMonitor implementations when creating a shadow mount for @mount, see g_mount_is_shadowed() for more information. The caller will need to emit the #GMount::changed signal on @mount manually. - @@ -52117,7 +49765,6 @@ will need to emit the #GMount::changed signal on @mount manually. finished by calling g_mount_unmount_finish() with the @mount and #GAsyncResult data returned in the @callback. Use g_mount_unmount_with_operation() instead. - @@ -52148,7 +49795,6 @@ and #GAsyncResult data returned in the @callback. Finishes unmounting a mount. If any errors occurred during the operation, @error will be set to contain the errors and %FALSE will be returned. Use g_mount_unmount_with_operation_finish() instead. - %TRUE if the mount was successfully unmounted. %FALSE otherwise. @@ -52168,7 +49814,6 @@ and #GAsyncResult data returned in the @callback. Unmounts a mount. This is an asynchronous operation, and is finished by calling g_mount_unmount_with_operation_finish() with the @mount and #GAsyncResult data returned in the @callback. - @@ -52203,7 +49848,6 @@ and #GAsyncResult data returned in the @callback. Finishes unmounting a mount. If any errors occurred during the operation, @error will be set to contain the errors and %FALSE will be returned. - %TRUE if the mount was successfully unmounted. %FALSE otherwise. @@ -52224,7 +49868,6 @@ and #GAsyncResult data returned in the @callback. #GVolumeMonitor implementations when destroying a shadow mount for @mount, see g_mount_is_shadowed() for more information. The caller will need to emit the #GMount::changed signal on @mount manually. - @@ -52263,14 +49906,12 @@ finalized. Interface for implementing operations for mounts. - The parent interface. - @@ -52283,7 +49924,6 @@ finalized. - @@ -52296,7 +49936,6 @@ finalized. - a #GFile. The returned object should be unreffed with @@ -52313,7 +49952,6 @@ finalized. - the name for the given @mount. The returned string should be freed with g_free() @@ -52330,7 +49968,6 @@ finalized. - a #GIcon. The returned object should be unreffed with @@ -52347,7 +49984,6 @@ finalized. - the UUID for @mount or %NULL if no UUID can be computed. @@ -52365,7 +50001,6 @@ finalized. - a #GVolume or %NULL if @mount is not associated with a volume. @@ -52383,7 +50018,6 @@ finalized. - a #GDrive or %NULL if @mount is not associated with a volume or a drive. @@ -52401,7 +50035,6 @@ finalized. - %TRUE if the @mount can be unmounted. @@ -52416,7 +50049,6 @@ finalized. - %TRUE if the @mount can be ejected. @@ -52431,7 +50063,6 @@ finalized. - @@ -52461,7 +50092,6 @@ finalized. - %TRUE if the mount was successfully unmounted. %FALSE otherwise. @@ -52480,7 +50110,6 @@ finalized. - @@ -52510,7 +50139,6 @@ finalized. - %TRUE if the mount was successfully ejected. %FALSE otherwise. @@ -52529,7 +50157,6 @@ finalized. - @@ -52564,7 +50191,6 @@ finalized. - %TRUE if the mount was successfully remounted. %FALSE otherwise. @@ -52583,7 +50209,6 @@ finalized. - @@ -52614,7 +50239,6 @@ finalized. - a %NULL-terminated array of content types or %NULL on error. Caller should free this array with g_strfreev() when done with it. @@ -52636,7 +50260,6 @@ finalized. - a %NULL-terminated array of content types or %NULL on error. Caller should free this array with g_strfreev() when done with it. @@ -52663,7 +50286,6 @@ finalized. - @@ -52676,7 +50298,6 @@ finalized. - @@ -52711,7 +50332,6 @@ finalized. - %TRUE if the mount was successfully unmounted. %FALSE otherwise. @@ -52730,7 +50350,6 @@ finalized. - @@ -52765,7 +50384,6 @@ finalized. - %TRUE if the mount was successfully ejected. %FALSE otherwise. @@ -52784,7 +50402,6 @@ finalized. - a #GFile. The returned object should be unreffed with @@ -52801,7 +50418,6 @@ finalized. - Sorting key for @mount or %NULL if no such key is available. @@ -52816,7 +50432,6 @@ finalized. - a #GIcon. The returned object should be unreffed with @@ -52860,17 +50475,14 @@ The term ‘TCRYPT’ is used to mean ‘compatible with TrueCryp encrypting file containers, partitions or whole disks, typically used with Windows. [VeraCrypt](https://www.veracrypt.fr/) is a maintained fork of TrueCrypt with various improvements and auditing fixes. - Creates a new mount operation. - a #GMountOperation. - @@ -52881,7 +50493,6 @@ improvements and auditing fixes. - @@ -52905,7 +50516,6 @@ improvements and auditing fixes. Virtual implementation of #GMountOperation::ask-question. - @@ -52929,7 +50539,6 @@ improvements and auditing fixes. Emits the #GMountOperation::reply signal. - @@ -52946,7 +50555,6 @@ improvements and auditing fixes. Virtual implementation of #GMountOperation::show-processes. - @@ -52976,7 +50584,6 @@ improvements and auditing fixes. - @@ -52998,7 +50605,6 @@ improvements and auditing fixes. Check to see whether the mount operation is being used for an anonymous user. - %TRUE if mount operation is anonymous. @@ -53012,7 +50618,6 @@ for an anonymous user. Gets a choice from the mount operation. - an integer containing an index of the user's choice from the choice's list, or `0`. @@ -53027,8 +50632,7 @@ the choice's list, or `0`. Gets the domain of the mount operation. - - + a string set to the domain. @@ -53042,7 +50646,6 @@ the choice's list, or `0`. Check to see whether the mount operation is being used for a TCRYPT hidden volume. - %TRUE if mount operation is for hidden volume. @@ -53057,7 +50660,6 @@ for a TCRYPT hidden volume. Check to see whether the mount operation is being used for a TCRYPT system volume. - %TRUE if mount operation is for system volume. @@ -53071,8 +50673,7 @@ for a TCRYPT system volume. Gets a password from the mount operation. - - + a string containing the password within @op. @@ -53085,7 +50686,6 @@ for a TCRYPT system volume. Gets the state of saving passwords for the mount operation. - a #GPasswordSave flag. @@ -53099,7 +50699,6 @@ for a TCRYPT system volume. Gets a PIM from the mount operation. - The VeraCrypt PIM within @op. @@ -53113,8 +50712,7 @@ for a TCRYPT system volume. Get the user name from the mount operation. - - + a string containing the user name. @@ -53127,7 +50725,6 @@ for a TCRYPT system volume. Emits the #GMountOperation::reply signal. - @@ -53144,7 +50741,6 @@ for a TCRYPT system volume. Sets the mount operation to use an anonymous user if @anonymous is %TRUE. - @@ -53161,7 +50757,6 @@ for a TCRYPT system volume. Sets a default choice for the mount operation. - @@ -53178,7 +50773,6 @@ for a TCRYPT system volume. Sets the mount operation's domain. - @@ -53187,7 +50781,7 @@ for a TCRYPT system volume. a #GMountOperation. - + the domain to set. @@ -53195,7 +50789,6 @@ for a TCRYPT system volume. Sets the mount operation to use a hidden volume if @hidden_volume is %TRUE. - @@ -53212,7 +50805,6 @@ for a TCRYPT system volume. Sets the mount operation to use a system volume if @system_volume is %TRUE. - @@ -53229,7 +50821,6 @@ for a TCRYPT system volume. Sets the mount operation's password to @password. - @@ -53238,7 +50829,7 @@ for a TCRYPT system volume. a #GMountOperation. - + password to set. @@ -53246,7 +50837,6 @@ for a TCRYPT system volume. Sets the state of saving passwords for the mount operation. - @@ -53263,7 +50853,6 @@ for a TCRYPT system volume. Sets the mount operation's PIM to @pim. - @@ -53280,7 +50869,6 @@ for a TCRYPT system volume. Sets the user name within @op to @username. - @@ -53289,7 +50877,7 @@ for a TCRYPT system volume. a #GMountOperation. - + input username. @@ -53495,13 +51083,11 @@ primary text in a #GtkMessageDialog. - - @@ -53526,7 +51112,6 @@ primary text in a #GtkMessageDialog. - @@ -53551,7 +51136,6 @@ primary text in a #GtkMessageDialog. - @@ -53569,7 +51153,6 @@ primary text in a #GtkMessageDialog. - @@ -53582,7 +51165,6 @@ primary text in a #GtkMessageDialog. - @@ -53614,7 +51196,6 @@ primary text in a #GtkMessageDialog. - @@ -53636,7 +51217,6 @@ primary text in a #GtkMessageDialog. - @@ -53644,7 +51224,6 @@ primary text in a #GtkMessageDialog. - @@ -53652,7 +51231,6 @@ primary text in a #GtkMessageDialog. - @@ -53660,7 +51238,6 @@ primary text in a #GtkMessageDialog. - @@ -53668,7 +51245,6 @@ primary text in a #GtkMessageDialog. - @@ -53676,7 +51252,6 @@ primary text in a #GtkMessageDialog. - @@ -53684,7 +51259,6 @@ primary text in a #GtkMessageDialog. - @@ -53692,7 +51266,6 @@ primary text in a #GtkMessageDialog. - @@ -53700,16 +51273,13 @@ primary text in a #GtkMessageDialog. - - - - + #GMountOperationResult is returned as a result when a request for information is send by the mounting operation. @@ -53737,67 +51307,57 @@ information is send by the mounting operation. - - - - - - - - - - @@ -53806,39 +51366,33 @@ information is send by the mounting operation. Extension point for network status monitoring functionality. See [Extending GIO][extending-gio]. - - - - - - @@ -53846,11 +51400,9 @@ See [Extending GIO][extending-gio]. A socket address of some unknown native type. - Creates a new #GNativeSocketAddress for @native and @len. - a new #GNativeSocketAddress @@ -53874,28 +51426,22 @@ See [Extending GIO][extending-gio]. - - - - + - - - @@ -53921,7 +51467,6 @@ alive for too long. See #GSocketConnectable for an example of using the connectable interface. - Creates a new #GSocketConnectable for connecting to the given @@ -53932,7 +51477,6 @@ Note that depending on the configuration of the machine, a only, or to both IPv4 and IPv6; use g_network_address_new_loopback() to create a #GNetworkAddress that is guaranteed to resolve to both addresses. - the new #GNetworkAddress @@ -53961,7 +51505,6 @@ resolving `localhost`, and an IPv6 address for `localhost6`. g_network_address_get_hostname() will always return `localhost` for a #GNetworkAddress created with this constructor. - the new #GNetworkAddress @@ -53995,7 +51538,6 @@ and @default_port is expected to be provided by the application. service name rather than as a numeric port, but this functionality is deprecated, because it depends on the contents of /etc/services, which is generally quite sparse on platforms other than Linux.) - the new #GNetworkAddress, or %NULL on error @@ -54019,7 +51561,6 @@ which is generally quite sparse on platforms other than Linux.) Using this rather than g_network_address_new() or g_network_address_parse() allows #GSocketClient to determine when to use application-specific proxy protocols. - the new #GNetworkAddress, or %NULL on error @@ -54039,7 +51580,6 @@ when to use application-specific proxy protocols. Gets @addr's hostname. This might be either UTF-8 or ASCII-encoded, depending on what @addr was created with. - @addr's hostname @@ -54053,7 +51593,6 @@ depending on what @addr was created with. Gets @addr's port number - @addr's port (which may be 0) @@ -54067,8 +51606,7 @@ depending on what @addr was created with. Gets @addr's scheme - - + @addr's scheme (%NULL if not built from URI) @@ -54096,14 +51634,11 @@ depending on what @addr was created with. - - - - + The host's network connectivity state, as reported by #GNetworkMonitor. @@ -54132,13 +51667,12 @@ implementations are based on the kernel's netlink interface and on NetworkManager. There is also an implementation for use inside Flatpak sandboxes. - Gets the default #GNetworkMonitor for the system. - - a #GNetworkMonitor + a #GNetworkMonitor, which will be + a dummy object if no network monitor is available @@ -54160,7 +51694,6 @@ Note that although this does not attempt to connect to @connectable, it may still block for a brief period of time (eg, trying to do multicast DNS on the local network), so if you do not want to block, you should use g_network_monitor_can_reach_async(). - %TRUE if @connectable is reachable, %FALSE if not. @@ -54190,7 +51723,6 @@ For more details, see g_network_monitor_can_reach(). When the operation is finished, @callback will be called. You can then call g_network_monitor_can_reach_finish() to get the result of the operation. - @@ -54221,7 +51753,6 @@ to get the result of the operation. Finishes an async network connectivity test. See g_network_monitor_can_reach_async(). - %TRUE if network is reachable, %FALSE if not. @@ -54238,7 +51769,6 @@ See g_network_monitor_can_reach_async(). - @@ -54269,7 +51799,6 @@ Note that although this does not attempt to connect to @connectable, it may still block for a brief period of time (eg, trying to do multicast DNS on the local network), so if you do not want to block, you should use g_network_monitor_can_reach_async(). - %TRUE if @connectable is reachable, %FALSE if not. @@ -54299,7 +51828,6 @@ For more details, see g_network_monitor_can_reach(). When the operation is finished, @callback will be called. You can then call g_network_monitor_can_reach_finish() to get the result of the operation. - @@ -54330,7 +51858,6 @@ to get the result of the operation. Finishes an async network connectivity test. See g_network_monitor_can_reach_async(). - %TRUE if network is reachable, %FALSE if not. @@ -54366,7 +51893,6 @@ Note that in the case of %G_NETWORK_CONNECTIVITY_LIMITED and reachable but others are not. In this case, applications can attempt to connect to remote servers, but should gracefully fall back to their "offline" behavior if the connection attempt fails. - the network connectivity state @@ -54383,7 +51909,6 @@ back to their "offline" behavior if the connection attempt fails. system has a default route available for at least one of IPv4 or IPv6. It does not necessarily imply that the public Internet is reachable. See #GNetworkMonitor:network-available for more details. - whether the network is available @@ -54398,7 +51923,6 @@ reachable. See #GNetworkMonitor:network-available for more details. Checks if the network is metered. See #GNetworkMonitor:network-metered for more details. - whether the connection is metered @@ -54471,14 +51995,12 @@ See also #GNetworkMonitor:network-available. The virtual function table for #GNetworkMonitor. - The parent interface. - @@ -54494,7 +52016,6 @@ See also #GNetworkMonitor:network-available. - %TRUE if @connectable is reachable, %FALSE if not. @@ -54517,7 +52038,6 @@ See also #GNetworkMonitor:network-available. - @@ -54548,7 +52068,6 @@ See also #GNetworkMonitor:network-available. - %TRUE if network is reachable, %FALSE if not. @@ -54576,13 +52095,11 @@ address families. See #GSrvTarget for more information about SRV records, and see #GSocketConnectable for an example of using the connectable interface. - Creates a new #GNetworkService representing the given @service, @protocol, and @domain. This will initially be unresolved; use the #GSocketConnectable interface to resolve it. - a new #GNetworkService @@ -54605,7 +52122,6 @@ interface. Gets the domain that @srv serves. This might be either UTF-8 or ASCII-encoded, depending on what @srv was created with. - @srv's domain name @@ -54619,7 +52135,6 @@ ASCII-encoded, depending on what @srv was created with. Gets @srv's protocol name (eg, "tcp"). - @srv's protocol name @@ -54634,7 +52149,6 @@ ASCII-encoded, depending on what @srv was created with. Gets the URI scheme used to resolve proxies. By default, the service name is used as scheme. - @srv's scheme name @@ -54648,7 +52162,6 @@ is used as scheme. Gets @srv's service name (eg, "ldap"). - @srv's service name @@ -54663,7 +52176,6 @@ is used as scheme. Set's the URI scheme used to resolve proxies. By default, the service name is used as scheme. - @@ -54698,14 +52210,11 @@ is used as scheme. - - - - + #GNotification is a mechanism for creating a notification to be shown to the user -- typically as a pop-up notification presented by the @@ -54735,7 +52244,6 @@ After populating @notification with more details, it can be sent to the desktop shell with g_application_send_notification(). Changing any properties after this call will not have any effect until resending @notification. - a new #GNotification instance @@ -54756,7 +52264,6 @@ its parameter. See g_action_parse_detailed_name() for a description of the format for @detailed_action. - @@ -54783,7 +52290,6 @@ If @target_format is given, it is used to collect remaining positional parameters into a #GVariant instance, similar to g_variant_new(). @action will be activated with that #GVariant as its parameter. - @@ -54816,7 +52322,6 @@ parameter. If @target is non-%NULL, @action will be activated with @target as its parameter. - @@ -54841,7 +52346,6 @@ its parameter. Sets the body of @notification to @body. - @@ -54868,7 +52372,6 @@ for @detailed_action. When no default action is set, the application that the notification was sent on is activated. - @@ -54895,7 +52398,6 @@ parameter. When no default action is set, the application that the notification was sent on is activated. - @@ -54928,7 +52430,6 @@ its parameter. When no default action is set, the application that the notification was sent on is activated. - @@ -54949,7 +52450,6 @@ was sent on is activated. Sets the icon of @notification to @icon. - @@ -54967,7 +52467,6 @@ was sent on is activated. Sets the priority of @notification to @priority. See #GNotificationPriority for possible values. - @@ -54984,7 +52483,6 @@ was sent on is activated. Sets the title of @notification to @title. - @@ -55003,7 +52501,6 @@ was sent on is activated. Deprecated in favor of g_notification_set_priority(). Since 2.42, this has been deprecated in favour of g_notification_set_priority(). - @@ -55043,21 +52540,18 @@ was sent on is activated. - - - @@ -55071,7 +52565,6 @@ were one buffer. If @address is %NULL then the message is sent to the default receiver (as previously set by g_socket_connect()). - a #GSocketAddress, or %NULL @@ -55113,7 +52606,6 @@ See the documentation for #GIOStream for details of thread safety of streaming APIs. All of these functions have async variants too. - Requests an asynchronous close of the stream, releasing resources related to it. When the operation is finished @callback will be @@ -55125,7 +52617,6 @@ For behaviour details see g_output_stream_close(). The asynchronous methods have a default fallback that uses threads to implement asynchronicity, so they are optional for inheriting classes. However, if you override one you must override all. - @@ -55154,7 +52645,6 @@ classes. However, if you override one you must override all. Closes an output stream. - %TRUE if stream was successfully closed, %FALSE otherwise. @@ -55171,7 +52661,6 @@ classes. However, if you override one you must override all. - @@ -55194,7 +52683,6 @@ This function is optional for inherited classes. If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. - %TRUE on success, %FALSE on error @@ -55218,7 +52706,6 @@ For behaviour details see g_output_stream_flush(). When the operation is finished @callback will be called. You can then call g_output_stream_flush_finish() to get the result of the operation. - @@ -55247,7 +52734,6 @@ result of the operation. Finishes flushing an output stream. - %TRUE if flush operation succeeded, %FALSE otherwise. @@ -55265,7 +52751,6 @@ result of the operation. Splices an input stream into an output stream. - a #gssize containing the size of the data spliced, or -1 if an error occurred. Note that if the number of bytes @@ -55301,7 +52786,6 @@ result of the operation. For the synchronous, blocking version of this function, see g_output_stream_splice(). - @@ -55338,7 +52822,6 @@ g_output_stream_splice(). Finishes an asynchronous stream splice operation. - a #gssize of the number of bytes spliced. Note that if the number of bytes spliced is greater than %G_MAXSSIZE, then that @@ -55393,7 +52876,6 @@ Note that no copy of @buffer will be made, so it must stay valid until @callback is called. See g_output_stream_write_bytes_async() for a #GBytes version that will automatically hold a reference to the contents (without copying) for the duration of the call. - @@ -55432,7 +52914,6 @@ the contents (without copying) for the duration of the call. Finishes a stream write operation. - a #gssize containing the number of bytes written to the stream. @@ -55469,7 +52950,6 @@ operation was partially finished when the operation was cancelled the partial result will be returned, without an error. On error -1 is returned and @error is set accordingly. - Number of bytes written, or -1 on error @@ -55526,7 +53006,6 @@ g_output_stream_writev(). Note that no copy of @vectors will be made, so it must stay valid until @callback is called. - @@ -55565,7 +53044,6 @@ until @callback is called. Finishes a stream writev operation. - %TRUE on success, %FALSE if there was an error @@ -55609,7 +53087,6 @@ Some implementations of g_output_stream_writev() may have limitations on the aggregate buffer size, and will return %G_IO_ERROR_INVALID_ARGUMENT if these are exceeded. For example, when writing to a local file on UNIX platforms, the aggregate buffer size must not exceed %G_MAXSSIZE bytes. - %TRUE on success, %FALSE if there was an error @@ -55642,7 +53119,6 @@ the aggregate buffer size must not exceed %G_MAXSSIZE bytes. Clears the pending flag on @stream. - @@ -55683,7 +53159,6 @@ Cancelling a close will still leave the stream closed, but there some streams can use a faster close that doesn't block to e.g. check errors. On cancellation (as with any error) there is no guarantee that all written data will reach the target. - %TRUE on success, %FALSE on failure @@ -55710,7 +53185,6 @@ For behaviour details see g_output_stream_close(). The asynchronous methods have a default fallback that uses threads to implement asynchronicity, so they are optional for inheriting classes. However, if you override one you must override all. - @@ -55739,7 +53213,6 @@ classes. However, if you override one you must override all. Closes an output stream. - %TRUE if stream was successfully closed, %FALSE otherwise. @@ -55765,7 +53238,6 @@ This function is optional for inherited classes. If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. - %TRUE on success, %FALSE on error @@ -55789,7 +53261,6 @@ For behaviour details see g_output_stream_flush(). When the operation is finished @callback will be called. You can then call g_output_stream_flush_finish() to get the result of the operation. - @@ -55818,7 +53289,6 @@ result of the operation. Finishes flushing an output stream. - %TRUE if flush operation succeeded, %FALSE otherwise. @@ -55836,7 +53306,6 @@ result of the operation. Checks if an output stream has pending actions. - %TRUE if @stream has pending actions. @@ -55850,7 +53319,6 @@ result of the operation. Checks if an output stream has already been closed. - %TRUE if @stream is closed. %FALSE otherwise. @@ -55867,7 +53335,6 @@ result of the operation. used inside e.g. a flush implementation to see if the flush (or other i/o operation) is called from within the closing operation. - %TRUE if @stream is being closed. %FALSE otherwise. @@ -55892,7 +53359,6 @@ function due to the variable length of the written string, if you need precise control over partial write failures, you need to create you own printf()-like wrapper around g_output_stream_write() or g_output_stream_write_all(). - %TRUE on success, %FALSE if there was an error @@ -55929,7 +53395,6 @@ or g_output_stream_write_all(). Sets @stream to have actions pending. If the pending flag is already set or @stream is closed, it will return %FALSE and set @error. - %TRUE if pending was previously unset and is now set. @@ -55943,7 +53408,6 @@ already set or @stream is closed, it will return %FALSE and set Splices an input stream into an output stream. - a #gssize containing the size of the data spliced, or -1 if an error occurred. Note that if the number of bytes @@ -55979,7 +53443,6 @@ result of the operation. For the synchronous, blocking version of this function, see g_output_stream_splice(). - @@ -56016,7 +53479,6 @@ g_output_stream_splice(). Finishes an asynchronous stream splice operation. - a #gssize of the number of bytes spliced. Note that if the number of bytes spliced is greater than %G_MAXSSIZE, then that @@ -56048,7 +53510,6 @@ function due to the variable length of the written string, if you need precise control over partial write failures, you need to create you own printf()-like wrapper around g_output_stream_write() or g_output_stream_write_all(). - %TRUE on success, %FALSE if there was an error @@ -56102,7 +53563,6 @@ operation was partially finished when the operation was cancelled the partial result will be returned, without an error. On error -1 is returned and @error is set accordingly. - Number of bytes written, or -1 on error @@ -56148,7 +53608,6 @@ successfully written before the error was encountered. This functionality is only available from C. If you need it from another language then you must write your own loop around g_output_stream_write(). - %TRUE on success, %FALSE if there was an error @@ -56195,7 +53654,6 @@ priority. Default priority is %G_PRIORITY_DEFAULT. Note that no copy of @buffer will be made, so it must stay valid until @callback is called. - @@ -56243,7 +53701,6 @@ successfully written before the error was encountered. This functionality is only available from C. If you need it from another language then you must write your own loop around g_output_stream_write_async(). - %TRUE on success, %FALSE if there was an error @@ -56299,7 +53756,6 @@ Note that no copy of @buffer will be made, so it must stay valid until @callback is called. See g_output_stream_write_bytes_async() for a #GBytes version that will automatically hold a reference to the contents (without copying) for the duration of the call. - @@ -56348,7 +53804,6 @@ writing, you will need to create a new #GBytes containing just the remaining bytes, using g_bytes_new_from_bytes(). Passing the same #GBytes instance multiple times potentially can result in duplicated data in the output stream. - Number of bytes written, or -1 on error @@ -56382,7 +53837,6 @@ data in the output stream. For the synchronous, blocking version of this function, see g_output_stream_write_bytes(). - @@ -56415,7 +53869,6 @@ g_output_stream_write_bytes(). Finishes a stream write-from-#GBytes operation. - a #gssize containing the number of bytes written to the stream. @@ -56433,7 +53886,6 @@ g_output_stream_write_bytes(). Finishes a stream write operation. - a #gssize containing the number of bytes written to the stream. @@ -56473,7 +53925,6 @@ Some implementations of g_output_stream_writev() may have limitations on the aggregate buffer size, and will return %G_IO_ERROR_INVALID_ARGUMENT if these are exceeded. For example, when writing to a local file on UNIX platforms, the aggregate buffer size must not exceed %G_MAXSSIZE bytes. - %TRUE on success, %FALSE if there was an error @@ -56527,7 +53978,6 @@ g_output_stream_write(). The content of the individual elements of @vectors might be changed by this function. - %TRUE on success, %FALSE if there was an error @@ -56575,7 +54025,6 @@ priority. Default priority is %G_PRIORITY_DEFAULT. Note that no copy of @vectors will be made, so it must stay valid until @callback is called. The content of the individual elements of @vectors might be changed by this function. - @@ -56623,7 +54072,6 @@ successfully written before the error was encountered. This functionality is only available from C. If you need it from another language then you must write your own loop around g_output_stream_writev_async(). - %TRUE on success, %FALSE if there was an error @@ -56674,7 +54122,6 @@ g_output_stream_writev(). Note that no copy of @vectors will be made, so it must stay valid until @callback is called. - @@ -56713,7 +54160,6 @@ until @callback is called. Finishes a stream writev operation. - %TRUE on success, %FALSE if there was an error @@ -56741,13 +54187,11 @@ until @callback is called. - - Number of bytes written, or -1 on error @@ -56776,7 +54220,6 @@ until @callback is called. - a #gssize containing the size of the data spliced, or -1 if an error occurred. Note that if the number of bytes @@ -56807,7 +54250,6 @@ until @callback is called. - %TRUE on success, %FALSE on error @@ -56826,7 +54268,6 @@ until @callback is called. - @@ -56842,7 +54283,6 @@ until @callback is called. - @@ -56882,7 +54322,6 @@ until @callback is called. - a #gssize containing the number of bytes written to the stream. @@ -56901,7 +54340,6 @@ until @callback is called. - @@ -56939,7 +54377,6 @@ until @callback is called. - a #gssize of the number of bytes spliced. Note that if the number of bytes spliced is greater than %G_MAXSSIZE, then that @@ -56961,7 +54398,6 @@ until @callback is called. - @@ -56991,7 +54427,6 @@ until @callback is called. - %TRUE if flush operation succeeded, %FALSE otherwise. @@ -57010,7 +54445,6 @@ until @callback is called. - @@ -57040,7 +54474,6 @@ until @callback is called. - %TRUE if stream was successfully closed, %FALSE otherwise. @@ -57059,7 +54492,6 @@ until @callback is called. - %TRUE on success, %FALSE if there was an error @@ -57093,7 +54525,6 @@ until @callback is called. - @@ -57133,7 +54564,6 @@ until @callback is called. - %TRUE on success, %FALSE if there was an error @@ -57156,7 +54586,6 @@ until @callback is called. - @@ -57164,7 +54593,6 @@ until @callback is called. - @@ -57172,7 +54600,6 @@ until @callback is called. - @@ -57180,7 +54607,6 @@ until @callback is called. - @@ -57188,16 +54614,13 @@ until @callback is called. - - - - + GOutputStreamSpliceFlags determine how streams should be spliced. @@ -57217,7 +54640,6 @@ until @callback is called. You generally pass in an array of #GOutputVectors and the operation will use all the buffers as if they were one buffer. - Pointer to a buffer of data to read. @@ -57228,105 +54650,90 @@ one buffer. - - - - - - - - - - - - - - - @@ -57335,18 +54742,15 @@ one buffer. Extension point for proxy functionality. See [Extending GIO][extending-gio]. - - - @@ -57355,11 +54759,9 @@ See [Extending GIO][extending-gio]. Extension point for proxy resolving functionality. See [Extending GIO][extending-gio]. - - @@ -57396,7 +54798,6 @@ user to write to a #GSettings object. This #GPermission object could then be used to decide if it is appropriate to show a "Click here to unlock" button in a dialog and to provide the mechanism to invoke when that button is clicked. - Attempts to acquire the permission represented by @permission. @@ -57413,7 +54814,6 @@ If the permission is acquired then %TRUE is returned. Otherwise, This call is blocking, likely for a very long time (in the case that user interaction is required). See g_permission_acquire_async() for the non-blocking version. - %TRUE if the permission was successfully acquired @@ -57434,7 +54834,6 @@ the non-blocking version. This is the first half of the asynchronous version of g_permission_acquire(). - @@ -57463,7 +54862,6 @@ represented by @permission. This is the second half of the asynchronous version of g_permission_acquire(). - %TRUE if the permission was successfully acquired @@ -57495,7 +54893,6 @@ If the permission is released then %TRUE is returned. Otherwise, This call is blocking, likely for a very long time (in the case that user interaction is required). See g_permission_release_async() for the non-blocking version. - %TRUE if the permission was successfully released @@ -57516,7 +54913,6 @@ the non-blocking version. This is the first half of the asynchronous version of g_permission_release(). - @@ -57545,7 +54941,6 @@ represented by @permission. This is the second half of the asynchronous version of g_permission_release(). - %TRUE if the permission was successfully released @@ -57577,7 +54972,6 @@ If the permission is acquired then %TRUE is returned. Otherwise, This call is blocking, likely for a very long time (in the case that user interaction is required). See g_permission_acquire_async() for the non-blocking version. - %TRUE if the permission was successfully acquired @@ -57598,7 +54992,6 @@ the non-blocking version. This is the first half of the asynchronous version of g_permission_acquire(). - @@ -57627,7 +55020,6 @@ represented by @permission. This is the second half of the asynchronous version of g_permission_acquire(). - %TRUE if the permission was successfully acquired @@ -57647,7 +55039,6 @@ g_permission_acquire(). Gets the value of the 'allowed' property. This property is %TRUE if the caller currently has permission to perform the action that @permission represents the permission to perform. - the value of the 'allowed' property @@ -57663,7 +55054,6 @@ the caller currently has permission to perform the action that Gets the value of the 'can-acquire' property. This property is %TRUE if it is generally possible to acquire the permission by calling g_permission_acquire(). - the value of the 'can-acquire' property @@ -57679,7 +55069,6 @@ g_permission_acquire(). Gets the value of the 'can-release' property. This property is %TRUE if it is generally possible to release the permission by calling g_permission_release(). - the value of the 'can-release' property @@ -57697,7 +55086,6 @@ the properties of the permission. You should never call this function except from a #GPermission implementation. GObject notify signals are generated, as appropriate. - @@ -57736,7 +55124,6 @@ If the permission is released then %TRUE is returned. Otherwise, This call is blocking, likely for a very long time (in the case that user interaction is required). See g_permission_release_async() for the non-blocking version. - %TRUE if the permission was successfully released @@ -57757,7 +55144,6 @@ the non-blocking version. This is the first half of the asynchronous version of g_permission_release(). - @@ -57786,7 +55172,6 @@ represented by @permission. This is the second half of the asynchronous version of g_permission_release(). - %TRUE if the permission was successfully released @@ -57825,13 +55210,11 @@ g_permission_release(). - - %TRUE if the permission was successfully acquired @@ -57850,7 +55233,6 @@ g_permission_release(). - @@ -57876,7 +55258,6 @@ g_permission_release(). - %TRUE if the permission was successfully acquired @@ -57895,7 +55276,6 @@ g_permission_release(). - %TRUE if the permission was successfully released @@ -57914,7 +55294,6 @@ g_permission_release(). - @@ -57940,7 +55319,6 @@ g_permission_release(). - %TRUE if the permission was successfully released @@ -57963,15 +55341,12 @@ g_permission_release(). - - - + #GPollableInputStream is implemented by #GInputStreams that can be polled for readiness to read. This can be used when interfacing with a non-GIO API that expects UNIX-file-descriptor-style asynchronous I/O rather than GIO-style. - Checks if @stream is actually pollable. Some classes may implement @@ -57981,7 +55356,6 @@ other #GPollableInputStream methods is undefined. For any given stream, the value returned by this method is constant; a stream cannot switch from pollable to non-pollable or vice versa. - %TRUE if @stream is pollable, %FALSE if not. @@ -58002,7 +55376,6 @@ As with g_pollable_input_stream_is_readable(), it is possible that the stream may not actually be readable even after the source triggers, so you should use g_pollable_input_stream_read_nonblocking() rather than g_input_stream_read() from the callback. - a new #GSource @@ -58027,7 +55400,6 @@ after this returns %TRUE would still block. To guarantee non-blocking behavior, you should always use g_pollable_input_stream_read_nonblocking(), which will return a %G_IO_ERROR_WOULD_BLOCK error rather than blocking. - %TRUE if @stream is readable, %FALSE if not. If an error has occurred on @stream, this will result in @@ -58054,7 +55426,6 @@ use @cancellable to cancel it. However, it will return an error if @cancellable has already been cancelled when you call, which may happen if you call this method after a source triggers due to having been cancelled. - the number of bytes read, or -1 on error (including %G_IO_ERROR_WOULD_BLOCK). @@ -58086,7 +55457,6 @@ other #GPollableInputStream methods is undefined. For any given stream, the value returned by this method is constant; a stream cannot switch from pollable to non-pollable or vice versa. - %TRUE if @stream is pollable, %FALSE if not. @@ -58107,7 +55477,6 @@ As with g_pollable_input_stream_is_readable(), it is possible that the stream may not actually be readable even after the source triggers, so you should use g_pollable_input_stream_read_nonblocking() rather than g_input_stream_read() from the callback. - a new #GSource @@ -58132,7 +55501,6 @@ after this returns %TRUE would still block. To guarantee non-blocking behavior, you should always use g_pollable_input_stream_read_nonblocking(), which will return a %G_IO_ERROR_WOULD_BLOCK error rather than blocking. - %TRUE if @stream is readable, %FALSE if not. If an error has occurred on @stream, this will result in @@ -58159,7 +55527,6 @@ use @cancellable to cancel it. However, it will return an error if @cancellable has already been cancelled when you call, which may happen if you call this method after a source triggers due to having been cancelled. - the number of bytes read, or -1 on error (including %G_IO_ERROR_WOULD_BLOCK). @@ -58199,14 +55566,12 @@ g_input_stream_read() if it returns %TRUE. This means you only need to override it if it is possible that your @is_readable implementation may return %TRUE when the stream is not actually readable. - The parent interface. - %TRUE if @stream is pollable, %FALSE if not. @@ -58221,7 +55586,6 @@ readable. - %TRUE if @stream is readable, %FALSE if not. If an error has occurred on @stream, this will result in @@ -58239,7 +55603,6 @@ readable. - a new #GSource @@ -58258,7 +55621,6 @@ readable. - the number of bytes read, or -1 on error (including %G_IO_ERROR_WOULD_BLOCK). @@ -58289,7 +55651,6 @@ readable. can be polled for readiness to write. This can be used when interfacing with a non-GIO API that expects UNIX-file-descriptor-style asynchronous I/O rather than GIO-style. - Checks if @stream is actually pollable. Some classes may implement @@ -58299,7 +55660,6 @@ of other #GPollableOutputStream methods is undefined. For any given stream, the value returned by this method is constant; a stream cannot switch from pollable to non-pollable or vice versa. - %TRUE if @stream is pollable, %FALSE if not. @@ -58320,7 +55680,6 @@ As with g_pollable_output_stream_is_writable(), it is possible that the stream may not actually be writable even after the source triggers, so you should use g_pollable_output_stream_write_nonblocking() rather than g_output_stream_write() from the callback. - a new #GSource @@ -58345,7 +55704,6 @@ after this returns %TRUE would still block. To guarantee non-blocking behavior, you should always use g_pollable_output_stream_write_nonblocking(), which will return a %G_IO_ERROR_WOULD_BLOCK error rather than blocking. - %TRUE if @stream is writable, %FALSE if not. If an error has occurred on @stream, this will result in @@ -58376,7 +55734,6 @@ to having been cancelled. Also note that if %G_IO_ERROR_WOULD_BLOCK is returned some underlying transports like D/TLS require that you re-send the same @buffer and @count in the next write call. - the number of bytes written, or -1 on error (including %G_IO_ERROR_WOULD_BLOCK). @@ -58417,7 +55774,6 @@ to having been cancelled. Also note that if %G_POLLABLE_RETURN_WOULD_BLOCK is returned some underlying transports like D/TLS require that you re-send the same @vectors and @n_vectors in the next write call. - %@G_POLLABLE_RETURN_OK on success, %G_POLLABLE_RETURN_WOULD_BLOCK if the stream is not currently writable (and @error is *not* set), or @@ -58455,7 +55811,6 @@ of other #GPollableOutputStream methods is undefined. For any given stream, the value returned by this method is constant; a stream cannot switch from pollable to non-pollable or vice versa. - %TRUE if @stream is pollable, %FALSE if not. @@ -58476,7 +55831,6 @@ As with g_pollable_output_stream_is_writable(), it is possible that the stream may not actually be writable even after the source triggers, so you should use g_pollable_output_stream_write_nonblocking() rather than g_output_stream_write() from the callback. - a new #GSource @@ -58501,7 +55855,6 @@ after this returns %TRUE would still block. To guarantee non-blocking behavior, you should always use g_pollable_output_stream_write_nonblocking(), which will return a %G_IO_ERROR_WOULD_BLOCK error rather than blocking. - %TRUE if @stream is writable, %FALSE if not. If an error has occurred on @stream, this will result in @@ -58532,7 +55885,6 @@ to having been cancelled. Also note that if %G_IO_ERROR_WOULD_BLOCK is returned some underlying transports like D/TLS require that you re-send the same @buffer and @count in the next write call. - the number of bytes written, or -1 on error (including %G_IO_ERROR_WOULD_BLOCK). @@ -58577,7 +55929,6 @@ to having been cancelled. Also note that if %G_POLLABLE_RETURN_WOULD_BLOCK is returned some underlying transports like D/TLS require that you re-send the same @vectors and @n_vectors in the next write call. - %@G_POLLABLE_RETURN_OK on success, %G_POLLABLE_RETURN_WOULD_BLOCK if the stream is not currently writable (and @error is *not* set), or @@ -58629,14 +55980,12 @@ g_pollable_output_stream_write_nonblocking() for each vector, and converts its return value and error (if set) to a #GPollableReturn. You should override this where possible to avoid having to allocate a #GError to return %G_IO_ERROR_WOULD_BLOCK. - The parent interface. - %TRUE if @stream is pollable, %FALSE if not. @@ -58651,7 +56000,6 @@ override this where possible to avoid having to allocate a #GError to return - %TRUE if @stream is writable, %FALSE if not. If an error has occurred on @stream, this will result in @@ -58669,7 +56017,6 @@ override this where possible to avoid having to allocate a #GError to return - a new #GSource @@ -58688,7 +56035,6 @@ override this where possible to avoid having to allocate a #GError to return - the number of bytes written, or -1 on error (including %G_IO_ERROR_WOULD_BLOCK). @@ -58715,7 +56061,6 @@ override this where possible to avoid having to allocate a #GError to return - %@G_POLLABLE_RETURN_OK on success, %G_POLLABLE_RETURN_WOULD_BLOCK if the stream is not currently writable (and @error is *not* set), or @@ -58771,7 +56116,6 @@ operation to give details about the error that happened. This is the function type of the callback used for the #GSource returned by g_pollable_input_stream_create_source() and g_pollable_output_stream_create_source(). - it should return %FALSE if the source should be removed. @@ -58849,7 +56193,6 @@ construct-only). This function takes a reference on @object and doesn't release it until the action is destroyed. - a new #GPropertyAction @@ -58922,12 +56265,10 @@ The extensions are named after their proxy protocol name. As an example, a SOCKS5 proxy implementation can be retrieved with the name 'socks5' using the function g_io_extension_point_get_extension_by_name(). - Find the `gio-proxy` extension point for a proxy implementation that supports the specified protocol. - - + return a #GProxy or NULL if protocol is not supported. @@ -58944,7 +56285,6 @@ the specified protocol. #GSocketConnection that is connected to the proxy server), this does the necessary handshake to connect to @proxy_address, and if required, wraps the #GIOStream to handle proxy payload. - a #GIOStream that will replace @connection. This might be the same as @connection, in which case a reference @@ -58972,7 +56312,6 @@ required, wraps the #GIOStream to handle proxy payload. Asynchronous version of g_proxy_connect(). - @@ -59005,7 +56344,6 @@ required, wraps the #GIOStream to handle proxy payload. See g_proxy_connect(). - a #GIOStream. @@ -59029,7 +56367,6 @@ implementing such a protocol. When %FALSE is returned, the caller should resolve the destination hostname first, and then pass a #GProxyAddress containing the stringified IP address to g_proxy_connect() or g_proxy_connect_async(). - %TRUE if hostname resolution is supported. @@ -59046,7 +56383,6 @@ g_proxy_connect() or g_proxy_connect_async(). #GSocketConnection that is connected to the proxy server), this does the necessary handshake to connect to @proxy_address, and if required, wraps the #GIOStream to handle proxy payload. - a #GIOStream that will replace @connection. This might be the same as @connection, in which case a reference @@ -59074,7 +56410,6 @@ required, wraps the #GIOStream to handle proxy payload. Asynchronous version of g_proxy_connect(). - @@ -59107,7 +56442,6 @@ required, wraps the #GIOStream to handle proxy payload. See g_proxy_connect(). - a #GIOStream. @@ -59131,7 +56465,6 @@ implementing such a protocol. When %FALSE is returned, the caller should resolve the destination hostname first, and then pass a #GProxyAddress containing the stringified IP address to g_proxy_connect() or g_proxy_connect_async(). - %TRUE if hostname resolution is supported. @@ -59146,7 +56479,6 @@ g_proxy_connect() or g_proxy_connect_async(). Support for proxied #GInetSocketAddress. - Creates a new #GProxyAddress for @inetaddr with @protocol that should @@ -59155,7 +56487,6 @@ tunnel through @dest_hostname and @dest_port. (Note that this method doesn't set the #GProxyAddress:uri or #GProxyAddress:destination-protocol fields; use g_object_new() directly if you want to set those.) - a new #GProxyAddress @@ -59197,7 +56528,6 @@ directly if you want to set those.) Gets @proxy's destination hostname; that is, the name of the host that will be connected to via the proxy, not the name of the proxy itself. - the @proxy's destination hostname @@ -59213,7 +56543,6 @@ itself. Gets @proxy's destination port; that is, the port on the destination host that will be connected to via the proxy, not the port number of the proxy itself. - the @proxy's destination port @@ -59228,7 +56557,6 @@ port number of the proxy itself. Gets the protocol that is being spoken to the destination server; eg, "http" or "ftp". - the @proxy's destination protocol @@ -59242,8 +56570,7 @@ server; eg, "http" or "ftp". Gets @proxy's password. - - + the @proxy's password @@ -59256,7 +56583,6 @@ server; eg, "http" or "ftp". Gets @proxy's protocol. eg, "socks" or "http" - the @proxy's protocol @@ -59270,8 +56596,7 @@ server; eg, "http" or "ftp". Gets the proxy URI that @proxy was constructed from. - - + the @proxy's URI, or %NULL if unknown @@ -59284,8 +56609,7 @@ server; eg, "http" or "ftp". Gets @proxy's username. - - + the @proxy's username @@ -59330,7 +56654,6 @@ if the creator didn't specify this). Class structure for #GProxyAddress. - @@ -59345,7 +56668,6 @@ This enumerator will be returned (for example, by g_socket_connectable_enumerate()) as appropriate when a proxy is configured; there should be no need to manually wrap a #GSocketAddressEnumerator instance with one. - @@ -59370,13 +56692,11 @@ specify one. Class structure for #GProxyAddressEnumerator. - - @@ -59384,7 +56704,6 @@ specify one. - @@ -59392,7 +56711,6 @@ specify one. - @@ -59400,7 +56718,6 @@ specify one. - @@ -59408,7 +56725,6 @@ specify one. - @@ -59416,7 +56732,6 @@ specify one. - @@ -59424,29 +56739,22 @@ specify one. - - - - - - - + + Provides an interface for handling proxy connection and payload. - The parent interface. - a #GIOStream that will replace @connection. This might be the same as @connection, in which case a reference @@ -59475,7 +56783,6 @@ specify one. - @@ -59509,7 +56816,6 @@ specify one. - a #GIOStream. @@ -59528,7 +56834,6 @@ specify one. - %TRUE if hostname resolution is supported. @@ -59550,12 +56855,11 @@ the method g_socket_connectable_proxy_enumerate(). Implementations of #GProxyResolver based on libproxy and GNOME settings can be found in glib-networking. GIO comes with an implementation for use inside Flatpak portals. - Gets the default #GProxyResolver for the system. - - the default #GProxyResolver. + the default #GProxyResolver, which + will be a dummy object if no proxy resolver is available @@ -59563,7 +56867,6 @@ Flatpak portals. Checks if @resolver can be used on this system. (This is used internally; g_proxy_resolver_get_default() will only return a proxy resolver that returns %TRUE for this method.) - %TRUE if @resolver is supported. @@ -59591,7 +56894,6 @@ In this case, the resolver might still return a generic proxy type `direct://` is used when no proxy is needed. Direct connection should not be attempted unless it is part of the returned array of proxies. - A NULL-terminated array of proxy URIs. Must be freed @@ -59618,7 +56920,6 @@ returned array of proxies. Asynchronous lookup of proxy. See g_proxy_resolver_lookup() for more details. - @@ -59649,7 +56950,6 @@ details. Call this function to obtain the array of proxy URIs when g_proxy_resolver_lookup_async() is complete. See g_proxy_resolver_lookup() for more details. - A NULL-terminated array of proxy URIs. Must be freed @@ -59673,7 +56973,6 @@ g_proxy_resolver_lookup() for more details. Checks if @resolver can be used on this system. (This is used internally; g_proxy_resolver_get_default() will only return a proxy resolver that returns %TRUE for this method.) - %TRUE if @resolver is supported. @@ -59701,7 +57000,6 @@ In this case, the resolver might still return a generic proxy type `direct://` is used when no proxy is needed. Direct connection should not be attempted unless it is part of the returned array of proxies. - A NULL-terminated array of proxy URIs. Must be freed @@ -59728,7 +57026,6 @@ returned array of proxies. Asynchronous lookup of proxy. See g_proxy_resolver_lookup() for more details. - @@ -59759,7 +57056,6 @@ details. Call this function to obtain the array of proxy URIs when g_proxy_resolver_lookup_async() is complete. See g_proxy_resolver_lookup() for more details. - A NULL-terminated array of proxy URIs. Must be freed @@ -59782,14 +57078,12 @@ g_proxy_resolver_lookup() for more details. The virtual function table for #GProxyResolver. - The parent interface. - %TRUE if @resolver is supported. @@ -59804,7 +57098,6 @@ g_proxy_resolver_lookup() for more details. - A NULL-terminated array of proxy URIs. Must be freed @@ -59831,7 +57124,6 @@ g_proxy_resolver_lookup() for more details. - @@ -59861,7 +57153,6 @@ g_proxy_resolver_lookup() for more details. - A NULL-terminated array of proxy URIs. Must be freed @@ -59884,35 +57175,30 @@ g_proxy_resolver_lookup() for more details. - - - - - @@ -59923,7 +57209,6 @@ g_proxy_resolver_lookup() for more details. @size bytes. The function should have the same semantics as realloc(). - a pointer to the reallocated memory @@ -59961,7 +57246,6 @@ the exported #GActionGroup implements #GRemoteActionGroup and use the `_full` variants of the calls if available. This provides a mechanism by which to receive platform data for action invocations that arrive by way of D-Bus. - Activates the remote action. @@ -59973,7 +57257,6 @@ interaction timestamp or startup notification information. @platform_data must be non-%NULL and must have the type %G_VARIANT_TYPE_VARDICT. If it is floating, it will be consumed. - @@ -60006,7 +57289,6 @@ user interaction timestamp or startup notification information. @platform_data must be non-%NULL and must have the type %G_VARIANT_TYPE_VARDICT. If it is floating, it will be consumed. - @@ -60039,7 +57321,6 @@ interaction timestamp or startup notification information. @platform_data must be non-%NULL and must have the type %G_VARIANT_TYPE_VARDICT. If it is floating, it will be consumed. - @@ -60072,7 +57353,6 @@ user interaction timestamp or startup notification information. @platform_data must be non-%NULL and must have the type %G_VARIANT_TYPE_VARDICT. If it is floating, it will be consumed. - @@ -60098,13 +57378,11 @@ user interaction timestamp or startup notification information. The virtual function table for #GRemoteActionGroup. - - @@ -60130,7 +57408,6 @@ user interaction timestamp or startup notification information. - @@ -60164,13 +57441,11 @@ g_resolver_lookup_by_name() and their async variants) and SRV #GNetworkAddress and #GNetworkService provide wrappers around #GResolver functionality that also implement #GSocketConnectable, making it easy to connect to a remote host/service. - Frees @addresses (which should be the return value from g_resolver_lookup_by_name() or g_resolver_lookup_by_name_finish()). (This is a convenience method; you can also simply free the results by hand.) - @@ -60188,7 +57463,6 @@ by hand.) g_resolver_lookup_service() or g_resolver_lookup_service_finish()). (This is a convenience method; you can also simply free the results by hand.) - @@ -60205,7 +57479,6 @@ results by hand.) Gets the default #GResolver. You should unref it when you are done with it. #GResolver may use its reference count as a hint about how many threads it should allocate for concurrent DNS resolutions. - the default #GResolver. @@ -60221,7 +57494,6 @@ a value from #GResolverError. If @cancellable is non-%NULL, it can be used to cancel the operation, in which case @error (if non-%NULL) will be set to %G_IO_ERROR_CANCELLED. - a hostname (either ASCII-only, or in ASCII-encoded form), or %NULL on error. @@ -60246,7 +57518,6 @@ operation, in which case @error (if non-%NULL) will be set to Begins asynchronously reverse-resolving @address to determine its associated hostname, and eventually calls @callback, which must call g_resolver_lookup_by_address_finish() to get the final result. - @@ -60280,7 +57551,6 @@ g_resolver_lookup_by_address_async(). If the DNS resolution failed, @error (if non-%NULL) will be set to a value from #GResolverError. If the operation was cancelled, @error will be set to %G_IO_ERROR_CANCELLED. - a hostname (either ASCII-only, or in ASCII-encoded form), or %NULL on error. @@ -60321,7 +57591,6 @@ operation, in which case @error (if non-%NULL) will be set to If you are planning to connect to a socket on the resolved IP address, it may be easier to create a #GNetworkAddress and use its #GSocketConnectable interface. - a non-empty #GList of #GInetAddress, or %NULL on error. You @@ -60351,7 +57620,6 @@ done with it. (You can use g_resolver_free_addresses() to do this.) associated IP address(es), and eventually calls @callback, which must call g_resolver_lookup_by_name_finish() to get the result. See g_resolver_lookup_by_name() for more details. - @@ -60385,7 +57653,6 @@ g_resolver_lookup_by_name_async(). If the DNS resolution failed, @error (if non-%NULL) will be set to a value from #GResolverError. If the operation was cancelled, @error will be set to %G_IO_ERROR_CANCELLED. - a #GList of #GInetAddress, or %NULL on error. See g_resolver_lookup_by_name() @@ -60409,7 +57676,6 @@ for more details. This differs from g_resolver_lookup_by_name() in that you can modify the lookup behavior with @flags. For example this can be used to limit results with #G_RESOLVER_NAME_LOOKUP_FLAGS_IPV4_ONLY. - a non-empty #GList of #GInetAddress, or %NULL on error. You @@ -60443,7 +57709,6 @@ done with it. (You can use g_resolver_free_addresses() to do this.) associated IP address(es), and eventually calls @callback, which must call g_resolver_lookup_by_name_with_flags_finish() to get the result. See g_resolver_lookup_by_name() for more details. - @@ -60481,7 +57746,6 @@ g_resolver_lookup_by_name_with_flags_async(). If the DNS resolution failed, @error (if non-%NULL) will be set to a value from #GResolverError. If the operation was cancelled, @error will be set to %G_IO_ERROR_CANCELLED. - a #GList of #GInetAddress, or %NULL on error. See g_resolver_lookup_by_name() @@ -60512,7 +57776,6 @@ a value from #GResolverError and %NULL will be returned. If @cancellable is non-%NULL, it can be used to cancel the operation, in which case @error (if non-%NULL) will be set to %G_IO_ERROR_CANCELLED. - a non-empty #GList of #GVariant, or %NULL on error. You must free each of the records and the list @@ -60546,7 +57809,6 @@ g_variant_unref() to do this.) @rrname, and eventually calls @callback, which must call g_resolver_lookup_records_finish() to get the final result. See g_resolver_lookup_records() for more details. - @@ -60586,7 +57848,6 @@ records contain. If the DNS resolution failed, @error (if non-%NULL) will be set to a value from #GResolverError. If the operation was cancelled, @error will be set to %G_IO_ERROR_CANCELLED. - a non-empty #GList of #GVariant, or %NULL on error. You must free each of the records and the list @@ -60608,7 +57869,6 @@ g_variant_unref() to do this.) - @@ -60627,7 +57887,6 @@ g_variant_unref() to do this.) - @@ -60656,7 +57915,6 @@ g_resolver_lookup_service_async(). If the DNS resolution failed, @error (if non-%NULL) will be set to a value from #GResolverError. If the operation was cancelled, @error will be set to %G_IO_ERROR_CANCELLED. - a non-empty #GList of #GSrvTarget, or %NULL on error. See g_resolver_lookup_service() for more @@ -60677,7 +57935,6 @@ details. - @@ -60697,7 +57954,6 @@ a value from #GResolverError. If @cancellable is non-%NULL, it can be used to cancel the operation, in which case @error (if non-%NULL) will be set to %G_IO_ERROR_CANCELLED. - a hostname (either ASCII-only, or in ASCII-encoded form), or %NULL on error. @@ -60722,7 +57978,6 @@ operation, in which case @error (if non-%NULL) will be set to Begins asynchronously reverse-resolving @address to determine its associated hostname, and eventually calls @callback, which must call g_resolver_lookup_by_address_finish() to get the final result. - @@ -60756,7 +58011,6 @@ g_resolver_lookup_by_address_async(). If the DNS resolution failed, @error (if non-%NULL) will be set to a value from #GResolverError. If the operation was cancelled, @error will be set to %G_IO_ERROR_CANCELLED. - a hostname (either ASCII-only, or in ASCII-encoded form), or %NULL on error. @@ -60797,7 +58051,6 @@ operation, in which case @error (if non-%NULL) will be set to If you are planning to connect to a socket on the resolved IP address, it may be easier to create a #GNetworkAddress and use its #GSocketConnectable interface. - a non-empty #GList of #GInetAddress, or %NULL on error. You @@ -60827,7 +58080,6 @@ done with it. (You can use g_resolver_free_addresses() to do this.) associated IP address(es), and eventually calls @callback, which must call g_resolver_lookup_by_name_finish() to get the result. See g_resolver_lookup_by_name() for more details. - @@ -60861,7 +58113,6 @@ g_resolver_lookup_by_name_async(). If the DNS resolution failed, @error (if non-%NULL) will be set to a value from #GResolverError. If the operation was cancelled, @error will be set to %G_IO_ERROR_CANCELLED. - a #GList of #GInetAddress, or %NULL on error. See g_resolver_lookup_by_name() @@ -60885,7 +58136,6 @@ for more details. This differs from g_resolver_lookup_by_name() in that you can modify the lookup behavior with @flags. For example this can be used to limit results with #G_RESOLVER_NAME_LOOKUP_FLAGS_IPV4_ONLY. - a non-empty #GList of #GInetAddress, or %NULL on error. You @@ -60919,7 +58169,6 @@ done with it. (You can use g_resolver_free_addresses() to do this.) associated IP address(es), and eventually calls @callback, which must call g_resolver_lookup_by_name_with_flags_finish() to get the result. See g_resolver_lookup_by_name() for more details. - @@ -60957,7 +58206,6 @@ g_resolver_lookup_by_name_with_flags_async(). If the DNS resolution failed, @error (if non-%NULL) will be set to a value from #GResolverError. If the operation was cancelled, @error will be set to %G_IO_ERROR_CANCELLED. - a #GList of #GInetAddress, or %NULL on error. See g_resolver_lookup_by_name() @@ -60988,7 +58236,6 @@ a value from #GResolverError and %NULL will be returned. If @cancellable is non-%NULL, it can be used to cancel the operation, in which case @error (if non-%NULL) will be set to %G_IO_ERROR_CANCELLED. - a non-empty #GList of #GVariant, or %NULL on error. You must free each of the records and the list @@ -61022,7 +58269,6 @@ g_variant_unref() to do this.) @rrname, and eventually calls @callback, which must call g_resolver_lookup_records_finish() to get the final result. See g_resolver_lookup_records() for more details. - @@ -61062,7 +58308,6 @@ records contain. If the DNS resolution failed, @error (if non-%NULL) will be set to a value from #GResolverError. If the operation was cancelled, @error will be set to %G_IO_ERROR_CANCELLED. - a non-empty #GList of #GVariant, or %NULL on error. You must free each of the records and the list @@ -61105,7 +58350,6 @@ operation, in which case @error (if non-%NULL) will be set to If you are planning to connect to the service, it is usually easier to create a #GNetworkService and use its #GSocketConnectable interface. - a non-empty #GList of #GSrvTarget, or %NULL on error. You must free each of the targets and the @@ -61144,7 +58388,6 @@ this.) @callback, which must call g_resolver_lookup_service_finish() to get the final result. See g_resolver_lookup_service() for more details. - @@ -61186,7 +58429,6 @@ g_resolver_lookup_service_async(). If the DNS resolution failed, @error (if non-%NULL) will be set to a value from #GResolverError. If the operation was cancelled, @error will be set to %G_IO_ERROR_CANCELLED. - a non-empty #GList of #GSrvTarget, or %NULL on error. See g_resolver_lookup_service() for more @@ -61216,7 +58458,6 @@ caching or "pinning"; it can implement its own #GResolver that calls the original default resolver for DNS operations, and implements its own cache policies on top of that, and then set itself as the default resolver for all later code to use. - @@ -61242,13 +58483,11 @@ configuration has changed. - - @@ -61261,7 +58500,6 @@ configuration has changed. - a non-empty #GList of #GInetAddress, or %NULL on error. You @@ -61289,7 +58527,6 @@ done with it. (You can use g_resolver_free_addresses() to do this.) - @@ -61319,7 +58556,6 @@ done with it. (You can use g_resolver_free_addresses() to do this.) - a #GList of #GInetAddress, or %NULL on error. See g_resolver_lookup_by_name() @@ -61342,7 +58578,6 @@ for more details. - a hostname (either ASCII-only, or in ASCII-encoded form), or %NULL on error. @@ -61366,7 +58601,6 @@ for more details. - @@ -61396,7 +58630,6 @@ for more details. - a hostname (either ASCII-only, or in ASCII-encoded form), or %NULL on error. @@ -61416,7 +58649,6 @@ form), or %NULL on error. - @@ -61437,7 +58669,6 @@ form), or %NULL on error. - @@ -61462,7 +58693,6 @@ form), or %NULL on error. - a non-empty #GList of #GSrvTarget, or %NULL on error. See g_resolver_lookup_service() for more @@ -61485,7 +58715,6 @@ details. - a non-empty #GList of #GVariant, or %NULL on error. You must free each of the records and the list @@ -61517,7 +58746,6 @@ g_variant_unref() to do this.) - @@ -61551,7 +58779,6 @@ g_variant_unref() to do this.) - a non-empty #GList of #GVariant, or %NULL on error. You must free each of the records and the list @@ -61575,7 +58802,6 @@ g_variant_unref() to do this.) - @@ -61609,7 +58835,6 @@ g_variant_unref() to do this.) - a #GList of #GInetAddress, or %NULL on error. See g_resolver_lookup_by_name() @@ -61632,7 +58857,6 @@ for more details. - a non-empty #GList of #GInetAddress, or %NULL on error. You @@ -61697,9 +58921,7 @@ from a #GResolver routine. only resolve ipv6 addresses - - - + The type of record that g_resolver_lookup_records() or g_resolver_lookup_records_async() should retrieve. The records are returned @@ -61776,12 +58998,16 @@ the `XMLLINT` environment variable must be set to the full path to the xmllint executable, or xmllint must be in the `PATH`; otherwise the preprocessing step is skipped. -`to-pixdata` which will use the gdk-pixbuf-pixdata command to convert -images to the GdkPixdata format, which allows you to create pixbufs directly using the data inside -the resource file, rather than an (uncompressed) copy of it. For this, the gdk-pixbuf-pixdata -program must be in the PATH, or the `GDK_PIXBUF_PIXDATA` environment variable must be -set to the full path to the gdk-pixbuf-pixdata executable; otherwise the resource compiler will -abort. +`to-pixdata` (deprecated since gdk-pixbuf 2.32) which will use the +`gdk-pixbuf-pixdata` command to convert images to the #GdkPixdata format, +which allows you to create pixbufs directly using the data inside the +resource file, rather than an (uncompressed) copy of it. For this, the +`gdk-pixbuf-pixdata` program must be in the `PATH`, or the +`GDK_PIXBUF_PIXDATA` environment variable must be set to the full path to the +`gdk-pixbuf-pixdata` executable; otherwise the resource compiler will abort. +`to-pixdata` has been deprecated since gdk-pixbuf 2.32, as #GResource +supports embedding modern image formats just as well. Instead of using it, +embed a PNG or SVG file in your #GResource. `json-stripblanks` which will use the `json-glib-format` command to strip ignorable whitespace from the JSON file. For this to work, the @@ -61859,7 +59085,7 @@ When debugging a program or testing a change to an installed version, it is ofte replace resources in the program or library, without recompiling, for debugging or quick hacking and testing purposes. Since GLib 2.50, it is possible to use the `G_RESOURCE_OVERLAYS` environment variable to selectively overlay resources with replacements from the filesystem. It is a %G_SEARCHPATH_SEPARATOR-separated list of substitutions to perform -during resource lookups. +during resource lookups. It is ignored when running in a setuid process. A substitution has the form @@ -61880,7 +59106,6 @@ version will be used instead. Whiteouts are not currently supported. Substitutions must start with a slash, and must not contain a trailing slash before the '='. The path after the slash should ideally be absolute, but this is not strictly required. It is possible to overlay the location of a single resource with an individual file. - Creates a GResource from a reference to the binary resource bundle. This will keep a reference to @data while the resource lives, so @@ -61894,7 +59119,6 @@ Otherwise this function will internally create a copy of the memory since GLib 2.56, or in older versions fail and exit the process. If @data is empty or corrupt, %G_RESOURCE_ERROR_INTERNAL will be returned. - a new #GResource, or %NULL on error @@ -61910,7 +59134,6 @@ If @data is empty or corrupt, %G_RESOURCE_ERROR_INTERNAL will be returned. Registers the resource with the process-global set of resources. Once a resource is registered the files in it can be accessed with the global resource lookup functions like g_resources_lookup_data(). - @@ -61923,7 +59146,6 @@ with the global resource lookup functions like g_resources_lookup_data(). Unregisters the resource from the process-global set of resources. - @@ -61943,7 +59165,6 @@ If @path is invalid or does not exist in the #GResource, %G_RESOURCE_ERROR_NOT_FOUND will be returned. @lookup_flags controls the behaviour of the lookup. - an array of constant strings @@ -61970,7 +59191,6 @@ If @path is invalid or does not exist in the #GResource, if found returns information about it. @lookup_flags controls the behaviour of the lookup. - %TRUE if the file was found. %FALSE if there were errors @@ -62015,7 +59235,6 @@ in the program binary. For compressed files we allocate memory on the heap and automatically uncompress the data. @lookup_flags controls the behaviour of the lookup. - #GBytes or %NULL on error. Free the returned object with g_bytes_unref() @@ -62041,7 +59260,6 @@ the heap and automatically uncompress the data. returns a #GInputStream that lets you read the data. @lookup_flags controls the behaviour of the lookup. - #GInputStream or %NULL on error. Free the returned object with g_object_unref() @@ -62065,7 +59283,6 @@ returns a #GInputStream that lets you read the data. Atomically increments the reference count of @resource by one. This function is MT-safe and may be called from any thread. - The passed in #GResource @@ -62082,7 +59299,6 @@ function is MT-safe and may be called from any thread. reference count drops to 0, all memory allocated by the resource is released. This function is MT-safe and may be called from any thread. - @@ -62104,7 +59320,6 @@ If @filename is empty or the data in it is corrupt, %G_RESOURCE_ERROR_INTERNAL will be returned. If @filename doesn’t exist, or there is an error in reading it, an error from g_mapped_file_new() will be returned. - a new #GResource, or %NULL on error @@ -62151,35 +59366,30 @@ bundle. - - - - - @@ -62187,305 +59397,261 @@ bundle. Extension point for #GSettingsBackend functionality. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - @@ -62506,10 +59672,8 @@ truncated. #GSeekable on resizable streams is approximately the same as POSIX lseek() on a normal file. Seeking past the end and writing data will usually cause the stream to resize by introducing zero bytes. - Tests if the stream supports the #GSeekableIface. - %TRUE if @seekable can be seeked. %FALSE otherwise. @@ -62524,7 +59688,6 @@ usually cause the stream to resize by introducing zero bytes. Tests if the length of the stream can be adjusted with g_seekable_truncate(). - %TRUE if the stream can be truncated, %FALSE otherwise. @@ -62551,7 +59714,6 @@ Any operation that would result in a negative offset will fail. If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. - %TRUE if successful. If an error has occurred, this function will return %FALSE and set @error @@ -62579,7 +59741,6 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. Tells the current position within the stream. - the offset from the beginning of the buffer. @@ -62601,7 +59762,6 @@ triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. If an operation was partially finished when the operation was cancelled the partial result will be returned, without an error. - %TRUE if successful. If an error has occurred, this function will return %FALSE and set @error @@ -62625,7 +59785,6 @@ partial result will be returned, without an error. Tests if the stream supports the #GSeekableIface. - %TRUE if @seekable can be seeked. %FALSE otherwise. @@ -62640,7 +59799,6 @@ partial result will be returned, without an error. Tests if the length of the stream can be adjusted with g_seekable_truncate(). - %TRUE if the stream can be truncated, %FALSE otherwise. @@ -62667,7 +59825,6 @@ Any operation that would result in a negative offset will fail. If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. - %TRUE if successful. If an error has occurred, this function will return %FALSE and set @error @@ -62695,7 +59852,6 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. Tells the current position within the stream. - the offset from the beginning of the buffer. @@ -62717,7 +59873,6 @@ triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. If an operation was partially finished when the operation was cancelled the partial result will be returned, without an error. - %TRUE if successful. If an error has occurred, this function will return %FALSE and set @error @@ -62742,14 +59897,12 @@ partial result will be returned, without an error. Provides an interface for implementing seekable functionality on I/O Streams. - The parent interface. - the offset from the beginning of the buffer. @@ -62764,7 +59917,6 @@ partial result will be returned, without an error. - %TRUE if @seekable can be seeked. %FALSE otherwise. @@ -62779,7 +59931,6 @@ partial result will be returned, without an error. - %TRUE if successful. If an error has occurred, this function will return %FALSE and set @error @@ -62808,7 +59959,6 @@ partial result will be returned, without an error. - %TRUE if the stream can be truncated, %FALSE otherwise. @@ -62823,7 +59973,6 @@ partial result will be returned, without an error. - %TRUE if successful. If an error has occurred, this function will return %FALSE and set @error @@ -63135,7 +60284,6 @@ which are specified in `gsettings_ENUM_FILES`. This will generate a automatically included in the schema compilation, install and uninstall rules. It should not be committed to version control or included in `EXTRA_DIST`. - Creates a new #GSettings object with the schema specified by @schema_id. @@ -63150,7 +60298,6 @@ Signals on the newly created #GSettings object will be dispatched via the thread-default #GMainContext in effect at the time of the call to g_settings_new(). The new #GSettings will hold a reference on the context. See g_main_context_push_thread_default(). - a new #GSettings object @@ -63186,7 +60333,6 @@ If @path is %NULL then the path from the schema is used. It is an error if @path is %NULL and the schema has no path of its own or if @path is non-%NULL and not equal to the path that the schema does have. - a new #GSettings object @@ -63215,7 +60361,6 @@ settings from a database other than the usual one. For example, it may make sense to pass a backend corresponding to the "defaults" settings database on the system to get a settings object that modifies the system default settings instead of the settings for this user. - a new #GSettings object @@ -63237,7 +60382,6 @@ settings instead of the settings for this user. This is a mix of g_settings_new_with_backend() and g_settings_new_with_path(). - a new #GSettings object @@ -63271,7 +60415,6 @@ has an explicitly specified path. It is a programmer error if @path is not a valid path. A valid path begins and ends with '/' and does not contain two consecutive '/' characters. - a new #GSettings object @@ -63290,7 +60433,6 @@ characters. Deprecated. Use g_settings_schema_source_list_schemas() instead - a list of relocatable #GSettings schemas that are available, in no defined order. The list must @@ -63306,7 +60448,6 @@ characters. 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. - a list of #GSettings schemas that are available, in no defined order. The list must not be @@ -63327,7 +60468,6 @@ This call will block until all of the writes have made it to the backend. Since the mainloop is not running, no change notifications will be dispatched during this call (but some may be queued by the time the call is done). - @@ -63338,7 +60478,6 @@ time the call is done). Note that bindings are automatically removed when the object is finalized, so it is rarely necessary to call this function. - @@ -63354,7 +60493,6 @@ function. - @@ -63371,7 +60509,6 @@ function. - @@ -63385,7 +60522,6 @@ function. - @@ -63399,7 +60535,6 @@ function. - @@ -63417,7 +60552,6 @@ function. function does nothing unless @settings is in 'delay-apply' mode; see g_settings_delay(). In the normal case settings are always applied immediately. - @@ -63449,7 +60583,6 @@ Note that the lifecycle of the binding is tied to @object, and that you can have only one binding per object property. If you bind the same property twice on the same object, the second binding overrides the first one. - @@ -63487,7 +60620,6 @@ Note that the lifecycle of the binding is tied to @object, and that you can have only one binding per object property. If you bind the same property twice on the same object, the second binding overrides the first one. - @@ -63550,7 +60682,6 @@ Note that the lifecycle of the binding is tied to @object, and that you can have only one binding per object property. If you bind the same property twice on the same object, the second binding overrides the first one. - @@ -63592,7 +60723,6 @@ For boolean-valued keys, action activations take no parameter and result in the toggling of the value. For all other types, activations take the new value for the key (which must have the correct type). - a new #GAction @@ -63612,7 +60742,6 @@ correct type). Changes the #GSettings object into 'delay-apply' mode. In this mode, changes to @settings are not immediately propagated to the backend, but kept locally until g_settings_apply() is called. - @@ -63632,7 +60761,6 @@ g_variant_get(). It is a programmer error to give a @key that isn't contained in the schema for @settings or for the #GVariantType of @format to mismatch the type given in the schema. - @@ -63662,7 +60790,6 @@ A convenience variant of g_settings_get() for booleans. It is a programmer error to give a @key that isn't specified as having a boolean type in the schema for @settings. - a boolean @@ -63685,7 +60812,6 @@ having a boolean type in the schema for @settings. The schema for the child settings object must have been declared in the schema of @settings using a <child> element. - a 'child' settings object @@ -63723,7 +60849,6 @@ the default value was before the user set it. It is a programmer error to give a @key that isn't contained in the schema for @settings. - the default value @@ -63746,7 +60871,6 @@ A convenience variant of g_settings_get() for doubles. It is a programmer error to give a @key that isn't specified as having a 'double' type in the schema for @settings. - a double @@ -63775,7 +60899,6 @@ schema for @settings or is not marked as an enumerated type. If the value stored in the configuration database is not a valid value for the enumerated type then this function will return the default value. - the enum value @@ -63804,7 +60927,6 @@ schema for @settings or is not marked as a flags type. If the value stored in the configuration database is not a valid value for the flags type then this function will return the default value. - the flags value @@ -63823,7 +60945,6 @@ value. Returns whether the #GSettings object has any unapplied changes. This can only be the case if it is in 'delayed-apply' mode. - %TRUE if @settings has unapplied changes @@ -63842,7 +60963,6 @@ A convenience variant of g_settings_get() for 32-bit integers. It is a programmer error to give a @key that isn't specified as having a int32 type in the schema for @settings. - an integer @@ -63865,7 +60985,6 @@ A convenience variant of g_settings_get() for 64-bit integers. It is a programmer error to give a @key that isn't specified as having a int64 type in the schema for @settings. - a 64-bit integer @@ -63909,7 +61028,6 @@ The result parameter for the @mapping function is pointed to a to each invocation of @mapping. The final value of that #gpointer is what is returned by this function. %NULL is valid; it is returned just as any other value would be. - the result, which may be %NULL @@ -63937,7 +61055,6 @@ just as any other value would be. Queries the range of a key. Use g_settings_schema_key_get_range() instead. - @@ -63959,7 +61076,6 @@ A convenience variant of g_settings_get() for strings. It is a programmer error to give a @key that isn't specified as having a string type in the schema for @settings. - a newly-allocated string @@ -63980,7 +61096,6 @@ having a string type in the schema for @settings. It is a programmer error to give a @key that isn't specified as having an array of strings type in the schema for @settings. - a newly-allocated, %NULL-terminated array of strings, the value that @@ -64008,7 +61123,6 @@ integers. It is a programmer error to give a @key that isn't specified as having a uint32 type in the schema for @settings. - an unsigned integer @@ -64032,7 +61146,6 @@ integers. It is a programmer error to give a @key that isn't specified as having a uint64 type in the schema for @settings. - a 64-bit unsigned integer @@ -64067,7 +61180,6 @@ for providing indication that a particular value has been changed. It is a programmer error to give a @key that isn't contained in the schema for @settings. - the user's value, if set @@ -64088,7 +61200,6 @@ schema for @settings. It is a programmer error to give a @key that isn't contained in the schema for @settings. - a new #GVariant @@ -64106,7 +61217,6 @@ schema for @settings. Finds out if a key can be written or not - %TRUE if the key @name is writable @@ -64134,7 +61244,6 @@ may still be useful there for introspection reasons, however. You should free the return value with g_strfreev() when you are done with it. - a list of the children on @settings, in no defined order @@ -64159,7 +61268,6 @@ function is intended for introspection reasons. You should free the return value with g_strfreev() when you are done with it. Use g_settings_schema_list_keys() instead. - a list of the keys on @settings, in no defined order @@ -64178,7 +61286,6 @@ with it. Checks if the given @value is of the correct type and within the permitted range for @key. Use g_settings_schema_key_range_check() instead. - %TRUE if @value is valid for @key @@ -64204,7 +61311,6 @@ permitted range for @key. This call resets the key, as much as possible, to its default value. That might be the value specified in the schema or the one set by the administrator. - @@ -64226,7 +61332,6 @@ g_settings_delay(). In the normal case settings are always applied immediately. Change notifications will be emitted for affected keys. - @@ -64246,7 +61351,6 @@ g_variant_new(). It is a programmer error to give a @key that isn't contained in the schema for @settings or for the #GVariantType of @format to mismatch the type given in the schema. - %TRUE if setting the key succeeded, %FALSE if the key was not writable @@ -64278,7 +61382,6 @@ A convenience variant of g_settings_set() for booleans. It is a programmer error to give a @key that isn't specified as having a boolean type in the schema for @settings. - %TRUE if setting the key succeeded, %FALSE if the key was not writable @@ -64306,7 +61409,6 @@ A convenience variant of g_settings_set() for doubles. It is a programmer error to give a @key that isn't specified as having a 'double' type in the schema for @settings. - %TRUE if setting the key succeeded, %FALSE if the key was not writable @@ -64338,7 +61440,6 @@ schema for @settings or is not marked as an enumerated type, or for After performing the write, accessing @key directly with g_settings_get_string() will return the 'nick' associated with @value. - %TRUE, if the set succeeds @@ -64370,7 +61471,6 @@ to contain any bits that are not value for the named type. After performing the write, accessing @key directly with g_settings_get_strv() will return an array of 'nicks'; one for each bit in @value. - %TRUE, if the set succeeds @@ -64397,7 +61497,6 @@ A convenience variant of g_settings_set() for 32-bit integers. It is a programmer error to give a @key that isn't specified as having a int32 type in the schema for @settings. - %TRUE if setting the key succeeded, %FALSE if the key was not writable @@ -64425,7 +61524,6 @@ A convenience variant of g_settings_set() for 64-bit integers. It is a programmer error to give a @key that isn't specified as having a int64 type in the schema for @settings. - %TRUE if setting the key succeeded, %FALSE if the key was not writable @@ -64453,7 +61551,6 @@ A convenience variant of g_settings_set() for strings. It is a programmer error to give a @key that isn't specified as having a string type in the schema for @settings. - %TRUE if setting the key succeeded, %FALSE if the key was not writable @@ -64482,7 +61579,6 @@ A convenience variant of g_settings_set() for string arrays. If It is a programmer error to give a @key that isn't specified as having an array of strings type in the schema for @settings. - %TRUE if setting the key succeeded, %FALSE if the key was not writable @@ -64513,7 +61609,6 @@ integers. It is a programmer error to give a @key that isn't specified as having a uint32 type in the schema for @settings. - %TRUE if setting the key succeeded, %FALSE if the key was not writable @@ -64542,7 +61637,6 @@ integers. It is a programmer error to give a @key that isn't specified as having a uint64 type in the schema for @settings. - %TRUE if setting the key succeeded, %FALSE if the key was not writable @@ -64571,7 +61665,6 @@ schema for @settings or for @value to have the incorrect type, per the schema. If @value is floating then this function consumes the reference. - %TRUE if setting the key succeeded, %FALSE if the key was not writable @@ -64776,7 +61869,6 @@ implementations, but does not carry the same stability guarantees as the public GIO API. For this reason, you have to define the C preprocessor symbol %G_SETTINGS_ENABLE_BACKEND before including `gio/gsettingsbackend.h`. - Calculate the longest common prefix of all keys in a tree and write out an array of the key names relative to that prefix and, @@ -64785,7 +61877,6 @@ optionally, the value to store at each of those keys. You must free the value returned in @path, @keys and @values using g_free(). You should not attempt to free or unref the contents of @keys or @values. - @@ -64820,14 +61911,14 @@ the default by setting the `GSETTINGS_BACKEND` environment variable to the name of a settings backend. The user gets a reference to the backend. - - the default #GSettingsBackend + the default #GSettingsBackend, + which will be a dummy (memory) settings backend if no other settings + backend is available. - @@ -64841,7 +61932,6 @@ The user gets a reference to the backend. - @@ -64855,7 +61945,6 @@ The user gets a reference to the backend. - @@ -64875,7 +61964,6 @@ The user gets a reference to the backend. - @@ -64892,7 +61980,6 @@ The user gets a reference to the backend. - @@ -64909,7 +61996,6 @@ The user gets a reference to the backend. - @@ -64923,7 +62009,6 @@ The user gets a reference to the backend. - @@ -64934,7 +62019,6 @@ The user gets a reference to the backend. - @@ -64948,7 +62032,6 @@ The user gets a reference to the backend. - @@ -64968,7 +62051,6 @@ The user gets a reference to the backend. - @@ -65007,7 +62089,6 @@ g_settings_backend_write()). In the case that this call is in response to a call to g_settings_backend_write() then @origin_tag must be set to the same value that was passed to that call. - @@ -65030,7 +62111,6 @@ value that was passed to that call. This call is a convenience wrapper. It gets the list of changes from @tree, computes the longest common prefix and calls g_settings_backend_changed(). - @@ -65071,7 +62151,6 @@ case g_settings_backend_changed() is definitely preferred). For efficiency reasons, the implementation should strive for @path to be as long as possible (ie: the longest common prefix of all of the keys that were changed) but this is not strictly required. - @@ -65118,7 +62197,6 @@ be as long as possible (ie: the longest common prefix of all of the keys that were changed) but this is not strictly required. As an example, if this function is called with the path of "/" then every single key in the application will be notified of a possible change. - @@ -65143,7 +62221,6 @@ changed. Since GSettings performs no locking operations for itself, this call will always be made in response to external events. - @@ -65163,7 +62240,6 @@ will always be made in response to external events. Since GSettings performs no locking operations for itself, this call will always be made in response to external events. - @@ -65187,13 +62263,11 @@ will always be made in response to external events. Class structure for #GSettingsBackend. - - @@ -65215,7 +62289,6 @@ will always be made in response to external events. - @@ -65231,7 +62304,6 @@ will always be made in response to external events. - @@ -65253,7 +62325,6 @@ will always be made in response to external events. - @@ -65272,7 +62343,6 @@ will always be made in response to external events. - @@ -65291,7 +62361,6 @@ will always be made in response to external events. - @@ -65307,7 +62376,6 @@ will always be made in response to external events. - @@ -65323,7 +62391,6 @@ will always be made in response to external events. - @@ -65336,7 +62403,6 @@ will always be made in response to external events. - @@ -65352,7 +62418,6 @@ will always be made in response to external events. - @@ -65375,9 +62440,7 @@ will always be made in response to external events. - - - + Flags used when creating a binding. These flags determine in which direction the binding works. The default is to synchronize in both @@ -65410,7 +62473,6 @@ directions. The type for the function that is used to convert from #GSettings to an object property. The @value is already initialized to hold values of the appropriate type. - %TRUE if the conversion succeeded, %FALSE in case of an error @@ -65433,7 +62495,6 @@ of the appropriate type. The type for the function that is used to convert an object property value to a #GVariant for storing it in #GSettings. - a new #GVariant holding the data from @value, or %NULL in case of an error @@ -65455,13 +62516,11 @@ value to a #GVariant for storing it in #GSettings. - - @@ -65477,7 +62536,6 @@ value to a #GVariant for storing it in #GSettings. - @@ -65493,7 +62551,6 @@ value to a #GVariant for storing it in #GSettings. - @@ -65509,7 +62566,6 @@ value to a #GVariant for storing it in #GSettings. - @@ -65543,7 +62599,6 @@ is not in the right format) then %FALSE should be returned. If @value is %NULL then it means that the mapping function is being given a "last chance" to successfully return a valid value. %TRUE must be returned in this case. - %TRUE if the conversion succeeded, %FALSE in case of an error @@ -65564,9 +62619,7 @@ g_settings_get_mapped() - - - + The #GSettingsSchemaSource and #GSettingsSchema APIs provide a mechanism for advanced control over the loading of schemas and a @@ -65658,10 +62711,8 @@ It's also possible that the plugin system expects the schema source files (ie: .gschema.xml files) instead of a gschemas.compiled file. In that case, the plugin loading system must compile the schemas for itself before attempting to create the settings source. - Get the ID of @schema. - the ID @@ -65678,7 +62729,6 @@ itself before attempting to create the settings source. It is a programmer error to request a key that does not exist. See g_settings_schema_list_keys(). - the #GSettingsSchemaKey for @name @@ -65704,8 +62754,7 @@ database: those located at the path returned by this function. Relocatable schemas can be referenced by other schemas and can therefore describe multiple sets of keys at different locations. For relocatable schemas, this function will return %NULL. - - + the path of the schema, or %NULL @@ -65718,7 +62767,6 @@ relocatable schemas, this function will return %NULL. Checks if @schema has a key named @name. - %TRUE if such a key exists @@ -65739,7 +62787,6 @@ relocatable schemas, this function will return %NULL. You should free the return value with g_strfreev() when you are done with it. - a list of the children on @settings, in no defined order @@ -65760,7 +62807,6 @@ with it. You should probably not be calling this function from "normal" code (since you should already know what keys are in your schema). This function is intended for introspection reasons. - a list of the keys on @schema, in no defined order @@ -65777,7 +62823,6 @@ function is intended for introspection reasons. Increase the reference count of @schema, returning a new reference. - a new reference to @schema @@ -65791,7 +62836,6 @@ function is intended for introspection reasons. Decrease the reference count of @schema, possibly freeing it. - @@ -65806,13 +62850,11 @@ function is intended for introspection reasons. #GSettingsSchemaKey is an opaque data structure and can only be accessed using the following functions. - Gets the default value for @key. Note that this is the default value according to the schema. System administrator defaults and lockdown are not visible via this API. - the default value for the key @@ -65839,8 +62881,7 @@ This function is slow. The summary and description information for the schemas is not stored in the compiled schema database so this function has to parse all of the source XML files in the schema directory. - - + the description for @key, or %NULL @@ -65853,7 +62894,6 @@ directory. Gets the name of @key. - the name of @key. @@ -65902,7 +62942,6 @@ forms may be added to the possibilities described above. You should free the returned value with g_variant_unref() when it is no longer needed. - a #GVariant describing the range @@ -65928,8 +62967,7 @@ This function is slow. The summary and description information for the schemas is not stored in the compiled schema database so this function has to parse all of the source XML files in the schema directory. - - + the summary for @key, or %NULL @@ -65942,7 +62980,6 @@ directory. Gets the #GVariantType of @key. - the type of @key @@ -65960,7 +62997,6 @@ permitted range for @key. It is a programmer error if @value is not of the correct type -- you must check for this first. - %TRUE if @value is valid for @key @@ -65978,7 +63014,6 @@ must check for this first. Increase the reference count of @key, returning a new reference. - a new reference to @key @@ -65992,7 +63027,6 @@ must check for this first. Decrease the reference count of @key, possibly freeing it. - @@ -66006,7 +63040,6 @@ must check for this first. This is an opaque structure type. You may not access it directly. - Attempts to create a new schema source corresponding to the contents of the given directory. @@ -66039,7 +63072,6 @@ from the @parent. For this second reason, except in very unusual situations, the @parent should probably be given as the default schema source, as returned by g_settings_schema_source_get_default(). - @@ -66071,7 +63103,6 @@ use g_settings_new_with_path(). Do not call this function from normal programs. This is designed for use by database editors, commandline tools, etc. - @@ -66111,7 +63142,6 @@ If the schema isn't found directly in @source and @recursive is %TRUE then the parent sources will also be checked. If the schema isn't found, %NULL is returned. - a new #GSettingsSchema @@ -66133,7 +63163,6 @@ If the schema isn't found, %NULL is returned. Increase the reference count of @source, returning a new reference. - a new reference to @source @@ -66147,7 +63176,6 @@ If the schema isn't found, %NULL is returned. Decrease the reference count of @source, possibly freeing it. - @@ -66172,7 +63200,6 @@ from different directories, depending on which directories were given in `XDG_DATA_DIRS` and `GSETTINGS_SCHEMA_DIR`. For this reason, all lookups performed against the default source should probably be done recursively. - the default schema source @@ -66191,7 +63218,6 @@ See also #GtkAction. The created action is stateless. See g_simple_action_new_stateful() to create an action that has state. - a new #GSimpleAction @@ -66215,7 +63241,6 @@ All future state values must have the same #GVariantType as the initial @state. If the @state #GVariant is floating, it is consumed. - a new #GSimpleAction @@ -66244,7 +63269,6 @@ have its state changed from outside callers. This should only be called by the implementor of the action. Users of the action should not attempt to modify its enabled flag. - @@ -66270,7 +63294,6 @@ property. Instead, they should call g_action_change_state() to request the change. If the @value GVariant is floating, it is consumed. - @@ -66290,7 +63313,6 @@ If the @value GVariant is floating, it is consumed. See g_action_get_state_hint() for more information about action state hints. - @@ -66404,12 +63426,10 @@ It could set it to any value at all, or take some other action. #GSimpleActionGroup is a hash table filled with #GAction objects, implementing the #GActionGroup and #GActionMap interfaces. - Creates a new, empty, #GSimpleActionGroup. - a new #GSimpleActionGroup @@ -66419,7 +63439,6 @@ implementing the #GActionGroup and #GActionMap interfaces. A convenience function for creating multiple #GSimpleAction instances and adding them to the action group. Use g_action_map_add_action_entries() - @@ -66453,7 +63472,6 @@ If the action group already contains an action with the same name as The action group takes its own reference on @action. Use g_action_map_add_action() - @@ -66473,7 +63491,6 @@ The action group takes its own reference on @action. If no such action exists, returns %NULL. Use g_action_map_lookup_action() - a #GAction, or %NULL @@ -66494,7 +63511,6 @@ If no such action exists, returns %NULL. If no action of this name is in the group then nothing happens. Use g_action_map_remove_action() - @@ -66517,7 +63533,6 @@ If no action of this name is in the group then nothing happens. - @@ -66527,9 +63542,7 @@ If no action of this name is in the group then nothing happens. - - - + As of GLib 2.46, #GSimpleAsyncResult is deprecated in favor of #GTask, which provides a simpler API. @@ -66696,7 +63709,6 @@ baker_bake_cake_finish (Baker *self, return g_object_ref (cake); } ]| - Creates a #GSimpleAsyncResult. @@ -66710,7 +63722,6 @@ probably should) then you should provide the user's cancellable to g_simple_async_result_set_check_cancellable() immediately after this function returns. Use g_task_new() instead. - a #GSimpleAsyncResult. @@ -66737,7 +63748,6 @@ this function returns. Creates a new #GSimpleAsyncResult with a set error. Use g_task_new() and g_task_return_new_error() instead. - a #GSimpleAsyncResult. @@ -66776,7 +63786,6 @@ this function returns. Creates a #GSimpleAsyncResult from an error condition. Use g_task_new() and g_task_return_error() instead. - a #GSimpleAsyncResult. @@ -66804,7 +63813,6 @@ this function returns. Creates a #GSimpleAsyncResult from an error condition, and takes over the caller's ownership of @error, so the caller does not need to free it anymore. Use g_task_new() and g_task_return_error() instead. - a #GSimpleAsyncResult @@ -66842,7 +63850,6 @@ which this function is called). (Alternatively, if either @source_tag or @result's source tag is %NULL, then the source tag check is skipped.) Use #GTask and g_task_is_valid() instead. - #TRUE if all checks passed or #FALSE if any failed. @@ -66871,7 +63878,6 @@ g_simple_async_result_complete_in_idle(). Calling this function takes a reference to @simple for as long as is needed to complete the call. Use #GTask instead. - @@ -66891,7 +63897,6 @@ of the thread that @simple was initially created in Calling this function takes a reference to @simple for as long as is needed to complete the call. Use #GTask instead. - @@ -66905,7 +63910,6 @@ is needed to complete the call. Gets the operation result boolean from within the asynchronous result. Use #GTask and g_task_propagate_boolean() instead. - %TRUE if the operation's result was %TRUE, %FALSE if the operation's result was %FALSE. @@ -66921,7 +63925,6 @@ is needed to complete the call. Gets a pointer result as returned by the asynchronous function. Use #GTask and g_task_propagate_pointer() instead. - a pointer from the result. @@ -66936,7 +63939,6 @@ is needed to complete the call. Gets a gssize from the asynchronous result. Use #GTask and g_task_propagate_int() instead. - a gssize returned from the asynchronous function. @@ -66951,7 +63953,6 @@ is needed to complete the call. Gets the source tag for the #GSimpleAsyncResult. Use #GTask and g_task_get_source_tag() instead. - a #gpointer to the source object for the #GSimpleAsyncResult. @@ -66971,7 +63972,6 @@ If the #GCancellable given to a prior call to g_simple_async_result_set_check_cancellable() is cancelled then this function will return %TRUE with @dest set appropriately. Use #GTask instead. - %TRUE if the error was propagated to @dest. %FALSE otherwise. @@ -66991,7 +63991,6 @@ the result to the appropriate main loop. Calling this function takes a reference to @simple for as long as is needed to run the job and report its completion. Use #GTask and g_task_run_in_thread() instead. - @@ -67031,7 +64030,6 @@ already been sent as an idle to the main context to be dispatched). The checking described above is done regardless of any call to the unrelated g_simple_async_result_set_handle_cancellation() function. Use #GTask instead. - @@ -67049,7 +64047,6 @@ unrelated g_simple_async_result_set_handle_cancellation() function. Sets an error within the asynchronous result without a #GError. Use #GTask and g_task_return_new_error() instead. - @@ -67080,7 +64077,6 @@ unrelated g_simple_async_result_set_handle_cancellation() function. Sets an error within the asynchronous result without a #GError. Unless writing a binding, see g_simple_async_result_set_error(). Use #GTask and g_task_return_error() instead. - @@ -67110,7 +64106,6 @@ Unless writing a binding, see g_simple_async_result_set_error(). Sets the result from a #GError. Use #GTask and g_task_return_error() instead. - @@ -67131,7 +64126,6 @@ Unless writing a binding, see g_simple_async_result_set_error(). This function has nothing to do with g_simple_async_result_set_check_cancellable(). It only refers to the #GCancellable passed to g_simple_async_result_run_in_thread(). - @@ -67149,7 +64143,6 @@ g_simple_async_result_set_check_cancellable(). It only refers to the Sets the operation result to a boolean within the asynchronous result. Use #GTask and g_task_return_boolean() instead. - @@ -67167,7 +64160,6 @@ g_simple_async_result_set_check_cancellable(). It only refers to the Sets the operation result within the asynchronous result to a pointer. Use #GTask and g_task_return_pointer() instead. - @@ -67190,7 +64182,6 @@ g_simple_async_result_set_check_cancellable(). It only refers to the Sets the operation result within the asynchronous result to the given @op_res. Use #GTask and g_task_return_int() instead. - @@ -67209,7 +64200,6 @@ the given @op_res. Sets the result from @error, and takes over the caller's ownership of @error, so the caller does not need to free it any more. Use #GTask and g_task_return_error() instead. - @@ -67225,13 +64215,10 @@ of @error, so the caller does not need to free it any more. - - - + Simple thread function that runs an asynchronous operation and checks for cancellation. - @@ -67262,7 +64249,6 @@ to take advantage of the methods provided by #GIOStream. Creates a new #GSimpleIOStream wrapping @input_stream and @output_stream. See also #GIOStream. - a new #GSimpleIOStream instance. @@ -67294,7 +64280,6 @@ Calling request or release will result in errors. Creates a new #GPermission instance that represents an action that is either always or never allowed. - the #GSimplePermission, as a #GPermission @@ -67316,14 +64301,12 @@ proxies, and a list of hosts that proxies should not be used for. can be used as the base class for another proxy resolver implementation, or it can be created and used manually, such as with g_socket_client_set_proxy_resolver(). - Creates a new #GSimpleProxyResolver. See #GSimpleProxyResolver:default-proxy and #GSimpleProxyResolver:ignore-hosts for more details on how the arguments are interpreted. - a new #GSimpleProxyResolver @@ -67349,7 +64332,6 @@ via g_simple_proxy_resolver_set_uri_proxy(). If @default_proxy starts with "socks://", #GSimpleProxyResolver will treat it as referring to all three of the socks5, socks4a, and socks4 proxy types. - @@ -67369,7 +64351,6 @@ the socks5, socks4a, and socks4 proxy types. See #GSimpleProxyResolver:ignore-hosts for more details on how the @ignore_hosts argument is interpreted. - @@ -67394,7 +64375,6 @@ As with #GSimpleProxyResolver:default-proxy, if @proxy starts with "socks://", #GSimpleProxyResolver will treat it as referring to all three of the socks5, socks4a, and socks4 proxy types. - @@ -67470,13 +64450,11 @@ commonly used by other applications. - - @@ -67484,7 +64462,6 @@ commonly used by other applications. - @@ -67492,7 +64469,6 @@ commonly used by other applications. - @@ -67500,7 +64476,6 @@ commonly used by other applications. - @@ -67508,16 +64483,13 @@ commonly used by other applications. - - - - + A #GSocket is a low-level networking primitive. It is a more or less direct mapping of the BSD socket API in a portable GObject based API. @@ -67570,7 +64542,6 @@ if it tries to write to %stdout after it has been closed. Like most other APIs in GLib, #GSocket is not inherently thread safe. To use a #GSocket concurrently from multiple threads, you must implement your own locking. - @@ -67587,7 +64558,6 @@ the family and type. The protocol id is passed directly to the operating system, so you can use protocols not listed in #GSocketProtocol if you know the protocol number used for it. - a #GSocket or %NULL on error. Free the returned object with g_object_unref(). @@ -67622,7 +64592,6 @@ caller must close @fd themselves. Since GLib 2.46, it is no longer a fatal error to call this on a non-socket descriptor. Instead, a GError will be set with code %G_IO_ERROR_FAILED - a #GSocket or %NULL on error. Free the returned object with g_object_unref(). @@ -67646,7 +64615,6 @@ must be listening for incoming connections (g_socket_listen()). If there are no outstanding connections then the operation will block or return %G_IO_ERROR_WOULD_BLOCK if non-blocking I/O is enabled. To be notified of an incoming connection, wait for the %G_IO_IN condition. - a new #GSocket, or %NULL on error. Free the returned object with g_object_unref(). @@ -67687,7 +64655,6 @@ time. In particular, you can have several UDP sockets bound to the same address, and they will all receive all of the multicast and broadcast packets sent to that address. (The behavior of unicast UDP packets to an address with multiple listeners is not defined.) - %TRUE on success, %FALSE on error. @@ -67711,7 +64678,6 @@ UDP packets to an address with multiple listeners is not defined.) Checks and resets the pending connect error for the socket. This is used to check for errors when g_socket_connect() is used in non-blocking mode. - %TRUE if no error, %FALSE otherwise, setting @error to the error @@ -67753,7 +64719,6 @@ connection, after which the server can safely call g_socket_close(). g_tcp_connection_set_graceful_disconnect(). But of course, this only works if the client will close its connection after the server does.) - %TRUE on success, %FALSE on error @@ -67783,7 +64748,6 @@ It is meaningless to specify %G_IO_ERR or %G_IO_HUP in condition; these conditions will always be set in the output if they are true. This call never blocks. - the @GIOCondition mask of the current state @@ -67816,7 +64780,6 @@ Note that although @timeout_us is in microseconds for consistency with other GLib APIs, this function actually only has millisecond resolution, and the behavior is undefined if @timeout_us is not an exact number of milliseconds. - %TRUE if the condition was met, %FALSE otherwise @@ -67851,7 +64814,6 @@ the appropriate value (%G_IO_ERROR_CANCELLED or %G_IO_ERROR_TIMED_OUT). See also g_socket_condition_timed_wait(). - %TRUE if the condition was met, %FALSE otherwise @@ -67888,7 +64850,6 @@ non-blocking I/O is enabled. Then %G_IO_ERROR_PENDING is returned and the user can be notified of the connection finishing by waiting for the G_IO_OUT condition. The result of the connection must then be checked with g_socket_check_connect_result(). - %TRUE if connected, %FALSE on error. @@ -67911,7 +64872,6 @@ checked with g_socket_check_connect_result(). Creates a #GSocketConnection subclass of the right type for @socket. - a #GSocketConnection @@ -67944,7 +64904,6 @@ occurs, the source will then trigger anyway, reporting %G_IO_IN or %G_IO_OUT depending on @condition. However, @socket will have been marked as having had a timeout, and so the next #GSocket I/O method you call will then fail with a %G_IO_ERROR_TIMED_OUT. - a newly allocated %GSource, free with g_source_unref(). @@ -67977,7 +64936,6 @@ of the incoming packet, it is better to just do a g_socket_receive() with a buffer of that size, rather than calling g_socket_get_available_bytes() first and then doing a receive of exactly the right size. - the number of bytes that can be read from the socket without blocking or truncating, or -1 on error. @@ -67993,7 +64951,6 @@ without blocking or truncating, or -1 on error. Gets the blocking mode of the socket. For details on blocking I/O, see g_socket_set_blocking(). - %TRUE if blocking I/O is used, %FALSE otherwise. @@ -68009,7 +64966,6 @@ see g_socket_set_blocking(). Gets the broadcast setting on @socket; if %TRUE, it is possible to send packets to broadcast addresses. - the broadcast setting on @socket @@ -68042,7 +64998,6 @@ Other ways to obtain credentials from a foreign peer includes the #GUnixCredentialsMessage type and g_unix_connection_send_credentials() / g_unix_connection_receive_credentials() functions. - %NULL if @error is set, otherwise a #GCredentials object that must be freed with g_object_unref(). @@ -68057,7 +65012,6 @@ that must be freed with g_object_unref(). Gets the socket family of the socket. - a #GSocketFamily @@ -68075,7 +65029,6 @@ is a socket file descriptor, and on Windows this is a Winsock2 SOCKET handle. This may be useful for doing platform specific or otherwise unusual operations on the socket. - the file descriptor of the socket. @@ -68090,7 +65043,6 @@ on the socket. Gets the keepalive mode of the socket. For details on this, see g_socket_set_keepalive(). - %TRUE if keepalive is active, %FALSE otherwise. @@ -68105,7 +65057,6 @@ see g_socket_set_keepalive(). Gets the listen backlog setting of the socket. For details on this, see g_socket_set_listen_backlog(). - the maximum number of pending connections. @@ -68121,7 +65072,6 @@ see g_socket_set_listen_backlog(). Try to get the local address of a bound socket. This is only useful if the socket has been bound to a local address, either explicitly or implicitly when connecting. - a #GSocketAddress or %NULL on error. Free the returned object with g_object_unref(). @@ -68138,7 +65088,6 @@ either explicitly or implicitly when connecting. Gets the multicast loopback setting on @socket; if %TRUE (the default), outgoing multicast packets will be looped back to multicast listeners on the same host. - the multicast loopback setting on @socket @@ -68153,7 +65102,6 @@ multicast listeners on the same host. Gets the multicast time-to-live setting on @socket; see g_socket_set_multicast_ttl() for more details. - the multicast time-to-live setting on @socket @@ -68179,7 +65127,6 @@ headers. Note that even for socket options that are a single byte in size, @value is still a pointer to a #gint variable, not a #guchar; g_socket_get_option() will handle the conversion internally. - success or failure. On failure, @error will be set, and the system error value (`errno` or WSAGetLastError()) will still @@ -68208,7 +65155,6 @@ g_socket_get_option() will handle the conversion internally. Gets the socket protocol id the socket was created with. In case the protocol is unknown, -1 is returned. - a protocol id, or -1 if unknown @@ -68223,7 +65169,6 @@ In case the protocol is unknown, -1 is returned. Try to get the remote address of a connected socket. This is only useful for connection oriented sockets that have been connected. - a #GSocketAddress or %NULL on error. Free the returned object with g_object_unref(). @@ -68238,7 +65183,6 @@ useful for connection oriented sockets that have been connected. Gets the socket type of the socket. - a #GSocketType @@ -68253,7 +65197,6 @@ useful for connection oriented sockets that have been connected. Gets the timeout setting of the socket. For details on this, see g_socket_set_timeout(). - the timeout in seconds @@ -68268,7 +65211,6 @@ g_socket_set_timeout(). Gets the unicast time-to-live setting on @socket; see g_socket_set_ttl() for more details. - the time-to-live setting on @socket @@ -68282,7 +65224,6 @@ g_socket_set_ttl() for more details. Checks whether a socket is closed. - %TRUE if socket is closed, %FALSE otherwise @@ -68302,7 +65243,6 @@ If using g_socket_shutdown(), this function will return %TRUE until the socket has been shut down for reading and writing. If you do a non-blocking connect, this function will not return %TRUE until after you call g_socket_check_connect_result(). - %TRUE if socket is connected, %FALSE otherwise. @@ -68329,7 +65269,6 @@ with a %G_IO_ERROR_NOT_SUPPORTED error. To bind to a given source-specific multicast address, use g_socket_join_multicast_group_ssm() instead. - %TRUE on success, %FALSE on error. @@ -68369,7 +65308,6 @@ with a %G_IO_ERROR_NOT_SUPPORTED error. Note that this function can be called multiple times for the same @group with different @source_specific in order to receive multicast packets from more than one source. - %TRUE on success, %FALSE on error. @@ -68404,7 +65342,6 @@ unicast messages after calling this. To unbind to a given source-specific multicast address, use g_socket_leave_multicast_group_ssm() instead. - %TRUE on success, %FALSE on error. @@ -68435,7 +65372,6 @@ when you joined the group). @socket remains bound to its address and port, and can still receive unicast messages after calling this. - %TRUE on success, %FALSE on error. @@ -68469,7 +65405,6 @@ g_socket_bind(). To set the maximum amount of outstanding clients, use g_socket_set_listen_backlog(). - %TRUE on success, %FALSE on error. @@ -68505,7 +65440,6 @@ returned. To be notified when data is available, wait for the %G_IO_IN condition. On error -1 is returned and @error is set accordingly. - Number of bytes read, or 0 if the connection was closed by the peer, or -1 on error @@ -68541,7 +65475,6 @@ source address of the received packet. @address is owned by the caller. See g_socket_receive() for additional information. - Number of bytes read, or 0 if the connection was closed by the peer, or -1 on error @@ -68634,7 +65567,6 @@ returned. To be notified when data is available, wait for the %G_IO_IN condition. On error -1 is returned and @error is set accordingly. - Number of bytes read, or 0 if the connection was closed by the peer, or -1 on error @@ -68733,7 +65665,6 @@ g_socket_receive_messages() will return 0 (with no error set). On error -1 is returned and @error is set accordingly. An error will only be returned if zero messages could be received; otherwise the number of messages successfully received before the error will be returned. - number of messages received, or -1 on error. Note that the number of messages received may be smaller than @num_messages if in non-blocking @@ -68773,7 +65704,6 @@ messages successfully received before the error will be returned. This behaves exactly the same as g_socket_receive(), except that the choice of blocking or non-blocking behavior is determined by the @blocking argument rather than by @socket's properties. - Number of bytes read, or 0 if the connection was closed by the peer, or -1 on error @@ -68820,7 +65750,6 @@ notified of a %G_IO_OUT condition. (On Windows in particular, this is very common due to the way the underlying APIs work.) On error -1 is returned and @error is set accordingly. - Number of bytes written (which may be less than @size), or -1 on error @@ -68885,8 +65814,12 @@ will be returned. To be notified when space is available, wait for the notified of a %G_IO_OUT condition. (On Windows in particular, this is very common due to the way the underlying APIs work.) +The sum of the sizes of each #GOutputVector in vectors must not be +greater than %G_MAXSSIZE. If the message can be larger than this, +then it is mandatory to use the g_socket_send_message_with_timeout() +function. + On error -1 is returned and @error is set accordingly. - Number of bytes written (which may be less than @size), or -1 on error @@ -68941,7 +65874,6 @@ rather than by @socket's properties. On error %G_POLLABLE_RETURN_FAILED is returned and @error is set accordingly, or if the socket is currently not writable %G_POLLABLE_RETURN_WOULD_BLOCK is returned. @bytes_written will contain 0 in both cases. - %G_POLLABLE_RETURN_OK if all data was successfully written, %G_POLLABLE_RETURN_WOULD_BLOCK if the socket is currently not writable, or @@ -69032,7 +65964,6 @@ very common due to the way the underlying APIs work.) On error -1 is returned and @error is set accordingly. An error will only be returned if zero messages could be sent; otherwise the number of messages successfully sent before the error will be returned. - number of messages sent, or -1 on error. Note that the number of messages sent may be smaller than @num_messages if the socket is @@ -69072,7 +66003,6 @@ successfully sent before the error will be returned. g_socket_connect()). See g_socket_send() for additional information. - Number of bytes written (which may be less than @size), or -1 on error @@ -69108,7 +66038,6 @@ on error This behaves exactly the same as g_socket_send(), except that the choice of blocking or non-blocking behavior is determined by the @blocking argument rather than by @socket's properties. - Number of bytes written (which may be less than @size), or -1 on error @@ -69150,7 +66079,6 @@ with a %G_IO_ERROR_WOULD_BLOCK error. All sockets are created in blocking mode. However, note that the platform level socket is always non-blocking, and blocking mode is a GSocket level feature. - @@ -69168,7 +66096,6 @@ is a GSocket level feature. Sets whether @socket should allow sending to broadcast addresses. This is %FALSE by default. - @@ -69200,7 +66127,6 @@ normally be at least two hours. Most commonly, you would set this flag on a server socket if you want to allow clients to remain idle for long periods of time, but also want to ensure that connections are eventually garbage-collected if clients crash or become unreachable. - @@ -69223,7 +66149,6 @@ on time then the new connections will be refused. Note that this must be called before g_socket_listen() and has no effect if called after that. - @@ -69242,7 +66167,6 @@ effect if called after that. Sets whether outgoing multicast packets will be received by sockets listening on that multicast address on the same host. This is %TRUE by default. - @@ -69262,7 +66186,6 @@ by default. Sets the time-to-live for outgoing multicast datagrams on @socket. By default, this is 1, meaning that multicast packets will not leave the local network. - @@ -69287,7 +66210,6 @@ header pulls in system headers that will define most of the standard/portable socket options. For unusual socket protocols or platform-dependent options, you may need to include additional headers. - success or failure. On failure, @error will be set, and the system error value (`errno` or WSAGetLastError()) will still @@ -69334,7 +66256,6 @@ on their own. Note that if an I/O operation is interrupted by a signal, this may cause the timeout to be reset. - @@ -69352,7 +66273,6 @@ cause the timeout to be reset. Sets the time-to-live for outgoing unicast packets on @socket. By default the platform-specific default value is used. - @@ -69382,7 +66302,6 @@ One example where it is useful to shut down only one side of a connection is graceful disconnect for TCP connections where you close the sending side, then wait for the other side to close the connection, thus ensuring that the other side saw all sent data. - %TRUE on success, %FALSE on error @@ -69412,7 +66331,6 @@ information. No other types of sockets are currently considered as being capable of speaking IPv4. - %TRUE if this socket can be used with IPv4. @@ -69482,12 +66400,10 @@ of speaking IPv4. #GSocketAddress is the equivalent of struct sockaddr in the BSD sockets API. This is an abstract class; use #GInetSocketAddress for internet sockets, or #GUnixSocketAddress for UNIX domain sockets. - Creates a #GSocketAddress subclass corresponding to the native struct sockaddr @native. - a new #GSocketAddress if @native could successfully be converted, otherwise %NULL @@ -69506,7 +66422,6 @@ struct sockaddr @native. Gets the socket family type of @address. - the socket family type of @address @@ -69522,7 +66437,6 @@ struct sockaddr @native. Gets the size of @address's native struct sockaddr. You can use this to allocate memory to pass to g_socket_address_to_native(). - the size of the native struct sockaddr that @address represents @@ -69542,7 +66456,6 @@ be passed to low-level functions like connect() or bind(). If not enough space is available, a %G_IO_ERROR_NO_SPACE error is returned. If the address type is not known on the system then a %G_IO_ERROR_NOT_SUPPORTED error is returned. - %TRUE if @dest was filled in, %FALSE on error @@ -69566,7 +66479,6 @@ struct sockaddr Gets the socket family type of @address. - the socket family type of @address @@ -69582,7 +66494,6 @@ struct sockaddr Gets the size of @address's native struct sockaddr. You can use this to allocate memory to pass to g_socket_address_to_native(). - the size of the native struct sockaddr that @address represents @@ -69602,7 +66513,6 @@ be passed to low-level functions like connect() or bind(). If not enough space is available, a %G_IO_ERROR_NO_SPACE error is returned. If the address type is not known on the system then a %G_IO_ERROR_NOT_SUPPORTED error is returned. - %TRUE if @dest was filled in, %FALSE on error @@ -69632,13 +66542,11 @@ struct sockaddr - - the socket family type of @address @@ -69653,7 +66561,6 @@ struct sockaddr - the size of the native struct sockaddr that @address represents @@ -69669,7 +66576,6 @@ struct sockaddr - %TRUE if @dest was filled in, %FALSE on error @@ -69708,7 +66614,6 @@ Each #GSocketAddressEnumerator can only be enumerated once. Once g_socket_address_enumerator_next() has returned %NULL, further enumeration with that #GSocketAddressEnumerator is not possible, and it can be unreffed. - Retrieves the next #GSocketAddress from @enumerator. Note that this may block for some amount of time. (Eg, a #GNetworkAddress may need @@ -69723,7 +66628,6 @@ in *@error. However, if the first call to g_socket_address_enumerator_next() succeeds, then any further internal errors (other than @cancellable being triggered) will be ignored. - a #GSocketAddress (owned by the caller), or %NULL on error (in which case *@error will be set) or if there are no @@ -69747,7 +66651,6 @@ and then calls @callback, which must call g_socket_address_enumerator_next_finish() to get the result. It is an error to call this multiple times before the previous callback has finished. - @@ -69776,7 +66679,6 @@ It is an error to call this multiple times before the previous callback has fini g_socket_address_enumerator_next_async(). See g_socket_address_enumerator_next() for more information about error handling. - a #GSocketAddress (owned by the caller), or %NULL on error (in which case *@error will be set) or if there are no @@ -69808,7 +66710,6 @@ in *@error. However, if the first call to g_socket_address_enumerator_next() succeeds, then any further internal errors (other than @cancellable being triggered) will be ignored. - a #GSocketAddress (owned by the caller), or %NULL on error (in which case *@error will be set) or if there are no @@ -69832,7 +66733,6 @@ and then calls @callback, which must call g_socket_address_enumerator_next_finish() to get the result. It is an error to call this multiple times before the previous callback has finished. - @@ -69861,7 +66761,6 @@ It is an error to call this multiple times before the previous callback has fini g_socket_address_enumerator_next_async(). See g_socket_address_enumerator_next() for more information about error handling. - a #GSocketAddress (owned by the caller), or %NULL on error (in which case *@error will be set) or if there are no @@ -69885,13 +66784,11 @@ error handling. Class structure for #GSocketAddressEnumerator. - - a #GSocketAddress (owned by the caller), or %NULL on error (in which case *@error will be set) or if there are no @@ -69912,7 +66809,6 @@ error handling. - @@ -69939,7 +66835,6 @@ error handling. - a #GSocketAddress (owned by the caller), or %NULL on error (in which case *@error will be set) or if there are no @@ -69960,13 +66855,11 @@ error handling. - - @@ -69974,7 +66867,6 @@ error handling. - @@ -69982,7 +66874,6 @@ error handling. - @@ -69990,7 +66881,6 @@ error handling. - @@ -69998,7 +66888,6 @@ error handling. - @@ -70006,7 +66895,6 @@ error handling. - @@ -70014,7 +66902,6 @@ error handling. - @@ -70022,7 +66909,6 @@ error handling. - @@ -70030,7 +66916,6 @@ error handling. - @@ -70038,7 +66923,6 @@ error handling. - @@ -70059,10 +66943,8 @@ it will be a #GTcpConnection. As #GSocketClient is a lightweight object, you don't need to cache it. You can just create a new one any time you need one. - Creates a new #GSocketClient with the default options. - a #GSocketClient. Free the returned object with g_object_unref(). @@ -70070,7 +66952,6 @@ can just create a new one any time you need one. - @@ -70109,7 +66990,6 @@ be use as generic socket proxy through the HTTP CONNECT method. When the proxy is detected as being an application proxy, TLS handshake will be skipped. This is required to let the application do the proxy specific handshake. - @@ -70143,7 +67023,6 @@ g_socket_client_set_socket_type(). If a local address is specified with g_socket_client_set_local_address() the socket will be bound to this address before connecting. - a #GSocketConnection on success, %NULL on error. @@ -70166,10 +67045,18 @@ socket will be bound to this address before connecting. This is the asynchronous version of g_socket_client_connect(). +You may wish to prefer the asynchronous version even in synchronous +command line programs because, since 2.60, it implements +[RFC 8305](https://tools.ietf.org/html/rfc8305) "Happy Eyeballs" +recommendations to work around long connection timeouts in networks +where IPv6 is broken by performing an IPv4 connection simultaneously +without waiting for IPv6 to time out, which is not supported by the +synchronous call. (This is not an API guarantee, and may change in +the future.) + When the operation is finished @callback will be called. You can then call g_socket_client_connect_finish() to get the result of the operation. - @@ -70198,7 +67085,6 @@ the result of the operation. Finishes an async connect operation. See g_socket_client_connect_async() - a #GSocketConnection on success, %NULL on error. @@ -70245,7 +67131,6 @@ reference to it when finished with it. In the event of any failure (DNS error, service not found, no hosts connectable) %NULL is returned and @error (if non-%NULL) is set accordingly. - a #GSocketConnection on success, %NULL on error. @@ -70275,7 +67160,6 @@ accordingly. When the operation is finished @callback will be called. You can then call g_socket_client_connect_to_host_finish() to get the result of the operation. - @@ -70308,7 +67192,6 @@ the result of the operation. Finishes an async connect operation. See g_socket_client_connect_to_host_async() - a #GSocketConnection on success, %NULL on error. @@ -70339,7 +67222,6 @@ reference to it when finished with it. In the event of any failure (DNS error, service not found, no hosts connectable) %NULL is returned and @error (if non-%NULL) is set accordingly. - a #GSocketConnection if successful, or %NULL on error @@ -70366,7 +67248,6 @@ accordingly. This is the asynchronous version of g_socket_client_connect_to_service(). - @@ -70399,7 +67280,6 @@ g_socket_client_connect_to_service(). Finishes an async connect operation. See g_socket_client_connect_to_service_async() - a #GSocketConnection on success, %NULL on error. @@ -70437,7 +67317,6 @@ reference to it when finished with it. In the event of any failure (DNS error, service not found, no hosts connectable) %NULL is returned and @error (if non-%NULL) is set accordingly. - a #GSocketConnection on success, %NULL on error. @@ -70467,7 +67346,6 @@ accordingly. When the operation is finished @callback will be called. You can then call g_socket_client_connect_to_uri_finish() to get the result of the operation. - @@ -70500,7 +67378,6 @@ the result of the operation. Finishes an async connect operation. See g_socket_client_connect_to_uri_async() - a #GSocketConnection on success, %NULL on error. @@ -70518,7 +67395,6 @@ the result of the operation. Gets the proxy enable state; see g_socket_client_set_enable_proxy() - whether proxying is enabled @@ -70534,7 +67410,6 @@ the result of the operation. Gets the socket family of the socket client. See g_socket_client_set_family() for details. - a #GSocketFamily @@ -70550,8 +67425,7 @@ See g_socket_client_set_family() for details. Gets the local address of the socket client. See g_socket_client_set_local_address() for details. - - + a #GSocketAddress or %NULL. Do not free. @@ -70566,7 +67440,6 @@ See g_socket_client_set_local_address() for details. Gets the protocol name type of the socket client. See g_socket_client_set_protocol() for details. - a #GSocketProtocol @@ -70582,7 +67455,6 @@ See g_socket_client_set_protocol() for details. Gets the #GProxyResolver being used by @client. Normally, this will be the resolver returned by g_proxy_resolver_get_default(), but you can override it with g_socket_client_set_proxy_resolver(). - The #GProxyResolver being used by @client. @@ -70599,7 +67471,6 @@ can override it with g_socket_client_set_proxy_resolver(). Gets the socket type of the socket client. See g_socket_client_set_socket_type() for details. - a #GSocketFamily @@ -70615,7 +67486,6 @@ See g_socket_client_set_socket_type() for details. Gets the I/O timeout time for sockets created by @client. See g_socket_client_set_timeout() for details. - the timeout in seconds @@ -70630,7 +67500,6 @@ See g_socket_client_set_timeout() for details. Gets whether @client creates TLS connections. See g_socket_client_set_tls() for details. - whether @client uses TLS @@ -70645,7 +67514,6 @@ g_socket_client_set_tls() for details. Gets the TLS validation flags used creating TLS connections via @client. - the TLS validation flags @@ -70664,7 +67532,6 @@ proxy server. When enabled (the default), #GSocketClient will use a needed, and automatically do the necessary proxy negotiation. See also g_socket_client_set_proxy_resolver(). - @@ -70688,7 +67555,6 @@ family. This might be useful for instance if you want to force the local connection to be an ipv4 socket, even though the address might be an ipv6 mapped to ipv4 address. - @@ -70711,7 +67577,6 @@ specified address (if not %NULL) before connecting. This is useful if you want to ensure that the local side of the connection is on a specific port, or on a specific interface. - @@ -70733,7 +67598,6 @@ protocol. If @protocol is %G_SOCKET_PROTOCOL_DEFAULT that means to use the default protocol for the socket family and type. - @@ -70756,7 +67620,6 @@ default proxy settings. Note that whether or not the proxy resolver is actually used depends on the setting of #GSocketClient:enable-proxy, which is not changed by this function (but which is %TRUE by default) - @@ -70779,7 +67642,6 @@ type. It doesn't make sense to specify a type of %G_SOCKET_TYPE_DATAGRAM, as GSocketClient is used for connection oriented services. - @@ -70801,7 +67663,6 @@ time in seconds, or 0 for no timeout (the default). The timeout value affects the initial connection attempt as well, so setting this may cause calls to g_socket_client_connect(), etc, to fail with %G_IO_ERROR_TIMED_OUT. - @@ -70835,7 +67696,6 @@ setting a client-side certificate to use, or connecting to the emitted with %G_SOCKET_CLIENT_TLS_HANDSHAKING, which will give you a chance to see the #GTlsClientConnection before the handshake starts. - @@ -70853,7 +67713,6 @@ starts. Sets the TLS validation flags used when creating TLS connections via @client. The default value is %G_TLS_CERTIFICATE_VALIDATE_ALL. - @@ -70947,7 +67806,7 @@ Each event except %G_SOCKET_CLIENT_COMPLETE may be emitted multiple times (or not at all) for a given connectable (in particular, if @client ends up attempting to connect to more than one address). However, if @client emits the #GSocketClient::event -signal at all for a given connectable, that it will always emit +signal at all for a given connectable, then it will always emit it with %G_SOCKET_CLIENT_COMPLETE when it is done. Note that there may be additional #GSocketClientEvent values in @@ -70972,13 +67831,11 @@ the future; unrecognized @event values should be ignored. - - @@ -71000,7 +67857,6 @@ the future; unrecognized @event values should be ignored. - @@ -71008,7 +67864,6 @@ the future; unrecognized @event values should be ignored. - @@ -71016,7 +67871,6 @@ the future; unrecognized @event values should be ignored. - @@ -71024,7 +67878,6 @@ the future; unrecognized @event values should be ignored. - @@ -71071,9 +67924,7 @@ Additional values may be added to this type in the future. #GSocketConnectable. - - - + Objects that describe one or more potential socket endpoints implement #GSocketConnectable. Callers can then use @@ -71132,10 +67983,8 @@ connect_to_host (const char *hostname, } } ]| - Creates a #GSocketAddressEnumerator for @connectable. - a new #GSocketAddressEnumerator. @@ -71155,7 +68004,6 @@ to via a proxy. If @connectable does not implement g_socket_connectable_proxy_enumerate(), this will fall back to calling g_socket_connectable_enumerate(). - a new #GSocketAddressEnumerator. @@ -71175,7 +68023,6 @@ user. If the #GSocketConnectable implementation does not support string formatting, the implementation’s type name will be returned as a fallback. - the formatted string @@ -71189,7 +68036,6 @@ the implementation’s type name will be returned as a fallback. Creates a #GSocketAddressEnumerator for @connectable. - a new #GSocketAddressEnumerator. @@ -71209,7 +68055,6 @@ to via a proxy. If @connectable does not implement g_socket_connectable_proxy_enumerate(), this will fall back to calling g_socket_connectable_enumerate(). - a new #GSocketAddressEnumerator. @@ -71229,7 +68074,6 @@ user. If the #GSocketConnectable implementation does not support string formatting, the implementation’s type name will be returned as a fallback. - the formatted string @@ -71245,14 +68089,12 @@ the implementation’s type name will be returned as a fallback. Provides an interface for returning a #GSocketAddressEnumerator and #GProxyAddressEnumerator - The parent interface. - a new #GSocketAddressEnumerator. @@ -71267,7 +68109,6 @@ and #GProxyAddressEnumerator - a new #GSocketAddressEnumerator. @@ -71282,7 +68123,6 @@ and #GProxyAddressEnumerator - the formatted string @@ -71313,13 +68153,11 @@ family/type/protocol using g_socket_connection_factory_register_type(). To close a #GSocketConnection, use g_io_stream_close(). Closing both substreams of the #GIOStream separately will not close the underlying #GSocket. - Looks up the #GType to be used when creating socket connections on sockets with the specified @family, @type and @protocol_id. If no type is registered, the #GSocketConnection base type is returned. - a #GType @@ -71344,7 +68182,6 @@ If no type is registered, the #GSocketConnection base type is returned. sockets with the specified @family, @type and @protocol. If no type is registered, the #GSocketConnection base type is returned. - @@ -71369,7 +68206,6 @@ If no type is registered, the #GSocketConnection base type is returned. Connect @connection to the specified remote address. - %TRUE if the connection succeeded, %FALSE on error @@ -71396,7 +68232,6 @@ This clears the #GSocket:blocking flag on @connection's underlying socket if it is currently set. Use g_socket_connection_connect_finish() to retrieve the result. - @@ -71425,7 +68260,6 @@ Use g_socket_connection_connect_finish() to retrieve the result. Gets the result of a g_socket_connection_connect_async() call. - %TRUE if the connection succeeded, %FALSE on error @@ -71443,7 +68277,6 @@ Use g_socket_connection_connect_finish() to retrieve the result. Try to get the local address of a socket connection. - a #GSocketAddress or %NULL on error. Free the returned object with g_object_unref(). @@ -71465,7 +68298,6 @@ g_socket_client_connect_async(), during emission of address that will be used for the connection. This allows applications to print e.g. "Connecting to example.com (10.42.77.3)...". - a #GSocketAddress or %NULL on error. Free the returned object with g_object_unref(). @@ -71482,7 +68314,6 @@ applications to print e.g. "Connecting to example.com Gets the underlying #GSocket object of the connection. This can be useful if you want to do something unusual on it not supported by the #GSocketConnection APIs. - a #GSocket or %NULL on error. @@ -71497,7 +68328,6 @@ not supported by the #GSocketConnection APIs. Checks if @connection is connected. This is equivalent to calling g_socket_is_connected() on @connection's underlying #GSocket. - whether @connection is connected @@ -71520,13 +68350,11 @@ g_socket_is_connected() on @connection's underlying #GSocket. - - @@ -71534,7 +68362,6 @@ g_socket_is_connected() on @connection's underlying #GSocket. - @@ -71542,7 +68369,6 @@ g_socket_is_connected() on @connection's underlying #GSocket. - @@ -71550,7 +68376,6 @@ g_socket_is_connected() on @connection's underlying #GSocket. - @@ -71558,7 +68383,6 @@ g_socket_is_connected() on @connection's underlying #GSocket. - @@ -71566,16 +68390,13 @@ g_socket_is_connected() on @connection's underlying #GSocket. - - - - + A #GSocketControlMessage is a special-purpose utility message that can be sent to or received from a #GSocket. These types of @@ -71597,7 +68418,6 @@ To extend the set of control messages that can be received, subclass this class and implement the deserialize method. Also, make sure your class is registered with the GType typesystem before calling g_socket_receive_message() to read such a message. - Tries to deserialize a socket control message of a given @level and @type. This will ask all known (to GType) subclasses @@ -71606,7 +68426,6 @@ of message and if so deserialize it into a #GSocketControlMessage. If there is no implementation for this kind of control message, %NULL will be returned. - the deserialized message or %NULL @@ -71635,7 +68454,6 @@ will be returned. Returns the "level" (i.e. the originating protocol) of the control message. This is often SOL_SOCKET. - an integer describing the level @@ -71650,7 +68468,6 @@ This is often SOL_SOCKET. Returns the space required for the control message, not including headers or alignment. - The number of bytes required. @@ -71663,7 +68480,6 @@ headers or alignment. - @@ -71680,7 +68496,6 @@ message. @data is guaranteed to have enough space to fit the size returned by g_socket_control_message_get_size() on this object. - @@ -71698,7 +68513,6 @@ object. Returns the "level" (i.e. the originating protocol) of the control message. This is often SOL_SOCKET. - an integer describing the level @@ -71713,7 +68527,6 @@ This is often SOL_SOCKET. Returns the protocol specific type of the control message. For instance, for UNIX fd passing this would be SCM_RIGHTS. - an integer describing the type of control message @@ -71728,7 +68541,6 @@ For instance, for UNIX fd passing this would be SCM_RIGHTS. Returns the space required for the control message, not including headers or alignment. - The number of bytes required. @@ -71747,7 +68559,6 @@ message. @data is guaranteed to have enough space to fit the size returned by g_socket_control_message_get_size() on this object. - @@ -71771,13 +68582,11 @@ object. Class structure for #GSocketControlMessage. - - The number of bytes required. @@ -71792,7 +68601,6 @@ object. - an integer describing the level @@ -71807,7 +68615,6 @@ object. - @@ -71820,7 +68627,6 @@ object. - @@ -71838,7 +68644,6 @@ object. - @@ -71860,7 +68665,6 @@ object. - @@ -71868,7 +68672,6 @@ object. - @@ -71876,7 +68679,6 @@ object. - @@ -71884,7 +68686,6 @@ object. - @@ -71892,16 +68693,13 @@ object. - - - - + The protocol family of a #GSocketAddress. (These values are identical to the system defines %AF_INET, %AF_INET6 and %AF_UNIX, @@ -71934,19 +68732,16 @@ internally. If you want to implement a network server, also look at #GSocketService and #GThreadedSocketService which are subclasses of #GSocketListener that make this even easier. - Creates a new #GSocketListener with no sockets to listen for. New listeners can be added with e.g. g_socket_listener_add_address() or g_socket_listener_add_inet_port(). - a new #GSocketListener. - @@ -71957,7 +68752,6 @@ or g_socket_listener_add_inet_port(). - @@ -71985,7 +68779,6 @@ to the listener. If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. - a #GSocketConnection on success, %NULL on error. @@ -72011,7 +68804,6 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. When the operation is finished @callback will be called. You can then call g_socket_listener_accept_socket() to get the result of the operation. - @@ -72036,7 +68828,6 @@ to get the result of the operation. Finishes an async accept operation. See g_socket_listener_accept_async() - a #GSocketConnection on success, %NULL on error. @@ -72071,7 +68862,6 @@ to the listener. If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. - a #GSocket on success, %NULL on error. @@ -72097,7 +68887,6 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. When the operation is finished @callback will be called. You can then call g_socket_listener_accept_socket_finish() to get the result of the operation. - @@ -72122,7 +68911,6 @@ to get the result of the operation. Finishes an async accept operation. See g_socket_listener_accept_socket_async() - a #GSocket on success, %NULL on error. @@ -72166,7 +68954,6 @@ requested, belongs to the caller and must be freed. Call g_socket_listener_close() to stop listening on @address; this will not be done automatically when you drop your final reference to @listener, as references may be held internally. - %TRUE on success, %FALSE on error. @@ -72209,7 +68996,6 @@ but don't care about the specific port number. to accept to identify this particular source, which is useful if you're listening on multiple addresses and do different things depending on what address is connected to. - the port number, or 0 in case of failure. @@ -72238,7 +69024,6 @@ different things depending on what address is connected to. Call g_socket_listener_close() to stop listening on @port; this will not be done automatically when you drop your final reference to @listener, as references may be held internally. - %TRUE on success, %FALSE on error. @@ -72272,7 +69057,6 @@ The @socket will not be automatically closed when the @listener is finalized unless the listener held the final reference to the socket. Before GLib 2.42, the @socket was automatically closed on finalization of the @listener, even if references to it were held elsewhere. - %TRUE on success, %FALSE on error. @@ -72294,7 +69078,6 @@ if references to it were held elsewhere. Closes all the sockets in the listener. - @@ -72311,7 +69094,6 @@ before adding any sockets, addresses or ports to the #GSocketListener (for example, by calling g_socket_listener_add_inet_port()) to be effective. See g_socket_set_listen_backlog() for details - @@ -72357,13 +69139,11 @@ the order they happen in is undefined. Class structure for #GSocketListener. - - @@ -72376,7 +69156,6 @@ the order they happen in is undefined. - @@ -72395,7 +69174,6 @@ the order they happen in is undefined. - @@ -72403,7 +69181,6 @@ the order they happen in is undefined. - @@ -72411,7 +69188,6 @@ the order they happen in is undefined. - @@ -72419,7 +69195,6 @@ the order they happen in is undefined. - @@ -72427,7 +69202,6 @@ the order they happen in is undefined. - @@ -72454,9 +69228,7 @@ Additional values may be added to this type in the future. this socket. - - - + Flags used in g_socket_receive_message() and g_socket_send_message(). The flags listed in the enum are some commonly available flags, but the @@ -72478,9 +69250,7 @@ the right system header and pass in the flag. only send to hosts on directly connected networks. - - - + A protocol identifier is specified when creating a #GSocket, which is a family/type specific identifier, where 0 means the default protocol for @@ -72532,7 +69302,6 @@ of the thread it is created in, and is not threadsafe in general. However, the calls to start and stop the service are thread-safe so these can be used from threads that handle incoming clients. - Creates a new #GSocketService with no sockets to listen for. New listeners can be added with e.g. g_socket_listener_add_address() @@ -72541,14 +69310,12 @@ or g_socket_listener_add_inet_port(). New services are created active, there is no need to call g_socket_service_start(), unless g_socket_service_stop() has been called before. - a new #GSocketService. - @@ -72569,7 +69336,6 @@ called before. service will accept new clients that connect, while a non-active service will let connecting clients queue up until the service is started. - %TRUE if the service is active, %FALSE otherwise @@ -72589,7 +69355,6 @@ g_socket_service_stop(). This call is thread-safe, so it may be called from a thread handling an incoming client request. - @@ -72616,7 +69381,6 @@ will happen automatically when the #GSocketService is finalized.) This must be called before calling g_socket_listener_close() as the socket service will start accepting connections immediately when a new socket is added. - @@ -72664,13 +69428,11 @@ so you need to ref it yourself if you are planning to use it. Class structure for #GSocketService. - - @@ -72689,7 +69451,6 @@ so you need to ref it yourself if you are planning to use it. - @@ -72697,7 +69458,6 @@ so you need to ref it yourself if you are planning to use it. - @@ -72705,7 +69465,6 @@ so you need to ref it yourself if you are planning to use it. - @@ -72713,7 +69472,6 @@ so you need to ref it yourself if you are planning to use it. - @@ -72721,7 +69479,6 @@ so you need to ref it yourself if you are planning to use it. - @@ -72729,20 +69486,16 @@ so you need to ref it yourself if you are planning to use it. - - - - + This is the function type of the callback used for the #GSource returned by g_socket_create_source(). - it should return %FALSE if the source should be removed. @@ -72795,13 +69548,11 @@ for a given service. However, if you are simply planning to connect to the remote service, you can use #GNetworkService's #GSocketConnectable interface and not need to worry about #GSrvTarget at all. - Creates a new #GSrvTarget with the given parameters. You should not need to use this; normally #GSrvTargets are created by #GResolver. - a new #GSrvTarget. @@ -72827,7 +69578,6 @@ created by #GResolver. Copies @target - a copy of @target @@ -72841,7 +69591,6 @@ created by #GResolver. Frees @target - @@ -72857,7 +69606,6 @@ created by #GResolver. this to the user, you should use g_hostname_is_ascii_encoded() to check if it contains encoded Unicode segments, and use g_hostname_to_unicode() to convert it if it does.) - @target's hostname @@ -72871,7 +69619,6 @@ g_hostname_to_unicode() to convert it if it does.) Gets @target's port - @target's port @@ -72887,7 +69634,6 @@ g_hostname_to_unicode() to convert it if it does.) Gets @target's priority. You should not need to look at this; #GResolver already sorts the targets according to the algorithm in RFC 2782. - @target's priority @@ -72903,7 +69649,6 @@ RFC 2782. Gets @target's weight. You should not need to look at this; #GResolver already sorts the targets according to the algorithm in RFC 2782. - @target's weight @@ -72917,7 +69662,6 @@ RFC 2782. Sorts @targets in place according to the algorithm in RFC 2782. - the head of the sorted list. @@ -72937,7 +69681,6 @@ RFC 2782. #GStaticResource is an opaque data structure and can only be accessed using the following functions. - @@ -72959,7 +69702,6 @@ using the following functions. This is normally used by code generated by [glib-compile-resources][glib-compile-resources] and is not typically used by other code. - @@ -72976,7 +69718,6 @@ and is not typically used by other code. This is normally used by code generated by [glib-compile-resources][glib-compile-resources] and is not typically used by other code. - a #GResource @@ -72995,7 +69736,6 @@ GStaticResource. This is normally used by code generated by [glib-compile-resources][glib-compile-resources] and is not typically used by other code. - @@ -73071,7 +69811,6 @@ stdout/stderr will be inherited from the parent. You can use @flags to control this behavior. The argument list must be terminated with %NULL. - A newly created #GSubprocess, or %NULL on error (and @error will be set) @@ -73100,7 +69839,6 @@ The argument list must be terminated with %NULL. Create a new process with the given flags and argument list. The argument list is expected to be %NULL-terminated. - A newly created #GSubprocess, or %NULL on error (and @error will be set) @@ -73161,7 +69899,6 @@ starting this function, since they may be left in strange states, even if the operation was cancelled. You should especially not attempt to interact with the pipes while the operation is in progress (either from another thread or if using the asynchronous version). - %TRUE if successful @@ -73192,7 +69929,6 @@ attempt to interact with the pipes while the operation is in progress Asynchronous version of g_subprocess_communicate(). Complete invocation with g_subprocess_communicate_finish(). - @@ -73221,7 +69957,6 @@ invocation with g_subprocess_communicate_finish(). Complete an invocation of g_subprocess_communicate_async(). - @@ -73250,7 +69985,6 @@ process as UTF-8, and returns it as a regular NUL terminated string. On error, @stdout_buf and @stderr_buf will be set to undefined values and should not be used. - @@ -73280,7 +70014,6 @@ should not be used. Asynchronous version of g_subprocess_communicate_utf8(). Complete invocation with g_subprocess_communicate_utf8_finish(). - @@ -73309,7 +70042,6 @@ invocation with g_subprocess_communicate_utf8_finish(). Complete an invocation of g_subprocess_communicate_utf8_async(). - @@ -73340,7 +70072,6 @@ however, you can use g_subprocess_wait() to monitor the status of the process after calling this function. On Unix, this function sends %SIGKILL. - @@ -73360,7 +70091,6 @@ This is equivalent to the system WEXITSTATUS macro. It is an error to call this function before g_subprocess_wait() and unless g_subprocess_get_if_exited() returned %TRUE. - the exit status @@ -73376,7 +70106,6 @@ unless g_subprocess_get_if_exited() returned %TRUE. On UNIX, returns the process ID as a decimal string. On Windows, returns the result of GetProcessId() also as a string. If the subprocess has terminated, this will return %NULL. - the subprocess identifier, or %NULL if the subprocess has terminated @@ -73397,7 +70126,6 @@ This is equivalent to the system WIFEXITED macro. It is an error to call this function before g_subprocess_wait() has returned. - %TRUE if the case of a normal exit @@ -73416,7 +70144,6 @@ This is equivalent to the system WIFSIGNALED macro. It is an error to call this function before g_subprocess_wait() has returned. - %TRUE if the case of termination due to a signal @@ -73440,7 +70167,6 @@ followed by g_subprocess_get_exit_status(). It is an error to call this function before g_subprocess_wait() has returned. - the (meaningless) waitpid() exit status from the kernel @@ -73456,10 +70182,9 @@ returned. Gets the #GInputStream from which to read the stderr output of @subprocess. -The process must have been created with -%G_SUBPROCESS_FLAGS_STDERR_PIPE. - - +The process must have been created with %G_SUBPROCESS_FLAGS_STDERR_PIPE, +otherwise %NULL will be returned. + the stderr pipe @@ -73474,10 +70199,9 @@ The process must have been created with Gets the #GOutputStream that you can write to in order to give data to the stdin of @subprocess. -The process must have been created with -%G_SUBPROCESS_FLAGS_STDIN_PIPE. - - +The process must have been created with %G_SUBPROCESS_FLAGS_STDIN_PIPE and +not %G_SUBPROCESS_FLAGS_STDIN_INHERIT, otherwise %NULL will be returned. + the stdout pipe @@ -73492,10 +70216,9 @@ The process must have been created with Gets the #GInputStream from which to read the stdout output of @subprocess. -The process must have been created with -%G_SUBPROCESS_FLAGS_STDOUT_PIPE. - - +The process must have been created with %G_SUBPROCESS_FLAGS_STDOUT_PIPE, +otherwise %NULL will be returned. + the stdout pipe @@ -73513,7 +70236,6 @@ way of the exit() system call or return from main(). It is an error to call this function before g_subprocess_wait() has returned. - %TRUE if the process exited cleanly with a exit status of 0 @@ -73533,7 +70255,6 @@ This is equivalent to the system WTERMSIG macro. It is an error to call this function before g_subprocess_wait() and unless g_subprocess_get_if_signaled() returned %TRUE. - the signal causing termination @@ -73553,7 +70274,6 @@ This API is race-free. If the subprocess has terminated, it will not be signalled. This API is not available on Windows. - @@ -73580,7 +70300,6 @@ abnormal termination. See g_subprocess_wait_check() for that. Cancelling @cancellable doesn't kill the subprocess. Call g_subprocess_force_exit() if it is desirable. - %TRUE on success, %FALSE if @cancellable was cancelled @@ -73600,7 +70319,6 @@ g_subprocess_force_exit() if it is desirable. Wait for the subprocess to terminate. This is the asynchronous version of g_subprocess_wait(). - @@ -73625,7 +70343,6 @@ This is the asynchronous version of g_subprocess_wait(). Combines g_subprocess_wait() with g_spawn_check_exit_status(). - %TRUE on success, %FALSE if process exited abnormally, or @cancellable was cancelled @@ -73646,7 +70363,6 @@ This is the asynchronous version of g_subprocess_wait(). Combines g_subprocess_wait_async() with g_spawn_check_exit_status(). This is the asynchronous version of g_subprocess_wait_check(). - @@ -73672,7 +70388,6 @@ This is the asynchronous version of g_subprocess_wait_check(). Collects the result of a previous call to g_subprocess_wait_check_async(). - %TRUE if successful, or %FALSE with @error set @@ -73691,7 +70406,6 @@ g_subprocess_wait_check_async(). Collects the result of a previous call to g_subprocess_wait_async(). - %TRUE if successful, or %FALSE with @error set @@ -73783,7 +70497,6 @@ a similar configuration. The launcher is created with the default options. A copy of the environment of the calling process is made at the time of this call and will be used as the environment that the process is launched in. - @@ -73800,8 +70513,7 @@ environment of processes launched from this launcher. On UNIX, the returned string can be an arbitrary byte string. On Windows, it will be UTF-8. - - + the value of the environment variable, %NULL if unset @@ -73831,7 +70543,6 @@ given. %NULL can be given as @child_setup to disable the functionality. Child setup functions are only available on UNIX. - @@ -73860,7 +70571,6 @@ with. By default processes are launched with the current working directory of the launching process at the time of launch. - @@ -73895,7 +70605,6 @@ etc.) before launching the subprocess. On UNIX, all strings in this array can be arbitrary byte strings. On Windows, they should be in UTF-8. - @@ -73926,7 +70635,6 @@ handle a particular stdio stream (eg: specifying both You may also not set a flag that conflicts with a previous call to a function like g_subprocess_launcher_set_stdin_file_path() or g_subprocess_launcher_take_stdout_fd(). - @@ -73956,7 +70664,6 @@ You may not set a stderr file path if a stderr fd is already set or if the launcher flags contain any flags directing stderr elsewhere. This feature is only available on UNIX. - @@ -73982,7 +70689,6 @@ You may not set a stdin file path if a stdin fd is already set or if the launcher flags contain any flags directing stdin elsewhere. This feature is only available on UNIX. - @@ -74008,7 +70714,6 @@ You may not set a stdout file path if a stdout fd is already set or if the launcher flags contain any flags directing stdout elsewhere. This feature is only available on UNIX. - @@ -74030,7 +70735,6 @@ processes launched from this launcher. On UNIX, both the variable's name and value can be arbitrary byte strings, except that the variable's name cannot contain '='. On Windows, they should be in UTF-8. - @@ -74056,7 +70760,6 @@ On Windows, they should be in UTF-8. Creates a #GSubprocess given a provided varargs list of arguments. - A new #GSubprocess, or %NULL on error (and @error will be set) @@ -74082,7 +70785,6 @@ On Windows, they should be in UTF-8. Creates a #GSubprocess given a provided array of arguments. - A new #GSubprocess, or %NULL on error (and @error will be set) @@ -74102,18 +70804,17 @@ On Windows, they should be in UTF-8. Transfer an arbitrary file descriptor from parent process to the -child. This function takes "ownership" of the fd; it will be closed +child. This function takes ownership of the @source_fd; it will be closed in the parent when @self is freed. By default, all file descriptors from the parent will be closed. -This function allows you to create (for example) a custom pipe() or -socketpair() before launching the process, and choose the target +This function allows you to create (for example) a custom `pipe()` or +`socketpair()` before launching the process, and choose the target descriptor in the child. An example use case is GNUPG, which has a command line argument ---passphrase-fd providing a file descriptor number where it expects +`--passphrase-fd` providing a file descriptor number where it expects the passphrase to be written. - @@ -74149,7 +70850,6 @@ You may not set a stderr fd if a stderr file path is already set or if the launcher flags contain any flags directing stderr elsewhere. This feature is only available on UNIX. - @@ -74183,7 +70883,6 @@ You may not set a stdin fd if a stdin file path is already set or if the launcher flags contain any flags directing stdin elsewhere. This feature is only available on UNIX. - @@ -74216,7 +70915,6 @@ You may not set a stdout fd if a stdout file path is already set or if the launcher flags contain any flags directing stdout elsewhere. This feature is only available on UNIX. - @@ -74237,7 +70935,6 @@ processes launched from this launcher. On UNIX, the variable's name can be an arbitrary byte string not containing '='. On Windows, it should be in UTF-8. - @@ -74258,119 +70955,102 @@ containing '='. On Windows, it should be in UTF-8. - - - - - - - - - - - - - - - - - @@ -74379,88 +71059,75 @@ containing '='. On Windows, it should be in UTF-8. Extension point for TLS functionality via #GTlsBackend. See [Extending GIO][extending-gio]. - - - - - - - - - - - - - @@ -74469,101 +71136,86 @@ See [Extending GIO][extending-gio]. The purpose used to verify the client certificate in a TLS connection. Used by TLS servers. - The purpose used to verify the server certificate in a TLS connection. This is the most common purpose in use. Used by TLS clients. - - - - - - - - - - - - - - @@ -75065,7 +71717,6 @@ in several ways: having come from the `_async()` wrapper function (for "short-circuit" results, such as when passing 0 to g_input_stream_read_async()). - Creates a #GTask acting on @source_object, which will eventually be @@ -75084,7 +71735,6 @@ simplified handling in cases where cancellation may imply that other objects that the task depends on have been destroyed. If you do not want this behavior, you can use g_task_set_check_cancellable() to change it. - a #GTask. @@ -75113,7 +71763,6 @@ g_task_set_check_cancellable() to change it. Checks that @result is a #GTask, and that @source_object is its source object (or that @source_object is %NULL and @result has no source object). This can be used in g_return_if_fail() checks. - %TRUE if @result and @source_object are valid, %FALSE if not @@ -75140,7 +71789,6 @@ check if the result there is tagged as having been created by the wrapper method, and deal with it appropriately if so. See also g_task_report_new_error(). - @@ -75178,7 +71826,6 @@ having been created by the wrapper method, and deal with it appropriately if so. See also g_task_report_error(). - @@ -75228,7 +71875,6 @@ It will set the @source’s name to the task’s name (as set with g_task_set_name()), if one has been set. This takes a reference on @task until @source is destroyed. - @@ -75249,7 +71895,6 @@ This takes a reference on @task until @source is destroyed. Gets @task's #GCancellable - @task's #GCancellable @@ -75264,7 +71909,6 @@ This takes a reference on @task until @source is destroyed. Gets @task's check-cancellable flag. See g_task_set_check_cancellable() for more details. - @@ -75279,7 +71923,6 @@ g_task_set_check_cancellable() for more details. Gets the value of #GTask:completed. This changes from %FALSE to %TRUE after the task’s callback is invoked, and will return %FALSE if called from inside the callback. - %TRUE if the task has completed, %FALSE otherwise. @@ -75299,7 +71942,6 @@ at the point when @task was created). This will always return a non-%NULL value, even if the task's context is the default #GMainContext. - @task's #GMainContext @@ -75313,7 +71955,6 @@ context is the default #GMainContext. Gets @task’s name. See g_task_set_name(). - @task’s name, or %NULL @@ -75327,7 +71968,6 @@ context is the default #GMainContext. Gets @task's priority - @task's priority @@ -75342,7 +71982,6 @@ context is the default #GMainContext. Gets @task's return-on-cancel flag. See g_task_set_return_on_cancel() for more details. - @@ -75356,7 +71995,6 @@ g_task_set_return_on_cancel() for more details. Gets the source object from @task. Like g_async_result_get_source_object(), but does not ref the object. - @task's source object, or %NULL @@ -75370,7 +72008,6 @@ g_async_result_get_source_object(), but does not ref the object. Gets @task's source tag. See g_task_set_source_tag(). - @task's source tag @@ -75384,7 +72021,6 @@ g_async_result_get_source_object(), but does not ref the object. Gets @task's `task_data`. - @task's `task_data`. @@ -75398,7 +72034,6 @@ g_async_result_get_source_object(), but does not ref the object. Tests if @task resulted in an error. - %TRUE if the task resulted in an error, %FALSE otherwise. @@ -75418,7 +72053,6 @@ instead return %FALSE and set @error. Since this method transfers ownership of the return value (or error) to the caller, you may only call it once. - the task result, or %FALSE on error @@ -75438,7 +72072,6 @@ instead return -1 and set @error. Since this method transfers ownership of the return value (or error) to the caller, you may only call it once. - the task result, or -1 on error @@ -75459,7 +72092,6 @@ instead return %NULL and set @error. Since this method transfers ownership of the return value (or error) to the caller, you may only call it once. - the task result, or %NULL on error @@ -75482,7 +72114,6 @@ instead set @error and return %FALSE. Since this method transfers ownership of the return value (or error) to the caller, you may only call it once. - %TRUE if @task succeeded, %FALSE on error. @@ -75502,7 +72133,6 @@ error) to the caller, you may only call it once. Sets @task's result to @result and completes the task (see g_task_return_pointer() for more discussion of exactly what this means). - @@ -75529,7 +72159,6 @@ Call g_error_copy() on the error if you need to keep a local copy as well. See also g_task_return_new_error(). - @@ -75549,7 +72178,6 @@ See also g_task_return_new_error(). @task's error accordingly and completes the task (see g_task_return_pointer() for more discussion of exactly what this means). - %TRUE if @task has been cancelled, %FALSE if not @@ -75565,7 +72193,6 @@ means). Sets @task's result to @result and completes the task (see g_task_return_pointer() for more discussion of exactly what this means). - @@ -75587,7 +72214,6 @@ g_task_return_pointer() for more discussion of exactly what this means). See also g_task_return_error(). - @@ -75633,7 +72259,6 @@ Note that since the task may be completed before returning from g_task_return_pointer(), you cannot assume that @result is still valid after calling this, unless you are still holding another reference on it. - @@ -75662,7 +72287,6 @@ with a value of %NULL will be used for the result. This is a very generic low-level method intended primarily for use by language bindings; for C code, g_task_return_pointer() and the like will normally be much easier to use. - @@ -75691,7 +72315,6 @@ g_task_run_in_thread(), you should not assume that it will always do this. If you have a very large number of tasks to run, but don't want them to all run at once, you should only queue a limited number of them at a time. - @@ -75723,7 +72346,6 @@ g_task_run_in_thread_sync(), you should not assume that it will always do this. If you have a very large number of tasks to run, but don't want them to all run at once, you should only queue a limited number of them at a time. - @@ -75753,7 +72375,6 @@ via g_task_return_error_if_cancelled()). If you are using g_task_set_return_on_cancel() as well, then you must leave check-cancellable set %TRUE. - @@ -75779,7 +72400,6 @@ name of the #GSource used for idle completion of the task. This function may only be called before the @task is first used in a thread other than the one it was constructed in. - @@ -75802,7 +72422,6 @@ This will affect the priority of #GSources created with g_task_attach_source() and the scheduling of tasks run in threads, and can also be explicitly retrieved later via g_task_get_priority(). - @@ -75846,7 +72465,6 @@ If the task's #GCancellable is already cancelled before you call g_task_run_in_thread()/g_task_run_in_thread_sync(), then the #GTaskThreadFunc will still be run (for consistency), but the task will also be completed right away. - %TRUE if @task's return-on-cancel flag was changed to match @return_on_cancel. %FALSE if @task has already been @@ -75872,7 +72490,6 @@ doing the tagging) and then later check it using g_task_get_source_tag() (or g_async_result_is_tagged()) in the task's "finish" function, to figure out if the response came from a particular place. - @@ -75889,7 +72506,6 @@ particular place. Sets @task's task data (freeing the existing task data, if any). - @@ -75921,9 +72537,7 @@ context as the task’s callback, immediately after that callback is invoke - - - + The prototype for a task function to be run in a thread via g_task_run_in_thread() or g_task_run_in_thread_sync(). @@ -75940,7 +72554,6 @@ g_task_set_return_on_cancel() for more details. Other than in that case, @task will be completed when the #GTaskThreadFunc returns, not when it calls a `g_task_return_` function. - @@ -75966,11 +72579,9 @@ Other than in that case, @task will be completed when the This is the subclass of #GSocketConnection that is created for TCP/IP sockets. - Checks if graceful disconnects are used. See g_tcp_connection_set_graceful_disconnect(). - %TRUE if graceful disconnect is used on close, %FALSE otherwise @@ -75992,7 +72603,6 @@ all the outstanding data to the other end, or get an error reported. However, it also means we have to wait for all the data to reach the other side and for it to acknowledge this by closing the socket, which may take a while. For this reason it is disabled by default. - @@ -76018,24 +72628,19 @@ take a while. For this reason it is disabled by default. - - - - + A #GTcpWrapperConnection can be used to wrap a #GIOStream that is based on a #GSocket, but which is not actually a #GSocketConnection. This is used by #GSocketClient so that it can always return a #GSocketConnection, even when the connection it has actually created is not directly a #GSocketConnection. - Wraps @base_io_stream and @socket together as a #GSocketConnection. - the new #GSocketConnection. @@ -76053,7 +72658,6 @@ actually created is not directly a #GSocketConnection. Gets @conn's base #GIOStream - @conn's base #GIOStream @@ -76076,14 +72680,11 @@ actually created is not directly a #GSocketConnection. - - - - + A helper class for testing code which uses D-Bus without touching the user's session bus. @@ -76159,7 +72760,6 @@ do the following in the directory holding schemas: ]| Create a new #GTestDBus object. - a new #GTestDBus. @@ -76178,7 +72778,6 @@ won't use user's session bus. This is useful for unit tests that want to verify behaviour when no session bus is running. It is not necessary to call this if unit test already calls g_test_dbus_up() before acquiring the session bus. - @@ -76186,7 +72785,6 @@ g_test_dbus_up() before acquiring the session bus. Add a path where dbus-daemon will look up .service files. This can't be called after g_test_dbus_up(). - @@ -76207,7 +72805,6 @@ called after g_test_dbus_up(). This will wait for the singleton returned by g_bus_get() or g_bus_get_sync() to be destroyed. This is done to ensure that the next unit test won't get a leaked singleton from this test. - @@ -76222,7 +72819,6 @@ leaked singleton from this test. Get the address on which dbus-daemon is running. If g_test_dbus_up() has not been called yet, %NULL is returned. This can be used with g_dbus_connection_new_for_address(). - the address of the bus, or %NULL. @@ -76236,7 +72832,6 @@ g_dbus_connection_new_for_address(). Get the flags of the #GTestDBus object. - the value of #GTestDBus:flags property @@ -76255,7 +72850,6 @@ Unlike g_test_dbus_down(), this won't verify the #GDBusConnection singleton returned by g_bus_get() or g_bus_get_sync() is destroyed. Unit tests wanting to verify behaviour after the session bus has been stopped can use this function but should still call g_test_dbus_down() when done. - @@ -76275,7 +72869,6 @@ g_test_dbus_down() must be called in its teardown callback. If this function is called from unit test's main(), then g_test_dbus_down() must be called after g_test_run(). - @@ -76305,11 +72898,9 @@ not provide actual pixmaps for icons, just the icon names. Ideally something like gtk_icon_theme_choose_icon() should be used to resolve the list of names so that fallback icons work nicely with themes that inherit other themes. - Creates a new themed icon for @iconname. - a new #GThemedIcon. @@ -76323,7 +72914,6 @@ themes that inherit other themes. Creates a new themed icon for @iconnames. - a new #GThemedIcon @@ -76358,7 +72948,6 @@ const char *names[] = { icon1 = g_themed_icon_new_from_names (names, 4); icon2 = g_themed_icon_new_with_default_fallbacks ("gnome-dev-cdrom-audio"); ]| - a new #GThemedIcon. @@ -76375,7 +72964,6 @@ icon2 = g_themed_icon_new_with_default_fallbacks ("gnome-dev-cdrom-audio"); Note that doing so invalidates the hash computed by prior calls to g_icon_hash(). - @@ -76392,7 +72980,6 @@ to g_icon_hash(). Gets the names of icons from within @icon. - a list of icon names. @@ -76411,7 +72998,6 @@ to g_icon_hash(). Note that doing so invalidates the hash computed by prior calls to g_icon_hash(). - @@ -76455,9 +73041,7 @@ would become - - - + A #GThreadedSocketService is a simple subclass of #GSocketService that handles incoming connections by creating a worker thread and @@ -76474,11 +73058,9 @@ new connections when all threads are busy. As with #GSocketService, you may connect to #GThreadedSocketService::run, or subclass and override the default handler. - Creates a new #GThreadedSocketService with no listeners. Listeners must be added with one of the #GSocketListener "add" methods. - a new #GSocketService. @@ -76492,7 +73074,6 @@ must be added with one of the #GSocketListener "add" methods. - @@ -76539,13 +73120,11 @@ not return until the connection is closed. - - @@ -76564,7 +73143,6 @@ not return until the connection is closed. - @@ -76572,7 +73150,6 @@ not return until the connection is closed. - @@ -76580,7 +73157,6 @@ not return until the connection is closed. - @@ -76588,7 +73164,6 @@ not return until the connection is closed. - @@ -76596,16 +73171,13 @@ not return until the connection is closed. - - - - + The client authentication mode for a #GTlsServerConnection. @@ -76620,18 +73192,16 @@ not return until the connection is closed. TLS (Transport Layer Security, aka SSL) and DTLS backend. - Gets the default #GTlsBackend for the system. - - a #GTlsBackend + a #GTlsBackend, which will be a + dummy object if no TLS backend is available Gets the default #GTlsDatabase used to verify TLS connections. - the default database, which should be unreffed when done. @@ -76647,7 +73217,6 @@ not return until the connection is closed. Checks if DTLS is supported. DTLS support may not be available even if TLS support is available, and vice-versa. - whether DTLS is supported @@ -76662,7 +73231,6 @@ support is available, and vice-versa. Checks if TLS is supported; if this returns %FALSE for the default #GTlsBackend, it means no "real" TLS backend is available. - whether or not TLS is supported @@ -76676,7 +73244,6 @@ support is available, and vice-versa. Gets the #GType of @backend's #GTlsCertificate implementation. - the #GType of @backend's #GTlsCertificate implementation. @@ -76691,7 +73258,6 @@ support is available, and vice-versa. Gets the #GType of @backend's #GTlsClientConnection implementation. - the #GType of @backend's #GTlsClientConnection implementation. @@ -76706,7 +73272,6 @@ support is available, and vice-versa. Gets the default #GTlsDatabase used to verify TLS connections. - the default database, which should be unreffed when done. @@ -76721,7 +73286,6 @@ support is available, and vice-versa. Gets the #GType of @backend’s #GDtlsClientConnection implementation. - the #GType of @backend’s #GDtlsClientConnection implementation, or %G_TYPE_INVALID if this backend doesn’t support DTLS. @@ -76736,7 +73300,6 @@ support is available, and vice-versa. Gets the #GType of @backend’s #GDtlsServerConnection implementation. - the #GType of @backend’s #GDtlsServerConnection implementation, or %G_TYPE_INVALID if this backend doesn’t support DTLS. @@ -76751,7 +73314,6 @@ support is available, and vice-versa. Gets the #GType of @backend's #GTlsFileDatabase implementation. - the #GType of backend's #GTlsFileDatabase implementation. @@ -76765,7 +73327,6 @@ support is available, and vice-versa. Gets the #GType of @backend's #GTlsServerConnection implementation. - the #GType of @backend's #GTlsServerConnection implementation. @@ -76787,7 +73348,6 @@ modified. Setting a %NULL default database will reset to using the system default database as if g_tls_backend_set_default_database() had never been called. - @@ -76805,7 +73365,6 @@ database as if g_tls_backend_set_default_database() had never been called. Checks if DTLS is supported. DTLS support may not be available even if TLS support is available, and vice-versa. - whether DTLS is supported @@ -76820,7 +73379,6 @@ support is available, and vice-versa. Checks if TLS is supported; if this returns %FALSE for the default #GTlsBackend, it means no "real" TLS backend is available. - whether or not TLS is supported @@ -76835,14 +73393,12 @@ support is available, and vice-versa. Provides an interface for describing TLS-related types. - The parent interface. - whether or not TLS is supported @@ -76857,7 +73413,6 @@ support is available, and vice-versa. - @@ -76865,7 +73420,6 @@ support is available, and vice-versa. - @@ -76873,7 +73427,6 @@ support is available, and vice-versa. - @@ -76881,7 +73434,6 @@ support is available, and vice-versa. - @@ -76889,7 +73441,6 @@ support is available, and vice-versa. - the default database, which should be unreffed when done. @@ -76905,7 +73456,6 @@ support is available, and vice-versa. - whether DTLS is supported @@ -76920,7 +73470,6 @@ support is available, and vice-versa. - @@ -76928,7 +73477,6 @@ support is available, and vice-versa. - @@ -76941,7 +73489,6 @@ This can represent either a certificate only (eg, the certificate received by a client from a server), or the combination of a certificate and a private key (which is needed when acting as a #GTlsServerConnection). - Creates a #GTlsCertificate from the PEM-encoded data in @file. The returned certificate will be the first certificate found in @file. As @@ -76956,7 +73503,6 @@ still be returned. If @file cannot be read or parsed, the function will return %NULL and set @error. Otherwise, this behaves like g_tls_certificate_new_from_pem(). - the new certificate, or %NULL on error @@ -76983,7 +73529,6 @@ still be returned. If either file cannot be read or parsed, the function will return %NULL and set @error. Otherwise, this behaves like g_tls_certificate_new_from_pem(). - the new certificate, or %NULL on error @@ -77016,7 +73561,6 @@ file) and the #GTlsCertificate:issuer property of each certificate will be set accordingly if the verification succeeds. If any certificate in the chain cannot be verified, the first certificate in the file will still be returned. - the new certificate, or %NULL if @data is invalid @@ -77038,7 +73582,6 @@ data in @file. If @file cannot be read or parsed, the function will return %NULL and set @error. If @file does not contain any PEM-encoded certificates, this will return an empty list and not set @error. - a #GList containing #GTlsCertificate objects. You must free the list @@ -77074,7 +73617,6 @@ value. (All other #GTlsCertificateFlags values will always be set or unset as appropriate.) - the appropriate #GTlsCertificateFlags @@ -77096,8 +73638,7 @@ as appropriate.) Gets the #GTlsCertificate representing @cert's issuer, if known - - + The certificate of @cert's issuer, or %NULL if @cert is self-signed or signed with an unknown certificate. @@ -77116,7 +73657,6 @@ The raw DER byte data of the two certificates are checked for equality. This has the effect that two certificates may compare equal even if their #GTlsCertificate:issuer, #GTlsCertificate:private-key, or #GTlsCertificate:private-key-pem properties differ. - whether the same or not @@ -77152,7 +73692,6 @@ value. (All other #GTlsCertificateFlags values will always be set or unset as appropriate.) - the appropriate #GTlsCertificateFlags @@ -77228,13 +73767,11 @@ tool to convert PKCS#8 keys to PKCS#1. - - the appropriate #GTlsCertificateFlags @@ -77299,9 +73836,7 @@ a particular certificate was rejected (eg, in flags - - - + Flags for g_tls_interaction_request_certificate(), g_tls_interaction_request_certificate_async(), and @@ -77364,7 +73899,6 @@ binding type is not currently implemented. #GTlsClientConnection is the client-side subclass of #GTlsConnection, representing a client-side TLS connection. - Creates a new #GTlsClientConnection wrapping @base_io_stream (which @@ -77374,7 +73908,6 @@ communicate with the server identified by @server_identity. See the documentation for #GTlsConnection:base-io-stream for restrictions on when application code can run operations on the @base_io_stream after this function has returned. - the new #GTlsClientConnection, or %NULL on error @@ -77420,7 +73953,6 @@ from the server, provided a ticket is available that has not previously been used for session resumption, since session ticket reuse would be a privacy weakness. Using this function causes the ticket to be copied without regard for privacy considerations. - @@ -77464,7 +73996,6 @@ from the server, provided a ticket is available that has not previously been used for session resumption, since session ticket reuse would be a privacy weakness. Using this function causes the ticket to be copied without regard for privacy considerations. - @@ -77487,7 +74018,6 @@ Otherwise, it will be %NULL. Each item in the list is a #GByteArray which contains the complete subject DN of the certificate authority. - the list of CA DNs. You should unref each element with g_byte_array_unref() and then @@ -77507,8 +74037,7 @@ the free the list with g_list_free(). Gets @conn's expected server identity - - + a #GSocketConnectable describing the expected server identity, or %NULL if the expected identity is not known. @@ -77525,7 +74054,6 @@ known. SSL 3.0 is no longer supported. See g_tls_client_connection_set_use_ssl3() for details. SSL 3.0 is insecure. - %FALSE @@ -77539,7 +74067,6 @@ g_tls_client_connection_set_use_ssl3() for details. Gets @conn's validation flags - the validation flags @@ -77556,7 +74083,6 @@ g_tls_client_connection_set_use_ssl3() for details. servers on virtual hosts which certificate to present, and also to let @conn know what name to look for in the certificate when performing %G_TLS_CERTIFICATE_BAD_IDENTITY validation, if enabled. - @@ -77583,7 +74109,6 @@ acceptable. Since GLib 2.64, this function does nothing. SSL 3.0 is insecure. - @@ -77602,7 +74127,6 @@ Since GLib 2.64, this function does nothing. Sets @conn's validation flags, to override the default set of checks performed when validating a server certificate. By default, %G_TLS_CERTIFICATE_VALIDATE_ALL is used. - @@ -77662,14 +74186,12 @@ overrides the default via #GTlsConnection::accept-certificate. vtable for a #GTlsClientConnection implementation. - The parent interface. - @@ -77693,9 +74215,7 @@ subclasses, #GTlsClientConnection and #GTlsServerConnection, implement client-side and server-side TLS, respectively. For DTLS (Datagram TLS) support, see #GDtlsConnection. - - @@ -77712,7 +74232,6 @@ For DTLS (Datagram TLS) support, see #GDtlsConnection. - @@ -77762,7 +74281,6 @@ function manually is not recommended. #GTlsConnection::accept_certificate may be emitted during the handshake. - success or failure @@ -77781,7 +74299,6 @@ handshake. Asynchronously performs a TLS handshake on @conn. See g_tls_connection_handshake() for more information. - @@ -77811,7 +74328,6 @@ g_tls_connection_handshake() for more information. Finish an asynchronous TLS handshake operation. See g_tls_connection_handshake() for more information. - %TRUE on success, %FALSE on failure, in which case @error will be set. @@ -77831,7 +74347,6 @@ case @error will be set. Used by #GTlsConnection implementations to emit the #GTlsConnection::accept-certificate signal. - %TRUE if one of the signal handlers has returned %TRUE to accept @peer_cert @@ -77855,7 +74370,6 @@ case @error will be set. Gets @conn's certificate, as set by g_tls_connection_set_certificate(). - @conn's certificate, or %NULL @@ -77881,7 +74395,6 @@ is supported by the TLS backend). It does not guarantee that the data will be available though. That could happen if TLS connection does not support @type or the binding data is not available yet due to additional negotiation or input required. - %TRUE on success, %FALSE otherwise @@ -77907,7 +74420,6 @@ negotiation or input required. Gets the certificate database that @conn uses to verify peer certificates. See g_tls_connection_set_database(). - the certificate database that @conn uses or %NULL @@ -77923,7 +74435,6 @@ peer certificates. See g_tls_connection_set_database(). Get the object that will be used to interact with the user. It will be used for things like prompting the user for passwords. If %NULL is returned, then no user interaction will occur for this connection. - The interaction object. @@ -77943,7 +74454,6 @@ If the peer did not use the ALPN extension, or did not advertise a protocol that matched one of @conn's protocols, or the TLS backend does not support ALPN, then this will be %NULL. See g_tls_connection_set_advertised_protocols(). - the negotiated protocol, or %NULL @@ -77959,7 +74469,6 @@ g_tls_connection_set_advertised_protocols(). Gets @conn's peer's certificate after the handshake has completed or failed. (It is not set during the emission of #GTlsConnection::accept-certificate.) - @conn's peer's certificate, or %NULL @@ -77975,7 +74484,6 @@ or failed. (It is not set during the emission of Gets the errors associated with validating @conn's peer's certificate, after the handshake has completed or failed. (It is not set during the emission of #GTlsConnection::accept-certificate.) - @conn's peer's certificate errors @@ -77993,7 +74501,6 @@ g_tls_connection_set_rehandshake_mode() for details. Changing the rehandshake mode is no longer required for compatibility. Also, rehandshaking has been removed from the TLS protocol in TLS 1.3. - %G_TLS_REHANDSHAKE_SAFELY @@ -78009,7 +74516,6 @@ g_tls_connection_set_rehandshake_mode() for details. Tests whether or not @conn expects a proper TLS close notification when the connection is closed. See g_tls_connection_set_require_close_notify() for details. - %TRUE if @conn requires a proper TLS close notification. @@ -78026,7 +74532,6 @@ notification. Gets whether @conn uses the system certificate database to verify peer certificates. See g_tls_connection_set_use_system_certdb(). Use g_tls_connection_get_database() instead - whether @conn uses the system certificate database @@ -78070,7 +74575,6 @@ function manually is not recommended. #GTlsConnection::accept_certificate may be emitted during the handshake. - success or failure @@ -78089,7 +74593,6 @@ handshake. Asynchronously performs a TLS handshake on @conn. See g_tls_connection_handshake() for more information. - @@ -78119,7 +74622,6 @@ g_tls_connection_handshake() for more information. Finish an asynchronous TLS handshake operation. See g_tls_connection_handshake() for more information. - %TRUE on success, %FALSE on failure, in which case @error will be set. @@ -78147,7 +74649,6 @@ of @protocols will disable ALPN negotiation. See [IANA TLS ALPN Protocol IDs](https://www.iana.org/assignments/tls-extensiontype-values/tls-extensiontype-values.xhtml#alpn-protocol-ids) for a list of registered protocol IDs. - @@ -78184,7 +74685,6 @@ or without a certificate; in that case, if you don't provide a certificate, you can tell that the server requested one by the fact that g_tls_client_connection_get_accepted_cas() will return non-%NULL.) - @@ -78208,7 +74708,6 @@ peer certificate validation will always set the #GTlsConnection::accept-certificate will always be emitted on client-side connections, unless that bit is not set in #GTlsClientConnection:validation-flags). - @@ -78230,7 +74729,6 @@ for things like prompting the user for passwords. The @interaction argument will normally be a derived subclass of #GTlsInteraction. %NULL can also be provided if no user interaction should occur for this connection. - @@ -78253,7 +74751,6 @@ rekey operations. Changing the rehandshake mode is no longer required for compatibility. Also, rehandshaking has been removed from the TLS protocol in TLS 1.3. - @@ -78296,7 +74793,6 @@ setting of this property. If you explicitly want to do an unclean close, you can close @conn's #GTlsConnection:base-io-stream rather than closing @conn itself, but note that this may only be done when no other operations are pending on @conn or the base I/O stream. - @@ -78320,7 +74816,6 @@ peer certificate validation will always set the client-side connections, unless that bit is not set in #GTlsClientConnection:validation-flags). Use g_tls_connection_set_database() instead - @@ -78469,13 +74964,11 @@ no one else overrides it. - - @@ -78494,7 +74987,6 @@ no one else overrides it. - success or failure @@ -78513,7 +75005,6 @@ no one else overrides it. - @@ -78543,7 +75034,6 @@ no one else overrides it. - %TRUE on success, %FALSE on failure, in which case @error will be set. @@ -78563,7 +75053,6 @@ case @error will be set. - @@ -78588,9 +75077,7 @@ case @error will be set. - - - + #GTlsDatabase is used to look up certificates and other information from a certificate or key store. It is an abstract base class which @@ -78601,7 +75088,6 @@ All implementations are required to be fully thread-safe. Most common client applications will not directly interact with #GTlsDatabase. It is used internally by #GTlsConnection. - Create a handle string for the certificate. The database will only be able to create a handle for certificates that originate from the database. In @@ -78611,7 +75097,6 @@ will be returned. This handle should be stable across various instances of the application, and between applications. If a certificate is modified in the database, then it is not guaranteed that this handle will continue to point to it. - a newly allocated string containing the handle. @@ -78641,7 +75126,6 @@ this database, then %NULL will be returned. This function can block, use g_tls_database_lookup_certificate_for_handle_async() to perform the lookup operation asynchronously. - a newly allocated #GTlsCertificate, or %NULL. Use g_object_unref() to release the certificate. @@ -78673,7 +75157,6 @@ the lookup operation asynchronously. Asynchronously look up a certificate by its handle in the database. See g_tls_database_lookup_certificate_for_handle() for more information. - @@ -78714,7 +75197,6 @@ g_tls_database_lookup_certificate_for_handle() for more information. If the handle is no longer valid, or does not point to a certificate in this database, then %NULL will be returned. - a newly allocated #GTlsCertificate object. Use g_object_unref() to release the certificate. @@ -78740,7 +75222,6 @@ into a chain. This function can block, use g_tls_database_lookup_certificate_issuer_async() to perform the lookup operation asynchronously. - a newly allocated issuer #GTlsCertificate, or %NULL. Use g_object_unref() to release the certificate. @@ -78772,7 +75253,6 @@ or %NULL. Use g_object_unref() to release the certificate. Asynchronously look up the issuer of @certificate in the database. See g_tls_database_lookup_certificate_issuer() for more information. - @@ -78810,7 +75290,6 @@ g_tls_database_lookup_certificate_issuer() for more information. Finish an asynchronous lookup issuer operation. See g_tls_database_lookup_certificate_issuer() for more information. - a newly allocated issuer #GTlsCertificate, or %NULL. Use g_object_unref() to release the certificate. @@ -78832,7 +75311,6 @@ or %NULL. Use g_object_unref() to release the certificate. This function can block, use g_tls_database_lookup_certificates_issued_by_async() to perform the lookup operation asynchronously. - a newly allocated list of #GTlsCertificate objects. Use g_object_unref() on each certificate, and g_list_free() on the release the list. @@ -78872,7 +75350,6 @@ g_tls_database_lookup_certificates_issued_by() for more information. The database may choose to hold a reference to the issuer byte array for the duration of of this asynchronous operation. The byte array should not be modified during this time. - @@ -78912,7 +75389,6 @@ this time. Finish an asynchronous lookup of certificates. See g_tls_database_lookup_certificates_issued_by() for more information. - a newly allocated list of #GTlsCertificate objects. Use g_object_unref() on each certificate, and g_list_free() on the release the list. @@ -78969,7 +75445,6 @@ but found to be invalid. This function can block, use g_tls_database_verify_chain_async() to perform the verification operation asynchronously. - the appropriate #GTlsCertificateFlags which represents the result of verification. @@ -79010,7 +75485,6 @@ result of verification. Asynchronously determines the validity of a certificate chain after looking up and adding any missing certificates to the chain. See g_tls_database_verify_chain() for more information. - @@ -79065,7 +75539,6 @@ before it completes) then the return value will be %G_TLS_CERTIFICATE_GENERIC_ERROR and @error will be set accordingly. @error is not set when @chain is successfully analyzed but found to be invalid. - the appropriate #GTlsCertificateFlags which represents the result of verification. @@ -79091,7 +75564,6 @@ will be returned. This handle should be stable across various instances of the application, and between applications. If a certificate is modified in the database, then it is not guaranteed that this handle will continue to point to it. - a newly allocated string containing the handle. @@ -79121,7 +75593,6 @@ this database, then %NULL will be returned. This function can block, use g_tls_database_lookup_certificate_for_handle_async() to perform the lookup operation asynchronously. - a newly allocated #GTlsCertificate, or %NULL. Use g_object_unref() to release the certificate. @@ -79153,7 +75624,6 @@ the lookup operation asynchronously. Asynchronously look up a certificate by its handle in the database. See g_tls_database_lookup_certificate_for_handle() for more information. - @@ -79194,7 +75664,6 @@ g_tls_database_lookup_certificate_for_handle() for more information. If the handle is no longer valid, or does not point to a certificate in this database, then %NULL will be returned. - a newly allocated #GTlsCertificate object. Use g_object_unref() to release the certificate. @@ -79220,7 +75689,6 @@ into a chain. This function can block, use g_tls_database_lookup_certificate_issuer_async() to perform the lookup operation asynchronously. - a newly allocated issuer #GTlsCertificate, or %NULL. Use g_object_unref() to release the certificate. @@ -79252,7 +75720,6 @@ or %NULL. Use g_object_unref() to release the certificate. Asynchronously look up the issuer of @certificate in the database. See g_tls_database_lookup_certificate_issuer() for more information. - @@ -79290,7 +75757,6 @@ g_tls_database_lookup_certificate_issuer() for more information. Finish an asynchronous lookup issuer operation. See g_tls_database_lookup_certificate_issuer() for more information. - a newly allocated issuer #GTlsCertificate, or %NULL. Use g_object_unref() to release the certificate. @@ -79312,7 +75778,6 @@ or %NULL. Use g_object_unref() to release the certificate. This function can block, use g_tls_database_lookup_certificates_issued_by_async() to perform the lookup operation asynchronously. - a newly allocated list of #GTlsCertificate objects. Use g_object_unref() on each certificate, and g_list_free() on the release the list. @@ -79352,7 +75817,6 @@ g_tls_database_lookup_certificates_issued_by() for more information. The database may choose to hold a reference to the issuer byte array for the duration of of this asynchronous operation. The byte array should not be modified during this time. - @@ -79392,7 +75856,6 @@ this time. Finish an asynchronous lookup of certificates. See g_tls_database_lookup_certificates_issued_by() for more information. - a newly allocated list of #GTlsCertificate objects. Use g_object_unref() on each certificate, and g_list_free() on the release the list. @@ -79449,7 +75912,6 @@ but found to be invalid. This function can block, use g_tls_database_verify_chain_async() to perform the verification operation asynchronously. - the appropriate #GTlsCertificateFlags which represents the result of verification. @@ -79490,7 +75952,6 @@ result of verification. Asynchronously determines the validity of a certificate chain after looking up and adding any missing certificates to the chain. See g_tls_database_verify_chain() for more information. - @@ -79545,7 +76006,6 @@ before it completes) then the return value will be %G_TLS_CERTIFICATE_GENERIC_ERROR and @error will be set accordingly. @error is not set when @chain is successfully analyzed but found to be invalid. - the appropriate #GTlsCertificateFlags which represents the result of verification. @@ -79573,13 +76033,11 @@ result of verification. The class for #GTlsDatabase. Derived classes should implement the various virtual methods. _async and _finish methods have a default implementation that runs the corresponding sync method in a thread. - - the appropriate #GTlsCertificateFlags which represents the result of verification. @@ -79619,7 +76077,6 @@ result of verification. - @@ -79665,7 +76122,6 @@ result of verification. - the appropriate #GTlsCertificateFlags which represents the result of verification. @@ -79685,7 +76141,6 @@ result of verification. - a newly allocated string containing the handle. @@ -79705,7 +76160,6 @@ handle. - a newly allocated #GTlsCertificate, or %NULL. Use g_object_unref() to release the certificate. @@ -79737,7 +76191,6 @@ handle. - @@ -79775,7 +76228,6 @@ handle. - a newly allocated #GTlsCertificate object. Use g_object_unref() to release the certificate. @@ -79795,7 +76247,6 @@ Use g_object_unref() to release the certificate. - a newly allocated issuer #GTlsCertificate, or %NULL. Use g_object_unref() to release the certificate. @@ -79827,7 +76278,6 @@ or %NULL. Use g_object_unref() to release the certificate. - @@ -79865,7 +76315,6 @@ or %NULL. Use g_object_unref() to release the certificate. - a newly allocated issuer #GTlsCertificate, or %NULL. Use g_object_unref() to release the certificate. @@ -79885,7 +76334,6 @@ or %NULL. Use g_object_unref() to release the certificate. - a newly allocated list of #GTlsCertificate objects. Use g_object_unref() on each certificate, and g_list_free() on the release the list. @@ -79921,7 +76369,6 @@ objects. Use g_object_unref() on each certificate, and g_list_free() on the rele - @@ -79961,7 +76408,6 @@ objects. Use g_object_unref() on each certificate, and g_list_free() on the rele - a newly allocated list of #GTlsCertificate objects. Use g_object_unref() on each certificate, and g_list_free() on the release the list. @@ -79999,9 +76445,7 @@ and g_tls_database_lookup_certificates_issued_by(). a private key. - - - + Flags for g_tls_database_verify_chain(). @@ -80056,14 +76500,12 @@ TLS-related routine. #GTlsFileDatabase is implemented by #GTlsDatabase objects which load their certificate information from a file. It is an interface which TLS library specific subtypes implement. - Creates a new #GTlsFileDatabase which uses anchor certificate authorities in @anchors to verify certificate chains. The certificates in @anchors must be PEM encoded. - the new #GTlsFileDatabase, or %NULL on error @@ -80086,7 +76528,6 @@ via the g_tls_database_verify_chain() operation. Provides an interface for #GTlsFileDatabase implementations. - The parent interface. @@ -80118,7 +76559,6 @@ like to support by overriding those virtual methods in their class initialization function. Any interactions not implemented will return %G_TLS_INTERACTION_UNHANDLED. If a derived class implements an async method, it must also implement the corresponding finish method. - Run synchronous interaction to ask the user for a password. In general, g_tls_interaction_invoke_ask_password() should be used instead of this @@ -80133,7 +76573,6 @@ If the interaction is cancelled by the cancellation object, or by the user then %G_TLS_INTERACTION_FAILED will be returned with an error that contains a %G_IO_ERROR_CANCELLED error code. Certain implementations may not support immediate cancellation. - The status of the ask password interaction. @@ -80169,7 +76608,6 @@ contains a %G_IO_ERROR_CANCELLED error code. Certain implementations may not support immediate cancellation. Certain implementations may not support immediate cancellation. - @@ -80206,7 +76644,6 @@ to g_tls_interaction_ask_password() will have its password filled in. If the interaction is cancelled by the cancellation object, or by the user then %G_TLS_INTERACTION_FAILED will be returned with an error that contains a %G_IO_ERROR_CANCELLED error code. - The status of the ask password interaction. @@ -80239,7 +76676,6 @@ If the interaction is cancelled by the cancellation object, or by the user then %G_TLS_INTERACTION_FAILED will be returned with an error that contains a %G_IO_ERROR_CANCELLED error code. Certain implementations may not support immediate cancellation. - The status of the request certificate interaction. @@ -80272,7 +76708,6 @@ Derived subclasses usually implement a certificate selector, although they may also choose to provide a certificate from elsewhere. @callback will be called when the operation completes. Alternatively the user may abort this certificate request, which will usually abort the TLS connection. - @@ -80314,7 +76749,6 @@ passed to g_tls_interaction_request_certificate_async() will have had its If the interaction is cancelled by the cancellation object, or by the user then %G_TLS_INTERACTION_FAILED will be returned with an error that contains a %G_IO_ERROR_CANCELLED error code. - The status of the request certificate interaction. @@ -80344,7 +76778,6 @@ If the interaction is cancelled by the cancellation object, or by the user then %G_TLS_INTERACTION_FAILED will be returned with an error that contains a %G_IO_ERROR_CANCELLED error code. Certain implementations may not support immediate cancellation. - The status of the ask password interaction. @@ -80380,7 +76813,6 @@ contains a %G_IO_ERROR_CANCELLED error code. Certain implementations may not support immediate cancellation. Certain implementations may not support immediate cancellation. - @@ -80417,7 +76849,6 @@ to g_tls_interaction_ask_password() will have its password filled in. If the interaction is cancelled by the cancellation object, or by the user then %G_TLS_INTERACTION_FAILED will be returned with an error that contains a %G_IO_ERROR_CANCELLED error code. - The status of the ask password interaction. @@ -80453,7 +76884,6 @@ If the interaction is cancelled by the cancellation object, or by the user then %G_TLS_INTERACTION_FAILED will be returned with an error that contains a %G_IO_ERROR_CANCELLED error code. Certain implementations may not support immediate cancellation. - The status of the ask password interaction. @@ -80494,7 +76924,6 @@ If the interaction is cancelled by the cancellation object, or by the user then %G_TLS_INTERACTION_FAILED will be returned with an error that contains a %G_IO_ERROR_CANCELLED error code. Certain implementations may not support immediate cancellation. - The status of the certificate request interaction. @@ -80535,7 +76964,6 @@ If the interaction is cancelled by the cancellation object, or by the user then %G_TLS_INTERACTION_FAILED will be returned with an error that contains a %G_IO_ERROR_CANCELLED error code. Certain implementations may not support immediate cancellation. - The status of the request certificate interaction. @@ -80568,7 +76996,6 @@ Derived subclasses usually implement a certificate selector, although they may also choose to provide a certificate from elsewhere. @callback will be called when the operation completes. Alternatively the user may abort this certificate request, which will usually abort the TLS connection. - @@ -80610,7 +77037,6 @@ passed to g_tls_interaction_request_certificate_async() will have had its If the interaction is cancelled by the cancellation object, or by the user then %G_TLS_INTERACTION_FAILED will be returned with an error that contains a %G_IO_ERROR_CANCELLED error code. - The status of the request certificate interaction. @@ -80648,13 +77074,11 @@ and the asynchronous methods to display modeless dialogs. If the user cancels an interaction, then the result should be %G_TLS_INTERACTION_FAILED and the error should be set with a domain of %G_IO_ERROR and code of %G_IO_ERROR_CANCELLED. - - The status of the ask password interaction. @@ -80677,7 +77101,6 @@ If the user cancels an interaction, then the result should be - @@ -80707,7 +77130,6 @@ If the user cancels an interaction, then the result should be - The status of the ask password interaction. @@ -80726,7 +77148,6 @@ If the user cancels an interaction, then the result should be - The status of the request certificate interaction. @@ -80753,7 +77174,6 @@ If the user cancels an interaction, then the result should be - @@ -80787,7 +77207,6 @@ If the user cancels an interaction, then the result should be - The status of the request certificate interaction. @@ -80810,9 +77229,7 @@ If the user cancels an interaction, then the result should be - - - + #GTlsInteractionResult is returned by various functions in #GTlsInteraction when finishing an interaction request. @@ -80831,10 +77248,8 @@ when finishing an interaction request. Holds a password used in TLS. - Create a new #GTlsPassword object. - The newly allocated password object @@ -80851,7 +77266,6 @@ when finishing an interaction request. - @@ -80867,7 +77281,6 @@ filled in with the length of the password value. (Note that the password value is not nul-terminated, so you can only pass %NULL for @length in contexts where you know the password will have a certain fixed length.) - The password value (owned by the password object). @@ -80893,7 +77306,6 @@ Specify the @length, for a non-nul-terminated password. Pass -1 as @length if using a nul-terminated password, and @length will be calculated automatically. (Note that the terminating nul is not considered part of the password in this case.) - @@ -80920,7 +77332,6 @@ considered part of the password in this case.) Get a description string about what the password will be used for. - The description of the password. @@ -80934,7 +77345,6 @@ considered part of the password in this case.) Get flags about the password. - The flags about the password. @@ -80952,7 +77362,6 @@ filled in with the length of the password value. (Note that the password value is not nul-terminated, so you can only pass %NULL for @length in contexts where you know the password will have a certain fixed length.) - The password value (owned by the password object). @@ -80972,7 +77381,6 @@ certain fixed length.) Get a user readable translated warning. Usually this warning is a representation of the password flags returned from g_tls_password_get_flags(). - The warning. @@ -80986,7 +77394,6 @@ g_tls_password_get_flags(). Set a description string about what the password will be used for. - @@ -81003,7 +77410,6 @@ g_tls_password_get_flags(). Set flags about the password. - @@ -81026,7 +77432,6 @@ Specify the @length, for a non-nul-terminated password. Pass -1 as @length if using a nul-terminated password, and @length will be calculated automatically. (Note that the terminating nul is not considered part of the password in this case.) - @@ -81057,7 +77462,6 @@ Specify the @length, for a non-nul-terminated password. Pass -1 as @length if using a nul-terminated password, and @length will be calculated automatically. (Note that the terminating nul is not considered part of the password in this case.) - @@ -81086,7 +77490,6 @@ considered part of the password in this case.) Set a user readable translated warning. Usually this warning is a representation of the password flags returned from g_tls_password_get_flags(). - @@ -81119,13 +77522,11 @@ g_tls_password_get_flags(). Class structure for #GTlsPassword. - - The password value (owned by the password object). @@ -81144,7 +77545,6 @@ g_tls_password_get_flags(). - @@ -81172,7 +77572,6 @@ g_tls_password_get_flags(). - @@ -81206,9 +77605,7 @@ g_tls_password_get_flags(). this password right. - - - + When to allow rehandshaking. See g_tls_connection_set_rehandshake_mode(). @@ -81228,7 +77625,6 @@ g_tls_connection_set_rehandshake_mode(). #GTlsServerConnection is the server-side subclass of #GTlsConnection, representing a server-side TLS connection. - Creates a new #GTlsServerConnection wrapping @base_io_stream (which @@ -81237,7 +77633,6 @@ must have pollable input and output streams). See the documentation for #GTlsConnection:base-io-stream for restrictions on when application code can run operations on the @base_io_stream after this function has returned. - the new #GTlsServerConnection, or %NULL on error @@ -81263,168 +77658,144 @@ rehandshake with a different mode from the initial handshake. vtable for a #GTlsServerConnection implementation. - The parent interface. - - - - - - - - - - - - - - - - - - - - - - - @@ -81440,7 +77811,6 @@ functionality like passing file descriptors. Note that `<gio/gunixconnection.h>` belongs to the UNIX-specific GIO interfaces, thus you have to use the `gio-unix-2.0.pc` pkg-config file when using it. - Receives credentials from the sending end of the connection. The sending end has to call g_unix_connection_send_credentials() (or @@ -81460,7 +77830,6 @@ This method can be expected to be available on the following platforms: Other ways to exchange credentials with a foreign peer includes the #GUnixCredentialsMessage type and g_socket_get_credentials() function. - Received credentials on success (free with g_object_unref()), %NULL if @error is set. @@ -81485,7 +77854,6 @@ the synchronous version of this call. When the operation is finished, @callback will be called. You can then call g_unix_connection_receive_credentials_finish() to get the result of the operation. - @@ -81511,7 +77879,6 @@ g_unix_connection_receive_credentials_finish() to get the result of the operatio Finishes an asynchronous receive credentials operation started with g_unix_connection_receive_credentials_async(). - a #GCredentials, or %NULL on error. Free the returned object with g_object_unref(). @@ -81536,7 +77903,6 @@ to work. As well as reading the fd this also reads a single byte from the stream, as this is required for fd passing to work on some implementations. - a file descriptor on success, -1 on error. @@ -81572,7 +77938,6 @@ This method can be expected to be available on the following platforms: Other ways to exchange credentials with a foreign peer includes the #GUnixCredentialsMessage type and g_socket_get_credentials() function. - %TRUE on success, %FALSE if @error is set. @@ -81596,7 +77961,6 @@ the synchronous version of this call. When the operation is finished, @callback will be called. You can then call g_unix_connection_send_credentials_finish() to get the result of the operation. - @@ -81622,7 +77986,6 @@ g_unix_connection_send_credentials_finish() to get the result of the operation.< Finishes an asynchronous send credentials operation started with g_unix_connection_send_credentials_async(). - %TRUE if the operation was successful, otherwise %FALSE. @@ -81646,7 +78009,6 @@ to accept the file descriptor. As well as sending the fd this also writes a single byte to the stream, as this is required for fd passing to work on some implementations. - a %TRUE on success, %NULL on error. @@ -81674,14 +78036,11 @@ implementations. - - - - + This #GSocketControlMessage contains a #GCredentials instance. It may be sent using g_socket_send_message() and received using @@ -81694,10 +78053,8 @@ g_unix_connection_send_credentials() and g_unix_connection_receive_credentials(). To receive credentials of a foreign process connected to a socket, use g_socket_get_credentials(). - Creates a new #GUnixCredentialsMessage with credentials matching the current processes. - a new #GUnixCredentialsMessage @@ -81705,7 +78062,6 @@ g_socket_get_credentials(). Creates a new #GUnixCredentialsMessage holding @credentials. - a new #GUnixCredentialsMessage @@ -81719,7 +78075,6 @@ g_socket_get_credentials(). Checks if passing #GCredentials on a #GSocket is supported on this platform. - %TRUE if supported, %FALSE otherwise @@ -81727,7 +78082,6 @@ g_socket_get_credentials(). Gets the credentials stored in @message. - A #GCredentials instance. Do not free, it is owned by @message. @@ -81752,13 +78106,11 @@ g_socket_get_credentials(). Class structure for #GUnixCredentialsMessage. - - @@ -81766,16 +78118,13 @@ g_socket_get_credentials(). - - - - + A #GUnixFDList contains a list of file descriptors. It owns the file descriptors that it contains, closing them when finalized. @@ -81787,10 +78136,8 @@ and received using g_socket_receive_message(). Note that `<gio/gunixfdlist.h>` belongs to the UNIX-specific GIO interfaces, thus you have to use the `gio-unix-2.0.pc` pkg-config file when using it. - Creates a new #GUnixFDList containing no file descriptors. - a new #GUnixFDList @@ -81805,7 +78152,6 @@ the caller. Each file descriptor in the array should be set to close-on-exec. If @n_fds is -1 then @fds must be terminated with -1. - a new #GUnixFDList @@ -81836,7 +78182,6 @@ system-wide file descriptor limit. The index of the file descriptor in the list is returned. If you use this index with g_unix_fd_list_get() then you will receive back a duplicated copy of the same file descriptor. - the index of the appended fd in case of success, else -1 (and @error is set) @@ -81866,7 +78211,6 @@ when you are done. A possible cause of failure is exceeding the per-process or system-wide file descriptor limit. - the file descriptor, or -1 in case of error @@ -81885,7 +78229,6 @@ system-wide file descriptor limit. Gets the length of @list (ie: the number of file descriptors contained within). - the length of @list @@ -81911,7 +78254,6 @@ terminated with -1. This function never returns %NULL. In case there are no file descriptors contained in @list, an empty array is returned. - an array of file descriptors @@ -81950,7 +78292,6 @@ terminated with -1. This function never returns %NULL. In case there are no file descriptors contained in @list, an empty array is returned. - an array of file descriptors @@ -81978,13 +78319,11 @@ descriptors contained in @list, an empty array is returned. - - @@ -81992,7 +78331,6 @@ descriptors contained in @list, an empty array is returned. - @@ -82000,7 +78338,6 @@ descriptors contained in @list, an empty array is returned. - @@ -82008,7 +78345,6 @@ descriptors contained in @list, an empty array is returned. - @@ -82016,16 +78352,13 @@ descriptors contained in @list, an empty array is returned. - - - - + This #GSocketControlMessage contains a #GUnixFDList. It may be sent using g_socket_send_message() and received using @@ -82040,11 +78373,9 @@ g_unix_connection_receive_fd(). Note that `<gio/gunixfdmessage.h>` belongs to the UNIX-specific GIO interfaces, thus you have to use the `gio-unix-2.0.pc` pkg-config file when using it. - Creates a new #GUnixFDMessage containing an empty file descriptor list. - a new #GUnixFDMessage @@ -82052,7 +78383,6 @@ list. Creates a new #GUnixFDMessage containing @list. - a new #GUnixFDMessage @@ -82073,7 +78403,6 @@ when @message is finalized. A possible cause of failure is exceeding the per-process or system-wide file descriptor limit. - %TRUE in case of success, else %FALSE (and @error is set) @@ -82093,7 +78422,6 @@ system-wide file descriptor limit. Gets the #GUnixFDList contained in @message. This function does not return a reference to the caller, but the returned list is valid for the lifetime of @message. - the #GUnixFDList from @message @@ -82123,7 +78451,6 @@ terminated with -1. This function never returns %NULL. In case there are no file descriptors contained in @message, an empty array is returned. - an array of file descriptors @@ -82154,13 +78481,11 @@ descriptors contained in @message, an empty array is returned. - - @@ -82168,16 +78493,13 @@ descriptors contained in @message, an empty array is returned. - - - - + #GUnixInputStream implements #GInputStream for reading from a UNIX file descriptor, including asynchronous operations. (If the file @@ -82188,7 +78510,6 @@ to doing asynchronous I/O in another thread.) Note that `<gio/gunixinputstream.h>` belongs to the UNIX-specific GIO interfaces, thus you have to use the `gio-unix-2.0.pc` pkg-config file when using it. - @@ -82196,7 +78517,6 @@ file when using it. If @close_fd is %TRUE, the file descriptor will be closed when the stream is closed. - a new #GUnixInputStream @@ -82215,7 +78535,6 @@ when the stream is closed. Returns whether the file descriptor of @stream will be closed when the stream is closed. - %TRUE if the file descriptor is closed when done @@ -82229,7 +78548,6 @@ closed when the stream is closed. Return the UNIX file descriptor that the stream reads from. - The file descriptor of @stream @@ -82244,7 +78562,6 @@ closed when the stream is closed. Sets whether the file descriptor of @stream shall be closed when the stream is closed. - @@ -82275,13 +78592,11 @@ when the stream is closed. - - @@ -82289,7 +78604,6 @@ when the stream is closed. - @@ -82297,7 +78611,6 @@ when the stream is closed. - @@ -82305,7 +78618,6 @@ when the stream is closed. - @@ -82313,31 +78625,25 @@ when the stream is closed. - - - - + Defines a Unix mount entry (e.g. <filename>/media/cdrom</filename>). This corresponds roughly to a mtab entry. - Watches #GUnixMounts for changes. - Deprecated alias for g_unix_mount_monitor_get(). This function was never a true constructor, which is why it was renamed. Use g_unix_mount_monitor_get() instead. - a #GUnixMountMonitor. @@ -82353,7 +78659,6 @@ entries). You must only call g_object_unref() on the return value from under the same main context as you called this function. - the #GUnixMountMonitor. @@ -82368,7 +78673,6 @@ circumstances. Since @mount_monitor is a singleton, it also meant that calling this function would have side effects for other users of the monitor. This function does nothing. Don't call it. - @@ -82397,16 +78701,12 @@ the monitor. - - - + Defines a Unix mount point (e.g. <filename>/dev</filename>). This corresponds roughly to a fstab entry. - Compares two unix mount points. - 1, 0 or -1 if @mount1 is greater than, equal to, or less than @mount2, respectively. @@ -82425,7 +78725,6 @@ or less than @mount2, respectively. Makes a copy of @mount_point. - a new #GUnixMountPoint @@ -82439,7 +78738,6 @@ or less than @mount2, respectively. Frees a unix mount point. - @@ -82452,7 +78750,6 @@ or less than @mount2, respectively. Gets the device path for a unix mount point. - a string containing the device path. @@ -82466,7 +78763,6 @@ or less than @mount2, respectively. Gets the file system type for the mount point. - a string containing the file system type. @@ -82480,7 +78776,6 @@ or less than @mount2, respectively. Gets the mount path for a unix mount point. - a string containing the mount path. @@ -82494,8 +78789,7 @@ or less than @mount2, respectively. Gets the options for the mount point. - - + a string containing the options. @@ -82508,7 +78802,6 @@ or less than @mount2, respectively. Guesses whether a Unix mount point can be ejected. - %TRUE if @mount_point is deemed to be ejectable. @@ -82522,7 +78815,6 @@ or less than @mount2, respectively. Guesses the icon of a Unix mount point. - a #GIcon @@ -82537,7 +78829,6 @@ or less than @mount2, respectively. Guesses the name of a Unix mount point. The result is a translated string. - A newly allocated string that must be freed with g_free() @@ -82552,7 +78843,6 @@ The result is a translated string. Guesses the symbolic icon of a Unix mount point. - a #GIcon @@ -82566,7 +78856,6 @@ The result is a translated string. Checks if a unix mount point is a loopback device. - %TRUE if the mount point is a loopback. %FALSE otherwise. @@ -82580,7 +78869,6 @@ The result is a translated string. Checks if a unix mount point is read only. - %TRUE if a mount point is read only. @@ -82594,7 +78882,6 @@ The result is a translated string. Checks if a unix mount point is mountable by the user. - %TRUE if the mount point is user mountable. @@ -82613,7 +78900,6 @@ changed since with g_unix_mount_points_changed_since(). If more mount points have the same mount path, the last matching mount point is returned. - a #GUnixMountPoint, or %NULL if no match is found. @@ -82641,7 +78927,6 @@ to doing asynchronous I/O in another thread.) Note that `<gio/gunixoutputstream.h>` belongs to the UNIX-specific GIO interfaces, thus you have to use the `gio-unix-2.0.pc` pkg-config file when using it. - @@ -82649,7 +78934,6 @@ when using it. If @close_fd, is %TRUE, the file descriptor will be closed when the output stream is destroyed. - a new #GOutputStream @@ -82668,7 +78952,6 @@ the output stream is destroyed. Returns whether the file descriptor of @stream will be closed when the stream is closed. - %TRUE if the file descriptor is closed when done @@ -82682,7 +78965,6 @@ closed when the stream is closed. Return the UNIX file descriptor that the stream writes to. - The file descriptor of @stream @@ -82697,7 +78979,6 @@ closed when the stream is closed. Sets whether the file descriptor of @stream shall be closed when the stream is closed. - @@ -82728,13 +79009,11 @@ when the stream is closed. - - @@ -82742,7 +79021,6 @@ when the stream is closed. - @@ -82750,7 +79028,6 @@ when the stream is closed. - @@ -82758,7 +79035,6 @@ when the stream is closed. - @@ -82766,16 +79042,13 @@ when the stream is closed. - - - - + Support for UNIX-domain (also known as local) sockets. @@ -82791,14 +79064,12 @@ to see if abstract names are supported. Note that `<gio/gunixsocketaddress.h>` belongs to the UNIX-specific GIO interfaces, thus you have to use the `gio-unix-2.0.pc` pkg-config file when using it. - Creates a new #GUnixSocketAddress for @path. To create abstract socket addresses, on systems that support that, use g_unix_socket_address_new_abstract(). - a new #GUnixSocketAddress @@ -82814,7 +79085,6 @@ use g_unix_socket_address_new_abstract(). Creates a new %G_UNIX_SOCKET_ADDRESS_ABSTRACT_PADDED #GUnixSocketAddress for @path. Use g_unix_socket_address_new_with_type(). - a new #GUnixSocketAddress @@ -82864,7 +79134,6 @@ length of @path. when connecting to a server created by another process, you must use the appropriate type corresponding to how that process created its listening socket. - a new #GUnixSocketAddress @@ -82888,7 +79157,6 @@ its listening socket. Checks if abstract UNIX domain socket names are supported. - %TRUE if supported, %FALSE otherwise @@ -82896,7 +79164,6 @@ its listening socket. Gets @address's type. - a #GUnixSocketAddressType @@ -82911,7 +79178,6 @@ its listening socket. Tests if @address is abstract. Use g_unix_socket_address_get_address_type() - %TRUE if the address is abstract, %FALSE otherwise @@ -82930,7 +79196,6 @@ Guaranteed to be zero-terminated, but an abstract socket may contain embedded zeros, and thus you should use g_unix_socket_address_get_path_len() to get the true length of this string. - the path for @address @@ -82946,7 +79211,6 @@ of this string. Gets the length of @address's path. For details, see g_unix_socket_address_get_path(). - the length of the path @@ -82984,14 +79248,11 @@ abstract addresses. - - - - + The type of name used by a #GUnixSocketAddress. %G_UNIX_SOCKET_ADDRESS_PATH indicates a traditional unix domain @@ -83024,14 +79285,12 @@ pass an appropriate smaller length to bind() or connect(). This is - - @@ -83040,25 +79299,21 @@ pass an appropriate smaller length to bind() or connect(). This is Extension point for #GVfs functionality. See [Extending GIO][extending-gio]. - - - - @@ -83074,44 +79329,36 @@ This is intended to be used by applications to classify #GVolume instances into different sections - for example a file manager or file chooser can use this information to show `network` volumes under a "Network" heading and `device` volumes under a "Devices" heading. - The string used to obtain a Hal UDI with g_volume_get_identifier(). Do not use, HAL is deprecated. - The string used to obtain a filesystem label with g_volume_get_identifier(). - The string used to obtain a NFS mount with g_volume_get_identifier(). - The string used to obtain a Unix device path with g_volume_get_identifier(). - The string used to obtain a UUID with g_volume_get_identifier(). - - - @@ -83120,11 +79367,9 @@ a "Network" heading and `device` volumes under a "Devices" heading. Extension point for volume monitor functionality. See [Extending GIO][extending-gio]. - - @@ -83132,25 +79377,22 @@ See [Extending GIO][extending-gio]. Entry point for using GIO functionality. - Gets the default #GVfs for the system. - - a #GVfs. + a #GVfs, which will be the local + file system #GVfs if no other implementation is available. Gets the local #GVfs for the system. - a #GVfs. - @@ -83164,7 +79406,6 @@ See [Extending GIO][extending-gio]. - @@ -83179,7 +79420,6 @@ See [Extending GIO][extending-gio]. Gets a #GFile for @path. - a #GFile. Free the returned object with g_object_unref(). @@ -83202,7 +79442,6 @@ See [Extending GIO][extending-gio]. This operation never fails, but the returned object might not support any I/O operation if the URI is malformed or if the URI scheme is not supported. - a #GFile. Free the returned object with g_object_unref(). @@ -83221,7 +79460,6 @@ is malformed or if the URI scheme is not supported. Gets a list of URI schemes supported by @vfs. - a %NULL-terminated array of strings. The returned array belongs to GIO and must @@ -83239,7 +79477,6 @@ is malformed or if the URI scheme is not supported. Checks if the VFS is active. - %TRUE if construction of the @vfs was successful and it is now active. @@ -83253,7 +79490,6 @@ is malformed or if the URI scheme is not supported. - @@ -83285,7 +79521,6 @@ is malformed or if the URI scheme is not supported. - @@ -83302,7 +79537,6 @@ is malformed or if the URI scheme is not supported. - @@ -83316,7 +79550,6 @@ is malformed or if the URI scheme is not supported. - @@ -83342,7 +79575,6 @@ is malformed or if the URI scheme is not supported. This operation never fails, but the returned object might not support any I/O operations if the @parse_name cannot be parsed by the #GVfs module. - a #GFile for the given @parse_name. Free the returned object with g_object_unref(). @@ -83361,7 +79593,6 @@ be parsed by the #GVfs module. Gets a #GFile for @path. - a #GFile. Free the returned object with g_object_unref(). @@ -83384,7 +79615,6 @@ be parsed by the #GVfs module. This operation never fails, but the returned object might not support any I/O operation if the URI is malformed or if the URI scheme is not supported. - a #GFile. Free the returned object with g_object_unref(). @@ -83403,7 +79633,6 @@ is malformed or if the URI scheme is not supported. Gets a list of URI schemes supported by @vfs. - a %NULL-terminated array of strings. The returned array belongs to GIO and must @@ -83421,7 +79650,6 @@ is malformed or if the URI scheme is not supported. Checks if the VFS is active. - %TRUE if construction of the @vfs was successful and it is now active. @@ -83438,7 +79666,6 @@ is malformed or if the URI scheme is not supported. This operation never fails, but the returned object might not support any I/O operations if the @parse_name cannot be parsed by the #GVfs module. - a #GFile for the given @parse_name. Free the returned object with g_object_unref(). @@ -83476,7 +79703,6 @@ g_vfs_register_uri_scheme() or g_vfs_unregister_uri_scheme(). It's an error to call this function twice with the same scheme. To unregister a custom URI scheme, use g_vfs_unregister_uri_scheme(). - %TRUE if @scheme was successfully registered, or %FALSE if a handler for @scheme already exists. @@ -83525,7 +79751,6 @@ a custom URI scheme, use g_vfs_unregister_uri_scheme(). Unregisters the URI handler for @scheme previously registered with g_vfs_register_uri_scheme(). - %TRUE if @scheme was successfully unregistered, or %FALSE if a handler for @scheme does not exist. @@ -83547,13 +79772,11 @@ g_vfs_register_uri_scheme(). - - %TRUE if construction of the @vfs was successful and it is now active. @@ -83569,7 +79792,6 @@ g_vfs_register_uri_scheme(). - a #GFile. Free the returned object with g_object_unref(). @@ -83589,7 +79811,6 @@ g_vfs_register_uri_scheme(). - a #GFile. Free the returned object with g_object_unref(). @@ -83609,7 +79830,6 @@ g_vfs_register_uri_scheme(). - a %NULL-terminated array of strings. The returned array belongs to GIO and must @@ -83628,7 +79848,6 @@ g_vfs_register_uri_scheme(). - a #GFile for the given @parse_name. Free the returned object with g_object_unref(). @@ -83648,7 +79867,6 @@ g_vfs_register_uri_scheme(). - @@ -83682,7 +79900,6 @@ g_vfs_register_uri_scheme(). - @@ -83698,7 +79915,6 @@ g_vfs_register_uri_scheme(). - @@ -83723,7 +79939,6 @@ g_vfs_register_uri_scheme(). - @@ -83739,7 +79954,6 @@ g_vfs_register_uri_scheme(). - @@ -83758,7 +79972,6 @@ g_vfs_register_uri_scheme(). - @@ -83774,7 +79987,6 @@ g_vfs_register_uri_scheme(). - @@ -83782,7 +79994,6 @@ g_vfs_register_uri_scheme(). - @@ -83790,7 +80001,6 @@ g_vfs_register_uri_scheme(). - @@ -83798,7 +80008,6 @@ g_vfs_register_uri_scheme(). - @@ -83806,7 +80015,6 @@ g_vfs_register_uri_scheme(). - @@ -83814,7 +80022,6 @@ g_vfs_register_uri_scheme(). - @@ -83828,7 +80035,6 @@ implementation. The client should return a reference to the new file that has been created for @uri, or %NULL to continue with the default implementation. - a #GFile for @identifier. @@ -83891,10 +80097,8 @@ when the gvfs hal volume monitor is in use. Other volume monitors will generally be able to provide the #G_VOLUME_IDENTIFIER_KIND_UNIX_DEVICE identifier, which can be used to obtain a hal device by means of libhal_manager_find_device_string_match(). - Checks if a volume can be ejected. - %TRUE if the @volume can be ejected. %FALSE otherwise @@ -83908,7 +80112,6 @@ libhal_manager_find_device_string_match(). Checks if a volume can be mounted. - %TRUE if the @volume can be mounted. %FALSE otherwise @@ -83921,7 +80124,6 @@ libhal_manager_find_device_string_match(). - @@ -83936,7 +80138,6 @@ libhal_manager_find_device_string_match(). finished by calling g_volume_eject_finish() with the @volume and #GAsyncResult returned in the @callback. Use g_volume_eject_with_operation() instead. - @@ -83967,7 +80168,6 @@ and #GAsyncResult returned in the @callback. Finishes ejecting a volume. If any errors occurred during the operation, @error will be set to contain the errors and %FALSE will be returned. Use g_volume_eject_with_operation_finish() instead. - %TRUE, %FALSE if operation failed @@ -83987,7 +80187,6 @@ and #GAsyncResult returned in the @callback. Ejects a volume. This is an asynchronous operation, and is finished by calling g_volume_eject_with_operation_finish() with the @volume and #GAsyncResult data returned in the @callback. - @@ -84022,7 +80221,6 @@ and #GAsyncResult data returned in the @callback. Finishes ejecting a volume. If any errors occurred during the operation, @error will be set to contain the errors and %FALSE will be returned. - %TRUE if the volume was successfully ejected. %FALSE otherwise @@ -84041,7 +80239,6 @@ and #GAsyncResult data returned in the @callback. Gets the kinds of [identifiers][volume-identifier] that @volume has. Use g_volume_get_identifier() to obtain the identifiers themselves. - a %NULL-terminated array of strings containing kinds of identifiers. Use g_strfreev() to free. @@ -84083,7 +80280,6 @@ will always be %TRUE. Activation roots are typically used in #GVolumeMonitor implementations to find the underlying mount to shadow, see g_mount_is_shadowed() for more details. - the activation root of @volume or %NULL. Use g_object_unref() to free. @@ -84098,7 +80294,6 @@ g_mount_is_shadowed() for more details. Gets the drive for the @volume. - a #GDrive or %NULL if @volume is not associated with a drive. The returned object should be unreffed @@ -84114,7 +80309,6 @@ g_mount_is_shadowed() for more details. Gets the icon for @volume. - a #GIcon. The returned object should be unreffed with g_object_unref() @@ -84132,7 +80326,6 @@ g_mount_is_shadowed() for more details. Gets the identifier of the given kind for @volume. See the [introduction][volume-identifier] for more information about volume identifiers. - a newly allocated string containing the requested identifier, or %NULL if the #GVolume @@ -84152,7 +80345,6 @@ information about volume identifiers. Gets the mount for the @volume. - a #GMount or %NULL if @volume isn't mounted. The returned object should be unreffed with g_object_unref() @@ -84168,7 +80360,6 @@ information about volume identifiers. Gets the name of @volume. - the name for the given @volume. The returned string should be freed with g_free() when no longer needed. @@ -84183,7 +80374,6 @@ information about volume identifiers. Gets the sort key for @volume, if any. - Sorting key for @volume or %NULL if no such key is available @@ -84197,7 +80387,6 @@ information about volume identifiers. Gets the symbolic icon for @volume. - a #GIcon. The returned object should be unreffed with g_object_unref() @@ -84216,7 +80405,6 @@ information about volume identifiers. the file system UUID for the volume in question and should be considered an opaque string. Returns %NULL if there is no UUID available. - the UUID for @volume or %NULL if no UUID can be computed. @@ -84239,7 +80427,6 @@ If the mount operation succeeded, g_volume_get_mount() on @volume is guaranteed to return the mount right after calling this function; there's no need to listen for the 'mount-added' signal on #GVolumeMonitor. - %TRUE, %FALSE if operation failed @@ -84259,7 +80446,6 @@ function; there's no need to listen for the 'mount-added' signal on Mounts a volume. This is an asynchronous operation, and is finished by calling g_volume_mount_finish() with the @volume and #GAsyncResult returned in the @callback. - @@ -84291,7 +80477,6 @@ and #GAsyncResult returned in the @callback. - @@ -84303,7 +80488,6 @@ and #GAsyncResult returned in the @callback. Returns whether the volume should be automatically mounted. - %TRUE if the volume should be automatically mounted @@ -84317,7 +80501,6 @@ and #GAsyncResult returned in the @callback. Checks if a volume can be ejected. - %TRUE if the @volume can be ejected. %FALSE otherwise @@ -84331,7 +80514,6 @@ and #GAsyncResult returned in the @callback. Checks if a volume can be mounted. - %TRUE if the @volume can be mounted. %FALSE otherwise @@ -84348,7 +80530,6 @@ and #GAsyncResult returned in the @callback. finished by calling g_volume_eject_finish() with the @volume and #GAsyncResult returned in the @callback. Use g_volume_eject_with_operation() instead. - @@ -84379,7 +80560,6 @@ and #GAsyncResult returned in the @callback. Finishes ejecting a volume. If any errors occurred during the operation, @error will be set to contain the errors and %FALSE will be returned. Use g_volume_eject_with_operation_finish() instead. - %TRUE, %FALSE if operation failed @@ -84399,7 +80579,6 @@ and #GAsyncResult returned in the @callback. Ejects a volume. This is an asynchronous operation, and is finished by calling g_volume_eject_with_operation_finish() with the @volume and #GAsyncResult data returned in the @callback. - @@ -84434,7 +80613,6 @@ and #GAsyncResult data returned in the @callback. Finishes ejecting a volume. If any errors occurred during the operation, @error will be set to contain the errors and %FALSE will be returned. - %TRUE if the volume was successfully ejected. %FALSE otherwise @@ -84453,7 +80631,6 @@ and #GAsyncResult data returned in the @callback. Gets the kinds of [identifiers][volume-identifier] that @volume has. Use g_volume_get_identifier() to obtain the identifiers themselves. - a %NULL-terminated array of strings containing kinds of identifiers. Use g_strfreev() to free. @@ -84495,7 +80672,6 @@ will always be %TRUE. Activation roots are typically used in #GVolumeMonitor implementations to find the underlying mount to shadow, see g_mount_is_shadowed() for more details. - the activation root of @volume or %NULL. Use g_object_unref() to free. @@ -84510,7 +80686,6 @@ g_mount_is_shadowed() for more details. Gets the drive for the @volume. - a #GDrive or %NULL if @volume is not associated with a drive. The returned object should be unreffed @@ -84526,7 +80701,6 @@ g_mount_is_shadowed() for more details. Gets the icon for @volume. - a #GIcon. The returned object should be unreffed with g_object_unref() @@ -84544,7 +80718,6 @@ g_mount_is_shadowed() for more details. Gets the identifier of the given kind for @volume. See the [introduction][volume-identifier] for more information about volume identifiers. - a newly allocated string containing the requested identifier, or %NULL if the #GVolume @@ -84564,7 +80737,6 @@ information about volume identifiers. Gets the mount for the @volume. - a #GMount or %NULL if @volume isn't mounted. The returned object should be unreffed with g_object_unref() @@ -84580,7 +80752,6 @@ information about volume identifiers. Gets the name of @volume. - the name for the given @volume. The returned string should be freed with g_free() when no longer needed. @@ -84595,7 +80766,6 @@ information about volume identifiers. Gets the sort key for @volume, if any. - Sorting key for @volume or %NULL if no such key is available @@ -84609,7 +80779,6 @@ information about volume identifiers. Gets the symbolic icon for @volume. - a #GIcon. The returned object should be unreffed with g_object_unref() @@ -84628,7 +80797,6 @@ information about volume identifiers. the file system UUID for the volume in question and should be considered an opaque string. Returns %NULL if there is no UUID available. - the UUID for @volume or %NULL if no UUID can be computed. @@ -84647,7 +80815,6 @@ available. Mounts a volume. This is an asynchronous operation, and is finished by calling g_volume_mount_finish() with the @volume and #GAsyncResult returned in the @callback. - @@ -84686,7 +80853,6 @@ If the mount operation succeeded, g_volume_get_mount() on @volume is guaranteed to return the mount right after calling this function; there's no need to listen for the 'mount-added' signal on #GVolumeMonitor. - %TRUE, %FALSE if operation failed @@ -84704,7 +80870,6 @@ function; there's no need to listen for the 'mount-added' signal on Returns whether the volume should be automatically mounted. - %TRUE if the volume should be automatically mounted @@ -84733,14 +80898,12 @@ release them so the object can be finalized. Interface for implementing operations for mountable volumes. - The parent interface. - @@ -84753,7 +80916,6 @@ release them so the object can be finalized. - @@ -84766,7 +80928,6 @@ release them so the object can be finalized. - the name for the given @volume. The returned string should be freed with g_free() when no longer needed. @@ -84782,7 +80943,6 @@ release them so the object can be finalized. - a #GIcon. The returned object should be unreffed with g_object_unref() @@ -84799,7 +80959,6 @@ release them so the object can be finalized. - the UUID for @volume or %NULL if no UUID can be computed. @@ -84817,7 +80976,6 @@ release them so the object can be finalized. - a #GDrive or %NULL if @volume is not associated with a drive. The returned object should be unreffed @@ -84834,7 +80992,6 @@ release them so the object can be finalized. - a #GMount or %NULL if @volume isn't mounted. The returned object should be unreffed with g_object_unref() @@ -84851,7 +81008,6 @@ release them so the object can be finalized. - %TRUE if the @volume can be mounted. %FALSE otherwise @@ -84866,7 +81022,6 @@ release them so the object can be finalized. - %TRUE if the @volume can be ejected. %FALSE otherwise @@ -84881,7 +81036,6 @@ release them so the object can be finalized. - @@ -84915,7 +81069,6 @@ release them so the object can be finalized. - %TRUE, %FALSE if operation failed @@ -84934,7 +81087,6 @@ release them so the object can be finalized. - @@ -84964,7 +81116,6 @@ release them so the object can be finalized. - %TRUE, %FALSE if operation failed @@ -84983,7 +81134,6 @@ release them so the object can be finalized. - a newly allocated string containing the requested identifier, or %NULL if the #GVolume @@ -85004,7 +81154,6 @@ release them so the object can be finalized. - a %NULL-terminated array of strings containing kinds of identifiers. Use g_strfreev() to free. @@ -85022,7 +81171,6 @@ release them so the object can be finalized. - %TRUE if the volume should be automatically mounted @@ -85037,7 +81185,6 @@ release them so the object can be finalized. - the activation root of @volume or %NULL. Use g_object_unref() to free. @@ -85053,7 +81200,6 @@ release them so the object can be finalized. - @@ -85088,7 +81234,6 @@ release them so the object can be finalized. - %TRUE if the volume was successfully ejected. %FALSE otherwise @@ -85107,7 +81252,6 @@ release them so the object can be finalized. - Sorting key for @volume or %NULL if no such key is available @@ -85122,7 +81266,6 @@ release them so the object can be finalized. - a #GIcon. The returned object should be unreffed with g_object_unref() @@ -85150,7 +81293,6 @@ thread-default-context active. In order to receive updates about volumes and mounts monitored through GVFS, a main loop must be running. - This function should be called by any #GVolumeMonitor implementation when a new #GMount object is created that is not @@ -85185,7 +81327,6 @@ implementations should instead create shadow mounts with the URI of the mount they intend to adopt. See the proxy volume monitor in gvfs for an example of this. Also see g_mount_is_shadowed(), g_mount_shadow() and g_mount_unshadow() functions. - the #GVolume object that is the parent for @mount or %NULL if no wants to adopt the #GMount. @@ -85200,7 +81341,6 @@ if no wants to adopt the #GMount. Gets the volume monitor used by gio. - a reference to the #GVolumeMonitor used by gio. Call g_object_unref() when done with it. @@ -85208,7 +81348,6 @@ if no wants to adopt the #GMount. - @@ -85222,7 +81361,6 @@ if no wants to adopt the #GMount. - @@ -85236,7 +81374,6 @@ if no wants to adopt the #GMount. - @@ -85250,7 +81387,6 @@ if no wants to adopt the #GMount. - @@ -85264,7 +81400,6 @@ if no wants to adopt the #GMount. - @@ -85282,7 +81417,6 @@ if no wants to adopt the #GMount. The returned list should be freed with g_list_free(), after its elements have been unreffed with g_object_unref(). - a #GList of connected #GDrive objects. @@ -85298,8 +81432,7 @@ its elements have been unreffed with g_object_unref(). Finds a #GMount object by its UUID (see g_mount_get_uuid()) - - + a #GMount or %NULL if no such mount is available. Free the returned object with g_object_unref(). @@ -85320,7 +81453,6 @@ its elements have been unreffed with g_object_unref(). The returned list should be freed with g_list_free(), after its elements have been unreffed with g_object_unref(). - a #GList of #GMount objects. @@ -85336,8 +81468,7 @@ its elements have been unreffed with g_object_unref(). Finds a #GVolume object by its UUID (see g_volume_get_uuid()) - - + a #GVolume or %NULL if no such volume is available. Free the returned object with g_object_unref(). @@ -85358,7 +81489,6 @@ its elements have been unreffed with g_object_unref(). The returned list should be freed with g_list_free(), after its elements have been unreffed with g_object_unref(). - a #GList of #GVolume objects. @@ -85373,7 +81503,6 @@ its elements have been unreffed with g_object_unref(). - @@ -85387,7 +81516,6 @@ its elements have been unreffed with g_object_unref(). - @@ -85401,7 +81529,6 @@ its elements have been unreffed with g_object_unref(). - @@ -85415,7 +81542,6 @@ its elements have been unreffed with g_object_unref(). - @@ -85429,7 +81555,6 @@ its elements have been unreffed with g_object_unref(). - @@ -85443,7 +81568,6 @@ its elements have been unreffed with g_object_unref(). - @@ -85457,7 +81581,6 @@ its elements have been unreffed with g_object_unref(). - @@ -85475,7 +81598,6 @@ its elements have been unreffed with g_object_unref(). The returned list should be freed with g_list_free(), after its elements have been unreffed with g_object_unref(). - a #GList of connected #GDrive objects. @@ -85491,8 +81613,7 @@ its elements have been unreffed with g_object_unref(). Finds a #GMount object by its UUID (see g_mount_get_uuid()) - - + a #GMount or %NULL if no such mount is available. Free the returned object with g_object_unref(). @@ -85513,7 +81634,6 @@ its elements have been unreffed with g_object_unref(). The returned list should be freed with g_list_free(), after its elements have been unreffed with g_object_unref(). - a #GList of #GMount objects. @@ -85529,8 +81649,7 @@ its elements have been unreffed with g_object_unref(). Finds a #GVolume object by its UUID (see g_volume_get_uuid()) - - + a #GVolume or %NULL if no such volume is available. Free the returned object with g_object_unref(). @@ -85551,7 +81670,6 @@ its elements have been unreffed with g_object_unref(). The returned list should be freed with g_list_free(), after its elements have been unreffed with g_object_unref(). - a #GList of #GVolume objects. @@ -85720,13 +81838,11 @@ GIO was used to unmount. - - @@ -85742,7 +81858,6 @@ GIO was used to unmount. - @@ -85758,7 +81873,6 @@ GIO was used to unmount. - @@ -85774,7 +81888,6 @@ GIO was used to unmount. - @@ -85790,7 +81903,6 @@ GIO was used to unmount. - @@ -85806,7 +81918,6 @@ GIO was used to unmount. - @@ -85822,7 +81933,6 @@ GIO was used to unmount. - @@ -85838,7 +81948,6 @@ GIO was used to unmount. - @@ -85854,7 +81963,6 @@ GIO was used to unmount. - @@ -85870,7 +81978,6 @@ GIO was used to unmount. - @@ -85886,7 +81993,6 @@ GIO was used to unmount. - @@ -85894,7 +82000,6 @@ GIO was used to unmount. - a #GList of connected #GDrive objects. @@ -85911,7 +82016,6 @@ GIO was used to unmount. - a #GList of #GVolume objects. @@ -85928,7 +82032,6 @@ GIO was used to unmount. - a #GList of #GMount objects. @@ -85945,8 +82048,7 @@ GIO was used to unmount. - - + a #GVolume or %NULL if no such volume is available. Free the returned object with g_object_unref(). @@ -85965,8 +82067,7 @@ GIO was used to unmount. - - + a #GMount or %NULL if no such mount is available. Free the returned object with g_object_unref(). @@ -85985,7 +82086,6 @@ GIO was used to unmount. - @@ -86001,7 +82101,6 @@ GIO was used to unmount. - @@ -86017,7 +82116,6 @@ GIO was used to unmount. - @@ -86033,7 +82131,6 @@ GIO was used to unmount. - @@ -86041,7 +82138,6 @@ GIO was used to unmount. - @@ -86049,7 +82145,6 @@ GIO was used to unmount. - @@ -86057,7 +82152,6 @@ GIO was used to unmount. - @@ -86065,7 +82159,6 @@ GIO was used to unmount. - @@ -86073,7 +82166,6 @@ GIO was used to unmount. - @@ -86081,42 +82173,36 @@ GIO was used to unmount. - - - - - - @@ -86124,11 +82210,9 @@ GIO was used to unmount. Zlib decompression - Creates a new #GZlibCompressor. - a new #GZlibCompressor @@ -86146,8 +82230,7 @@ GIO was used to unmount. Returns the #GZlibCompressor:file-info property. - - + a #GFileInfo, or %NULL @@ -86167,7 +82250,6 @@ the GZIP header of the compressed data. Note: it is an error to call this function while a compression is in progress; it may only be called immediately after creation of @compressor, or after resetting it with g_converter_reset(). - @@ -86196,7 +82278,6 @@ and modification time from the file info to the GZIP header. - @@ -86216,11 +82297,9 @@ and #GZlibCompressor. Zlib decompression - Creates a new #GZlibDecompressor. - a new #GZlibDecompressor @@ -86238,8 +82317,7 @@ of compressed data processed by @compressor, or %NULL if @decompressor's #GZlibDecompressor:format property is not %G_ZLIB_COMPRESSOR_FORMAT_GZIP, or the header data was not fully processed yet, or it not present in the data stream at all. - - + a #GFileInfo, or %NULL @@ -86262,7 +82340,6 @@ fully processed, is not present at all, or the compressor's - @@ -86275,7 +82352,6 @@ plus '-' and '.'. The empty string is not a valid action name. It is an error to call this function with a non-utf8 @action_name. @action_name must not be %NULL. - %TRUE if @action_name is valid @@ -86312,7 +82388,6 @@ two sets of parens, for example: "app.action((1,2,3))". A string target can be specified this way as well: "app.action('target')". For strings, this third format must be used if * target value is empty or contains characters other than alphanumerics, '-' and '.'. - %TRUE if successful, else %FALSE with @error set @@ -86343,7 +82418,6 @@ and @target_value by that function. See that function for the types of strings that will be printed by this function. - a detailed format string @@ -86367,7 +82441,6 @@ Note that for @commandline, the quoting rules of the Exec key of the are applied. For example, if the @commandline contains percent-encoded URIs, the percent-character must be doubled in order to prevent it from being swallowed by Exec key unquoting. See the specification for exact quoting rules. - new #GAppInfo for given command. @@ -86396,7 +82469,6 @@ For desktop files, this includes applications that have of `OnlyShowIn` or `NotShowIn`. See g_app_info_should_show(). The returned list does not include applications which have the `Hidden` key set. - a newly allocated #GList of references to #GAppInfos. @@ -86409,7 +82481,6 @@ the `Hidden` key set. including the recommended and fallback #GAppInfos. See g_app_info_get_recommended_for_type() and g_app_info_get_fallback_for_type(). - #GList of #GAppInfos for given @content_type or %NULL on error. @@ -86426,7 +82497,6 @@ g_app_info_get_fallback_for_type(). Gets the default #GAppInfo for a given content type. - #GAppInfo for given @content_type or %NULL on error. @@ -86449,7 +82519,6 @@ g_app_info_get_fallback_for_type(). the given URI scheme. A URI scheme is the initial part of the URI, up to but not including the ':', e.g. "http", "ftp" or "sip". - #GAppInfo for given @uri_scheme or %NULL on error. @@ -86466,7 +82535,6 @@ of the URI, up to but not including the ':', e.g. "http", Gets a list of fallback #GAppInfos for a given content type, i.e. those applications which claim to support the given content type by MIME type subclassing and not directly. - #GList of #GAppInfos for given @content_type or %NULL on error. @@ -86488,7 +82556,6 @@ and not by MIME type subclassing. Note that the first application of the list is the last used one, i.e. the last one for which g_app_info_set_as_last_used_for_type() has been called. - #GList of #GAppInfos for given @content_type or %NULL on error. @@ -86512,7 +82579,6 @@ required. The D-Bus–activated applications don't have to be started if your application terminates too soon after this function. To prevent this, use g_app_info_launch_default_for_uri_async() instead. - %TRUE on success, %FALSE on error. @@ -86539,7 +82605,6 @@ dialog to the user. This is also useful if you want to be sure that the D-Bus–activated applications are really started before termination and if you are interested in receiving error information from their activation. - @@ -86568,7 +82633,6 @@ in receiving error information from their activation. Finishes an asynchronous launch-default-for-uri operation. - %TRUE if the launch was successful, %FALSE if @error is set @@ -86586,7 +82650,6 @@ g_app_info_set_as_default_for_type(), g_app_info_set_as_default_for_extension(), g_app_info_add_supports_type() or g_app_info_remove_supports_type(). - @@ -86606,7 +82669,6 @@ then call g_async_initable_new_finish() to get the new object and check for any errors. Use g_object_new_with_properties() and g_async_initable_init_async() instead. See #GParameter for more information. - @@ -86650,7 +82712,6 @@ then call g_bus_get_finish() to get the result of the operation. This is an asynchronous failable function. See g_bus_get_sync() for the synchronous version. - @@ -86684,7 +82745,6 @@ g_dbus_connection_new_for_address(). Note that the returned #GDBusConnection object will (usually) have the #GDBusConnection:exit-on-close property set to %TRUE. - a #GDBusConnection or %NULL if @error is set. Free with g_object_unref(). @@ -86715,7 +82775,6 @@ g_dbus_connection_new_for_address(). Note that the returned #GDBusConnection object will (usually) have the #GDBusConnection:exit-on-close property set to %TRUE. - a #GDBusConnection or %NULL if @error is set. Free with g_object_unref(). @@ -86782,7 +82841,6 @@ This behavior makes it very simple to write applications that wants to [own names][gdbus-owning-names] and export objects. Simply register objects to be exported in @bus_acquired_handler and unregister the objects (if any) in @name_lost_handler. - an identifier (never 0) that can be used with g_bus_unown_name() to stop owning the name. @@ -86826,7 +82884,6 @@ unregister the objects (if any) in @name_lost_handler. Like g_bus_own_name() but takes a #GDBusConnection instead of a #GBusType. - an identifier (never 0) that can be used with g_bus_unown_name() to stop owning the name @@ -86866,7 +82923,6 @@ unregister the objects (if any) in @name_lost_handler. Version of g_bus_own_name_on_connection() using closures instead of callbacks for easier binding in other languages. - an identifier (never 0) that can be used with g_bus_unown_name() to stop owning the name. @@ -86900,7 +82956,6 @@ callbacks for easier binding in other languages. Version of g_bus_own_name() using closures instead of callbacks for easier binding in other languages. - an identifier (never 0) that can be used with g_bus_unown_name() to stop owning the name. @@ -86945,7 +83000,6 @@ this function has returned. You should continue to iterate the #GMainContext until the #GDestroyNotify function passed to g_bus_own_name() is called, in order to avoid memory leaks through callbacks queued on the #GMainContext after it’s stopped being iterated. - @@ -86965,7 +83019,6 @@ this function has returned. You should continue to iterate the #GMainContext until the #GDestroyNotify function passed to g_bus_watch_name() is called, in order to avoid memory leaks through callbacks queued on the #GMainContext after it’s stopped being iterated. - @@ -87006,7 +83059,6 @@ to take action when a certain [name exists][gdbus-watching-names]. Basically, the application should create object proxies in @name_appeared_handler and destroy them again (if any) in @name_vanished_handler. - An identifier (never 0) that can be used with g_bus_unwatch_name() to stop watching the name. @@ -87046,7 +83098,6 @@ g_bus_unwatch_name() to stop watching the name. Like g_bus_watch_name() but takes a #GDBusConnection instead of a #GBusType. - An identifier (never 0) that can be used with g_bus_unwatch_name() to stop watching the name. @@ -87086,7 +83137,6 @@ g_bus_unwatch_name() to stop watching the name. Version of g_bus_watch_name_on_connection() using closures instead of callbacks for easier binding in other languages. - An identifier (never 0) that can be used with g_bus_unwatch_name() to stop watching the name. @@ -87120,7 +83170,6 @@ to not exist or %NULL. Version of g_bus_watch_name() using closures instead of callbacks for easier binding in other languages. - An identifier (never 0) that can be used with g_bus_unwatch_name() to stop watching the name. @@ -87154,7 +83203,6 @@ to not exist or %NULL. Checks if a content type can be executable. Note that for instance things like text files can be executables (i.e. scripts and batch files). - %TRUE if the file type corresponds to a type that can be executable, %FALSE otherwise. @@ -87169,7 +83217,6 @@ things like text files can be executables (i.e. scripts and batch files). Compares two content types for equality. - %TRUE if the two strings are identical or equivalent, %FALSE otherwise. @@ -87188,7 +83235,6 @@ things like text files can be executables (i.e. scripts and batch files). Tries to find a content type based on the mime type name. - Newly allocated string with content type or %NULL. Free with g_free() @@ -87203,7 +83249,6 @@ things like text files can be executables (i.e. scripts and batch files). Gets the human readable description of the content type. - a short description of the content type @type. Free the returned string with g_free() @@ -87222,7 +83267,6 @@ things like text files can be executables (i.e. scripts and batch files). See the [shared-mime-info](http://www.freedesktop.org/wiki/Specifications/shared-mime-info-spec) specification for more on the generic icon name. - the registered generic icon name for the given @type, or %NULL if unknown. Free with g_free() @@ -87237,7 +83281,6 @@ specification for more on the generic icon name. Gets the icon for a content type. - #GIcon corresponding to the content type. Free the returned object with g_object_unref() @@ -87253,7 +83296,6 @@ specification for more on the generic icon name. Get the list of directories which MIME data is loaded from. See g_content_type_set_mime_dirs() for details. - %NULL-terminated list of directories to load MIME data from, including any `mime/` subdirectory, @@ -87265,7 +83307,6 @@ g_content_type_set_mime_dirs() for details. Gets the mime type for the content type, if one is registered. - the registered mime type for the given @type, or %NULL if unknown; free with g_free(). @@ -87280,7 +83321,6 @@ g_content_type_set_mime_dirs() for details. Gets the symbolic icon for a content type. - symbolic #GIcon corresponding to the content type. Free the returned object with g_object_unref() @@ -87298,7 +83338,6 @@ g_content_type_set_mime_dirs() for details. uncertain, @result_uncertain will be set to %TRUE. Either @filename or @data may be %NULL, in which case the guess will be based solely on the other argument. - a string indicating a guessed content type for the given data. Free with g_free() @@ -87339,7 +83378,6 @@ specification for more on x-content types. This function is useful in the implementation of g_mount_guess_content_type(). - an %NULL-terminated array of zero or more content types. Free with g_strfreev() @@ -87356,7 +83394,6 @@ g_mount_guess_content_type(). Determines if @type is a subset of @supertype. - %TRUE if @type is a kind of @supertype, %FALSE otherwise. @@ -87376,7 +83413,6 @@ g_mount_guess_content_type(). Determines if @type is a subset of @mime_type. Convenience wrapper around g_content_type_is_a(). - %TRUE if @type is a kind of @mime_type, %FALSE otherwise. @@ -87398,7 +83434,6 @@ Convenience wrapper around g_content_type_is_a(). On UNIX this is the "application/octet-stream" mimetype, while on win32 it is "*" and on OSX it is a dynamic type or octet-stream. - %TRUE if the type is the unknown type. @@ -87434,7 +83469,6 @@ with @dirs set to %NULL before calling g_test_init(), for instance: return g_test_run (); ]| - @@ -87453,7 +83487,6 @@ with @dirs set to %NULL before calling g_test_init(), for instance: Gets a list of strings containing all the registered content types known to the system. The list and its data should be freed using `g_list_free_full (list, g_free)`. - list of the registered content types @@ -87470,7 +83503,6 @@ For instance, if @string is `/run/bus-for-:0`, this function would return `/run/bus-for-%3A0`, which could be used in a D-Bus address like `unix:nonce-tcp:host=127.0.0.1,port=42,noncefile=/run/bus-for-%3A0`. - a copy of @string with all non-optionally-escaped bytes escaped @@ -87491,7 +83523,6 @@ platform specific mechanisms. The returned address will be in the [D-Bus address format](https://dbus.freedesktop.org/doc/dbus-specification.html#addresses). - a valid D-Bus address string for @bus_type or %NULL if @error is set @@ -87520,7 +83551,6 @@ the operation. This is an asynchronous failable function. See g_dbus_address_get_stream_sync() for the synchronous version. - @@ -87544,8 +83574,10 @@ g_dbus_address_get_stream_sync() for the synchronous version. - Finishes an operation started with g_dbus_address_get_stream(). - + Finishes an operation started with g_dbus_address_get_stream(). + +A server is not required to set a GUID, so @out_guid may be set to %NULL +even on success. A #GIOStream or %NULL if @error is set. @@ -87555,7 +83587,7 @@ g_dbus_address_get_stream_sync() for the synchronous version. A #GAsyncResult obtained from the GAsyncReadyCallback passed to g_dbus_address_get_stream(). - + %NULL or return location to store the GUID extracted from @address, if any. @@ -87567,9 +83599,11 @@ sets up the connection so it is in a state to run the client-side of the D-Bus authentication conversation. @address must be in the [D-Bus address format](https://dbus.freedesktop.org/doc/dbus-specification.html#addresses). +A server is not required to set a GUID, so @out_guid may be set to %NULL +even on success. + This is a synchronous failable function. See g_dbus_address_get_stream() for the asynchronous version. - A #GIOStream or %NULL if @error is set. @@ -87579,7 +83613,7 @@ g_dbus_address_get_stream() for the asynchronous version. A valid D-Bus address. - + %NULL or return location to store the GUID extracted from @address, if any. @@ -87593,8 +83627,7 @@ g_dbus_address_get_stream() for the asynchronous version. Looks up the value of an annotation. The cost of this function is O(n) in number of annotations. - - + The value or %NULL if not found. Do not free, it is owned by @annotations. @@ -87623,9 +83656,9 @@ on the wire back to a #GError using g_dbus_error_new_for_dbus_error(). This function is typically only used in object mappings to put a #GError on the wire. Regular applications should not use it. - - A D-Bus error name (never %NULL). Free with g_free(). + A D-Bus error name (never %NULL). + Free with g_free(). @@ -87642,10 +83675,9 @@ This function is guaranteed to return a D-Bus error name for all #GErrors returned from functions handling remote method calls (e.g. g_dbus_connection_call_finish()) unless g_dbus_error_strip_remote_error() has been used on @error. - - - an allocated string or %NULL if the D-Bus error name - could not be found. Free with g_free(). + + an allocated string or %NULL if the + D-Bus error name could not be found. Free with g_free(). @@ -87658,7 +83690,6 @@ g_dbus_error_strip_remote_error() has been used on @error. Checks if @error represents an error received via D-Bus from a remote peer. If so, use g_dbus_error_get_remote_error() to get the name of the error. - %TRUE if @error represents an error from a remote peer, %FALSE otherwise. @@ -87698,7 +83729,6 @@ returned #GError using the g_dbus_error_get_remote_error() function This function is typically only used in object mappings to prepare #GError instances for applications. Regular applications should not use it. - An allocated #GError. Free with g_error_free(). @@ -87725,7 +83755,6 @@ it. This is typically done in the routine that returns the #GQuark for an error domain. - %TRUE if the association was created, %FALSE if it already exists. @@ -87747,8 +83776,10 @@ exists. - Helper function for associating a #GError error domain with D-Bus error names. - + Helper function for associating a #GError error domain with D-Bus error names. + +While @quark_volatile has a `volatile` qualifier, this is a historical +artifact and the argument passed to it should not be `volatile`. @@ -87780,7 +83811,6 @@ message field in @error will correspond exactly to what was received on the wire. This is typically used when presenting errors to the end user. - %TRUE if information was stripped, %FALSE otherwise. @@ -87794,7 +83824,6 @@ This is typically used when presenting errors to the end user. Destroys an association previously set up with g_dbus_error_register_error(). - %TRUE if the association was destroyed, %FALSE if it wasn't found. @@ -87820,7 +83849,6 @@ e.g. g_dbus_connection_new(). See the D-Bus specification regarding what strings are valid D-Bus GUID (for example, D-Bus GUIDs are not RFC-4122 compliant). - A valid D-Bus GUID. Free with g_free(). @@ -87855,11 +83883,10 @@ returned (e.g. 0 for scalar types, the empty string for string types, See the g_dbus_gvariant_to_gvalue() function for how to convert a #GVariant to a #GValue. - - A #GVariant (never floating) of #GVariantType @type holding - the data from @gvalue or %NULL in case of failure. Free with - g_variant_unref(). + A #GVariant (never floating) of + #GVariantType @type holding the data from @gvalue or an empty #GVariant + in case of failure. Free with g_variant_unref(). @@ -87885,7 +83912,6 @@ variant, tuple, dict entry) will be converted to a #GValue containing that The conversion never fails - a valid #GValue is always returned in @out_gvalue. - @@ -87907,7 +83933,6 @@ The conversion never fails - a valid #GValue is always returned in This doesn't check if @string is actually supported by #GDBusServer or #GDBusConnection - use g_dbus_is_supported_address() to do more checks. - %TRUE if @string is a valid D-Bus address, %FALSE otherwise. @@ -87924,7 +83949,6 @@ checks. See the D-Bus specification regarding what strings are valid D-Bus GUID (for example, D-Bus GUIDs are not RFC-4122 compliant). - %TRUE if @string is a guid, %FALSE otherwise. @@ -87938,7 +83962,6 @@ GUID (for example, D-Bus GUIDs are not RFC-4122 compliant). Checks if @string is a valid D-Bus interface name. - %TRUE if valid, %FALSE otherwise. @@ -87952,7 +83975,6 @@ GUID (for example, D-Bus GUIDs are not RFC-4122 compliant). Checks if @string is a valid D-Bus member (e.g. signal or method) name. - %TRUE if valid, %FALSE otherwise. @@ -87966,7 +83988,6 @@ GUID (for example, D-Bus GUIDs are not RFC-4122 compliant). Checks if @string is a valid D-Bus bus name (either unique or well-known). - %TRUE if valid, %FALSE otherwise. @@ -87983,7 +84004,6 @@ GUID (for example, D-Bus GUIDs are not RFC-4122 compliant). transports in @string and that key/value pairs for each transport are valid. See the specification of the [D-Bus address format](https://dbus.freedesktop.org/doc/dbus-specification.html#addresses). - %TRUE if @string is a valid D-Bus address that is supported by this library, %FALSE if @error is set. @@ -87998,7 +84018,6 @@ supported by this library, %FALSE if @error is set. Checks if @string is a valid D-Bus unique bus name. - %TRUE if valid, %FALSE otherwise. @@ -88013,7 +84032,6 @@ supported by this library, %FALSE if @error is set. Creates a new #GDtlsClientConnection wrapping @base_socket which is assumed to communicate with the server identified by @server_identity. - the new #GDtlsClientConnection, or %NULL on error @@ -88032,7 +84050,6 @@ assumed to communicate with the server identified by @server_identity. Creates a new #GDtlsServerConnection wrapping @base_socket. - the new #GDtlsServerConnection, or %NULL on error @@ -88117,7 +84134,6 @@ the commandline. #GApplication also uses UTF-8 but g_application_command_line_create_file_for_arg() may be more useful for you there. It is also always possible to use this function with #GOptionContext arguments of type %G_OPTION_ARG_FILENAME. - a new #GFile. Free the returned object with g_object_unref(). @@ -88142,7 +84158,6 @@ This is useful if the commandline argument was given in a context other than the invocation of the current process. See also g_application_command_line_create_file_for_arg(). - a new #GFile @@ -88162,7 +84177,6 @@ See also g_application_command_line_create_file_for_arg(). Constructs a #GFile for a given path. This operation never fails, but the returned object might not support any I/O operation if @path is malformed. - a new #GFile for the given @path. Free the returned object with g_object_unref(). @@ -88181,7 +84195,6 @@ operation if @path is malformed. fails, but the returned object might not support any I/O operation if @uri is malformed or if the uri type is not supported. - a new #GFile for the given @uri. Free the returned object with g_object_unref(). @@ -88205,7 +84218,6 @@ directory components. If it is %NULL, a default template is used. Unlike the other #GFile constructors, this will return %NULL if a temporary file could not be created. - a new #GFile. Free the returned object with g_object_unref(). @@ -88228,7 +84240,6 @@ a temporary file could not be created. given by g_file_get_parse_name()). This operation never fails, but the returned object might not support any I/O operation if the @parse_name cannot be parsed. - a new #GFile. @@ -88316,12 +84327,12 @@ G_STATIC_ASSERT (G_N_ELEMENTS (foo_bar_error_entries) == FOO_BAR_N_ERRORS); GQuark foo_bar_error_quark (void) { - static volatile gsize quark_volatile = 0; + static gsize quark = 0; g_dbus_error_register_error_domain ("foo-bar-error-quark", - &quark_volatile, + &quark, foo_bar_error_entries, G_N_ELEMENTS (foo_bar_error_entries)); - return (GQuark) quark_volatile; + return (GQuark) quark; } ]| With this setup, a D-Bus peer can transparently pass e.g. %FOO_BAR_ERROR_ANOTHER_ERROR and @@ -88600,8 +84611,7 @@ decompresses data compressed with zlib. Deserializes a #GIcon previously serialized using g_icon_serialize(). - - + a #GIcon, or %NULL when deserialization fails. @@ -88614,7 +84624,6 @@ decompresses data compressed with zlib. Gets a hash for an icon. - a #guint containing a hash for the @icon, suitable for use in a #GHashTable or similar data structure. @@ -88634,7 +84643,6 @@ use in a #GHashTable or similar data structure. If your application or library provides one or more #GIcon implementations you need to ensure that each #GType is registered with the type system prior to calling g_icon_new_for_string(). - An object implementing the #GIcon interface or %NULL if @error is set. @@ -88653,7 +84661,6 @@ similar to g_object_newv() but also initializes the object and returns %NULL, setting an error on failure. Use g_object_new_with_properties() and g_initable_init() instead. See #GParameter for more information. - a newly allocated #GObject, or %NULL on error @@ -88688,7 +84695,6 @@ specific value instead). As %errno is global and may be modified by intermediate function calls, you should save its value as soon as the call which sets it - #GIOErrorEnum value for the given errno.h error number. @@ -88713,7 +84719,6 @@ calls, you should save its value as soon as the call which sets it If @type has already been registered as an extension for this extension point, the existing #GIOExtension object is returned. - a #GIOExtension object for #GType @@ -88739,7 +84744,6 @@ extension point, the existing #GIOExtension object is returned. Looks up an existing extension point. - the #GIOExtensionPoint, or %NULL if there is no registered extension point with the given name. @@ -88754,7 +84758,6 @@ extension point, the existing #GIOExtension object is returned. Registers an extension point. - the new #GIOExtensionPoint. This object is owned by GIO and should not be freed. @@ -88773,7 +84776,6 @@ extension point, the existing #GIOExtension object is returned. If don't require all modules to be initialized (and thus registering all gtypes) then you can use g_io_modules_scan_all_in_directory() which allows delayed/lazy loading of modules. - a list of #GIOModules loaded from the directory, @@ -88799,7 +84801,6 @@ which allows delayed/lazy loading of modules. If don't require all modules to be initialized (and thus registering all gtypes) then you can use g_io_modules_scan_all_in_directory() which allows delayed/lazy loading of modules. - a list of #GIOModules loaded from the directory, @@ -88835,7 +84836,6 @@ g_io_extension_point_get_extension_by_name(). If you need to guarantee that all types are loaded in all the modules, use g_io_modules_load_all_in_directory(). - @@ -88859,7 +84859,6 @@ g_io_extension_point_get_extension_by_name(). If you need to guarantee that all types are loaded in all the modules, use g_io_modules_load_all_in_directory(). - @@ -88883,7 +84882,6 @@ g_io_scheduler_push_job(). You should never call this function, since you don't know how other libraries in your program might be making use of gioscheduler. - @@ -88898,7 +84896,6 @@ If @cancellable is not %NULL, it can be used to cancel the I/O job by calling g_cancellable_cancel() or by calling g_io_scheduler_cancel_all_jobs(). use #GThreadPool or g_task_run_in_thread() - @@ -88976,7 +84973,6 @@ The backend reads default values from a keyfile called `defaults` in the directory specified by the #GKeyfileSettingsBackend:defaults-dir property, and a list of locked keys from a text file with the name `locks` in the same location. - a keyfile-backed #GSettingsBackend @@ -88999,7 +84995,6 @@ the same location. Gets a reference to the default #GMemoryMonitor for the system. - a new reference to the default #GMemoryMonitor @@ -89011,7 +85006,6 @@ the same location. This backend allows changes to settings, but does not write them to any backing storage, so the next time you run your application, the memory backend will start out with the default values again. - a newly created #GSettingsBackend @@ -89019,9 +85013,9 @@ the memory backend will start out with the default values again. Gets the default #GNetworkMonitor for the system. - - a #GNetworkMonitor + a #GNetworkMonitor, which will be + a dummy object if no network monitor is available @@ -89030,7 +85024,6 @@ the memory backend will start out with the default values again. calls WSAStartup()). GLib will call this itself if it is needed, so you only need to call it if you directly call system networking functions (without calling any GLib networking functions first). - @@ -89040,7 +85033,6 @@ functions (without calling any GLib networking functions first). This backend does not allow changes to settings, so all settings will always have their default values. - a newly created #GSettingsBackend @@ -89052,7 +85044,6 @@ implementations. Creates a new #GSource that expects a callback of type #GPollableSourceFunc. The new source does not actually do anything on its own; use g_source_add_child_source() to add other sources to it to cause it to trigger. - the new #GSource. @@ -89069,7 +85060,6 @@ sources to it to cause it to trigger. implementations. Creates a new #GSource, as with g_pollable_source_new(), but also attaching @child_source (with a dummy callback), and @cancellable, if they are non-%NULL. - the new #GSource. @@ -89100,7 +85090,6 @@ If @blocking is %FALSE, then @stream must be a #GPollableInputStream for which g_pollable_input_stream_can_poll() returns %TRUE, or else the behavior is undefined. If @blocking is %TRUE, then @stream does not need to be a #GPollableInputStream. - the number of bytes read, or -1 on error. @@ -89142,7 +85131,6 @@ If @blocking is %FALSE, then @stream must be a g_pollable_output_stream_can_poll() returns %TRUE or else the behavior is undefined. If @blocking is %TRUE, then @stream does not need to be a #GPollableOutputStream. - the number of bytes written, or -1 on error. @@ -89192,7 +85180,6 @@ As with g_pollable_stream_write(), if @blocking is %FALSE, then g_pollable_output_stream_can_poll() returns %TRUE or else the behavior is undefined. If @blocking is %TRUE, then @stream does not need to be a #GPollableOutputStream. - %TRUE on success, %FALSE if there was an error @@ -89231,8 +85218,7 @@ need to be a #GPollableOutputStream. Find the `gio-proxy` extension point for a proxy implementation that supports the specified protocol. - - + return a #GProxy or NULL if protocol is not supported. @@ -89246,9 +85232,9 @@ the specified protocol. Gets the default #GProxyResolver for the system. - - the default #GProxyResolver. + the default #GProxyResolver, which + will be a dummy object if no proxy resolver is available @@ -89277,7 +85263,6 @@ If @filename is empty or the data in it is corrupt, %G_RESOURCE_ERROR_INTERNAL will be returned. If @filename doesn’t exist, or there is an error in reading it, an error from g_mapped_file_new() will be returned. - a new #GResource, or %NULL on error @@ -89296,7 +85281,6 @@ The return result is a %NULL terminated list of strings which should be released with g_strfreev(). @lookup_flags controls the behaviour of the lookup. - an array of constant strings @@ -89319,7 +85303,6 @@ be released with g_strfreev(). globally registered resources and if found returns information about it. @lookup_flags controls the behaviour of the lookup. - %TRUE if the file was found. %FALSE if there were errors @@ -89360,7 +85343,6 @@ in the program binary. For compressed files we allocate memory on the heap and automatically uncompress the data. @lookup_flags controls the behaviour of the lookup. - #GBytes or %NULL on error. Free the returned object with g_bytes_unref() @@ -89383,7 +85365,6 @@ globally registered resources and returns a #GInputStream that lets you read the data. @lookup_flags controls the behaviour of the lookup. - #GInputStream or %NULL on error. Free the returned object with g_object_unref() @@ -89404,7 +85385,6 @@ that lets you read the data. Registers the resource with the process-global set of resources. Once a resource is registered the files in it can be accessed with the global resource lookup functions like g_resources_lookup_data(). - @@ -89417,7 +85397,6 @@ with the global resource lookup functions like g_resources_lookup_data(). Unregisters the resource from the process-global set of resources. - @@ -89442,7 +85421,6 @@ from different directories, depending on which directories were given in `XDG_DATA_DIRS` and `GSETTINGS_SCHEMA_DIR`. For this reason, all lookups performed against the default source should probably be done recursively. - the default schema source @@ -89453,7 +85431,6 @@ recursively. directly setting the contents of the #GAsyncResult with the given error information. Use g_task_report_error(). - @@ -89493,7 +85470,6 @@ information. g_simple_async_report_error_in_idle(), but takes a #GError rather than building a new one. Use g_task_report_error(). - @@ -89521,7 +85497,6 @@ than building a new one. g_simple_async_report_gerror_in_idle(), but takes over the caller's ownership of @error, so the caller does not have to free it any more. Use g_task_report_error(). - @@ -89546,7 +85521,6 @@ ownership of @error, so the caller does not have to free it any more. Sorts @targets in place according to the algorithm in RFC 2782. - the head of the sorted list. @@ -89564,9 +85538,9 @@ ownership of @error, so the caller does not have to free it any more. Gets the default #GTlsBackend for the system. - - a #GTlsBackend + a #GTlsBackend, which will be a + dummy object if no TLS backend is available @@ -89585,7 +85559,6 @@ communicate with the server identified by @server_identity. See the documentation for #GTlsConnection:base-io-stream for restrictions on when application code can run operations on the @base_io_stream after this function has returned. - the new #GTlsClientConnection, or %NULL on error @@ -89614,7 +85587,6 @@ this function has returned. in @anchors to verify certificate chains. The certificates in @anchors must be PEM encoded. - the new #GTlsFileDatabase, or %NULL on error @@ -89634,7 +85606,6 @@ must have pollable input and output streams). See the documentation for #GTlsConnection:base-io-stream for restrictions on when application code can run operations on the @base_io_stream after this function has returned. - the new #GTlsServerConnection, or %NULL on error @@ -89656,7 +85627,6 @@ this function has returned. OS. This is primarily used for hiding mountable and mounted volumes that only are used in the OS and has little to no relevance to the casual user. - %TRUE if @mount_path is considered an implementation detail of the OS. @@ -89677,7 +85647,6 @@ administrators at a shell; rather than something that should, for example, appear in a GUI. For example, the Linux `/proc` filesystem. The list of device paths considered ‘system’ ones may change over time. - %TRUE if @device_path is considered an implementation detail of the OS. @@ -89698,7 +85667,6 @@ administrators at a shell; rather than something that should, for example, appear in a GUI. For example, the Linux `/proc` filesystem. The list of file system types considered ‘system’ ones may change over time. - %TRUE if @fs_type is considered an implementation detail of the OS. @@ -89717,7 +85685,6 @@ if the mounts have changed since with g_unix_mounts_changed_since(). If more mounts have the same mount path, the last matching mount is returned. - a #GUnixMountEntry. @@ -89735,7 +85702,6 @@ is returned. Compares two unix mounts. - 1, 0 or -1 if @mount1 is greater than, equal to, or less than @mount2, respectively. @@ -89754,7 +85720,6 @@ or less than @mount2, respectively. Makes a copy of @mount_entry. - a new #GUnixMountEntry @@ -89773,7 +85738,6 @@ if the mounts have changed since with g_unix_mounts_changed_since(). If more mounts have the same mount path, the last matching mount is returned. - a #GUnixMountEntry. @@ -89791,7 +85755,6 @@ is returned. Frees a unix mount. - @@ -89804,7 +85767,6 @@ is returned. Gets the device path for a unix mount. - a string containing the device path. @@ -89818,7 +85780,6 @@ is returned. Gets the filesystem type for the unix mount. - a string containing the file system type. @@ -89832,7 +85793,6 @@ is returned. Gets the mount path for a unix mount. - the mount path for @mount_entry. @@ -89850,7 +85810,6 @@ is returned. This is similar to g_unix_mount_point_get_options(), but it takes a #GUnixMountEntry as an argument. - a string containing the options, or %NULL if not available. @@ -89870,7 +85829,6 @@ mounts created by bind operation, or btrfs subvolumes. For example, the root path is equal to "/" for mount created by "mount /dev/sda1 /mnt/foo" and "/bar" for "mount --bind /mnt/foo/bar /mnt/bar". - a string containing the root, or %NULL if not supported. @@ -89884,7 +85842,6 @@ For example, the root path is equal to "/" for mount created by Guesses whether a Unix mount can be ejected. - %TRUE if @mount_entry is deemed to be ejectable. @@ -89898,7 +85855,6 @@ For example, the root path is equal to "/" for mount created by Guesses the icon of a Unix mount. - a #GIcon @@ -89913,7 +85869,6 @@ For example, the root path is equal to "/" for mount created by Guesses the name of a Unix mount. The result is a translated string. - A newly allocated string that must be freed with g_free() @@ -89928,7 +85883,6 @@ The result is a translated string. Guesses whether a Unix mount should be displayed in the UI. - %TRUE if @mount_entry is deemed to be displayable. @@ -89942,7 +85896,6 @@ The result is a translated string. Guesses the symbolic icon of a Unix mount. - a #GIcon @@ -89956,7 +85909,6 @@ The result is a translated string. Checks if a unix mount is mounted read only. - %TRUE if @mount_entry is read only. @@ -89975,7 +85927,6 @@ g_unix_is_mount_path_system_internal() on @mount_entry’s properties. The definition of what a ‘system’ mount entry is may change over time as new file system types and device paths are ignored. - %TRUE if the unix mount is for a system path. @@ -89994,7 +85945,6 @@ changed since with g_unix_mount_points_changed_since(). If more mount points have the same mount path, the last matching mount point is returned. - a #GUnixMountPoint, or %NULL if no match is found. @@ -90013,7 +85963,6 @@ is found. Checks if the unix mount points have changed since a given unix time. - %TRUE if the mount points have changed since @time. @@ -90030,7 +85979,6 @@ is found. If @time_read is set, it will be filled with the mount timestamp, allowing for checking if the mounts have changed with g_unix_mount_points_changed_since(). - a #GList of the UNIX mountpoints. @@ -90047,7 +85995,6 @@ g_unix_mount_points_changed_since(). Checks if the unix mounts have changed since a given unix time. - %TRUE if the mounts have changed since @time. @@ -90064,7 +86011,6 @@ g_unix_mount_points_changed_since(). If @time_read is set, it will be filled with the mount timestamp, allowing for checking if the mounts have changed with g_unix_mounts_changed_since(). - a #GList of the UNIX mounts.