tauri-apps/archived-gir-files
1
0
Fork 0
mirror of https://github.com/tauri-apps/gir-files.git synced 2026-01-31 00:45:15 +01:00
Code Issues Packages Projects Releases Wiki Activity

Update GIR files

Browse Source
This commit is contained in:
sdroege
2022-07-17 01:30:10 +00:00
committed by GitHub
parent faebfb303c
commit 7a02fc59ff
11 changed files with 2720 additions and 216 deletions
Download Patch File Download Diff File Expand all files Collapse all files

6
Atk-1.0.gir
View File

@@ -544,7 +544,7 @@ A string name/value pair representing a generic attribute.</doc>
</parameters>
</function>
</record>
<constant name="BINARY_AGE" value="24410" c:type="ATK_BINARY_AGE" version="2.7.4">
<constant name="BINARY_AGE" value="24511" c:type="ATK_BINARY_AGE" version="2.7.4">
<doc xml:space="preserve">Like atk_get_binary_age(), but from the headers used at
application compile time, rather than from the library linked
against at application run time.</doc>
@@ -4539,13 +4539,13 @@ application compile time, rather than from the library linked
against at application run time.</doc>
<type name="gint" c:type="gint"/>
</constant>
<constant name="MICRO_VERSION" value="0" c:type="ATK_MICRO_VERSION" version="2.7.4">
<constant name="MICRO_VERSION" value="1" c:type="ATK_MICRO_VERSION" version="2.7.4">
<doc xml:space="preserve">Like atk_get_micro_version(), but from the headers used at
application compile time, rather than from the library linked
against at application run time.</doc>
<type name="gint" c:type="gint"/>
</constant>
<constant name="MINOR_VERSION" value="44" c:type="ATK_MINOR_VERSION" version="2.7.4">
<constant name="MINOR_VERSION" value="45" c:type="ATK_MINOR_VERSION" version="2.7.4">
<doc xml:space="preserve">Like atk_get_minor_version(), but from the headers used at
application compile time, rather than from the library linked
against at application run time.</doc>

451
GLib-2.0.gir
View File

