gobject-introspection 3.1.8-x64-mingw32 → 3.1.9-x64-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 +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
Binary file
|
Binary file
|
Binary file
|
Binary file
|
Binary file
|
Binary file
|
Binary file
|
Binary file
|
Binary file
|
Binary file
|
Binary file
|
Binary file
|
Binary file
|
Binary file
|
@@ -99,10 +99,10 @@ class DumpCompiler(object):
|
|
99
99
|
self._uninst_srcdir = os.environ.get('UNINSTALLED_INTROSPECTION_SRCDIR')
|
100
100
|
self._packages = ['gio-2.0 gmodule-2.0']
|
101
101
|
self._packages.extend(options.packages)
|
102
|
-
if
|
103
|
-
self._linker_cmd =
|
102
|
+
if self._compiler.check_is_msvc():
|
103
|
+
self._linker_cmd = ['link.exe']
|
104
104
|
else:
|
105
|
-
self._linker_cmd =
|
105
|
+
self._linker_cmd = shlex.split(os.environ.get('CC', 'cc'))
|
106
106
|
|
107
107
|
# Public API
|
108
108
|
|
@@ -212,21 +212,25 @@ class DumpCompiler(object):
|
|
212
212
|
libtool = utils.get_libtool_command(self._options)
|
213
213
|
if libtool:
|
214
214
|
# Note: MSVC Builds do not use libtool!
|
215
|
-
# In the libtool case, put together the linker command, as we did before.
|
216
|
-
# We aren't using distutils to link in this case.
|
217
215
|
args.extend(libtool)
|
218
216
|
args.append('--mode=link')
|
219
217
|
args.append('--tag=CC')
|
220
218
|
if self._options.quiet:
|
221
219
|
args.append('--silent')
|
222
220
|
|
223
|
-
|
221
|
+
args.extend(self._linker_cmd)
|
224
222
|
|
223
|
+
# We can use -o for the Microsoft compiler/linker,
|
224
|
+
# but it is considered deprecated usage
|
225
|
+
if self._compiler.check_is_msvc():
|
226
|
+
args.extend(['-out:' + output])
|
227
|
+
else:
|
225
228
|
args.extend(['-o', output])
|
226
|
-
if
|
227
|
-
|
228
|
-
|
229
|
-
|
229
|
+
if libtool:
|
230
|
+
if os.name == 'nt':
|
231
|
+
args.append('-Wl,--export-all-symbols')
|
232
|
+
else:
|
233
|
+
args.append('-export-dynamic')
|
230
234
|
|
231
235
|
if not self._compiler.check_is_msvc():
|
232
236
|
# These envvars are not used for MSVC Builds!
|
@@ -246,8 +250,7 @@ class DumpCompiler(object):
|
|
246
250
|
raise CompilerError(
|
247
251
|
"Could not find object file: %s" % (source, ))
|
248
252
|
|
249
|
-
|
250
|
-
args.extend(sources)
|
253
|
+
args.extend(sources)
|
251
254
|
|
252
255
|
pkg_config_libs = self._run_pkgconfig('--libs')
|
253
256
|
|
@@ -261,66 +264,36 @@ class DumpCompiler(object):
|
|
261
264
|
|
262
265
|
else:
|
263
266
|
args.extend(pkg_config_libs)
|
264
|
-
self._compiler.get_external_link_flags(args,
|
265
|
-
libtool,
|
266
|
-
self._options.libraries)
|
267
|
+
self._compiler.get_external_link_flags(args, self._options.libraries)
|
267
268
|
|
268
269
|
if not self._compiler.check_is_msvc():
|
269
270
|
for ldflag in shlex.split(os.environ.get('LDFLAGS', '')):
|
270
271
|
args.append(ldflag)
|
271
272
|
|
272
|
-
if not
|
273
|
-
|
274
|
-
|
275
|
-
|
276
|
-
|
277
|
-
|
278
|
-
|
279
|
-
|
280
|
-
#
|
281
|
-
#
|
282
|
-
|
283
|
-
|
284
|
-
|
285
|
-
|
286
|
-
|
287
|
-
|
288
|
-
|
289
|
-
|
290
|
-
|
291
|
-
|
292
|
-
|
293
|
-
|
294
|
-
else:
|
295
|
-
raise LinkError(e)
|
296
|
-
else:
|
297
|
-
raise LinkError(e)
|
298
|
-
else:
|
299
|
-
# libtool: Run the assembled link command, we don't use distutils
|
300
|
-
# for linking here.
|
301
|
-
if not self._options.quiet:
|
302
|
-
print("g-ir-scanner: link: %s" % (
|
303
|
-
subprocess.list2cmdline(args), ))
|
304
|
-
sys.stdout.flush()
|
305
|
-
msys = os.environ.get('MSYSTEM', None)
|
273
|
+
if not self._options.quiet:
|
274
|
+
print("g-ir-scanner: link: %s" % (
|
275
|
+
subprocess.list2cmdline(args), ))
|
276
|
+
sys.stdout.flush()
|
277
|
+
|
278
|
+
msys = os.environ.get('MSYSTEM', None)
|
279
|
+
if msys:
|
280
|
+
shell = os.environ.get('SHELL', 'sh.exe')
|
281
|
+
# Create a temporary script file that
|
282
|
+
# runs the command we want
|
283
|
+
tf, tf_name = tempfile.mkstemp()
|
284
|
+
with os.fdopen(tf, 'wb') as f:
|
285
|
+
shellcontents = ' '.join([x.replace('\\', '/') for x in args])
|
286
|
+
fcontents = '#!/bin/sh\nunset PWD\n{}\n'.format(shellcontents)
|
287
|
+
f.write(fcontents)
|
288
|
+
shell = utils.which(shell)
|
289
|
+
args = [shell, tf_name.replace('\\', '/')]
|
290
|
+
try:
|
291
|
+
subprocess.check_call(args)
|
292
|
+
except subprocess.CalledProcessError as e:
|
293
|
+
raise LinkerError(e)
|
294
|
+
finally:
|
306
295
|
if msys:
|
307
|
-
|
308
|
-
# Create a temporary script file that
|
309
|
-
# runs the command we want
|
310
|
-
tf, tf_name = tempfile.mkstemp()
|
311
|
-
with os.fdopen(tf, 'wb') as f:
|
312
|
-
shellcontents = ' '.join([x.replace('\\', '/') for x in args])
|
313
|
-
fcontents = '#!/bin/sh\nunset PWD\n{}\n'.format(shellcontents)
|
314
|
-
f.write(fcontents)
|
315
|
-
shell = utils.which(shell)
|
316
|
-
args = [shell, tf_name.replace('\\', '/')]
|
317
|
-
try:
|
318
|
-
subprocess.check_call(args)
|
319
|
-
except subprocess.CalledProcessError as e:
|
320
|
-
raise LinkerError(e)
|
321
|
-
finally:
|
322
|
-
if msys:
|
323
|
-
os.remove(tf_name)
|
296
|
+
os.remove(tf_name)
|
324
297
|
|
325
298
|
|
326
299
|
def compile_introspection_binary(options, get_type_functions,
|
Binary file
|
Binary file
|
Binary file
|
Binary file
|
Binary file
|
Binary file
|
Binary file
|
Binary file
|
Binary file
|
Binary file
|
Binary file
|
Binary file
|
Binary file
|
Binary file
|
Binary file
|
Binary file
|
Binary file
|
Binary file
|
Binary file
|
Binary file
|
Binary file
|
Binary file
|
Binary file
|
Binary file
|
@@ -290,7 +290,9 @@ class SourceScanner(object):
|
|
290
290
|
|
291
291
|
cc = CCompiler()
|
292
292
|
|
293
|
-
tmp_fd_cpp, tmp_name_cpp = tempfile.mkstemp(prefix='g-ir-cpp-',
|
293
|
+
tmp_fd_cpp, tmp_name_cpp = tempfile.mkstemp(prefix='g-ir-cpp-',
|
294
|
+
suffix='.c',
|
295
|
+
dir=os.getcwd())
|
294
296
|
with os.fdopen(tmp_fd_cpp, 'wb') as fp_cpp:
|
295
297
|
self._write_preprocess_src(fp_cpp, defines, undefs, filenames)
|
296
298
|
|
Binary file
|
Binary file
|
Binary file
|
Binary file
|
Binary file
|
Binary file
|
@@ -159,7 +159,7 @@ def get_libtool_command(options):
|
|
159
159
|
libtool_cmd = 'glibtool'
|
160
160
|
try:
|
161
161
|
subprocess.check_call([libtool_cmd, '--version'],
|
162
|
-
stdout=open(os.devnull))
|
162
|
+
stdout=open(os.devnull, 'w'))
|
163
163
|
except (subprocess.CalledProcessError, OSError):
|
164
164
|
# If libtool's not installed, assume we don't need it
|
165
165
|
return None
|
@@ -228,7 +228,7 @@ def makedirs(name, mode=0o777, exist_ok=False):
|
|
228
228
|
if head and tail and not os.path.exists(head):
|
229
229
|
try:
|
230
230
|
makedirs(head, mode, exist_ok)
|
231
|
-
except OSError as e:
|
231
|
+
except (IOError, OSError) as e:
|
232
232
|
# be happy if someone already created the path
|
233
233
|
if e.errno != errno.EEXIST:
|
234
234
|
raise
|
@@ -236,7 +236,7 @@ def makedirs(name, mode=0o777, exist_ok=False):
|
|
236
236
|
return
|
237
237
|
try:
|
238
238
|
os.mkdir(name, mode)
|
239
|
-
except OSError as e:
|
239
|
+
except (IOError, OSError) as e:
|
240
240
|
if not exist_ok or e.errno != errno.EEXIST or not os.path.isdir(name):
|
241
241
|
raise
|
242
242
|
|
Binary file
|
Binary file
|
Binary file
|
Binary file
|
Binary file
|
Binary file
|
@@ -149,7 +149,11 @@ is greater than one, the #GArray wrapper is preserved but the size
|
|
149
149
|
of @array will be set to zero.
|
150
150
|
|
151
151
|
If array elements contain dynamically-allocated memory, they should
|
152
|
-
be freed separately
|
152
|
+
be freed separately.
|
153
|
+
|
154
|
+
This function is not thread-safe. If using a #GArray from multiple
|
155
|
+
threads, use only the atomic g_array_ref() and g_array_unref()
|
156
|
+
functions.</doc>
|
153
157
|
<return-value transfer-ownership="full">
|
154
158
|
<doc xml:space="preserve">the element data if @free_segment is %FALSE, otherwise
|
155
159
|
%NULL. The element data should be freed using g_free().</doc>
|
@@ -278,7 +282,7 @@ the new elements.</doc>
|
|
278
282
|
version="2.22"
|
279
283
|
introspectable="0">
|
280
284
|
<doc xml:space="preserve">Atomically increments the reference count of @array by one.
|
281
|
-
This function is
|
285
|
+
This function is thread-safe and may be called from any thread.</doc>
|
282
286
|
<return-value>
|
283
287
|
<doc xml:space="preserve">The passed in #GArray</doc>
|
284
288
|
<array name="GLib.Array" c:type="GArray*">
|
@@ -523,7 +527,7 @@ This did not actually work, so any such code should be removed.</doc>
|
|
523
527
|
introspectable="0">
|
524
528
|
<doc xml:space="preserve">Atomically decrements the reference count of @array by one. If the
|
525
529
|
reference count drops to 0, all memory allocated by the array is
|
526
|
-
released. This function is
|
530
|
+
released. This function is thread-safe and may be called from any
|
527
531
|
thread.</doc>
|
528
532
|
<return-value transfer-ownership="none">
|
529
533
|
<type name="none" c:type="void"/>
|
@@ -6028,16 +6032,6 @@ filenames, the returned name is in UTF-8.</doc>
|
|
6028
6032
|
</instance-parameter>
|
6029
6033
|
</parameters>
|
6030
6034
|
</method>
|
6031
|
-
<method name="read_name_utf8" c:identifier="g_dir_read_name_utf8">
|
6032
|
-
<return-value transfer-ownership="none">
|
6033
|
-
<type name="utf8" c:type="const gchar*"/>
|
6034
|
-
</return-value>
|
6035
|
-
<parameters>
|
6036
|
-
<instance-parameter name="dir" transfer-ownership="none">
|
6037
|
-
<type name="Dir" c:type="GDir*"/>
|
6038
|
-
</instance-parameter>
|
6039
|
-
</parameters>
|
6040
|
-
</method>
|
6041
6035
|
<method name="rewind" c:identifier="g_dir_rewind">
|
6042
6036
|
<doc xml:space="preserve">Resets the given directory. The next call to g_dir_read_name()
|
6043
6037
|
will return the first entry again.</doc>
|
@@ -6109,22 +6103,6 @@ that the ordering is not defined.</doc>
|
|
6109
6103
|
</parameter>
|
6110
6104
|
</parameters>
|
6111
6105
|
</function>
|
6112
|
-
<function name="open_utf8"
|
6113
|
-
c:identifier="g_dir_open_utf8"
|
6114
|
-
introspectable="0"
|
6115
|
-
throws="1">
|
6116
|
-
<return-value>
|
6117
|
-
<type name="Dir" c:type="GDir*"/>
|
6118
|
-
</return-value>
|
6119
|
-
<parameters>
|
6120
|
-
<parameter name="path" transfer-ownership="none">
|
6121
|
-
<type name="utf8" c:type="const gchar*"/>
|
6122
|
-
</parameter>
|
6123
|
-
<parameter name="flags" transfer-ownership="none">
|
6124
|
-
<type name="guint" c:type="guint"/>
|
6125
|
-
</parameter>
|
6126
|
-
</parameters>
|
6127
|
-
</function>
|
6128
6106
|
</record>
|
6129
6107
|
<union name="DoubleIEEE754" c:type="GDoubleIEEE754">
|
6130
6108
|
<doc xml:space="preserve">The #GFloatIEEE754 and #GDoubleIEEE754 unions are used to access the sign,
|
@@ -8932,21 +8910,6 @@ access the channel after it is closed).</doc>
|
|
8932
8910
|
</parameter>
|
8933
8911
|
</parameters>
|
8934
8912
|
</constructor>
|
8935
|
-
<constructor name="new_file_utf8"
|
8936
|
-
c:identifier="g_io_channel_new_file_utf8"
|
8937
|
-
throws="1">
|
8938
|
-
<return-value transfer-ownership="full">
|
8939
|
-
<type name="IOChannel" c:type="GIOChannel*"/>
|
8940
|
-
</return-value>
|
8941
|
-
<parameters>
|
8942
|
-
<parameter name="filename" transfer-ownership="none">
|
8943
|
-
<type name="utf8" c:type="const gchar*"/>
|
8944
|
-
</parameter>
|
8945
|
-
<parameter name="mode" transfer-ownership="none">
|
8946
|
-
<type name="utf8" c:type="const gchar*"/>
|
8947
|
-
</parameter>
|
8948
|
-
</parameters>
|
8949
|
-
</constructor>
|
8950
8913
|
<constructor name="unix_new" c:identifier="g_io_channel_unix_new">
|
8951
8914
|
<doc xml:space="preserve">Creates a new #GIOChannel given a file descriptor. On UNIX systems
|
8952
8915
|
this works for plain files, pipes, and sockets.
|
@@ -8957,6 +8920,8 @@ The default encoding for #GIOChannel is UTF-8. If your application
|
|
8957
8920
|
is reading output from a command using via pipe, you may need to set
|
8958
8921
|
the encoding to the encoding of the current locale (see
|
8959
8922
|
g_get_charset()) with the g_io_channel_set_encoding() function.
|
8923
|
+
By default, the fd passed will not be closed when the final reference
|
8924
|
+
to the #GIOChannel data structure is dropped.
|
8960
8925
|
|
8961
8926
|
If you want to read raw binary data without interpretation, then
|
8962
8927
|
call the g_io_channel_set_encoding() function with %NULL for the
|
@@ -9146,8 +9111,7 @@ will be closed when @channel receives its final unref and is
|
|
9146
9111
|
destroyed. The default value of this is %TRUE for channels created
|
9147
9112
|
by g_io_channel_new_file (), and %FALSE for all other channels.</doc>
|
9148
9113
|
<return-value transfer-ownership="none">
|
9149
|
-
<doc xml:space="preserve"
|
9150
|
-
the GIOChannel data structure.</doc>
|
9114
|
+
<doc xml:space="preserve">%TRUE if the channel will be closed, %FALSE otherwise.</doc>
|
9151
9115
|
<type name="gboolean" c:type="gboolean"/>
|
9152
9116
|
</return-value>
|
9153
9117
|
<parameters>
|
@@ -9557,8 +9521,12 @@ The default state of the channel is buffered.</doc>
|
|
9557
9521
|
</method>
|
9558
9522
|
<method name="set_close_on_unref"
|
9559
9523
|
c:identifier="g_io_channel_set_close_on_unref">
|
9560
|
-
<doc xml:space="preserve">
|
9561
|
-
|
9524
|
+
<doc xml:space="preserve">Whether to close the channel on the final unref of the #GIOChannel
|
9525
|
+
data structure. The default value of this is %TRUE for channels
|
9526
|
+
created by g_io_channel_new_file (), and %FALSE for all other channels.
|
9527
|
+
|
9528
|
+
Setting this flag to %TRUE for a channel you have already closed
|
9529
|
+
can cause problems when the final reference to the #GIOChannel is dropped.</doc>
|
9562
9530
|
<return-value transfer-ownership="none">
|
9563
9531
|
<type name="none" c:type="void"/>
|
9564
9532
|
</return-value>
|
@@ -9569,9 +9537,7 @@ can cause problems.</doc>
|
|
9569
9537
|
</instance-parameter>
|
9570
9538
|
<parameter name="do_close" transfer-ownership="none">
|
9571
9539
|
<doc xml:space="preserve">Whether to close the channel on the final unref of
|
9572
|
-
the GIOChannel data structure
|
9573
|
-
this is %TRUE for channels created by g_io_channel_new_file (),
|
9574
|
-
and %FALSE for all other channels.</doc>
|
9540
|
+
the GIOChannel data structure.</doc>
|
9575
9541
|
<type name="gboolean" c:type="gboolean"/>
|
9576
9542
|
</parameter>
|
9577
9543
|
</parameters>
|
@@ -11960,8 +11926,7 @@ See #G_BYTE_ORDER.</doc>
|
|
11960
11926
|
<constant name="LOG_DOMAIN" value="0" c:type="G_LOG_DOMAIN">
|
11961
11927
|
<doc xml:space="preserve">Defines the log domain.
|
11962
11928
|
|
11963
|
-
|
11964
|
-
(or "") domain. Libraries should define this so that any messages
|
11929
|
+
Libraries should define this so that any messages
|
11965
11930
|
which they log can be differentiated from messages from other
|
11966
11931
|
libraries and application code. But be careful not to define
|
11967
11932
|
it in any public header files.
|
@@ -11969,7 +11934,11 @@ it in any public header files.
|
|
11969
11934
|
For example, GTK+ uses this in its Makefile.am:
|
11970
11935
|
|[
|
11971
11936
|
AM_CPPFLAGS = -DG_LOG_DOMAIN=\"Gtk\"
|
11972
|
-
]
|
11937
|
+
]|
|
11938
|
+
|
11939
|
+
Applications can choose to leave it as the default %NULL (or "")
|
11940
|
+
domain. However, defining the domain offers the same advantages as
|
11941
|
+
above.</doc>
|
11973
11942
|
<type name="gchar" c:type="gchar"/>
|
11974
11943
|
</constant>
|
11975
11944
|
<constant name="LOG_FATAL_MASK" value="0" c:type="G_LOG_FATAL_MASK">
|
@@ -12994,7 +12963,14 @@ can write arbitrary binary output, as field values may be arbitrary binary.
|
|
12994
12963
|
|
12995
12964
|
@log_level is guaranteed to be included in @fields as the `PRIORITY` field,
|
12996
12965
|
but is provided separately for convenience of deciding whether or where to
|
12997
|
-
output the log entry
|
12966
|
+
output the log entry.
|
12967
|
+
|
12968
|
+
Writer functions should return %G_LOG_WRITER_HANDLED if they handled the log
|
12969
|
+
message successfully or if they deliberately ignored it. If there was an
|
12970
|
+
error handling the message (for example, if the writer function is meant to
|
12971
|
+
send messages to a remote logging server and there is a network error), it
|
12972
|
+
should return %G_LOG_WRITER_UNHANDLED. This allows writer functions to be
|
12973
|
+
chained and fall back to simpler handlers in case of failure.</doc>
|
12998
12974
|
<return-value transfer-ownership="none">
|
12999
12975
|
<doc xml:space="preserve">%G_LOG_WRITER_HANDLED if the log entry was handled successfully;
|
13000
12976
|
%G_LOG_WRITER_UNHANDLED otherwise</doc>
|
@@ -13092,7 +13068,7 @@ linked against at application run time.</doc>
|
|
13092
13068
|
<doc xml:space="preserve">The maximum value which can be held in a #guint8.</doc>
|
13093
13069
|
<type name="guint8" c:type="guint8"/>
|
13094
13070
|
</constant>
|
13095
|
-
<constant name="MICRO_VERSION" value="
|
13071
|
+
<constant name="MICRO_VERSION" value="1" c:type="GLIB_MICRO_VERSION">
|
13096
13072
|
<doc xml:space="preserve">The micro version number of the GLib library.
|
13097
13073
|
|
13098
13074
|
Like #gtk_micro_version, but from the headers used at
|
@@ -13119,7 +13095,7 @@ linked against at application run time.</doc>
|
|
13119
13095
|
<doc xml:space="preserve">The minimum value which can be held in a #gint8.</doc>
|
13120
13096
|
<type name="gint8" c:type="gint8"/>
|
13121
13097
|
</constant>
|
13122
|
-
<constant name="MINOR_VERSION" value="
|
13098
|
+
<constant name="MINOR_VERSION" value="54" c:type="GLIB_MINOR_VERSION">
|
13123
13099
|
<doc xml:space="preserve">The minor version number of the GLib library.
|
13124
13100
|
|
13125
13101
|
Like #gtk_minor_version, but from the headers used at
|
@@ -16092,6 +16068,22 @@ should generally be normalized before comparing them.</doc>
|
|
16092
16068
|
<doc xml:space="preserve">another name for %G_NORMALIZE_ALL_COMPOSE</doc>
|
16093
16069
|
</member>
|
16094
16070
|
</enumeration>
|
16071
|
+
<enumeration name="NumberParserError"
|
16072
|
+
version="2.54"
|
16073
|
+
c:type="GNumberParserError"
|
16074
|
+
glib:error-domain="g-number-parser-error-quark">
|
16075
|
+
<doc xml:space="preserve">Error codes returned by functions converting a string to a number.</doc>
|
16076
|
+
<member name="invalid"
|
16077
|
+
value="0"
|
16078
|
+
c:identifier="G_NUMBER_PARSER_ERROR_INVALID">
|
16079
|
+
<doc xml:space="preserve">String was not a valid number.</doc>
|
16080
|
+
</member>
|
16081
|
+
<member name="out_of_bounds"
|
16082
|
+
value="1"
|
16083
|
+
c:identifier="G_NUMBER_PARSER_ERROR_OUT_OF_BOUNDS">
|
16084
|
+
<doc xml:space="preserve">String was a number, but out of bounds.</doc>
|
16085
|
+
</member>
|
16086
|
+
</enumeration>
|
16095
16087
|
<constant name="OPTION_REMAINING"
|
16096
16088
|
value=""
|
16097
16089
|
c:type="G_OPTION_REMAINING"
|
@@ -17574,6 +17566,99 @@ in size automatically if necessary.</doc>
|
|
17574
17566
|
</parameter>
|
17575
17567
|
</parameters>
|
17576
17568
|
</function>
|
17569
|
+
<function name="find"
|
17570
|
+
c:identifier="g_ptr_array_find"
|
17571
|
+
version="2.54"
|
17572
|
+
introspectable="0">
|
17573
|
+
<doc xml:space="preserve">Checks whether @needle exists in @haystack. If the element is found, %TRUE is
|
17574
|
+
returned and the element’s index is returned in @index_ (if non-%NULL).
|
17575
|
+
Otherwise, %FALSE is returned and @index_ is undefined. If @needle exists
|
17576
|
+
multiple times in @haystack, the index of the first instance is returned.
|
17577
|
+
|
17578
|
+
This does pointer comparisons only. If you want to use more complex equality
|
17579
|
+
checks, such as string comparisons, use g_ptr_array_find_with_equal_func().</doc>
|
17580
|
+
<return-value transfer-ownership="none">
|
17581
|
+
<doc xml:space="preserve">%TRUE if @needle is one of the elements of @haystack</doc>
|
17582
|
+
<type name="gboolean" c:type="gboolean"/>
|
17583
|
+
</return-value>
|
17584
|
+
<parameters>
|
17585
|
+
<parameter name="haystack" transfer-ownership="none">
|
17586
|
+
<doc xml:space="preserve">pointer array to be searched</doc>
|
17587
|
+
<array name="GLib.PtrArray" c:type="GPtrArray*">
|
17588
|
+
<type name="gpointer" c:type="gpointer"/>
|
17589
|
+
</array>
|
17590
|
+
</parameter>
|
17591
|
+
<parameter name="needle"
|
17592
|
+
transfer-ownership="none"
|
17593
|
+
nullable="1"
|
17594
|
+
allow-none="1">
|
17595
|
+
<doc xml:space="preserve">pointer to look for</doc>
|
17596
|
+
<type name="gpointer" c:type="gconstpointer"/>
|
17597
|
+
</parameter>
|
17598
|
+
<parameter name="index_"
|
17599
|
+
direction="out"
|
17600
|
+
caller-allocates="1"
|
17601
|
+
transfer-ownership="none"
|
17602
|
+
optional="1"
|
17603
|
+
allow-none="1">
|
17604
|
+
<doc xml:space="preserve">return location for the index of
|
17605
|
+
the element, if found</doc>
|
17606
|
+
<type name="guint" c:type="guint*"/>
|
17607
|
+
</parameter>
|
17608
|
+
</parameters>
|
17609
|
+
</function>
|
17610
|
+
<function name="find_with_equal_func"
|
17611
|
+
c:identifier="g_ptr_array_find_with_equal_func"
|
17612
|
+
version="2.54"
|
17613
|
+
introspectable="0">
|
17614
|
+
<doc xml:space="preserve">Checks whether @needle exists in @haystack, using the given @equal_func.
|
17615
|
+
If the element is found, %TRUE is returned and the element’s index is
|
17616
|
+
returned in @index_ (if non-%NULL). Otherwise, %FALSE is returned and @index_
|
17617
|
+
is undefined. If @needle exists multiple times in @haystack, the index of
|
17618
|
+
the first instance is returned.
|
17619
|
+
|
17620
|
+
@equal_func is called with the element from the array as its first parameter,
|
17621
|
+
and @needle as its second parameter. If @equal_func is %NULL, pointer
|
17622
|
+
equality is used.</doc>
|
17623
|
+
<return-value transfer-ownership="none">
|
17624
|
+
<doc xml:space="preserve">%TRUE if @needle is one of the elements of @haystack</doc>
|
17625
|
+
<type name="gboolean" c:type="gboolean"/>
|
17626
|
+
</return-value>
|
17627
|
+
<parameters>
|
17628
|
+
<parameter name="haystack" transfer-ownership="none">
|
17629
|
+
<doc xml:space="preserve">pointer array to be searched</doc>
|
17630
|
+
<array name="GLib.PtrArray" c:type="GPtrArray*">
|
17631
|
+
<type name="gpointer" c:type="gpointer"/>
|
17632
|
+
</array>
|
17633
|
+
</parameter>
|
17634
|
+
<parameter name="needle"
|
17635
|
+
transfer-ownership="none"
|
17636
|
+
nullable="1"
|
17637
|
+
allow-none="1">
|
17638
|
+
<doc xml:space="preserve">pointer to look for</doc>
|
17639
|
+
<type name="gpointer" c:type="gconstpointer"/>
|
17640
|
+
</parameter>
|
17641
|
+
<parameter name="equal_func"
|
17642
|
+
transfer-ownership="none"
|
17643
|
+
nullable="1"
|
17644
|
+
allow-none="1">
|
17645
|
+
<doc xml:space="preserve">the function to call for each element, which should
|
17646
|
+
return %TRUE when the desired element is found; or %NULL to use pointer
|
17647
|
+
equality</doc>
|
17648
|
+
<type name="EqualFunc" c:type="GEqualFunc"/>
|
17649
|
+
</parameter>
|
17650
|
+
<parameter name="index_"
|
17651
|
+
direction="out"
|
17652
|
+
caller-allocates="1"
|
17653
|
+
transfer-ownership="none"
|
17654
|
+
optional="1"
|
17655
|
+
allow-none="1">
|
17656
|
+
<doc xml:space="preserve">return location for the index of
|
17657
|
+
the element, if found</doc>
|
17658
|
+
<type name="guint" c:type="guint*"/>
|
17659
|
+
</parameter>
|
17660
|
+
</parameters>
|
17661
|
+
</function>
|
17577
17662
|
<function name="foreach"
|
17578
17663
|
c:identifier="g_ptr_array_foreach"
|
17579
17664
|
version="2.4"
|
@@ -17612,7 +17697,11 @@ size of @array will be set to zero.
|
|
17612
17697
|
|
17613
17698
|
If array contents point to dynamically-allocated memory, they should
|
17614
17699
|
be freed separately if @free_seg is %TRUE and no #GDestroyNotify
|
17615
|
-
function has been set for @array
|
17700
|
+
function has been set for @array.
|
17701
|
+
|
17702
|
+
This function is not thread-safe. If using a #GPtrArray from multiple
|
17703
|
+
threads, use only the atomic g_ptr_array_ref() and g_ptr_array_unref()
|
17704
|
+
functions.</doc>
|
17616
17705
|
<return-value transfer-ownership="none" nullable="1">
|
17617
17706
|
<doc xml:space="preserve">the pointer array if @free_seg is %FALSE, otherwise %NULL.
|
17618
17707
|
The pointer array should be freed using g_free().</doc>
|
@@ -18030,7 +18119,7 @@ This is guaranteed to be a stable sort since version 2.32.</doc>
|
|
18030
18119
|
<doc xml:space="preserve">Atomically decrements the reference count of @array by one. If the
|
18031
18120
|
reference count drops to 0, the effect is the same as calling
|
18032
18121
|
g_ptr_array_free() with @free_segment set to %TRUE. This function
|
18033
|
-
is
|
18122
|
+
is thread-safe and may be called from any thread.</doc>
|
18034
18123
|
<return-value transfer-ownership="none">
|
18035
18124
|
<type name="none" c:type="void"/>
|
18036
18125
|
</return-value>
|
@@ -22645,12 +22734,9 @@ g_io_channel_seek_position() operation.</doc>
|
|
22645
22734
|
<record name="Sequence" c:type="GSequence" disguised="1">
|
22646
22735
|
<doc xml:space="preserve">The #GSequence struct is an opaque data type representing a
|
22647
22736
|
[sequence][glib-Sequences] data type.</doc>
|
22648
|
-
<method name="append"
|
22649
|
-
c:identifier="g_sequence_append"
|
22650
|
-
version="2.14"
|
22651
|
-
introspectable="0">
|
22737
|
+
<method name="append" c:identifier="g_sequence_append" version="2.14">
|
22652
22738
|
<doc xml:space="preserve">Adds a new item to the end of @seq.</doc>
|
22653
|
-
<return-value>
|
22739
|
+
<return-value transfer-ownership="none">
|
22654
22740
|
<doc xml:space="preserve">an iterator pointing to the new item</doc>
|
22655
22741
|
<type name="SequenceIter" c:type="GSequenceIter*"/>
|
22656
22742
|
</return-value>
|
@@ -22711,10 +22797,9 @@ in @seq.</doc>
|
|
22711
22797
|
</method>
|
22712
22798
|
<method name="get_begin_iter"
|
22713
22799
|
c:identifier="g_sequence_get_begin_iter"
|
22714
|
-
version="2.14"
|
22715
|
-
introspectable="0">
|
22800
|
+
version="2.14">
|
22716
22801
|
<doc xml:space="preserve">Returns the begin iterator for @seq.</doc>
|
22717
|
-
<return-value>
|
22802
|
+
<return-value transfer-ownership="none">
|
22718
22803
|
<doc xml:space="preserve">the begin iterator for @seq.</doc>
|
22719
22804
|
<type name="SequenceIter" c:type="GSequenceIter*"/>
|
22720
22805
|
</return-value>
|
@@ -22727,10 +22812,9 @@ in @seq.</doc>
|
|
22727
22812
|
</method>
|
22728
22813
|
<method name="get_end_iter"
|
22729
22814
|
c:identifier="g_sequence_get_end_iter"
|
22730
|
-
version="2.14"
|
22731
|
-
introspectable="0">
|
22815
|
+
version="2.14">
|
22732
22816
|
<doc xml:space="preserve">Returns the end iterator for @seg</doc>
|
22733
|
-
<return-value>
|
22817
|
+
<return-value transfer-ownership="none">
|
22734
22818
|
<doc xml:space="preserve">the end iterator for @seq</doc>
|
22735
22819
|
<type name="SequenceIter" c:type="GSequenceIter*"/>
|
22736
22820
|
</return-value>
|
@@ -22743,11 +22827,10 @@ in @seq.</doc>
|
|
22743
22827
|
</method>
|
22744
22828
|
<method name="get_iter_at_pos"
|
22745
22829
|
c:identifier="g_sequence_get_iter_at_pos"
|
22746
|
-
version="2.14"
|
22747
|
-
introspectable="0">
|
22830
|
+
version="2.14">
|
22748
22831
|
<doc xml:space="preserve">Returns the iterator at position @pos. If @pos is negative or larger
|
22749
22832
|
than the number of items in @seq, the end iterator is returned.</doc>
|
22750
|
-
<return-value>
|
22833
|
+
<return-value transfer-ownership="none">
|
22751
22834
|
<doc xml:space="preserve">The #GSequenceIter at position @pos</doc>
|
22752
22835
|
<type name="SequenceIter" c:type="GSequenceIter*"/>
|
22753
22836
|
</return-value>
|
@@ -22791,7 +22874,7 @@ otherwise the new position of @data is undefined.
|
|
22791
22874
|
It should return 0 if the items are equal, a negative value
|
22792
22875
|
if the first item comes before the second, and a positive value
|
22793
22876
|
if the second item comes before the first.</doc>
|
22794
|
-
<return-value>
|
22877
|
+
<return-value transfer-ownership="none">
|
22795
22878
|
<doc xml:space="preserve">a #GSequenceIter pointing to the new item.</doc>
|
22796
22879
|
<type name="SequenceIter" c:type="GSequenceIter*"/>
|
22797
22880
|
</return-value>
|
@@ -22837,7 +22920,7 @@ It is called with two iterators pointing into @seq. It should
|
|
22837
22920
|
return 0 if the iterators are equal, a negative value if the
|
22838
22921
|
first iterator comes before the second, and a positive value
|
22839
22922
|
if the second iterator comes before the first.</doc>
|
22840
|
-
<return-value>
|
22923
|
+
<return-value transfer-ownership="none">
|
22841
22924
|
<doc xml:space="preserve">a #GSequenceIter pointing to the new item</doc>
|
22842
22925
|
<type name="SequenceIter" c:type="GSequenceIter*"/>
|
22843
22926
|
</return-value>
|
@@ -22906,7 +22989,7 @@ unsorted. Use g_sequence_insert_sorted() or
|
|
22906
22989
|
g_sequence_insert_sorted_iter() to add data to your sequence or, if
|
22907
22990
|
you want to add a large amount of data, call g_sequence_sort() after
|
22908
22991
|
doing unsorted insertions.</doc>
|
22909
|
-
<return-value>
|
22992
|
+
<return-value transfer-ownership="none" nullable="1">
|
22910
22993
|
<doc xml:space="preserve">an #GSequenceIter pointing to the position of the
|
22911
22994
|
first item found equal to @data according to @cmp_func and
|
22912
22995
|
@cmp_data, or %NULL if no such item exists</doc>
|
@@ -22954,7 +23037,7 @@ unsorted. Use g_sequence_insert_sorted() or
|
|
22954
23037
|
g_sequence_insert_sorted_iter() to add data to your sequence or, if
|
22955
23038
|
you want to add a large amount of data, call g_sequence_sort() after
|
22956
23039
|
doing unsorted insertions.</doc>
|
22957
|
-
<return-value>
|
23040
|
+
<return-value transfer-ownership="none" nullable="1">
|
22958
23041
|
<doc xml:space="preserve">an #GSequenceIter pointing to the position of
|
22959
23042
|
the first item found equal to @data according to @cmp_func
|
22960
23043
|
and @cmp_data, or %NULL if no such item exists</doc>
|
@@ -22986,12 +23069,9 @@ doing unsorted insertions.</doc>
|
|
22986
23069
|
</parameter>
|
22987
23070
|
</parameters>
|
22988
23071
|
</method>
|
22989
|
-
<method name="prepend"
|
22990
|
-
c:identifier="g_sequence_prepend"
|
22991
|
-
version="2.14"
|
22992
|
-
introspectable="0">
|
23072
|
+
<method name="prepend" c:identifier="g_sequence_prepend" version="2.14">
|
22993
23073
|
<doc xml:space="preserve">Adds a new item to the front of @seq</doc>
|
22994
|
-
<return-value>
|
23074
|
+
<return-value transfer-ownership="none">
|
22995
23075
|
<doc xml:space="preserve">an iterator pointing to the new item</doc>
|
22996
23076
|
<type name="SequenceIter" c:type="GSequenceIter*"/>
|
22997
23077
|
</return-value>
|
@@ -23029,7 +23109,7 @@ unsorted. Use g_sequence_insert_sorted() or
|
|
23029
23109
|
g_sequence_insert_sorted_iter() to add data to your sequence or, if
|
23030
23110
|
you want to add a large amount of data, call g_sequence_sort() after
|
23031
23111
|
doing unsorted insertions.</doc>
|
23032
|
-
<return-value>
|
23112
|
+
<return-value transfer-ownership="none">
|
23033
23113
|
<doc xml:space="preserve">an #GSequenceIter pointing to the position where @data
|
23034
23114
|
would have been inserted according to @cmp_func and @cmp_data</doc>
|
23035
23115
|
<type name="SequenceIter" c:type="GSequenceIter*"/>
|
@@ -23079,7 +23159,7 @@ unsorted. Use g_sequence_insert_sorted() or
|
|
23079
23159
|
g_sequence_insert_sorted_iter() to add data to your sequence or, if
|
23080
23160
|
you want to add a large amount of data, call g_sequence_sort() after
|
23081
23161
|
doing unsorted insertions.</doc>
|
23082
|
-
<return-value>
|
23162
|
+
<return-value transfer-ownership="none">
|
23083
23163
|
<doc xml:space="preserve">a #GSequenceIter pointing to the position in @seq
|
23084
23164
|
where @data would have been inserted according to @iter_cmp
|
23085
23165
|
and @cmp_data</doc>
|
@@ -23221,10 +23301,9 @@ iterator comes before the first.</doc>
|
|
23221
23301
|
</function>
|
23222
23302
|
<function name="insert_before"
|
23223
23303
|
c:identifier="g_sequence_insert_before"
|
23224
|
-
version="2.14"
|
23225
|
-
introspectable="0">
|
23304
|
+
version="2.14">
|
23226
23305
|
<doc xml:space="preserve">Inserts a new item just before the item pointed to by @iter.</doc>
|
23227
|
-
<return-value>
|
23306
|
+
<return-value transfer-ownership="none">
|
23228
23307
|
<doc xml:space="preserve">an iterator pointing to the new item</doc>
|
23229
23308
|
<type name="SequenceIter" c:type="GSequenceIter*"/>
|
23230
23309
|
</return-value>
|
@@ -23298,7 +23377,7 @@ the (@begin, @end) range, the range does not move.</doc>
|
|
23298
23377
|
<doc xml:space="preserve">Creates a new GSequence. The @data_destroy function, if non-%NULL will
|
23299
23378
|
be called on all items when the sequence is destroyed and on items that
|
23300
23379
|
are removed from the sequence.</doc>
|
23301
|
-
<return-value>
|
23380
|
+
<return-value transfer-ownership="full">
|
23302
23381
|
<doc xml:space="preserve">a new #GSequence</doc>
|
23303
23382
|
<type name="Sequence" c:type="GSequence*"/>
|
23304
23383
|
</return-value>
|
@@ -23315,15 +23394,14 @@ are removed from the sequence.</doc>
|
|
23315
23394
|
</function>
|
23316
23395
|
<function name="range_get_midpoint"
|
23317
23396
|
c:identifier="g_sequence_range_get_midpoint"
|
23318
|
-
version="2.14"
|
23319
|
-
introspectable="0">
|
23397
|
+
version="2.14">
|
23320
23398
|
<doc xml:space="preserve">Finds an iterator somewhere in the range (@begin, @end). This
|
23321
23399
|
iterator will be close to the middle of the range, but is not
|
23322
23400
|
guaranteed to be exactly in the middle.
|
23323
23401
|
|
23324
23402
|
The @begin and @end iterators must both point to the same sequence
|
23325
23403
|
and @begin must come before or be equal to @end in the sequence.</doc>
|
23326
|
-
<return-value>
|
23404
|
+
<return-value transfer-ownership="none">
|
23327
23405
|
<doc xml:space="preserve">a #GSequenceIter pointing somewhere in the
|
23328
23406
|
(@begin, @end) range</doc>
|
23329
23407
|
<type name="SequenceIter" c:type="GSequenceIter*"/>
|
@@ -23526,10 +23604,9 @@ The @a and @b iterators must point into the same sequence.</doc>
|
|
23526
23604
|
</method>
|
23527
23605
|
<method name="get_sequence"
|
23528
23606
|
c:identifier="g_sequence_iter_get_sequence"
|
23529
|
-
version="2.14"
|
23530
|
-
introspectable="0">
|
23607
|
+
version="2.14">
|
23531
23608
|
<doc xml:space="preserve">Returns the #GSequence that @iter points into.</doc>
|
23532
|
-
<return-value>
|
23609
|
+
<return-value transfer-ownership="none">
|
23533
23610
|
<doc xml:space="preserve">the #GSequence that @iter points into</doc>
|
23534
23611
|
<type name="Sequence" c:type="GSequence*"/>
|
23535
23612
|
</return-value>
|
@@ -23570,15 +23647,12 @@ The @a and @b iterators must point into the same sequence.</doc>
|
|
23570
23647
|
</instance-parameter>
|
23571
23648
|
</parameters>
|
23572
23649
|
</method>
|
23573
|
-
<method name="move"
|
23574
|
-
c:identifier="g_sequence_iter_move"
|
23575
|
-
version="2.14"
|
23576
|
-
introspectable="0">
|
23650
|
+
<method name="move" c:identifier="g_sequence_iter_move" version="2.14">
|
23577
23651
|
<doc xml:space="preserve">Returns the #GSequenceIter which is @delta positions away from @iter.
|
23578
23652
|
If @iter is closer than -@delta positions to the beginning of the sequence,
|
23579
23653
|
the begin iterator is returned. If @iter is closer than @delta positions
|
23580
23654
|
to the end of the sequence, the end iterator is returned.</doc>
|
23581
|
-
<return-value>
|
23655
|
+
<return-value transfer-ownership="none">
|
23582
23656
|
<doc xml:space="preserve">a #GSequenceIter which is @delta positions away from @iter</doc>
|
23583
23657
|
<type name="SequenceIter" c:type="GSequenceIter*"/>
|
23584
23658
|
</return-value>
|
@@ -23594,13 +23668,10 @@ to the end of the sequence, the end iterator is returned.</doc>
|
|
23594
23668
|
</parameter>
|
23595
23669
|
</parameters>
|
23596
23670
|
</method>
|
23597
|
-
<method name="next"
|
23598
|
-
c:identifier="g_sequence_iter_next"
|
23599
|
-
version="2.14"
|
23600
|
-
introspectable="0">
|
23671
|
+
<method name="next" c:identifier="g_sequence_iter_next" version="2.14">
|
23601
23672
|
<doc xml:space="preserve">Returns an iterator pointing to the next position after @iter.
|
23602
23673
|
If @iter is the end iterator, the end iterator is returned.</doc>
|
23603
|
-
<return-value>
|
23674
|
+
<return-value transfer-ownership="none">
|
23604
23675
|
<doc xml:space="preserve">a #GSequenceIter pointing to the next position after @iter</doc>
|
23605
23676
|
<type name="SequenceIter" c:type="GSequenceIter*"/>
|
23606
23677
|
</return-value>
|
@@ -23611,13 +23682,10 @@ If @iter is the end iterator, the end iterator is returned.</doc>
|
|
23611
23682
|
</instance-parameter>
|
23612
23683
|
</parameters>
|
23613
23684
|
</method>
|
23614
|
-
<method name="prev"
|
23615
|
-
c:identifier="g_sequence_iter_prev"
|
23616
|
-
version="2.14"
|
23617
|
-
introspectable="0">
|
23685
|
+
<method name="prev" c:identifier="g_sequence_iter_prev" version="2.14">
|
23618
23686
|
<doc xml:space="preserve">Returns an iterator pointing to the previous position before @iter.
|
23619
23687
|
If @iter is the begin iterator, the begin iterator is returned.</doc>
|
23620
|
-
<return-value>
|
23688
|
+
<return-value transfer-ownership="none">
|
23621
23689
|
<doc xml:space="preserve">a #GSequenceIter pointing to the previous position
|
23622
23690
|
before @iter</doc>
|
23623
23691
|
<type name="SequenceIter" c:type="GSequenceIter*"/>
|
@@ -26720,9 +26788,16 @@ the W3C Note
|
|
26720
26788
|
Both of these documents are profiles of ISO 8601.
|
26721
26789
|
|
26722
26790
|
Use g_date_time_format() or g_strdup_printf() if a different
|
26723
|
-
variation of ISO 8601 format is required
|
26724
|
-
|
26725
|
-
|
26791
|
+
variation of ISO 8601 format is required.
|
26792
|
+
|
26793
|
+
If @time_ represents a date which is too large to fit into a `struct tm`,
|
26794
|
+
%NULL will be returned. This is platform dependent, but it is safe to assume
|
26795
|
+
years up to 3000 are supported. The return value of g_time_val_to_iso8601()
|
26796
|
+
has been nullable since GLib 2.54; before then, GLib would crash under the
|
26797
|
+
same conditions.</doc>
|
26798
|
+
<return-value transfer-ownership="full" nullable="1">
|
26799
|
+
<doc xml:space="preserve">a newly allocated string containing an ISO 8601 date,
|
26800
|
+
or %NULL if @time_ was too large</doc>
|
26726
26801
|
<type name="utf8" c:type="gchar*"/>
|
26727
26802
|
</return-value>
|
26728
26803
|
<parameters>
|
@@ -28780,7 +28855,25 @@ See [Unicode Standard Annex #24: Script names](http://www.unicode.org/reports/tr
|
|
28780
28855
|
<doc xml:space="preserve">Osage. Since: 2.50</doc>
|
28781
28856
|
</member>
|
28782
28857
|
<member name="tangut" value="137" c:identifier="G_UNICODE_SCRIPT_TANGUT">
|
28783
|
-
<doc xml:space="preserve">Tangut. Since: 2.50
|
28858
|
+
<doc xml:space="preserve">Tangut. Since: 2.50
|
28859
|
+
@G_UNICODE_SCRIPT_MASARAM_GONDI, Masaram Gondi. Since: 2.54
|
28860
|
+
@G_UNICODE_SCRIPT_NUSHU, Nushu. Since: 2.54
|
28861
|
+
@G_UNICODE_SCRIPT_SOYOMBO, Soyombo. Since: 2.54
|
28862
|
+
@G_UNICODE_SCRIPT_ZANABAZAR_SQUARE Zanabazar Square. Since: 2.54</doc>
|
28863
|
+
</member>
|
28864
|
+
<member name="masaram_gondi"
|
28865
|
+
value="138"
|
28866
|
+
c:identifier="G_UNICODE_SCRIPT_MASARAM_GONDI">
|
28867
|
+
</member>
|
28868
|
+
<member name="nushu" value="139" c:identifier="G_UNICODE_SCRIPT_NUSHU">
|
28869
|
+
</member>
|
28870
|
+
<member name="soyombo"
|
28871
|
+
value="140"
|
28872
|
+
c:identifier="G_UNICODE_SCRIPT_SOYOMBO">
|
28873
|
+
</member>
|
28874
|
+
<member name="zanabazar_square"
|
28875
|
+
value="141"
|
28876
|
+
c:identifier="G_UNICODE_SCRIPT_ZANABAZAR_SQUARE">
|
28784
28877
|
</member>
|
28785
28878
|
</enumeration>
|
28786
28879
|
<enumeration name="UnicodeType" c:type="GUnicodeType">
|
@@ -29026,10 +29119,10 @@ For instance, if you want to create a #GVariant holding an integer value you
|
|
29026
29119
|
can use:
|
29027
29120
|
|
29028
29121
|
|[<!-- language="C" -->
|
29029
|
-
GVariant *v = g_variant_new (
|
29122
|
+
GVariant *v = g_variant_new ("u", 40);
|
29030
29123
|
]|
|
29031
29124
|
|
29032
|
-
The string
|
29125
|
+
The string "u" in the first argument tells #GVariant that the data passed to
|
29033
29126
|
the constructor (40) is going to be an unsigned integer.
|
29034
29127
|
|
29035
29128
|
More advanced examples of #GVariant in use can be found in documentation for
|
@@ -29241,7 +29334,7 @@ child.
|
|
29241
29334
|
|
29242
29335
|
To put the entire example together, for our dictionary mapping
|
29243
29336
|
strings to variants (with two entries, as given above), we are
|
29244
|
-
using 91 bytes of memory for type information, 29
|
29337
|
+
using 91 bytes of memory for type information, 29 bytes of memory
|
29245
29338
|
for the serialised data, 16 bytes for buffer management and 24
|
29246
29339
|
bytes for the #GVariant instance, or a total of 160 bytes, plus
|
29247
29340
|
malloc overhead. If we were to use g_variant_get_child_value() to
|
@@ -29461,10 +29554,10 @@ the new instance takes ownership of them as if via g_variant_ref_sink().</doc>
|
|
29461
29554
|
<constructor name="new_fixed_array"
|
29462
29555
|
c:identifier="g_variant_new_fixed_array"
|
29463
29556
|
version="2.32">
|
29464
|
-
<doc xml:space="preserve">
|
29465
|
-
|
29557
|
+
<doc xml:space="preserve">Constructs a new array #GVariant instance, where the elements are
|
29558
|
+
of @element_type type.
|
29466
29559
|
|
29467
|
-
@
|
29560
|
+
@elements must be an array with fixed-sized elements. Numeric types are
|
29468
29561
|
fixed-size as are tuples containing only other fixed-sized types.
|
29469
29562
|
|
29470
29563
|
@element_size must be the size of a single element in the array.
|
@@ -29473,8 +29566,7 @@ you might say sizeof(gint32). This value isn't used except for the purpose
|
|
29473
29566
|
of a double-check that the form of the serialised data matches the caller's
|
29474
29567
|
expectation.
|
29475
29568
|
|
29476
|
-
@n_elements
|
29477
|
-
items in the array.</doc>
|
29569
|
+
@n_elements must be the length of the @elements array.</doc>
|
29478
29570
|
<return-value transfer-ownership="none">
|
29479
29571
|
<doc xml:space="preserve">a floating reference to a new array #GVariant instance</doc>
|
29480
29572
|
<type name="Variant" c:type="GVariant*"/>
|
@@ -30029,7 +30121,7 @@ pointing to the argument following the last.
|
|
30029
30121
|
|
30030
30122
|
Note that the arguments in @app must be of the correct width for their
|
30031
30123
|
types specified in @format_string when collected into the #va_list.
|
30032
|
-
See the [GVariant varargs documentation][gvariant-varargs.
|
30124
|
+
See the [GVariant varargs documentation][gvariant-varargs].
|
30033
30125
|
|
30034
30126
|
These two generalisations allow mixing of multiple calls to
|
30035
30127
|
g_variant_new_va() and g_variant_get_va() within a single actual
|
@@ -31902,7 +31994,7 @@ It typically only makes sense to do this on a stack-allocated
|
|
31902
31994
|
#GVariantBuilder if you want to abort building the value part-way
|
31903
31995
|
through. This function need not be called if you call
|
31904
31996
|
g_variant_builder_end() and it also doesn't need to be called on
|
31905
|
-
builders allocated with g_variant_builder_new (see
|
31997
|
+
builders allocated with g_variant_builder_new() (see
|
31906
31998
|
g_variant_builder_unref() for that).
|
31907
31999
|
|
31908
32000
|
This function leaves the #GVariantBuilder structure set to all-zeros.
|
@@ -33073,7 +33165,7 @@ The meaning of each of the characters is as follows:
|
|
33073
33165
|
- `s`: the type string of %G_VARIANT_TYPE_STRING; a string.
|
33074
33166
|
- `o`: the type string of %G_VARIANT_TYPE_OBJECT_PATH; a string in the form
|
33075
33167
|
of a D-Bus object path.
|
33076
|
-
- `g`: the type string of %
|
33168
|
+
- `g`: the type string of %G_VARIANT_TYPE_SIGNATURE; a string in the form of
|
33077
33169
|
a D-Bus type signature.
|
33078
33170
|
- `?`: the type string of %G_VARIANT_TYPE_BASIC; an indefinite type that
|
33079
33171
|
is a supertype of any of the basic types.
|
@@ -33954,6 +34046,120 @@ Both @s1 and @s2 must be non-%NULL.</doc>
|
|
33954
34046
|
</parameter>
|
33955
34047
|
</parameters>
|
33956
34048
|
</function>
|
34049
|
+
<function name="ascii_string_to_signed"
|
34050
|
+
c:identifier="g_ascii_string_to_signed"
|
34051
|
+
version="2.54"
|
34052
|
+
throws="1">
|
34053
|
+
<doc xml:space="preserve">A convenience function for converting a string to a signed number.
|
34054
|
+
|
34055
|
+
This function assumes that @str contains only a number of the given
|
34056
|
+
@base that is within inclusive bounds limited by @min and @max. If
|
34057
|
+
this is true, then the converted number is stored in @out_num. An
|
34058
|
+
empty string is not a valid input. A string with leading or
|
34059
|
+
trailing whitespace is also an invalid input.
|
34060
|
+
|
34061
|
+
@base can be between 2 and 36 inclusive. Hexadecimal numbers must
|
34062
|
+
not be prefixed with "0x" or "0X". Such a problem does not exist
|
34063
|
+
for octal numbers, since they were usually prefixed with a zero
|
34064
|
+
which does not change the value of the parsed number.
|
34065
|
+
|
34066
|
+
Parsing failures result in an error with the %G_NUMBER_PARSER_ERROR
|
34067
|
+
domain. If the input is invalid, the error code will be
|
34068
|
+
%G_NUMBER_PARSER_ERROR_INVALID. If the parsed number is out of
|
34069
|
+
bounds - %G_NUMBER_PARSER_ERROR_OUT_OF_BOUNDS.
|
34070
|
+
|
34071
|
+
See g_ascii_strtoll() if you have more complex needs such as
|
34072
|
+
parsing a string which starts with a number, but then has other
|
34073
|
+
characters.</doc>
|
34074
|
+
<return-value transfer-ownership="none">
|
34075
|
+
<doc xml:space="preserve">%TRUE if @str was a number, otherwise %FALSE.</doc>
|
34076
|
+
<type name="gboolean" c:type="gboolean"/>
|
34077
|
+
</return-value>
|
34078
|
+
<parameters>
|
34079
|
+
<parameter name="str" transfer-ownership="none">
|
34080
|
+
<doc xml:space="preserve">a string</doc>
|
34081
|
+
<type name="utf8" c:type="const gchar*"/>
|
34082
|
+
</parameter>
|
34083
|
+
<parameter name="base" transfer-ownership="none">
|
34084
|
+
<doc xml:space="preserve">base of a parsed number</doc>
|
34085
|
+
<type name="guint" c:type="guint"/>
|
34086
|
+
</parameter>
|
34087
|
+
<parameter name="min" transfer-ownership="none">
|
34088
|
+
<doc xml:space="preserve">a lower bound (inclusive)</doc>
|
34089
|
+
<type name="gint64" c:type="gint64"/>
|
34090
|
+
</parameter>
|
34091
|
+
<parameter name="max" transfer-ownership="none">
|
34092
|
+
<doc xml:space="preserve">an upper bound (inclusive)</doc>
|
34093
|
+
<type name="gint64" c:type="gint64"/>
|
34094
|
+
</parameter>
|
34095
|
+
<parameter name="out_num"
|
34096
|
+
direction="out"
|
34097
|
+
caller-allocates="0"
|
34098
|
+
transfer-ownership="full"
|
34099
|
+
optional="1"
|
34100
|
+
allow-none="1">
|
34101
|
+
<doc xml:space="preserve">a return location for a number</doc>
|
34102
|
+
<type name="gint64" c:type="gint64*"/>
|
34103
|
+
</parameter>
|
34104
|
+
</parameters>
|
34105
|
+
</function>
|
34106
|
+
<function name="ascii_string_to_unsigned"
|
34107
|
+
c:identifier="g_ascii_string_to_unsigned"
|
34108
|
+
version="2.54"
|
34109
|
+
throws="1">
|
34110
|
+
<doc xml:space="preserve">A convenience function for converting a string to an unsigned number.
|
34111
|
+
|
34112
|
+
This function assumes that @str contains only a number of the given
|
34113
|
+
@base that is within inclusive bounds limited by @min and @max. If
|
34114
|
+
this is true, then the converted number is stored in @out_num. An
|
34115
|
+
empty string is not a valid input. A string with leading or
|
34116
|
+
trailing whitespace is also an invalid input.
|
34117
|
+
|
34118
|
+
@base can be between 2 and 36 inclusive. Hexadecimal numbers must
|
34119
|
+
not be prefixed with "0x" or "0X". Such a problem does not exist
|
34120
|
+
for octal numbers, since they were usually prefixed with a zero
|
34121
|
+
which does not change the value of the parsed number.
|
34122
|
+
|
34123
|
+
Parsing failures result in an error with the %G_NUMBER_PARSER_ERROR
|
34124
|
+
domain. If the input is invalid, the error code will be
|
34125
|
+
%G_NUMBER_PARSER_ERROR_INVALID. If the parsed number is out of
|
34126
|
+
bounds - %G_NUMBER_PARSER_ERROR_OUT_OF_BOUNDS.
|
34127
|
+
|
34128
|
+
See g_ascii_strtoull() if you have more complex needs such as
|
34129
|
+
parsing a string which starts with a number, but then has other
|
34130
|
+
characters.</doc>
|
34131
|
+
<return-value transfer-ownership="none">
|
34132
|
+
<doc xml:space="preserve">%TRUE if @str was a number, otherwise %FALSE.</doc>
|
34133
|
+
<type name="gboolean" c:type="gboolean"/>
|
34134
|
+
</return-value>
|
34135
|
+
<parameters>
|
34136
|
+
<parameter name="str" transfer-ownership="none">
|
34137
|
+
<doc xml:space="preserve">a string</doc>
|
34138
|
+
<type name="utf8" c:type="const gchar*"/>
|
34139
|
+
</parameter>
|
34140
|
+
<parameter name="base" transfer-ownership="none">
|
34141
|
+
<doc xml:space="preserve">base of a parsed number</doc>
|
34142
|
+
<type name="guint" c:type="guint"/>
|
34143
|
+
</parameter>
|
34144
|
+
<parameter name="min" transfer-ownership="none">
|
34145
|
+
<doc xml:space="preserve">a lower bound (inclusive)</doc>
|
34146
|
+
<type name="guint64" c:type="guint64"/>
|
34147
|
+
</parameter>
|
34148
|
+
<parameter name="max" transfer-ownership="none">
|
34149
|
+
<doc xml:space="preserve">an upper bound (inclusive)</doc>
|
34150
|
+
<type name="guint64" c:type="guint64"/>
|
34151
|
+
</parameter>
|
34152
|
+
<parameter name="out_num"
|
34153
|
+
direction="out"
|
34154
|
+
caller-allocates="0"
|
34155
|
+
transfer-ownership="full"
|
34156
|
+
optional="1"
|
34157
|
+
allow-none="1">
|
34158
|
+
<doc xml:space="preserve">a return location for a number</doc>
|
34159
|
+
<type name="guint64" c:type="guint64*"/>
|
34160
|
+
</parameter>
|
34161
|
+
</parameters>
|
34162
|
+
</function>
|
33957
34163
|
<function name="ascii_strncasecmp" c:identifier="g_ascii_strncasecmp">
|
33958
34164
|
<doc xml:space="preserve">Compare @s1 and @s2, ignoring the case of ASCII characters and any
|
33959
34165
|
characters after the first @n in each string.
|
@@ -37392,24 +37598,6 @@ codes are those in the #GFileError enumeration. In the error case,
|
|
37392
37598
|
</parameter>
|
37393
37599
|
</parameters>
|
37394
37600
|
</function>
|
37395
|
-
<function name="file_get_contents_utf8"
|
37396
|
-
c:identifier="g_file_get_contents_utf8"
|
37397
|
-
throws="1">
|
37398
|
-
<return-value transfer-ownership="none">
|
37399
|
-
<type name="gboolean" c:type="gboolean"/>
|
37400
|
-
</return-value>
|
37401
|
-
<parameters>
|
37402
|
-
<parameter name="filename" transfer-ownership="none">
|
37403
|
-
<type name="utf8" c:type="const gchar*"/>
|
37404
|
-
</parameter>
|
37405
|
-
<parameter name="contents" transfer-ownership="none">
|
37406
|
-
<type name="utf8" c:type="gchar**"/>
|
37407
|
-
</parameter>
|
37408
|
-
<parameter name="length" transfer-ownership="none">
|
37409
|
-
<type name="gsize" c:type="gsize*"/>
|
37410
|
-
</parameter>
|
37411
|
-
</parameters>
|
37412
|
-
</function>
|
37413
37601
|
<function name="file_open_tmp" c:identifier="g_file_open_tmp" throws="1">
|
37414
37602
|
<doc xml:space="preserve">Opens a file for writing in the preferred directory for temporary
|
37415
37603
|
files (as returned by g_get_tmp_dir()).
|
@@ -37453,21 +37641,6 @@ name encoding.</doc>
|
|
37453
37641
|
</parameter>
|
37454
37642
|
</parameters>
|
37455
37643
|
</function>
|
37456
|
-
<function name="file_open_tmp_utf8"
|
37457
|
-
c:identifier="g_file_open_tmp_utf8"
|
37458
|
-
throws="1">
|
37459
|
-
<return-value transfer-ownership="none">
|
37460
|
-
<type name="gint" c:type="gint"/>
|
37461
|
-
</return-value>
|
37462
|
-
<parameters>
|
37463
|
-
<parameter name="tmpl" transfer-ownership="none">
|
37464
|
-
<type name="utf8" c:type="const gchar*"/>
|
37465
|
-
</parameter>
|
37466
|
-
<parameter name="name_used" transfer-ownership="none">
|
37467
|
-
<type name="utf8" c:type="gchar**"/>
|
37468
|
-
</parameter>
|
37469
|
-
</parameters>
|
37470
|
-
</function>
|
37471
37644
|
<function name="file_read_link"
|
37472
37645
|
c:identifier="g_file_read_link"
|
37473
37646
|
version="2.4"
|
@@ -37596,19 +37769,6 @@ extensions and those listed in the `PATHEXT` environment variable.</doc>
|
|
37596
37769
|
</parameter>
|
37597
37770
|
</parameters>
|
37598
37771
|
</function>
|
37599
|
-
<function name="file_test_utf8" c:identifier="g_file_test_utf8">
|
37600
|
-
<return-value transfer-ownership="none">
|
37601
|
-
<type name="gboolean" c:type="gboolean"/>
|
37602
|
-
</return-value>
|
37603
|
-
<parameters>
|
37604
|
-
<parameter name="filename" transfer-ownership="none">
|
37605
|
-
<type name="utf8" c:type="const gchar*"/>
|
37606
|
-
</parameter>
|
37607
|
-
<parameter name="test" transfer-ownership="none">
|
37608
|
-
<type name="FileTest" c:type="GFileTest"/>
|
37609
|
-
</parameter>
|
37610
|
-
</parameters>
|
37611
|
-
</function>
|
37612
37772
|
<function name="filename_display_basename"
|
37613
37773
|
c:identifier="g_filename_display_basename"
|
37614
37774
|
version="2.6">
|
@@ -37691,6 +37851,7 @@ encoding used for filenames.</doc>
|
|
37691
37851
|
direction="out"
|
37692
37852
|
caller-allocates="0"
|
37693
37853
|
transfer-ownership="full"
|
37854
|
+
nullable="1"
|
37694
37855
|
optional="1"
|
37695
37856
|
allow-none="1">
|
37696
37857
|
<doc xml:space="preserve">Location to store hostname for the URI.
|
@@ -37700,21 +37861,6 @@ encoding used for filenames.</doc>
|
|
37700
37861
|
</parameter>
|
37701
37862
|
</parameters>
|
37702
37863
|
</function>
|
37703
|
-
<function name="filename_from_uri_utf8"
|
37704
|
-
c:identifier="g_filename_from_uri_utf8"
|
37705
|
-
throws="1">
|
37706
|
-
<return-value transfer-ownership="full">
|
37707
|
-
<type name="utf8" c:type="gchar*"/>
|
37708
|
-
</return-value>
|
37709
|
-
<parameters>
|
37710
|
-
<parameter name="uri" transfer-ownership="none">
|
37711
|
-
<type name="utf8" c:type="const gchar*"/>
|
37712
|
-
</parameter>
|
37713
|
-
<parameter name="hostname" transfer-ownership="none">
|
37714
|
-
<type name="utf8" c:type="gchar**"/>
|
37715
|
-
</parameter>
|
37716
|
-
</parameters>
|
37717
|
-
</function>
|
37718
37864
|
<function name="filename_from_utf8"
|
37719
37865
|
c:identifier="g_filename_from_utf8"
|
37720
37866
|
throws="1">
|
@@ -37765,27 +37911,6 @@ on other platforms, this function indirectly depends on the
|
|
37765
37911
|
</parameter>
|
37766
37912
|
</parameters>
|
37767
37913
|
</function>
|
37768
|
-
<function name="filename_from_utf8_utf8"
|
37769
|
-
c:identifier="g_filename_from_utf8_utf8"
|
37770
|
-
throws="1">
|
37771
|
-
<return-value transfer-ownership="full">
|
37772
|
-
<type name="utf8" c:type="gchar*"/>
|
37773
|
-
</return-value>
|
37774
|
-
<parameters>
|
37775
|
-
<parameter name="utf8string" transfer-ownership="none">
|
37776
|
-
<type name="utf8" c:type="const gchar*"/>
|
37777
|
-
</parameter>
|
37778
|
-
<parameter name="len" transfer-ownership="none">
|
37779
|
-
<type name="gssize" c:type="gssize"/>
|
37780
|
-
</parameter>
|
37781
|
-
<parameter name="bytes_read" transfer-ownership="none">
|
37782
|
-
<type name="gsize" c:type="gsize*"/>
|
37783
|
-
</parameter>
|
37784
|
-
<parameter name="bytes_written" transfer-ownership="none">
|
37785
|
-
<type name="gsize" c:type="gsize*"/>
|
37786
|
-
</parameter>
|
37787
|
-
</parameters>
|
37788
|
-
</function>
|
37789
37914
|
<function name="filename_to_uri"
|
37790
37915
|
c:identifier="g_filename_to_uri"
|
37791
37916
|
throws="1">
|
@@ -37812,21 +37937,6 @@ component following Section 3.3. of RFC 2396.</doc>
|
|
37812
37937
|
</parameter>
|
37813
37938
|
</parameters>
|
37814
37939
|
</function>
|
37815
|
-
<function name="filename_to_uri_utf8"
|
37816
|
-
c:identifier="g_filename_to_uri_utf8"
|
37817
|
-
throws="1">
|
37818
|
-
<return-value transfer-ownership="full">
|
37819
|
-
<type name="utf8" c:type="gchar*"/>
|
37820
|
-
</return-value>
|
37821
|
-
<parameters>
|
37822
|
-
<parameter name="filename" transfer-ownership="none">
|
37823
|
-
<type name="utf8" c:type="const gchar*"/>
|
37824
|
-
</parameter>
|
37825
|
-
<parameter name="hostname" transfer-ownership="none">
|
37826
|
-
<type name="utf8" c:type="const gchar*"/>
|
37827
|
-
</parameter>
|
37828
|
-
</parameters>
|
37829
|
-
</function>
|
37830
37940
|
<function name="filename_to_utf8"
|
37831
37941
|
c:identifier="g_filename_to_utf8"
|
37832
37942
|
throws="1">
|
@@ -37878,27 +37988,6 @@ the [current locale][setlocale].</doc>
|
|
37878
37988
|
</parameter>
|
37879
37989
|
</parameters>
|
37880
37990
|
</function>
|
37881
|
-
<function name="filename_to_utf8_utf8"
|
37882
|
-
c:identifier="g_filename_to_utf8_utf8"
|
37883
|
-
throws="1">
|
37884
|
-
<return-value transfer-ownership="full">
|
37885
|
-
<type name="utf8" c:type="gchar*"/>
|
37886
|
-
</return-value>
|
37887
|
-
<parameters>
|
37888
|
-
<parameter name="opsysstring" transfer-ownership="none">
|
37889
|
-
<type name="utf8" c:type="const gchar*"/>
|
37890
|
-
</parameter>
|
37891
|
-
<parameter name="len" transfer-ownership="none">
|
37892
|
-
<type name="gssize" c:type="gssize"/>
|
37893
|
-
</parameter>
|
37894
|
-
<parameter name="bytes_read" transfer-ownership="none">
|
37895
|
-
<type name="gsize" c:type="gsize*"/>
|
37896
|
-
</parameter>
|
37897
|
-
<parameter name="bytes_written" transfer-ownership="none">
|
37898
|
-
<type name="gsize" c:type="gsize*"/>
|
37899
|
-
</parameter>
|
37900
|
-
</parameters>
|
37901
|
-
</function>
|
37902
37991
|
<function name="find_program_in_path"
|
37903
37992
|
c:identifier="g_find_program_in_path">
|
37904
37993
|
<doc xml:space="preserve">Locates the first executable named @program in the user's path, in the
|
@@ -38180,12 +38269,6 @@ the current directory is the target of a symbolic link.</doc>
|
|
38180
38269
|
<type name="filename" c:type="gchar*"/>
|
38181
38270
|
</return-value>
|
38182
38271
|
</function>
|
38183
|
-
<function name="get_current_dir_utf8"
|
38184
|
-
c:identifier="g_get_current_dir_utf8">
|
38185
|
-
<return-value transfer-ownership="full">
|
38186
|
-
<type name="utf8" c:type="gchar*"/>
|
38187
|
-
</return-value>
|
38188
|
-
</function>
|
38189
38272
|
<function name="get_current_time" c:identifier="g_get_current_time">
|
38190
38273
|
<doc xml:space="preserve">Equivalent to the UNIX gettimeofday() function, but portable.
|
38191
38274
|
|
@@ -38387,9 +38470,11 @@ similar cases.</doc>
|
|
38387
38470
|
<doc xml:space="preserve">Gets the name of the program. This name should not be localized,
|
38388
38471
|
in contrast to g_get_application_name().
|
38389
38472
|
|
38390
|
-
If you are using
|
38391
|
-
|
38392
|
-
|
38473
|
+
If you are using #GApplication the program name is set in
|
38474
|
+
g_application_run(). In case of GDK or GTK+ it is set in
|
38475
|
+
gdk_init(), which is called by gtk_init() and the
|
38476
|
+
#GtkApplication::startup handler. The program name is found by
|
38477
|
+
taking the last component of @argv[0].</doc>
|
38393
38478
|
<return-value transfer-ownership="none">
|
38394
38479
|
<doc xml:space="preserve">the name of the program. The returned string belongs
|
38395
38480
|
to GLib and must not be modified or freed.</doc>
|
@@ -38435,12 +38520,15 @@ in the
|
|
38435
38520
|
[XDG Base Directory Specification](http://www.freedesktop.org/Standards/basedir-spec).
|
38436
38521
|
In this case the list of directories retrieved will be `XDG_CONFIG_DIRS`.
|
38437
38522
|
|
38438
|
-
On Windows
|
38439
|
-
|
38440
|
-
|
38441
|
-
|
38442
|
-
|
38443
|
-
|
38523
|
+
On Windows it follows XDG Base Directory Specification if `XDG_CONFIG_DIRS` is defined.
|
38524
|
+
If `XDG_CONFIG_DIRS` is undefined, the directory that contains application
|
38525
|
+
data for all users is used instead. A typical path is
|
38526
|
+
`C:\Documents and Settings\All Users\Application Data`.
|
38527
|
+
This folder is used for application data
|
38528
|
+
that is not user specific. For example, an application can store
|
38529
|
+
a spell-check dictionary, a database of clip art, or a log file in the
|
38530
|
+
CSIDL_COMMON_APPDATA folder. This information will not roam and is available
|
38531
|
+
to anyone using the computer.</doc>
|
38444
38532
|
<return-value transfer-ownership="none">
|
38445
38533
|
<doc xml:space="preserve">
|
38446
38534
|
a %NULL-terminated array of strings owned by GLib that must not be
|
@@ -38459,9 +38547,11 @@ system-wide application data.
|
|
38459
38547
|
On UNIX platforms this is determined using the mechanisms described
|
38460
38548
|
in the
|
38461
38549
|
[XDG Base Directory Specification](http://www.freedesktop.org/Standards/basedir-spec)
|
38462
|
-
In this case the list of directories retrieved will be XDG_DATA_DIRS
|
38550
|
+
In this case the list of directories retrieved will be `XDG_DATA_DIRS`.
|
38463
38551
|
|
38464
|
-
On Windows
|
38552
|
+
On Windows it follows XDG Base Directory Specification if `XDG_DATA_DIRS` is defined.
|
38553
|
+
If `XDG_DATA_DIRS` is undefined,
|
38554
|
+
the first elements in the list are the Application Data
|
38465
38555
|
and Documents folders for All Users. (These can be determined only
|
38466
38556
|
on Windows 2000 or later and are not present in the list on other
|
38467
38557
|
Windows versions.) See documentation for CSIDL_COMMON_APPDATA and
|
@@ -38520,12 +38610,13 @@ data specific to particular user.
|
|
38520
38610
|
On UNIX platforms this is determined using the mechanisms described
|
38521
38611
|
in the
|
38522
38612
|
[XDG Base Directory Specification](http://www.freedesktop.org/Standards/basedir-spec).
|
38523
|
-
In this case the directory retrieved will be XDG_CACHE_HOME
|
38613
|
+
In this case the directory retrieved will be `XDG_CACHE_HOME`.
|
38524
38614
|
|
38525
|
-
On Windows
|
38526
|
-
|
38527
|
-
|
38528
|
-
|
38615
|
+
On Windows it follows XDG Base Directory Specification if `XDG_CACHE_HOME` is defined.
|
38616
|
+
If `XDG_CACHE_HOME` is undefined, the directory that serves as a common
|
38617
|
+
repository for temporary Internet files is used instead. A typical path is
|
38618
|
+
`C:\Documents and Settings\username\Local Settings\Temporary Internet Files`.
|
38619
|
+
See the [documentation for `CSIDL_INTERNET_CACHE`](https://msdn.microsoft.com/en-us/library/windows/desktop/bb762494%28v=vs.85%29.aspx#csidl_internet_cache).</doc>
|
38529
38620
|
<return-value transfer-ownership="none">
|
38530
38621
|
<doc xml:space="preserve">a string owned by GLib that must not be modified
|
38531
38622
|
or freed.</doc>
|
@@ -38543,10 +38634,12 @@ in the
|
|
38543
38634
|
[XDG Base Directory Specification](http://www.freedesktop.org/Standards/basedir-spec).
|
38544
38635
|
In this case the directory retrieved will be `XDG_CONFIG_HOME`.
|
38545
38636
|
|
38546
|
-
On Windows
|
38547
|
-
|
38548
|
-
|
38549
|
-
|
38637
|
+
On Windows it follows XDG Base Directory Specification if `XDG_CONFIG_HOME` is defined.
|
38638
|
+
If `XDG_CONFIG_HOME` is undefined, the folder to use for local (as opposed
|
38639
|
+
to roaming) application data is used instead. See the
|
38640
|
+
[documentation for `CSIDL_LOCAL_APPDATA`](https://msdn.microsoft.com/en-us/library/windows/desktop/bb762494%28v=vs.85%29.aspx#csidl_local_appdata).
|
38641
|
+
Note that in this case on Windows it will be the same
|
38642
|
+
as what g_get_user_data_dir() returns.</doc>
|
38550
38643
|
<return-value transfer-ownership="none">
|
38551
38644
|
<doc xml:space="preserve">a string owned by GLib that must not be modified
|
38552
38645
|
or freed.</doc>
|
@@ -38564,10 +38657,12 @@ in the
|
|
38564
38657
|
[XDG Base Directory Specification](http://www.freedesktop.org/Standards/basedir-spec).
|
38565
38658
|
In this case the directory retrieved will be `XDG_DATA_HOME`.
|
38566
38659
|
|
38567
|
-
On Windows
|
38568
|
-
|
38569
|
-
|
38570
|
-
|
38660
|
+
On Windows it follows XDG Base Directory Specification if `XDG_DATA_HOME`
|
38661
|
+
is defined. If `XDG_DATA_HOME` is undefined, the folder to use for local (as
|
38662
|
+
opposed to roaming) application data is used instead. See the
|
38663
|
+
[documentation for `CSIDL_LOCAL_APPDATA`](https://msdn.microsoft.com/en-us/library/windows/desktop/bb762494%28v=vs.85%29.aspx#csidl_local_appdata).
|
38664
|
+
Note that in this case on Windows it will be the same
|
38665
|
+
as what g_get_user_config_dir() returns.</doc>
|
38571
38666
|
<return-value transfer-ownership="none">
|
38572
38667
|
<doc xml:space="preserve">a string owned by GLib that must not be modified
|
38573
38668
|
or freed.</doc>
|
@@ -38590,18 +38685,13 @@ consistent on a machine. On Windows, it is always UTF-8.</doc>
|
|
38590
38685
|
<doc xml:space="preserve">Returns a directory that is unique to the current user on the local
|
38591
38686
|
system.
|
38592
38687
|
|
38593
|
-
|
38688
|
+
This is determined using the mechanisms described
|
38594
38689
|
in the
|
38595
38690
|
[XDG Base Directory Specification](http://www.freedesktop.org/Standards/basedir-spec).
|
38596
38691
|
This is the directory
|
38597
38692
|
specified in the `XDG_RUNTIME_DIR` environment variable.
|
38598
38693
|
In the case that this variable is not set, we return the value of
|
38599
|
-
g_get_user_cache_dir(), after verifying that it exists
|
38600
|
-
|
38601
|
-
On Windows this is the folder to use for local (as opposed to
|
38602
|
-
roaming) application data. See documentation for
|
38603
|
-
CSIDL_LOCAL_APPDATA. Note that on Windows it thus is the same as
|
38604
|
-
what g_get_user_config_dir() returns.</doc>
|
38694
|
+
g_get_user_cache_dir(), after verifying that it exists.</doc>
|
38605
38695
|
<return-value transfer-ownership="none">
|
38606
38696
|
<doc xml:space="preserve">a string owned by GLib that must not be
|
38607
38697
|
modified or freed.</doc>
|
@@ -38656,16 +38746,6 @@ references to other environment variables, they are expanded.</doc>
|
|
38656
38746
|
</parameter>
|
38657
38747
|
</parameters>
|
38658
38748
|
</function>
|
38659
|
-
<function name="getenv_utf8" c:identifier="g_getenv_utf8">
|
38660
|
-
<return-value transfer-ownership="none">
|
38661
|
-
<type name="utf8" c:type="const gchar*"/>
|
38662
|
-
</return-value>
|
38663
|
-
<parameters>
|
38664
|
-
<parameter name="variable" transfer-ownership="none">
|
38665
|
-
<type name="utf8" c:type="const gchar*"/>
|
38666
|
-
</parameter>
|
38667
|
-
</parameters>
|
38668
|
-
</function>
|
38669
38749
|
<function name="hash_table_add"
|
38670
38750
|
c:identifier="g_hash_table_add"
|
38671
38751
|
moved-to="HashTable.add"
|
@@ -40171,7 +40251,10 @@ There can only be one writer function. It is an error to set more than one.</doc
|
|
40171
40251
|
<doc xml:space="preserve">Log a message with structured data. The message will be passed through to
|
40172
40252
|
the log writer set by the application using g_log_set_writer_func(). If the
|
40173
40253
|
message is fatal (i.e. its log level is %G_LOG_LEVEL_ERROR), the program will
|
40174
|
-
be aborted at the end of this function.
|
40254
|
+
be aborted at the end of this function. If the log writer returns
|
40255
|
+
%G_LOG_WRITER_UNHANDLED (failure), no other fallback writers will be tried.
|
40256
|
+
See the documentation for #GLogWriterFunc for information on chaining
|
40257
|
+
writers.
|
40175
40258
|
|
40176
40259
|
The structured data is provided as key–value pairs, where keys are UTF-8
|
40177
40260
|
strings, and values are arbitrary pointers — typically pointing to UTF-8
|
@@ -40236,8 +40319,8 @@ g_log_structured_array (G_LOG_LEVEL_DEBUG, fields, G_N_ELEMENTS (fields));
|
|
40236
40319
|
]|
|
40237
40320
|
|
40238
40321
|
Note also that, even if no other structured fields are specified, there
|
40239
|
-
must always be a
|
40240
|
-
pair has to be the last of the key-value pairs, and
|
40322
|
+
must always be a `MESSAGE` key before the format string. The `MESSAGE`-format
|
40323
|
+
pair has to be the last of the key-value pairs, and `MESSAGE` is the only
|
40241
40324
|
field for which printf()-style formatting is supported.
|
40242
40325
|
|
40243
40326
|
The default writer function for `stdout` and `stderr` will automatically
|
@@ -40430,7 +40513,13 @@ UTF-8.</doc>
|
|
40430
40513
|
version="2.50">
|
40431
40514
|
<doc xml:space="preserve">Check whether the given @output_fd file descriptor is a connection to the
|
40432
40515
|
systemd journal, or something else (like a log file or `stdout` or
|
40433
|
-
`stderr`)
|
40516
|
+
`stderr`).
|
40517
|
+
|
40518
|
+
Invalid file descriptors are accepted and return %FALSE, which allows for
|
40519
|
+
the following construct without needing any additional error handling:
|
40520
|
+
|[<!-- language="C" -->
|
40521
|
+
is_journald = g_log_writer_is_journald (fileno (stderr));
|
40522
|
+
]|</doc>
|
40434
40523
|
<return-value transfer-ownership="none">
|
40435
40524
|
<doc xml:space="preserve">%TRUE if @output_fd points to the journal, %FALSE otherwise</doc>
|
40436
40525
|
<type name="gboolean" c:type="gboolean"/>
|
@@ -41253,16 +41342,6 @@ on Windows it should be in UTF-8.</doc>
|
|
41253
41342
|
</parameter>
|
41254
41343
|
</parameters>
|
41255
41344
|
</function>
|
41256
|
-
<function name="mkstemp_utf8" c:identifier="g_mkstemp_utf8">
|
41257
|
-
<return-value transfer-ownership="none">
|
41258
|
-
<type name="gint" c:type="gint"/>
|
41259
|
-
</return-value>
|
41260
|
-
<parameters>
|
41261
|
-
<parameter name="tmpl" transfer-ownership="none">
|
41262
|
-
<type name="utf8" c:type="gchar*"/>
|
41263
|
-
</parameter>
|
41264
|
-
</parameters>
|
41265
|
-
</function>
|
41266
41345
|
<function name="nullify_pointer" c:identifier="g_nullify_pointer">
|
41267
41346
|
<doc xml:space="preserve">Set the pointer at the specified location to %NULL.</doc>
|
41268
41347
|
<return-value transfer-ownership="none">
|
@@ -41275,6 +41354,12 @@ on Windows it should be in UTF-8.</doc>
|
|
41275
41354
|
</parameter>
|
41276
41355
|
</parameters>
|
41277
41356
|
</function>
|
41357
|
+
<function name="number_parser_error_quark"
|
41358
|
+
c:identifier="g_number_parser_error_quark">
|
41359
|
+
<return-value transfer-ownership="none">
|
41360
|
+
<type name="Quark" c:type="GQuark"/>
|
41361
|
+
</return-value>
|
41362
|
+
</function>
|
41278
41363
|
<function name="on_error_query" c:identifier="g_on_error_query">
|
41279
41364
|
<doc xml:space="preserve">Prompts the user with
|
41280
41365
|
`[E]xit, [H]alt, show [S]tack trace or [P]roceed`.
|
@@ -41796,7 +41881,9 @@ to take advantage of this feature is up to you.</doc>
|
|
41796
41881
|
<parameter name="err"
|
41797
41882
|
direction="inout"
|
41798
41883
|
caller-allocates="0"
|
41799
|
-
transfer-ownership="full"
|
41884
|
+
transfer-ownership="full"
|
41885
|
+
nullable="1"
|
41886
|
+
allow-none="1">
|
41800
41887
|
<doc xml:space="preserve">a return location for a #GError</doc>
|
41801
41888
|
<type name="Error" c:type="GError**"/>
|
41802
41889
|
</parameter>
|
@@ -41962,6 +42049,101 @@ g_prefix_error().</doc>
|
|
41962
42049
|
</parameter>
|
41963
42050
|
</parameters>
|
41964
42051
|
</function>
|
42052
|
+
<function name="ptr_array_find"
|
42053
|
+
c:identifier="g_ptr_array_find"
|
42054
|
+
moved-to="PtrArray.find"
|
42055
|
+
version="2.54"
|
42056
|
+
introspectable="0">
|
42057
|
+
<doc xml:space="preserve">Checks whether @needle exists in @haystack. If the element is found, %TRUE is
|
42058
|
+
returned and the element’s index is returned in @index_ (if non-%NULL).
|
42059
|
+
Otherwise, %FALSE is returned and @index_ is undefined. If @needle exists
|
42060
|
+
multiple times in @haystack, the index of the first instance is returned.
|
42061
|
+
|
42062
|
+
This does pointer comparisons only. If you want to use more complex equality
|
42063
|
+
checks, such as string comparisons, use g_ptr_array_find_with_equal_func().</doc>
|
42064
|
+
<return-value transfer-ownership="none">
|
42065
|
+
<doc xml:space="preserve">%TRUE if @needle is one of the elements of @haystack</doc>
|
42066
|
+
<type name="gboolean" c:type="gboolean"/>
|
42067
|
+
</return-value>
|
42068
|
+
<parameters>
|
42069
|
+
<parameter name="haystack" transfer-ownership="none">
|
42070
|
+
<doc xml:space="preserve">pointer array to be searched</doc>
|
42071
|
+
<array name="GLib.PtrArray" c:type="GPtrArray*">
|
42072
|
+
<type name="gpointer" c:type="gpointer"/>
|
42073
|
+
</array>
|
42074
|
+
</parameter>
|
42075
|
+
<parameter name="needle"
|
42076
|
+
transfer-ownership="none"
|
42077
|
+
nullable="1"
|
42078
|
+
allow-none="1">
|
42079
|
+
<doc xml:space="preserve">pointer to look for</doc>
|
42080
|
+
<type name="gpointer" c:type="gconstpointer"/>
|
42081
|
+
</parameter>
|
42082
|
+
<parameter name="index_"
|
42083
|
+
direction="out"
|
42084
|
+
caller-allocates="1"
|
42085
|
+
transfer-ownership="none"
|
42086
|
+
optional="1"
|
42087
|
+
allow-none="1">
|
42088
|
+
<doc xml:space="preserve">return location for the index of
|
42089
|
+
the element, if found</doc>
|
42090
|
+
<type name="guint" c:type="guint*"/>
|
42091
|
+
</parameter>
|
42092
|
+
</parameters>
|
42093
|
+
</function>
|
42094
|
+
<function name="ptr_array_find_with_equal_func"
|
42095
|
+
c:identifier="g_ptr_array_find_with_equal_func"
|
42096
|
+
moved-to="PtrArray.find_with_equal_func"
|
42097
|
+
version="2.54"
|
42098
|
+
introspectable="0">
|
42099
|
+
<doc xml:space="preserve">Checks whether @needle exists in @haystack, using the given @equal_func.
|
42100
|
+
If the element is found, %TRUE is returned and the element’s index is
|
42101
|
+
returned in @index_ (if non-%NULL). Otherwise, %FALSE is returned and @index_
|
42102
|
+
is undefined. If @needle exists multiple times in @haystack, the index of
|
42103
|
+
the first instance is returned.
|
42104
|
+
|
42105
|
+
@equal_func is called with the element from the array as its first parameter,
|
42106
|
+
and @needle as its second parameter. If @equal_func is %NULL, pointer
|
42107
|
+
equality is used.</doc>
|
42108
|
+
<return-value transfer-ownership="none">
|
42109
|
+
<doc xml:space="preserve">%TRUE if @needle is one of the elements of @haystack</doc>
|
42110
|
+
<type name="gboolean" c:type="gboolean"/>
|
42111
|
+
</return-value>
|
42112
|
+
<parameters>
|
42113
|
+
<parameter name="haystack" transfer-ownership="none">
|
42114
|
+
<doc xml:space="preserve">pointer array to be searched</doc>
|
42115
|
+
<array name="GLib.PtrArray" c:type="GPtrArray*">
|
42116
|
+
<type name="gpointer" c:type="gpointer"/>
|
42117
|
+
</array>
|
42118
|
+
</parameter>
|
42119
|
+
<parameter name="needle"
|
42120
|
+
transfer-ownership="none"
|
42121
|
+
nullable="1"
|
42122
|
+
allow-none="1">
|
42123
|
+
<doc xml:space="preserve">pointer to look for</doc>
|
42124
|
+
<type name="gpointer" c:type="gconstpointer"/>
|
42125
|
+
</parameter>
|
42126
|
+
<parameter name="equal_func"
|
42127
|
+
transfer-ownership="none"
|
42128
|
+
nullable="1"
|
42129
|
+
allow-none="1">
|
42130
|
+
<doc xml:space="preserve">the function to call for each element, which should
|
42131
|
+
return %TRUE when the desired element is found; or %NULL to use pointer
|
42132
|
+
equality</doc>
|
42133
|
+
<type name="EqualFunc" c:type="GEqualFunc"/>
|
42134
|
+
</parameter>
|
42135
|
+
<parameter name="index_"
|
42136
|
+
direction="out"
|
42137
|
+
caller-allocates="1"
|
42138
|
+
transfer-ownership="none"
|
42139
|
+
optional="1"
|
42140
|
+
allow-none="1">
|
42141
|
+
<doc xml:space="preserve">return location for the index of
|
42142
|
+
the element, if found</doc>
|
42143
|
+
<type name="guint" c:type="guint*"/>
|
42144
|
+
</parameter>
|
42145
|
+
</parameters>
|
42146
|
+
</function>
|
41965
42147
|
<function name="qsort_with_data"
|
41966
42148
|
c:identifier="g_qsort_with_data"
|
41967
42149
|
introspectable="0">
|
@@ -42506,6 +42688,29 @@ on your system.</doc>
|
|
42506
42688
|
</parameter>
|
42507
42689
|
</parameters>
|
42508
42690
|
</function>
|
42691
|
+
<function name="sequence_insert_before"
|
42692
|
+
c:identifier="g_sequence_insert_before"
|
42693
|
+
moved-to="Sequence.insert_before"
|
42694
|
+
version="2.14">
|
42695
|
+
<doc xml:space="preserve">Inserts a new item just before the item pointed to by @iter.</doc>
|
42696
|
+
<return-value transfer-ownership="none">
|
42697
|
+
<doc xml:space="preserve">an iterator pointing to the new item</doc>
|
42698
|
+
<type name="SequenceIter" c:type="GSequenceIter*"/>
|
42699
|
+
</return-value>
|
42700
|
+
<parameters>
|
42701
|
+
<parameter name="iter" transfer-ownership="none">
|
42702
|
+
<doc xml:space="preserve">a #GSequenceIter</doc>
|
42703
|
+
<type name="SequenceIter" c:type="GSequenceIter*"/>
|
42704
|
+
</parameter>
|
42705
|
+
<parameter name="data"
|
42706
|
+
transfer-ownership="none"
|
42707
|
+
nullable="1"
|
42708
|
+
allow-none="1">
|
42709
|
+
<doc xml:space="preserve">the data for the new item</doc>
|
42710
|
+
<type name="gpointer" c:type="gpointer"/>
|
42711
|
+
</parameter>
|
42712
|
+
</parameters>
|
42713
|
+
</function>
|
42509
42714
|
<function name="sequence_move"
|
42510
42715
|
c:identifier="g_sequence_move"
|
42511
42716
|
moved-to="Sequence.move"
|
@@ -42559,6 +42764,32 @@ the (@begin, @end) range, the range does not move.</doc>
|
|
42559
42764
|
</parameter>
|
42560
42765
|
</parameters>
|
42561
42766
|
</function>
|
42767
|
+
<function name="sequence_range_get_midpoint"
|
42768
|
+
c:identifier="g_sequence_range_get_midpoint"
|
42769
|
+
moved-to="Sequence.range_get_midpoint"
|
42770
|
+
version="2.14">
|
42771
|
+
<doc xml:space="preserve">Finds an iterator somewhere in the range (@begin, @end). This
|
42772
|
+
iterator will be close to the middle of the range, but is not
|
42773
|
+
guaranteed to be exactly in the middle.
|
42774
|
+
|
42775
|
+
The @begin and @end iterators must both point to the same sequence
|
42776
|
+
and @begin must come before or be equal to @end in the sequence.</doc>
|
42777
|
+
<return-value transfer-ownership="none">
|
42778
|
+
<doc xml:space="preserve">a #GSequenceIter pointing somewhere in the
|
42779
|
+
(@begin, @end) range</doc>
|
42780
|
+
<type name="SequenceIter" c:type="GSequenceIter*"/>
|
42781
|
+
</return-value>
|
42782
|
+
<parameters>
|
42783
|
+
<parameter name="begin" transfer-ownership="none">
|
42784
|
+
<doc xml:space="preserve">a #GSequenceIter</doc>
|
42785
|
+
<type name="SequenceIter" c:type="GSequenceIter*"/>
|
42786
|
+
</parameter>
|
42787
|
+
<parameter name="end" transfer-ownership="none">
|
42788
|
+
<doc xml:space="preserve">a #GSequenceIter</doc>
|
42789
|
+
<type name="SequenceIter" c:type="GSequenceIter*"/>
|
42790
|
+
</parameter>
|
42791
|
+
</parameters>
|
42792
|
+
</function>
|
42562
42793
|
<function name="sequence_remove"
|
42563
42794
|
c:identifier="g_sequence_remove"
|
42564
42795
|
moved-to="Sequence.remove"
|
@@ -42741,6 +42972,12 @@ that could include printf() escape sequences.</doc>
|
|
42741
42972
|
<doc xml:space="preserve">Sets the name of the program. This name should not be localized,
|
42742
42973
|
in contrast to g_set_application_name().
|
42743
42974
|
|
42975
|
+
If you are using #GApplication the program name is set in
|
42976
|
+
g_application_run(). In case of GDK or GTK+ it is set in
|
42977
|
+
gdk_init(), which is called by gtk_init() and the
|
42978
|
+
#GtkApplication::startup handler. The program name is found by
|
42979
|
+
taking the last component of @argv[0].
|
42980
|
+
|
42744
42981
|
Note that for thread-safety reasons this function can only be called once.</doc>
|
42745
42982
|
<return-value transfer-ownership="none">
|
42746
42983
|
<type name="none" c:type="void"/>
|
@@ -42833,22 +43070,6 @@ array directly to execvpe(), g_spawn_async(), or the like.</doc>
|
|
42833
43070
|
</parameter>
|
42834
43071
|
</parameters>
|
42835
43072
|
</function>
|
42836
|
-
<function name="setenv_utf8" c:identifier="g_setenv_utf8">
|
42837
|
-
<return-value transfer-ownership="none">
|
42838
|
-
<type name="gboolean" c:type="gboolean"/>
|
42839
|
-
</return-value>
|
42840
|
-
<parameters>
|
42841
|
-
<parameter name="variable" transfer-ownership="none">
|
42842
|
-
<type name="utf8" c:type="const gchar*"/>
|
42843
|
-
</parameter>
|
42844
|
-
<parameter name="value" transfer-ownership="none">
|
42845
|
-
<type name="utf8" c:type="const gchar*"/>
|
42846
|
-
</parameter>
|
42847
|
-
<parameter name="overwrite" transfer-ownership="none">
|
42848
|
-
<type name="gboolean" c:type="gboolean"/>
|
42849
|
-
</parameter>
|
42850
|
-
</parameters>
|
42851
|
-
</function>
|
42852
43073
|
<function name="shell_error_quark" c:identifier="g_shell_error_quark">
|
42853
43074
|
<return-value transfer-ownership="none">
|
42854
43075
|
<type name="Quark" c:type="GQuark"/>
|
@@ -43298,10 +43519,10 @@ simply calls the g_spawn_async_with_pipes() without any pipes.
|
|
43298
43519
|
You should call g_spawn_close_pid() on the returned child process
|
43299
43520
|
reference when you don't need it any more.
|
43300
43521
|
|
43301
|
-
If you are writing a GTK+ application, and the program you are
|
43302
|
-
|
43303
|
-
|
43304
|
-
|
43522
|
+
If you are writing a GTK+ application, and the program you are spawning is a
|
43523
|
+
graphical application too, then to ensure that the spawned program opens its
|
43524
|
+
windows on the right screen, you may want to use #GdkAppLaunchContext,
|
43525
|
+
#GAppLaunchcontext, or set the %DISPLAY environment variable.
|
43305
43526
|
|
43306
43527
|
Note that the returned @child_pid on Windows is a handle to the child
|
43307
43528
|
process and not its identifier. Process handles and process identifiers
|
@@ -43364,40 +43585,6 @@ are different concepts on Windows.</doc>
|
|
43364
43585
|
</parameter>
|
43365
43586
|
</parameters>
|
43366
43587
|
</function>
|
43367
|
-
<function name="spawn_async_utf8"
|
43368
|
-
c:identifier="g_spawn_async_utf8"
|
43369
|
-
introspectable="0"
|
43370
|
-
throws="1">
|
43371
|
-
<return-value transfer-ownership="none">
|
43372
|
-
<type name="gboolean" c:type="gboolean"/>
|
43373
|
-
</return-value>
|
43374
|
-
<parameters>
|
43375
|
-
<parameter name="working_directory" transfer-ownership="none">
|
43376
|
-
<type name="utf8" c:type="const gchar*"/>
|
43377
|
-
</parameter>
|
43378
|
-
<parameter name="argv" transfer-ownership="none">
|
43379
|
-
<type name="utf8" c:type="gchar**"/>
|
43380
|
-
</parameter>
|
43381
|
-
<parameter name="envp" transfer-ownership="none">
|
43382
|
-
<type name="utf8" c:type="gchar**"/>
|
43383
|
-
</parameter>
|
43384
|
-
<parameter name="flags" transfer-ownership="none">
|
43385
|
-
<type name="SpawnFlags" c:type="GSpawnFlags"/>
|
43386
|
-
</parameter>
|
43387
|
-
<parameter name="child_setup" transfer-ownership="none" closure="5">
|
43388
|
-
<type name="SpawnChildSetupFunc" c:type="GSpawnChildSetupFunc"/>
|
43389
|
-
</parameter>
|
43390
|
-
<parameter name="user_data"
|
43391
|
-
transfer-ownership="none"
|
43392
|
-
nullable="1"
|
43393
|
-
allow-none="1">
|
43394
|
-
<type name="gpointer" c:type="gpointer"/>
|
43395
|
-
</parameter>
|
43396
|
-
<parameter name="child_pid" transfer-ownership="none">
|
43397
|
-
<type name="Pid" c:type="GPid*"/>
|
43398
|
-
</parameter>
|
43399
|
-
</parameters>
|
43400
|
-
</function>
|
43401
43588
|
<function name="spawn_async_with_pipes"
|
43402
43589
|
c:identifier="g_spawn_async_with_pipes"
|
43403
43590
|
throws="1">
|
@@ -43459,10 +43646,11 @@ If @envp is %NULL, the child inherits its parent's environment.
|
|
43459
43646
|
|
43460
43647
|
@flags should be the bitwise OR of any flags you want to affect the
|
43461
43648
|
function's behaviour. The %G_SPAWN_DO_NOT_REAP_CHILD means that the
|
43462
|
-
child will not automatically be reaped; you must use a child watch
|
43463
|
-
be notified about the death of the child process
|
43464
|
-
|
43465
|
-
|
43649
|
+
child will not automatically be reaped; you must use a child watch
|
43650
|
+
(g_child_watch_add()) to be notified about the death of the child process,
|
43651
|
+
otherwise it will stay around as a zombie process until this process exits.
|
43652
|
+
Eventually you must call g_spawn_close_pid() on the @child_pid, in order to
|
43653
|
+
free resources which may be associated with the child process. (On Unix,
|
43466
43654
|
using a child watch is equivalent to calling waitpid() or handling
|
43467
43655
|
the %SIGCHLD signal manually. On Windows, calling g_spawn_close_pid()
|
43468
43656
|
is equivalent to calling CloseHandle() on the process handle returned
|
@@ -43546,10 +43734,10 @@ and @standard_error will not be filled with valid values.
|
|
43546
43734
|
If @child_pid is not %NULL and an error does not occur then the returned
|
43547
43735
|
process reference must be closed using g_spawn_close_pid().
|
43548
43736
|
|
43549
|
-
If you are writing a GTK+ application, and the program you
|
43550
|
-
|
43551
|
-
|
43552
|
-
|
43737
|
+
If you are writing a GTK+ application, and the program you are spawning is a
|
43738
|
+
graphical application too, then to ensure that the spawned program opens its
|
43739
|
+
windows on the right screen, you may want to use #GdkAppLaunchContext,
|
43740
|
+
#GAppLaunchcontext, or set the %DISPLAY environment variable.</doc>
|
43553
43741
|
<return-value transfer-ownership="none">
|
43554
43742
|
<doc xml:space="preserve">%TRUE on success, %FALSE if an error was set</doc>
|
43555
43743
|
<type name="gboolean" c:type="gboolean"/>
|
@@ -43635,49 +43823,6 @@ the spawned program opens its windows on the right screen.</doc>
|
|
43635
43823
|
</parameter>
|
43636
43824
|
</parameters>
|
43637
43825
|
</function>
|
43638
|
-
<function name="spawn_async_with_pipes_utf8"
|
43639
|
-
c:identifier="g_spawn_async_with_pipes_utf8"
|
43640
|
-
introspectable="0"
|
43641
|
-
throws="1">
|
43642
|
-
<return-value transfer-ownership="none">
|
43643
|
-
<type name="gboolean" c:type="gboolean"/>
|
43644
|
-
</return-value>
|
43645
|
-
<parameters>
|
43646
|
-
<parameter name="working_directory" transfer-ownership="none">
|
43647
|
-
<type name="utf8" c:type="const gchar*"/>
|
43648
|
-
</parameter>
|
43649
|
-
<parameter name="argv" transfer-ownership="none">
|
43650
|
-
<type name="utf8" c:type="gchar**"/>
|
43651
|
-
</parameter>
|
43652
|
-
<parameter name="envp" transfer-ownership="none">
|
43653
|
-
<type name="utf8" c:type="gchar**"/>
|
43654
|
-
</parameter>
|
43655
|
-
<parameter name="flags" transfer-ownership="none">
|
43656
|
-
<type name="SpawnFlags" c:type="GSpawnFlags"/>
|
43657
|
-
</parameter>
|
43658
|
-
<parameter name="child_setup" transfer-ownership="none" closure="5">
|
43659
|
-
<type name="SpawnChildSetupFunc" c:type="GSpawnChildSetupFunc"/>
|
43660
|
-
</parameter>
|
43661
|
-
<parameter name="user_data"
|
43662
|
-
transfer-ownership="none"
|
43663
|
-
nullable="1"
|
43664
|
-
allow-none="1">
|
43665
|
-
<type name="gpointer" c:type="gpointer"/>
|
43666
|
-
</parameter>
|
43667
|
-
<parameter name="child_pid" transfer-ownership="none">
|
43668
|
-
<type name="Pid" c:type="GPid*"/>
|
43669
|
-
</parameter>
|
43670
|
-
<parameter name="standard_input" transfer-ownership="none">
|
43671
|
-
<type name="gint" c:type="gint*"/>
|
43672
|
-
</parameter>
|
43673
|
-
<parameter name="standard_output" transfer-ownership="none">
|
43674
|
-
<type name="gint" c:type="gint*"/>
|
43675
|
-
</parameter>
|
43676
|
-
<parameter name="standard_error" transfer-ownership="none">
|
43677
|
-
<type name="gint" c:type="gint*"/>
|
43678
|
-
</parameter>
|
43679
|
-
</parameters>
|
43680
|
-
</function>
|
43681
43826
|
<function name="spawn_check_exit_status"
|
43682
43827
|
c:identifier="g_spawn_check_exit_status"
|
43683
43828
|
version="2.34"
|
@@ -43768,18 +43913,6 @@ The same concerns on Windows apply as for g_spawn_command_line_sync().</doc>
|
|
43768
43913
|
</parameter>
|
43769
43914
|
</parameters>
|
43770
43915
|
</function>
|
43771
|
-
<function name="spawn_command_line_async_utf8"
|
43772
|
-
c:identifier="g_spawn_command_line_async_utf8"
|
43773
|
-
throws="1">
|
43774
|
-
<return-value transfer-ownership="none">
|
43775
|
-
<type name="gboolean" c:type="gboolean"/>
|
43776
|
-
</return-value>
|
43777
|
-
<parameters>
|
43778
|
-
<parameter name="command_line" transfer-ownership="none">
|
43779
|
-
<type name="utf8" c:type="const gchar*"/>
|
43780
|
-
</parameter>
|
43781
|
-
</parameters>
|
43782
|
-
</function>
|
43783
43916
|
<function name="spawn_command_line_sync"
|
43784
43917
|
c:identifier="g_spawn_command_line_sync"
|
43785
43918
|
throws="1">
|
@@ -43847,27 +43980,6 @@ separator. You need to enclose such paths with single quotes, like
|
|
43847
43980
|
</parameter>
|
43848
43981
|
</parameters>
|
43849
43982
|
</function>
|
43850
|
-
<function name="spawn_command_line_sync_utf8"
|
43851
|
-
c:identifier="g_spawn_command_line_sync_utf8"
|
43852
|
-
throws="1">
|
43853
|
-
<return-value transfer-ownership="none">
|
43854
|
-
<type name="gboolean" c:type="gboolean"/>
|
43855
|
-
</return-value>
|
43856
|
-
<parameters>
|
43857
|
-
<parameter name="command_line" transfer-ownership="none">
|
43858
|
-
<type name="utf8" c:type="const gchar*"/>
|
43859
|
-
</parameter>
|
43860
|
-
<parameter name="standard_output" transfer-ownership="none">
|
43861
|
-
<type name="utf8" c:type="gchar**"/>
|
43862
|
-
</parameter>
|
43863
|
-
<parameter name="standard_error" transfer-ownership="none">
|
43864
|
-
<type name="utf8" c:type="gchar**"/>
|
43865
|
-
</parameter>
|
43866
|
-
<parameter name="exit_status" transfer-ownership="none">
|
43867
|
-
<type name="gint" c:type="gint*"/>
|
43868
|
-
</parameter>
|
43869
|
-
</parameters>
|
43870
|
-
</function>
|
43871
43983
|
<function name="spawn_error_quark" c:identifier="g_spawn_error_quark">
|
43872
43984
|
<return-value transfer-ownership="none">
|
43873
43985
|
<type name="Quark" c:type="GQuark"/>
|
@@ -43978,46 +44090,6 @@ how these functions work on Windows.</doc>
|
|
43978
44090
|
</parameter>
|
43979
44091
|
</parameters>
|
43980
44092
|
</function>
|
43981
|
-
<function name="spawn_sync_utf8"
|
43982
|
-
c:identifier="g_spawn_sync_utf8"
|
43983
|
-
introspectable="0"
|
43984
|
-
throws="1">
|
43985
|
-
<return-value transfer-ownership="none">
|
43986
|
-
<type name="gboolean" c:type="gboolean"/>
|
43987
|
-
</return-value>
|
43988
|
-
<parameters>
|
43989
|
-
<parameter name="working_directory" transfer-ownership="none">
|
43990
|
-
<type name="utf8" c:type="const gchar*"/>
|
43991
|
-
</parameter>
|
43992
|
-
<parameter name="argv" transfer-ownership="none">
|
43993
|
-
<type name="utf8" c:type="gchar**"/>
|
43994
|
-
</parameter>
|
43995
|
-
<parameter name="envp" transfer-ownership="none">
|
43996
|
-
<type name="utf8" c:type="gchar**"/>
|
43997
|
-
</parameter>
|
43998
|
-
<parameter name="flags" transfer-ownership="none">
|
43999
|
-
<type name="SpawnFlags" c:type="GSpawnFlags"/>
|
44000
|
-
</parameter>
|
44001
|
-
<parameter name="child_setup" transfer-ownership="none" closure="5">
|
44002
|
-
<type name="SpawnChildSetupFunc" c:type="GSpawnChildSetupFunc"/>
|
44003
|
-
</parameter>
|
44004
|
-
<parameter name="user_data"
|
44005
|
-
transfer-ownership="none"
|
44006
|
-
nullable="1"
|
44007
|
-
allow-none="1">
|
44008
|
-
<type name="gpointer" c:type="gpointer"/>
|
44009
|
-
</parameter>
|
44010
|
-
<parameter name="standard_output" transfer-ownership="none">
|
44011
|
-
<type name="utf8" c:type="gchar**"/>
|
44012
|
-
</parameter>
|
44013
|
-
<parameter name="standard_error" transfer-ownership="none">
|
44014
|
-
<type name="utf8" c:type="gchar**"/>
|
44015
|
-
</parameter>
|
44016
|
-
<parameter name="exit_status" transfer-ownership="none">
|
44017
|
-
<type name="gint" c:type="gint*"/>
|
44018
|
-
</parameter>
|
44019
|
-
</parameters>
|
44020
|
-
</function>
|
44021
44093
|
<function name="sprintf"
|
44022
44094
|
c:identifier="g_sprintf"
|
44023
44095
|
version="2.2"
|
@@ -44649,7 +44721,17 @@ the lifetime of the process.
|
|
44649
44721
|
|
44650
44722
|
Note that the string may be translated according to the current locale.
|
44651
44723
|
|
44652
|
-
The value of %errno will not be changed by this function
|
44724
|
+
The value of %errno will not be changed by this function. However, it may
|
44725
|
+
be changed by intermediate function calls, so you should save its value
|
44726
|
+
as soon as the call returns:
|
44727
|
+
|[
|
44728
|
+
int saved_errno;
|
44729
|
+
|
44730
|
+
ret = read (blah);
|
44731
|
+
saved_errno = errno;
|
44732
|
+
|
44733
|
+
g_strerror (saved_errno);
|
44734
|
+
]|</doc>
|
44653
44735
|
<return-value transfer-ownership="none">
|
44654
44736
|
<doc xml:space="preserve">a UTF-8 string describing the error code. If the error code
|
44655
44737
|
is unknown, it returns a string like "unknown error (<code>)".</doc>
|
@@ -47888,16 +47970,6 @@ array directly to execvpe(), g_spawn_async(), or the like.</doc>
|
|
47888
47970
|
</parameter>
|
47889
47971
|
</parameters>
|
47890
47972
|
</function>
|
47891
|
-
<function name="unsetenv_utf8" c:identifier="g_unsetenv_utf8">
|
47892
|
-
<return-value transfer-ownership="none">
|
47893
|
-
<type name="none" c:type="void"/>
|
47894
|
-
</return-value>
|
47895
|
-
<parameters>
|
47896
|
-
<parameter name="variable" transfer-ownership="none">
|
47897
|
-
<type name="utf8" c:type="const gchar*"/>
|
47898
|
-
</parameter>
|
47899
|
-
</parameters>
|
47900
|
-
</function>
|
47901
47973
|
<function name="uri_escape_string"
|
47902
47974
|
c:identifier="g_uri_escape_string"
|
47903
47975
|
version="2.16">
|
@@ -48273,9 +48345,15 @@ Note that this function depends on the [current locale][setlocale].</doc>
|
|
48273
48345
|
|
48274
48346
|
@p does not have to be at the beginning of a UTF-8 character. No check
|
48275
48347
|
is made to see if the character found is actually valid other than
|
48276
|
-
it starts with an appropriate byte
|
48277
|
-
|
48278
|
-
|
48348
|
+
it starts with an appropriate byte.
|
48349
|
+
|
48350
|
+
If @end is %NULL, the return value will never be %NULL: if the end of the
|
48351
|
+
string is reached, a pointer to the terminating nul byte is returned. If
|
48352
|
+
@end is non-%NULL, the return value will be %NULL if the end of the string
|
48353
|
+
is reached.</doc>
|
48354
|
+
<return-value transfer-ownership="full" nullable="1">
|
48355
|
+
<doc xml:space="preserve">a pointer to the found character or %NULL if @end is
|
48356
|
+
set and is reached</doc>
|
48279
48357
|
<type name="utf8" c:type="gchar*"/>
|
48280
48358
|
</return-value>
|
48281
48359
|
<parameters>
|
@@ -48339,7 +48417,11 @@ instead.</doc>
|
|
48339
48417
|
<doc xml:space="preserve">Convert a sequence of bytes encoded as UTF-8 to a Unicode character.
|
48340
48418
|
This function checks for incomplete characters, for invalid characters
|
48341
48419
|
such as characters that are out of the range of Unicode, and for
|
48342
|
-
overlong encodings of valid characters
|
48420
|
+
overlong encodings of valid characters.
|
48421
|
+
|
48422
|
+
Note that g_utf8_get_char_validated() returns (gunichar)-2 if
|
48423
|
+
@max_len is positive and any of the bytes in the first UTF-8 character
|
48424
|
+
sequence are nul.</doc>
|
48343
48425
|
<return-value transfer-ownership="none">
|
48344
48426
|
<doc xml:space="preserve">the resulting character. If @p points to a partial
|
48345
48427
|
sequence at the end of a string that could begin a valid
|
@@ -49466,6 +49548,77 @@ be freed with g_strfreev() when no longer needed.</doc>
|
|
49466
49548
|
</array>
|
49467
49549
|
</return-value>
|
49468
49550
|
</function>
|
49551
|
+
<function name="win32_get_package_installation_directory"
|
49552
|
+
c:identifier="g_win32_get_package_installation_directory"
|
49553
|
+
deprecated="1"
|
49554
|
+
deprecated-version="2.18">
|
49555
|
+
<doc xml:space="preserve">Try to determine the installation directory for a software package.
|
49556
|
+
|
49557
|
+
This function is deprecated. Use
|
49558
|
+
g_win32_get_package_installation_directory_of_module() instead.
|
49559
|
+
|
49560
|
+
The use of @package is deprecated. You should always pass %NULL. A
|
49561
|
+
warning is printed if non-NULL is passed as @package.
|
49562
|
+
|
49563
|
+
The original intended use of @package was for a short identifier of
|
49564
|
+
the package, typically the same identifier as used for
|
49565
|
+
`GETTEXT_PACKAGE` in software configured using GNU
|
49566
|
+
autotools. The function first looks in the Windows Registry for the
|
49567
|
+
value `#InstallationDirectory` in the key
|
49568
|
+
`#HKLM\Software\@package`, and if that value
|
49569
|
+
exists and is a string, returns that.
|
49570
|
+
|
49571
|
+
It is strongly recommended that packagers of GLib-using libraries
|
49572
|
+
for Windows do not store installation paths in the Registry to be
|
49573
|
+
used by this function as that interfers with having several
|
49574
|
+
parallel installations of the library. Enabling multiple
|
49575
|
+
installations of different versions of some GLib-using library, or
|
49576
|
+
GLib itself, is desirable for various reasons.
|
49577
|
+
|
49578
|
+
For this reason it is recommeded to always pass %NULL as
|
49579
|
+
@package to this function, to avoid the temptation to use the
|
49580
|
+
Registry. In version 2.20 of GLib the @package parameter
|
49581
|
+
will be ignored and this function won't look in the Registry at all.
|
49582
|
+
|
49583
|
+
If @package is %NULL, or the above value isn't found in the
|
49584
|
+
Registry, but @dll_name is non-%NULL, it should name a DLL loaded
|
49585
|
+
into the current process. Typically that would be the name of the
|
49586
|
+
DLL calling this function, looking for its installation
|
49587
|
+
directory. The function then asks Windows what directory that DLL
|
49588
|
+
was loaded from. If that directory's last component is "bin" or
|
49589
|
+
"lib", the parent directory is returned, otherwise the directory
|
49590
|
+
itself. If that DLL isn't loaded, the function proceeds as if
|
49591
|
+
@dll_name was %NULL.
|
49592
|
+
|
49593
|
+
If both @package and @dll_name are %NULL, the directory from where
|
49594
|
+
the main executable of the process was loaded is used instead in
|
49595
|
+
the same way as above.</doc>
|
49596
|
+
<doc-deprecated xml:space="preserve">Pass the HMODULE of a DLL or EXE to
|
49597
|
+
g_win32_get_package_installation_directory_of_module() instead.</doc-deprecated>
|
49598
|
+
<return-value transfer-ownership="full">
|
49599
|
+
<doc xml:space="preserve">a string containing the installation directory for
|
49600
|
+
@package. The string is in the GLib file name encoding,
|
49601
|
+
i.e. UTF-8. The return value should be freed with g_free() when not
|
49602
|
+
needed any longer. If the function fails %NULL is returned.</doc>
|
49603
|
+
<type name="utf8" c:type="gchar*"/>
|
49604
|
+
</return-value>
|
49605
|
+
<parameters>
|
49606
|
+
<parameter name="package"
|
49607
|
+
transfer-ownership="none"
|
49608
|
+
nullable="1"
|
49609
|
+
allow-none="1">
|
49610
|
+
<doc xml:space="preserve">You should pass %NULL for this.</doc>
|
49611
|
+
<type name="utf8" c:type="const gchar*"/>
|
49612
|
+
</parameter>
|
49613
|
+
<parameter name="dll_name"
|
49614
|
+
transfer-ownership="none"
|
49615
|
+
nullable="1"
|
49616
|
+
allow-none="1">
|
49617
|
+
<doc xml:space="preserve">The name of a DLL that a package provides in UTF-8, or %NULL.</doc>
|
49618
|
+
<type name="utf8" c:type="const gchar*"/>
|
49619
|
+
</parameter>
|
49620
|
+
</parameters>
|
49621
|
+
</function>
|
49469
49622
|
<function name="win32_get_package_installation_directory_of_module"
|
49470
49623
|
c:identifier="g_win32_get_package_installation_directory_of_module"
|
49471
49624
|
version="2.16">
|
@@ -49510,33 +49663,49 @@ with g_free() when not needed any longer. If the function fails
|
|
49510
49663
|
</parameter>
|
49511
49664
|
</parameters>
|
49512
49665
|
</function>
|
49513
|
-
<function name="
|
49514
|
-
c:identifier="
|
49515
|
-
|
49516
|
-
|
49517
|
-
|
49518
|
-
|
49519
|
-
|
49520
|
-
|
49521
|
-
|
49522
|
-
|
49523
|
-
|
49524
|
-
|
49525
|
-
|
49526
|
-
|
49527
|
-
|
49528
|
-
|
49666
|
+
<function name="win32_get_package_installation_subdirectory"
|
49667
|
+
c:identifier="g_win32_get_package_installation_subdirectory"
|
49668
|
+
deprecated="1"
|
49669
|
+
deprecated-version="2.18">
|
49670
|
+
<doc xml:space="preserve">This function is deprecated. Use
|
49671
|
+
g_win32_get_package_installation_directory_of_module() and
|
49672
|
+
g_build_filename() instead.
|
49673
|
+
|
49674
|
+
Returns a newly-allocated string containing the path of the
|
49675
|
+
subdirectory @subdir in the return value from calling
|
49676
|
+
g_win32_get_package_installation_directory() with the @package and
|
49677
|
+
@dll_name parameters. See the documentation for
|
49678
|
+
g_win32_get_package_installation_directory() for more details. In
|
49679
|
+
particular, note that it is deprecated to pass anything except NULL
|
49680
|
+
as @package.</doc>
|
49681
|
+
<doc-deprecated xml:space="preserve">Pass the HMODULE of a DLL or EXE to
|
49682
|
+
g_win32_get_package_installation_directory_of_module() instead, and
|
49683
|
+
then construct a subdirectory pathname with g_build_filename().</doc-deprecated>
|
49529
49684
|
<return-value transfer-ownership="full">
|
49685
|
+
<doc xml:space="preserve">a string containing the complete path to @subdir inside
|
49686
|
+
the installation directory of @package. The returned string is in
|
49687
|
+
the GLib file name encoding, i.e. UTF-8. The return value should be
|
49688
|
+
freed with g_free() when no longer needed. If something goes wrong,
|
49689
|
+
%NULL is returned.</doc>
|
49530
49690
|
<type name="utf8" c:type="gchar*"/>
|
49531
49691
|
</return-value>
|
49532
49692
|
<parameters>
|
49533
|
-
<parameter name="package"
|
49693
|
+
<parameter name="package"
|
49694
|
+
transfer-ownership="none"
|
49695
|
+
nullable="1"
|
49696
|
+
allow-none="1">
|
49697
|
+
<doc xml:space="preserve">You should pass %NULL for this.</doc>
|
49534
49698
|
<type name="utf8" c:type="const gchar*"/>
|
49535
49699
|
</parameter>
|
49536
|
-
<parameter name="dll_name"
|
49700
|
+
<parameter name="dll_name"
|
49701
|
+
transfer-ownership="none"
|
49702
|
+
nullable="1"
|
49703
|
+
allow-none="1">
|
49704
|
+
<doc xml:space="preserve">The name of a DLL that a package provides, in UTF-8, or %NULL.</doc>
|
49537
49705
|
<type name="utf8" c:type="const gchar*"/>
|
49538
49706
|
</parameter>
|
49539
49707
|
<parameter name="subdir" transfer-ownership="none">
|
49708
|
+
<doc xml:space="preserve">A subdirectory of the package installation directory, also in UTF-8</doc>
|
49540
49709
|
<type name="utf8" c:type="const gchar*"/>
|
49541
49710
|
</parameter>
|
49542
49711
|
</parameters>
|