gobject-introspection 3.1.8-x86-mingw32 → 3.1.9-x86-mingw32
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/Rakefile +2 -2
- data/ext/gobject-introspection/rb-gi-argument.c +49 -9
- data/ext/gobject-introspection/rb-gi-loader.c +74 -1
- data/lib/2.2/gobject_introspection.so +0 -0
- data/lib/2.3/gobject_introspection.so +0 -0
- data/lib/2.4/gobject_introspection.so +0 -0
- data/test/run-test.rb +1 -1
- data/vendor/local/bin/g-ir-compiler.exe +0 -0
- data/vendor/local/bin/g-ir-generate.exe +0 -0
- data/vendor/local/bin/g-ir-inspect.exe +0 -0
- data/vendor/local/bin/libgirepository-1.0-1.dll +0 -0
- data/vendor/local/lib/girepository-1.0/GLib-2.0.typelib +0 -0
- data/vendor/local/lib/girepository-1.0/GModule-2.0.typelib +0 -0
- data/vendor/local/lib/girepository-1.0/GObject-2.0.typelib +0 -0
- data/vendor/local/lib/girepository-1.0/Gio-2.0.typelib +0 -0
- data/vendor/local/lib/girepository-1.0/cairo-1.0.typelib +0 -0
- data/vendor/local/lib/gobject-introspection/giscanner/__init__.pyc +0 -0
- data/vendor/local/lib/gobject-introspection/giscanner/__init__.pyo +0 -0
- data/vendor/local/lib/gobject-introspection/giscanner/annotationmain.pyc +0 -0
- data/vendor/local/lib/gobject-introspection/giscanner/annotationmain.pyo +0 -0
- data/vendor/local/lib/gobject-introspection/giscanner/annotationparser.pyc +0 -0
- data/vendor/local/lib/gobject-introspection/giscanner/annotationparser.pyo +0 -0
- data/vendor/local/lib/gobject-introspection/giscanner/ast.pyc +0 -0
- data/vendor/local/lib/gobject-introspection/giscanner/ast.pyo +0 -0
- data/vendor/local/lib/gobject-introspection/giscanner/cachestore.py +8 -14
- data/vendor/local/lib/gobject-introspection/giscanner/cachestore.pyc +0 -0
- data/vendor/local/lib/gobject-introspection/giscanner/cachestore.pyo +0 -0
- data/vendor/local/lib/gobject-introspection/giscanner/ccompiler.py +48 -51
- data/vendor/local/lib/gobject-introspection/giscanner/ccompiler.pyc +0 -0
- data/vendor/local/lib/gobject-introspection/giscanner/ccompiler.pyo +0 -0
- data/vendor/local/lib/gobject-introspection/giscanner/codegen.pyc +0 -0
- data/vendor/local/lib/gobject-introspection/giscanner/codegen.pyo +0 -0
- data/vendor/local/lib/gobject-introspection/giscanner/collections/__init__.pyc +0 -0
- data/vendor/local/lib/gobject-introspection/giscanner/collections/__init__.pyo +0 -0
- data/vendor/local/lib/gobject-introspection/giscanner/collections/counter.pyc +0 -0
- data/vendor/local/lib/gobject-introspection/giscanner/collections/counter.pyo +0 -0
- data/vendor/local/lib/gobject-introspection/giscanner/collections/ordereddict.pyc +0 -0
- data/vendor/local/lib/gobject-introspection/giscanner/collections/ordereddict.pyo +0 -0
- data/vendor/local/lib/gobject-introspection/giscanner/docmain.pyc +0 -0
- data/vendor/local/lib/gobject-introspection/giscanner/docmain.pyo +0 -0
- data/vendor/local/lib/gobject-introspection/giscanner/docwriter.pyc +0 -0
- data/vendor/local/lib/gobject-introspection/giscanner/docwriter.pyo +0 -0
- data/vendor/local/lib/gobject-introspection/giscanner/dumper.py +39 -66
- data/vendor/local/lib/gobject-introspection/giscanner/dumper.pyc +0 -0
- data/vendor/local/lib/gobject-introspection/giscanner/dumper.pyo +0 -0
- data/vendor/local/lib/gobject-introspection/giscanner/gdumpparser.pyc +0 -0
- data/vendor/local/lib/gobject-introspection/giscanner/gdumpparser.pyo +0 -0
- data/vendor/local/lib/gobject-introspection/giscanner/girparser.pyc +0 -0
- data/vendor/local/lib/gobject-introspection/giscanner/girparser.pyo +0 -0
- data/vendor/local/lib/gobject-introspection/giscanner/girwriter.pyc +0 -0
- data/vendor/local/lib/gobject-introspection/giscanner/girwriter.pyo +0 -0
- data/vendor/local/lib/gobject-introspection/giscanner/introspectablepass.pyc +0 -0
- data/vendor/local/lib/gobject-introspection/giscanner/introspectablepass.pyo +0 -0
- data/vendor/local/lib/gobject-introspection/giscanner/libtoolimporter.pyc +0 -0
- data/vendor/local/lib/gobject-introspection/giscanner/libtoolimporter.pyo +0 -0
- data/vendor/local/lib/gobject-introspection/giscanner/maintransformer.pyc +0 -0
- data/vendor/local/lib/gobject-introspection/giscanner/maintransformer.pyo +0 -0
- data/vendor/local/lib/gobject-introspection/giscanner/message.pyc +0 -0
- data/vendor/local/lib/gobject-introspection/giscanner/message.pyo +0 -0
- data/vendor/local/lib/gobject-introspection/giscanner/msvccompiler.pyc +0 -0
- data/vendor/local/lib/gobject-introspection/giscanner/msvccompiler.pyo +0 -0
- data/vendor/local/lib/gobject-introspection/giscanner/scannermain.pyc +0 -0
- data/vendor/local/lib/gobject-introspection/giscanner/scannermain.pyo +0 -0
- data/vendor/local/lib/gobject-introspection/giscanner/sectionparser.pyc +0 -0
- data/vendor/local/lib/gobject-introspection/giscanner/sectionparser.pyo +0 -0
- data/vendor/local/lib/gobject-introspection/giscanner/shlibs.pyc +0 -0
- data/vendor/local/lib/gobject-introspection/giscanner/shlibs.pyo +0 -0
- data/vendor/local/lib/gobject-introspection/giscanner/sourcescanner.py +3 -1
- data/vendor/local/lib/gobject-introspection/giscanner/sourcescanner.pyc +0 -0
- data/vendor/local/lib/gobject-introspection/giscanner/sourcescanner.pyo +0 -0
- data/vendor/local/lib/gobject-introspection/giscanner/testcodegen.pyc +0 -0
- data/vendor/local/lib/gobject-introspection/giscanner/testcodegen.pyo +0 -0
- data/vendor/local/lib/gobject-introspection/giscanner/transformer.pyc +0 -0
- data/vendor/local/lib/gobject-introspection/giscanner/transformer.pyo +0 -0
- data/vendor/local/lib/gobject-introspection/giscanner/utils.py +3 -3
- data/vendor/local/lib/gobject-introspection/giscanner/utils.pyc +0 -0
- data/vendor/local/lib/gobject-introspection/giscanner/utils.pyo +0 -0
- data/vendor/local/lib/gobject-introspection/giscanner/xmlwriter.pyc +0 -0
- data/vendor/local/lib/gobject-introspection/giscanner/xmlwriter.pyo +0 -0
- data/vendor/local/lib/libgirepository-1.0.a +0 -0
- data/vendor/local/lib/libgirepository-1.0.dll.a +0 -0
- data/vendor/local/lib/pkgconfig/gobject-introspection-1.0.pc +1 -1
- data/vendor/local/lib/pkgconfig/gobject-introspection-no-export-1.0.pc +1 -1
- data/vendor/local/share/gir-1.0/GLib-2.0.gir +579 -528
- data/vendor/local/share/gir-1.0/GModule-2.0.gir +0 -25
- data/vendor/local/share/gir-1.0/GObject-2.0.gir +160 -3
- data/vendor/local/share/gir-1.0/Gio-2.0.gir +198 -83
- data/vendor/local/share/gir-1.0/cairo-1.0.gir +622 -21
- data/vendor/local/share/gir-1.0/gir-1.2.rnc +479 -0
- data/vendor/local/share/gobject-introspection-1.0/tests/annotation.c +2 -1
- data/vendor/local/share/gobject-introspection-1.0/tests/annotation.h +1 -1
- data/vendor/local/share/gobject-introspection-1.0/tests/regress.c +50 -1
- data/vendor/local/share/gobject-introspection-1.0/tests/regress.h +7 -0
- metadata +5 -4
@@ -59,16 +59,6 @@ If @module refers to the application itself, "main" is returned.</doc>
|
|
59
59
|
</instance-parameter>
|
60
60
|
</parameters>
|
61
61
|
</method>
|
62
|
-
<method name="name_utf8" c:identifier="g_module_name_utf8">
|
63
|
-
<return-value transfer-ownership="none">
|
64
|
-
<type name="utf8" c:type="const gchar*"/>
|
65
|
-
</return-value>
|
66
|
-
<parameters>
|
67
|
-
<instance-parameter name="module" transfer-ownership="none">
|
68
|
-
<type name="Module" c:type="GModule*"/>
|
69
|
-
</instance-parameter>
|
70
|
-
</parameters>
|
71
|
-
</method>
|
72
62
|
<method name="symbol" c:identifier="g_module_symbol">
|
73
63
|
<doc xml:space="preserve">Gets a symbol pointer from a module, such as one exported
|
74
64
|
by #G_MODULE_EXPORT. Note that a valid symbol can be %NULL.</doc>
|
@@ -170,21 +160,6 @@ returned.</doc>
|
|
170
160
|
</parameter>
|
171
161
|
</parameters>
|
172
162
|
</function>
|
173
|
-
<function name="open_utf8"
|
174
|
-
c:identifier="g_module_open_utf8"
|
175
|
-
introspectable="0">
|
176
|
-
<return-value>
|
177
|
-
<type name="Module" c:type="GModule*"/>
|
178
|
-
</return-value>
|
179
|
-
<parameters>
|
180
|
-
<parameter name="file_name" transfer-ownership="none">
|
181
|
-
<type name="utf8" c:type="const gchar*"/>
|
182
|
-
</parameter>
|
183
|
-
<parameter name="flags" transfer-ownership="none">
|
184
|
-
<type name="ModuleFlags" c:type="GModuleFlags"/>
|
185
|
-
</parameter>
|
186
|
-
</parameters>
|
187
|
-
</function>
|
188
163
|
<function name="supported" c:identifier="g_module_supported">
|
189
164
|
<doc xml:space="preserve">Checks if modules are supported on the current platform.</doc>
|
190
165
|
<return-value transfer-ownership="none">
|
@@ -3902,7 +3902,7 @@ zeros before this function is called.</doc>
|
|
3902
3902
|
to the #GObject implementation and should never be accessed directly.</doc>
|
3903
3903
|
<constructor name="new"
|
3904
3904
|
c:identifier="g_object_new"
|
3905
|
-
shadowed-by="
|
3905
|
+
shadowed-by="new_with_properties"
|
3906
3906
|
introspectable="0">
|
3907
3907
|
<doc xml:space="preserve">Creates a new instance of a #GObject subtype and sets its properties.
|
3908
3908
|
|
@@ -3956,11 +3956,54 @@ which are not explicitly specified are set to their default values.</doc>
|
|
3956
3956
|
</parameter>
|
3957
3957
|
</parameters>
|
3958
3958
|
</constructor>
|
3959
|
-
<constructor name="
|
3959
|
+
<constructor name="new_with_properties"
|
3960
|
+
c:identifier="g_object_new_with_properties"
|
3961
|
+
shadows="new"
|
3962
|
+
version="2.54">
|
3963
|
+
<doc xml:space="preserve">Creates a new instance of a #GObject subtype and sets its properties using
|
3964
|
+
the provided arrays. Both arrays must have exactly @n_properties elements,
|
3965
|
+
and the names and values correspond by index.
|
3966
|
+
|
3967
|
+
Construction parameters (see %G_PARAM_CONSTRUCT, %G_PARAM_CONSTRUCT_ONLY)
|
3968
|
+
which are not explicitly specified are set to their default values.</doc>
|
3969
|
+
<return-value transfer-ownership="full">
|
3970
|
+
<doc xml:space="preserve">a new instance of
|
3971
|
+
@object_type</doc>
|
3972
|
+
<type name="Object" c:type="GObject*"/>
|
3973
|
+
</return-value>
|
3974
|
+
<parameters>
|
3975
|
+
<parameter name="object_type" transfer-ownership="none">
|
3976
|
+
<doc xml:space="preserve">the object type to instantiate</doc>
|
3977
|
+
<type name="GType" c:type="GType"/>
|
3978
|
+
</parameter>
|
3979
|
+
<parameter name="n_properties" transfer-ownership="none">
|
3980
|
+
<doc xml:space="preserve">the number of properties</doc>
|
3981
|
+
<type name="guint" c:type="guint"/>
|
3982
|
+
</parameter>
|
3983
|
+
<parameter name="names" transfer-ownership="none">
|
3984
|
+
<doc xml:space="preserve">the names of each property to be set</doc>
|
3985
|
+
<array length="1" zero-terminated="0" c:type="char*">
|
3986
|
+
<type name="utf8" c:type="char"/>
|
3987
|
+
</array>
|
3988
|
+
</parameter>
|
3989
|
+
<parameter name="values" transfer-ownership="none">
|
3990
|
+
<doc xml:space="preserve">the values of each property to be set</doc>
|
3991
|
+
<array length="1" zero-terminated="0" c:type="GValue">
|
3992
|
+
<type name="Value" c:type="GValue"/>
|
3993
|
+
</array>
|
3994
|
+
</parameter>
|
3995
|
+
</parameters>
|
3996
|
+
</constructor>
|
3997
|
+
<constructor name="newv"
|
3998
|
+
c:identifier="g_object_newv"
|
3999
|
+
deprecated="1"
|
4000
|
+
deprecated-version="2.54">
|
3960
4001
|
<doc xml:space="preserve">Creates a new instance of a #GObject subtype and sets its properties.
|
3961
4002
|
|
3962
4003
|
Construction parameters (see #G_PARAM_CONSTRUCT, #G_PARAM_CONSTRUCT_ONLY)
|
3963
4004
|
which are not explicitly specified are set to their default values.</doc>
|
4005
|
+
<doc-deprecated xml:space="preserve">Use g_object_new_with_properties() instead.
|
4006
|
+
deprecated. See #GParameter for more information.</doc-deprecated>
|
3964
4007
|
<return-value transfer-ownership="full">
|
3965
4008
|
<doc xml:space="preserve">a new instance of
|
3966
4009
|
@object_type</doc>
|
@@ -4827,6 +4870,37 @@ See g_object_get().</doc>
|
|
4827
4870
|
</parameter>
|
4828
4871
|
</parameters>
|
4829
4872
|
</method>
|
4873
|
+
<method name="getv" c:identifier="g_object_getv" version="2.54">
|
4874
|
+
<doc xml:space="preserve">Gets @n_properties properties for an @object.
|
4875
|
+
Obtained properties will be set to @values. All properties must be valid.
|
4876
|
+
Warnings will be emitted and undefined behaviour may result if invalid
|
4877
|
+
properties are passed in.</doc>
|
4878
|
+
<return-value transfer-ownership="none">
|
4879
|
+
<type name="none" c:type="void"/>
|
4880
|
+
</return-value>
|
4881
|
+
<parameters>
|
4882
|
+
<instance-parameter name="object" transfer-ownership="none">
|
4883
|
+
<doc xml:space="preserve">a #GObject</doc>
|
4884
|
+
<type name="Object" c:type="GObject*"/>
|
4885
|
+
</instance-parameter>
|
4886
|
+
<parameter name="n_properties" transfer-ownership="none">
|
4887
|
+
<doc xml:space="preserve">the number of properties</doc>
|
4888
|
+
<type name="guint" c:type="guint"/>
|
4889
|
+
</parameter>
|
4890
|
+
<parameter name="names" transfer-ownership="none">
|
4891
|
+
<doc xml:space="preserve">the names of each property to get</doc>
|
4892
|
+
<array length="0" zero-terminated="0" c:type="gchar*">
|
4893
|
+
<type name="utf8" c:type="gchar"/>
|
4894
|
+
</array>
|
4895
|
+
</parameter>
|
4896
|
+
<parameter name="values" transfer-ownership="none">
|
4897
|
+
<doc xml:space="preserve">the values of each property to get</doc>
|
4898
|
+
<array length="0" zero-terminated="0" c:type="GValue">
|
4899
|
+
<type name="Value" c:type="GValue"/>
|
4900
|
+
</array>
|
4901
|
+
</parameter>
|
4902
|
+
</parameters>
|
4903
|
+
</method>
|
4830
4904
|
<method name="is_floating"
|
4831
4905
|
c:identifier="g_object_is_floating"
|
4832
4906
|
version="2.10">
|
@@ -5341,6 +5415,40 @@ with the same @quark.</doc>
|
|
5341
5415
|
</parameter>
|
5342
5416
|
</parameters>
|
5343
5417
|
</method>
|
5418
|
+
<method name="setv"
|
5419
|
+
c:identifier="g_object_setv"
|
5420
|
+
version="2.54"
|
5421
|
+
introspectable="0">
|
5422
|
+
<doc xml:space="preserve">Sets @n_properties properties for an @object.
|
5423
|
+
Properties to be set will be taken from @values. All properties must be
|
5424
|
+
valid. Warnings will be emitted and undefined behaviour may result if invalid
|
5425
|
+
properties are passed in.</doc>
|
5426
|
+
<return-value transfer-ownership="none">
|
5427
|
+
<type name="none" c:type="void"/>
|
5428
|
+
</return-value>
|
5429
|
+
<parameters>
|
5430
|
+
<instance-parameter name="object" transfer-ownership="none">
|
5431
|
+
<doc xml:space="preserve">a #GObject</doc>
|
5432
|
+
<type name="Object" c:type="GObject*"/>
|
5433
|
+
</instance-parameter>
|
5434
|
+
<parameter name="n_properties" transfer-ownership="none">
|
5435
|
+
<doc xml:space="preserve">the number of properties</doc>
|
5436
|
+
<type name="guint" c:type="guint"/>
|
5437
|
+
</parameter>
|
5438
|
+
<parameter name="names" transfer-ownership="none">
|
5439
|
+
<doc xml:space="preserve">the names of each property to be set</doc>
|
5440
|
+
<array length="0" zero-terminated="0" c:type="gchar*">
|
5441
|
+
<type name="utf8" c:type="gchar"/>
|
5442
|
+
</array>
|
5443
|
+
</parameter>
|
5444
|
+
<parameter name="values" transfer-ownership="none">
|
5445
|
+
<doc xml:space="preserve">the values of each property to be set</doc>
|
5446
|
+
<array length="0" zero-terminated="0" c:type="GValue">
|
5447
|
+
<type name="Value" c:type="GValue"/>
|
5448
|
+
</array>
|
5449
|
+
</parameter>
|
5450
|
+
</parameters>
|
5451
|
+
</method>
|
5344
5452
|
<method name="steal_data" c:identifier="g_object_steal_data">
|
5345
5453
|
<doc xml:space="preserve">Remove a specified datum from the object's data associations,
|
5346
5454
|
without invoking the association's destroy handler.</doc>
|
@@ -7348,9 +7456,13 @@ g_param_type_register_static().</doc>
|
|
7348
7456
|
</array>
|
7349
7457
|
</field>
|
7350
7458
|
</class>
|
7351
|
-
<record name="Parameter"
|
7459
|
+
<record name="Parameter"
|
7460
|
+
c:type="GParameter"
|
7461
|
+
deprecated="1"
|
7462
|
+
deprecated-version="2.54">
|
7352
7463
|
<doc xml:space="preserve">The GParameter struct is an auxiliary structure used
|
7353
7464
|
to hand parameter name/value pairs to g_object_newv().</doc>
|
7465
|
+
<doc-deprecated xml:space="preserve">This type is not introspectable.</doc-deprecated>
|
7354
7466
|
<field name="name" writable="1">
|
7355
7467
|
<doc xml:space="preserve">the parameter name</doc>
|
7356
7468
|
<type name="utf8" c:type="const gchar*"/>
|
@@ -12128,6 +12240,28 @@ definition than to write one yourself using g_enum_register_static().</doc>
|
|
12128
12240
|
</parameter>
|
12129
12241
|
</parameters>
|
12130
12242
|
</function>
|
12243
|
+
<function name="enum_to_string"
|
12244
|
+
c:identifier="g_enum_to_string"
|
12245
|
+
version="2.54">
|
12246
|
+
<doc xml:space="preserve">Pretty-prints @value in the form of the enum’s name.
|
12247
|
+
|
12248
|
+
This is intended to be used for debugging purposes. The format of the output
|
12249
|
+
may change in the future.</doc>
|
12250
|
+
<return-value transfer-ownership="full">
|
12251
|
+
<doc xml:space="preserve">a newly-allocated text string</doc>
|
12252
|
+
<type name="utf8" c:type="gchar*"/>
|
12253
|
+
</return-value>
|
12254
|
+
<parameters>
|
12255
|
+
<parameter name="g_enum_type" transfer-ownership="none">
|
12256
|
+
<doc xml:space="preserve">the type identifier of a #GEnumClass type</doc>
|
12257
|
+
<type name="GType" c:type="GType"/>
|
12258
|
+
</parameter>
|
12259
|
+
<parameter name="value" transfer-ownership="none">
|
12260
|
+
<doc xml:space="preserve">the value</doc>
|
12261
|
+
<type name="gint" c:type="gint"/>
|
12262
|
+
</parameter>
|
12263
|
+
</parameters>
|
12264
|
+
</function>
|
12131
12265
|
<function name="flags_complete_type_info"
|
12132
12266
|
c:identifier="g_flags_complete_type_info">
|
12133
12267
|
<doc xml:space="preserve">This function is meant to be called from the complete_type_info()
|
@@ -12237,6 +12371,29 @@ definition than to write one yourself using g_flags_register_static().</doc>
|
|
12237
12371
|
</parameter>
|
12238
12372
|
</parameters>
|
12239
12373
|
</function>
|
12374
|
+
<function name="flags_to_string"
|
12375
|
+
c:identifier="g_flags_to_string"
|
12376
|
+
version="2.54">
|
12377
|
+
<doc xml:space="preserve">Pretty-prints @value in the form of the flag names separated by ` | ` and
|
12378
|
+
sorted. Any extra bits will be shown at the end as a hexadecimal number.
|
12379
|
+
|
12380
|
+
This is intended to be used for debugging purposes. The format of the output
|
12381
|
+
may change in the future.</doc>
|
12382
|
+
<return-value transfer-ownership="full">
|
12383
|
+
<doc xml:space="preserve">a newly-allocated text string</doc>
|
12384
|
+
<type name="utf8" c:type="gchar*"/>
|
12385
|
+
</return-value>
|
12386
|
+
<parameters>
|
12387
|
+
<parameter name="flags_type" transfer-ownership="none">
|
12388
|
+
<doc xml:space="preserve">the type identifier of a #GFlagsClass type</doc>
|
12389
|
+
<type name="GType" c:type="GType"/>
|
12390
|
+
</parameter>
|
12391
|
+
<parameter name="value" transfer-ownership="none">
|
12392
|
+
<doc xml:space="preserve">the value</doc>
|
12393
|
+
<type name="guint" c:type="guint"/>
|
12394
|
+
</parameter>
|
12395
|
+
</parameters>
|
12396
|
+
</function>
|
12240
12397
|
<function name="gtype_get_type" c:identifier="g_gtype_get_type">
|
12241
12398
|
<return-value transfer-ownership="none">
|
12242
12399
|
<type name="GType" c:type="GType"/>
|
@@ -4557,7 +4557,7 @@ reproduced here:
|
|
4557
4557
|
"[A-Z][a-z][0-9]_-." and must not begin with a digit.
|
4558
4558
|
|
4559
4559
|
- Application identifiers must contain at least one '.' (period)
|
4560
|
-
character (and thus at least
|
4560
|
+
character (and thus at least two elements).
|
4561
4561
|
|
4562
4562
|
- Application identifiers must not begin or end with a '.' (period)
|
4563
4563
|
character.
|
@@ -7189,13 +7189,17 @@ the value, and other property value pairs, and ended by %NULL.</doc>
|
|
7189
7189
|
</function>
|
7190
7190
|
<function name="newv_async"
|
7191
7191
|
c:identifier="g_async_initable_newv_async"
|
7192
|
-
version="2.22"
|
7192
|
+
version="2.22"
|
7193
|
+
deprecated="1"
|
7194
|
+
deprecated-version="2.54">
|
7193
7195
|
<doc xml:space="preserve">Helper function for constructing #GAsyncInitable object. This is
|
7194
7196
|
similar to g_object_newv() but also initializes the object asynchronously.
|
7195
7197
|
|
7196
7198
|
When the initialization is finished, @callback will be called. You can
|
7197
7199
|
then call g_async_initable_new_finish() to get the new object and check
|
7198
7200
|
for any errors.</doc>
|
7201
|
+
<doc-deprecated xml:space="preserve">Use g_object_new_with_properties() and
|
7202
|
+
g_async_initable_init_async() instead. See #GParameter for more information.</doc-deprecated>
|
7199
7203
|
<return-value transfer-ownership="none">
|
7200
7204
|
<type name="none" c:type="void"/>
|
7201
7205
|
</return-value>
|
@@ -7248,6 +7252,9 @@ interface. This must be done before any real use of the object after
|
|
7248
7252
|
initial construction. If the object also implements #GInitable you can
|
7249
7253
|
optionally call g_initable_init() instead.
|
7250
7254
|
|
7255
|
+
This method is intended for language bindings. If writing in C,
|
7256
|
+
g_async_initable_new_async() should typically be used instead.
|
7257
|
+
|
7251
7258
|
When the initialization is finished, @callback will be called. You can
|
7252
7259
|
then call g_async_initable_init_finish() to get the result of the
|
7253
7260
|
initialization.
|
@@ -7265,11 +7272,11 @@ g_object_ref() and g_object_unref() are considered to be invalid, and
|
|
7265
7272
|
have undefined behaviour. They will often fail with g_critical() or
|
7266
7273
|
g_warning(), but this must not be relied on.
|
7267
7274
|
|
7268
|
-
|
7269
|
-
|
7270
|
-
|
7271
|
-
|
7272
|
-
|
7275
|
+
Callers should not assume that a class which implements #GAsyncInitable can
|
7276
|
+
be initialized multiple times; for more information, see g_initable_init().
|
7277
|
+
If a class explicitly supports being initialized multiple times,
|
7278
|
+
implementation requires yielding all subsequent calls to init_async() on the
|
7279
|
+
results of the first call.
|
7273
7280
|
|
7274
7281
|
For classes that also support the #GInitable interface, the default
|
7275
7282
|
implementation of this method will run the g_initable_init() function
|
@@ -7344,6 +7351,9 @@ interface. This must be done before any real use of the object after
|
|
7344
7351
|
initial construction. If the object also implements #GInitable you can
|
7345
7352
|
optionally call g_initable_init() instead.
|
7346
7353
|
|
7354
|
+
This method is intended for language bindings. If writing in C,
|
7355
|
+
g_async_initable_new_async() should typically be used instead.
|
7356
|
+
|
7347
7357
|
When the initialization is finished, @callback will be called. You can
|
7348
7358
|
then call g_async_initable_init_finish() to get the result of the
|
7349
7359
|
initialization.
|
@@ -7361,11 +7371,11 @@ g_object_ref() and g_object_unref() are considered to be invalid, and
|
|
7361
7371
|
have undefined behaviour. They will often fail with g_critical() or
|
7362
7372
|
g_warning(), but this must not be relied on.
|
7363
7373
|
|
7364
|
-
|
7365
|
-
|
7366
|
-
|
7367
|
-
|
7368
|
-
|
7374
|
+
Callers should not assume that a class which implements #GAsyncInitable can
|
7375
|
+
be initialized multiple times; for more information, see g_initable_init().
|
7376
|
+
If a class explicitly supports being initialized multiple times,
|
7377
|
+
implementation requires yielding all subsequent calls to init_async() on the
|
7378
|
+
results of the first call.
|
7369
7379
|
|
7370
7380
|
For classes that also support the #GInitable interface, the default
|
7371
7381
|
implementation of this method will run the g_initable_init() function
|
@@ -8693,6 +8703,13 @@ the connection was disconnected.</doc>
|
|
8693
8703
|
<doc xml:space="preserve">If another message bus connection owns the name and have
|
8694
8704
|
specified #G_BUS_NAME_OWNER_FLAGS_ALLOW_REPLACEMENT, then take the name from the other connection.</doc>
|
8695
8705
|
</member>
|
8706
|
+
<member name="do_not_queue"
|
8707
|
+
value="4"
|
8708
|
+
c:identifier="G_BUS_NAME_OWNER_FLAGS_DO_NOT_QUEUE"
|
8709
|
+
glib:nick="do-not-queue">
|
8710
|
+
<doc xml:space="preserve">If another message bus connection owns the name, immediately
|
8711
|
+
return an error from g_bus_own_name() rather than entering the waiting queue for that name. (Since 2.54)</doc>
|
8712
|
+
</member>
|
8696
8713
|
</bitfield>
|
8697
8714
|
<callback name="BusNameVanishedCallback"
|
8698
8715
|
c:type="GBusNameVanishedCallback"
|
@@ -13907,10 +13924,7 @@ method.</doc>
|
|
13907
13924
|
<doc xml:space="preserve">Indentation level.</doc>
|
13908
13925
|
<type name="guint" c:type="guint"/>
|
13909
13926
|
</parameter>
|
13910
|
-
<parameter name="string_builder"
|
13911
|
-
direction="out"
|
13912
|
-
caller-allocates="1"
|
13913
|
-
transfer-ownership="none">
|
13927
|
+
<parameter name="string_builder" transfer-ownership="none">
|
13914
13928
|
<doc xml:space="preserve">A #GString to to append XML data to.</doc>
|
13915
13929
|
<type name="GLib.String" c:type="GString*"/>
|
13916
13930
|
</parameter>
|
@@ -14125,7 +14139,7 @@ emitted immediately.
|
|
14125
14139
|
|
14126
14140
|
For example, an exported D-Bus interface may queue up property
|
14127
14141
|
changes and emit the
|
14128
|
-
`org.freedesktop.DBus.Properties::
|
14142
|
+
`org.freedesktop.DBus.Properties::PropertiesChanged`
|
14129
14143
|
signal later (e.g. in an idle handler). This technique is useful
|
14130
14144
|
for collapsing multiple property changes into one.</doc>
|
14131
14145
|
<return-value transfer-ownership="none">
|
@@ -14245,7 +14259,7 @@ emitted immediately.
|
|
14245
14259
|
|
14246
14260
|
For example, an exported D-Bus interface may queue up property
|
14247
14261
|
changes and emit the
|
14248
|
-
`org.freedesktop.DBus.Properties::
|
14262
|
+
`org.freedesktop.DBus.Properties::PropertiesChanged`
|
14249
14263
|
signal later (e.g. in an idle handler). This technique is useful
|
14250
14264
|
for collapsing multiple property changes into one.</doc>
|
14251
14265
|
<return-value transfer-ownership="none">
|
@@ -16591,10 +16605,7 @@ handling the `org.freedesktop.DBus.Introspectable.Introspect` method.</doc>
|
|
16591
16605
|
<doc xml:space="preserve">Indentation level.</doc>
|
16592
16606
|
<type name="guint" c:type="guint"/>
|
16593
16607
|
</parameter>
|
16594
|
-
<parameter name="string_builder"
|
16595
|
-
direction="out"
|
16596
|
-
caller-allocates="1"
|
16597
|
-
transfer-ownership="none">
|
16608
|
+
<parameter name="string_builder" transfer-ownership="none">
|
16598
16609
|
<doc xml:space="preserve">A #GString to to append XML data to.</doc>
|
16599
16610
|
<type name="GLib.String" c:type="GString*"/>
|
16600
16611
|
</parameter>
|
@@ -20897,7 +20908,9 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.</doc>
|
|
20897
20908
|
<parameter name="length"
|
20898
20909
|
direction="out"
|
20899
20910
|
caller-allocates="0"
|
20900
|
-
transfer-ownership="full"
|
20911
|
+
transfer-ownership="full"
|
20912
|
+
optional="1"
|
20913
|
+
allow-none="1">
|
20901
20914
|
<doc xml:space="preserve">a #gsize to get the length of the data read in.</doc>
|
20902
20915
|
<type name="gsize" c:type="gsize*"/>
|
20903
20916
|
</parameter>
|
@@ -20987,7 +21000,9 @@ well.</doc>
|
|
20987
21000
|
<parameter name="length"
|
20988
21001
|
direction="out"
|
20989
21002
|
caller-allocates="0"
|
20990
|
-
transfer-ownership="full"
|
21003
|
+
transfer-ownership="full"
|
21004
|
+
optional="1"
|
21005
|
+
allow-none="1">
|
20991
21006
|
<doc xml:space="preserve">a #gsize to get the length of the data read in.</doc>
|
20992
21007
|
<type name="gsize" c:type="gsize*"/>
|
20993
21008
|
</parameter>
|
@@ -21020,7 +21035,9 @@ g_data_input_stream_read_line_async().</doc>
|
|
21020
21035
|
<parameter name="length"
|
21021
21036
|
direction="out"
|
21022
21037
|
caller-allocates="0"
|
21023
|
-
transfer-ownership="full"
|
21038
|
+
transfer-ownership="full"
|
21039
|
+
optional="1"
|
21040
|
+
allow-none="1">
|
21024
21041
|
<doc xml:space="preserve">a #gsize to get the length of the data read in.</doc>
|
21025
21042
|
<type name="gsize" c:type="gsize*"/>
|
21026
21043
|
</parameter>
|
@@ -21053,7 +21070,9 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.</doc>
|
|
21053
21070
|
<parameter name="length"
|
21054
21071
|
direction="out"
|
21055
21072
|
caller-allocates="0"
|
21056
|
-
transfer-ownership="full"
|
21073
|
+
transfer-ownership="full"
|
21074
|
+
optional="1"
|
21075
|
+
allow-none="1">
|
21057
21076
|
<doc xml:space="preserve">a #gsize to get the length of the data read in.</doc>
|
21058
21077
|
<type name="gsize" c:type="gsize*"/>
|
21059
21078
|
</parameter>
|
@@ -21185,7 +21204,9 @@ does not consume the stop character.</doc>
|
|
21185
21204
|
<parameter name="length"
|
21186
21205
|
direction="out"
|
21187
21206
|
caller-allocates="0"
|
21188
|
-
transfer-ownership="full"
|
21207
|
+
transfer-ownership="full"
|
21208
|
+
optional="1"
|
21209
|
+
allow-none="1">
|
21189
21210
|
<doc xml:space="preserve">a #gsize to get the length of the data read in.</doc>
|
21190
21211
|
<type name="gsize" c:type="gsize*"/>
|
21191
21212
|
</parameter>
|
@@ -21282,7 +21303,9 @@ g_data_input_stream_read_until_async().</doc>
|
|
21282
21303
|
<parameter name="length"
|
21283
21304
|
direction="out"
|
21284
21305
|
caller-allocates="0"
|
21285
|
-
transfer-ownership="full"
|
21306
|
+
transfer-ownership="full"
|
21307
|
+
optional="1"
|
21308
|
+
allow-none="1">
|
21286
21309
|
<doc xml:space="preserve">a #gsize to get the length of the data read in.</doc>
|
21287
21310
|
<type name="gsize" c:type="gsize*"/>
|
21288
21311
|
</parameter>
|
@@ -21326,7 +21349,9 @@ specified.</doc>
|
|
21326
21349
|
<parameter name="length"
|
21327
21350
|
direction="out"
|
21328
21351
|
caller-allocates="0"
|
21329
|
-
transfer-ownership="full"
|
21352
|
+
transfer-ownership="full"
|
21353
|
+
optional="1"
|
21354
|
+
allow-none="1">
|
21330
21355
|
<doc xml:space="preserve">a #gsize to get the length of the data read in</doc>
|
21331
21356
|
<type name="gsize" c:type="gsize*"/>
|
21332
21357
|
</parameter>
|
@@ -21431,7 +21456,9 @@ g_data_input_stream_read_upto_async() again.</doc>
|
|
21431
21456
|
<parameter name="length"
|
21432
21457
|
direction="out"
|
21433
21458
|
caller-allocates="0"
|
21434
|
-
transfer-ownership="full"
|
21459
|
+
transfer-ownership="full"
|
21460
|
+
optional="1"
|
21461
|
+
allow-none="1">
|
21435
21462
|
<doc xml:space="preserve">a #gsize to get the length of the data read in</doc>
|
21436
21463
|
<type name="gsize" c:type="gsize*"/>
|
21437
21464
|
</parameter>
|
@@ -27644,6 +27671,10 @@ If the flag #G_FILE_COPY_NOFOLLOW_SYMLINKS is specified then symlinks
|
|
27644
27671
|
will be copied as symlinks, otherwise the target of the
|
27645
27672
|
@source symlink will be copied.
|
27646
27673
|
|
27674
|
+
If the flag #G_FILE_COPY_ALL_METADATA is specified then all the metadata
|
27675
|
+
that is possible to copy is copied, not just the default subset (which,
|
27676
|
+
for instance, does not include the owner, see #GFileInfo).
|
27677
|
+
|
27647
27678
|
If @cancellable is not %NULL, then the operation can be cancelled by
|
27648
27679
|
triggering the cancellable object from another thread. If the operation
|
27649
27680
|
was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
|
@@ -27714,9 +27745,7 @@ file), see g_file_dup().</doc>
|
|
27714
27745
|
</parameter>
|
27715
27746
|
</parameters>
|
27716
27747
|
</virtual-method>
|
27717
|
-
<virtual-method name="copy_async"
|
27718
|
-
invoker="copy_async"
|
27719
|
-
introspectable="0">
|
27748
|
+
<virtual-method name="copy_async" invoker="copy_async">
|
27720
27749
|
<doc xml:space="preserve">Copies the file @source to the location specified by @destination
|
27721
27750
|
asynchronously. For details of the behaviour, see g_file_copy().
|
27722
27751
|
|
@@ -27759,6 +27788,7 @@ g_file_copy_finish() to get the result of the operation.</doc>
|
|
27759
27788
|
transfer-ownership="none"
|
27760
27789
|
nullable="1"
|
27761
27790
|
allow-none="1"
|
27791
|
+
scope="notified"
|
27762
27792
|
closure="5">
|
27763
27793
|
<doc xml:space="preserve">function to callback with progress
|
27764
27794
|
information, or %NULL if progress information is not needed</doc>
|
@@ -27767,7 +27797,8 @@ g_file_copy_finish() to get the result of the operation.</doc>
|
|
27767
27797
|
<parameter name="progress_callback_data"
|
27768
27798
|
transfer-ownership="none"
|
27769
27799
|
nullable="1"
|
27770
|
-
allow-none="1"
|
27800
|
+
allow-none="1"
|
27801
|
+
closure="4">
|
27771
27802
|
<doc xml:space="preserve">user data to pass to @progress_callback</doc>
|
27772
27803
|
<type name="gpointer" c:type="gpointer"/>
|
27773
27804
|
</parameter>
|
@@ -27784,7 +27815,7 @@ g_file_copy_finish() to get the result of the operation.</doc>
|
|
27784
27815
|
transfer-ownership="none"
|
27785
27816
|
nullable="1"
|
27786
27817
|
allow-none="1"
|
27787
|
-
closure="
|
27818
|
+
closure="6">
|
27788
27819
|
<doc xml:space="preserve">the data to pass to callback function</doc>
|
27789
27820
|
<type name="gpointer" c:type="gpointer"/>
|
27790
27821
|
</parameter>
|
@@ -31280,6 +31311,10 @@ If the flag #G_FILE_COPY_NOFOLLOW_SYMLINKS is specified then symlinks
|
|
31280
31311
|
will be copied as symlinks, otherwise the target of the
|
31281
31312
|
@source symlink will be copied.
|
31282
31313
|
|
31314
|
+
If the flag #G_FILE_COPY_ALL_METADATA is specified then all the metadata
|
31315
|
+
that is possible to copy is copied, not just the default subset (which,
|
31316
|
+
for instance, does not include the owner, see #GFileInfo).
|
31317
|
+
|
31283
31318
|
If @cancellable is not %NULL, then the operation can be cancelled by
|
31284
31319
|
triggering the cancellable object from another thread. If the operation
|
31285
31320
|
was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
|
@@ -31350,9 +31385,7 @@ file), see g_file_dup().</doc>
|
|
31350
31385
|
</parameter>
|
31351
31386
|
</parameters>
|
31352
31387
|
</method>
|
31353
|
-
<method name="copy_async"
|
31354
|
-
c:identifier="g_file_copy_async"
|
31355
|
-
introspectable="0">
|
31388
|
+
<method name="copy_async" c:identifier="g_file_copy_async">
|
31356
31389
|
<doc xml:space="preserve">Copies the file @source to the location specified by @destination
|
31357
31390
|
asynchronously. For details of the behaviour, see g_file_copy().
|
31358
31391
|
|
@@ -31395,6 +31428,7 @@ g_file_copy_finish() to get the result of the operation.</doc>
|
|
31395
31428
|
transfer-ownership="none"
|
31396
31429
|
nullable="1"
|
31397
31430
|
allow-none="1"
|
31431
|
+
scope="notified"
|
31398
31432
|
closure="5">
|
31399
31433
|
<doc xml:space="preserve">function to callback with progress
|
31400
31434
|
information, or %NULL if progress information is not needed</doc>
|
@@ -31403,7 +31437,8 @@ g_file_copy_finish() to get the result of the operation.</doc>
|
|
31403
31437
|
<parameter name="progress_callback_data"
|
31404
31438
|
transfer-ownership="none"
|
31405
31439
|
nullable="1"
|
31406
|
-
allow-none="1"
|
31440
|
+
allow-none="1"
|
31441
|
+
closure="4">
|
31407
31442
|
<doc xml:space="preserve">user data to pass to @progress_callback</doc>
|
31408
31443
|
<type name="gpointer" c:type="gpointer"/>
|
31409
31444
|
</parameter>
|
@@ -31419,7 +31454,8 @@ g_file_copy_finish() to get the result of the operation.</doc>
|
|
31419
31454
|
<parameter name="user_data"
|
31420
31455
|
transfer-ownership="none"
|
31421
31456
|
nullable="1"
|
31422
|
-
allow-none="1"
|
31457
|
+
allow-none="1"
|
31458
|
+
closure="6">
|
31423
31459
|
<doc xml:space="preserve">the data to pass to callback function</doc>
|
31424
31460
|
<type name="gpointer" c:type="gpointer"/>
|
31425
31461
|
</parameter>
|
@@ -39555,8 +39591,8 @@ to be used as icon.</doc>
|
|
39555
39591
|
</parameters>
|
39556
39592
|
</callback>
|
39557
39593
|
</field>
|
39558
|
-
<field name="copy_async"
|
39559
|
-
<callback name="copy_async"
|
39594
|
+
<field name="copy_async">
|
39595
|
+
<callback name="copy_async">
|
39560
39596
|
<return-value transfer-ownership="none">
|
39561
39597
|
<type name="none" c:type="void"/>
|
39562
39598
|
</return-value>
|
@@ -39589,6 +39625,7 @@ to be used as icon.</doc>
|
|
39589
39625
|
transfer-ownership="none"
|
39590
39626
|
nullable="1"
|
39591
39627
|
allow-none="1"
|
39628
|
+
scope="notified"
|
39592
39629
|
closure="6">
|
39593
39630
|
<doc xml:space="preserve">function to callback with progress
|
39594
39631
|
information, or %NULL if progress information is not needed</doc>
|
@@ -39598,7 +39635,8 @@ to be used as icon.</doc>
|
|
39598
39635
|
<parameter name="progress_callback_data"
|
39599
39636
|
transfer-ownership="none"
|
39600
39637
|
nullable="1"
|
39601
|
-
allow-none="1"
|
39638
|
+
allow-none="1"
|
39639
|
+
closure="5">
|
39602
39640
|
<doc xml:space="preserve">user data to pass to @progress_callback</doc>
|
39603
39641
|
<type name="gpointer" c:type="gpointer"/>
|
39604
39642
|
</parameter>
|
@@ -39615,7 +39653,7 @@ to be used as icon.</doc>
|
|
39615
39653
|
transfer-ownership="none"
|
39616
39654
|
nullable="1"
|
39617
39655
|
allow-none="1"
|
39618
|
-
closure="
|
39656
|
+
closure="7">
|
39619
39657
|
<doc xml:space="preserve">the data to pass to callback function</doc>
|
39620
39658
|
<type name="gpointer" c:type="gpointer"/>
|
39621
39659
|
</parameter>
|
@@ -46858,10 +46896,14 @@ the value, and other property value pairs, and ended by %NULL.</doc>
|
|
46858
46896
|
<function name="newv"
|
46859
46897
|
c:identifier="g_initable_newv"
|
46860
46898
|
version="2.22"
|
46899
|
+
deprecated="1"
|
46900
|
+
deprecated-version="2.54"
|
46861
46901
|
throws="1">
|
46862
46902
|
<doc xml:space="preserve">Helper function for constructing #GInitable object. This is
|
46863
46903
|
similar to g_object_newv() but also initializes the object
|
46864
46904
|
and returns %NULL, setting an error on failure.</doc>
|
46905
|
+
<doc-deprecated xml:space="preserve">Use g_object_new_with_properties() and
|
46906
|
+
g_initable_init() instead. See #GParameter for more information.</doc-deprecated>
|
46865
46907
|
<return-value transfer-ownership="full">
|
46866
46908
|
<doc xml:space="preserve">a newly allocated
|
46867
46909
|
#GObject, or %NULL on error</doc>
|
@@ -46894,6 +46936,9 @@ and returns %NULL, setting an error on failure.</doc>
|
|
46894
46936
|
<virtual-method name="init" invoker="init" version="2.22" throws="1">
|
46895
46937
|
<doc xml:space="preserve">Initializes the object implementing the interface.
|
46896
46938
|
|
46939
|
+
This method is intended for language bindings. If writing in C,
|
46940
|
+
g_initable_new() should typically be used instead.
|
46941
|
+
|
46897
46942
|
The object must be initialized before any real use after initial
|
46898
46943
|
construction, either with this function or g_async_initable_init_async().
|
46899
46944
|
|
@@ -46909,11 +46954,24 @@ error, then all operations on the object except g_object_ref() and
|
|
46909
46954
|
g_object_unref() are considered to be invalid, and have undefined
|
46910
46955
|
behaviour. See the [introduction][ginitable] for more details.
|
46911
46956
|
|
46912
|
-
|
46913
|
-
|
46914
|
-
|
46915
|
-
|
46916
|
-
|
46957
|
+
Callers should not assume that a class which implements #GInitable can be
|
46958
|
+
initialized multiple times, unless the class explicitly documents itself as
|
46959
|
+
supporting this. Generally, a class’ implementation of init() can assume
|
46960
|
+
(and assert) that it will only be called once. Previously, this documentation
|
46961
|
+
recommended all #GInitable implementations should be idempotent; that
|
46962
|
+
recommendation was relaxed in GLib 2.54.
|
46963
|
+
|
46964
|
+
If a class explicitly supports being initialized multiple times, it is
|
46965
|
+
recommended that the method is idempotent: multiple calls with the same
|
46966
|
+
arguments should return the same results. Only the first call initializes
|
46967
|
+
the object; further calls return the result of the first call.
|
46968
|
+
|
46969
|
+
One reason why a class might need to support idempotent initialization is if
|
46970
|
+
it is designed to be used via the singleton pattern, with a
|
46971
|
+
#GObjectClass.constructor that sometimes returns an existing instance.
|
46972
|
+
In this pattern, a caller would expect to be able to call g_initable_init()
|
46973
|
+
on the result of g_object_new(), regardless of whether it is in fact a new
|
46974
|
+
instance.</doc>
|
46917
46975
|
<return-value transfer-ownership="none">
|
46918
46976
|
<doc xml:space="preserve">%TRUE if successful. If an error has occurred, this function will
|
46919
46977
|
return %FALSE and set @error appropriately if present.</doc>
|
@@ -46939,6 +46997,9 @@ pattern in the GObject constructor function.</doc>
|
|
46939
46997
|
throws="1">
|
46940
46998
|
<doc xml:space="preserve">Initializes the object implementing the interface.
|
46941
46999
|
|
47000
|
+
This method is intended for language bindings. If writing in C,
|
47001
|
+
g_initable_new() should typically be used instead.
|
47002
|
+
|
46942
47003
|
The object must be initialized before any real use after initial
|
46943
47004
|
construction, either with this function or g_async_initable_init_async().
|
46944
47005
|
|
@@ -46954,11 +47015,24 @@ error, then all operations on the object except g_object_ref() and
|
|
46954
47015
|
g_object_unref() are considered to be invalid, and have undefined
|
46955
47016
|
behaviour. See the [introduction][ginitable] for more details.
|
46956
47017
|
|
46957
|
-
|
46958
|
-
|
46959
|
-
|
46960
|
-
|
46961
|
-
|
47018
|
+
Callers should not assume that a class which implements #GInitable can be
|
47019
|
+
initialized multiple times, unless the class explicitly documents itself as
|
47020
|
+
supporting this. Generally, a class’ implementation of init() can assume
|
47021
|
+
(and assert) that it will only be called once. Previously, this documentation
|
47022
|
+
recommended all #GInitable implementations should be idempotent; that
|
47023
|
+
recommendation was relaxed in GLib 2.54.
|
47024
|
+
|
47025
|
+
If a class explicitly supports being initialized multiple times, it is
|
47026
|
+
recommended that the method is idempotent: multiple calls with the same
|
47027
|
+
arguments should return the same results. Only the first call initializes
|
47028
|
+
the object; further calls return the result of the first call.
|
47029
|
+
|
47030
|
+
One reason why a class might need to support idempotent initialization is if
|
47031
|
+
it is designed to be used via the singleton pattern, with a
|
47032
|
+
#GObjectClass.constructor that sometimes returns an existing instance.
|
47033
|
+
In this pattern, a caller would expect to be able to call g_initable_init()
|
47034
|
+
on the result of g_object_new(), regardless of whether it is in fact a new
|
47035
|
+
instance.</doc>
|
46962
47036
|
<return-value transfer-ownership="none">
|
46963
47037
|
<doc xml:space="preserve">%TRUE if successful. If an error has occurred, this function will
|
46964
47038
|
return %FALSE and set @error appropriately if present.</doc>
|
@@ -47100,7 +47174,7 @@ operation.
|
|
47100
47174
|
|
47101
47175
|
For behaviour details see g_input_stream_close().
|
47102
47176
|
|
47103
|
-
The
|
47177
|
+
The asynchronous methods have a default fallback that uses threads to implement
|
47104
47178
|
asynchronicity, so they are optional for inheriting classes. However, if you
|
47105
47179
|
override one you must override all.</doc>
|
47106
47180
|
<return-value transfer-ownership="none">
|
@@ -47195,7 +47269,7 @@ Any outstanding i/o request with higher priority (lower numerical value) will
|
|
47195
47269
|
be executed before an outstanding request with lower priority. Default
|
47196
47270
|
priority is %G_PRIORITY_DEFAULT.
|
47197
47271
|
|
47198
|
-
The
|
47272
|
+
The asynchronous methods have a default fallback that uses threads to implement
|
47199
47273
|
asynchronicity, so they are optional for inheriting classes. However, if you
|
47200
47274
|
override one you must override all.</doc>
|
47201
47275
|
<return-value transfer-ownership="none">
|
@@ -47475,7 +47549,7 @@ operation.
|
|
47475
47549
|
|
47476
47550
|
For behaviour details see g_input_stream_close().
|
47477
47551
|
|
47478
|
-
The
|
47552
|
+
The asynchronous methods have a default fallback that uses threads to implement
|
47479
47553
|
asynchronicity, so they are optional for inheriting classes. However, if you
|
47480
47554
|
override one you must override all.</doc>
|
47481
47555
|
<return-value transfer-ownership="none">
|
@@ -47786,7 +47860,7 @@ Any outstanding i/o request with higher priority (lower numerical value) will
|
|
47786
47860
|
be executed before an outstanding request with lower priority. Default
|
47787
47861
|
priority is %G_PRIORITY_DEFAULT.
|
47788
47862
|
|
47789
|
-
The
|
47863
|
+
The asynchronous methods have a default fallback that uses threads to implement
|
47790
47864
|
asynchronicity, so they are optional for inheriting classes. However, if you
|
47791
47865
|
override one you must override all.</doc>
|
47792
47866
|
<return-value transfer-ownership="none">
|
@@ -52143,7 +52217,7 @@ and the #GAsyncReady data to see if the operation was completed
|
|
52143
52217
|
successfully. If an @error is present when g_mount_unmount_with_operation_finish()
|
52144
52218
|
is called, then it will be filled with any error information.</doc>
|
52145
52219
|
<virtual-method name="can_eject" invoker="can_eject">
|
52146
|
-
<doc xml:space="preserve">Checks if @mount can be
|
52220
|
+
<doc xml:space="preserve">Checks if @mount can be ejected.</doc>
|
52147
52221
|
<return-value transfer-ownership="none">
|
52148
52222
|
<doc xml:space="preserve">%TRUE if the @mount can be ejected.</doc>
|
52149
52223
|
<type name="gboolean" c:type="gboolean"/>
|
@@ -52156,7 +52230,7 @@ is called, then it will be filled with any error information.</doc>
|
|
52156
52230
|
</parameters>
|
52157
52231
|
</virtual-method>
|
52158
52232
|
<virtual-method name="can_unmount" invoker="can_unmount">
|
52159
|
-
<doc xml:space="preserve">Checks if @mount can be
|
52233
|
+
<doc xml:space="preserve">Checks if @mount can be unmounted.</doc>
|
52160
52234
|
<return-value transfer-ownership="none">
|
52161
52235
|
<doc xml:space="preserve">%TRUE if the @mount can be unmounted.</doc>
|
52162
52236
|
<type name="gboolean" c:type="gboolean"/>
|
@@ -52824,7 +52898,7 @@ and #GAsyncResult data returned in the @callback.</doc>
|
|
52824
52898
|
</parameters>
|
52825
52899
|
</virtual-method>
|
52826
52900
|
<method name="can_eject" c:identifier="g_mount_can_eject">
|
52827
|
-
<doc xml:space="preserve">Checks if @mount can be
|
52901
|
+
<doc xml:space="preserve">Checks if @mount can be ejected.</doc>
|
52828
52902
|
<return-value transfer-ownership="none">
|
52829
52903
|
<doc xml:space="preserve">%TRUE if the @mount can be ejected.</doc>
|
52830
52904
|
<type name="gboolean" c:type="gboolean"/>
|
@@ -52837,7 +52911,7 @@ and #GAsyncResult data returned in the @callback.</doc>
|
|
52837
52911
|
</parameters>
|
52838
52912
|
</method>
|
52839
52913
|
<method name="can_unmount" c:identifier="g_mount_can_unmount">
|
52840
|
-
<doc xml:space="preserve">Checks if @mount can be
|
52914
|
+
<doc xml:space="preserve">Checks if @mount can be unmounted.</doc>
|
52841
52915
|
<return-value transfer-ownership="none">
|
52842
52916
|
<doc xml:space="preserve">%TRUE if the @mount can be unmounted.</doc>
|
52843
52917
|
<type name="gboolean" c:type="gboolean"/>
|
@@ -55259,8 +55333,11 @@ depending on what @addr was created with.</doc>
|
|
55259
55333
|
glib:get-type="g_network_monitor_get_type"
|
55260
55334
|
glib:type-struct="NetworkMonitorInterface">
|
55261
55335
|
<doc xml:space="preserve">#GNetworkMonitor provides an easy-to-use cross-platform API
|
55262
|
-
for monitoring network connectivity. On Linux, the
|
55263
|
-
|
55336
|
+
for monitoring network connectivity. On Linux, the available
|
55337
|
+
implementations are based on the kernel's netlink interface and
|
55338
|
+
on NetworkManager.
|
55339
|
+
|
55340
|
+
There is also an implementation for use inside Flatpak sandboxes.</doc>
|
55264
55341
|
<prerequisite name="Initable"/>
|
55265
55342
|
<function name="get_default"
|
55266
55343
|
c:identifier="g_network_monitor_get_default"
|
@@ -60553,7 +60630,11 @@ specify one.</doc>
|
|
60553
60630
|
glib:type-struct="ProxyResolverInterface">
|
60554
60631
|
<doc xml:space="preserve">#GProxyResolver provides synchronous and asynchronous network proxy
|
60555
60632
|
resolution. #GProxyResolver is used within #GSocketClient through
|
60556
|
-
the method g_socket_connectable_proxy_enumerate()
|
60633
|
+
the method g_socket_connectable_proxy_enumerate().
|
60634
|
+
|
60635
|
+
Implementations of #GProxyResolver based on libproxy and GNOME settings can
|
60636
|
+
be found in glib-networking. GIO comes with an implementation for use inside
|
60637
|
+
Flatpak portals.</doc>
|
60557
60638
|
<function name="get_default"
|
60558
60639
|
c:identifier="g_proxy_resolver_get_default"
|
60559
60640
|
version="2.26">
|
@@ -62792,6 +62873,13 @@ program must be in the PATH, or the `GDK_PIXBUF_PIXDATA` environment variable mu
|
|
62792
62873
|
set to the full path to the gdk-pixbuf-pixdata executable; otherwise the resource compiler will
|
62793
62874
|
abort.
|
62794
62875
|
|
62876
|
+
Resource files will be exported in the GResource namespace using the
|
62877
|
+
combination of the given `prefix` and the filename from the `file` element.
|
62878
|
+
The `alias` attribute can be used to alter the filename to expose them at a
|
62879
|
+
different location in the resource namespace. Typically, this is used to
|
62880
|
+
include files from a different source directory without exposing the source
|
62881
|
+
directory in the resource namespace, as in the example below.
|
62882
|
+
|
62795
62883
|
Resource bundles are created by the [glib-compile-resources][glib-compile-resources] program
|
62796
62884
|
which takes an XML file that describes the bundle, and a set of files that the XML references. These
|
62797
62885
|
are combined into a binary resource bundle.
|
@@ -62804,6 +62892,7 @@ An example resource description:
|
|
62804
62892
|
<file>data/splashscreen.png</file>
|
62805
62893
|
<file compressed="true">dialog.ui</file>
|
62806
62894
|
<file preprocess="xml-stripblanks">menumarkup.xml</file>
|
62895
|
+
<file alias="example.css">data/example.css</file>
|
62807
62896
|
</gresource>
|
62808
62897
|
</gresources>
|
62809
62898
|
]|
|
@@ -62813,6 +62902,7 @@ This will create a resource bundle with the following files:
|
|
62813
62902
|
/org/gtk/Example/data/splashscreen.png
|
62814
62903
|
/org/gtk/Example/dialog.ui
|
62815
62904
|
/org/gtk/Example/menumarkup.xml
|
62905
|
+
/org/gtk/Example/example.css
|
62816
62906
|
]|
|
62817
62907
|
|
62818
62908
|
Note that all resources in the process share the same namespace, so use Java-style
|
@@ -62833,22 +62923,24 @@ using API calls like g_resources_open_stream() to stream the data or g_resources
|
|
62833
62923
|
to the data. You can also use URIs like "resource:///org/gtk/Example/data/splashscreen.png" with #GFile to access
|
62834
62924
|
the resource data.
|
62835
62925
|
|
62926
|
+
Some higher-level APIs, such as #GtkApplication, will automatically load
|
62927
|
+
resources from certain well-known paths in the resource namespace as a
|
62928
|
+
convenience. See the documentation for those APIs for details.
|
62929
|
+
|
62836
62930
|
There are two forms of the generated source, the default version uses the compiler support for constructor
|
62837
62931
|
and destructor functions (where available) to automatically create and register the #GResource on startup
|
62838
|
-
or library load time. If you pass
|
62839
|
-
|
62840
|
-
even on the minor ones where
|
62932
|
+
or library load time. If you pass `--manual-register`, two functions to register/unregister the resource are created
|
62933
|
+
instead. This requires an explicit initialization call in your application/library, but it works on all platforms,
|
62934
|
+
even on the minor ones where constructors are not supported. (Constructor support is available for at least Win32, Mac OS and Linux.)
|
62841
62935
|
|
62842
62936
|
Note that resource data can point directly into the data segment of e.g. a library, so if you are unloading libraries
|
62843
62937
|
during runtime you need to be very careful with keeping around pointers to data from a resource, as this goes away
|
62844
62938
|
when the library is unloaded. However, in practice this is not generally a problem, since most resource accesses
|
62845
|
-
|
62939
|
+
are for your own resources, and resource data is often used once, during parsing, and then released.
|
62846
62940
|
|
62847
62941
|
When debugging a program or testing a change to an installed version, it is often useful to be able to
|
62848
62942
|
replace resources in the program or library, without recompiling, for debugging or quick hacking and testing
|
62849
|
-
purposes.
|
62850
|
-
|
62851
|
-
Since GLib 2.50, it is possible to use the `G_RESOURCE_OVERLAYS` environment variable to selectively overlay
|
62943
|
+
purposes. Since GLib 2.50, it is possible to use the `G_RESOURCE_OVERLAYS` environment variable to selectively overlay
|
62852
62944
|
resources with replacements from the filesystem. It is a colon-separated list of substitutions to perform
|
62853
62945
|
during resource lookups.
|
62854
62946
|
|
@@ -64026,8 +64118,7 @@ of your whole loop.</doc-deprecated>
|
|
64026
64118
|
</return-value>
|
64027
64119
|
</function>
|
64028
64120
|
<function name="sync" c:identifier="g_settings_sync">
|
64029
|
-
<doc xml:space="preserve">Ensures that all pending operations for the
|
64030
|
-
the default backend.
|
64121
|
+
<doc xml:space="preserve">Ensures that all pending operations are complete for the default backend.
|
64031
64122
|
|
64032
64123
|
Writes made to a #GSettings are handled asynchronously. For this
|
64033
64124
|
reason, it is very unlikely that the changes have it to disk by the
|
@@ -69773,10 +69864,11 @@ the peer, or -1 on error</doc>
|
|
69773
69864
|
direction="out"
|
69774
69865
|
caller-allocates="0"
|
69775
69866
|
transfer-ownership="full"
|
69867
|
+
nullable="1"
|
69776
69868
|
optional="1"
|
69777
69869
|
allow-none="1">
|
69778
|
-
<doc xml:space="preserve">a pointer
|
69779
|
-
may be filled with an array of #GSocketControlMessages, or %NULL</doc>
|
69870
|
+
<doc xml:space="preserve">a pointer
|
69871
|
+
which may be filled with an array of #GSocketControlMessages, or %NULL</doc>
|
69780
69872
|
<array length="4"
|
69781
69873
|
zero-terminated="0"
|
69782
69874
|
c:type="GSocketControlMessage***">
|
@@ -73417,6 +73509,7 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.</doc>
|
|
73417
73509
|
direction="out"
|
73418
73510
|
caller-allocates="0"
|
73419
73511
|
transfer-ownership="none"
|
73512
|
+
nullable="1"
|
73420
73513
|
optional="1"
|
73421
73514
|
allow-none="1">
|
73422
73515
|
<doc xml:space="preserve">location where #GObject pointer will be stored, or %NULL</doc>
|
@@ -73494,6 +73587,7 @@ to get the result of the operation.</doc>
|
|
73494
73587
|
direction="out"
|
73495
73588
|
caller-allocates="0"
|
73496
73589
|
transfer-ownership="none"
|
73590
|
+
nullable="1"
|
73497
73591
|
optional="1"
|
73498
73592
|
allow-none="1">
|
73499
73593
|
<doc xml:space="preserve">Optional #GObject identifying this source</doc>
|
@@ -73532,6 +73626,7 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.</doc>
|
|
73532
73626
|
direction="out"
|
73533
73627
|
caller-allocates="0"
|
73534
73628
|
transfer-ownership="none"
|
73629
|
+
nullable="1"
|
73535
73630
|
optional="1"
|
73536
73631
|
allow-none="1">
|
73537
73632
|
<doc xml:space="preserve">location where #GObject pointer will be stored, or %NULL.</doc>
|
@@ -73609,6 +73704,7 @@ to get the result of the operation.</doc>
|
|
73609
73704
|
direction="out"
|
73610
73705
|
caller-allocates="0"
|
73611
73706
|
transfer-ownership="none"
|
73707
|
+
nullable="1"
|
73612
73708
|
optional="1"
|
73613
73709
|
allow-none="1">
|
73614
73710
|
<doc xml:space="preserve">Optional #GObject identifying this source</doc>
|
@@ -75573,8 +75669,12 @@ g_environ_unsetenv(), etc.
|
|
75573
75669
|
As an alternative, you can use g_subprocess_launcher_setenv(),
|
75574
75670
|
g_subprocess_launcher_unsetenv(), etc.
|
75575
75671
|
|
75576
|
-
Pass
|
75577
|
-
|
75672
|
+
Pass an empty array to set an empty environment. Pass %NULL to inherit the
|
75673
|
+
parent process’ environment. As of GLib 2.54, the parent process’ environment
|
75674
|
+
will be copied when g_subprocess_launcher_set_environ() is called.
|
75675
|
+
Previously, it was copied when the subprocess was executed. This means the
|
75676
|
+
copied environment may now be modified (using g_subprocess_launcher_setenv(),
|
75677
|
+
etc.) before launching the subprocess.
|
75578
75678
|
|
75579
75679
|
On UNIX, all strings in this array can be arbitrary byte strings.
|
75580
75680
|
On Windows, they should be in UTF-8.</doc>
|
@@ -86827,13 +86927,17 @@ g_app_info_remove_supports_type().</doc>
|
|
86827
86927
|
<function name="async_initable_newv_async"
|
86828
86928
|
c:identifier="g_async_initable_newv_async"
|
86829
86929
|
moved-to="AsyncInitable.newv_async"
|
86830
|
-
version="2.22"
|
86930
|
+
version="2.22"
|
86931
|
+
deprecated="1"
|
86932
|
+
deprecated-version="2.54">
|
86831
86933
|
<doc xml:space="preserve">Helper function for constructing #GAsyncInitable object. This is
|
86832
86934
|
similar to g_object_newv() but also initializes the object asynchronously.
|
86833
86935
|
|
86834
86936
|
When the initialization is finished, @callback will be called. You can
|
86835
86937
|
then call g_async_initable_new_finish() to get the new object and check
|
86836
86938
|
for any errors.</doc>
|
86939
|
+
<doc-deprecated xml:space="preserve">Use g_object_new_with_properties() and
|
86940
|
+
g_async_initable_init_async() instead. See #GParameter for more information.</doc-deprecated>
|
86837
86941
|
<return-value transfer-ownership="none">
|
86838
86942
|
<type name="none" c:type="void"/>
|
86839
86943
|
</return-value>
|
@@ -88261,7 +88365,11 @@ See the g_dbus_gvariant_to_gvalue() function for how to convert a
|
|
88261
88365
|
<doc xml:space="preserve">Converts a #GVariant to a #GValue. If @value is floating, it is consumed.
|
88262
88366
|
|
88263
88367
|
The rules specified in the g_dbus_gvalue_to_gvariant() function are
|
88264
|
-
used - this function is essentially its reverse form.
|
88368
|
+
used - this function is essentially its reverse form. So, a #GVariant
|
88369
|
+
containing any basic or string array type will be converted to a #GValue
|
88370
|
+
containing a basic value or string array. Any other #GVariant (handle,
|
88371
|
+
variant, tuple, dict entry) will be converted to a #GValue containing that
|
88372
|
+
#GVariant.
|
88265
88373
|
|
88266
88374
|
The conversion never fails - a valid #GValue is always returned in
|
88267
88375
|
@out_gvalue.</doc>
|
@@ -88657,10 +88765,14 @@ with the type system prior to calling g_icon_new_for_string().</doc>
|
|
88657
88765
|
c:identifier="g_initable_newv"
|
88658
88766
|
moved-to="Initable.newv"
|
88659
88767
|
version="2.22"
|
88768
|
+
deprecated="1"
|
88769
|
+
deprecated-version="2.54"
|
88660
88770
|
throws="1">
|
88661
88771
|
<doc xml:space="preserve">Helper function for constructing #GInitable object. This is
|
88662
88772
|
similar to g_object_newv() but also initializes the object
|
88663
88773
|
and returns %NULL, setting an error on failure.</doc>
|
88774
|
+
<doc-deprecated xml:space="preserve">Use g_object_new_with_properties() and
|
88775
|
+
g_initable_init() instead. See #GParameter for more information.</doc-deprecated>
|
88664
88776
|
<return-value transfer-ownership="full">
|
88665
88777
|
<doc xml:space="preserve">a newly allocated
|
88666
88778
|
#GObject, or %NULL on error</doc>
|
@@ -88694,7 +88806,10 @@ and returns %NULL, setting an error on failure.</doc>
|
|
88694
88806
|
<doc xml:space="preserve">Converts errno.h error codes into GIO error codes. The fallback
|
88695
88807
|
value %G_IO_ERROR_FAILED is returned for error codes not currently
|
88696
88808
|
handled (but note that future GLib releases may return a more
|
88697
|
-
specific value instead)
|
88809
|
+
specific value instead).
|
88810
|
+
|
88811
|
+
As %errno is global and may be modified by intermediate function
|
88812
|
+
calls, you should save its value as soon as the call which sets it</doc>
|
88698
88813
|
<return-value transfer-ownership="none">
|
88699
88814
|
<doc xml:space="preserve">#GIOErrorEnum value for the given errno.h error number.</doc>
|
88700
88815
|
<type name="IOErrorEnum" c:type="GIOErrorEnum"/>
|
@@ -89433,8 +89548,8 @@ globally registered resources and if found returns information about it.
|
|
89433
89548
|
transfer-ownership="full"
|
89434
89549
|
optional="1"
|
89435
89550
|
allow-none="1">
|
89436
|
-
<doc xml:space="preserve">a location to place the
|
89437
|
-
or %NULL if the
|
89551
|
+
<doc xml:space="preserve">a location to place the #GResourceFlags about the file,
|
89552
|
+
or %NULL if the flags are not needed</doc>
|
89438
89553
|
<type name="guint32" c:type="guint32*"/>
|
89439
89554
|
</parameter>
|
89440
89555
|
</parameters>
|