@@ -3361,8 +3361,10 @@ data is copied.</doc>
</method>
</record>
<function-macro name="CHECK_VERSION" c:identifier="GLIB_CHECK_VERSION" introspectable="0">
<doc xml:space="preserve">Checks the version of the GLib library that is being compiled
against. See glib_check_version() for a runtime check.</doc>
<doc xml:space="preserve">Checks whether the version of the GLib library that is being compiled
against is greater than or equal to the given one.
See glib_check_version() for a runtime check.</doc>
<parameters>
<parameter name="major">
<doc xml:space="preserve">the major version to check for</doc>
@@ -3946,7 +3948,7 @@ when doing a deep-copy of a tree.</doc>
<doc xml:space="preserve">A pointer to the data which should be copied</doc>
<type name="gpointer" c:type="gconstpointer"/>
</parameter>
<parameter name="data" transfer-ownership="none" nullable="1" allow-none="1">
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="1">
<doc xml:space="preserve">Additional data</doc>
<type name="gpointer" c:type="gpointer"/>
</parameter>
@@ -6350,7 +6352,8 @@ The following format specifiers are supported:
- \%c: the preferred date and time representation for the current locale
- \%C: the century number (year/100) as a 2-digit integer (00-99)
- \%d: the day of the month as a decimal number (range 01 to 31)
- \%e: the day of the month as a decimal number (range 1 to 31)
- \%e: the day of the month as a decimal number (range 1 to 31);
single digits are preceded by a figure space
- \%F: equivalent to `%Y-%m-%d` (the ISO 8601 date format)
- \%g: the last two digits of the ISO 8601 week-based year as a
decimal number (00-99). This works well with \%V and \%u.
@@ -6361,9 +6364,9 @@ The following format specifiers are supported:
- \%I: the hour as a decimal number using a 12-hour clock (range 01 to 12)
- \%j: the day of the year as a decimal number (range 001 to 366)
- \%k: the hour (24-hour clock) as a decimal number (range 0 to 23);
single digits are preceded by a blank
single digits are preceded by a figure space
- \%l: the hour (12-hour clock) as a decimal number (range 1 to 12);
single digits are preceded by a blank
single digits are preceded by a figure space
- \%m: the month as a decimal number (range 01 to 12)
- \%M: the minute as a decimal number (range 00 to 59)
- \%f: the microsecond as a decimal number (range 000000 to 999999)
@@ -9699,7 +9702,7 @@ by g_hook_list_invoke_check().</doc>
<doc xml:space="preserve">a #GHook</doc>
<type name="Hook" c:type="GHook*"/>
</parameter>
<parameter name="marshal_data" transfer-ownership="none" nullable="1" allow-none="1">
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="1">
<doc xml:space="preserve">user data</doc>
<type name="gpointer" c:type="gpointer"/>
</parameter>
@@ -9751,7 +9754,7 @@ list of hooks gets finalized.</doc>
<doc xml:space="preserve">a #GHook</doc>
<type name="Hook" c:type="GHook*"/>
</parameter>
<parameter name="data" transfer-ownership="none" nullable="1" allow-none="1">
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="1">
<doc xml:space="preserve">user data passed to g_hook_find_func()</doc>
<type name="gpointer" c:type="gpointer"/>
</parameter>
@@ -9947,7 +9950,7 @@ function returns %FALSE.</doc>
<doc xml:space="preserve">a #GHook</doc>
<type name="Hook" c:type="GHook*"/>
</parameter>
<parameter name="marshal_data" transfer-ownership="none" nullable="1" allow-none="1">
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="1">
<doc xml:space="preserve">user data</doc>
<type name="gpointer" c:type="gpointer"/>
</parameter>
@@ -10940,6 +10943,9 @@ g_io_channel_read(), g_io_channel_write(), and g_io_channel_seek().</doc>
<doc xml:space="preserve">Specifies properties of a #GIOChannel. Some of the flags can only be
read with g_io_channel_get_flags(), but not changed with
g_io_channel_set_flags().</doc>
<member name="none" value="0" c:identifier="G_IO_FLAG_NONE">
<doc xml:space="preserve">no special flags set. Since: 2.74</doc>
</member>
<member name="append" value="1" c:identifier="G_IO_FLAG_APPEND">
<doc xml:space="preserve">turns on append mode, corresponds to %O_APPEND
(see the documentation of the UNIX open() syscall)</doc>
@@ -10997,7 +11003,7 @@ on a #GIOChannel is satisfied.</doc>
<doc xml:space="preserve">the condition which has been satisfied</doc>
<type name="IOCondition" c:type="GIOCondition"/>
</parameter>
<parameter name="data" transfer-ownership="none" nullable="1" allow-none="1">
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="2">
<doc xml:space="preserve">user data set in g_io_add_watch() or g_io_add_watch_full()</doc>
<type name="gpointer" c:type="gpointer"/>
</parameter>
@@ -13863,7 +13869,7 @@ linked against at application run time.</doc>
<doc xml:space="preserve">The maximum value which can be held in a #guint8.</doc>
<type name="guint8" c:type="guint8"/>
</constant>
<constant name="MICRO_VERSION" value="0" c:type="GLIB_MICRO_VERSION">
<constant name="MICRO_VERSION" value="2" c:type="GLIB_MICRO_VERSION">
<doc xml:space="preserve">The micro version number of the GLib library.
Like #gtk_micro_version, but from the headers used at
@@ -15264,6 +15270,9 @@ drops to 0, it is freed.</doc>
</record>
<bitfield name="MarkupParseFlags" c:type="GMarkupParseFlags">
<doc xml:space="preserve">Flags that affect the behaviour of the parser.</doc>
<member name="parse_flags_none" value="0" c:identifier="G_MARKUP_PARSE_FLAGS_NONE">
<doc xml:space="preserve">No special behaviour. Since: 2.74</doc>
</member>
<member name="do_not_use_this_unsupported_flag" value="1" c:identifier="G_MARKUP_DO_NOT_USE_THIS_UNSUPPORTED_FLAG">
<doc xml:space="preserve">flag you should not use</doc>
</member>
@@ -15907,16 +15916,14 @@ A #GMutex should only be accessed via g_mutex_ functions.</doc>
<type name="guint" c:type="guint"/>
</array>
</field>
<method name="clear" c:identifier="g_mutex_clear">
<method name="clear" c:identifier="g_mutex_clear" version="2.32">
<doc xml:space="preserve">Frees the resources allocated to a mutex with g_mutex_init().
This function should not be used with a #GMutex that has been
statically allocated.
Calling g_mutex_clear() on a locked mutex leads to undefined
behaviour.
Sine: 2.32</doc>
behaviour.</doc>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
@@ -16565,7 +16572,7 @@ data passed to g_node_children_foreach().</doc>
<doc xml:space="preserve">a #GNode.</doc>
<type name="Node" c:type="GNode*"/>
</parameter>
<parameter name="data" transfer-ownership="none" nullable="1" allow-none="1">
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="1">
<doc xml:space="preserve">user data passed to g_node_children_foreach().</doc>
<type name="gpointer" c:type="gpointer"/>
</parameter>
@@ -16585,7 +16592,7 @@ user data passed to g_node_traverse(). If the function returns
<doc xml:space="preserve">a #GNode.</doc>
<type name="Node" c:type="GNode*"/>
</parameter>
<parameter name="data" transfer-ownership="none" nullable="1" allow-none="1">
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="1">
<doc xml:space="preserve">user data passed to g_node_traverse().</doc>
<type name="gpointer" c:type="gpointer"/>
</parameter>
@@ -16818,9 +16825,9 @@ options.</doc>
<doc xml:space="preserve">The value to be parsed.</doc>
<type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="data" transfer-ownership="none" nullable="1" allow-none="1">
<doc xml:space="preserve">User data added to the #GOptionGroup containing the option when it
was created with g_option_group_new()</doc>
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="2">
<doc xml:space="preserve">User data added to the #GOptionGroup containing the option when
it was created with g_option_group_new()</doc>
<type name="gpointer" c:type="gpointer"/>
</parameter>
</parameters>
@@ -17399,9 +17406,9 @@ or g_option_group_add_entries().</doc>
<doc xml:space="preserve">The group to which the function belongs</doc>
<type name="OptionGroup" c:type="GOptionGroup*"/>
</parameter>
<parameter name="data" transfer-ownership="none" nullable="1" allow-none="1">
<doc xml:space="preserve">User data added to the #GOptionGroup containing the option when it
was created with g_option_group_new()</doc>
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="2">
<doc xml:space="preserve">User data added to the #GOptionGroup containing the option when
it was created with g_option_group_new()</doc>
<type name="gpointer" c:type="gpointer"/>
</parameter>
</parameters>
@@ -17659,9 +17666,9 @@ and all memory allocated by the @group is released.</doc>
<doc xml:space="preserve">The group to which the function belongs</doc>
<type name="OptionGroup" c:type="GOptionGroup*"/>
</parameter>
<parameter name="data" transfer-ownership="none" nullable="1" allow-none="1">
<doc xml:space="preserve">User data added to the #GOptionGroup containing the option when it
was created with g_option_group_new()</doc>
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="2">
<doc xml:space="preserve">User data added to the #GOptionGroup containing the option when
it was created with g_option_group_new()</doc>
<type name="gpointer" c:type="gpointer"/>
</parameter>
</parameters>
@@ -18091,7 +18098,8 @@ If @func is %NULL, then only the pointers (and not what they are
pointing to) are copied to the new #GPtrArray.
The copy of @array will have the same #GDestroyNotify for its elements as
@array.</doc>
@array. The copy will also be %NULL terminated if (and only if) the source
array is.</doc>
<return-value transfer-ownership="full">
<doc xml:space="preserve">a deep copy of the initial #GPtrArray.</doc>
<array name="GLib.PtrArray" c:type="GPtrArray*">
@@ -18127,7 +18135,9 @@ may get compiler warnings from this though if compiling with GCC&#x2019;s
`-Wcast-function-type` warning.
If @func is %NULL, then only the pointers (and not what they are
pointing to) are copied to the new #GPtrArray.</doc>
pointing to) are copied to the new #GPtrArray.
Whether @array_to_extend is %NULL terminated stays unchanged by this function.</doc>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
@@ -18284,6 +18294,10 @@ If array contents point to dynamically-allocated memory, they should
be freed separately if @free_seg is %TRUE and no #GDestroyNotify
function has been set for @array.
Note that if the array is %NULL terminated and @free_seg is %FALSE
then this will always return an allocated %NULL terminated buffer.
If pdata is previously %NULL, a new buffer will be allocated.
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.</doc>
@@ -18328,6 +18342,26 @@ array will grow in size automatically if necessary.</doc>
</parameter>
</parameters>
</function>
<function name="is_null_terminated" c:identifier="g_ptr_array_is_null_terminated" version="2.74" introspectable="0">
<doc xml:space="preserve">Gets whether the @array was constructed as %NULL-terminated.
This will only return %TRUE for arrays constructed by passing %TRUE to the
`null_terminated` argument of g_ptr_array_new_null_terminated(). It will not
return %TRUE for normal arrays which have had a %NULL element appended to
them.</doc>
<return-value transfer-ownership="none">
<doc xml:space="preserve">%TRUE if the array is made to be %NULL terminated.</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
<parameter name="array" transfer-ownership="none">
<doc xml:space="preserve">the #GPtrArray</doc>
<array name="GLib.PtrArray" c:type="GPtrArray*">
<type name="gpointer" c:type="gpointer"/>
</array>
</parameter>
</parameters>
</function>
<function name="new" c:identifier="g_ptr_array_new" introspectable="0">
<doc xml:space="preserve">Creates a new #GPtrArray with a reference count of 1.</doc>
<return-value>
@@ -18345,7 +18379,7 @@ the size of the array is still 0. It also set @element_free_func
for freeing each element when the array is destroyed either via
g_ptr_array_unref(), when g_ptr_array_free() is called with
@free_segment set to %TRUE or when removing elements.</doc>
<return-value>
<return-value transfer-ownership="full">
<doc xml:space="preserve">A new #GPtrArray</doc>
<array name="GLib.PtrArray" c:type="GPtrArray*">
<type name="gpointer" c:type="gpointer"/>
@@ -18363,12 +18397,53 @@ g_ptr_array_unref(), when g_ptr_array_free() is called with
</parameter>
</parameters>
</function>
<function name="new_null_terminated" c:identifier="g_ptr_array_new_null_terminated" version="2.74" introspectable="0">
<doc xml:space="preserve">Like g_ptr_array_new_full() but also allows to set the array to
be %NULL terminated. A %NULL terminated pointer array has an
additional %NULL pointer after the last element, beyond the
current length.
#GPtrArray created by other constructors are not automatically %NULL
terminated.
Note that if the @array's length is zero and currently no
data array is allocated, then pdata will still be %NULL.
%GPtrArray will only %NULL terminate pdata, if an actual
array is allocated. It does not guarantee that an array
is always allocated. In other words, if the length is zero,
then pdata may either point to a %NULL terminated array of length
zero or be %NULL.</doc>
<return-value transfer-ownership="full">
<doc xml:space="preserve">A new #GPtrArray</doc>
<array name="GLib.PtrArray" c:type="GPtrArray*">
<type name="gpointer" c:type="gpointer"/>
</array>
</return-value>
<parameters>
<parameter name="reserved_size" transfer-ownership="none">
<doc xml:space="preserve">number of pointers preallocated.
If @null_terminated is %TRUE, the actually allocated
buffer size is @reserved_size plus 1, unless @reserved_size
is zero, in which case no initial buffer gets allocated.</doc>
<type name="guint" c:type="guint"/>
</parameter>
<parameter name="element_free_func" transfer-ownership="none" nullable="1" allow-none="1" scope="async">
<doc xml:space="preserve">A function to free elements with
destroy @array or %NULL</doc>
<type name="DestroyNotify" c:type="GDestroyNotify"/>
</parameter>
<parameter name="null_terminated" transfer-ownership="none">
<doc xml:space="preserve">whether to make the array as %NULL terminated.</doc>
<type name="gboolean" c:type="gboolean"/>
</parameter>
</parameters>
</function>
<function name="new_with_free_func" c:identifier="g_ptr_array_new_with_free_func" version="2.22" introspectable="0">
<doc xml:space="preserve">Creates a new #GPtrArray with a reference count of 1 and use
@element_free_func for freeing each element when the array is destroyed
either via g_ptr_array_unref(), when g_ptr_array_free() is called with
@free_segment set to %TRUE or when removing elements.</doc>
<return-value>
<return-value transfer-ownership="full">
<doc xml:space="preserve">A new #GPtrArray</doc>
<array name="GLib.PtrArray" c:type="GPtrArray*">
<type name="gpointer" c:type="gpointer"/>
@@ -18719,6 +18794,10 @@ This is guaranteed to be a stable sort since version 2.32.</doc>
the underlying array is preserved for use elsewhere and returned
to the caller.
Note that if the array is %NULL terminated this may still return
%NULL if the length of the array was zero and pdata was not yet
allocated.
Even if set, the #GDestroyNotify function will never be called
on the current contents of the array and the caller is
responsible for freeing the array elements.
@@ -18757,7 +18836,8 @@ g_assert (chunk_buffer-&gt;len == 0);
]|</doc>
<return-value transfer-ownership="full" nullable="1">
<doc xml:space="preserve">the element data, which should be
freed using g_free().</doc>
freed using g_free(). This may be %NULL if the array doesn&#x2019;t have any
elements (i.e. if `*len` is zero).</doc>
<type name="gpointer" c:type="gpointer*"/>
</return-value>
<parameters>
@@ -19719,16 +19799,14 @@ A GRWLock should only be accessed with the g_rw_lock_ functions.</doc>
<type name="guint" c:type="guint"/>
</array>
</field>
<method name="clear" c:identifier="g_rw_lock_clear">
<method name="clear" c:identifier="g_rw_lock_clear" version="2.32">
<doc xml:space="preserve">Frees the resources allocated to a lock with g_rw_lock_init().
This function should not be used with a #GRWLock that has been
statically allocated.
Calling g_rw_lock_clear() when any thread holds the lock
leads to undefined behaviour.
Sine: 2.32</doc>
leads to undefined behaviour.</doc>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
@@ -20085,7 +20163,7 @@ g_rec_mutex_ functions.</doc>
<type name="guint" c:type="guint"/>
</array>
</field>
<method name="clear" c:identifier="g_rec_mutex_clear">
<method name="clear" c:identifier="g_rec_mutex_clear" version="2.32">
<doc xml:space="preserve">Frees the resources allocated to a recursive mutex with
g_rec_mutex_init().
@@ -20093,9 +20171,7 @@ This function should not be used with a #GRecMutex that has been
statically allocated.
Calling g_rec_mutex_clear() on a locked recursive mutex leads
to undefined behaviour.
Sine: 2.32</doc>
to undefined behaviour.</doc>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
@@ -20424,7 +20500,7 @@ print_uppercase_words (const gchar *string)
GRegex *regex;
GMatchInfo *match_info;
regex = g_regex_new ("[A-Z]+", 0, 0, NULL);
regex = g_regex_new ("[A-Z]+", G_REGEX_DEFAULT, G_REGEX_MATCH_DEFAULT, NULL);
g_regex_match (regex, string, 0, &amp;match_info);
while (g_match_info_matches (match_info))
{
@@ -20611,7 +20687,7 @@ print_uppercase_words (const gchar *string)
GMatchInfo *match_info;
GError *error = NULL;
regex = g_regex_new ("[A-Z]+", 0, 0, NULL);
regex = g_regex_new ("[A-Z]+", G_REGEX_DEFAULT, G_REGEX_MATCH_DEFAULT, NULL);
g_regex_match_full (regex, string, -1, 0, 0, &amp;match_info, &amp;error);
while (g_match_info_matches (match_info))
{
@@ -20776,7 +20852,7 @@ g_hash_table_insert (h, "2", "TWO");
g_hash_table_insert (h, "3", "THREE");
g_hash_table_insert (h, "4", "FOUR");
reg = g_regex_new ("1|2|3|4", 0, 0, NULL);
reg = g_regex_new ("1|2|3|4", G_REGEX_DEFAULT, G_REGEX_MATCH_DEFAULT, NULL);
res = g_regex_replace_eval (reg, text, -1, 0, 0, eval_cb, h, NULL);
g_hash_table_destroy (h);
@@ -21141,6 +21217,9 @@ it using g_strfreev()</doc>
</record>
<bitfield name="RegexCompileFlags" version="2.14" c:type="GRegexCompileFlags">
<doc xml:space="preserve">Flags specifying compile-time options.</doc>
<member name="default" value="0" c:identifier="G_REGEX_DEFAULT">
<doc xml:space="preserve">No special options set. Since: 2.74</doc>
</member>
<member name="caseless" value="1" c:identifier="G_REGEX_CASELESS">
<doc xml:space="preserve">Letters in the pattern match both upper- and
lowercase letters. This option can be changed within a pattern
@@ -21205,7 +21284,9 @@ it using g_strfreev()</doc>
<member name="optimize" value="8192" c:identifier="G_REGEX_OPTIMIZE">
<doc xml:space="preserve">Optimize the regular expression. If the pattern will
be used many times, then it may be worth the effort to optimize it
to improve the speed of matches.</doc>
to improve the speed of matches. Deprecated in GLib 2.74 which now uses
libpcre2, which doesn&#x2019;t require separate optimization of queries. This
option is now a no-op. Deprecated: 2.74</doc>
</member>
<member name="firstline" value="262144" c:identifier="G_REGEX_FIRSTLINE">
<doc xml:space="preserve">Limits an unanchored pattern to match before (or at) the
@@ -21244,7 +21325,8 @@ it using g_strfreev()</doc>
</member>
<member name="javascript_compat" value="33554432" c:identifier="G_REGEX_JAVASCRIPT_COMPAT">
<doc xml:space="preserve">Changes behaviour so that it is compatible with
JavaScript rather than PCRE. Since: 2.34</doc>
JavaScript rather than PCRE. Since GLib 2.74 this is no longer supported,
as libpcre2 does not support it. Since: 2.34 Deprecated: 2.74</doc>
</member>
</bitfield>
<enumeration name="RegexError" version="2.14" c:type="GRegexError" glib:error-domain="g-regex-error-quark">
@@ -21492,6 +21574,9 @@ to g_regex_replace_eval(), and it should append the replacement to
</callback>
<bitfield name="RegexMatchFlags" version="2.14" c:type="GRegexMatchFlags">
<doc xml:space="preserve">Flags specifying match-time options.</doc>
<member name="default" value="0" c:identifier="G_REGEX_MATCH_DEFAULT">
<doc xml:space="preserve">No special options set. Since: 2.74</doc>
</member>
<member name="anchored" value="16" c:identifier="G_REGEX_MATCH_ANCHORED">
<doc xml:space="preserve">The pattern is forced to be "anchored", that is,
it is constrained to match only at the first matching point in the
@@ -24016,7 +24101,7 @@ if @a comes before @b, and a positive value if @b comes before @a.</doc>
<doc xml:space="preserve">a #GSequenceIter</doc>
<type name="SequenceIter" c:type="GSequenceIter*"/>
</parameter>
<parameter name="data" transfer-ownership="none" nullable="1" allow-none="1">
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="2">
<doc xml:space="preserve">user data</doc>
<type name="gpointer" c:type="gpointer"/>
</parameter>
@@ -25156,6 +25241,22 @@ required condition has been met, and returns %TRUE if so.</doc>
<type name="SourceDummyMarshal" c:type="GSourceDummyMarshal"/>
</field>
</record>
<callback name="SourceOnceFunc" c:type="GSourceOnceFunc" version="2.74">
<doc xml:space="preserve">A source function that is only called once before being removed from the main
context automatically.
See: g_idle_add_once(), g_timeout_add_once()</doc>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
<parameters>
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="0">
<doc xml:space="preserve">data passed to the function, set when the source was
created</doc>
<type name="gpointer" c:type="gpointer"/>
</parameter>
</parameters>
</callback>
<record name="SourcePrivate" c:type="GSourcePrivate" disguised="1"/>
<callback name="SpawnChildSetupFunc" c:type="GSpawnChildSetupFunc">
<doc xml:space="preserve">Specifies the type of the setup function passed to g_spawn_async(),
@@ -25310,6 +25411,15 @@ list to the `g_spawn...` function.</doc>
<doc xml:space="preserve">create all pipes with the `O_CLOEXEC` flag set.
Since: 2.40</doc>
</member>
<member name="child_inherits_stdout" value="512" c:identifier="G_SPAWN_CHILD_INHERITS_STDOUT" version="2.74">
<doc xml:space="preserve">The child will inherit the parent's standard output.</doc>
</member>
<member name="child_inherits_stderr" value="1024" c:identifier="G_SPAWN_CHILD_INHERITS_STDERR" version="2.74">
<doc xml:space="preserve">The child will inherit the parent's standard error.</doc>
</member>
<member name="stdin_from_dev_null" value="2048" c:identifier="G_SPAWN_STDIN_FROM_DEV_NULL" version="2.74">
<doc xml:space="preserve">The child's standard input is attached to `/dev/null`.</doc>
</member>
</bitfield>
<record name="StatBuf" c:type="GStatBuf" disguised="1">
<doc xml:space="preserve">A type corresponding to the appropriate struct type for the stat()
@@ -26640,18 +26750,21 @@ zero then @fixture will be equal to @user_data.</doc>
Note that in contrast with g_test_trap_fork(), the default is to
not show stdout and stderr.</doc>
<member name="stdin" value="1" c:identifier="G_TEST_SUBPROCESS_INHERIT_STDIN">
<member name="default" value="0" c:identifier="G_TEST_SUBPROCESS_DEFAULT">
<doc xml:space="preserve">Default behaviour. Since: 2.74</doc>
</member>
<member name="inherit_stdin" value="1" c:identifier="G_TEST_SUBPROCESS_INHERIT_STDIN">
<doc xml:space="preserve">If this flag is given, the child
process will inherit the parent's stdin. Otherwise, the child's
stdin is redirected to `/dev/null`.</doc>
</member>
<member name="stdout" value="2" c:identifier="G_TEST_SUBPROCESS_INHERIT_STDOUT">
<member name="inherit_stdout" value="2" c:identifier="G_TEST_SUBPROCESS_INHERIT_STDOUT">
<doc xml:space="preserve">If this flag is given, the child
process will inherit the parent's stdout. Otherwise, the child's
stdout will not be visible, but it will be captured to allow
later tests with g_test_trap_assert_stdout().</doc>
</member>
<member name="stderr" value="4" c:identifier="G_TEST_SUBPROCESS_INHERIT_STDERR">
<member name="inherit_stderr" value="4" c:identifier="G_TEST_SUBPROCESS_INHERIT_STDERR">
<doc xml:space="preserve">If this flag is given, the child
process will inherit the parent's stderr. Otherwise, the child's
stderr will not be visible, but it will be captured to allow
@@ -26711,6 +26824,9 @@ These flags determine what traps to set.</doc>
<doc-deprecated xml:space="preserve">#GTestTrapFlags is used only with g_test_trap_fork(),
which is deprecated. g_test_trap_subprocess() uses
#GTestSubprocessFlags.</doc-deprecated>
<member name="default" value="0" c:identifier="G_TEST_TRAP_DEFAULT">
<doc xml:space="preserve">Default behaviour. Since: 2.74</doc>
</member>
<member name="silence_stdout" value="128" c:identifier="G_TEST_TRAP_SILENCE_STDOUT">
<doc xml:space="preserve">Redirect stdout of the test child to
`/dev/null` so it cannot be observed on the console during test
@@ -26942,7 +27058,7 @@ or g_thread_try_new().</doc>
<type name="gpointer" c:type="gpointer"/>
</return-value>
<parameters>
<parameter name="data" transfer-ownership="none" nullable="1" allow-none="1">
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="0">
<doc xml:space="preserve">data passed to the thread</doc>
<type name="gpointer" c:type="gpointer"/>
</parameter>
@@ -28052,7 +28168,7 @@ strings, for &lt;option&gt;--help&lt;/option&gt; output.</doc>
<doc xml:space="preserve">the untranslated string</doc>
<type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="data" transfer-ownership="none" nullable="1" allow-none="1">
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="1">
<doc xml:space="preserve">user data specified when installing the function, e.g.
in g_option_group_set_translate_func()</doc>
<type name="gpointer" c:type="gpointer"/>
@@ -28177,7 +28293,7 @@ parameter passed to g_tree_traverse(). If the function returns
<doc xml:space="preserve">the value corresponding to the key</doc>
<type name="gpointer" c:type="gpointer"/>
</parameter>
<parameter name="data" transfer-ownership="none" nullable="1" allow-none="1">
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="2">
<doc xml:space="preserve">user data passed to g_tree_traverse()</doc>
<type name="gpointer" c:type="gpointer"/>
</parameter>
@@ -28197,7 +28313,7 @@ stopped.</doc>
<doc xml:space="preserve">a #GTreeNode</doc>
<type name="TreeNode" c:type="GTreeNode*"/>
</parameter>
<parameter name="data" transfer-ownership="none" nullable="1" allow-none="1">
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="1">
<doc xml:space="preserve">user data passed to g_tree_foreach_node()</doc>
<type name="gpointer" c:type="gpointer"/>
</parameter>
@@ -34518,7 +34634,7 @@ returned.
If the key is found and the value has the correct type, it is
returned. If @expected_type was specified then any non-%NULL return
value will have this type.</doc>
<return-value transfer-ownership="full">
<return-value transfer-ownership="full" nullable="1">
<doc xml:space="preserve">the value of the dictionary key, or %NULL</doc>
<type name="Variant" c:type="GVariant*"/>
</return-value>
@@ -37557,6 +37673,42 @@ the pointer passed to it should not be `volatile`.</doc>
</parameter>
</parameters>
</function>
<function name="atomic_int_compare_and_exchange_full" c:identifier="g_atomic_int_compare_and_exchange_full" version="2.74">
<doc xml:space="preserve">Compares @atomic to @oldval and, if equal, sets it to @newval.
If @atomic was not equal to @oldval then no change occurs.
In any case the value of @atomic before this operation is stored in @preval.
This compare and exchange is done atomically.
Think of this operation as an atomic version of
`{ *preval = *atomic; if (*atomic == oldval) { *atomic = newval; return TRUE; } else return FALSE; }`.
This call acts as a full compiler and hardware memory barrier.
See also g_atomic_int_compare_and_exchange()</doc>
<return-value transfer-ownership="none">
<doc xml:space="preserve">%TRUE if the exchange took place</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
<parameter name="atomic" transfer-ownership="none">
<doc xml:space="preserve">a pointer to a #gint or #guint</doc>
<type name="gint" c:type="gint*"/>
</parameter>
<parameter name="oldval" transfer-ownership="none">
<doc xml:space="preserve">the value to compare with</doc>
<type name="gint" c:type="gint"/>
</parameter>
<parameter name="newval" transfer-ownership="none">
<doc xml:space="preserve">the value to conditionally replace with</doc>
<type name="gint" c:type="gint"/>
</parameter>
<parameter name="preval" direction="out" caller-allocates="0" transfer-ownership="full">
<doc xml:space="preserve">the contents of @atomic before this operation</doc>
<type name="gint" c:type="gint*"/>
</parameter>
</parameters>
</function>
<function name="atomic_int_dec_and_test" c:identifier="g_atomic_int_dec_and_test" version="2.4">
<doc xml:space="preserve">Decrements the value of @atomic by 1.
@@ -37578,6 +37730,30 @@ the pointer passed to it should not be `volatile`.</doc>
</parameter>
</parameters>
</function>
<function name="atomic_int_exchange" c:identifier="g_atomic_int_exchange" version="2.74">
<doc xml:space="preserve">Sets the @atomic to @newval and returns the old value from @atomic.
This exchange is done atomically.
Think of this operation as an atomic version of
`{ tmp = *atomic; *atomic = val; return tmp; }`.
This call acts as a full compiler and hardware memory barrier.</doc>
<return-value transfer-ownership="none">
<doc xml:space="preserve">the value of @atomic before the exchange, signed</doc>
<type name="gint" c:type="gint"/>
</return-value>
<parameters>
<parameter name="atomic" transfer-ownership="none">
<doc xml:space="preserve">a pointer to a #gint or #guint</doc>
<type name="gint" c:type="gint*"/>
</parameter>
<parameter name="newval" transfer-ownership="none">
<doc xml:space="preserve">the value to replace with</doc>
<type name="gint" c:type="gint"/>
</parameter>
</parameters>
</function>
<function name="atomic_int_exchange_and_add" c:identifier="g_atomic_int_exchange_and_add" version="2.4" deprecated="1" deprecated-version="2.30">
<doc xml:space="preserve">This function existed before g_atomic_int_add() returned the prior
value of the integer (which it now does). It is retained only for
@@ -37830,6 +38006,66 @@ the pointer passed to it should not be `volatile`.</doc>
</parameter>
</parameters>
</function>
<function name="atomic_pointer_compare_and_exchange_full" c:identifier="g_atomic_pointer_compare_and_exchange_full" version="2.74">
<doc xml:space="preserve">Compares @atomic to @oldval and, if equal, sets it to @newval.
If @atomic was not equal to @oldval then no change occurs.
In any case the value of @atomic before this operation is stored in @preval.
This compare and exchange is done atomically.
Think of this operation as an atomic version of
`{ *preval = *atomic; if (*atomic == oldval) { *atomic = newval; return TRUE; } else return FALSE; }`.
This call acts as a full compiler and hardware memory barrier.
See also g_atomic_pointer_compare_and_exchange()</doc>
<return-value transfer-ownership="none">
<doc xml:space="preserve">%TRUE if the exchange took place</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
<parameter name="atomic" transfer-ownership="none">
<doc xml:space="preserve">a pointer to a #gpointer-sized value</doc>
<type name="gpointer" c:type="void*"/>
</parameter>
<parameter name="oldval" transfer-ownership="none" nullable="1" allow-none="1">
<doc xml:space="preserve">the value to compare with</doc>
<type name="gpointer" c:type="gpointer"/>
</parameter>
<parameter name="newval" transfer-ownership="none" nullable="1" allow-none="1">
<doc xml:space="preserve">the value to conditionally replace with</doc>
<type name="gpointer" c:type="gpointer"/>
</parameter>
<parameter name="preval" direction="out" caller-allocates="0" transfer-ownership="full">
<doc xml:space="preserve">the contents of @atomic before this operation</doc>
<type name="gpointer" c:type="void*"/>
</parameter>
</parameters>
</function>
<function name="atomic_pointer_exchange" c:identifier="g_atomic_pointer_exchange" version="2.74">
<doc xml:space="preserve">Sets the @atomic to @newval and returns the old value from @atomic.
This exchange is done atomically.
Think of this operation as an atomic version of
`{ tmp = *atomic; *atomic = val; return tmp; }`.
This call acts as a full compiler and hardware memory barrier.</doc>
<return-value transfer-ownership="none" nullable="1">
<doc xml:space="preserve">the value of @atomic before the exchange</doc>
<type name="gpointer" c:type="gpointer"/>
</return-value>
<parameters>
<parameter name="atomic" transfer-ownership="none" nullable="1" allow-none="1">
<doc xml:space="preserve">a pointer to a #gpointer-sized value</doc>
<type name="gpointer" c:type="void*"/>
</parameter>
<parameter name="newval" transfer-ownership="none" nullable="1" allow-none="1">
<doc xml:space="preserve">the value to replace with</doc>
<type name="gpointer" c:type="gpointer"/>
</parameter>
</parameters>
</function>
<function name="atomic_pointer_get" c:identifier="g_atomic_pointer_get" version="2.4">
<doc xml:space="preserve">Gets the current value of @atomic.
@@ -39930,6 +40166,31 @@ threads are using the same datalist and the same key.</doc>
</parameter>
</parameters>
</function-macro>
<function name="datalist_id_remove_multiple" c:identifier="g_datalist_id_remove_multiple" version="2.74">
<doc xml:space="preserve">Removes multiple keys from a datalist.
This is more efficient than calling g_datalist_id_remove_data()
multiple times in a row.</doc>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
<parameters>
<parameter name="datalist" transfer-ownership="none">
<doc xml:space="preserve">a datalist</doc>
<type name="Data" c:type="GData**"/>
</parameter>
<parameter name="keys" transfer-ownership="none">
<doc xml:space="preserve">keys to remove</doc>
<array length="2" zero-terminated="0" c:type="GQuark*">
<type name="Quark" c:type="GQuark"/>
</array>
</parameter>
<parameter name="n_keys" transfer-ownership="none">
<doc xml:space="preserve">length of @keys, must be &lt;= 16</doc>
<type name="gsize" c:type="gsize"/>
</parameter>
</parameters>
</function>
<function name="datalist_id_remove_no_notify" c:identifier="g_datalist_id_remove_no_notify" introspectable="0">
<doc xml:space="preserve">Removes an element, without calling its destroy notification
function.</doc>
@@ -43749,6 +44010,30 @@ use a custom main context.</doc>
</parameter>
</parameters>
</function>
<function name="idle_add_once" c:identifier="g_idle_add_once" version="2.74" introspectable="0">
<doc xml:space="preserve">Adds a function to be called whenever there are no higher priority
events pending to the default main loop. The function is given the
default idle priority, %G_PRIORITY_DEFAULT_IDLE.
The function will only be called once and then the source will be
automatically removed from the main context.
This function otherwise behaves like g_idle_add().</doc>
<return-value transfer-ownership="none">
<doc xml:space="preserve">the ID (greater than 0) of the event source</doc>
<type name="guint" c:type="guint"/>
</return-value>
<parameters>
<parameter name="function" transfer-ownership="none" closure="1">
<doc xml:space="preserve">function to call</doc>
<type name="SourceOnceFunc" c:type="GSourceOnceFunc"/>
</parameter>
<parameter name="data" transfer-ownership="none" nullable="1" allow-none="1">
<doc xml:space="preserve">data to pass to @function</doc>
<type name="gpointer" c:type="gpointer"/>
</parameter>
</parameters>
</function>
<function name="idle_remove_by_data" c:identifier="g_idle_remove_by_data">
<doc xml:space="preserve">Removes the idle function with the given data.</doc>
<return-value transfer-ownership="none">
@@ -49976,17 +50261,23 @@ absolute path, it will be looked for in the `PATH` variable from
@envp. If both %G_SPAWN_SEARCH_PATH and %G_SPAWN_SEARCH_PATH_FROM_ENVP
are used, the value from @envp takes precedence over the environment.
%G_SPAWN_STDOUT_TO_DEV_NULL means that the child's standard output
will be discarded, instead of going to the same location as the parent's
standard output. If you use this flag, @stdout_pipe_out must be %NULL.
%G_SPAWN_STDERR_TO_DEV_NULL means that the child's standard error
will be discarded, instead of going to the same location as the parent's
standard error. If you use this flag, @stderr_pipe_out must be %NULL.
%G_SPAWN_CHILD_INHERITS_STDIN means that the child will inherit the parent's
standard input (by default, the child's standard input is attached to
`/dev/null`). If you use this flag, @stdin_pipe_out must be %NULL.
`/dev/null`). %G_SPAWN_STDIN_FROM_DEV_NULL explicitly imposes the default
behavior. Both flags cannot be enabled at the same time and, in both cases,
the @stdin_pipe_out argument is ignored.
%G_SPAWN_STDOUT_TO_DEV_NULL means that the child's standard output
will be discarded (by default, it goes to the same location as the parent's
standard output). %G_SPAWN_CHILD_INHERITS_STDOUT explicitly imposes the
default behavior. Both flags cannot be enabled at the same time and, in
both cases, the @stdout_pipe_out argument is ignored.
%G_SPAWN_STDERR_TO_DEV_NULL means that the child's standard error
will be discarded (by default, it goes to the same location as the parent's
standard error). %G_SPAWN_CHILD_INHERITS_STDERR explicitly imposes the
default behavior. Both flags cannot be enabled at the same time and, in
both cases, the @stderr_pipe_out argument is ignored.
It is valid to pass the same FD in multiple parameters (e.g. you can pass
a single FD for both @stdout_fd and @stderr_fd, and include it in
@@ -51071,7 +51362,7 @@ as soon as the call returns:
]|</doc>
<return-value transfer-ownership="none">
<doc xml:space="preserve">a UTF-8 string describing the error code. If the error code
is unknown, it returns a string like "unknown error (&lt;code&gt;)".</doc>
is unknown, it returns a string like "Unknown error: &lt;code&gt;".</doc>
<type name="utf8" c:type="const gchar*"/>
</return-value>
<parameters>
@@ -52938,7 +53229,7 @@ message.
}
// Reruns this same test in a subprocess
g_test_trap_subprocess (NULL, 0, 0);
g_test_trap_subprocess (NULL, 0, G_TEST_SUBPROCESS_DEFAULT);
g_test_trap_assert_failed ();
g_test_trap_assert_stderr ("*ERROR*too large*");
}
@@ -53557,6 +53848,34 @@ See g_get_monotonic_time().</doc>
</parameter>
</parameters>
</function>
<function name="timeout_add_once" c:identifier="g_timeout_add_once" version="2.74" introspectable="0">
<doc xml:space="preserve">Sets a function to be called after @interval milliseconds have elapsed,
with the default priority, %G_PRIORITY_DEFAULT.
The given @function is called once and then the source will be automatically
removed from the main context.
This function otherwise behaves like g_timeout_add().</doc>
<return-value transfer-ownership="none">
<doc xml:space="preserve">the ID (greater than 0) of the event source</doc>
<type name="guint" c:type="guint"/>
</return-value>
<parameters>
<parameter name="interval" transfer-ownership="none">
<doc xml:space="preserve">the time after which the function will be called, in
milliseconds (1/1000ths of a second)</doc>
<type name="guint" c:type="guint"/>
</parameter>
<parameter name="function" transfer-ownership="none" closure="2">
<doc xml:space="preserve">function to call</doc>
<type name="SourceOnceFunc" c:type="GSourceOnceFunc"/>
</parameter>
<parameter name="data" transfer-ownership="none" nullable="1" allow-none="1">
<doc xml:space="preserve">data to pass to @function</doc>
<type name="gpointer" c:type="gpointer"/>
</parameter>
</parameters>
</function>
<function name="timeout_add_seconds" c:identifier="g_timeout_add_seconds" shadowed-by="timeout_add_seconds_full" version="2.14" introspectable="0">
<doc xml:space="preserve">Sets a function to be called at regular intervals with the default
priority, %G_PRIORITY_DEFAULT.
@@ -55097,7 +55416,9 @@ for fcntl(); these are different on Linux/glibc.</doc>
<parameters>
<parameter name="fds" transfer-ownership="none">
<doc xml:space="preserve">Array of two integers</doc>
<type name="gint" c:type="gint*"/>
<array zero-terminated="0" c:type="gint*" fixed-size="2">
<type name="gint" c:type="gint"/>
</array>
</parameter>
<parameter name="flags" transfer-ownership="none">
<doc xml:space="preserve">Bitfield of file descriptor flags, as for fcntl()</doc>

