gobject-introspection 3.1.8-x64-mingw32 → 3.1.9-x64-mingw32
Sign up to get free protection for your applications and to get access to all the features.
- 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 +684 -515
- 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>
|