From 3204009d9879f516fa3b053e924ea3b54ced8e1c Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Sebastian=20Dr=C3=B6ge?= Date: Fri, 2 Mar 2018 21:58:19 +0200 Subject: [PATCH] Update GLib gir files from Debian/unstable --- gir-files/GLib-2.0.gir | 953 ++++++++++++++++++++++++------- gir-files/GObject-2.0.gir | 1117 ++++++++++++++++++++++++------------- 2 files changed, 1488 insertions(+), 582 deletions(-) diff --git a/gir-files/GLib-2.0.gir b/gir-files/GLib-2.0.gir index 2282f57b7..a540e0e72 100644 --- a/gir-files/GLib-2.0.gir +++ b/gir-files/GLib-2.0.gir @@ -26,7 +26,7 @@ allowed. The year is represented with four digits. Opaque type. See g_mutex_locker_new() for details. - + A type which is used to hold a process identification. @@ -46,7 +46,7 @@ particular string. A GQuark value of zero is associated to %NULL. A typedef alias for gchar**. This is mostly useful when used together with g_auto(). - + Simply a replacement for time_t. It has been deprecated @@ -149,7 +149,11 @@ is greater than one, the #GArray wrapper is preserved but the size of @array will be set to zero. If array elements contain dynamically-allocated memory, they should -be freed separately. +be freed separately. + +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(). @@ -278,7 +282,7 @@ the new elements. version="2.22" introspectable="0"> Atomically increments the reference count of @array by one. -This function is MT-safe and may be called from any thread. +This function is thread-safe and may be called from any thread. The passed in #GArray @@ -523,7 +527,7 @@ This did not actually work, so any such code should be removed. introspectable="0"> Atomically decrements the reference count of @array by one. If the reference count drops to 0, all memory allocated by the array is -released. This function is MT-safe and may be called from any +released. This function is thread-safe and may be called from any thread. @@ -3361,6 +3365,9 @@ date to include new hashing algorithm types. Use the SHA-512 hashing algorithm (Since: 2.36) + + Use the SHA-384 hashing algorithm (Since: 2.51) + Prototype of a #GChildWatchSource callback, called when a child @@ -7393,7 +7400,9 @@ The g_direct_equal(), g_int_equal(), g_int64_equal(), g_double_equal() and g_str_equal() functions are provided for the most common types of keys. If @key_equal_func is %NULL, keys are compared directly in a similar fashion to g_direct_equal(), but without the overhead of -a function call. +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 @@ -7424,7 +7433,7 @@ Since version 2.42 it is permissible for destroy notify functions to recursively remove further items from the hash table. This is only 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 +calling g_hash_table_remove_all() before releasing the last reference using g_hash_table_unref(). a new #GHashTable @@ -7987,7 +7996,8 @@ g_hmac_get_digest() have been called on a #GHmac, the HMAC will be closed and it won't be possible to call g_hmac_update() on it anymore. -Support for digests of type %G_CHECKSUM_SHA512 has been added in GLib 2.42. +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. @@ -8916,6 +8926,8 @@ The default encoding for #GIOChannel is UTF-8. If your application is reading output from a command using via pipe, you may need to set the encoding to the encoding of the current locale (see g_get_charset()) with the g_io_channel_set_encoding() function. +By default, the fd passed will not be closed when the final reference +to the #GIOChannel data structure is dropped. If you want to read raw binary data without interpretation, then call the g_io_channel_set_encoding() function with %NULL for the @@ -9021,8 +9033,7 @@ 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. - Whether the channel will be closed on the final unref of - the GIOChannel data structure. + %TRUE if the channel will be closed, %FALSE otherwise. @@ -9432,8 +9443,12 @@ The default state of the channel is buffered. - Setting this flag to %TRUE for a channel you have already closed -can cause problems. + Whether to close the channel on the final unref of the #GIOChannel +data structure. The default value of this is %TRUE for channels +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. @@ -9444,9 +9459,7 @@ can cause problems. Whether to close the channel on the final unref of - the GIOChannel data structure. The default value of - this is %TRUE for channels created by g_io_channel_new_file (), - and %FALSE for all other channels. + the GIOChannel data structure. @@ -10012,6 +10025,11 @@ in a generic way. Resource temporarily unavailable. + + + the value associated with the key as an integer, or @@ -10555,7 +10574,8 @@ integers. 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 integers then %NULL is returned +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. @@ -11015,9 +11035,13 @@ set to either a #GFileError or #GKeyFileError. throws="1"> This function looks for a key file named @file in the paths specified in @search_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. +returns the file's full path in @full_path. + +If the file could not be found in any of the @search_dirs, +%G_KEY_FILE_ERROR_NOT_FOUND is returned. If +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 @@ -11058,8 +11082,13 @@ be loaded then an %error is set to either a #GFileError or version="2.6" throws="1"> Loads a key file into an empty #GKeyFile structure. -If the file could not be loaded then @error is set to -either a #GFileError or #GKeyFileError. + +If 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. + +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 @@ -11782,8 +11811,7 @@ See #G_BYTE_ORDER. Defines the log domain. -For applications, this is typically left as the default %NULL -(or "") domain. Libraries should define this so that any messages +Libraries should define this so that any messages which they log can be differentiated from messages from other libraries and application code. But be careful not to define it in any public header files. @@ -11791,7 +11819,11 @@ it in any public header files. For example, GTK+ uses this in its Makefile.am: |[ 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. @@ -12816,7 +12848,14 @@ can write arbitrary binary output, as field values may be arbitrary binary. @log_level is guaranteed to be included in @fields as the `PRIORITY` field, but is provided separately for convenience of deciding whether or where to -output the log entry. +output the log entry. + +Writer functions should return %G_LOG_WRITER_HANDLED if they handled the log +message successfully or if they deliberately ignored it. If there was an +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 @@ -12914,7 +12953,7 @@ linked against at application run time. 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 @@ -12941,7 +12980,7 @@ linked against at application run time. The minimum value which can be held in a #gint8. - + The minor version number of the GLib library. Like #gtk_minor_version, but from the headers used at @@ -13024,7 +13063,7 @@ 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. - + @@ -15914,6 +15953,22 @@ should generally be normalized before comparing them. another name for %G_NORMALIZE_ALL_COMPOSE + + Error codes returned by functions converting a string to a number. + + String was not a valid number. + + + String was a number, but out of bounds. + + + transfer-ownership="full"> a pointer to the number of command line arguments + transfer-ownership="full"> a pointer to the array of command line arguments @@ -17400,6 +17451,99 @@ in size automatically if necessary. + + Checks whether @needle exists in @haystack. If the element is found, %TRUE is +returned and the element’s index is returned in @index_ (if non-%NULL). +Otherwise, %FALSE is returned and @index_ is undefined. If @needle exists +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 + + + + + pointer array to be searched + + + + + + pointer to look for + + + + return location for the index of + the element, if found + + + + + + Checks whether @needle exists in @haystack, using the given @equal_func. +If the element is found, %TRUE is returned and the element’s index is +returned in @index_ (if non-%NULL). Otherwise, %FALSE is returned and @index_ +is undefined. If @needle exists multiple times in @haystack, the index of +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 + + + + + pointer array to be searched + + + + + + pointer to look for + + + + the function to call for each element, which should + return %TRUE when the desired element is found; or %NULL to use pointer + equality + + + + return location for the index of + the element, if found + + + + +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(). @@ -17856,7 +18004,7 @@ This is guaranteed to be a stable sort since version 2.32. Atomically decrements the reference count of @array by one. If the 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 MT-safe and may be called from any thread. +is thread-safe and may be called from any thread. @@ -22471,12 +22619,9 @@ 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 @@ -22537,10 +22682,9 @@ in @seq. + version="2.14"> Returns the begin iterator for @seq. - + the begin iterator for @seq. @@ -22553,10 +22697,9 @@ in @seq. + version="2.14"> Returns the end iterator for @seg - + the end iterator for @seq @@ -22569,11 +22712,10 @@ in @seq. + version="2.14"> 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 @@ -22617,7 +22759,7 @@ otherwise the new position of @data is undefined. 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. - + a #GSequenceIter pointing to the new item. @@ -22663,7 +22805,7 @@ It is called with two iterators pointing into @seq. It should 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. - + a #GSequenceIter pointing to the new item @@ -22732,7 +22874,7 @@ unsorted. Use g_sequence_insert_sorted() or g_sequence_insert_sorted_iter() to add data to your sequence or, if you want to add a large amount of data, call g_sequence_sort() after doing unsorted insertions. - + an #GSequenceIter pointing to the position of the first item found equal to @data according to @cmp_func and @cmp_data, or %NULL if no such item exists @@ -22780,7 +22922,7 @@ unsorted. Use g_sequence_insert_sorted() or g_sequence_insert_sorted_iter() to add data to your sequence or, if you want to add a large amount of data, call g_sequence_sort() after doing unsorted insertions. - + an #GSequenceIter pointing to the position of the first item found equal to @data according to @cmp_func and @cmp_data, or %NULL if no such item exists @@ -22812,12 +22954,9 @@ doing unsorted insertions. - + Adds a new item to the front of @seq - + an iterator pointing to the new item @@ -22855,7 +22994,7 @@ unsorted. Use g_sequence_insert_sorted() or g_sequence_insert_sorted_iter() to add data to your sequence or, if you want to add a large amount of data, call g_sequence_sort() after doing unsorted insertions. - + an #GSequenceIter pointing to the position where @data would have been inserted according to @cmp_func and @cmp_data @@ -22905,7 +23044,7 @@ unsorted. Use g_sequence_insert_sorted() or g_sequence_insert_sorted_iter() to add data to your sequence or, if you want to add a large amount of data, call g_sequence_sort() after doing unsorted insertions. - + a #GSequenceIter pointing to the position in @seq where @data would have been inserted according to @iter_cmp and @cmp_data @@ -23047,10 +23186,9 @@ iterator comes before the first. + version="2.14"> Inserts a new item just before the item pointed to by @iter. - + an iterator pointing to the new item @@ -23124,7 +23262,7 @@ 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 @@ -23141,15 +23279,14 @@ are removed from the sequence. + version="2.14"> Finds an iterator somewhere in the range (@begin, @end). This iterator will be close to the middle of the range, but is not 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 @@ -23352,10 +23489,9 @@ The @a and @b iterators must point into the same sequence. + version="2.14"> Returns the #GSequence that @iter points into. - + the #GSequence that @iter points into @@ -23396,15 +23532,12 @@ The @a and @b iterators must point into the same sequence. - + Returns the #GSequenceIter which is @delta positions away from @iter. 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 @@ -23420,13 +23553,10 @@ 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 @@ -23437,13 +23567,10 @@ 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 @@ -23932,7 +24059,13 @@ idle_callback (gpointer data) return FALSE; } -]| +]| + +Calls to this function from a thread other than the one acquired by the +#GMainContext the #GSource is attached to are typically redundant, as 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 @@ -24274,6 +24407,9 @@ other suggests that it would be delivered first, and the ready time for both sources is reached during the same main context iteration then the order of dispatch is undefined. +It is a no-op to call this function on a #GSource which has already been +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. @@ -25679,7 +25815,7 @@ These two options correspond rather directly to the 'dist' and 'built' terminology that automake uses and are explicitly used to distinguish between the 'srcdir' and 'builddir' being separate. All files in your project should either be dist (in the -`DIST_EXTRA` or `dist_schema_DATA` +`EXTRA_DIST` or `dist_schema_DATA` sense, in which case they will always be in the srcdir) or built (in the `BUILT_SOURCES` sense, in which case they will always be in the builddir). @@ -26659,9 +26795,16 @@ the W3C Note Both of these documents are profiles of ISO 8601. Use g_date_time_format() or g_strdup_printf() if a different -variation of ISO 8601 format is required. - - a newly allocated string containing an ISO 8601 date +variation of ISO 8601 format is required. + +If @time_ represents a date which is too large to fit into a `struct tm`, +%NULL will be returned. This is platform dependent, but it is safe to assume +years up to 3000 are supported. 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. + + a newly allocated string containing an ISO 8601 date, + or %NULL if @time_ was too large @@ -27917,7 +28060,7 @@ This macro is provided for code readability. 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 <ulink url="http://www.unicode.org/unicode/reports/tr14/">http://www.unicode.org/unicode/reports/tr14/</ulink>. +See [Unicode Line Breaking Algorithm](http://www.unicode.org/unicode/reports/tr14/). @@ -28124,9 +28267,7 @@ and is interchangeable with #PangoScript. Note that new types may be added in the future. Applications should be ready to handle unknown values. -See <ulink -url="http://www.unicode.org/reports/tr24/">Unicode Standard Annex -#24: Script names</ulink>. +See [Unicode Standard Annex #24: Script names](http://www.unicode.org/reports/tr24/). @@ -28721,13 +28862,31 @@ url="http://www.unicode.org/reports/tr24/">Unicode Standard Annex Osage. Since: 2.50 - Tangut. Since: 2.50 + Tangut. Since: 2.50 +@G_UNICODE_SCRIPT_MASARAM_GONDI, Masaram Gondi. Since: 2.54 +@G_UNICODE_SCRIPT_NUSHU, Nushu. Since: 2.54 +@G_UNICODE_SCRIPT_SOYOMBO, Soyombo. Since: 2.54 +@G_UNICODE_SCRIPT_ZANABAZAR_SQUARE Zanabazar Square. Since: 2.54 + + + + + + + + These are the possible character classifications from the Unicode specification. -See <ulink url="http://www.unicode.org/reports/tr44/#General_Category_Values">Unicode Character Database</unlink>. +See [Unicode Character Database](http://www.unicode.org/reports/tr44/#General_Category_Values). General category "Other, Control" (Cc) @@ -28996,10 +29155,10 @@ For instance, if you want to create a #GVariant holding an integer value you can use: |[<!-- language="C" --> - GVariant *v = g_variant_new ('u', 40); + GVariant *v = g_variant_new ("u", 40); ]| -The string 'u' in the first argument tells #GVariant that the data passed to +The string "u" in the first argument tells #GVariant that the data passed to the constructor (40) is going to be an unsigned integer. More advanced examples of #GVariant in use can be found in documentation for @@ -29211,7 +29370,7 @@ child. To put the entire example together, for our dictionary mapping strings to variants (with two entries, as given above), we are -using 91 bytes of memory for type information, 29 byes of memory +using 91 bytes of memory for type information, 29 bytes of memory for the serialised data, 16 bytes for buffer management and 24 bytes for the #GVariant instance, or a total of 160 bytes, plus malloc overhead. If we were to use g_variant_get_child_value() to @@ -29431,10 +29590,10 @@ the new instance takes ownership of them as if via g_variant_ref_sink(). - Provides access to the serialised data for an array of fixed-sized -items. + Constructs a new array #GVariant instance, where the elements are +of @element_type type. -@value must be an array with fixed-sized elements. Numeric types are +@elements must be an array with fixed-sized elements. Numeric types are fixed-size as are tuples containing only other fixed-sized types. @element_size must be the size of a single element in the array. @@ -29443,8 +29602,7 @@ you might say sizeof(gint32). This value isn't used except for the purpose of a double-check that the form of the serialised data matches the caller's expectation. -@n_elements, which must be non-%NULL is set equal to the number of -items in the array. +@n_elements must be the length of the @elements array. a floating reference to a new array #GVariant instance @@ -29999,7 +30157,7 @@ pointing to the argument following the last. Note that the arguments in @app must be of the correct width for their types specified in @format_string when collected into the #va_list. -See the [GVariant varargs documentation][gvariant-varargs. +See the [GVariant varargs documentation][gvariant-varargs]. These two generalisations allow mixing of multiple calls to g_variant_new_va() and g_variant_get_va() within a single actual @@ -30651,11 +30809,11 @@ the appropriate type: - %G_VARIANT_TYPE_DOUBLE: #gdouble For example, if calling this function for an array of 32-bit integers, -you might say sizeof(gint32). This value isn't used except for the purpose +you might say `sizeof(gint32)`. This value isn't used except for the purpose of a double-check that the form of the serialised data matches the caller's expectation. -@n_elements, which must be non-%NULL is set equal to the number of +@n_elements, which must be non-%NULL, is set equal to the number of items in the array. a pointer to @@ -31872,7 +32030,7 @@ It typically only makes sense to do this on a stack-allocated #GVariantBuilder if you want to abort building the value part-way through. This function need not be called if you call g_variant_builder_end() and it also doesn't need to be called on -builders allocated with g_variant_builder_new (see +builders allocated with g_variant_builder_new() (see g_variant_builder_unref() for that). This function leaves the #GVariantBuilder structure set to all-zeros. @@ -31986,11 +32144,41 @@ this function. Opens a subcontainer inside the given @builder. When done adding -items to the subcontainer, g_variant_builder_close() must be called. +items to the subcontainer, g_variant_builder_close() must be called. @type +is the type of the container: so to build a tuple of several values, @type +must include the tuple itself. It is an error to call this function in any way that would cause an inconsistent value to be constructed (ie: adding too many values or -a value of an incorrect type). +a value of an incorrect type). + +Example of building a nested variant: +|[<!-- language="C" --> +GVariantBuilder builder; +guint32 some_number = get_number (); +g_autoptr (GHashTable) some_dict = get_dict (); +GHashTableIter iter; +const gchar *key; +const GVariant *value; +g_autoptr (GVariant) output = NULL; + +g_variant_builder_init (&builder, G_VARIANT_TYPE ("(ua{sv})")); +g_variant_builder_add (&builder, "u", some_number); +g_variant_builder_open (&builder, G_VARIANT_TYPE ("a{sv}")); + +g_hash_table_iter_init (&iter, some_dict); +while (g_hash_table_iter_next (&iter, (gpointer *) &key, (gpointer *) &value)) + { + g_variant_builder_open (&builder, G_VARIANT_TYPE ("{sv}")); + g_variant_builder_add (&builder, "s", key); + g_variant_builder_add (&builder, "v", value); + g_variant_builder_close (&builder); + } + +g_variant_builder_close (&builder); + +output = g_variant_builder_end (&builder); +]| @@ -32000,7 +32188,7 @@ a value of an incorrect type). - a #GVariantType + the #GVariantType of the container @@ -33013,7 +33201,7 @@ The meaning of each of the characters is as follows: - `s`: the type string of %G_VARIANT_TYPE_STRING; a string. - `o`: the type string of %G_VARIANT_TYPE_OBJECT_PATH; a string in the form of a D-Bus object path. -- `g`: the type string of %G_VARIANT_TYPE_STRING; a string in the form of +- `g`: the type string of %G_VARIANT_TYPE_SIGNATURE; a string in the form of a D-Bus type signature. - `?`: the type string of %G_VARIANT_TYPE_BASIC; an indefinite type that is a supertype of any of the basic types. @@ -33865,6 +34053,120 @@ Both @s1 and @s2 must be non-%NULL. + + A convenience function for converting a string to a signed number. + +This function assumes that @str contains only a number of the given +@base that is within inclusive bounds limited by @min and @max. If +this is true, then the converted number is stored in @out_num. An +empty string is not a valid input. A string with leading or +trailing whitespace is also an invalid input. + +@base can be between 2 and 36 inclusive. Hexadecimal numbers must +not be prefixed with "0x" or "0X". Such a problem does not exist +for octal numbers, since they were usually prefixed with a zero +which does not change the value of the parsed number. + +Parsing failures result in an error with the %G_NUMBER_PARSER_ERROR +domain. If the input is invalid, the error code will be +%G_NUMBER_PARSER_ERROR_INVALID. If the parsed number is out of +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. + + + + + a string + + + + base of a parsed number + + + + a lower bound (inclusive) + + + + an upper bound (inclusive) + + + + a return location for a number + + + + + + A convenience function for converting a string to an unsigned number. + +This function assumes that @str contains only a number of the given +@base that is within inclusive bounds limited by @min and @max. If +this is true, then the converted number is stored in @out_num. An +empty string is not a valid input. A string with leading or +trailing whitespace is also an invalid input. + +@base can be between 2 and 36 inclusive. Hexadecimal numbers must +not be prefixed with "0x" or "0X". Such a problem does not exist +for octal numbers, since they were usually prefixed with a zero +which does not change the value of the parsed number. + +Parsing failures result in an error with the %G_NUMBER_PARSER_ERROR +domain. If the input is invalid, the error code will be +%G_NUMBER_PARSER_ERROR_INVALID. If the parsed number is out of +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. + + + + + a string + + + + base of a parsed number + + + + a lower bound (inclusive) + + + + an upper bound (inclusive) + + + + a return location for a number + + + + Compare @s1 and @s2, ignoring the case of ASCII characters and any characters after the first @n in each string. @@ -34884,7 +35186,9 @@ representation. The output buffer must be large enough to fit all the data that will be written to it. It will need up to 4 bytes, or up to 5 bytes if -line-breaking is enabled. +line-breaking is enabled. + +The @out array will not be automatically nul-terminated. The number of bytes of output that was written @@ -37230,8 +37534,7 @@ codes are those in the #GFileError enumeration. In the error case, direction="out" caller-allocates="0" transfer-ownership="full" - optional="1" - allow-none="1"> + nullable="1"> location to store length in bytes of the contents, or %NULL @@ -37493,8 +37796,7 @@ encoding used for filenames. nullable="1" optional="1" allow-none="1"> - Location to store hostname for the - URI. + Location to store hostname for the URI. If there is no hostname in the URI, %NULL will be stored in this location. @@ -38052,9 +38354,11 @@ similar cases. Gets the name of the program. This name should not be localized, in contrast to g_get_application_name(). -If you are using GDK or GTK+ the program name is set in gdk_init(), -which is called by gtk_init(). The program name is found by taking -the last component of @argv[0]. +If you are using #GApplication the program name is set in +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. The returned string belongs to GLib and must not be modified or freed. @@ -38100,12 +38404,15 @@ in the [XDG Base Directory Specification](http://www.freedesktop.org/Standards/basedir-spec). In this case the list of directories retrieved will be `XDG_CONFIG_DIRS`. -On Windows is the directory that contains application data for all users. -A typical path is C:\Documents and Settings\All Users\Application Data. -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. +On Windows it follows XDG Base Directory Specification if `XDG_CONFIG_DIRS` is defined. +If `XDG_CONFIG_DIRS` is undefined, the directory that contains application +data for all users is used instead. A typical path is +`C:\Documents and Settings\All Users\Application Data`. +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. a %NULL-terminated array of strings owned by GLib that must not be @@ -38124,9 +38431,11 @@ system-wide application data. On UNIX platforms this is determined using the mechanisms described in the [XDG Base Directory Specification](http://www.freedesktop.org/Standards/basedir-spec) -In this case the list of directories retrieved will be XDG_DATA_DIRS. +In this case the list of directories retrieved will be `XDG_DATA_DIRS`. -On Windows the first elements in the list are the Application Data +On Windows it follows XDG Base Directory Specification if `XDG_DATA_DIRS` is defined. +If `XDG_DATA_DIRS` is undefined, +the first elements in the list are the Application Data and Documents folders for All Users. (These can be determined only on Windows 2000 or later and are not present in the list on other Windows versions.) See documentation for CSIDL_COMMON_APPDATA and @@ -38185,12 +38494,13 @@ data specific to particular user. On UNIX platforms this is determined using the mechanisms described in the [XDG Base Directory Specification](http://www.freedesktop.org/Standards/basedir-spec). -In this case the directory retrieved will be XDG_CACHE_HOME. +In this case the directory retrieved will be `XDG_CACHE_HOME`. -On Windows is the directory that serves as a common repository for -temporary Internet files. A typical path is -C:\Documents and Settings\username\Local Settings\Temporary Internet Files. -See documentation for CSIDL_INTERNET_CACHE. +On Windows it follows XDG Base Directory Specification if `XDG_CACHE_HOME` is defined. +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). a string owned by GLib that must not be modified or freed. @@ -38208,10 +38518,12 @@ in the [XDG Base Directory Specification](http://www.freedesktop.org/Standards/basedir-spec). In this case the directory retrieved will be `XDG_CONFIG_HOME`. -On Windows this is the folder to use for local (as opposed to -roaming) application data. See documentation for -CSIDL_LOCAL_APPDATA. Note that on Windows it thus is the same as -what g_get_user_data_dir() returns. +On Windows it follows XDG Base Directory Specification if `XDG_CONFIG_HOME` is defined. +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. a string owned by GLib that must not be modified or freed. @@ -38229,10 +38541,12 @@ in the [XDG Base Directory Specification](http://www.freedesktop.org/Standards/basedir-spec). In this case the directory retrieved will be `XDG_DATA_HOME`. -On Windows this is the folder to use for local (as opposed to -roaming) application data. See documentation for -CSIDL_LOCAL_APPDATA. Note that on Windows it thus is the same as -what g_get_user_config_dir() returns. +On Windows it follows XDG Base Directory Specification if `XDG_DATA_HOME` +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. a string owned by GLib that must not be modified or freed. @@ -38255,18 +38569,13 @@ consistent on a machine. On Windows, it is always UTF-8. Returns a directory that is unique to the current user on the local system. -On UNIX platforms this is determined using the mechanisms described +This is determined using the mechanisms described in the [XDG Base Directory Specification](http://www.freedesktop.org/Standards/basedir-spec). 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. - -On Windows this is the folder to use for local (as opposed to -roaming) application data. See documentation for -CSIDL_LOCAL_APPDATA. Note that on Windows it thus is the same as -what g_get_user_config_dir() returns. +g_get_user_cache_dir(), after verifying that it exists. a string owned by GLib that must not be modified or freed. @@ -39808,7 +40117,10 @@ There can only be one writer function. It is an error to set more than one.Log a message with structured data. The message will be passed through to the log writer set by the application using g_log_set_writer_func(). If the message is fatal (i.e. its log level is %G_LOG_LEVEL_ERROR), the program will -be aborted at the end of this function. +be aborted at the end of this function. If the log writer returns +%G_LOG_WRITER_UNHANDLED (failure), no other fallback writers will be tried. +See the documentation for #GLogWriterFunc for information on chaining +writers. The structured data is provided as key–value pairs, where keys are UTF-8 strings, and values are arbitrary pointers — typically pointing to UTF-8 @@ -39873,8 +40185,8 @@ g_log_structured_array (G_LOG_LEVEL_DEBUG, fields, G_N_ELEMENTS (fields)); ]| Note also that, even if no other structured fields are specified, there -must always be a "MESSAGE" key before the format string. The "MESSAGE"-format -pair has to be the last of the key-value pairs, and "MESSAGE" is the only +must always be a `MESSAGE` key before the format string. The `MESSAGE`-format +pair has to be the last of the key-value pairs, and `MESSAGE` is the only field for which printf()-style formatting is supported. The default writer function for `stdout` and `stderr` will automatically @@ -40067,7 +40379,13 @@ UTF-8. version="2.50"> Check whether the given @output_fd file descriptor is a connection to the systemd journal, or something else (like a log file or `stdout` or -`stderr`). +`stderr`). + +Invalid file descriptors are accepted and return %FALSE, which allows for +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 @@ -40709,18 +41027,25 @@ created. Returns -1 if an error occurred, with errno set. - + Creates a temporary directory. See the mkdtemp() documentation on most UNIX-like systems. The parameter is a string that should follow the rules for mkdtemp() templates, i.e. contain the string "XXXXXX". g_mkdtemp() is slightly more flexible than mkdtemp() in that the -sequence does not have to occur at the very end of the template -and you can pass a @mode and additional @flags. The X string will -be modified to form the name of a directory that didn't exist. +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 directory that +didn't exist. The string should be in the GLib file name encoding. Most importantly, -on Windows it should be in UTF-8. +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 @@ -40734,18 +41059,25 @@ on Windows it should be in UTF-8. - + Creates a temporary directory. See the mkdtemp() documentation on most UNIX-like systems. The parameter is a string that should follow the rules for mkdtemp() templates, i.e. contain the string "XXXXXX". -g_mkdtemp() is slightly more flexible than mkdtemp() in that the +g_mkdtemp_full() is slightly more flexible than mkdtemp() in that the sequence does not have to occur at the very end of the template and you can pass a @mode. The X string will be modified to form the name of a directory that didn't exist. The string should be in the GLib file name encoding. Most importantly, on Windows it -should be in UTF-8. +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 @@ -40763,7 +41095,7 @@ should be in UTF-8. - + Opens a temporary file. See the mkstemp() documentation on most UNIX-like systems. @@ -40789,7 +41121,10 @@ Most importantly, on Windows it should be in UTF-8. - + Opens a temporary file. See the mkstemp() documentation on most UNIX-like systems. @@ -40836,6 +41171,12 @@ on Windows it should be in UTF-8. + + + + + Prompts the user with `[E]xit, [H]alt, show [S]tack trace or [P]roceed`. @@ -41484,6 +41825,101 @@ g_prefix_error(). + + Checks whether @needle exists in @haystack. If the element is found, %TRUE is +returned and the element’s index is returned in @index_ (if non-%NULL). +Otherwise, %FALSE is returned and @index_ is undefined. If @needle exists +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 + + + + + pointer array to be searched + + + + + + pointer to look for + + + + return location for the index of + the element, if found + + + + + + Checks whether @needle exists in @haystack, using the given @equal_func. +If the element is found, %TRUE is returned and the element’s index is +returned in @index_ (if non-%NULL). Otherwise, %FALSE is returned and @index_ +is undefined. If @needle exists multiple times in @haystack, the index of +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 + + + + + pointer array to be searched + + + + + + pointer to look for + + + + the function to call for each element, which should + return %TRUE when the desired element is found; or %NULL to use pointer + equality + + + + return location for the index of + the element, if found + + + + @@ -41975,6 +42411,29 @@ on your system. + + Inserts a new item just before the item pointed to by @iter. + + an iterator pointing to the new item + + + + + a #GSequenceIter + + + + the data for the new item + + + + + + Finds an iterator somewhere in the range (@begin, @end). This +iterator will be close to the middle of the range, but is not +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 + + + + + a #GSequenceIter + + + + a #GSequenceIter + + + + Sets the name of the program. This name should not be localized, in contrast to g_set_application_name(). +If you are using #GApplication the program name is set in +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]. + Note that for thread-safety reasons this function can only be called once. @@ -42751,10 +43242,10 @@ simply calls the g_spawn_async_with_pipes() without any pipes. You should call g_spawn_close_pid() on the returned child process reference when you don't need it any more. -If you are writing a GTK+ application, and the program you are -spawning is a graphical application, too, then you may want to -use gdk_spawn_on_screen() instead to ensure that the spawned program -opens its windows on the right screen. +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. Note that the returned @child_pid on Windows is a handle to the child process and not its identifier. Process handles and process identifiers @@ -42878,10 +43369,11 @@ 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 to -be notified about the death of the child process. 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, +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 @@ -42965,10 +43457,10 @@ 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(). -If you are writing a GTK+ application, and the program you -are spawning is a graphical application, too, then you may -want to use gdk_spawn_on_screen_with_pipes() instead to ensure that -the spawned program opens its windows on the right screen. +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. %TRUE on success, %FALSE if an error was set @@ -43913,7 +44405,17 @@ the lifetime of the process. Note that the string may be translated according to the current locale. -The value of %errno will not be changed by this function. +The value of %errno will not be changed by this function. However, it may +be changed by intermediate function calls, so you should save its value +as soon as the call returns: +|[ + int saved_errno; + + ret = read (blah); + saved_errno = errno; + + 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>)". @@ -45034,6 +45536,7 @@ So far, the following arguments are understood: - `--verbose`: Run tests verbosely. - `-q`, `--quiet`: Run tests quietly. - `-p PATH`: Execute all tests matching the given path. +- `-s PATH`: Skip all tests matching the given path. This can also be used to force a test to run that would otherwise be skipped (ie, a test whose name contains "/subprocess"). - `-m {perf|slow|thorough|quick|undefined|no-undefined}`: Execute tests according to these test modes: @@ -45203,7 +45706,7 @@ order for test result reports. version="2.16"> This function enqueus a callback @destroy_func to be executed during the next test case teardown phase. This is most useful -to auto destruct allocted test resources at the end of a test run. +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. @@ -45314,8 +45817,9 @@ see g_test_rand_int() for details on test case random numbers. Runs all tests under the toplevel suite which can be retrieved with g_test_get_root(). Similar to g_test_run_suite(), the test cases to be run are filtered according to test path arguments -(`-p testpath`) as parsed by g_test_init(). g_test_run_suite() -or g_test_run() may only be called once in a program. +(`-p testpath` and `-s testpath`) as parsed by g_test_init(). +g_test_run_suite() or g_test_run() may only be called once in a +program. In general, the tests and sub-suites within each suite are run in the order in which they are defined. However, note that prior to @@ -45352,9 +45856,10 @@ producing TAP output, or 77 (treated as "skip test" by Automake) otherwise. Execute the tests within @suite and all nested #GTestSuites. The test suites to be executed are filtered according to -test path arguments (`-p testpath`) as parsed by g_test_init(). -See the g_test_run() documentation for more information on the -order that tests are run in. +test path arguments (`-p testpath` and `-s testpath`) as parsed by +g_test_init(). See the g_test_run() documentation for more +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. @@ -47343,7 +47848,7 @@ using g_source_remove(). Create a #GSource that will be dispatched upon delivery of the UNIX signal @signum. In GLib versions before 2.36, only `SIGHUP`, `SIGINT`, `SIGTERM` can be monitored. In GLib 2.36, `SIGUSR1` and `SIGUSR2` -were added. +were added. In GLib 2.54, `SIGWINCH` was added. Note that unlike the UNIX default, all sources which have created a watch will be dispatched, regardless of which underlying thread @@ -47799,9 +48304,15 @@ Note that this function depends on the [current locale][setlocale]. @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 +it starts with an appropriate byte. + +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 @@ -47865,7 +48376,11 @@ instead. Convert a sequence of bytes encoded as UTF-8 to a Unicode character. This function checks for incomplete characters, for invalid characters such as characters that are out of the range of Unicode, and for -overlong encodings of valid characters. +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 @@ -47880,8 +48395,35 @@ overlong encodings of valid characters. - the maximum number of bytes to read, or -1, for no maximum or - if @p is nul-terminated + the maximum number of bytes to read, or -1 if @p is nul-terminated + + + + + + If the provided string is valid UTF-8, return a copy of it. If not, +return a copy in which bytes that could not be interpreted as valid Unicode +are replaced with the Unicode replacement character (U+FFFD). + +For example, this is an appropriate function to use if you have received +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 + + + + + string to coerce into UTF-8 + + + + the maximum length of @str to use, in bytes. If @len < 0, + then the string is nul-terminated. @@ -48366,6 +48908,37 @@ doing anything else with it. + + Parses the string @str and verify if it is a UUID. + +The function accepts the following syntax: + +- simple forms (e.g. `f81d4fae-7dec-11d0-a765-00a0c91e6bf6`) + +Note that hyphens are required within the UUID string itself, +as per the aforementioned RFC. + + %TRUE if @str is a valid UUID, %FALSE otherwise. + + + + + a string representing a UUID + + + + + + Generates a random UUID (RFC 4122 version 4) as a string. + + A string that should be freed with g_free(). + + + diff --git a/gir-files/GObject-2.0.gir b/gir-files/GObject-2.0.gir index 077151556..44e1d0a1f 100644 --- a/gir-files/GObject-2.0.gir +++ b/gir-files/GObject-2.0.gir @@ -507,42 +507,47 @@ 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. + A #GClosureMarshal function for use with signals with handlers that +take a flags type as an argument 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(). - the #GClosure to which the marshaller belongs + A #GClosure. - a #GValue which can store the returned #gboolean + A #GValue to store the return value. May be %NULL + if the callback of closure doesn't return a value. - 2 + The length of the @param_values array. - a #GValue array holding instance and arg1 + An array of #GValues holding the arguments + on which to invoke the callback of closure. - the invocation hint given as the last argument - to g_closure_invoke() + The invocation hint given as the last argument to + g_closure_invoke(). - additional data specified when registering the marshaller + Additional data specified when registering the + marshaller, see g_closure_set_marshal() and + g_closure_set_meta_marshal() @@ -600,41 +605,46 @@ 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)`. + A #GClosureMarshal function for use with signals with handlers that +take a #GObject and a pointer and produce a string. It is highly +unlikely that your signal handler fits this description. - the #GClosure to which the marshaller belongs + A #GClosure. - a #GValue, which can store the returned string + A #GValue to store the return value. May be %NULL + if the callback of closure doesn't return a value. - 3 + The length of the @param_values array. - a #GValue array holding instance, arg1 and arg2 + An array of #GValues holding the arguments + on which to invoke the callback of closure. - the invocation hint given as the last argument - to g_closure_invoke() + The invocation hint given as the last argument to + g_closure_invoke(). - additional data specified when registering the marshaller + Additional data specified when registering the + marshaller, see g_closure_set_marshal() and + g_closure_set_meta_marshal() @@ -692,41 +702,45 @@ denotes a flags type. - A marshaller for a #GCClosure with a callback of type -`void (*callback) (gpointer instance, gboolean arg1, gpointer user_data)`. + A #GClosureMarshal function for use with signals with a single +boolean argument. - the #GClosure to which the marshaller belongs + A #GClosure. - ignored + A #GValue to store the return value. May be %NULL + if the callback of closure doesn't return a value. - 2 + The length of the @param_values array. - a #GValue array holding the instance and the #gboolean parameter + An array of #GValues holding the arguments + on which to invoke the callback of closure. - the invocation hint given as the last argument - to g_closure_invoke() + The invocation hint given as the last argument to + g_closure_invoke(). - additional data specified when registering the marshaller + Additional data specified when registering the + marshaller, see g_closure_set_marshal() and + g_closure_set_meta_marshal() @@ -784,41 +798,45 @@ denotes a flags type. - A marshaller for a #GCClosure with a callback of type -`void (*callback) (gpointer instance, GBoxed *arg1, gpointer user_data)`. + A #GClosureMarshal function for use with signals with a single +argument which is any boxed pointer type. - the #GClosure to which the marshaller belongs + A #GClosure. - ignored + A #GValue to store the return value. May be %NULL + if the callback of closure doesn't return a value. - 2 + The length of the @param_values array. - a #GValue array holding the instance and the #GBoxed* parameter + An array of #GValues holding the arguments + on which to invoke the callback of closure. - the invocation hint given as the last argument - to g_closure_invoke() + The invocation hint given as the last argument to + g_closure_invoke(). - additional data specified when registering the marshaller + Additional data specified when registering the + marshaller, see g_closure_set_marshal() and + g_closure_set_meta_marshal() @@ -876,41 +894,45 @@ denotes a flags type. - A marshaller for a #GCClosure with a callback of type -`void (*callback) (gpointer instance, gchar arg1, gpointer user_data)`. + A #GClosureMarshal function for use with signals with a single +character argument. - the #GClosure to which the marshaller belongs + A #GClosure. - ignored + A #GValue to store the return value. May be %NULL + if the callback of closure doesn't return a value. - 2 + The length of the @param_values array. - a #GValue array holding the instance and the #gchar parameter + An array of #GValues holding the arguments + on which to invoke the callback of closure. - the invocation hint given as the last argument - to g_closure_invoke() + The invocation hint given as the last argument to + g_closure_invoke(). - additional data specified when registering the marshaller + Additional data specified when registering the + marshaller, see g_closure_set_marshal() and + g_closure_set_meta_marshal() @@ -968,41 +990,45 @@ denotes a flags type. - A marshaller for a #GCClosure with a callback of type -`void (*callback) (gpointer instance, gdouble arg1, gpointer user_data)`. + A #GClosureMarshal function for use with signals with one +double-precision floating point argument. - the #GClosure to which the marshaller belongs + A #GClosure. - ignored + A #GValue to store the return value. May be %NULL + if the callback of closure doesn't return a value. - 2 + The length of the @param_values array. - a #GValue array holding the instance and the #gdouble parameter + An array of #GValues holding the arguments + on which to invoke the callback of closure. - the invocation hint given as the last argument - to g_closure_invoke() + The invocation hint given as the last argument to + g_closure_invoke(). - additional data specified when registering the marshaller + Additional data specified when registering the + marshaller, see g_closure_set_marshal() and + g_closure_set_meta_marshal() @@ -1060,41 +1086,45 @@ 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.. + A #GClosureMarshal function for use with signals with a single +argument with an enumerated type. - the #GClosure to which the marshaller belongs + A #GClosure. - ignored + A #GValue to store the return value. May be %NULL + if the callback of closure doesn't return a value. - 2 + The length of the @param_values array. - a #GValue array holding the instance and the enumeration parameter + An array of #GValues holding the arguments + on which to invoke the callback of closure. - the invocation hint given as the last argument - to g_closure_invoke() + The invocation hint given as the last argument to + g_closure_invoke(). - additional data specified when registering the marshaller + Additional data specified when registering the + marshaller, see g_closure_set_marshal() and + g_closure_set_meta_marshal() @@ -1152,41 +1182,45 @@ 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. + A #GClosureMarshal function for use with signals with a single +argument with a flags types. - the #GClosure to which the marshaller belongs + A #GClosure. - ignored + A #GValue to store the return value. May be %NULL + if the callback of closure doesn't return a value. - 2 + The length of the @param_values array. - a #GValue array holding the instance and the flags parameter + An array of #GValues holding the arguments + on which to invoke the callback of closure. - the invocation hint given as the last argument - to g_closure_invoke() + The invocation hint given as the last argument to + g_closure_invoke(). - additional data specified when registering the marshaller + Additional data specified when registering the + marshaller, see g_closure_set_marshal() and + g_closure_set_meta_marshal() @@ -1244,41 +1278,45 @@ denotes a flags type. - A marshaller for a #GCClosure with a callback of type -`void (*callback) (gpointer instance, gfloat arg1, gpointer user_data)`. + A #GClosureMarshal function for use with signals with one +single-precision floating point argument. - the #GClosure to which the marshaller belongs + A #GClosure. - ignored + A #GValue to store the return value. May be %NULL + if the callback of closure doesn't return a value. - 2 + The length of the @param_values array. - a #GValue array holding the instance and the #gfloat parameter + An array of #GValues holding the arguments + on which to invoke the callback of closure. - the invocation hint given as the last argument - to g_closure_invoke() + The invocation hint given as the last argument to + g_closure_invoke(). - additional data specified when registering the marshaller + Additional data specified when registering the + marshaller, see g_closure_set_marshal() and + g_closure_set_meta_marshal() @@ -1336,41 +1374,45 @@ denotes a flags type. - A marshaller for a #GCClosure with a callback of type -`void (*callback) (gpointer instance, gint arg1, gpointer user_data)`. + A #GClosureMarshal function for use with signals with a single +integer argument. - the #GClosure to which the marshaller belongs + A #GClosure. - ignored + A #GValue to store the return value. May be %NULL + if the callback of closure doesn't return a value. - 2 + The length of the @param_values array. - a #GValue array holding the instance and the #gint parameter + An array of #GValues holding the arguments + on which to invoke the callback of closure. - the invocation hint given as the last argument - to g_closure_invoke() + The invocation hint given as the last argument to + g_closure_invoke(). - additional data specified when registering the marshaller + Additional data specified when registering the + marshaller, see g_closure_set_marshal() and + g_closure_set_meta_marshal() @@ -1428,41 +1470,45 @@ denotes a flags type. - A marshaller for a #GCClosure with a callback of type -`void (*callback) (gpointer instance, glong arg1, gpointer user_data)`. + A #GClosureMarshal function for use with signals with with a single +long integer argument. - the #GClosure to which the marshaller belongs + A #GClosure. - ignored + A #GValue to store the return value. May be %NULL + if the callback of closure doesn't return a value. - 2 + The length of the @param_values array. - a #GValue array holding the instance and the #glong parameter + An array of #GValues holding the arguments + on which to invoke the callback of closure. - the invocation hint given as the last argument - to g_closure_invoke() + The invocation hint given as the last argument to + g_closure_invoke(). - additional data specified when registering the marshaller + Additional data specified when registering the + marshaller, see g_closure_set_marshal() and + g_closure_set_meta_marshal() @@ -1520,41 +1566,45 @@ denotes a flags type. - A marshaller for a #GCClosure with a callback of type -`void (*callback) (gpointer instance, GObject *arg1, gpointer user_data)`. + A #GClosureMarshal function for use with signals with a single +#GObject argument. - the #GClosure to which the marshaller belongs + A #GClosure. - ignored + A #GValue to store the return value. May be %NULL + if the callback of closure doesn't return a value. - 2 + The length of the @param_values array. - a #GValue array holding the instance and the #GObject* parameter + An array of #GValues holding the arguments + on which to invoke the callback of closure. - the invocation hint given as the last argument - to g_closure_invoke() + The invocation hint given as the last argument to + g_closure_invoke(). - additional data specified when registering the marshaller + Additional data specified when registering the + marshaller, see g_closure_set_marshal() and + g_closure_set_meta_marshal() @@ -1612,41 +1662,45 @@ denotes a flags type. - A marshaller for a #GCClosure with a callback of type -`void (*callback) (gpointer instance, GParamSpec *arg1, gpointer user_data)`. + A #GClosureMarshal function for use with signals with a single +argument of type #GParamSpec. - the #GClosure to which the marshaller belongs + A #GClosure. - ignored + A #GValue to store the return value. May be %NULL + if the callback of closure doesn't return a value. - 2 + The length of the @param_values array. - a #GValue array holding the instance and the #GParamSpec* parameter + An array of #GValues holding the arguments + on which to invoke the callback of closure. - the invocation hint given as the last argument - to g_closure_invoke() + The invocation hint given as the last argument to + g_closure_invoke(). - additional data specified when registering the marshaller + Additional data specified when registering the + marshaller, see g_closure_set_marshal() and + g_closure_set_meta_marshal() @@ -1704,41 +1758,49 @@ denotes a flags type. - A marshaller for a #GCClosure with a callback of type -`void (*callback) (gpointer instance, gpointer arg1, gpointer user_data)`. + A #GClosureMarshal function for use with signals with a single raw +pointer argument type. + +If it is possible, it is better to use one of the more specific +functions such as g_cclosure_marshal_VOID__OBJECT() or +g_cclosure_marshal_VOID__OBJECT(). - the #GClosure to which the marshaller belongs + A #GClosure. - ignored + A #GValue to store the return value. May be %NULL + if the callback of closure doesn't return a value. - 2 + The length of the @param_values array. - a #GValue array holding the instance and the #gpointer parameter + An array of #GValues holding the arguments + on which to invoke the callback of closure. - the invocation hint given as the last argument - to g_closure_invoke() + The invocation hint given as the last argument to + g_closure_invoke(). - additional data specified when registering the marshaller + Additional data specified when registering the + marshaller, see g_closure_set_marshal() and + g_closure_set_meta_marshal() @@ -1796,41 +1858,45 @@ denotes a flags type. - A marshaller for a #GCClosure with a callback of type -`void (*callback) (gpointer instance, const gchar *arg1, gpointer user_data)`. + A #GClosureMarshal function for use with signals with a single string +argument. - the #GClosure to which the marshaller belongs + A #GClosure. - ignored + A #GValue to store the return value. May be %NULL + if the callback of closure doesn't return a value. - 2 + The length of the @param_values array. - a #GValue array holding the instance and the #gchar* parameter + An array of #GValues holding the arguments + on which to invoke the callback of closure. - the invocation hint given as the last argument - to g_closure_invoke() + The invocation hint given as the last argument to + g_closure_invoke(). - additional data specified when registering the marshaller + Additional data specified when registering the + marshaller, see g_closure_set_marshal() and + g_closure_set_meta_marshal() @@ -1888,41 +1954,45 @@ denotes a flags type. - A marshaller for a #GCClosure with a callback of type -`void (*callback) (gpointer instance, guchar arg1, gpointer user_data)`. + A #GClosureMarshal function for use with signals with a single +unsigned character argument. - the #GClosure to which the marshaller belongs + A #GClosure. - ignored + A #GValue to store the return value. May be %NULL + if the callback of closure doesn't return a value. - 2 + The length of the @param_values array. - a #GValue array holding the instance and the #guchar parameter + An array of #GValues holding the arguments + on which to invoke the callback of closure. - the invocation hint given as the last argument - to g_closure_invoke() + The invocation hint given as the last argument to + g_closure_invoke(). - additional data specified when registering the marshaller + Additional data specified when registering the + marshaller, see g_closure_set_marshal() and + g_closure_set_meta_marshal() @@ -1980,82 +2050,90 @@ denotes a flags type. - A marshaller for a #GCClosure with a callback of type -`void (*callback) (gpointer instance, guint arg1, gpointer user_data)`. + A #GClosureMarshal function for use with signals with with a single +unsigned integer argument. - the #GClosure to which the marshaller belongs + A #GClosure. - ignored + A #GValue to store the return value. May be %NULL + if the callback of closure doesn't return a value. - 2 + The length of the @param_values array. - a #GValue array holding the instance and the #guint parameter + An array of #GValues holding the arguments + on which to invoke the callback of closure. - the invocation hint given as the last argument - to g_closure_invoke() + The invocation hint given as the last argument to + g_closure_invoke(). - additional data specified when registering the marshaller + Additional data specified when registering the + marshaller, see g_closure_set_marshal() and + g_closure_set_meta_marshal() - A marshaller for a #GCClosure with a callback of type -`void (*callback) (gpointer instance, guint arg1, gpointer arg2, gpointer user_data)`. + A #GClosureMarshal function for use with signals with a unsigned int +and a pointer as arguments. - the #GClosure to which the marshaller belongs + A #GClosure. - ignored + A #GValue to store the return value. May be %NULL + if the callback of closure doesn't return a value. - 3 + The length of the @param_values array. - a #GValue array holding instance, arg1 and arg2 + An array of #GValues holding the arguments + on which to invoke the callback of closure. - the invocation hint given as the last argument - to g_closure_invoke() + The invocation hint given as the last argument to + g_closure_invoke(). - additional data specified when registering the marshaller + Additional data specified when registering the + marshaller, see g_closure_set_marshal() and + g_closure_set_meta_marshal() @@ -2164,41 +2242,45 @@ denotes a flags type. - A marshaller for a #GCClosure with a callback of type -`void (*callback) (gpointer instance, gulong arg1, gpointer user_data)`. + A #GClosureMarshal function for use with signals with a single +unsigned long integer argument. - the #GClosure to which the marshaller belongs + A #GClosure. - ignored + A #GValue to store the return value. May be %NULL + if the callback of closure doesn't return a value. - 2 + The length of the @param_values array. - a #GValue array holding the instance and the #gulong parameter + An array of #GValues holding the arguments + on which to invoke the callback of closure. - the invocation hint given as the last argument - to g_closure_invoke() + The invocation hint given as the last argument to + g_closure_invoke(). - additional data specified when registering the marshaller + Additional data specified when registering the + marshaller, see g_closure_set_marshal() and + g_closure_set_meta_marshal() @@ -2255,43 +2337,46 @@ denotes a flags type. - A marshaller for a #GCClosure with a callback of type -`void (*callback) (gpointer instance, GVariant *arg1, gpointer user_data)`. + c:identifier="g_cclosure_marshal_VOID__VARIANT"> + A #GClosureMarshal function for use with signals with a single +#GVariant argument. - the #GClosure to which the marshaller belongs + A #GClosure. - ignored + A #GValue to store the return value. May be %NULL + if the callback of closure doesn't return a value. - 2 + The length of the @param_values array. - a #GValue array holding the instance and the #GVariant* parameter + An array of #GValues holding the arguments + on which to invoke the callback of closure. - the invocation hint given as the last argument - to g_closure_invoke() + The invocation hint given as the last argument to + g_closure_invoke(). - additional data specified when registering the marshaller + Additional data specified when registering the + marshaller, see g_closure_set_marshal() and + g_closure_set_meta_marshal() @@ -2349,41 +2434,44 @@ denotes a flags type. - A marshaller for a #GCClosure with a callback of type -`void (*callback) (gpointer instance, gpointer user_data)`. + A #GClosureMarshal function for use with signals with no arguments. - the #GClosure to which the marshaller belongs + A #GClosure. - ignored + A #GValue to store the return value. May be %NULL + if the callback of closure doesn't return a value. - 1 + The length of the @param_values array. - a #GValue array holding only the instance + An array of #GValues holding the arguments + on which to invoke the callback of closure. - the invocation hint given as the last argument - to g_closure_invoke() + The invocation hint given as the last argument to + g_closure_invoke(). - additional data specified when registering the marshaller + Additional data specified when registering the + marshaller, see g_closure_set_marshal() and + g_closure_set_meta_marshal() @@ -3814,7 +3902,7 @@ zeros before this function is called. to the #GObject implementation and should never be accessed directly. Creates a new instance of a #GObject subtype and sets its properties. @@ -3868,11 +3956,54 @@ which are not explicitly specified are set to their default values. - + + Creates a new instance of a #GObject subtype and sets its properties using +the provided arrays. Both arrays must have exactly @n_properties elements, +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 + + + + + the object type to instantiate + + + + the number of properties + + + + the names of each property to be set + + + + + + the values of each property to be set + + + + + + + Creates a new instance of a #GObject subtype and sets its properties. 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 @@ -4739,6 +4870,37 @@ See g_object_get(). + + Gets @n_properties properties for an @object. +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. + + + + + + a #GObject + + + + the number of properties + + + + the names of each property to get + + + + + + the values of each property to get + + + + + + @@ -5253,6 +5415,40 @@ with the same @quark. + + Sets @n_properties properties for an @object. +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. + + + + + + a #GObject + + + + the number of properties + + + + the names of each property to be set + + + + + + the values of each property to be set + + + + + + Remove a specified datum from the object's data associations, without invoking the association's destroy handler. @@ -7260,9 +7456,13 @@ g_param_type_register_static(). - + 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 @@ -10755,42 +10955,47 @@ 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. + A #GClosureMarshal function for use with signals with handlers that +take a flags type as an argument 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(). - the #GClosure to which the marshaller belongs + A #GClosure. - a #GValue which can store the returned #gboolean + A #GValue to store the return value. May be %NULL + if the callback of closure doesn't return a value. - 2 + The length of the @param_values array. - a #GValue array holding instance and arg1 + An array of #GValues holding the arguments + on which to invoke the callback of closure. - the invocation hint given as the last argument - to g_closure_invoke() + The invocation hint given as the last argument to + g_closure_invoke(). - additional data specified when registering the marshaller + Additional data specified when registering the + marshaller, see g_closure_set_marshal() and + g_closure_set_meta_marshal() @@ -10798,41 +11003,46 @@ 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)`. + A #GClosureMarshal function for use with signals with handlers that +take a #GObject and a pointer and produce a string. It is highly +unlikely that your signal handler fits this description. - the #GClosure to which the marshaller belongs + A #GClosure. - a #GValue, which can store the returned string + A #GValue to store the return value. May be %NULL + if the callback of closure doesn't return a value. - 3 + The length of the @param_values array. - a #GValue array holding instance, arg1 and arg2 + An array of #GValues holding the arguments + on which to invoke the callback of closure. - the invocation hint given as the last argument - to g_closure_invoke() + The invocation hint given as the last argument to + g_closure_invoke(). - additional data specified when registering the marshaller + Additional data specified when registering the + marshaller, see g_closure_set_marshal() and + g_closure_set_meta_marshal() @@ -10840,41 +11050,45 @@ denotes a flags type. - A marshaller for a #GCClosure with a callback of type -`void (*callback) (gpointer instance, gboolean arg1, gpointer user_data)`. + A #GClosureMarshal function for use with signals with a single +boolean argument. - the #GClosure to which the marshaller belongs + A #GClosure. - ignored + A #GValue to store the return value. May be %NULL + if the callback of closure doesn't return a value. - 2 + The length of the @param_values array. - a #GValue array holding the instance and the #gboolean parameter + An array of #GValues holding the arguments + on which to invoke the callback of closure. - the invocation hint given as the last argument - to g_closure_invoke() + The invocation hint given as the last argument to + g_closure_invoke(). - additional data specified when registering the marshaller + Additional data specified when registering the + marshaller, see g_closure_set_marshal() and + g_closure_set_meta_marshal() @@ -10882,41 +11096,45 @@ denotes a flags type. - A marshaller for a #GCClosure with a callback of type -`void (*callback) (gpointer instance, GBoxed *arg1, gpointer user_data)`. + A #GClosureMarshal function for use with signals with a single +argument which is any boxed pointer type. - the #GClosure to which the marshaller belongs + A #GClosure. - ignored + A #GValue to store the return value. May be %NULL + if the callback of closure doesn't return a value. - 2 + The length of the @param_values array. - a #GValue array holding the instance and the #GBoxed* parameter + An array of #GValues holding the arguments + on which to invoke the callback of closure. - the invocation hint given as the last argument - to g_closure_invoke() + The invocation hint given as the last argument to + g_closure_invoke(). - additional data specified when registering the marshaller + Additional data specified when registering the + marshaller, see g_closure_set_marshal() and + g_closure_set_meta_marshal() @@ -10924,41 +11142,45 @@ denotes a flags type. - A marshaller for a #GCClosure with a callback of type -`void (*callback) (gpointer instance, gchar arg1, gpointer user_data)`. + A #GClosureMarshal function for use with signals with a single +character argument. - the #GClosure to which the marshaller belongs + A #GClosure. - ignored + A #GValue to store the return value. May be %NULL + if the callback of closure doesn't return a value. - 2 + The length of the @param_values array. - a #GValue array holding the instance and the #gchar parameter + An array of #GValues holding the arguments + on which to invoke the callback of closure. - the invocation hint given as the last argument - to g_closure_invoke() + The invocation hint given as the last argument to + g_closure_invoke(). - additional data specified when registering the marshaller + Additional data specified when registering the + marshaller, see g_closure_set_marshal() and + g_closure_set_meta_marshal() @@ -10966,41 +11188,45 @@ denotes a flags type. - A marshaller for a #GCClosure with a callback of type -`void (*callback) (gpointer instance, gdouble arg1, gpointer user_data)`. + A #GClosureMarshal function for use with signals with one +double-precision floating point argument. - the #GClosure to which the marshaller belongs + A #GClosure. - ignored + A #GValue to store the return value. May be %NULL + if the callback of closure doesn't return a value. - 2 + The length of the @param_values array. - a #GValue array holding the instance and the #gdouble parameter + An array of #GValues holding the arguments + on which to invoke the callback of closure. - the invocation hint given as the last argument - to g_closure_invoke() + The invocation hint given as the last argument to + g_closure_invoke(). - additional data specified when registering the marshaller + Additional data specified when registering the + marshaller, see g_closure_set_marshal() and + g_closure_set_meta_marshal() @@ -11008,41 +11234,45 @@ 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.. + A #GClosureMarshal function for use with signals with a single +argument with an enumerated type. - the #GClosure to which the marshaller belongs + A #GClosure. - ignored + A #GValue to store the return value. May be %NULL + if the callback of closure doesn't return a value. - 2 + The length of the @param_values array. - a #GValue array holding the instance and the enumeration parameter + An array of #GValues holding the arguments + on which to invoke the callback of closure. - the invocation hint given as the last argument - to g_closure_invoke() + The invocation hint given as the last argument to + g_closure_invoke(). - additional data specified when registering the marshaller + Additional data specified when registering the + marshaller, see g_closure_set_marshal() and + g_closure_set_meta_marshal() @@ -11050,41 +11280,45 @@ 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. + A #GClosureMarshal function for use with signals with a single +argument with a flags types. - the #GClosure to which the marshaller belongs + A #GClosure. - ignored + A #GValue to store the return value. May be %NULL + if the callback of closure doesn't return a value. - 2 + The length of the @param_values array. - a #GValue array holding the instance and the flags parameter + An array of #GValues holding the arguments + on which to invoke the callback of closure. - the invocation hint given as the last argument - to g_closure_invoke() + The invocation hint given as the last argument to + g_closure_invoke(). - additional data specified when registering the marshaller + Additional data specified when registering the + marshaller, see g_closure_set_marshal() and + g_closure_set_meta_marshal() @@ -11092,41 +11326,45 @@ denotes a flags type. - A marshaller for a #GCClosure with a callback of type -`void (*callback) (gpointer instance, gfloat arg1, gpointer user_data)`. + A #GClosureMarshal function for use with signals with one +single-precision floating point argument. - the #GClosure to which the marshaller belongs + A #GClosure. - ignored + A #GValue to store the return value. May be %NULL + if the callback of closure doesn't return a value. - 2 + The length of the @param_values array. - a #GValue array holding the instance and the #gfloat parameter + An array of #GValues holding the arguments + on which to invoke the callback of closure. - the invocation hint given as the last argument - to g_closure_invoke() + The invocation hint given as the last argument to + g_closure_invoke(). - additional data specified when registering the marshaller + Additional data specified when registering the + marshaller, see g_closure_set_marshal() and + g_closure_set_meta_marshal() @@ -11134,41 +11372,45 @@ denotes a flags type. - A marshaller for a #GCClosure with a callback of type -`void (*callback) (gpointer instance, gint arg1, gpointer user_data)`. + A #GClosureMarshal function for use with signals with a single +integer argument. - the #GClosure to which the marshaller belongs + A #GClosure. - ignored + A #GValue to store the return value. May be %NULL + if the callback of closure doesn't return a value. - 2 + The length of the @param_values array. - a #GValue array holding the instance and the #gint parameter + An array of #GValues holding the arguments + on which to invoke the callback of closure. - the invocation hint given as the last argument - to g_closure_invoke() + The invocation hint given as the last argument to + g_closure_invoke(). - additional data specified when registering the marshaller + Additional data specified when registering the + marshaller, see g_closure_set_marshal() and + g_closure_set_meta_marshal() @@ -11176,41 +11418,45 @@ denotes a flags type. - A marshaller for a #GCClosure with a callback of type -`void (*callback) (gpointer instance, glong arg1, gpointer user_data)`. + A #GClosureMarshal function for use with signals with with a single +long integer argument. - the #GClosure to which the marshaller belongs + A #GClosure. - ignored + A #GValue to store the return value. May be %NULL + if the callback of closure doesn't return a value. - 2 + The length of the @param_values array. - a #GValue array holding the instance and the #glong parameter + An array of #GValues holding the arguments + on which to invoke the callback of closure. - the invocation hint given as the last argument - to g_closure_invoke() + The invocation hint given as the last argument to + g_closure_invoke(). - additional data specified when registering the marshaller + Additional data specified when registering the + marshaller, see g_closure_set_marshal() and + g_closure_set_meta_marshal() @@ -11218,41 +11464,45 @@ denotes a flags type. - A marshaller for a #GCClosure with a callback of type -`void (*callback) (gpointer instance, GObject *arg1, gpointer user_data)`. + A #GClosureMarshal function for use with signals with a single +#GObject argument. - the #GClosure to which the marshaller belongs + A #GClosure. - ignored + A #GValue to store the return value. May be %NULL + if the callback of closure doesn't return a value. - 2 + The length of the @param_values array. - a #GValue array holding the instance and the #GObject* parameter + An array of #GValues holding the arguments + on which to invoke the callback of closure. - the invocation hint given as the last argument - to g_closure_invoke() + The invocation hint given as the last argument to + g_closure_invoke(). - additional data specified when registering the marshaller + Additional data specified when registering the + marshaller, see g_closure_set_marshal() and + g_closure_set_meta_marshal() @@ -11260,41 +11510,45 @@ denotes a flags type. - A marshaller for a #GCClosure with a callback of type -`void (*callback) (gpointer instance, GParamSpec *arg1, gpointer user_data)`. + A #GClosureMarshal function for use with signals with a single +argument of type #GParamSpec. - the #GClosure to which the marshaller belongs + A #GClosure. - ignored + A #GValue to store the return value. May be %NULL + if the callback of closure doesn't return a value. - 2 + The length of the @param_values array. - a #GValue array holding the instance and the #GParamSpec* parameter + An array of #GValues holding the arguments + on which to invoke the callback of closure. - the invocation hint given as the last argument - to g_closure_invoke() + The invocation hint given as the last argument to + g_closure_invoke(). - additional data specified when registering the marshaller + Additional data specified when registering the + marshaller, see g_closure_set_marshal() and + g_closure_set_meta_marshal() @@ -11302,41 +11556,49 @@ denotes a flags type. - A marshaller for a #GCClosure with a callback of type -`void (*callback) (gpointer instance, gpointer arg1, gpointer user_data)`. + A #GClosureMarshal function for use with signals with a single raw +pointer argument type. + +If it is possible, it is better to use one of the more specific +functions such as g_cclosure_marshal_VOID__OBJECT() or +g_cclosure_marshal_VOID__OBJECT(). - the #GClosure to which the marshaller belongs + A #GClosure. - ignored + A #GValue to store the return value. May be %NULL + if the callback of closure doesn't return a value. - 2 + The length of the @param_values array. - a #GValue array holding the instance and the #gpointer parameter + An array of #GValues holding the arguments + on which to invoke the callback of closure. - the invocation hint given as the last argument - to g_closure_invoke() + The invocation hint given as the last argument to + g_closure_invoke(). - additional data specified when registering the marshaller + Additional data specified when registering the + marshaller, see g_closure_set_marshal() and + g_closure_set_meta_marshal() @@ -11344,41 +11606,45 @@ denotes a flags type. - A marshaller for a #GCClosure with a callback of type -`void (*callback) (gpointer instance, const gchar *arg1, gpointer user_data)`. + A #GClosureMarshal function for use with signals with a single string +argument. - the #GClosure to which the marshaller belongs + A #GClosure. - ignored + A #GValue to store the return value. May be %NULL + if the callback of closure doesn't return a value. - 2 + The length of the @param_values array. - a #GValue array holding the instance and the #gchar* parameter + An array of #GValues holding the arguments + on which to invoke the callback of closure. - the invocation hint given as the last argument - to g_closure_invoke() + The invocation hint given as the last argument to + g_closure_invoke(). - additional data specified when registering the marshaller + Additional data specified when registering the + marshaller, see g_closure_set_marshal() and + g_closure_set_meta_marshal() @@ -11386,41 +11652,45 @@ denotes a flags type. - A marshaller for a #GCClosure with a callback of type -`void (*callback) (gpointer instance, guchar arg1, gpointer user_data)`. + A #GClosureMarshal function for use with signals with a single +unsigned character argument. - the #GClosure to which the marshaller belongs + A #GClosure. - ignored + A #GValue to store the return value. May be %NULL + if the callback of closure doesn't return a value. - 2 + The length of the @param_values array. - a #GValue array holding the instance and the #guchar parameter + An array of #GValues holding the arguments + on which to invoke the callback of closure. - the invocation hint given as the last argument - to g_closure_invoke() + The invocation hint given as the last argument to + g_closure_invoke(). - additional data specified when registering the marshaller + Additional data specified when registering the + marshaller, see g_closure_set_marshal() and + g_closure_set_meta_marshal() @@ -11428,41 +11698,45 @@ denotes a flags type. - A marshaller for a #GCClosure with a callback of type -`void (*callback) (gpointer instance, guint arg1, gpointer user_data)`. + A #GClosureMarshal function for use with signals with with a single +unsigned integer argument. - the #GClosure to which the marshaller belongs + A #GClosure. - ignored + A #GValue to store the return value. May be %NULL + if the callback of closure doesn't return a value. - 2 + The length of the @param_values array. - a #GValue array holding the instance and the #guint parameter + An array of #GValues holding the arguments + on which to invoke the callback of closure. - the invocation hint given as the last argument - to g_closure_invoke() + The invocation hint given as the last argument to + g_closure_invoke(). - additional data specified when registering the marshaller + Additional data specified when registering the + marshaller, see g_closure_set_marshal() and + g_closure_set_meta_marshal() @@ -11470,41 +11744,45 @@ 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)`. + A #GClosureMarshal function for use with signals with a unsigned int +and a pointer as arguments. - the #GClosure to which the marshaller belongs + A #GClosure. - ignored + A #GValue to store the return value. May be %NULL + if the callback of closure doesn't return a value. - 3 + The length of the @param_values array. - a #GValue array holding instance, arg1 and arg2 + An array of #GValues holding the arguments + on which to invoke the callback of closure. - the invocation hint given as the last argument - to g_closure_invoke() + The invocation hint given as the last argument to + g_closure_invoke(). - additional data specified when registering the marshaller + Additional data specified when registering the + marshaller, see g_closure_set_marshal() and + g_closure_set_meta_marshal() @@ -11512,84 +11790,91 @@ denotes a flags type. - A marshaller for a #GCClosure with a callback of type -`void (*callback) (gpointer instance, gulong arg1, gpointer user_data)`. + A #GClosureMarshal function for use with signals with a single +unsigned long integer argument. - the #GClosure to which the marshaller belongs + A #GClosure. - ignored + A #GValue to store the return value. May be %NULL + if the callback of closure doesn't return a value. - 2 + The length of the @param_values array. - a #GValue array holding the instance and the #gulong parameter + An array of #GValues holding the arguments + on which to invoke the callback of closure. - the invocation hint given as the last argument - to g_closure_invoke() + The invocation hint given as the last argument to + g_closure_invoke(). - additional data specified when registering the marshaller + Additional data specified when registering the + marshaller, see g_closure_set_marshal() and + g_closure_set_meta_marshal() - A marshaller for a #GCClosure with a callback of type -`void (*callback) (gpointer instance, GVariant *arg1, gpointer user_data)`. + moved-to="CClosure.marshal_VOID__VARIANT"> + A #GClosureMarshal function for use with signals with a single +#GVariant argument. - the #GClosure to which the marshaller belongs + A #GClosure. - ignored + A #GValue to store the return value. May be %NULL + if the callback of closure doesn't return a value. - 2 + The length of the @param_values array. - a #GValue array holding the instance and the #GVariant* parameter + An array of #GValues holding the arguments + on which to invoke the callback of closure. - the invocation hint given as the last argument - to g_closure_invoke() + The invocation hint given as the last argument to + g_closure_invoke(). - additional data specified when registering the marshaller + Additional data specified when registering the + marshaller, see g_closure_set_marshal() and + g_closure_set_meta_marshal() @@ -11597,41 +11882,44 @@ denotes a flags type. - A marshaller for a #GCClosure with a callback of type -`void (*callback) (gpointer instance, gpointer user_data)`. + A #GClosureMarshal function for use with signals with no arguments. - the #GClosure to which the marshaller belongs + A #GClosure. - ignored + A #GValue to store the return value. May be %NULL + if the callback of closure doesn't return a value. - 1 + The length of the @param_values array. - a #GValue array holding only the instance + An array of #GValues holding the arguments + on which to invoke the callback of closure. - the invocation hint given as the last argument - to g_closure_invoke() + The invocation hint given as the last argument to + g_closure_invoke(). - additional data specified when registering the marshaller + Additional data specified when registering the + marshaller, see g_closure_set_marshal() and + g_closure_set_meta_marshal() @@ -11952,6 +12240,28 @@ definition than to write one yourself using g_enum_register_static(). + + Pretty-prints @value in the form of the enum’s name. + +This is intended to be used for debugging purposes. The format of the output +may change in the future. + + a newly-allocated text string + + + + + the type identifier of a #GEnumClass type + + + + the value + + + + This function is meant to be called from the complete_type_info() @@ -12061,6 +12371,29 @@ definition than to write one yourself using g_flags_register_static(). + + Pretty-prints @value in the form of the flag names separated by ` | ` and +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 + + + + + the type identifier of a #GFlagsClass type + + + + the value + + + + @@ -13229,7 +13562,7 @@ g_signal_override_class_handler(). c:identifier="g_signal_connect_closure"> Connects a closure to a signal for a particular object. - the handler id (always greater than 0 for successful connections) + the handler ID (always greater than 0 for successful connections) @@ -13256,7 +13589,7 @@ g_signal_override_class_handler(). c:identifier="g_signal_connect_closure_by_id"> Connects a closure to a signal for a particular object. - the handler id (always greater than 0 for successful connections) + the handler ID (always greater than 0 for successful connections) @@ -13292,7 +13625,7 @@ 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) + the handler ID (always greater than 0 for successful connections) @@ -13606,7 +13939,7 @@ If no handler was found, 0 is returned. - Returns whether @handler_id is the id of a handler connected to @instance. + Returns whether @handler_id is the ID of a handler connected to @instance. whether @handler_id identifies a handler connected to @instance. @@ -13617,7 +13950,7 @@ If no handler was found, 0 is returned. - the handler id. + the handler ID.