195
GObject-2.0.gir
View File

@@ -3337,7 +3337,7 @@ destroyed and freed.</doc>
last argument to g_closure_invoke()</doc>
<type name="gpointer" c:type="gpointer"/>
</parameter>
<parameter name="marshal_data" transfer-ownership="none" nullable="1" allow-none="1">
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="5">
<doc xml:space="preserve">additional data specified when
registering the marshaller, see g_closure_set_marshal() and
g_closure_set_meta_marshal()</doc>
@@ -3373,12 +3373,16 @@ on closures.</doc>
<bitfield name="ConnectFlags" c:type="GConnectFlags">
<doc xml:space="preserve">The connection flags are used to specify the behaviour of a signal's
connection.</doc>
<member name="default" value="0" c:identifier="G_CONNECT_DEFAULT">
<doc xml:space="preserve">Default behaviour (no special flags). Since: 2.74</doc>
</member>
<member name="after" value="1" c:identifier="G_CONNECT_AFTER">
<doc xml:space="preserve">whether the handler should be called before or after the
default handler of the signal.</doc>
<doc xml:space="preserve">If set, the handler should be called after the
default handler of the signal. Normally, the handler is called before
the default handler.</doc>
</member>
<member name="swapped" value="2" c:identifier="G_CONNECT_SWAPPED">
<doc xml:space="preserve">whether the instance and data should be swapped when
<doc xml:space="preserve">If set, the instance and data should be swapped when
calling the handler; see g_signal_connect_swapped() for an example.</doc>
</member>
</bitfield>
@@ -3909,6 +3913,47 @@ gtk_gadget_register_type (GTypeModule *type_module)
</parameter>
</parameters>
</function-macro>
<function-macro name="DEFINE_ENUM_TYPE" c:identifier="G_DEFINE_ENUM_TYPE" version="2.74" introspectable="0">
<doc xml:space="preserve">A convenience macro for defining enumeration types.
This macro will generate a `*_get_type()` function for the
given @TypeName, using @type_name as the function prefix.
|[&lt;!-- language="C" --&gt;
G_DEFINE_ENUM_TYPE (GtkOrientation, gtk_orientation,
G_DEFINE_ENUM_VALUE (GTK_ORIENTATION_HORIZONTAL, "horizontal"),
G_DEFINE_ENUM_VALUE (GTK_ORIENTATION_VERTICAL, "vertical"))
]|
For projects that have multiple enumeration types, or enumeration
types with many values, you should consider using glib-mkenums to
generate the type function.</doc>
<parameters>
<parameter name="TypeName">
<doc xml:space="preserve">the enumeration type, in `CamelCase`</doc>
</parameter>
<parameter name="type_name">
<doc xml:space="preserve">the enumeration type prefixed, in `snake_case`</doc>
</parameter>
<parameter name="...">
<doc xml:space="preserve">a list of enumeration values, defined using G_DEFINE_ENUM_VALUE()</doc>
</parameter>
</parameters>
</function-macro>
<function-macro name="DEFINE_ENUM_VALUE" c:identifier="G_DEFINE_ENUM_VALUE" version="2.74" introspectable="0">
<doc xml:space="preserve">Defines an enumeration value, and maps it to a "nickname".
This macro can only be used with G_DEFINE_ENUM_TYPE() and
G_DEFINE_FLAGS_TYPE().</doc>
<parameters>
<parameter name="EnumValue">
<doc xml:space="preserve">an enumeration value</doc>
</parameter>
<parameter name="EnumNick">
<doc xml:space="preserve">a short string representing the enumeration value</doc>
</parameter>
</parameters>
</function-macro>
<function-macro name="DEFINE_FINAL_TYPE" c:identifier="G_DEFINE_FINAL_TYPE" version="2.70" introspectable="0">
<doc xml:space="preserve">A convenience macro for type implementations.
@@ -3971,6 +4016,37 @@ See G_DEFINE_TYPE_EXTENDED() for an example.</doc>
</parameter>
</parameters>
</function-macro>
<function-macro name="DEFINE_FLAGS_TYPE" c:identifier="G_DEFINE_FLAGS_TYPE" version="2.74" introspectable="0">
<doc xml:space="preserve">A convenience macro for defining flag types.
This macro will generate a `*_get_type()` function for the
given @TypeName, using @type_name as the function prefix.
|[&lt;!-- language="C" --&gt;
G_DEFINE_FLAGS_TYPE (GSettingsBindFlags, g_settings_bind_flags,
G_DEFINE_ENUM_VALUE (G_SETTINGS_BIND_DEFAULT, "default"),
G_DEFINE_ENUM_VALUE (G_SETTINGS_BIND_GET, "get"),
G_DEFINE_ENUM_VALUE (G_SETTINGS_BIND_SET, "set"),
G_DEFINE_ENUM_VALUE (G_SETTINGS_BIND_NO_SENSITIVITY, "no-sensitivity"),
G_DEFINE_ENUM_VALUE (G_SETTINGS_BIND_GET_NO_CHANGES, "get-no-changes"),
G_DEFINE_ENUM_VALUE (G_SETTINGS_BIND_INVERT_BOOLEAN, "invert-boolean"))
]|
For projects that have multiple enumeration types, or enumeration
types with many values, you should consider using glib-mkenums to
generate the type function.</doc>
<parameters>
<parameter name="TypeName">
<doc xml:space="preserve">the enumeration type, in `CamelCase`</doc>
</parameter>
<parameter name="type_name">
<doc xml:space="preserve">the enumeration type prefixed, in `snake_case`</doc>
</parameter>
<parameter name="...">
<doc xml:space="preserve">a list of enumeration values, defined using G_DEFINE_ENUM_VALUE()</doc>
</parameter>
</parameters>
</function-macro>
<function-macro name="DEFINE_INTERFACE" c:identifier="G_DEFINE_INTERFACE" version="2.24" introspectable="0">
<doc xml:space="preserve">A convenience macro for #GTypeInterface definitions, which declares
a default vtable initialization function and defines a `*_get_type()`
@@ -4860,8 +4936,17 @@ implementation and should never be accessed directly.</doc>
<field name="flags" readable="0" private="1">
<type name="gsize" c:type="gsize"/>
</field>
<field name="n_construct_properties" readable="0" private="1">
<type name="gsize" c:type="gsize"/>
</field>
<field name="pspecs" readable="0" private="1">
<type name="gpointer" c:type="gpointer"/>
</field>
<field name="n_pspecs" readable="0" private="1">
<type name="gsize" c:type="gsize"/>
</field>
<field name="pdummy" readable="0" private="1">
<array zero-terminated="0" fixed-size="6">
<array zero-terminated="0" fixed-size="3">
<type name="gpointer" c:type="gpointer"/>
</array>
</field>
@@ -5656,8 +5741,8 @@ function pointers.</doc>
The signal specs expected by this function have the form
"modifier::signal_name", where modifier can be one of the following:
- signal: equivalent to g_signal_connect_data (..., NULL, 0)
- object-signal, object_signal: equivalent to g_signal_connect_object (..., 0)
- signal: equivalent to g_signal_connect_data (..., NULL, G_CONNECT_DEFAULT)
- object-signal, object_signal: equivalent to g_signal_connect_object (..., G_CONNECT_DEFAULT)
- swapped-signal, swapped_signal: equivalent to g_signal_connect_data (..., NULL, G_CONNECT_SWAPPED)
- swapped_object_signal, swapped-object-signal: equivalent to g_signal_connect_object (..., G_CONNECT_SWAPPED)
- signal_after, signal-after: equivalent to g_signal_connect_data (..., NULL, G_CONNECT_AFTER)
@@ -6065,12 +6150,11 @@ instead, is to store the GParamSpec used with
g_object_class_install_property() inside a static array, e.g.:
|[&lt;!-- language="C" --&gt;
enum
typedef enum
{
PROP_0,
PROP_FOO,
PROP_FOO = 1,
PROP_LAST
};
} MyObjectProperty;
static GParamSpec *properties[PROP_LAST];
@@ -6080,7 +6164,7 @@ g_object_class_install_property() inside a static array, e.g.:
properties[PROP_FOO] = g_param_spec_int ("foo", "Foo", "The foo",
0, 100,
50,
G_PARAM_READWRITE);
G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS);
g_object_class_install_property (gobject_class,
PROP_FOO,
properties[PROP_FOO]);
@@ -6958,8 +7042,17 @@ my_singleton_constructor (GType type,
<field name="flags" readable="0" private="1">
<type name="gsize" c:type="gsize"/>
</field>
<field name="n_construct_properties" readable="0" private="1">
<type name="gsize" c:type="gsize"/>
</field>
<field name="pspecs" readable="0" private="1">
<type name="gpointer" c:type="gpointer"/>
</field>
<field name="n_pspecs" readable="0" private="1">
<type name="gsize" c:type="gsize"/>
</field>
<field name="pdummy" readable="0" private="1">
<array zero-terminated="0" fixed-size="6">
<array zero-terminated="0" fixed-size="3">
<type name="gpointer" c:type="gpointer"/>
</array>
</field>
@@ -7000,9 +7093,11 @@ This function should be used if you plan to use a static array of
class initialization:
|[&lt;!-- language="C" --&gt;
enum {
PROP_0, PROP_FOO, PROP_BAR, N_PROPERTIES
};
typedef enum {
PROP_FOO = 1,
PROP_BAR,
N_PROPERTIES
} MyObjectProperty;
static GParamSpec *obj_properties[N_PROPERTIES] = { NULL, };
@@ -7015,17 +7110,17 @@ my_object_class_init (MyObjectClass *klass)
g_param_spec_int ("foo", "Foo", "Foo",
-1, G_MAXINT,
0,
G_PARAM_READWRITE);
G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS);
obj_properties[PROP_BAR] =
g_param_spec_string ("bar", "Bar", "Bar",
NULL,
G_PARAM_READWRITE);
G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS);
gobject_class-&gt;set_property = my_object_set_property;
gobject_class-&gt;get_property = my_object_get_property;
g_object_class_install_properties (gobject_class,
N_PROPERTIES,
G_N_ELEMENTS (obj_properties),
obj_properties);
}
]|
@@ -7465,6 +7560,12 @@ a #GParamSpec object.</doc>
<constant name="PARAM_STATIC_STRINGS" value="224" c:type="G_PARAM_STATIC_STRINGS">
<doc xml:space="preserve">#GParamFlags value alias for %G_PARAM_STATIC_NAME | %G_PARAM_STATIC_NICK | %G_PARAM_STATIC_BLURB.
It is recommended to use this for all properties by default, as it allows for
internal performance improvements in GObject.
It is very rare that a property would have a dynamically constructed name,
nickname or blurb.
Since 2.13.0</doc>
<type name="gint" c:type="gint"/>
</constant>
@@ -7670,6 +7771,19 @@ the rules for valid names.</doc>
</instance-parameter>
</parameters>
</virtual-method>
<virtual-method name="value_is_valid">
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
<instance-parameter name="pspec" transfer-ownership="none">
<type name="ParamSpec" c:type="GParamSpec*"/>
</instance-parameter>
<parameter name="value" transfer-ownership="none">
<type name="Value" c:type="const GValue*"/>
</parameter>
</parameters>
</virtual-method>
<virtual-method name="value_set_default">
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
@@ -8094,8 +8208,23 @@ g_param_type_register_static().</doc>
</parameters>
</callback>
</field>
<field name="value_is_valid">
<callback name="value_is_valid">
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
<parameter name="pspec" transfer-ownership="none">
<type name="ParamSpec" c:type="GParamSpec*"/>
</parameter>
<parameter name="value" transfer-ownership="none">
<type name="Value" c:type="const GValue*"/>
</parameter>
</parameters>
</callback>
</field>
<field name="dummy" readable="0" private="1">
<array zero-terminated="0" fixed-size="4">
<array zero-terminated="0" fixed-size="3">
<type name="gpointer" c:type="gpointer"/>
</array>
</field>
@@ -8738,7 +8867,7 @@ last callback.</doc>
<doc xml:space="preserve">A #GValue holding the return value of the signal handler.</doc>
<type name="Value" c:type="const GValue*"/>
</parameter>
<parameter name="data" transfer-ownership="none" nullable="1" allow-none="1">
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="3">
<doc xml:space="preserve">Callback data that was specified when creating the signal.</doc>
<type name="gpointer" c:type="gpointer"/>
</parameter>
@@ -8773,7 +8902,7 @@ You may not attach these to signals created with the %G_SIGNAL_NO_HOOKS flag.</d
<type name="Value" c:type="GValue"/>
</array>
</parameter>
<parameter name="data" transfer-ownership="none" nullable="1" allow-none="1">
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="3">
<doc xml:space="preserve">user data associated with the hook.</doc>
<type name="gpointer" c:type="gpointer"/>
</parameter>
@@ -10018,6 +10147,9 @@ environment variable.</doc>
</bitfield>
<bitfield name="TypeFlags" c:type="GTypeFlags">
<doc xml:space="preserve">Bit masks used to check or determine characteristics of a type.</doc>
<member name="none" value="0" c:identifier="G_TYPE_FLAG_NONE">
<doc xml:space="preserve">No special flags. Since: 2.74</doc>
</member>
<member name="abstract" value="16" c:identifier="G_TYPE_FLAG_ABSTRACT">
<doc xml:space="preserve">Indicates an abstract type. No instances can be
created for an abstract type</doc>
@@ -15268,6 +15400,25 @@ without modifications</doc>
</parameter>
</parameters>
</function>
<function name="param_value_is_valid" c:identifier="g_param_value_is_valid" version="2.74">
<doc xml:space="preserve">Return whether the contents of @value comply with the specifications
set out by @pspec.</doc>
<return-value transfer-ownership="none">
<doc xml:space="preserve">whether the contents of @value comply with the specifications
set out by @pspec.</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
<parameter name="pspec" transfer-ownership="none">
<doc xml:space="preserve">a valid #GParamSpec</doc>
<type name="ParamSpec" c:type="GParamSpec*"/>
</parameter>
<parameter name="value" transfer-ownership="none">
<doc xml:space="preserve">a #GValue of correct type for @pspec</doc>
<type name="Value" c:type="const GValue*"/>
</parameter>
</parameters>
</function>
<function name="param_value_set_default" c:identifier="g_param_value_set_default">
<doc xml:space="preserve">Sets @value to its default value as specified in @pspec.</doc>
<return-value transfer-ownership="none">

707
Gio-2.0.gir
View File

@@ -9,14 +9,11 @@ and/or use gtk-doc annotations. -->
<c:include name="gio/gdesktopappinfo.h"/>
<c:include name="gio/gfiledescriptorbased.h"/>
<c:include name="gio/gio.h"/>
<c:include name="gio/gunixconnection.h"/>
<c:include name="gio/gunixcredentialsmessage.h"/>
<c:include name="gio/gunixfdlist.h"/>
<c:include name="gio/gunixfdmessage.h"/>
<c:include name="gio/gunixinputstream.h"/>
<c:include name="gio/gunixmounts.h"/>
<c:include name="gio/gunixoutputstream.h"/>
<c:include name="gio/gunixsocketaddress.h"/>
<namespace name="Gio" version="2.0" shared-library="libgio-2.0.so.0" c:identifier-prefixes="G" c:symbol-prefixes="g">
<function-macro name="ACTION" c:identifier="G_ACTION" introspectable="0">
<parameters>
@@ -2404,6 +2401,52 @@ g_app_info_get_fallback_for_type().</doc>
</parameter>
</parameters>
</function>
<function name="get_default_for_type_async" c:identifier="g_app_info_get_default_for_type_async" version="2.74">
<doc xml:space="preserve">Asynchronously gets the default #GAppInfo for a given content type.</doc>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
<parameters>
<parameter name="content_type" transfer-ownership="none">
<doc xml:space="preserve">the content type to find a #GAppInfo for</doc>
<type name="utf8" c:type="const char*"/>
</parameter>
<parameter name="must_support_uris" transfer-ownership="none">
<doc xml:space="preserve">if %TRUE, the #GAppInfo is expected to
support URIs</doc>
<type name="gboolean" c:type="gboolean"/>
</parameter>
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
<doc xml:space="preserve">optional #GCancellable object, %NULL to ignore</doc>
<type name="Cancellable" c:type="GCancellable*"/>
</parameter>
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="4">
<doc xml:space="preserve">a #GAsyncReadyCallback to call when the request is done</doc>
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
</parameter>
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
<doc xml:space="preserve">data to pass to @callback</doc>
<type name="gpointer" c:type="gpointer"/>
</parameter>
</parameters>
</function>
<function name="get_default_for_type_finish" c:identifier="g_app_info_get_default_for_type_finish" version="2.74" throws="1">
<doc xml:space="preserve">Finishes a default #GAppInfo lookup started by
g_app_info_get_default_for_type_async().
If no #GAppInfo is found, then @error will be set to %G_IO_ERROR_NOT_FOUND.</doc>
<return-value transfer-ownership="full">
<doc xml:space="preserve">#GAppInfo for given @content_type or
%NULL on error.</doc>
<type name="AppInfo" c:type="GAppInfo*"/>
</return-value>
<parameters>
<parameter name="result" transfer-ownership="none">
<doc xml:space="preserve">a #GAsyncResult</doc>
<type name="AsyncResult" c:type="GAsyncResult*"/>
</parameter>
</parameters>
</function>
<function name="get_default_for_uri_scheme" c:identifier="g_app_info_get_default_for_uri_scheme">
<doc xml:space="preserve">Gets the default application for handling URIs with
the given URI scheme. A URI scheme is the initial part
@@ -2421,6 +2464,50 @@ of the URI, up to but not including the ':', e.g. "http",
</parameter>
</parameters>
</function>
<function name="get_default_for_uri_scheme_async" c:identifier="g_app_info_get_default_for_uri_scheme_async" version="2.74">
<doc xml:space="preserve">Asynchronously gets the default application for handling URIs with
the given URI scheme. A URI scheme is the initial part
of the URI, up to but not including the ':', e.g. "http",
"ftp" or "sip".</doc>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
<parameters>
<parameter name="uri_scheme" transfer-ownership="none">
<doc xml:space="preserve">a string containing a URI scheme.</doc>
<type name="utf8" c:type="const char*"/>
</parameter>
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
<doc xml:space="preserve">optional #GCancellable object, %NULL to ignore</doc>
<type name="Cancellable" c:type="GCancellable*"/>
</parameter>
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="3">
<doc xml:space="preserve">a #GAsyncReadyCallback to call when the request is done</doc>
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
</parameter>
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
<doc xml:space="preserve">data to pass to @callback</doc>
<type name="gpointer" c:type="gpointer"/>
</parameter>
</parameters>
</function>
<function name="get_default_for_uri_scheme_finish" c:identifier="g_app_info_get_default_for_uri_scheme_finish" version="2.74" throws="1">
<doc xml:space="preserve">Finishes a default #GAppInfo lookup started by
g_app_info_get_default_for_uri_scheme_async().
If no #GAppInfo is found, then @error will be set to %G_IO_ERROR_NOT_FOUND.</doc>
<return-value transfer-ownership="full">
<doc xml:space="preserve">#GAppInfo for given @uri_scheme or
%NULL on error.</doc>
<type name="AppInfo" c:type="GAppInfo*"/>
</return-value>
<parameters>
<parameter name="result" transfer-ownership="none">
<doc xml:space="preserve">a #GAsyncResult</doc>
<type name="AsyncResult" c:type="GAsyncResult*"/>
</parameter>
</parameters>
</function>
<function name="get_fallback_for_type" c:identifier="g_app_info_get_fallback_for_type" version="2.28">
<doc xml:space="preserve">Gets a list of fallback #GAppInfos for a given content type, i.e.
those applications which claim to support the given content type
@@ -23682,8 +23769,13 @@ known.</doc>
</instance-parameter>
</parameters>
</method>
<method name="get_validation_flags" c:identifier="g_dtls_client_connection_get_validation_flags" glib:get-property="validation-flags" version="2.48">
<doc xml:space="preserve">Gets @conn's validation flags</doc>
<method name="get_validation_flags" c:identifier="g_dtls_client_connection_get_validation_flags" glib:get-property="validation-flags" version="2.48" deprecated="1" deprecated-version="2.74">
<doc xml:space="preserve">Gets @conn's validation flags
This function does not work as originally designed and is impossible
to use correctly. See #GDtlsClientConnection:validation-flags for more
information.</doc>
<doc-deprecated xml:space="preserve">Do not attempt to ignore validation errors.</doc-deprecated>
<return-value transfer-ownership="none">
<doc xml:space="preserve">the validation flags</doc>
<type name="TlsCertificateFlags" c:type="GTlsCertificateFlags"/>
@@ -23714,10 +23806,15 @@ performing %G_TLS_CERTIFICATE_BAD_IDENTITY validation, if enabled.</doc>
</parameter>
</parameters>
</method>
<method name="set_validation_flags" c:identifier="g_dtls_client_connection_set_validation_flags" glib:set-property="validation-flags" version="2.48">
<method name="set_validation_flags" c:identifier="g_dtls_client_connection_set_validation_flags" glib:set-property="validation-flags" version="2.48" deprecated="1" deprecated-version="2.74">
<doc xml:space="preserve">Sets @conn's validation flags, to override the default set of
checks performed when validating a server certificate. By default,
%G_TLS_CERTIFICATE_VALIDATE_ALL is used.</doc>
%G_TLS_CERTIFICATE_VALIDATE_ALL is used.
This function does not work as originally designed and is impossible
to use correctly. See #GDtlsClientConnection:validation-flags for more
information.</doc>
<doc-deprecated xml:space="preserve">Do not attempt to ignore validation errors.</doc-deprecated>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
@@ -23761,11 +23858,24 @@ certificate we expect, which is useful for servers that serve
virtual hosts.</doc>
<type name="SocketConnectable"/>
</property>
<property name="validation-flags" version="2.48" writable="1" construct="1" transfer-ownership="none" setter="set_validation_flags" getter="get_validation_flags">
<property name="validation-flags" version="2.48" deprecated="1" deprecated-version="2.74" writable="1" construct="1" transfer-ownership="none" setter="set_validation_flags" getter="get_validation_flags">
<doc xml:space="preserve">What steps to perform when validating a certificate received from
a server. Server certificates that fail to validate in any of the
ways indicated here will be rejected unless the application
overrides the default via #GDtlsConnection::accept-certificate.</doc>
overrides the default via #GDtlsConnection::accept-certificate.
GLib guarantees that if certificate verification fails, at least one
flag will be set, but it does not guarantee that all possible flags
will be set. Accordingly, you may not safely decide to ignore any
particular type of error. For example, it would be incorrect to mask
%G_TLS_CERTIFICATE_EXPIRED if you want to allow expired certificates,
because this could potentially be the only error flag set even if
other problems exist with the certificate. Therefore, there is no
safe way to use this property. This is not a horrible problem,
though, because you should not be attempting to ignore validation
errors anyway. If you really must ignore TLS certificate errors,
connect to #GDtlsConnection::accept-certificate.</doc>
<doc-deprecated xml:space="preserve">Do not attempt to ignore validation errors.</doc-deprecated>
<type name="TlsCertificateFlags"/>
</property>
</interface>
@@ -25910,6 +26020,13 @@ contains the time since the file was last accessed, in seconds since the
UNIX epoch.</doc>
<type name="utf8" c:type="gchar*"/>
</constant>
<constant name="FILE_ATTRIBUTE_TIME_ACCESS_NSEC" value="time::access-nsec" c:type="G_FILE_ATTRIBUTE_TIME_ACCESS_NSEC" version="2.74">
<doc xml:space="preserve">A key in the "time" namespace for getting the nanoseconds of the time
the file was last accessed. This should be used in conjunction with
#G_FILE_ATTRIBUTE_TIME_ACCESS. Corresponding #GFileAttributeType is
%G_FILE_ATTRIBUTE_TYPE_UINT32.</doc>
<type name="utf8" c:type="gchar*"/>
</constant>
<constant name="FILE_ATTRIBUTE_TIME_ACCESS_USEC" value="time::access-usec" c:type="G_FILE_ATTRIBUTE_TIME_ACCESS_USEC">
<doc xml:space="preserve">A key in the "time" namespace for getting the microseconds of the time
the file was last accessed.
@@ -25930,6 +26047,13 @@ the UNIX epoch.
This corresponds to the traditional UNIX ctime.</doc>
<type name="utf8" c:type="gchar*"/>
</constant>
<constant name="FILE_ATTRIBUTE_TIME_CHANGED_NSEC" value="time::changed-nsec" c:type="G_FILE_ATTRIBUTE_TIME_CHANGED_NSEC" version="2.74">
<doc xml:space="preserve">A key in the "time" namespace for getting the nanoseconds of the time
the file was last changed. This should be used in conjunction with
#G_FILE_ATTRIBUTE_TIME_CHANGED. Corresponding #GFileAttributeType is
%G_FILE_ATTRIBUTE_TYPE_UINT32.</doc>
<type name="utf8" c:type="gchar*"/>
</constant>
<constant name="FILE_ATTRIBUTE_TIME_CHANGED_USEC" value="time::changed-usec" c:type="G_FILE_ATTRIBUTE_TIME_CHANGED_USEC">
<doc xml:space="preserve">A key in the "time" namespace for getting the microseconds of the time
the file was last changed.
@@ -25950,6 +26074,13 @@ This may correspond to Linux `stx_btime`, FreeBSD `st_birthtim`, NetBSD
`st_birthtime` or NTFS `ctime`.</doc>
<type name="utf8" c:type="gchar*"/>
</constant>
<constant name="FILE_ATTRIBUTE_TIME_CREATED_NSEC" value="time::created-nsec" c:type="G_FILE_ATTRIBUTE_TIME_CREATED_NSEC" version="2.74">
<doc xml:space="preserve">A key in the "time" namespace for getting the nanoseconds of the time
the file was created. This should be used in conjunction with
#G_FILE_ATTRIBUTE_TIME_CREATED. Corresponding #GFileAttributeType is
%G_FILE_ATTRIBUTE_TYPE_UINT32.</doc>
<type name="utf8" c:type="gchar*"/>
</constant>
<constant name="FILE_ATTRIBUTE_TIME_CREATED_USEC" value="time::created-usec" c:type="G_FILE_ATTRIBUTE_TIME_CREATED_USEC">
<doc xml:space="preserve">A key in the "time" namespace for getting the microseconds of the time
the file was created.
@@ -25968,6 +26099,13 @@ contains the time since the file was modified, in seconds since the UNIX
epoch.</doc>
<type name="utf8" c:type="gchar*"/>
</constant>
<constant name="FILE_ATTRIBUTE_TIME_MODIFIED_NSEC" value="time::modified-nsec" c:type="G_FILE_ATTRIBUTE_TIME_MODIFIED_NSEC" version="2.74">
<doc xml:space="preserve">A key in the "time" namespace for getting the nanoseconds of the time
the file was last modified. This should be used in conjunction with
#G_FILE_ATTRIBUTE_TIME_MODIFIED. Corresponding #GFileAttributeType is
%G_FILE_ATTRIBUTE_TYPE_UINT32.</doc>
<type name="utf8" c:type="gchar*"/>
</constant>
<constant name="FILE_ATTRIBUTE_TIME_MODIFIED_USEC" value="time::modified-usec" c:type="G_FILE_ATTRIBUTE_TIME_MODIFIED_USEC">
<doc xml:space="preserve">A key in the "time" namespace for getting the microseconds of the time
the file was last modified.
@@ -26292,6 +26430,8 @@ To construct a #GFile, you can use:
- g_file_new_for_uri() if you have a URI.
- g_file_new_for_commandline_arg() for a command line argument.
- g_file_new_tmp() to create a temporary file from a template.
- g_file_new_tmp_async() to asynchronously create a temporary file.
- g_file_new_tmp_dir_async() to asynchronously create a temporary directory.
- g_file_parse_name() from a UTF-8 string gotten from g_file_get_parse_name().
- g_file_new_build_filename() to create a file from path elements.
@@ -26498,6 +26638,107 @@ a temporary file could not be created.</doc>
</parameter>
</parameters>
</function>
<function name="new_tmp_async" c:identifier="g_file_new_tmp_async" version="2.74">
<doc xml:space="preserve">Asynchronously opens a file in the preferred directory for temporary files
(as returned by g_get_tmp_dir()) as g_file_new_tmp().
@tmpl should be a string in the GLib file name encoding
containing a sequence of six 'X' characters, and containing no
directory components. If it is %NULL, a default template is used.</doc>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
<parameters>
<parameter name="tmpl" transfer-ownership="none" nullable="1" allow-none="1">
<doc xml:space="preserve">Template for the file
name, as in g_file_open_tmp(), or %NULL for a default template</doc>
<type name="filename" c:type="const char*"/>
</parameter>
<parameter name="io_priority" transfer-ownership="none">
<doc xml:space="preserve">the [I/O priority][io-priority] of the request</doc>
<type name="gint" c:type="int"/>
</parameter>
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
<doc xml:space="preserve">optional #GCancellable object, %NULL to ignore</doc>
<type name="Cancellable" c:type="GCancellable*"/>
</parameter>
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="4">
<doc xml:space="preserve">a #GAsyncReadyCallback to call when the request is done</doc>
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
</parameter>
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
<doc xml:space="preserve">data to pass to @callback</doc>
<type name="gpointer" c:type="gpointer"/>
</parameter>
</parameters>
</function>
<function name="new_tmp_dir_async" c:identifier="g_file_new_tmp_dir_async" version="2.74">
<doc xml:space="preserve">Asynchronously creates a directory in the preferred directory for
temporary files (as returned by g_get_tmp_dir()) as g_dir_make_tmp().
@tmpl should be a string in the GLib file name encoding
containing a sequence of six 'X' characters, and containing no
directory components. If it is %NULL, a default template is used.</doc>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
<parameters>
<parameter name="tmpl" transfer-ownership="none" nullable="1" allow-none="1">
<doc xml:space="preserve">Template for the file
name, as in g_dir_make_tmp(), or %NULL for a default template</doc>
<type name="filename" c:type="const char*"/>
</parameter>
<parameter name="io_priority" transfer-ownership="none">
<doc xml:space="preserve">the [I/O priority][io-priority] of the request</doc>
<type name="gint" c:type="int"/>
</parameter>
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
<doc xml:space="preserve">optional #GCancellable object, %NULL to ignore</doc>
<type name="Cancellable" c:type="GCancellable*"/>
</parameter>
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="4">
<doc xml:space="preserve">a #GAsyncReadyCallback to call when the request is done</doc>
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
</parameter>
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
<doc xml:space="preserve">data to pass to @callback</doc>
<type name="gpointer" c:type="gpointer"/>
</parameter>
</parameters>
</function>
<function name="new_tmp_dir_finish" c:identifier="g_file_new_tmp_dir_finish" version="2.74" throws="1">
<doc xml:space="preserve">Finishes a temporary directory creation started by
g_file_new_tmp_dir_async().</doc>
<return-value transfer-ownership="full">
<doc xml:space="preserve">a new #GFile.
Free the returned object with g_object_unref().</doc>
<type name="File" c:type="GFile*"/>
</return-value>
<parameters>
<parameter name="result" transfer-ownership="none">
<doc xml:space="preserve">a #GAsyncResult</doc>
<type name="AsyncResult" c:type="GAsyncResult*"/>
</parameter>
</parameters>
</function>
<function name="new_tmp_finish" c:identifier="g_file_new_tmp_finish" version="2.74" throws="1">
<doc xml:space="preserve">Finishes a temporary file creation started by g_file_new_tmp_async().</doc>
<return-value transfer-ownership="full">
<doc xml:space="preserve">a new #GFile.
Free the returned object with g_object_unref().</doc>
<type name="File" c:type="GFile*"/>
</return-value>
<parameters>
<parameter name="result" transfer-ownership="none">
<doc xml:space="preserve">a #GAsyncResult</doc>
<type name="AsyncResult" c:type="GAsyncResult*"/>
</parameter>
<parameter name="iostream" direction="out" caller-allocates="0" transfer-ownership="full">
<doc xml:space="preserve">on return, a #GFileIOStream for the created file</doc>
<type name="FileIOStream" c:type="GFileIOStream**"/>
</parameter>
</parameters>
</function>
<function name="parse_name" c:identifier="g_file_parse_name">
<doc xml:space="preserve">Constructs a #GFile with the given @parse_name (i.e. something
given by g_file_get_parse_name()). This operation never fails,
@@ -27777,6 +28018,60 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.</doc>
</parameter>
</parameters>
</virtual-method>
<virtual-method name="make_symbolic_link_async" invoker="make_symbolic_link_async" version="2.74">
<doc xml:space="preserve">Asynchronously creates a symbolic link named @file which contains the
string @symlink_value.</doc>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
<parameters>
<instance-parameter name="file" transfer-ownership="none">
<doc xml:space="preserve">a #GFile with the name of the symlink to create</doc>
<type name="File" c:type="GFile*"/>
</instance-parameter>
<parameter name="symlink_value" transfer-ownership="none">
<doc xml:space="preserve">a string with the path for the target
of the new symlink</doc>
<type name="filename" c:type="const char*"/>
</parameter>
<parameter name="io_priority" transfer-ownership="none">
<doc xml:space="preserve">the [I/O priority][io-priority] of the request</doc>
<type name="gint" c:type="int"/>
</parameter>
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
<doc xml:space="preserve">optional #GCancellable object,
%NULL to ignore</doc>
<type name="Cancellable" c:type="GCancellable*"/>
</parameter>
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="4">
<doc xml:space="preserve">a #GAsyncReadyCallback to call
when the request is satisfied</doc>
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
</parameter>
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="4">
<doc xml:space="preserve">the data to pass to callback function</doc>
<type name="gpointer" c:type="gpointer"/>
</parameter>
</parameters>
</virtual-method>
<virtual-method name="make_symbolic_link_finish" invoker="make_symbolic_link_finish" version="2.74" throws="1">
<doc xml:space="preserve">Finishes an asynchronous symbolic link creation, started with
g_file_make_symbolic_link_async().</doc>
<return-value transfer-ownership="none">
<doc xml:space="preserve">%TRUE on successful directory creation, %FALSE otherwise.</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
<instance-parameter name="file" transfer-ownership="none">
<doc xml:space="preserve">input #GFile</doc>
<type name="File" c:type="GFile*"/>
</instance-parameter>
<parameter name="result" transfer-ownership="none">
<doc xml:space="preserve">a #GAsyncResult</doc>
<type name="AsyncResult" c:type="GAsyncResult*"/>
</parameter>
</parameters>
</virtual-method>
<virtual-method name="measure_disk_usage" invoker="measure_disk_usage" version="2.38" introspectable="0" throws="1">
<doc xml:space="preserve">Recursively measures the disk usage of @file.
@@ -31373,6 +31668,60 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.</doc>
</parameter>
</parameters>
</method>
<method name="make_symbolic_link_async" c:identifier="g_file_make_symbolic_link_async" version="2.74">
<doc xml:space="preserve">Asynchronously creates a symbolic link named @file which contains the
string @symlink_value.</doc>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
<parameters>
<instance-parameter name="file" transfer-ownership="none">
<doc xml:space="preserve">a #GFile with the name of the symlink to create</doc>
<type name="File" c:type="GFile*"/>
</instance-parameter>
<parameter name="symlink_value" transfer-ownership="none">
<doc xml:space="preserve">a string with the path for the target
of the new symlink</doc>
<type name="filename" c:type="const char*"/>
</parameter>
<parameter name="io_priority" transfer-ownership="none">
<doc xml:space="preserve">the [I/O priority][io-priority] of the request</doc>
<type name="gint" c:type="int"/>
</parameter>
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
<doc xml:space="preserve">optional #GCancellable object,
%NULL to ignore</doc>
<type name="Cancellable" c:type="GCancellable*"/>
</parameter>
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="4">
<doc xml:space="preserve">a #GAsyncReadyCallback to call
when the request is satisfied</doc>
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
</parameter>
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
<doc xml:space="preserve">the data to pass to callback function</doc>
<type name="gpointer" c:type="gpointer"/>
</parameter>
</parameters>
</method>
<method name="make_symbolic_link_finish" c:identifier="g_file_make_symbolic_link_finish" version="2.74" throws="1">
<doc xml:space="preserve">Finishes an asynchronous symbolic link creation, started with
g_file_make_symbolic_link_async().</doc>
<return-value transfer-ownership="none">
<doc xml:space="preserve">%TRUE on successful directory creation, %FALSE otherwise.</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
<instance-parameter name="file" transfer-ownership="none">
<doc xml:space="preserve">input #GFile</doc>
<type name="File" c:type="GFile*"/>
</instance-parameter>
<parameter name="result" transfer-ownership="none">
<doc xml:space="preserve">a #GAsyncResult</doc>
<type name="AsyncResult" c:type="GAsyncResult*"/>
</parameter>
</parameters>
</method>
<method name="measure_disk_usage" c:identifier="g_file_measure_disk_usage" version="2.38" introspectable="0" throws="1">
<doc xml:space="preserve">Recursively measures the disk usage of @file.
@@ -36968,18 +37317,58 @@ to be used as icon.</doc>
</parameters>
</callback>
</field>
<field name="_make_symbolic_link_async" introspectable="0">
<callback name="_make_symbolic_link_async">
<field name="make_symbolic_link_async">
<callback name="make_symbolic_link_async">
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
<parameters>
<parameter name="file" transfer-ownership="none">
<doc xml:space="preserve">a #GFile with the name of the symlink to create</doc>
<type name="File" c:type="GFile*"/>
</parameter>
<parameter name="symlink_value" transfer-ownership="none">
<doc xml:space="preserve">a string with the path for the target
of the new symlink</doc>
<type name="filename" c:type="const char*"/>
</parameter>
<parameter name="io_priority" transfer-ownership="none">
<doc xml:space="preserve">the [I/O priority][io-priority] of the request</doc>
<type name="gint" c:type="int"/>
</parameter>
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
<doc xml:space="preserve">optional #GCancellable object,
%NULL to ignore</doc>
<type name="Cancellable" c:type="GCancellable*"/>
</parameter>
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="5">
<doc xml:space="preserve">a #GAsyncReadyCallback to call
when the request is satisfied</doc>
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
</parameter>
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="5">
<doc xml:space="preserve">the data to pass to callback function</doc>
<type name="gpointer" c:type="gpointer"/>
</parameter>
</parameters>
</callback>
</field>
<field name="_make_symbolic_link_finish" introspectable="0">
<callback name="_make_symbolic_link_finish">
<field name="make_symbolic_link_finish">
<callback name="make_symbolic_link_finish" throws="1">
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
<doc xml:space="preserve">%TRUE on successful directory creation, %FALSE otherwise.</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
<parameter name="file" transfer-ownership="none">
<doc xml:space="preserve">input #GFile</doc>
<type name="File" c:type="GFile*"/>
</parameter>
<parameter name="result" transfer-ownership="none">
<doc xml:space="preserve">a #GAsyncResult</doc>
<type name="AsyncResult" c:type="GAsyncResult*"/>
</parameter>
</parameters>
</callback>
</field>
<field name="copy">
@@ -38159,7 +38548,10 @@ and then copies all of the file attributes from @src_info to @dest_info.</doc>
This requires the %G_FILE_ATTRIBUTE_TIME_ACCESS attribute. If
%G_FILE_ATTRIBUTE_TIME_ACCESS_USEC is provided, the resulting #GDateTime
will have microsecond precision.</doc>
will have microsecond precision.
If nanosecond precision is needed, %G_FILE_ATTRIBUTE_TIME_ACCESS_NSEC must
be queried separately using g_file_info_get_attribute_uint32().</doc>
<return-value transfer-ownership="full" nullable="1">
<doc xml:space="preserve">access time, or %NULL if unknown</doc>
<type name="GLib.DateTime" c:type="GDateTime*"/>
@@ -38451,7 +38843,10 @@ or %NULL if unknown.</doc>
This requires the %G_FILE_ATTRIBUTE_TIME_CREATED attribute. If
%G_FILE_ATTRIBUTE_TIME_CREATED_USEC is provided, the resulting #GDateTime
will have microsecond precision.</doc>
will have microsecond precision.
If nanosecond precision is needed, %G_FILE_ATTRIBUTE_TIME_CREATED_NSEC must
be queried separately using g_file_info_get_attribute_uint32().</doc>
<return-value transfer-ownership="full" nullable="1">
<doc xml:space="preserve">creation time, or %NULL if unknown</doc>
<type name="GLib.DateTime" c:type="GDateTime*"/>
@@ -38590,7 +38985,10 @@ This is different from the file's content type, see g_file_info_get_content_type
This requires the %G_FILE_ATTRIBUTE_TIME_MODIFIED attribute. If
%G_FILE_ATTRIBUTE_TIME_MODIFIED_USEC is provided, the resulting #GDateTime
will have microsecond precision.</doc>
will have microsecond precision.
If nanosecond precision is needed, %G_FILE_ATTRIBUTE_TIME_MODIFIED_NSEC must
be queried separately using g_file_info_get_attribute_uint32().</doc>
<return-value transfer-ownership="full" nullable="1">
<doc xml:space="preserve">modification time, or %NULL if unknown</doc>
<type name="GLib.DateTime" c:type="GDateTime*"/>
@@ -38767,7 +39165,9 @@ types for the given @name_space, or %NULL on error.</doc>
<method name="set_access_date_time" c:identifier="g_file_info_set_access_date_time" version="2.70">
<doc xml:space="preserve">Sets the %G_FILE_ATTRIBUTE_TIME_ACCESS and
%G_FILE_ATTRIBUTE_TIME_ACCESS_USEC attributes in the file info to the
given date/time value.</doc>
given date/time value.
%G_FILE_ATTRIBUTE_TIME_ACCESS_NSEC will be cleared.</doc>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
@@ -39063,7 +39463,9 @@ See %G_FILE_ATTRIBUTE_STANDARD_CONTENT_TYPE.</doc>
<method name="set_creation_date_time" c:identifier="g_file_info_set_creation_date_time" version="2.70">
<doc xml:space="preserve">Sets the %G_FILE_ATTRIBUTE_TIME_CREATED and
%G_FILE_ATTRIBUTE_TIME_CREATED_USEC attributes in the file info to the
given date/time value.</doc>
given date/time value.
%G_FILE_ATTRIBUTE_TIME_CREATED_NSEC will be cleared.</doc>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
@@ -39183,7 +39585,9 @@ See %G_FILE_ATTRIBUTE_STANDARD_IS_SYMLINK.</doc>
<method name="set_modification_date_time" c:identifier="g_file_info_set_modification_date_time" version="2.62">
<doc xml:space="preserve">Sets the %G_FILE_ATTRIBUTE_TIME_MODIFIED and
%G_FILE_ATTRIBUTE_TIME_MODIFIED_USEC attributes in the file info to the
given date/time value.</doc>
given date/time value.
%G_FILE_ATTRIBUTE_TIME_MODIFIED_NSEC will be cleared.</doc>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
@@ -39201,7 +39605,9 @@ given date/time value.</doc>
<method name="set_modification_time" c:identifier="g_file_info_set_modification_time" deprecated="1" deprecated-version="2.62">
<doc xml:space="preserve">Sets the %G_FILE_ATTRIBUTE_TIME_MODIFIED and
%G_FILE_ATTRIBUTE_TIME_MODIFIED_USEC attributes in the file info to the
given time value.</doc>
given time value.
%G_FILE_ATTRIBUTE_TIME_MODIFIED_NSEC will be cleared.</doc>
<doc-deprecated xml:space="preserve">Use g_file_info_set_modification_date_time() instead, as
#GTimeVal is deprecated due to the year 2038 problem.</doc-deprecated>
<return-value transfer-ownership="none">
@@ -40658,7 +41064,7 @@ should be read, or %FALSE otherwise.</doc>
<doc xml:space="preserve">the size of the data currently read.</doc>
<type name="gint64" c:type="goffset"/>
</parameter>
<parameter name="callback_data" transfer-ownership="none" nullable="1" allow-none="1" closure="2">
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="2">
<doc xml:space="preserve">data passed to the callback.</doc>
<type name="gpointer" c:type="gpointer"/>
</parameter>
@@ -41281,6 +41687,9 @@ See also #GPollableReturn for a cheaper way of returning
<member name="message_too_large" value="46" c:identifier="G_IO_ERROR_MESSAGE_TOO_LARGE" glib:nick="message-too-large" glib:name="G_IO_ERROR_MESSAGE_TOO_LARGE">
<doc xml:space="preserve">Message too large. Since 2.48.</doc>
</member>
<member name="no_such_device" value="47" c:identifier="G_IO_ERROR_NO_SUCH_DEVICE" glib:nick="no-such-device" glib:name="G_IO_ERROR_NO_SUCH_DEVICE">
<doc xml:space="preserve">No such device found. Since 2.74</doc>
</member>
</enumeration>
<record name="IOExtension" c:type="GIOExtension" disguised="1">
<doc xml:space="preserve">#GIOExtension is an opaque data structure and can only be accessed
@@ -46314,7 +46723,22 @@ This interface is intended only to be used from a single thread. The
thread in which it is appropriate to use it depends on the particular
implementation, but typically it will be from the thread that owns
the [thread-default main context][g-main-context-push-thread-default]
in effect at the time that the model was created.</doc>
in effect at the time that the model was created.
Over time, it has established itself as good practice for listmodel
implementations to provide properties `item-type` and `n-items` to
ease working with them. While it is not required, it is recommended
that implementations provide these two properties. They should return
the values of g_list_model_get_item_type() and g_list_model_get_n_items()
respectively and be defined as such:
|[&lt;!-- language="C" --&gt;
properties[PROP_ITEM_TYPE] =
g_param_spec_gtype ("item-type", "", "", G_TYPE_OBJECT,
G_PARAM_CONSTRUCT_ONLY | G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS);
properties[PROP_N_ITEMS] =
g_param_spec_uint ("n-items", "", "", 0, G_MAXUINT, 0,
G_PARAM_READABLE | G_PARAM_STATIC_STRINGS);
]|</doc>
<virtual-method name="get_item" version="2.44">
<doc xml:space="preserve">Get the item at @position. If @position is greater than the number of
items in @list, %NULL is returned.
@@ -46872,6 +47296,10 @@ the list at the time this function is called).</doc>
subclasses of #GObject.</doc>
<type name="GType" c:type="GType"/>
</property>
<property name="n-items" version="2.74" transfer-ownership="none">
<doc xml:space="preserve">The number of items contained in this list store.</doc>
<type name="guint" c:type="guint"/>
</property>
</class>
<record name="ListStoreClass" c:type="GListStoreClass" glib:is-gtype-struct-for="ListStore">
<field name="parent_class">
@@ -65548,7 +65976,7 @@ the socks5, socks4a, and socks4 proxy types.</doc>
<doc xml:space="preserve">a #GSimpleProxyResolver</doc>
<type name="SimpleProxyResolver" c:type="GSimpleProxyResolver*"/>
</instance-parameter>
<parameter name="default_proxy" transfer-ownership="none">
<parameter name="default_proxy" transfer-ownership="none" nullable="1" allow-none="1">
<doc xml:space="preserve">the default proxy to use</doc>
<type name="utf8" c:type="const gchar*"/>
</parameter>
@@ -67838,7 +68266,7 @@ in *@error. However, if the first call to
g_socket_address_enumerator_next() succeeds, then any further
internal errors (other than @cancellable being triggered) will be
ignored.</doc>
<return-value transfer-ownership="full">
<return-value transfer-ownership="full" nullable="1">
<doc xml:space="preserve">a #GSocketAddress (owned by the caller), or %NULL on
error (in which case *@error will be set) or if there are no
more addresses.</doc>
@@ -67889,7 +68317,7 @@ It is an error to call this multiple times before the previous callback has fini
g_socket_address_enumerator_next_async(). See
g_socket_address_enumerator_next() for more information about
error handling.</doc>
<return-value transfer-ownership="full">
<return-value transfer-ownership="full" nullable="1">
<doc xml:space="preserve">a #GSocketAddress (owned by the caller), or %NULL on
error (in which case *@error will be set) or if there are no
more addresses.</doc>
@@ -67920,7 +68348,7 @@ in *@error. However, if the first call to
g_socket_address_enumerator_next() succeeds, then any further
internal errors (other than @cancellable being triggered) will be
ignored.</doc>
<return-value transfer-ownership="full">
<return-value transfer-ownership="full" nullable="1">
<doc xml:space="preserve">a #GSocketAddress (owned by the caller), or %NULL on
error (in which case *@error will be set) or if there are no
more addresses.</doc>
@@ -67971,7 +68399,7 @@ It is an error to call this multiple times before the previous callback has fini
g_socket_address_enumerator_next_async(). See
g_socket_address_enumerator_next() for more information about
error handling.</doc>
<return-value transfer-ownership="full">
<return-value transfer-ownership="full" nullable="1">
<doc xml:space="preserve">a #GSocketAddress (owned by the caller), or %NULL on
error (in which case *@error will be set) or if there are no
more addresses.</doc>
@@ -67999,7 +68427,7 @@ error handling.</doc>
</field>
<field name="next">
<callback name="next" throws="1">
<return-value transfer-ownership="full">
<return-value transfer-ownership="full" nullable="1">
<doc xml:space="preserve">a #GSocketAddress (owned by the caller), or %NULL on
error (in which case *@error will be set) or if there are no
more addresses.</doc>
@@ -68045,7 +68473,7 @@ error handling.</doc>
</field>
<field name="next_finish">
<callback name="next_finish" throws="1">
<return-value transfer-ownership="full">
<return-value transfer-ownership="full" nullable="1">
<doc xml:space="preserve">a #GSocketAddress (owned by the caller), or %NULL on
error (in which case *@error will be set) or if there are no
more addresses.</doc>
@@ -74980,6 +75408,8 @@ certificate outside the context of making a connection, or to
check a certificate against a CA that is not part of the system
CA database.
If @cert is valid, %G_TLS_CERTIFICATE_FLAGS_NONE is returned.
If @identity is not %NULL, @cert's name(s) will be compared against
it, and %G_TLS_CERTIFICATE_BAD_IDENTITY will be set in the return
value if it does not match. If @identity is %NULL, that bit will
@@ -75151,6 +75581,8 @@ certificate outside the context of making a connection, or to
check a certificate against a CA that is not part of the system
CA database.
If @cert is valid, %G_TLS_CERTIFICATE_FLAGS_NONE is returned.
If @identity is not %NULL, @cert's name(s) will be compared against
it, and %G_TLS_CERTIFICATE_BAD_IDENTITY will be set in the return
value if it does not match. If @identity is %NULL, that bit will
@@ -75381,6 +75813,9 @@ particular type of error. For example, it would be incorrect to mask
%G_TLS_CERTIFICATE_EXPIRED if you want to allow expired certificates,
because this could potentially be the only error flag set even if
other problems exist with the certificate.</doc>
<member name="flags_none" value="0" c:identifier="G_TLS_CERTIFICATE_FLAGS_NONE" glib:nick="flags-none" glib:name="G_TLS_CERTIFICATE_FLAGS_NONE">
<doc xml:space="preserve">No flags. Since: 2.74</doc>
</member>
<member name="unknown_ca" value="1" c:identifier="G_TLS_CERTIFICATE_UNKNOWN_CA" glib:nick="unknown-ca" glib:name="G_TLS_CERTIFICATE_UNKNOWN_CA">
<doc xml:space="preserve">The signing certificate authority is
not known.</doc>
@@ -79985,9 +80420,11 @@ It may be wrapped in a #GUnixFDMessage and sent over a #GSocket in
the %G_SOCKET_FAMILY_UNIX family by using g_socket_send_message()
and received using g_socket_receive_message().
Note that `&lt;gio/gunixfdlist.h&gt;` belongs to the UNIX-specific GIO
interfaces, thus you have to use the `gio-unix-2.0.pc` pkg-config
file when using it.</doc>
Before 2.74, `&lt;gio/gunixfdlist.h&gt;` belonged to the UNIX-specific GIO
interfaces, thus you had to use the `gio-unix-2.0.pc` pkg-config file when
using it.
Since 2.74, the API is available for Windows.</doc>
<constructor name="new" c:identifier="g_unix_fd_list_new" version="2.24">
<doc xml:space="preserve">Creates a new #GUnixFDList containing no file descriptors.</doc>
<return-value transfer-ownership="full">
@@ -84372,6 +84809,52 @@ g_app_info_get_fallback_for_type().</doc>
</parameter>
</parameters>
</function>
<function name="app_info_get_default_for_type_async" c:identifier="g_app_info_get_default_for_type_async" moved-to="AppInfo.get_default_for_type_async" version="2.74">
<doc xml:space="preserve">Asynchronously gets the default #GAppInfo for a given content type.</doc>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
<parameters>
<parameter name="content_type" transfer-ownership="none">
<doc xml:space="preserve">the content type to find a #GAppInfo for</doc>
<type name="utf8" c:type="const char*"/>
</parameter>
<parameter name="must_support_uris" transfer-ownership="none">
<doc xml:space="preserve">if %TRUE, the #GAppInfo is expected to
support URIs</doc>
<type name="gboolean" c:type="gboolean"/>
</parameter>
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
<doc xml:space="preserve">optional #GCancellable object, %NULL to ignore</doc>
<type name="Cancellable" c:type="GCancellable*"/>
</parameter>
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="4">
<doc xml:space="preserve">a #GAsyncReadyCallback to call when the request is done</doc>
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
</parameter>
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
<doc xml:space="preserve">data to pass to @callback</doc>
<type name="gpointer" c:type="gpointer"/>
</parameter>
</parameters>
</function>
<function name="app_info_get_default_for_type_finish" c:identifier="g_app_info_get_default_for_type_finish" moved-to="AppInfo.get_default_for_type_finish" version="2.74" throws="1">
<doc xml:space="preserve">Finishes a default #GAppInfo lookup started by
g_app_info_get_default_for_type_async().
If no #GAppInfo is found, then @error will be set to %G_IO_ERROR_NOT_FOUND.</doc>
<return-value transfer-ownership="full">
<doc xml:space="preserve">#GAppInfo for given @content_type or
%NULL on error.</doc>
<type name="AppInfo" c:type="GAppInfo*"/>
</return-value>
<parameters>
<parameter name="result" transfer-ownership="none">
<doc xml:space="preserve">a #GAsyncResult</doc>
<type name="AsyncResult" c:type="GAsyncResult*"/>
</parameter>
</parameters>
</function>
<function name="app_info_get_default_for_uri_scheme" c:identifier="g_app_info_get_default_for_uri_scheme" moved-to="AppInfo.get_default_for_uri_scheme">
<doc xml:space="preserve">Gets the default application for handling URIs with
the given URI scheme. A URI scheme is the initial part
@@ -84389,6 +84872,50 @@ of the URI, up to but not including the ':', e.g. "http",
</parameter>
</parameters>
</function>
<function name="app_info_get_default_for_uri_scheme_async" c:identifier="g_app_info_get_default_for_uri_scheme_async" moved-to="AppInfo.get_default_for_uri_scheme_async" version="2.74">
<doc xml:space="preserve">Asynchronously gets the default application for handling URIs with
the given URI scheme. A URI scheme is the initial part
of the URI, up to but not including the ':', e.g. "http",
"ftp" or "sip".</doc>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
<parameters>
<parameter name="uri_scheme" transfer-ownership="none">
<doc xml:space="preserve">a string containing a URI scheme.</doc>
<type name="utf8" c:type="const char*"/>
</parameter>
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
<doc xml:space="preserve">optional #GCancellable object, %NULL to ignore</doc>
<type name="Cancellable" c:type="GCancellable*"/>
</parameter>
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="3">
<doc xml:space="preserve">a #GAsyncReadyCallback to call when the request is done</doc>
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
</parameter>
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
<doc xml:space="preserve">data to pass to @callback</doc>
<type name="gpointer" c:type="gpointer"/>
</parameter>
</parameters>
</function>
<function name="app_info_get_default_for_uri_scheme_finish" c:identifier="g_app_info_get_default_for_uri_scheme_finish" moved-to="AppInfo.get_default_for_uri_scheme_finish" version="2.74" throws="1">
<doc xml:space="preserve">Finishes a default #GAppInfo lookup started by
g_app_info_get_default_for_uri_scheme_async().
If no #GAppInfo is found, then @error will be set to %G_IO_ERROR_NOT_FOUND.</doc>
<return-value transfer-ownership="full">
<doc xml:space="preserve">#GAppInfo for given @uri_scheme or
%NULL on error.</doc>
<type name="AppInfo" c:type="GAppInfo*"/>
</return-value>
<parameters>
<parameter name="result" transfer-ownership="none">
<doc xml:space="preserve">a #GAsyncResult</doc>
<type name="AsyncResult" c:type="GAsyncResult*"/>
</parameter>
</parameters>
</function>
<function name="app_info_get_fallback_for_type" c:identifier="g_app_info_get_fallback_for_type" moved-to="AppInfo.get_fallback_for_type" version="2.28">
<doc xml:space="preserve">Gets a list of fallback #GAppInfos for a given content type, i.e.
those applications which claim to support the given content type
@@ -86187,6 +86714,107 @@ a temporary file could not be created.</doc>
</parameter>
</parameters>
</function>
<function name="file_new_tmp_async" c:identifier="g_file_new_tmp_async" moved-to="File.new_tmp_async" version="2.74">
<doc xml:space="preserve">Asynchronously opens a file in the preferred directory for temporary files
(as returned by g_get_tmp_dir()) as g_file_new_tmp().
@tmpl should be a string in the GLib file name encoding
containing a sequence of six 'X' characters, and containing no
directory components. If it is %NULL, a default template is used.</doc>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
<parameters>
<parameter name="tmpl" transfer-ownership="none" nullable="1" allow-none="1">
<doc xml:space="preserve">Template for the file
name, as in g_file_open_tmp(), or %NULL for a default template</doc>
<type name="filename" c:type="const char*"/>
</parameter>
<parameter name="io_priority" transfer-ownership="none">
<doc xml:space="preserve">the [I/O priority][io-priority] of the request</doc>
<type name="gint" c:type="int"/>
</parameter>
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
<doc xml:space="preserve">optional #GCancellable object, %NULL to ignore</doc>
<type name="Cancellable" c:type="GCancellable*"/>
</parameter>
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="4">
<doc xml:space="preserve">a #GAsyncReadyCallback to call when the request is done</doc>
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
</parameter>
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
<doc xml:space="preserve">data to pass to @callback</doc>
<type name="gpointer" c:type="gpointer"/>
</parameter>
</parameters>
</function>
<function name="file_new_tmp_dir_async" c:identifier="g_file_new_tmp_dir_async" moved-to="File.new_tmp_dir_async" version="2.74">
<doc xml:space="preserve">Asynchronously creates a directory in the preferred directory for
temporary files (as returned by g_get_tmp_dir()) as g_dir_make_tmp().
@tmpl should be a string in the GLib file name encoding
containing a sequence of six 'X' characters, and containing no
directory components. If it is %NULL, a default template is used.</doc>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
<parameters>
<parameter name="tmpl" transfer-ownership="none" nullable="1" allow-none="1">
<doc xml:space="preserve">Template for the file
name, as in g_dir_make_tmp(), or %NULL for a default template</doc>
<type name="filename" c:type="const char*"/>
</parameter>
<parameter name="io_priority" transfer-ownership="none">
<doc xml:space="preserve">the [I/O priority][io-priority] of the request</doc>
<type name="gint" c:type="int"/>
</parameter>
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
<doc xml:space="preserve">optional #GCancellable object, %NULL to ignore</doc>
<type name="Cancellable" c:type="GCancellable*"/>
</parameter>
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="4">
<doc xml:space="preserve">a #GAsyncReadyCallback to call when the request is done</doc>
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
</parameter>
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
<doc xml:space="preserve">data to pass to @callback</doc>
<type name="gpointer" c:type="gpointer"/>
</parameter>
</parameters>
</function>
<function name="file_new_tmp_dir_finish" c:identifier="g_file_new_tmp_dir_finish" moved-to="File.new_tmp_dir_finish" version="2.74" throws="1">
<doc xml:space="preserve">Finishes a temporary directory creation started by
g_file_new_tmp_dir_async().</doc>
<return-value transfer-ownership="full">
<doc xml:space="preserve">a new #GFile.
Free the returned object with g_object_unref().</doc>
<type name="File" c:type="GFile*"/>
</return-value>
<parameters>
<parameter name="result" transfer-ownership="none">
<doc xml:space="preserve">a #GAsyncResult</doc>
<type name="AsyncResult" c:type="GAsyncResult*"/>
</parameter>
</parameters>
</function>
<function name="file_new_tmp_finish" c:identifier="g_file_new_tmp_finish" moved-to="File.new_tmp_finish" version="2.74" throws="1">
<doc xml:space="preserve">Finishes a temporary file creation started by g_file_new_tmp_async().</doc>
<return-value transfer-ownership="full">
<doc xml:space="preserve">a new #GFile.
Free the returned object with g_object_unref().</doc>
<type name="File" c:type="GFile*"/>
</return-value>
<parameters>
<parameter name="result" transfer-ownership="none">
<doc xml:space="preserve">a #GAsyncResult</doc>
<type name="AsyncResult" c:type="GAsyncResult*"/>
</parameter>
<parameter name="iostream" direction="out" caller-allocates="0" transfer-ownership="full">
<doc xml:space="preserve">on return, a #GFileIOStream for the created file</doc>
<type name="FileIOStream" c:type="GFileIOStream**"/>
</parameter>
</parameters>
</function>
<function name="file_parse_name" c:identifier="g_file_parse_name" moved-to="File.parse_name">
<doc xml:space="preserve">Constructs a #GFile with the given @parse_name (i.e. something
given by g_file_get_parse_name()). This operation never fails,
@@ -86653,6 +87281,19 @@ calls, you should save its value as soon as the call which sets it</doc>
</parameter>
</parameters>
</function>
<function name="io_error_from_file_error" c:identifier="g_io_error_from_file_error" version="2.74">
<doc xml:space="preserve">Converts #GFileError error codes into GIO error codes.</doc>
<return-value transfer-ownership="none">
<doc xml:space="preserve">#GIOErrorEnum value for the given #GFileError error value.</doc>
<type name="IOErrorEnum" c:type="GIOErrorEnum"/>
</return-value>
<parameters>
<parameter name="file_error" transfer-ownership="none">
<doc xml:space="preserve">a #GFileError.</doc>
<type name="GLib.FileError" c:type="GFileError"/>
</parameter>
</parameters>
</function>
<function name="io_error_quark" c:identifier="g_io_error_quark">
<doc xml:space="preserve">Gets the GIO Error Quark.</doc>
<return-value transfer-ownership="none">

27
Gtk-3.0.gir
View File

@@ -97007,7 +97007,30 @@ animatable regions.</doc>
<doc xml:space="preserve">Retrieves several style property values from @context for a
given state.
See gtk_style_context_get_property() for details.</doc>
See gtk_style_context_get_property() for details.
For the property name / return value pairs, it works similarly as
g_object_get(). Example:
|[&lt;!-- language="C" --&gt;
GdkRGBA *background_color = NULL;
PangoFontDescription *font_desc = NULL;
gint border_radius = 0;
gtk_style_context_get (style_context,
gtk_style_context_get_state (style_context),
GTK_STYLE_PROPERTY_BACKGROUND_COLOR, &amp;background_color,
GTK_STYLE_PROPERTY_FONT, &amp;font_desc,
GTK_STYLE_PROPERTY_BORDER_RADIUS, &amp;border_radius,
NULL);
// Do something with the property values.
if (background_color != NULL)
gdk_rgba_free (background_color);
if (font_desc != NULL)
pango_font_description_free (font_desc);
]|</doc>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
@@ -97021,7 +97044,7 @@ See gtk_style_context_get_property() for details.</doc>
<type name="StateFlags" c:type="GtkStateFlags"/>
</parameter>
<parameter name="..." transfer-ownership="none">
<doc xml:space="preserve">property name /return value pairs, followed by %NULL</doc>
<doc xml:space="preserve">property name / return value pairs, followed by %NULL</doc>
<varargs/>
</parameter>
</parameters>

137
Gtk-4.0.gir
View File

@@ -1942,6 +1942,13 @@ contains an internal centered box which is centered with respect to
the full width of the box, even if the children at either side take
up different amounts of space.
# GtkActionBar as GtkBuildable
The `GtkActionBar` implementation of the `GtkBuildable` interface supports
adding children at the start or end sides by specifying &#x201C;start&#x201D; or &#x201C;end&#x201D; as
the &#x201C;type&#x201D; attribute of a `&lt;child&gt;` element, or setting the center widget
by specifying &#x201C;center&#x201D; value.
# CSS nodes
```
@@ -5602,7 +5609,7 @@ See gtk_assistant_commit() for details.</doc>
add its own buttons through gtk_assistant_add_action_widget().</doc>
</member>
</enumeration>
<constant name="BINARY_AGE" value="700" c:type="GTK_BINARY_AGE">
<constant name="BINARY_AGE" value="701" c:type="GTK_BINARY_AGE">
<doc xml:space="preserve">Like [func@get_binary_age], but from the headers used at
application compile time, rather than from the library linked
against at application run time.</doc>
@@ -52736,7 +52743,7 @@ against at application run time.</doc>
</parameter>
</parameters>
</function-macro>
<constant name="MICRO_VERSION" value="0" c:type="GTK_MICRO_VERSION">
<constant name="MICRO_VERSION" value="1" c:type="GTK_MICRO_VERSION">
<doc xml:space="preserve">Like [func@get_micro_version], but from the headers used at
application compile time, rather than from the library linked
against at application run time.</doc>
@@ -72208,6 +72215,7 @@ a `.search` style class, and the text node is a child of that.
</parameters>
</method>
<method name="get_search_delay" c:identifier="gtk_search_entry_get_search_delay" glib:get-property="search-delay" version="4.8">
<attribute name="org.gtk.Property.get_property" value="search-delay"/>
<doc xml:space="preserve">Get the delay to be used between the last keypress and the
[signal@Gtk.SearchEntry::search-changed] signal being emitted.</doc>
<return-value transfer-ownership="none">
@@ -72254,6 +72262,7 @@ capture and forward the events yourself with
</parameters>
</method>
<method name="set_search_delay" c:identifier="gtk_search_entry_set_search_delay" glib:set-property="search-delay" version="4.8">
<attribute name="org.gtk.Property.set_property" value="search-delay"/>
<doc xml:space="preserve">Set the delay to be used between the last keypress and the
[signal@Gtk.SearchEntry::search-changed] signal being emitted.</doc>
<return-value transfer-ownership="none">
@@ -75078,11 +75087,12 @@ You need to connect signal handlers before you use it.</doc>
</return-value>
</constructor>
<glib:signal name="bind" when="first">
<doc xml:space="preserve">Emitted when a new [property@Gtk.ListItem:item] has been set
on the @listitem and should be bound for use.
<doc xml:space="preserve">Emitted when an object has been bound, for example when a
new [property@Gtk.ListItem:item] has been set on a
`GtkListItem` and should be bound for use.
After this signal was emitted, the listitem might be shown in
a [class@Gtk.ListView] or other list widget.
After this signal was emitted, the object might be shown in
a [class@Gtk.ListView] or other widget.
The [signal@Gtk.SignalListItemFactory::unbind] signal is the
opposite of this signal and can be used to undo everything done
@@ -75091,9 +75101,9 @@ in this signal.</doc>
<type name="none" c:type="void"/>
</return-value>
<parameters>
<parameter name="listitem" transfer-ownership="none">
<doc xml:space="preserve">The `GtkListItem` to bind</doc>
<type name="ListItem"/>
<parameter name="object" transfer-ownership="none">
<doc xml:space="preserve">The `GObject` to bind</doc>
<type name="GObject.Object"/>
</parameter>
</parameters>
</glib:signal>
@@ -75108,16 +75118,16 @@ of this signal and can be used to undo everything done in this signal.</doc>
<type name="none" c:type="void"/>
</return-value>
<parameters>
<parameter name="listitem" transfer-ownership="none">
<doc xml:space="preserve">The `GtkListItem` to set up</doc>
<type name="ListItem"/>
<parameter name="object" transfer-ownership="none">
<doc xml:space="preserve">The `GObject` to set up</doc>
<type name="GObject.Object"/>
</parameter>
</parameters>
</glib:signal>
<glib:signal name="teardown" when="first">
<doc xml:space="preserve">Emitted when a listitem is about to be destroyed.
<doc xml:space="preserve">Emitted when an object is about to be destroyed.
It is the last signal ever emitted for this @listitem.
It is the last signal ever emitted for this @object.
This signal is the opposite of the [signal@Gtk.SignalListItemFactory::setup]
signal and should be used to undo everything done in that signal.</doc>
@@ -75125,14 +75135,15 @@ signal and should be used to undo everything done in that signal.</doc>
<type name="none" c:type="void"/>
</return-value>
<parameters>
<parameter name="listitem" transfer-ownership="none">
<doc xml:space="preserve">The `GtkListItem` to teardown</doc>
<type name="ListItem"/>
<parameter name="object" transfer-ownership="none">
<doc xml:space="preserve">The `GObject` to tear down</doc>
<type name="GObject.Object"/>
</parameter>
</parameters>
</glib:signal>
<glib:signal name="unbind" when="first">
<doc xml:space="preserve">Emitted when a listitem has been removed from use in a list widget
<doc xml:space="preserve">Emitted when a object has been unbound from its item, for example when
a listitem was removed from use in a list widget
and its new [property@Gtk.ListItem:item] is about to be unset.
This signal is the opposite of the [signal@Gtk.SignalListItemFactory::bind]
@@ -75141,9 +75152,9 @@ signal and should be used to undo everything done in that signal.</doc>
<type name="none" c:type="void"/>
</return-value>
<parameters>
<parameter name="listitem" transfer-ownership="none">
<doc xml:space="preserve">The `GtkListItem` to unbind</doc>
<type name="ListItem"/>
<parameter name="object" transfer-ownership="none">
<doc xml:space="preserve">The `GObject` to unbind</doc>
<type name="GObject.Object"/>
</parameter>
</parameters>
</glib:signal>
@@ -101347,11 +101358,29 @@ instance initialization function:
static void
foo_widget_init (FooWidget *self)
{
// ...
gtk_widget_init_template (GTK_WIDGET (self));
// Initialize the rest of the widget...
}
```
as well as calling [method@Gtk.Widget.dispose_template] from the dispose
function:
```c
static void
foo_widget_dispose (GObject *gobject)
{
FooWidget *self = FOO_WIDGET (gobject);
// Dispose objects for which you have a reference...
// Clear the template children for this widget type
gtk_widget_dispose_template (GTK_WIDGET (self), FOO_TYPE_WIDGET);
G_OBJECT_CLASS (foo_widget_parent_class)-&gt;dispose (gobject);
}
You can access widgets defined in the template using the
[id@gtk_widget_get_template_child] function, but you will typically declare
a pointer in the instance private data structure of your type using the same
@@ -101368,10 +101397,20 @@ typedef struct {
G_DEFINE_TYPE_WITH_PRIVATE (FooWidget, foo_widget, GTK_TYPE_BOX)
static void
foo_widget_dispose (GObject *gobject)
{
gtk_widget_dispose_template (GTK_WIDGET (gobject), FOO_TYPE_WIDGET);
G_OBJECT_CLASS (foo_widget_parent_class)-&gt;dispose (gobject);
}
static void
foo_widget_class_init (FooWidgetClass *klass)
{
// ...
G_OBJECT_CLASS (klass)-&gt;dispose = foo_widget_dispose;
gtk_widget_class_set_template_from_resource (GTK_WIDGET_CLASS (klass),
"/com/example/ui/foowidget.ui");
gtk_widget_class_bind_template_child_private (GTK_WIDGET_CLASS (klass),
@@ -101383,7 +101422,7 @@ foo_widget_class_init (FooWidgetClass *klass)
static void
foo_widget_init (FooWidget *widget)
{
gtk_widget_init_template (GTK_WIDGET (widget));
}
```
@@ -102395,6 +102434,46 @@ of the [property@Gtk.Widget:root] property on the widget.</doc>
</parameter>
</parameters>
</method>
<method name="dispose_template" c:identifier="gtk_widget_dispose_template" version="4.8">
<doc xml:space="preserve">Clears the template children for the given widget.
This function is the opposite of [method@Gtk.Widget.init_template], and
it is used to clear all the template children from a widget instance.
If you bound a template child to a field in the instance structure, or
in the instance private data structure, the field will be set to `NULL`
after this function returns.
You should call this function inside the `GObjectClass.dispose()`
implementation of any widget that called `gtk_widget_init_template()`.
Typically, you will want to call this function last, right before
chaining up to the parent type's dispose implementation, e.g.
```c
static void
some_widget_dispose (GObject *gobject)
{
SomeWidget *self = SOME_WIDGET (gobject);
// Clear the template data for SomeWidget
gtk_widget_dispose_template (GTK_WIDGET (self), SOME_TYPE_WIDGET);
G_OBJECT_CLASS (some_widget_parent_class)-&gt;dispose (gobject);
}
```</doc>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
<parameters>
<instance-parameter name="widget" transfer-ownership="none">
<doc xml:space="preserve">the widget with a template</doc>
<type name="Widget" c:type="GtkWidget*"/>
</instance-parameter>
<parameter name="widget_type" transfer-ownership="none">
<doc xml:space="preserve">the type of the widget to finalize the template for</doc>
<type name="GType" c:type="GType"/>
</parameter>
</parameters>
</method>
<method name="drag_check_threshold" c:identifier="gtk_drag_check_threshold">
<doc xml:space="preserve">Checks to see if a drag movement has passed the GTK drag threshold.</doc>
<return-value transfer-ownership="none">
@@ -109308,6 +109387,18 @@ If @set is empty, %FALSE is returned.</doc>
</parameter>
</parameters>
</function>
<function-macro name="builder_cscope_add_callback" c:identifier="gtk_builder_cscope_add_callback" version="4.8" introspectable="0">
<doc xml:space="preserve">Adds the @callback_symbol to the scope of @builder under its
own name.
This is a convenience wrapper of [method@Gtk.BuilderCScope.add_callback_symbol].</doc>
<parameters>
<parameter name="scope">
</parameter>
<parameter name="callback">
</parameter>
</parameters>
</function-macro>
<function name="builder_error_quark" c:identifier="gtk_builder_error_quark" moved-to="BuilderError.quark">
<return-value transfer-ownership="none">
<type name="GLib.Quark" c:type="GQuark"/>

1381
HarfBuzz-0.0.gir
View File

File diff suppressed because it is too large Load Diff

23
Pango-1.0.gir
View File

@@ -4,6 +4,7 @@ To affect the contents of this file, edit the original C definitions,
and/or use gtk-doc annotations. -->
<repository xmlns="http://www.gtk.org/introspection/core/1.0" xmlns:c="http://www.gtk.org/introspection/c/1.0" xmlns:glib="http://www.gtk.org/introspection/glib/1.0" version="1.2">
<include name="GObject" version="2.0"/>
<include name="Gio" version="2.0"/>
<include name="HarfBuzz" version="0.0"/>
<include name="cairo" version="1.0"/>
<package name="pango"/>
@@ -4128,6 +4129,7 @@ font faces.
The font faces in a family share a common design, but differ in
slant, weight, width or other aspects.</doc>
<implements name="Gio.ListModel"/>
<virtual-method name="get_face" invoker="get_face" version="1.46">
<doc xml:space="preserve">Gets the `PangoFontFace` of @family with the given name.</doc>
<return-value transfer-ownership="none" nullable="1">
@@ -4358,6 +4360,14 @@ for enumerating faces.</doc>
</parameter>
</parameters>
</method>
<property name="item-type" transfer-ownership="none">
<doc xml:space="preserve">The type of items contained in this list.</doc>
<type name="GType" c:type="GType"/>
</property>
<property name="n-items" transfer-ownership="none">
<doc xml:space="preserve">The number of items contained in this list.</doc>
<type name="guint" c:type="guint"/>
</property>
<field name="parent_instance">
<type name="GObject.Object" c:type="GObject"/>
</field>
@@ -4470,6 +4480,7 @@ particular rendering system.
This is a virtual object with implementations being specific to
particular rendering systems.</doc>
<implements name="Gio.ListModel"/>
<virtual-method name="changed" invoker="changed" version="1.34">
<doc xml:space="preserve">Forces a change in the context, which will cause any `PangoContext`
using this fontmap to change.
@@ -4779,6 +4790,14 @@ a font matching @desc.</doc>
</parameter>
</parameters>
</method>
<property name="item-type" transfer-ownership="none">
<doc xml:space="preserve">The type of items contained in this list.</doc>
<type name="GType" c:type="GType"/>
</property>
<property name="n-items" transfer-ownership="none">
<doc xml:space="preserve">The number of items contained in this list.</doc>
<type name="guint" c:type="guint"/>
</property>
<field name="parent_instance">
<type name="GObject.Object" c:type="GObject"/>
</field>
@@ -12005,7 +12024,7 @@ Two encoded version numbers can be compared as integers.</doc>
<doc xml:space="preserve">The major component of the version of Pango available at compile-time.</doc>
<type name="gint" c:type="gint"/>
</constant>
<constant name="VERSION_MICRO" value="7" c:type="PANGO_VERSION_MICRO">
<constant name="VERSION_MICRO" value="8" c:type="PANGO_VERSION_MICRO">
<doc xml:space="preserve">The micro component of the version of Pango available at compile-time.</doc>
<type name="gint" c:type="gint"/>
</constant>
@@ -12013,7 +12032,7 @@ Two encoded version numbers can be compared as integers.</doc>
<doc xml:space="preserve">The minor component of the version of Pango available at compile-time.</doc>
<type name="gint" c:type="gint"/>
</constant>
<constant name="VERSION_STRING" value="1.50.7" c:type="PANGO_VERSION_STRING">
<constant name="VERSION_STRING" value="1.50.8" c:type="PANGO_VERSION_STRING">
<doc xml:space="preserve">A string literal containing the version of Pango available at compile-time.</doc>
<type name="utf8" c:type="gchar*"/>
</constant>

1
PangoFT2-1.0.gir
View File

@@ -16,6 +16,7 @@ and/or use gtk-doc annotations. -->
</function-macro>
<class name="FontMap" c:symbol-prefix="font_map" c:type="PangoFT2FontMap" parent="PangoFc.FontMap" glib:type-name="PangoFT2FontMap" glib:get-type="pango_ft2_font_map_get_type">
<doc xml:space="preserve">The `PangoFT2FontMap` is the `PangoFontMap` implementation for FreeType fonts.</doc>
<implements name="Gio.ListModel"/>
<constructor name="new" c:identifier="pango_ft2_font_map_new" version="1.2">
<doc xml:space="preserve">Create a new `PangoFT2FontMap` object.

7
PangoFc-1.0.gir
View File

@@ -429,7 +429,7 @@ This face will be kept around until you call
<doc-deprecated xml:space="preserve">Use pango_font_get_hb_font() instead</doc-deprecated>
<return-value>
<doc xml:space="preserve">the FreeType `FT_Face` associated with @font.</doc>
<type c:type="FT_Face"/>
<type name="freetype2.Face" c:type="FT_Face"/>
</return-value>
<parameters>
<instance-parameter name="font" transfer-ownership="none">
@@ -499,6 +499,7 @@ It is used in the Xft and FreeType backends shipped with Pango,
but can also be used when creating new backends. Any backend
deriving from this base class will take advantage of the wide
range of shapers implemented using FreeType that come with Pango.</doc>
<implements name="Gio.ListModel"/>
<method name="add_decoder_find_func" c:identifier="pango_fc_font_map_add_decoder_find_func" version="1.6" introspectable="0">
<doc xml:space="preserve">This function saves a callback method in the `PangoFcFontMap` that
will be called whenever new fonts are created.
@@ -612,7 +613,7 @@ See also: [method@PangoFc.FontMap.set_config].</doc>
<doc xml:space="preserve">the `FcConfig` object attached to
@fcfontmap, which might be %NULL. The return value is
owned by Pango and should not be freed.</doc>
<type c:type="FcConfig*"/>
<type name="fontconfig.Config" c:type="FcConfig*"/>
</return-value>
<parameters>
<instance-parameter name="fcfontmap" transfer-ownership="none">
@@ -666,7 +667,7 @@ does **not** need to retain a reference.</doc>
</instance-parameter>
<parameter name="fcconfig" transfer-ownership="none" nullable="1" allow-none="1">
<doc xml:space="preserve">a `FcConfig`</doc>
<type c:type="FcConfig*"/>
<type name="fontconfig.Config" c:type="FcConfig*"/>
</parameter>
</parameters>
</method>

1
fontconfig-2.0.gir
View File

@@ -3,6 +3,7 @@
<namespace name="fontconfig" version="2.0" c:identifier-prefixes="Fc" c:symbol-prefixes="fc">
<record name="Pattern" c:type="FcPattern"/>
<record name="CharSet" c:type="FcCharSet"/>
<record name="Config" c:type="FcConfig"/>
<function name="init" c:identifier="FcInit">
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>