glib2 3.0.8-x86-mingw32 → 3.0.9-x86-mingw32
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/Rakefile +2 -2
- data/ext/glib2/extconf.rb +0 -1
- data/ext/glib2/rbglib-variant-type.c +5 -1
- data/ext/glib2/rbglib-variant.c +21 -7
- data/ext/glib2/rbglib.c +0 -38
- data/ext/glib2/rbglib.h +2 -2
- data/ext/glib2/rbglib_convert.c +3 -9
- data/ext/glib2/rbglib_matchinfo.c +4 -0
- data/ext/glib2/rbglib_regex.c +12 -1
- data/ext/glib2/rbgobj_object.c +112 -10
- data/ext/glib2/rbgobj_signal.c +12 -1
- data/ext/glib2/rbgobj_type.c +7 -1
- data/ext/glib2/rbgobject.c +0 -6
- data/ext/glib2/rbgprivate.h +0 -4
- data/ext/glib2/rbgutil.c +0 -2
- data/ext/glib2/rbgutil.h +1 -3
- data/lib/2.2/glib2.so +0 -0
- data/lib/2.3/glib2.so +0 -0
- data/lib/glib2.rb +7 -0
- data/lib/gnome2/rake/external-package.rb +119 -2
- data/lib/gnome2/rake/package-task.rb +63 -3
- data/lib/gnome2/rake/windows-binary-build-task.rb +343 -337
- data/lib/gnome2/rake/windows-binary-download-task.rb +151 -148
- data/lib/mkmf-gnome2.rb +11 -30
- data/test/test-binding.rb +157 -66
- data/test/test_glib2.rb +21 -6
- data/vendor/local/bin/asn1Coding.exe +0 -0
- data/vendor/local/bin/gdbus.exe +0 -0
- data/vendor/local/bin/gio-querymodules.exe +0 -0
- data/vendor/local/bin/glib-compile-resources.exe +0 -0
- data/vendor/local/bin/glib-compile-schemas.exe +0 -0
- data/vendor/local/bin/glib-genmarshal.exe +0 -0
- data/vendor/local/bin/glib-gettextize +1 -1
- data/vendor/local/bin/glib-mkenums +1 -1
- data/vendor/local/bin/gobject-query.exe +0 -0
- data/vendor/local/bin/gresource.exe +0 -0
- data/vendor/local/bin/gsettings.exe +0 -0
- data/vendor/local/bin/gspawn-win32-helper-console.exe +0 -0
- data/vendor/local/bin/gspawn-win32-helper.exe +0 -0
- data/vendor/local/bin/idn.exe +0 -0
- data/vendor/local/bin/libasprintf-0.dll +0 -0
- data/vendor/local/bin/libgio-2.0-0.dll +0 -0
- data/vendor/local/bin/libglib-2.0-0.dll +0 -0
- data/vendor/local/bin/libgmodule-2.0-0.dll +0 -0
- data/vendor/local/bin/libgobject-2.0-0.dll +0 -0
- data/vendor/local/bin/libgthread-2.0-0.dll +0 -0
- data/vendor/local/bin/libnettle-6-2.dll +0 -0
- data/vendor/local/bin/libpcreposix-0.dll +0 -0
- data/vendor/local/bin/nettle-hash.exe +0 -0
- data/vendor/local/bin/p11-kit.exe +0 -0
- data/vendor/local/bin/pcregrep.exe +0 -0
- data/vendor/local/bin/pkcs1-conv.exe +0 -0
- data/vendor/local/bin/sexp-conv.exe +0 -0
- data/vendor/local/include/glib-2.0/gio/gioenums.h +1 -1
- data/vendor/local/include/glib-2.0/glib/gmacros.h +21 -6
- data/vendor/local/include/glib-2.0/glib/gregex.h +1 -1
- data/vendor/local/lib/gio/modules/libgiognutls.a +0 -0
- data/vendor/local/lib/gio/modules/libgiognutls.dll +0 -0
- data/vendor/local/lib/gio/modules/libgiognutls.dll.a +0 -0
- data/vendor/local/lib/glib-2.0/include/glibconfig.h +1 -1
- data/vendor/local/lib/libasprintf.dll.a +0 -0
- data/vendor/local/lib/libcharset.dll.a +0 -0
- data/vendor/local/lib/libffi.dll.a +0 -0
- data/vendor/local/lib/libgio-2.0.dll.a +0 -0
- data/vendor/local/lib/libgio-2.0.la +1 -1
- data/vendor/local/lib/libglib-2.0.dll.a +0 -0
- data/vendor/local/lib/libglib-2.0.la +1 -1
- data/vendor/local/lib/libgmodule-2.0.dll.a +0 -0
- data/vendor/local/lib/libgmodule-2.0.la +1 -1
- data/vendor/local/lib/libgmp.dll.a +0 -0
- data/vendor/local/lib/libgnutls.dll.a +0 -0
- data/vendor/local/lib/libgobject-2.0.dll.a +0 -0
- data/vendor/local/lib/libgobject-2.0.la +1 -1
- data/vendor/local/lib/libgthread-2.0.dll.a +0 -0
- data/vendor/local/lib/libgthread-2.0.la +1 -1
- data/vendor/local/lib/libhogweed.dll.a +0 -0
- data/vendor/local/lib/libiconv.dll.a +0 -0
- data/vendor/local/lib/libidn.dll.a +0 -0
- data/vendor/local/lib/libintl.dll.a +0 -0
- data/vendor/local/lib/libnettle.dll.a +0 -0
- data/vendor/local/lib/libp11-kit.dll.a +0 -0
- data/vendor/local/lib/libpcre.dll.a +0 -0
- data/vendor/local/lib/libpcrecpp.dll.a +0 -0
- data/vendor/local/lib/libpcreposix.dll.a +0 -0
- data/vendor/local/lib/libtasn1.dll.a +0 -0
- data/vendor/local/lib/pkcs11/p11-kit-trust.dll.a +0 -0
- data/vendor/local/lib/pkgconfig/gio-2.0.pc +1 -1
- data/vendor/local/lib/pkgconfig/gio-windows-2.0.pc +1 -1
- data/vendor/local/lib/pkgconfig/glib-2.0.pc +1 -1
- data/vendor/local/lib/pkgconfig/gmodule-2.0.pc +1 -1
- data/vendor/local/lib/pkgconfig/gmodule-export-2.0.pc +1 -1
- data/vendor/local/lib/pkgconfig/gmodule-no-export-2.0.pc +1 -1
- data/vendor/local/lib/pkgconfig/gobject-2.0.pc +1 -1
- data/vendor/local/lib/pkgconfig/gthread-2.0.pc +1 -1
- data/vendor/local/share/gdb/auto-load/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/lib/{libglib-2.0.so.0.4800.0-gdb.py → libglib-2.0.so.0.4800.1-gdb.py} +0 -0
- data/vendor/local/share/gdb/auto-load/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/lib/{libgobject-2.0.so.0.4800.0-gdb.py → libgobject-2.0.so.0.4800.1-gdb.py} +0 -0
- data/vendor/local/share/glib-2.0/codegen/__init__.pyc +0 -0
- data/vendor/local/share/glib-2.0/codegen/__init__.pyo +0 -0
- data/vendor/local/share/glib-2.0/codegen/codegen.pyc +0 -0
- data/vendor/local/share/glib-2.0/codegen/codegen.pyo +0 -0
- data/vendor/local/share/glib-2.0/codegen/codegen_docbook.pyc +0 -0
- data/vendor/local/share/glib-2.0/codegen/codegen_docbook.pyo +0 -0
- data/vendor/local/share/glib-2.0/codegen/codegen_main.pyc +0 -0
- data/vendor/local/share/glib-2.0/codegen/codegen_main.pyo +0 -0
- data/vendor/local/share/glib-2.0/codegen/config.py +1 -1
- data/vendor/local/share/glib-2.0/codegen/config.pyc +0 -0
- data/vendor/local/share/glib-2.0/codegen/config.pyo +0 -0
- data/vendor/local/share/glib-2.0/codegen/dbustypes.pyc +0 -0
- data/vendor/local/share/glib-2.0/codegen/dbustypes.pyo +0 -0
- data/vendor/local/share/glib-2.0/codegen/parser.pyc +0 -0
- data/vendor/local/share/glib-2.0/codegen/parser.pyo +0 -0
- data/vendor/local/share/glib-2.0/codegen/utils.pyc +0 -0
- data/vendor/local/share/glib-2.0/codegen/utils.pyo +0 -0
- data/vendor/local/share/gtk-doc/html/gio/GAction.html +98 -104
- data/vendor/local/share/gtk-doc/html/gio/GActionGroup.html +116 -121
- data/vendor/local/share/gtk-doc/html/gio/GActionMap.html +28 -33
- data/vendor/local/share/gtk-doc/html/gio/GAppInfo.html +206 -211
- data/vendor/local/share/gtk-doc/html/gio/GAppInfoMonitor.html +9 -9
- data/vendor/local/share/gtk-doc/html/gio/GApplication.html +219 -221
- data/vendor/local/share/gtk-doc/html/gio/GApplicationCommandLine.html +87 -87
- data/vendor/local/share/gtk-doc/html/gio/GAsyncInitable.html +63 -68
- data/vendor/local/share/gtk-doc/html/gio/GAsyncResult.html +36 -41
- data/vendor/local/share/gtk-doc/html/gio/GBufferedInputStream.html +62 -62
- data/vendor/local/share/gtk-doc/html/gio/GBufferedOutputStream.html +29 -29
- data/vendor/local/share/gtk-doc/html/gio/GBytesIcon.html +18 -18
- data/vendor/local/share/gtk-doc/html/gio/GCancellable.html +81 -81
- data/vendor/local/share/gtk-doc/html/gio/GCharsetConverter.html +28 -28
- data/vendor/local/share/gtk-doc/html/gio/GConverter.html +16 -21
- data/vendor/local/share/gtk-doc/html/gio/GCredentials.html +43 -43
- data/vendor/local/share/gtk-doc/html/gio/GDBusActionGroup.html +7 -7
- data/vendor/local/share/gtk-doc/html/gio/GDBusAuthObserver.html +38 -38
- data/vendor/local/share/gtk-doc/html/gio/GDBusConnection.html +526 -526
- data/vendor/local/share/gtk-doc/html/gio/GDBusInterface.html +17 -17
- data/vendor/local/share/gtk-doc/html/gio/GDBusInterfaceSkeleton.html +66 -71
- data/vendor/local/share/gtk-doc/html/gio/GDBusMenuModel.html +8 -8
- data/vendor/local/share/gtk-doc/html/gio/GDBusMessage.html +202 -202
- data/vendor/local/share/gtk-doc/html/gio/GDBusMethodInvocation.html +76 -76
- data/vendor/local/share/gtk-doc/html/gio/GDBusObject.html +29 -29
- data/vendor/local/share/gtk-doc/html/gio/GDBusObjectManager.html +43 -43
- data/vendor/local/share/gtk-doc/html/gio/GDBusObjectManagerClient.html +141 -146
- data/vendor/local/share/gtk-doc/html/gio/GDBusObjectManagerServer.html +32 -36
- data/vendor/local/share/gtk-doc/html/gio/GDBusObjectProxy.html +12 -16
- data/vendor/local/share/gtk-doc/html/gio/GDBusObjectSkeleton.html +28 -35
- data/vendor/local/share/gtk-doc/html/gio/GDBusProxy.html +229 -229
- data/vendor/local/share/gtk-doc/html/gio/GDBusServer.html +51 -51
- data/vendor/local/share/gtk-doc/html/gio/GDataInputStream.html +160 -160
- data/vendor/local/share/gtk-doc/html/gio/GDataOutputStream.html +86 -86
- data/vendor/local/share/gtk-doc/html/gio/GDatagramBased.html +73 -78
- data/vendor/local/share/gtk-doc/html/gio/GDrive.html +181 -186
- data/vendor/local/share/gtk-doc/html/gio/GDtlsClientConnection.html +29 -33
- data/vendor/local/share/gtk-doc/html/gio/GDtlsConnection.html +122 -122
- data/vendor/local/share/gtk-doc/html/gio/GDtlsServerConnection.html +12 -16
- data/vendor/local/share/gtk-doc/html/gio/GEmblem.html +14 -14
- data/vendor/local/share/gtk-doc/html/gio/GEmblemedIcon.html +17 -17
- data/vendor/local/share/gtk-doc/html/gio/GFile.html +890 -895
- data/vendor/local/share/gtk-doc/html/gio/GFileDescriptorBased.html +9 -16
- data/vendor/local/share/gtk-doc/html/gio/GFileEnumerator.html +78 -78
- data/vendor/local/share/gtk-doc/html/gio/GFileIOStream.html +21 -21
- data/vendor/local/share/gtk-doc/html/gio/GFileIcon.html +9 -9
- data/vendor/local/share/gtk-doc/html/gio/GFileInfo.html +239 -239
- data/vendor/local/share/gtk-doc/html/gio/GFileInputStream.html +18 -18
- data/vendor/local/share/gtk-doc/html/gio/GFileMonitor.html +29 -29
- data/vendor/local/share/gtk-doc/html/gio/GFileOutputStream.html +21 -21
- data/vendor/local/share/gtk-doc/html/gio/GFilenameCompleter.html +19 -19
- data/vendor/local/share/gtk-doc/html/gio/GFilterInputStream.html +15 -15
- data/vendor/local/share/gtk-doc/html/gio/GFilterOutputStream.html +15 -15
- data/vendor/local/share/gtk-doc/html/gio/GIOModule.html +39 -39
- data/vendor/local/share/gtk-doc/html/gio/GIOStream.html +60 -60
- data/vendor/local/share/gtk-doc/html/gio/GIcon.html +48 -53
- data/vendor/local/share/gtk-doc/html/gio/GInetAddress.html +110 -110
- data/vendor/local/share/gtk-doc/html/gio/GInetAddressMask.html +37 -37
- data/vendor/local/share/gtk-doc/html/gio/GInetSocketAddress.html +31 -31
- data/vendor/local/share/gtk-doc/html/gio/GInitable.html +68 -75
- data/vendor/local/share/gtk-doc/html/gio/GInputStream.html +142 -142
- data/vendor/local/share/gtk-doc/html/gio/GListModel.html +44 -49
- data/vendor/local/share/gtk-doc/html/gio/GListStore.html +35 -35
- data/vendor/local/share/gtk-doc/html/gio/GLoadableIcon.html +19 -24
- data/vendor/local/share/gtk-doc/html/gio/GMemoryInputStream.html +19 -19
- data/vendor/local/share/gtk-doc/html/gio/GMemoryOutputStream.html +57 -57
- data/vendor/local/share/gtk-doc/html/gio/GMenu.html +143 -143
- data/vendor/local/share/gtk-doc/html/gio/GMenuModel.html +107 -107
- data/vendor/local/share/gtk-doc/html/gio/GMount.html +161 -166
- data/vendor/local/share/gtk-doc/html/gio/GMountOperation.html +83 -83
- data/vendor/local/share/gtk-doc/html/gio/GNetworkAddress.html +45 -45
- data/vendor/local/share/gtk-doc/html/gio/GNetworkMonitor.html +54 -59
- data/vendor/local/share/gtk-doc/html/gio/GNetworkService.html +34 -34
- data/vendor/local/share/gtk-doc/html/gio/GNotification.html +51 -51
- data/vendor/local/share/gtk-doc/html/gio/GOutputStream.html +186 -186
- data/vendor/local/share/gtk-doc/html/gio/GPermission.html +71 -71
- data/vendor/local/share/gtk-doc/html/gio/GPollableInputStream.html +40 -45
- data/vendor/local/share/gtk-doc/html/gio/GPollableOutputStream.html +40 -45
- data/vendor/local/share/gtk-doc/html/gio/GPropertyAction.html +36 -36
- data/vendor/local/share/gtk-doc/html/gio/GProxy.html +25 -30
- data/vendor/local/share/gtk-doc/html/gio/GProxyAddress.html +59 -59
- data/vendor/local/share/gtk-doc/html/gio/GProxyResolver.html +32 -37
- data/vendor/local/share/gtk-doc/html/gio/GRemoteActionGroup.html +18 -23
- data/vendor/local/share/gtk-doc/html/gio/GResolver.html +147 -147
- data/vendor/local/share/gtk-doc/html/gio/GResource.html +114 -114
- data/vendor/local/share/gtk-doc/html/gio/GSeekable.html +46 -51
- data/vendor/local/share/gtk-doc/html/gio/GSettings.html +354 -354
- data/vendor/local/share/gtk-doc/html/gio/GSettingsBackend.html +47 -52
- data/vendor/local/share/gtk-doc/html/gio/GSimpleAction.html +46 -46
- data/vendor/local/share/gtk-doc/html/gio/GSimpleActionGroup.html +15 -15
- data/vendor/local/share/gtk-doc/html/gio/GSimpleAsyncResult.html +146 -146
- data/vendor/local/share/gtk-doc/html/gio/GSimpleIOStream.html +5 -5
- data/vendor/local/share/gtk-doc/html/gio/GSimplePermission.html +7 -7
- data/vendor/local/share/gtk-doc/html/gio/GSimpleProxyResolver.html +19 -19
- data/vendor/local/share/gtk-doc/html/gio/GSocket.html +454 -454
- data/vendor/local/share/gtk-doc/html/gio/GSocketAddress.html +26 -26
- data/vendor/local/share/gtk-doc/html/gio/GSocketClient.html +138 -138
- data/vendor/local/share/gtk-doc/html/gio/GSocketConnectable.html +37 -42
- data/vendor/local/share/gtk-doc/html/gio/GSocketConnection.html +54 -54
- data/vendor/local/share/gtk-doc/html/gio/GSocketControlMessage.html +20 -20
- data/vendor/local/share/gtk-doc/html/gio/GSocketListener.html +91 -91
- data/vendor/local/share/gtk-doc/html/gio/GSocketService.html +22 -22
- data/vendor/local/share/gtk-doc/html/gio/GSrvTarget.html +38 -38
- data/vendor/local/share/gtk-doc/html/gio/GSubprocess.html +139 -139
- data/vendor/local/share/gtk-doc/html/gio/GSubprocessLauncher.html +63 -63
- data/vendor/local/share/gtk-doc/html/gio/GTask.html +219 -219
- data/vendor/local/share/gtk-doc/html/gio/GTcpConnection.html +12 -12
- data/vendor/local/share/gtk-doc/html/gio/GTcpWrapperConnection.html +7 -7
- data/vendor/local/share/gtk-doc/html/gio/GTestDBus.html +21 -21
- data/vendor/local/share/gtk-doc/html/gio/GThemedIcon.html +24 -24
- data/vendor/local/share/gtk-doc/html/gio/GThreadedSocketService.html +16 -16
- data/vendor/local/share/gtk-doc/html/gio/GTlsBackend.html +53 -58
- data/vendor/local/share/gtk-doc/html/gio/GTlsCertificate.html +57 -57
- data/vendor/local/share/gtk-doc/html/gio/GTlsClientConnection.html +40 -47
- data/vendor/local/share/gtk-doc/html/gio/GTlsConnection.html +84 -84
- data/vendor/local/share/gtk-doc/html/gio/GTlsDatabase.html +79 -84
- data/vendor/local/share/gtk-doc/html/gio/GTlsFileDatabase.html +13 -17
- data/vendor/local/share/gtk-doc/html/gio/GTlsInteraction.html +32 -32
- data/vendor/local/share/gtk-doc/html/gio/GTlsPassword.html +41 -46
- data/vendor/local/share/gtk-doc/html/gio/GTlsServerConnection.html +11 -15
- data/vendor/local/share/gtk-doc/html/gio/GUnixConnection.html +52 -52
- data/vendor/local/share/gtk-doc/html/gio/GUnixCredentialsMessage.html +12 -12
- data/vendor/local/share/gtk-doc/html/gio/GUnixFDList.html +43 -43
- data/vendor/local/share/gtk-doc/html/gio/GUnixFDMessage.html +25 -25
- data/vendor/local/share/gtk-doc/html/gio/GUnixInputStream.html +25 -25
- data/vendor/local/share/gtk-doc/html/gio/GUnixOutputStream.html +25 -25
- data/vendor/local/share/gtk-doc/html/gio/GUnixSocketAddress.html +38 -38
- data/vendor/local/share/gtk-doc/html/gio/GVfs.html +24 -24
- data/vendor/local/share/gtk-doc/html/gio/GVolume.html +117 -122
- data/vendor/local/share/gtk-doc/html/gio/GVolumeMonitor.html +87 -87
- data/vendor/local/share/gtk-doc/html/gio/GZlibCompressor.html +14 -14
- data/vendor/local/share/gtk-doc/html/gio/GZlibDecompressor.html +10 -10
- data/vendor/local/share/gtk-doc/html/gio/annotation-glossary.html +4 -2
- data/vendor/local/share/gtk-doc/html/gio/api-index-2-18.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/api-index-2-20.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/api-index-2-22.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/api-index-2-24.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/api-index-2-26.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/api-index-2-28.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/api-index-2-30.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/api-index-2-32.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/api-index-2-34.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/api-index-2-36.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/api-index-2-38.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/api-index-2-40.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/api-index-2-42.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/api-index-2-44.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/api-index-2-46.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/api-index-2-48.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/api-index-deprecated.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/api-index-full.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/application.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/async.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/ch01.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/ch02.html +3 -3
- data/vendor/local/share/gtk-doc/html/gio/ch03.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/ch32.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/ch33.html +7 -7
- data/vendor/local/share/gtk-doc/html/gio/ch33s02.html +3 -3
- data/vendor/local/share/gtk-doc/html/gio/ch33s03.html +4 -4
- data/vendor/local/share/gtk-doc/html/gio/ch34.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/ch34s02.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/ch34s03.html +4 -4
- data/vendor/local/share/gtk-doc/html/gio/ch34s04.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/ch34s05.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/ch34s06.html +6 -6
- data/vendor/local/share/gtk-doc/html/gio/ch34s07.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/ch35.html +4 -4
- data/vendor/local/share/gtk-doc/html/gio/ch35s02.html +3 -3
- data/vendor/local/share/gtk-doc/html/gio/ch35s03.html +10 -10
- data/vendor/local/share/gtk-doc/html/gio/ch35s04.html +3 -3
- data/vendor/local/share/gtk-doc/html/gio/conversion.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/data-models.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/extending-gio.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/extending.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/failable_initialization.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/file_mon.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/file_ops.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/gapplication-tool.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/gdbus-codegen.html +55 -55
- data/vendor/local/share/gtk-doc/html/gio/gdbus-convenience.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/gdbus-example-gdbus-codegen.html +4 -4
- data/vendor/local/share/gtk-doc/html/gio/gdbus-lowlevel.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/gdbus.html +5 -5
- data/vendor/local/share/gtk-doc/html/gio/gio-D-Bus-Addresses.html +51 -51
- data/vendor/local/share/gtk-doc/html/gio/gio-D-Bus-Introspection-Data.html +188 -188
- data/vendor/local/share/gtk-doc/html/gio/gio-D-Bus-Utilities.html +72 -72
- data/vendor/local/share/gtk-doc/html/gio/gio-Desktop-file-based-GAppInfo.html +110 -117
- data/vendor/local/share/gtk-doc/html/gio/gio-Extension-Points.html +48 -48
- data/vendor/local/share/gtk-doc/html/gio/gio-GActionGroup-exporter.html +11 -11
- data/vendor/local/share/gtk-doc/html/gio/gio-GContentType.html +86 -86
- data/vendor/local/share/gtk-doc/html/gio/gio-GConverterInputstream.html +7 -7
- data/vendor/local/share/gtk-doc/html/gio/gio-GConverterOutputstream.html +7 -7
- data/vendor/local/share/gtk-doc/html/gio/gio-GDBusError.html +103 -103
- data/vendor/local/share/gtk-doc/html/gio/gio-GFileAttribute.html +22 -22
- data/vendor/local/share/gtk-doc/html/gio/gio-GIOError.html +15 -15
- data/vendor/local/share/gtk-doc/html/gio/gio-GIOScheduler.html +41 -41
- data/vendor/local/share/gtk-doc/html/gio/gio-GMenuModel-exporter.html +11 -11
- data/vendor/local/share/gtk-doc/html/gio/gio-GSettingsSchema-GSettingsSchemaSource.html +108 -108
- data/vendor/local/share/gtk-doc/html/gio/gio-GWin32InputStream.html +17 -17
- data/vendor/local/share/gtk-doc/html/gio/gio-GWin32OutputStream.html +17 -17
- data/vendor/local/share/gtk-doc/html/gio/gio-GWin32RegistryKey.html +221 -221
- data/vendor/local/share/gtk-doc/html/gio/gio-Owning-Bus-Names.html +63 -63
- data/vendor/local/share/gtk-doc/html/gio/gio-TLS-Overview.html +16 -23
- data/vendor/local/share/gtk-doc/html/gio/gio-Unix-Mounts.html +128 -128
- data/vendor/local/share/gtk-doc/html/gio/gio-Watching-Bus-Names.html +57 -57
- data/vendor/local/share/gtk-doc/html/gio/gio-gnetworking.h.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/gio-gpollableutils.html +71 -71
- data/vendor/local/share/gtk-doc/html/gio/gio-hierarchy.html +6 -6
- data/vendor/local/share/gtk-doc/html/gio/gio-querymodules.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/gio.devhelp2 +450 -10
- data/vendor/local/share/gtk-doc/html/gio/glib-compile-resources.html +3 -3
- data/vendor/local/share/gtk-doc/html/gio/glib-compile-schemas.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/gresource-tool.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/gsettings-tool.html +5 -5
- data/vendor/local/share/gtk-doc/html/gio/highlevel-socket.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/icons.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/index.html +3 -3
- data/vendor/local/share/gtk-doc/html/gio/migrating.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/networking.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/permissions.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/pt01.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/pt02.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/registry.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/resolver.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/resources.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/running-gio-apps.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/settings.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/streaming.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/subprocesses.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/testing.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/tls.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/tools.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/types.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/utils.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/volume_mon.html +2 -2
- data/vendor/local/share/gtk-doc/html/glib/annotation-glossary.html +4 -2
- data/vendor/local/share/gtk-doc/html/glib/api-index-2-10.html +2 -2
- data/vendor/local/share/gtk-doc/html/glib/api-index-2-12.html +2 -2
- data/vendor/local/share/gtk-doc/html/glib/api-index-2-14.html +2 -2
- data/vendor/local/share/gtk-doc/html/glib/api-index-2-16.html +2 -2
- data/vendor/local/share/gtk-doc/html/glib/api-index-2-18.html +2 -2
- data/vendor/local/share/gtk-doc/html/glib/api-index-2-2.html +2 -2
- data/vendor/local/share/gtk-doc/html/glib/api-index-2-20.html +2 -2
- data/vendor/local/share/gtk-doc/html/glib/api-index-2-22.html +2 -2
- data/vendor/local/share/gtk-doc/html/glib/api-index-2-24.html +2 -2
- data/vendor/local/share/gtk-doc/html/glib/api-index-2-26.html +2 -2
- data/vendor/local/share/gtk-doc/html/glib/api-index-2-28.html +2 -2
- data/vendor/local/share/gtk-doc/html/glib/api-index-2-30.html +2 -2
- data/vendor/local/share/gtk-doc/html/glib/api-index-2-32.html +2 -2
- data/vendor/local/share/gtk-doc/html/glib/api-index-2-34.html +2 -2
- data/vendor/local/share/gtk-doc/html/glib/api-index-2-36.html +2 -2
- data/vendor/local/share/gtk-doc/html/glib/api-index-2-38.html +2 -2
- data/vendor/local/share/gtk-doc/html/glib/api-index-2-4.html +3 -10
- data/vendor/local/share/gtk-doc/html/glib/api-index-2-40.html +2 -2
- data/vendor/local/share/gtk-doc/html/glib/api-index-2-42.html +2 -2
- data/vendor/local/share/gtk-doc/html/glib/api-index-2-44.html +2 -2
- data/vendor/local/share/gtk-doc/html/glib/api-index-2-46.html +2 -2
- data/vendor/local/share/gtk-doc/html/glib/api-index-2-48.html +2 -2
- data/vendor/local/share/gtk-doc/html/glib/api-index-2-6.html +2 -2
- data/vendor/local/share/gtk-doc/html/glib/api-index-2-8.html +2 -2
- data/vendor/local/share/gtk-doc/html/glib/api-index-deprecated.html +2 -2
- data/vendor/local/share/gtk-doc/html/glib/api-index-full.html +3 -10
- data/vendor/local/share/gtk-doc/html/glib/deprecated.html +2 -2
- data/vendor/local/share/gtk-doc/html/glib/glib-Arrays.html +42 -42
- data/vendor/local/share/gtk-doc/html/glib/glib-Asynchronous-Queues.html +44 -44
- data/vendor/local/share/gtk-doc/html/glib/glib-Atomic-Operations.html +40 -40
- data/vendor/local/share/gtk-doc/html/glib/glib-Automatic-String-Completion.html +18 -18
- data/vendor/local/share/gtk-doc/html/glib/glib-Balanced-Binary-Trees.html +32 -32
- data/vendor/local/share/gtk-doc/html/glib/glib-Base64-Encoding.html +14 -14
- data/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html +5 -5
- data/vendor/local/share/gtk-doc/html/glib/glib-Bookmark-file-parser.html +68 -68
- data/vendor/local/share/gtk-doc/html/glib/glib-Bounds-checked-integer-arithmetic.html +14 -14
- data/vendor/local/share/gtk-doc/html/glib/glib-Byte-Arrays.html +56 -56
- data/vendor/local/share/gtk-doc/html/glib/glib-Byte-Order-Macros.html +120 -120
- data/vendor/local/share/gtk-doc/html/glib/glib-Caches.html +15 -15
- data/vendor/local/share/gtk-doc/html/glib/glib-Character-Set-Conversion.html +35 -35
- data/vendor/local/share/gtk-doc/html/glib/glib-Commandline-option-parser.html +72 -72
- data/vendor/local/share/gtk-doc/html/glib/glib-Data-Checksums.html +21 -21
- data/vendor/local/share/gtk-doc/html/glib/glib-Data-HMACs.html +17 -17
- data/vendor/local/share/gtk-doc/html/glib/glib-Datasets.html +24 -24
- data/vendor/local/share/gtk-doc/html/glib/glib-Date-and-Time-Functions.html +93 -93
- data/vendor/local/share/gtk-doc/html/glib/glib-Deprecated-Thread-APIs.html +50 -50
- data/vendor/local/share/gtk-doc/html/glib/glib-Double-ended-Queues.html +64 -64
- data/vendor/local/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html +69 -69
- data/vendor/local/share/gtk-doc/html/glib/glib-Dynamic-Loading-of-Modules.html +19 -19
- data/vendor/local/share/gtk-doc/html/glib/glib-Error-Reporting.html +21 -21
- data/vendor/local/share/gtk-doc/html/glib/glib-File-Utilities.html +80 -80
- data/vendor/local/share/gtk-doc/html/glib/glib-GDateTime.html +157 -157
- data/vendor/local/share/gtk-doc/html/glib/glib-GTimeZone.html +20 -20
- data/vendor/local/share/gtk-doc/html/glib/glib-GVariant.html +292 -266
- data/vendor/local/share/gtk-doc/html/glib/glib-GVariantType.html +423 -421
- data/vendor/local/share/gtk-doc/html/glib/glib-Glob-style-pattern-matching.html +13 -13
- data/vendor/local/share/gtk-doc/html/glib/glib-Hash-Tables.html +92 -92
- data/vendor/local/share/gtk-doc/html/glib/glib-Hook-Functions.html +62 -62
- data/vendor/local/share/gtk-doc/html/glib/glib-Hostname-Utilities.html +12 -12
- data/vendor/local/share/gtk-doc/html/glib/glib-I18N.html +27 -56
- data/vendor/local/share/gtk-doc/html/glib/glib-IO-Channels.html +84 -84
- data/vendor/local/share/gtk-doc/html/glib/glib-Key-value-file-parser.html +81 -81
- data/vendor/local/share/gtk-doc/html/glib/glib-Keyed-Data-Lists.html +31 -31
- data/vendor/local/share/gtk-doc/html/glib/glib-Lexical-Scanner.html +45 -45
- data/vendor/local/share/gtk-doc/html/glib/glib-Memory-Allocation.html +55 -55
- data/vendor/local/share/gtk-doc/html/glib/glib-Memory-Slices.html +22 -22
- data/vendor/local/share/gtk-doc/html/glib/glib-Message-Logging.html +80 -78
- data/vendor/local/share/gtk-doc/html/glib/glib-Miscellaneous-Macros.html +36 -36
- data/vendor/local/share/gtk-doc/html/glib/glib-Miscellaneous-Utility-Functions.html +83 -83
- data/vendor/local/share/gtk-doc/html/glib/glib-N-ary-Trees.html +81 -81
- data/vendor/local/share/gtk-doc/html/glib/glib-Numerical-Definitions.html +4 -4
- data/vendor/local/share/gtk-doc/html/glib/glib-Perl-compatible-regular-expressions.html +84 -84
- data/vendor/local/share/gtk-doc/html/glib/glib-Pointer-Arrays.html +34 -34
- data/vendor/local/share/gtk-doc/html/glib/glib-Quarks.html +15 -15
- data/vendor/local/share/gtk-doc/html/glib/glib-Random-Numbers.html +30 -30
- data/vendor/local/share/gtk-doc/html/glib/glib-Relations-and-Tuples.html +20 -20
- data/vendor/local/share/gtk-doc/html/glib/glib-Sequences.html +67 -67
- data/vendor/local/share/gtk-doc/html/glib/glib-Shell-related-Utilities.html +9 -9
- data/vendor/local/share/gtk-doc/html/glib/glib-Simple-XML-Subset-Parser.html +34 -34
- data/vendor/local/share/gtk-doc/html/glib/glib-Singly-Linked-Lists.html +58 -58
- data/vendor/local/share/gtk-doc/html/glib/glib-Spawning-Processes.html +19 -19
- data/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html +30 -30
- data/vendor/local/share/gtk-doc/html/glib/glib-String-Chunks.html +12 -12
- data/vendor/local/share/gtk-doc/html/glib/glib-String-Utility-Functions.html +195 -189
- data/vendor/local/share/gtk-doc/html/glib/glib-Strings.html +65 -65
- data/vendor/local/share/gtk-doc/html/glib/glib-Testing.html +91 -91
- data/vendor/local/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html +166 -166
- data/vendor/local/share/gtk-doc/html/glib/glib-Thread-Pools.html +24 -24
- data/vendor/local/share/gtk-doc/html/glib/glib-Threads.html +86 -86
- data/vendor/local/share/gtk-doc/html/glib/glib-Timers.html +10 -10
- data/vendor/local/share/gtk-doc/html/glib/glib-Trash-Stacks.html +11 -11
- data/vendor/local/share/gtk-doc/html/glib/glib-Type-Conversion-Macros.html +8 -8
- data/vendor/local/share/gtk-doc/html/glib/glib-UNIX-specific-utilities-and-integration.html +46 -38
- data/vendor/local/share/gtk-doc/html/glib/glib-URI-Functions.html +16 -16
- data/vendor/local/share/gtk-doc/html/glib/glib-Unicode-Manipulation.html +134 -134
- data/vendor/local/share/gtk-doc/html/glib/glib-Version-Information.html +128 -128
- data/vendor/local/share/gtk-doc/html/glib/glib-Warnings-and-Assertions.html +19 -19
- data/vendor/local/share/gtk-doc/html/glib/glib-Windows-Compatibility-Functions.html +20 -20
- data/vendor/local/share/gtk-doc/html/glib/glib-building.html +2 -2
- data/vendor/local/share/gtk-doc/html/glib/glib-changes.html +2 -2
- data/vendor/local/share/gtk-doc/html/glib/glib-compiling.html +2 -2
- data/vendor/local/share/gtk-doc/html/glib/glib-core.html +2 -2
- data/vendor/local/share/gtk-doc/html/glib/glib-cross-compiling.html +2 -2
- data/vendor/local/share/gtk-doc/html/glib/glib-data-types.html +2 -2
- data/vendor/local/share/gtk-doc/html/glib/glib-fundamentals.html +2 -2
- data/vendor/local/share/gtk-doc/html/glib/glib-gettextize.html +2 -2
- data/vendor/local/share/gtk-doc/html/glib/glib-programming.html +2 -2
- data/vendor/local/share/gtk-doc/html/glib/glib-regex-syntax.html +2 -2
- data/vendor/local/share/gtk-doc/html/glib/glib-resources.html +2 -2
- data/vendor/local/share/gtk-doc/html/glib/glib-running.html +2 -2
- data/vendor/local/share/gtk-doc/html/glib/glib-utilities.html +2 -2
- data/vendor/local/share/gtk-doc/html/glib/glib.devhelp2 +189 -51
- data/vendor/local/share/gtk-doc/html/glib/glib.html +2 -2
- data/vendor/local/share/gtk-doc/html/glib/gtester-report.html +2 -2
- data/vendor/local/share/gtk-doc/html/glib/gtester.html +2 -2
- data/vendor/local/share/gtk-doc/html/glib/gvariant-format-strings.html +15 -15
- data/vendor/local/share/gtk-doc/html/glib/gvariant-text.html +17 -17
- data/vendor/local/share/gtk-doc/html/glib/index.html +3 -3
- data/vendor/local/share/gtk-doc/html/glib/tools.html +2 -2
- data/vendor/local/share/gtk-doc/html/gobject/GBinding.html +55 -55
- data/vendor/local/share/gtk-doc/html/gobject/GTypeModule.html +28 -33
- data/vendor/local/share/gtk-doc/html/gobject/GTypePlugin.html +12 -12
- data/vendor/local/share/gtk-doc/html/gobject/annotation-glossary.html +4 -2
- data/vendor/local/share/gtk-doc/html/gobject/api-index-2-10.html +2 -2
- data/vendor/local/share/gtk-doc/html/gobject/api-index-2-12.html +2 -2
- data/vendor/local/share/gtk-doc/html/gobject/api-index-2-14.html +2 -2
- data/vendor/local/share/gtk-doc/html/gobject/api-index-2-18.html +2 -2
- data/vendor/local/share/gtk-doc/html/gobject/api-index-2-2.html +2 -2
- data/vendor/local/share/gtk-doc/html/gobject/api-index-2-22.html +2 -2
- data/vendor/local/share/gtk-doc/html/gobject/api-index-2-24.html +2 -2
- data/vendor/local/share/gtk-doc/html/gobject/api-index-2-26.html +2 -2
- data/vendor/local/share/gtk-doc/html/gobject/api-index-2-28.html +2 -2
- data/vendor/local/share/gtk-doc/html/gobject/api-index-2-30.html +2 -2
- data/vendor/local/share/gtk-doc/html/gobject/api-index-2-32.html +2 -2
- data/vendor/local/share/gtk-doc/html/gobject/api-index-2-34.html +2 -2
- data/vendor/local/share/gtk-doc/html/gobject/api-index-2-36.html +2 -2
- data/vendor/local/share/gtk-doc/html/gobject/api-index-2-38.html +2 -2
- data/vendor/local/share/gtk-doc/html/gobject/api-index-2-4.html +2 -2
- data/vendor/local/share/gtk-doc/html/gobject/api-index-2-40.html +2 -2
- data/vendor/local/share/gtk-doc/html/gobject/api-index-2-42.html +2 -2
- data/vendor/local/share/gtk-doc/html/gobject/api-index-2-44.html +2 -2
- data/vendor/local/share/gtk-doc/html/gobject/api-index-2-46.html +2 -2
- data/vendor/local/share/gtk-doc/html/gobject/api-index-2-6.html +2 -2
- data/vendor/local/share/gtk-doc/html/gobject/api-index-2-8.html +2 -2
- data/vendor/local/share/gtk-doc/html/gobject/api-index-deprecated.html +2 -2
- data/vendor/local/share/gtk-doc/html/gobject/api-index-full.html +2 -2
- data/vendor/local/share/gtk-doc/html/gobject/ch01s02.html +2 -2
- data/vendor/local/share/gtk-doc/html/gobject/chapter-gobject.html +2 -2
- data/vendor/local/share/gtk-doc/html/gobject/chapter-gtype.html +4 -4
- data/vendor/local/share/gtk-doc/html/gobject/chapter-intro.html +2 -2
- data/vendor/local/share/gtk-doc/html/gobject/chapter-signal.html +3 -3
- data/vendor/local/share/gtk-doc/html/gobject/glib-genmarshal.html +2 -2
- data/vendor/local/share/gtk-doc/html/gobject/glib-mkenums.html +2 -2
- data/vendor/local/share/gtk-doc/html/gobject/gobject-Boxed-Types.html +72 -62
- data/vendor/local/share/gtk-doc/html/gobject/gobject-Closures.html +301 -301
- data/vendor/local/share/gtk-doc/html/gobject/gobject-Enumeration-and-Flag-Types.html +71 -71
- data/vendor/local/share/gtk-doc/html/gobject/gobject-GParamSpec.html +139 -139
- data/vendor/local/share/gtk-doc/html/gobject/gobject-Generic-values.html +92 -92
- data/vendor/local/share/gtk-doc/html/gobject/gobject-Signals.html +304 -304
- data/vendor/local/share/gtk-doc/html/gobject/gobject-Standard-Parameter-and-Value-Types.html +570 -682
- data/vendor/local/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html +276 -276
- data/vendor/local/share/gtk-doc/html/gobject/gobject-Type-Information.html +349 -349
- data/vendor/local/share/gtk-doc/html/gobject/gobject-Value-arrays.html +54 -54
- data/vendor/local/share/gtk-doc/html/gobject/gobject-Varargs-Value-Collection.html +15 -15
- data/vendor/local/share/gtk-doc/html/gobject/gobject-memory.html +2 -2
- data/vendor/local/share/gtk-doc/html/gobject/gobject-properties.html +5 -5
- data/vendor/local/share/gtk-doc/html/gobject/gobject-query.html +2 -2
- data/vendor/local/share/gtk-doc/html/gobject/gobject.devhelp2 +153 -8
- data/vendor/local/share/gtk-doc/html/gobject/gtype-conventions.html +3 -3
- data/vendor/local/share/gtk-doc/html/gobject/gtype-instantiable-classed.html +2 -2
- data/vendor/local/share/gtk-doc/html/gobject/gtype-non-instantiable-classed.html +9 -9
- data/vendor/local/share/gtk-doc/html/gobject/gtype-non-instantiable.html +2 -2
- data/vendor/local/share/gtk-doc/html/gobject/howto-gobject-chainup.html +2 -2
- data/vendor/local/share/gtk-doc/html/gobject/howto-gobject-code.html +2 -2
- data/vendor/local/share/gtk-doc/html/gobject/howto-gobject-construction.html +4 -4
- data/vendor/local/share/gtk-doc/html/gobject/howto-gobject-destruction.html +3 -3
- data/vendor/local/share/gtk-doc/html/gobject/howto-gobject-methods.html +15 -15
- data/vendor/local/share/gtk-doc/html/gobject/howto-gobject.html +2 -2
- data/vendor/local/share/gtk-doc/html/gobject/howto-interface-implement.html +5 -5
- data/vendor/local/share/gtk-doc/html/gobject/howto-interface-override.html +4 -4
- data/vendor/local/share/gtk-doc/html/gobject/howto-interface-prerequisite.html +6 -6
- data/vendor/local/share/gtk-doc/html/gobject/howto-interface-properties.html +2 -2
- data/vendor/local/share/gtk-doc/html/gobject/howto-interface.html +9 -9
- data/vendor/local/share/gtk-doc/html/gobject/howto-signals.html +4 -4
- data/vendor/local/share/gtk-doc/html/gobject/index.html +3 -3
- data/vendor/local/share/gtk-doc/html/gobject/pr01.html +2 -2
- data/vendor/local/share/gtk-doc/html/gobject/pt01.html +2 -2
- data/vendor/local/share/gtk-doc/html/gobject/pt02.html +2 -2
- data/vendor/local/share/gtk-doc/html/gobject/pt03.html +2 -2
- data/vendor/local/share/gtk-doc/html/gobject/rn01.html +2 -2
- data/vendor/local/share/gtk-doc/html/gobject/rn02.html +2 -2
- data/vendor/local/share/gtk-doc/html/gobject/signal.html +5 -5
- data/vendor/local/share/gtk-doc/html/gobject/tools-ginspector.html +2 -2
- data/vendor/local/share/gtk-doc/html/gobject/tools-gob.html +2 -2
- data/vendor/local/share/gtk-doc/html/gobject/tools-gtkdoc.html +3 -3
- data/vendor/local/share/gtk-doc/html/gobject/tools-refdb.html +2 -2
- data/vendor/local/share/gtk-doc/html/gobject/tools-vala.html +2 -2
- data/vendor/local/share/gtk-doc/html/p11-kit/p11-kit-Future.html +4 -4
- data/vendor/local/share/gtk-doc/html/p11-kit/p11-kit-Modules.html +12 -12
- data/vendor/local/share/gtk-doc/html/p11-kit/p11-kit-PIN-Callbacks.html +15 -15
- data/vendor/local/share/gtk-doc/html/p11-kit/p11-kit-URIs.html +2 -2
- data/vendor/local/share/gtk-doc/html/p11-kit/p11-kit-Utilities.html +2 -2
- data/vendor/local/share/locale/ca/LC_MESSAGES/glib20.mo +0 -0
- data/vendor/local/share/locale/eu/LC_MESSAGES/glib20.mo +0 -0
- data/vendor/local/share/locale/fur/LC_MESSAGES/glib-networking.mo +0 -0
- data/vendor/local/share/locale/gd/LC_MESSAGES/glib-networking.mo +0 -0
- data/vendor/local/share/locale/oc/LC_MESSAGES/glib-networking.mo +0 -0
- data/vendor/local/share/locale/vi/LC_MESSAGES/glib20.mo +0 -0
- data/vendor/local/share/locale/zh_CN/LC_MESSAGES/glib20.mo +0 -0
- data/vendor/local/share/man/man1/gapplication.1 +1 -1
- data/vendor/local/share/man/man1/gdbus-codegen.1 +1 -1
- data/vendor/local/share/man/man1/gdbus.1 +1 -1
- data/vendor/local/share/man/man1/gio-querymodules.1 +1 -1
- data/vendor/local/share/man/man1/glib-compile-resources.1 +1 -1
- data/vendor/local/share/man/man1/glib-compile-schemas.1 +1 -1
- data/vendor/local/share/man/man1/glib-genmarshal.1 +1 -1
- data/vendor/local/share/man/man1/glib-gettextize.1 +1 -1
- data/vendor/local/share/man/man1/glib-mkenums.1 +1 -1
- data/vendor/local/share/man/man1/gobject-query.1 +1 -1
- data/vendor/local/share/man/man1/gresource.1 +1 -1
- data/vendor/local/share/man/man1/gsettings.1 +1 -1
- data/vendor/local/share/man/man1/gtester-report.1 +1 -1
- data/vendor/local/share/man/man1/gtester.1 +1 -1
- metadata +6 -8
- data/vendor/local/share/gtk-doc/html/gio/index.sgml +0 -4612
- data/vendor/local/share/gtk-doc/html/glib/index.sgml +0 -3447
- data/vendor/local/share/gtk-doc/html/gobject/index.sgml +0 -924
|
@@ -8,7 +8,7 @@
|
|
|
8
8
|
<link rel="up" href="subprocesses.html" title="Subprocesses">
|
|
9
9
|
<link rel="prev" href="GSubprocess.html" title="GSubprocess">
|
|
10
10
|
<link rel="next" href="networking.html" title="Low-level network support">
|
|
11
|
-
<meta name="generator" content="GTK-Doc V1.
|
|
11
|
+
<meta name="generator" content="GTK-Doc V1.25.1 (XML mode)">
|
|
12
12
|
<link rel="stylesheet" href="style.css" type="text/css">
|
|
13
13
|
</head>
|
|
14
14
|
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
|
|
@@ -90,7 +90,7 @@
|
|
|
90
90
|
</td>
|
|
91
91
|
</tr>
|
|
92
92
|
<tr>
|
|
93
|
-
<td class="function_type">const <a href="../glib
|
|
93
|
+
<td class="function_type">const <a href="../glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
|
|
94
94
|
</td>
|
|
95
95
|
<td class="function_name">
|
|
96
96
|
<a class="link" href="GSubprocessLauncher.html#g-subprocess-launcher-getenv" title="g_subprocess_launcher_getenv ()">g_subprocess_launcher_getenv</a> <span class="c_punctuation">()</span>
|
|
@@ -209,7 +209,7 @@
|
|
|
209
209
|
</div>
|
|
210
210
|
<div class="refsect1">
|
|
211
211
|
<a name="GSubprocessLauncher.object-hierarchy"></a><h2>Object Hierarchy</h2>
|
|
212
|
-
<pre class="screen"> <a href="../gobject
|
|
212
|
+
<pre class="screen"> <a href="../gobject-The-Base-Object-Type.html#GObject-struct">GObject</a>
|
|
213
213
|
<span class="lineart">╰──</span> GSubprocessLauncher
|
|
214
214
|
</pre>
|
|
215
215
|
</div>
|
|
@@ -239,7 +239,7 @@ g_subprocess_launcher_new (<em class="parameter"><code><a class="link" href="GSu
|
|
|
239
239
|
environment of the calling process is made at the time of this call
|
|
240
240
|
and will be used as the environment that the process is launched in.</p>
|
|
241
241
|
<div class="refsect3">
|
|
242
|
-
<a name="
|
|
242
|
+
<a name="g-subprocess-launcher-new.parameters"></a><h4>Parameters</h4>
|
|
243
243
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
|
244
244
|
<colgroup>
|
|
245
245
|
<col width="150px" class="parameters_name">
|
|
@@ -260,12 +260,12 @@ and will be used as the environment that the process is launched in.</p>
|
|
|
260
260
|
<a name="g-subprocess-launcher-spawn"></a><h3>g_subprocess_launcher_spawn ()</h3>
|
|
261
261
|
<pre class="programlisting"><a class="link" href="GSubprocess.html" title="GSubprocess"><span class="returnvalue">GSubprocess</span></a> *
|
|
262
262
|
g_subprocess_launcher_spawn (<em class="parameter"><code><a class="link" href="GSubprocessLauncher.html" title="GSubprocess Launcher"><span class="type">GSubprocessLauncher</span></a> *self</code></em>,
|
|
263
|
-
<em class="parameter"><code><a href="../glib
|
|
264
|
-
<em class="parameter"><code>const <a href="../glib
|
|
263
|
+
<em class="parameter"><code><a href="../glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>,
|
|
264
|
+
<em class="parameter"><code>const <a href="../glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *argv0</code></em>,
|
|
265
265
|
<em class="parameter"><code>...</code></em>);</pre>
|
|
266
266
|
<p>Creates a <a class="link" href="GSubprocess.html" title="GSubprocess"><span class="type">GSubprocess</span></a> given a provided varargs list of arguments.</p>
|
|
267
267
|
<div class="refsect3">
|
|
268
|
-
<a name="
|
|
268
|
+
<a name="g-subprocess-launcher-spawn.parameters"></a><h4>Parameters</h4>
|
|
269
269
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
|
270
270
|
<colgroup>
|
|
271
271
|
<col width="150px" class="parameters_name">
|
|
@@ -290,15 +290,15 @@ g_subprocess_launcher_spawn (<em class="parameter"><code><a class="link" href="G
|
|
|
290
290
|
</tr>
|
|
291
291
|
<tr>
|
|
292
292
|
<td class="parameter_name"><p>...</p></td>
|
|
293
|
-
<td class="parameter_description"><p>Continued arguments, <a href="../glib
|
|
293
|
+
<td class="parameter_description"><p>Continued arguments, <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> terminated</p></td>
|
|
294
294
|
<td class="parameter_annotations"> </td>
|
|
295
295
|
</tr>
|
|
296
296
|
</tbody>
|
|
297
297
|
</table></div>
|
|
298
298
|
</div>
|
|
299
299
|
<div class="refsect3">
|
|
300
|
-
<a name="
|
|
301
|
-
<p> A new <a class="link" href="GSubprocess.html" title="GSubprocess"><span class="type">GSubprocess</span></a>, or <a href="../glib
|
|
300
|
+
<a name="g-subprocess-launcher-spawn.returns"></a><h4>Returns</h4>
|
|
301
|
+
<p> A new <a class="link" href="GSubprocess.html" title="GSubprocess"><span class="type">GSubprocess</span></a>, or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error (and <em class="parameter"><code>error</code></em>
|
|
302
302
|
will be set). </p>
|
|
303
303
|
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
|
|
304
304
|
</div>
|
|
@@ -309,11 +309,11 @@ will be set). </p>
|
|
|
309
309
|
<a name="g-subprocess-launcher-spawnv"></a><h3>g_subprocess_launcher_spawnv ()</h3>
|
|
310
310
|
<pre class="programlisting"><a class="link" href="GSubprocess.html" title="GSubprocess"><span class="returnvalue">GSubprocess</span></a> *
|
|
311
311
|
g_subprocess_launcher_spawnv (<em class="parameter"><code><a class="link" href="GSubprocessLauncher.html" title="GSubprocess Launcher"><span class="type">GSubprocessLauncher</span></a> *self</code></em>,
|
|
312
|
-
<em class="parameter"><code>const <a href="../glib
|
|
313
|
-
<em class="parameter"><code><a href="../glib
|
|
312
|
+
<em class="parameter"><code>const <a href="../glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> * const *argv</code></em>,
|
|
313
|
+
<em class="parameter"><code><a href="../glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
|
|
314
314
|
<p>Creates a <a class="link" href="GSubprocess.html" title="GSubprocess"><span class="type">GSubprocess</span></a> given a provided array of arguments.</p>
|
|
315
315
|
<div class="refsect3">
|
|
316
|
-
<a name="
|
|
316
|
+
<a name="g-subprocess-launcher-spawnv.parameters"></a><h4>Parameters</h4>
|
|
317
317
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
|
318
318
|
<colgroup>
|
|
319
319
|
<col width="150px" class="parameters_name">
|
|
@@ -340,8 +340,8 @@ g_subprocess_launcher_spawnv (<em class="parameter"><code><a class="link" href="
|
|
|
340
340
|
</table></div>
|
|
341
341
|
</div>
|
|
342
342
|
<div class="refsect3">
|
|
343
|
-
<a name="
|
|
344
|
-
<p> A new <a class="link" href="GSubprocess.html" title="GSubprocess"><span class="type">GSubprocess</span></a>, or <a href="../glib
|
|
343
|
+
<a name="g-subprocess-launcher-spawnv.returns"></a><h4>Returns</h4>
|
|
344
|
+
<p> A new <a class="link" href="GSubprocess.html" title="GSubprocess"><span class="type">GSubprocess</span></a>, or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error (and <em class="parameter"><code>error</code></em>
|
|
345
345
|
will be set). </p>
|
|
346
346
|
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
|
|
347
347
|
</div>
|
|
@@ -352,18 +352,18 @@ will be set). </p>
|
|
|
352
352
|
<a name="g-subprocess-launcher-set-environ"></a><h3>g_subprocess_launcher_set_environ ()</h3>
|
|
353
353
|
<pre class="programlisting"><span class="returnvalue">void</span>
|
|
354
354
|
g_subprocess_launcher_set_environ (<em class="parameter"><code><a class="link" href="GSubprocessLauncher.html" title="GSubprocess Launcher"><span class="type">GSubprocessLauncher</span></a> *self</code></em>,
|
|
355
|
-
<em class="parameter"><code><a href="../glib
|
|
355
|
+
<em class="parameter"><code><a href="../glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **env</code></em>);</pre>
|
|
356
356
|
<p>Replace the entire environment of processes launched from this
|
|
357
357
|
launcher with the given 'environ' variable.</p>
|
|
358
|
-
<p>Typically you will build this variable by using <a href="../glib
|
|
359
|
-
the process 'environ' and using the functions <a href="../glib
|
|
360
|
-
<a href="../glib
|
|
358
|
+
<p>Typically you will build this variable by using <a href="../glib-Miscellaneous-Utility-Functions.html#g-listenv"><code class="function">g_listenv()</code></a> to copy
|
|
359
|
+
the process 'environ' and using the functions <a href="../glib-Miscellaneous-Utility-Functions.html#g-environ-setenv"><code class="function">g_environ_setenv()</code></a>,
|
|
360
|
+
<a href="../glib-Miscellaneous-Utility-Functions.html#g-environ-unsetenv"><code class="function">g_environ_unsetenv()</code></a>, etc.</p>
|
|
361
361
|
<p>As an alternative, you can use <a class="link" href="GSubprocessLauncher.html#g-subprocess-launcher-setenv" title="g_subprocess_launcher_setenv ()"><code class="function">g_subprocess_launcher_setenv()</code></a>,
|
|
362
362
|
<a class="link" href="GSubprocessLauncher.html#g-subprocess-launcher-unsetenv" title="g_subprocess_launcher_unsetenv ()"><code class="function">g_subprocess_launcher_unsetenv()</code></a>, etc.</p>
|
|
363
363
|
<p>On UNIX, all strings in this array can be arbitrary byte strings.
|
|
364
364
|
On Windows, they should be in UTF-8.</p>
|
|
365
365
|
<div class="refsect3">
|
|
366
|
-
<a name="
|
|
366
|
+
<a name="g-subprocess-launcher-set-environ.parameters"></a><h4>Parameters</h4>
|
|
367
367
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
|
368
368
|
<colgroup>
|
|
369
369
|
<col width="150px" class="parameters_name">
|
|
@@ -391,9 +391,9 @@ On Windows, they should be in UTF-8.</p>
|
|
|
391
391
|
<a name="g-subprocess-launcher-setenv"></a><h3>g_subprocess_launcher_setenv ()</h3>
|
|
392
392
|
<pre class="programlisting"><span class="returnvalue">void</span>
|
|
393
393
|
g_subprocess_launcher_setenv (<em class="parameter"><code><a class="link" href="GSubprocessLauncher.html" title="GSubprocess Launcher"><span class="type">GSubprocessLauncher</span></a> *self</code></em>,
|
|
394
|
-
<em class="parameter"><code>const <a href="../glib
|
|
395
|
-
<em class="parameter"><code>const <a href="../glib
|
|
396
|
-
<em class="parameter"><code><a href="../glib
|
|
394
|
+
<em class="parameter"><code>const <a href="../glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *variable</code></em>,
|
|
395
|
+
<em class="parameter"><code>const <a href="../glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *value</code></em>,
|
|
396
|
+
<em class="parameter"><code><a href="../glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> overwrite</code></em>);</pre>
|
|
397
397
|
<p>Sets the environment variable <em class="parameter"><code>variable</code></em>
|
|
398
398
|
in the environment of
|
|
399
399
|
processes launched from this launcher.</p>
|
|
@@ -401,7 +401,7 @@ processes launched from this launcher.</p>
|
|
|
401
401
|
strings, except that the variable's name cannot contain '='.
|
|
402
402
|
On Windows, they should be in UTF-8.</p>
|
|
403
403
|
<div class="refsect3">
|
|
404
|
-
<a name="
|
|
404
|
+
<a name="g-subprocess-launcher-setenv.parameters"></a><h4>Parameters</h4>
|
|
405
405
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
|
406
406
|
<colgroup>
|
|
407
407
|
<col width="150px" class="parameters_name">
|
|
@@ -439,14 +439,14 @@ On Windows, they should be in UTF-8.</p>
|
|
|
439
439
|
<a name="g-subprocess-launcher-unsetenv"></a><h3>g_subprocess_launcher_unsetenv ()</h3>
|
|
440
440
|
<pre class="programlisting"><span class="returnvalue">void</span>
|
|
441
441
|
g_subprocess_launcher_unsetenv (<em class="parameter"><code><a class="link" href="GSubprocessLauncher.html" title="GSubprocess Launcher"><span class="type">GSubprocessLauncher</span></a> *self</code></em>,
|
|
442
|
-
<em class="parameter"><code>const <a href="../glib
|
|
442
|
+
<em class="parameter"><code>const <a href="../glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *variable</code></em>);</pre>
|
|
443
443
|
<p>Removes the environment variable <em class="parameter"><code>variable</code></em>
|
|
444
444
|
from the environment of
|
|
445
445
|
processes launched from this launcher.</p>
|
|
446
446
|
<p>On UNIX, the variable's name can be an arbitrary byte string not
|
|
447
447
|
containing '='. On Windows, it should be in UTF-8.</p>
|
|
448
448
|
<div class="refsect3">
|
|
449
|
-
<a name="
|
|
449
|
+
<a name="g-subprocess-launcher-unsetenv.parameters"></a><h4>Parameters</h4>
|
|
450
450
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
|
451
451
|
<colgroup>
|
|
452
452
|
<col width="150px" class="parameters_name">
|
|
@@ -472,16 +472,16 @@ containing '='. On Windows, it should be in UTF-8.</p>
|
|
|
472
472
|
<hr>
|
|
473
473
|
<div class="refsect2">
|
|
474
474
|
<a name="g-subprocess-launcher-getenv"></a><h3>g_subprocess_launcher_getenv ()</h3>
|
|
475
|
-
<pre class="programlisting">const <a href="../glib
|
|
475
|
+
<pre class="programlisting">const <a href="../glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
|
|
476
476
|
g_subprocess_launcher_getenv (<em class="parameter"><code><a class="link" href="GSubprocessLauncher.html" title="GSubprocess Launcher"><span class="type">GSubprocessLauncher</span></a> *self</code></em>,
|
|
477
|
-
<em class="parameter"><code>const <a href="../glib
|
|
477
|
+
<em class="parameter"><code>const <a href="../glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *variable</code></em>);</pre>
|
|
478
478
|
<p>Returns the value of the environment variable <em class="parameter"><code>variable</code></em>
|
|
479
479
|
in the
|
|
480
480
|
environment of processes launched from this launcher.</p>
|
|
481
481
|
<p>On UNIX, the returned string can be an arbitrary byte string.
|
|
482
482
|
On Windows, it will be UTF-8.</p>
|
|
483
483
|
<div class="refsect3">
|
|
484
|
-
<a name="
|
|
484
|
+
<a name="g-subprocess-launcher-getenv.parameters"></a><h4>Parameters</h4>
|
|
485
485
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
|
486
486
|
<colgroup>
|
|
487
487
|
<col width="150px" class="parameters_name">
|
|
@@ -503,8 +503,8 @@ On Windows, it will be UTF-8.</p>
|
|
|
503
503
|
</table></div>
|
|
504
504
|
</div>
|
|
505
505
|
<div class="refsect3">
|
|
506
|
-
<a name="
|
|
507
|
-
<p> the value of the environment variable, <a href="../glib
|
|
506
|
+
<a name="g-subprocess-launcher-getenv.returns"></a><h4>Returns</h4>
|
|
507
|
+
<p> the value of the environment variable, <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if unset</p>
|
|
508
508
|
</div>
|
|
509
509
|
<p class="since">Since: <a class="link" href="api-index-2-40.html#api-index-2.40">2.40</a></p>
|
|
510
510
|
</div>
|
|
@@ -513,13 +513,13 @@ On Windows, it will be UTF-8.</p>
|
|
|
513
513
|
<a name="g-subprocess-launcher-set-cwd"></a><h3>g_subprocess_launcher_set_cwd ()</h3>
|
|
514
514
|
<pre class="programlisting"><span class="returnvalue">void</span>
|
|
515
515
|
g_subprocess_launcher_set_cwd (<em class="parameter"><code><a class="link" href="GSubprocessLauncher.html" title="GSubprocess Launcher"><span class="type">GSubprocessLauncher</span></a> *self</code></em>,
|
|
516
|
-
<em class="parameter"><code>const <a href="../glib
|
|
516
|
+
<em class="parameter"><code>const <a href="../glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *cwd</code></em>);</pre>
|
|
517
517
|
<p>Sets the current working directory that processes will be launched
|
|
518
518
|
with.</p>
|
|
519
519
|
<p>By default processes are launched with the current working directory
|
|
520
520
|
of the launching process at the time of launch.</p>
|
|
521
521
|
<div class="refsect3">
|
|
522
|
-
<a name="
|
|
522
|
+
<a name="g-subprocess-launcher-set-cwd.parameters"></a><h4>Parameters</h4>
|
|
523
523
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
|
524
524
|
<colgroup>
|
|
525
525
|
<col width="150px" class="parameters_name">
|
|
@@ -558,7 +558,7 @@ handle a particular stdio stream (eg: specifying both
|
|
|
558
558
|
function like <a class="link" href="GSubprocessLauncher.html#g-subprocess-launcher-set-stdin-file-path" title="g_subprocess_launcher_set_stdin_file_path ()"><code class="function">g_subprocess_launcher_set_stdin_file_path()</code></a> or
|
|
559
559
|
<a class="link" href="GSubprocessLauncher.html#g-subprocess-launcher-take-stdout-fd" title="g_subprocess_launcher_take_stdout_fd ()"><code class="function">g_subprocess_launcher_take_stdout_fd()</code></a>.</p>
|
|
560
560
|
<div class="refsect3">
|
|
561
|
-
<a name="
|
|
561
|
+
<a name="g-subprocess-launcher-set-flags.parameters"></a><h4>Parameters</h4>
|
|
562
562
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
|
563
563
|
<colgroup>
|
|
564
564
|
<col width="150px" class="parameters_name">
|
|
@@ -587,16 +587,16 @@ function like <a class="link" href="GSubprocessLauncher.html#g-subprocess-launch
|
|
|
587
587
|
<pre class="programlisting"><span class="returnvalue">void</span>
|
|
588
588
|
g_subprocess_launcher_set_stdin_file_path
|
|
589
589
|
(<em class="parameter"><code><a class="link" href="GSubprocessLauncher.html" title="GSubprocess Launcher"><span class="type">GSubprocessLauncher</span></a> *self</code></em>,
|
|
590
|
-
<em class="parameter"><code>const <a href="../glib
|
|
590
|
+
<em class="parameter"><code>const <a href="../glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *path</code></em>);</pre>
|
|
591
591
|
<p>Sets the file path to use as the stdin for spawned processes.</p>
|
|
592
592
|
<p>If <em class="parameter"><code>path</code></em>
|
|
593
|
-
is <a href="../glib
|
|
593
|
+
is <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> then any previously given path is unset.</p>
|
|
594
594
|
<p>The file must exist or spawning the process will fail.</p>
|
|
595
595
|
<p>You may not set a stdin file path if a stdin fd is already set or if
|
|
596
596
|
the launcher flags contain any flags directing stdin elsewhere.</p>
|
|
597
597
|
<p>This feature is only available on UNIX.</p>
|
|
598
598
|
<div class="refsect3">
|
|
599
|
-
<a name="
|
|
599
|
+
<a name="g-subprocess-launcher-set-stdin-file-path.parameters"></a><h4>Parameters</h4>
|
|
600
600
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
|
601
601
|
<colgroup>
|
|
602
602
|
<col width="150px" class="parameters_name">
|
|
@@ -611,7 +611,7 @@ the launcher flags contain any flags directing stdin elsewhere.</p>
|
|
|
611
611
|
</tr>
|
|
612
612
|
<tr>
|
|
613
613
|
<td class="parameter_name"><p>path</p></td>
|
|
614
|
-
<td class="parameter_description"><p>a filename or <a href="../glib
|
|
614
|
+
<td class="parameter_description"><p>a filename or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
|
|
615
615
|
<td class="parameter_annotations"> </td>
|
|
616
616
|
</tr>
|
|
617
617
|
</tbody>
|
|
@@ -624,7 +624,7 @@ the launcher flags contain any flags directing stdin elsewhere.</p>
|
|
|
624
624
|
<a name="g-subprocess-launcher-take-stdin-fd"></a><h3>g_subprocess_launcher_take_stdin_fd ()</h3>
|
|
625
625
|
<pre class="programlisting"><span class="returnvalue">void</span>
|
|
626
626
|
g_subprocess_launcher_take_stdin_fd (<em class="parameter"><code><a class="link" href="GSubprocessLauncher.html" title="GSubprocess Launcher"><span class="type">GSubprocessLauncher</span></a> *self</code></em>,
|
|
627
|
-
<em class="parameter"><code><a href="../glib
|
|
627
|
+
<em class="parameter"><code><a href="../glib-Basic-Types.html#gint"><span class="type">gint</span></a> fd</code></em>);</pre>
|
|
628
628
|
<p>Sets the file descriptor to use as the stdin for spawned processes.</p>
|
|
629
629
|
<p>If <em class="parameter"><code>fd</code></em>
|
|
630
630
|
is -1 then any previously given fd is unset.</p>
|
|
@@ -641,7 +641,7 @@ O_CLOEXEC if that's what you want.</p>
|
|
|
641
641
|
the launcher flags contain any flags directing stdin elsewhere.</p>
|
|
642
642
|
<p>This feature is only available on UNIX.</p>
|
|
643
643
|
<div class="refsect3">
|
|
644
|
-
<a name="
|
|
644
|
+
<a name="g-subprocess-launcher-take-stdin-fd.parameters"></a><h4>Parameters</h4>
|
|
645
645
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
|
646
646
|
<colgroup>
|
|
647
647
|
<col width="150px" class="parameters_name">
|
|
@@ -670,17 +670,17 @@ the launcher flags contain any flags directing stdin elsewhere.</p>
|
|
|
670
670
|
<pre class="programlisting"><span class="returnvalue">void</span>
|
|
671
671
|
g_subprocess_launcher_set_stdout_file_path
|
|
672
672
|
(<em class="parameter"><code><a class="link" href="GSubprocessLauncher.html" title="GSubprocess Launcher"><span class="type">GSubprocessLauncher</span></a> *self</code></em>,
|
|
673
|
-
<em class="parameter"><code>const <a href="../glib
|
|
673
|
+
<em class="parameter"><code>const <a href="../glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *path</code></em>);</pre>
|
|
674
674
|
<p>Sets the file path to use as the stdout for spawned processes.</p>
|
|
675
675
|
<p>If <em class="parameter"><code>path</code></em>
|
|
676
|
-
is <a href="../glib
|
|
676
|
+
is <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> then any previously given path is unset.</p>
|
|
677
677
|
<p>The file will be created or truncated when the process is spawned, as
|
|
678
678
|
would be the case if using '>' at the shell.</p>
|
|
679
679
|
<p>You may not set a stdout file path if a stdout fd is already set or
|
|
680
680
|
if the launcher flags contain any flags directing stdout elsewhere.</p>
|
|
681
681
|
<p>This feature is only available on UNIX.</p>
|
|
682
682
|
<div class="refsect3">
|
|
683
|
-
<a name="
|
|
683
|
+
<a name="g-subprocess-launcher-set-stdout-file-path.parameters"></a><h4>Parameters</h4>
|
|
684
684
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
|
685
685
|
<colgroup>
|
|
686
686
|
<col width="150px" class="parameters_name">
|
|
@@ -695,7 +695,7 @@ if the launcher flags contain any flags directing stdout elsewhere.</p>
|
|
|
695
695
|
</tr>
|
|
696
696
|
<tr>
|
|
697
697
|
<td class="parameter_name"><p>path</p></td>
|
|
698
|
-
<td class="parameter_description"><p>a filename or <a href="../glib
|
|
698
|
+
<td class="parameter_description"><p>a filename or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
|
|
699
699
|
<td class="parameter_annotations"> </td>
|
|
700
700
|
</tr>
|
|
701
701
|
</tbody>
|
|
@@ -708,7 +708,7 @@ if the launcher flags contain any flags directing stdout elsewhere.</p>
|
|
|
708
708
|
<a name="g-subprocess-launcher-take-stdout-fd"></a><h3>g_subprocess_launcher_take_stdout_fd ()</h3>
|
|
709
709
|
<pre class="programlisting"><span class="returnvalue">void</span>
|
|
710
710
|
g_subprocess_launcher_take_stdout_fd (<em class="parameter"><code><a class="link" href="GSubprocessLauncher.html" title="GSubprocess Launcher"><span class="type">GSubprocessLauncher</span></a> *self</code></em>,
|
|
711
|
-
<em class="parameter"><code><a href="../glib
|
|
711
|
+
<em class="parameter"><code><a href="../glib-Basic-Types.html#gint"><span class="type">gint</span></a> fd</code></em>);</pre>
|
|
712
712
|
<p>Sets the file descriptor to use as the stdout for spawned processes.</p>
|
|
713
713
|
<p>If <em class="parameter"><code>fd</code></em>
|
|
714
714
|
is -1 then any previously given fd is unset.</p>
|
|
@@ -724,7 +724,7 @@ O_CLOEXEC if that's what you want.</p>
|
|
|
724
724
|
if the launcher flags contain any flags directing stdout elsewhere.</p>
|
|
725
725
|
<p>This feature is only available on UNIX.</p>
|
|
726
726
|
<div class="refsect3">
|
|
727
|
-
<a name="
|
|
727
|
+
<a name="g-subprocess-launcher-take-stdout-fd.parameters"></a><h4>Parameters</h4>
|
|
728
728
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
|
729
729
|
<colgroup>
|
|
730
730
|
<col width="150px" class="parameters_name">
|
|
@@ -753,10 +753,10 @@ if the launcher flags contain any flags directing stdout elsewhere.</p>
|
|
|
753
753
|
<pre class="programlisting"><span class="returnvalue">void</span>
|
|
754
754
|
g_subprocess_launcher_set_stderr_file_path
|
|
755
755
|
(<em class="parameter"><code><a class="link" href="GSubprocessLauncher.html" title="GSubprocess Launcher"><span class="type">GSubprocessLauncher</span></a> *self</code></em>,
|
|
756
|
-
<em class="parameter"><code>const <a href="../glib
|
|
756
|
+
<em class="parameter"><code>const <a href="../glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *path</code></em>);</pre>
|
|
757
757
|
<p>Sets the file path to use as the stderr for spawned processes.</p>
|
|
758
758
|
<p>If <em class="parameter"><code>path</code></em>
|
|
759
|
-
is <a href="../glib
|
|
759
|
+
is <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> then any previously given path is unset.</p>
|
|
760
760
|
<p>The file will be created or truncated when the process is spawned, as
|
|
761
761
|
would be the case if using '2>' at the shell.</p>
|
|
762
762
|
<p>If you want to send both stdout and stderr to the same file then use
|
|
@@ -765,7 +765,7 @@ would be the case if using '2>' at the shell.</p>
|
|
|
765
765
|
if the launcher flags contain any flags directing stderr elsewhere.</p>
|
|
766
766
|
<p>This feature is only available on UNIX.</p>
|
|
767
767
|
<div class="refsect3">
|
|
768
|
-
<a name="
|
|
768
|
+
<a name="g-subprocess-launcher-set-stderr-file-path.parameters"></a><h4>Parameters</h4>
|
|
769
769
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
|
770
770
|
<colgroup>
|
|
771
771
|
<col width="150px" class="parameters_name">
|
|
@@ -780,7 +780,7 @@ if the launcher flags contain any flags directing stderr elsewhere.</p>
|
|
|
780
780
|
</tr>
|
|
781
781
|
<tr>
|
|
782
782
|
<td class="parameter_name"><p>path</p></td>
|
|
783
|
-
<td class="parameter_description"><p>a filename or <a href="../glib
|
|
783
|
+
<td class="parameter_description"><p>a filename or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
|
|
784
784
|
<td class="parameter_annotations"> </td>
|
|
785
785
|
</tr>
|
|
786
786
|
</tbody>
|
|
@@ -793,7 +793,7 @@ if the launcher flags contain any flags directing stderr elsewhere.</p>
|
|
|
793
793
|
<a name="g-subprocess-launcher-take-stderr-fd"></a><h3>g_subprocess_launcher_take_stderr_fd ()</h3>
|
|
794
794
|
<pre class="programlisting"><span class="returnvalue">void</span>
|
|
795
795
|
g_subprocess_launcher_take_stderr_fd (<em class="parameter"><code><a class="link" href="GSubprocessLauncher.html" title="GSubprocess Launcher"><span class="type">GSubprocessLauncher</span></a> *self</code></em>,
|
|
796
|
-
<em class="parameter"><code><a href="../glib
|
|
796
|
+
<em class="parameter"><code><a href="../glib-Basic-Types.html#gint"><span class="type">gint</span></a> fd</code></em>);</pre>
|
|
797
797
|
<p>Sets the file descriptor to use as the stderr for spawned processes.</p>
|
|
798
798
|
<p>If <em class="parameter"><code>fd</code></em>
|
|
799
799
|
is -1 then any previously given fd is unset.</p>
|
|
@@ -808,7 +808,7 @@ spawned process.</p>
|
|
|
808
808
|
if the launcher flags contain any flags directing stderr elsewhere.</p>
|
|
809
809
|
<p>This feature is only available on UNIX.</p>
|
|
810
810
|
<div class="refsect3">
|
|
811
|
-
<a name="
|
|
811
|
+
<a name="g-subprocess-launcher-take-stderr-fd.parameters"></a><h4>Parameters</h4>
|
|
812
812
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
|
813
813
|
<colgroup>
|
|
814
814
|
<col width="150px" class="parameters_name">
|
|
@@ -836,8 +836,8 @@ if the launcher flags contain any flags directing stderr elsewhere.</p>
|
|
|
836
836
|
<a name="g-subprocess-launcher-take-fd"></a><h3>g_subprocess_launcher_take_fd ()</h3>
|
|
837
837
|
<pre class="programlisting"><span class="returnvalue">void</span>
|
|
838
838
|
g_subprocess_launcher_take_fd (<em class="parameter"><code><a class="link" href="GSubprocessLauncher.html" title="GSubprocess Launcher"><span class="type">GSubprocessLauncher</span></a> *self</code></em>,
|
|
839
|
-
<em class="parameter"><code><a href="../glib
|
|
840
|
-
<em class="parameter"><code><a href="../glib
|
|
839
|
+
<em class="parameter"><code><a href="../glib-Basic-Types.html#gint"><span class="type">gint</span></a> source_fd</code></em>,
|
|
840
|
+
<em class="parameter"><code><a href="../glib-Basic-Types.html#gint"><span class="type">gint</span></a> target_fd</code></em>);</pre>
|
|
841
841
|
<p>Transfer an arbitrary file descriptor from parent process to the
|
|
842
842
|
child. This function takes "ownership" of the fd; it will be closed
|
|
843
843
|
in the parent when <em class="parameter"><code>self</code></em>
|
|
@@ -850,7 +850,7 @@ descriptor in the child.</p>
|
|
|
850
850
|
--passphrase-fd providing a file descriptor number where it expects
|
|
851
851
|
the passphrase to be written.</p>
|
|
852
852
|
<div class="refsect3">
|
|
853
|
-
<a name="
|
|
853
|
+
<a name="g-subprocess-launcher-take-fd.parameters"></a><h4>Parameters</h4>
|
|
854
854
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
|
855
855
|
<colgroup>
|
|
856
856
|
<col width="150px" class="parameters_name">
|
|
@@ -882,9 +882,9 @@ the passphrase to be written.</p>
|
|
|
882
882
|
<a name="g-subprocess-launcher-set-child-setup"></a><h3>g_subprocess_launcher_set_child_setup ()</h3>
|
|
883
883
|
<pre class="programlisting"><span class="returnvalue">void</span>
|
|
884
884
|
g_subprocess_launcher_set_child_setup (<em class="parameter"><code><a class="link" href="GSubprocessLauncher.html" title="GSubprocess Launcher"><span class="type">GSubprocessLauncher</span></a> *self</code></em>,
|
|
885
|
-
<em class="parameter"><code><a href="../glib
|
|
886
|
-
<em class="parameter"><code><a href="../glib
|
|
887
|
-
<em class="parameter"><code><a href="../glib
|
|
885
|
+
<em class="parameter"><code><a href="../glib-Spawning-Processes.html#GSpawnChildSetupFunc"><span class="type">GSpawnChildSetupFunc</span></a> child_setup</code></em>,
|
|
886
|
+
<em class="parameter"><code><a href="../glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
|
|
887
|
+
<em class="parameter"><code><a href="../glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy_notify</code></em>);</pre>
|
|
888
888
|
<p>Sets up a child setup function.</p>
|
|
889
889
|
<p>The child setup function will be called after <code class="function">fork()</code> but before
|
|
890
890
|
<code class="function">exec()</code> on the child's side.</p>
|
|
@@ -893,11 +893,11 @@ g_subprocess_launcher_set_child_setup (<em class="parameter"><code><a class="lin
|
|
|
893
893
|
of the <code class="function">fork()</code>. It will only be called when the last reference on the
|
|
894
894
|
<a class="link" href="GSubprocessLauncher.html" title="GSubprocess Launcher"><span class="type">GSubprocessLauncher</span></a> is dropped or when a new child setup function is
|
|
895
895
|
given.</p>
|
|
896
|
-
<p><a href="../glib
|
|
896
|
+
<p><a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> can be given as <em class="parameter"><code>child_setup</code></em>
|
|
897
897
|
to disable the functionality.</p>
|
|
898
898
|
<p>Child setup functions are only available on UNIX.</p>
|
|
899
899
|
<div class="refsect3">
|
|
900
|
-
<a name="
|
|
900
|
+
<a name="g-subprocess-launcher-set-child-setup.parameters"></a><h4>Parameters</h4>
|
|
901
901
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
|
902
902
|
<colgroup>
|
|
903
903
|
<col width="150px" class="parameters_name">
|
|
@@ -912,7 +912,7 @@ given.</p>
|
|
|
912
912
|
</tr>
|
|
913
913
|
<tr>
|
|
914
914
|
<td class="parameter_name"><p>child_setup</p></td>
|
|
915
|
-
<td class="parameter_description"><p>a <a href="../glib
|
|
915
|
+
<td class="parameter_description"><p>a <a href="../glib-Spawning-Processes.html#GSpawnChildSetupFunc"><span class="type">GSpawnChildSetupFunc</span></a> to use as the child setup function</p></td>
|
|
916
916
|
<td class="parameter_annotations"> </td>
|
|
917
917
|
</tr>
|
|
918
918
|
<tr>
|
|
@@ -923,7 +923,7 @@ given.</p>
|
|
|
923
923
|
</tr>
|
|
924
924
|
<tr>
|
|
925
925
|
<td class="parameter_name"><p>destroy_notify</p></td>
|
|
926
|
-
<td class="parameter_description"><p>a <a href="../glib
|
|
926
|
+
<td class="parameter_description"><p>a <a href="../glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> for <em class="parameter"><code>user_data</code></em>
|
|
927
927
|
</p></td>
|
|
928
928
|
<td class="parameter_annotations"> </td>
|
|
929
929
|
</tr>
|
|
@@ -953,6 +953,6 @@ given.</p>
|
|
|
953
953
|
</div>
|
|
954
954
|
</div>
|
|
955
955
|
<div class="footer">
|
|
956
|
-
<hr>Generated by GTK-Doc V1.
|
|
956
|
+
<hr>Generated by GTK-Doc V1.25.1</div>
|
|
957
957
|
</body>
|
|
958
958
|
</html>
|
|
@@ -8,7 +8,7 @@
|
|
|
8
8
|
<link rel="up" href="async.html" title="Asynchronous I/O">
|
|
9
9
|
<link rel="prev" href="GAsyncResult.html" title="GAsyncResult">
|
|
10
10
|
<link rel="next" href="gio-GIOScheduler.html" title="GIOScheduler">
|
|
11
|
-
<meta name="generator" content="GTK-Doc V1.
|
|
11
|
+
<meta name="generator" content="GTK-Doc V1.25.1 (XML mode)">
|
|
12
12
|
<link rel="stylesheet" href="style.css" type="text/css">
|
|
13
13
|
</head>
|
|
14
14
|
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
|
|
@@ -77,7 +77,7 @@
|
|
|
77
77
|
</tr>
|
|
78
78
|
<tr>
|
|
79
79
|
<td class="function_type">
|
|
80
|
-
<a href="../glib
|
|
80
|
+
<a href="../glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
|
|
81
81
|
</td>
|
|
82
82
|
<td class="function_name">
|
|
83
83
|
<a class="link" href="GTask.html#g-task-set-return-on-cancel" title="g_task_set_return_on_cancel ()">g_task_set_return_on_cancel</a> <span class="c_punctuation">()</span>
|
|
@@ -109,7 +109,7 @@
|
|
|
109
109
|
</tr>
|
|
110
110
|
<tr>
|
|
111
111
|
<td class="function_type">
|
|
112
|
-
<a href="../glib
|
|
112
|
+
<a href="../glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a>
|
|
113
113
|
</td>
|
|
114
114
|
<td class="function_name">
|
|
115
115
|
<a class="link" href="GTask.html#g-task-get-task-data" title="g_task_get_task_data ()">g_task_get_task_data</a> <span class="c_punctuation">()</span>
|
|
@@ -117,7 +117,7 @@
|
|
|
117
117
|
</tr>
|
|
118
118
|
<tr>
|
|
119
119
|
<td class="function_type">
|
|
120
|
-
<a href="../glib
|
|
120
|
+
<a href="../glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
|
|
121
121
|
</td>
|
|
122
122
|
<td class="function_name">
|
|
123
123
|
<a class="link" href="GTask.html#g-task-get-priority" title="g_task_get_priority ()">g_task_get_priority</a> <span class="c_punctuation">()</span>
|
|
@@ -133,7 +133,7 @@
|
|
|
133
133
|
</tr>
|
|
134
134
|
<tr>
|
|
135
135
|
<td class="function_type">
|
|
136
|
-
<a href="../glib
|
|
136
|
+
<a href="../glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
|
|
137
137
|
</td>
|
|
138
138
|
<td class="function_name">
|
|
139
139
|
<a class="link" href="GTask.html#g-task-get-check-cancellable" title="g_task_get_check_cancellable ()">g_task_get_check_cancellable</a> <span class="c_punctuation">()</span>
|
|
@@ -141,7 +141,7 @@
|
|
|
141
141
|
</tr>
|
|
142
142
|
<tr>
|
|
143
143
|
<td class="function_type">
|
|
144
|
-
<a href="../glib
|
|
144
|
+
<a href="../glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
|
|
145
145
|
</td>
|
|
146
146
|
<td class="function_name">
|
|
147
147
|
<a class="link" href="GTask.html#g-task-get-return-on-cancel" title="g_task_get_return_on_cancel ()">g_task_get_return_on_cancel</a> <span class="c_punctuation">()</span>
|
|
@@ -149,7 +149,7 @@
|
|
|
149
149
|
</tr>
|
|
150
150
|
<tr>
|
|
151
151
|
<td class="function_type">
|
|
152
|
-
<a href="../glib
|
|
152
|
+
<a href="../glib-The-Main-Event-Loop.html#GMainContext"><span class="returnvalue">GMainContext</span></a> *
|
|
153
153
|
</td>
|
|
154
154
|
<td class="function_name">
|
|
155
155
|
<a class="link" href="GTask.html#g-task-get-context" title="g_task_get_context ()">g_task_get_context</a> <span class="c_punctuation">()</span>
|
|
@@ -157,7 +157,7 @@
|
|
|
157
157
|
</tr>
|
|
158
158
|
<tr>
|
|
159
159
|
<td class="function_type">
|
|
160
|
-
<a href="../glib
|
|
160
|
+
<a href="../glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a>
|
|
161
161
|
</td>
|
|
162
162
|
<td class="function_name">
|
|
163
163
|
<a class="link" href="GTask.html#g-task-get-source-object" title="g_task_get_source_object ()">g_task_get_source_object</a> <span class="c_punctuation">()</span>
|
|
@@ -165,7 +165,7 @@
|
|
|
165
165
|
</tr>
|
|
166
166
|
<tr>
|
|
167
167
|
<td class="function_type">
|
|
168
|
-
<a href="../glib
|
|
168
|
+
<a href="../glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a>
|
|
169
169
|
</td>
|
|
170
170
|
<td class="function_name">
|
|
171
171
|
<a class="link" href="GTask.html#g-task-get-source-tag" title="g_task_get_source_tag ()">g_task_get_source_tag</a> <span class="c_punctuation">()</span>
|
|
@@ -213,7 +213,7 @@
|
|
|
213
213
|
</tr>
|
|
214
214
|
<tr>
|
|
215
215
|
<td class="function_type">
|
|
216
|
-
<a href="../glib
|
|
216
|
+
<a href="../glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
|
|
217
217
|
</td>
|
|
218
218
|
<td class="function_name">
|
|
219
219
|
<a class="link" href="GTask.html#g-task-return-error-if-cancelled" title="g_task_return_error_if_cancelled ()">g_task_return_error_if_cancelled</a> <span class="c_punctuation">()</span>
|
|
@@ -221,7 +221,7 @@
|
|
|
221
221
|
</tr>
|
|
222
222
|
<tr>
|
|
223
223
|
<td class="function_type">
|
|
224
|
-
<a href="../glib
|
|
224
|
+
<a href="../glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
|
|
225
225
|
</td>
|
|
226
226
|
<td class="function_name">
|
|
227
227
|
<a class="link" href="GTask.html#g-task-propagate-boolean" title="g_task_propagate_boolean ()">g_task_propagate_boolean</a> <span class="c_punctuation">()</span>
|
|
@@ -229,7 +229,7 @@
|
|
|
229
229
|
</tr>
|
|
230
230
|
<tr>
|
|
231
231
|
<td class="function_type">
|
|
232
|
-
<a href="../glib
|
|
232
|
+
<a href="../glib-Basic-Types.html#gssize"><span class="returnvalue">gssize</span></a>
|
|
233
233
|
</td>
|
|
234
234
|
<td class="function_name">
|
|
235
235
|
<a class="link" href="GTask.html#g-task-propagate-int" title="g_task_propagate_int ()">g_task_propagate_int</a> <span class="c_punctuation">()</span>
|
|
@@ -237,7 +237,7 @@
|
|
|
237
237
|
</tr>
|
|
238
238
|
<tr>
|
|
239
239
|
<td class="function_type">
|
|
240
|
-
<a href="../glib
|
|
240
|
+
<a href="../glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a>
|
|
241
241
|
</td>
|
|
242
242
|
<td class="function_name">
|
|
243
243
|
<a class="link" href="GTask.html#g-task-propagate-pointer" title="g_task_propagate_pointer ()">g_task_propagate_pointer</a> <span class="c_punctuation">()</span>
|
|
@@ -245,7 +245,7 @@
|
|
|
245
245
|
</tr>
|
|
246
246
|
<tr>
|
|
247
247
|
<td class="function_type">
|
|
248
|
-
<a href="../glib
|
|
248
|
+
<a href="../glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
|
|
249
249
|
</td>
|
|
250
250
|
<td class="function_name">
|
|
251
251
|
<a class="link" href="GTask.html#g-task-had-error" title="g_task_had_error ()">g_task_had_error</a> <span class="c_punctuation">()</span>
|
|
@@ -253,7 +253,7 @@
|
|
|
253
253
|
</tr>
|
|
254
254
|
<tr>
|
|
255
255
|
<td class="function_type">
|
|
256
|
-
<a href="../glib
|
|
256
|
+
<a href="../glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
|
|
257
257
|
</td>
|
|
258
258
|
<td class="function_name">
|
|
259
259
|
<a class="link" href="GTask.html#g-task-get-completed" title="g_task_get_completed ()">g_task_get_completed</a> <span class="c_punctuation">()</span>
|
|
@@ -293,7 +293,7 @@
|
|
|
293
293
|
</tr>
|
|
294
294
|
<tr>
|
|
295
295
|
<td class="function_type">
|
|
296
|
-
<a href="../glib
|
|
296
|
+
<a href="../glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
|
|
297
297
|
</td>
|
|
298
298
|
<td class="function_name">
|
|
299
299
|
<a class="link" href="GTask.html#g-task-is-valid" title="g_task_is_valid ()">g_task_is_valid</a> <span class="c_punctuation">()</span>
|
|
@@ -311,7 +311,7 @@
|
|
|
311
311
|
<col width="200px" class="properties_flags">
|
|
312
312
|
</colgroup>
|
|
313
313
|
<tbody><tr>
|
|
314
|
-
<td class="property_type"><a href="../glib
|
|
314
|
+
<td class="property_type"><a href="../glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></td>
|
|
315
315
|
<td class="property_name"><a class="link" href="GTask.html#GTask--completed" title="The “completed” property">completed</a></td>
|
|
316
316
|
<td class="property_flags">Read</td>
|
|
317
317
|
</tr></tbody>
|
|
@@ -332,7 +332,7 @@
|
|
|
332
332
|
</div>
|
|
333
333
|
<div class="refsect1">
|
|
334
334
|
<a name="GTask.object-hierarchy"></a><h2>Object Hierarchy</h2>
|
|
335
|
-
<pre class="screen"> <a href="../gobject
|
|
335
|
+
<pre class="screen"> <a href="../gobject-The-Base-Object-Type.html#GObject-struct">GObject</a>
|
|
336
336
|
<span class="lineart">╰──</span> GTask
|
|
337
337
|
</pre>
|
|
338
338
|
</div>
|
|
@@ -470,8 +470,8 @@ the return value.</p>
|
|
|
470
470
|
<span class="gtkdoc kwb">static void</span>
|
|
471
471
|
<span class="function">decoration_data_free</span> <span class="gtkdoc opt">(</span>DecorationData <span class="gtkdoc opt">*</span>decoration<span class="gtkdoc opt">)</span>
|
|
472
472
|
<span class="gtkdoc opt">{</span>
|
|
473
|
-
<span class="function"><a href="../glib
|
|
474
|
-
<span class="function"><a href="../glib
|
|
473
|
+
<span class="function"><a href="../glib-Memory-Allocation.html#g-free">g_free</a></span> <span class="gtkdoc opt">(</span>decoration<span class="gtkdoc opt">-></span>message<span class="gtkdoc opt">);</span>
|
|
474
|
+
<span class="function"><a href="../glib-Memory-Slices.html#g-slice-free">g_slice_free</a></span> <span class="gtkdoc opt">(</span>DecorationData<span class="gtkdoc opt">,</span> decoration<span class="gtkdoc opt">);</span>
|
|
475
475
|
<span class="gtkdoc opt">}</span>
|
|
476
476
|
|
|
477
477
|
<span class="gtkdoc kwb">static void</span>
|
|
@@ -486,21 +486,21 @@ the return value.</p>
|
|
|
486
486
|
<span class="gtkdoc opt">{</span>
|
|
487
487
|
<span class="function"><a href="GTask.html#g-task-return-new-error">g_task_return_new_error</a></span> <span class="gtkdoc opt">(</span>task<span class="gtkdoc opt">,</span> BAKER_ERROR<span class="gtkdoc opt">,</span> BAKER_ERROR_NO_FLOUR<span class="gtkdoc opt">,</span>
|
|
488
488
|
<span class="string">"Go to the supermarket"</span><span class="gtkdoc opt">);</span>
|
|
489
|
-
<span class="function"><a href="../gobject
|
|
489
|
+
<span class="function"><a href="../gobject-The-Base-Object-Type.html#g-object-unref">g_object_unref</a></span> <span class="gtkdoc opt">(</span>task<span class="gtkdoc opt">);</span>
|
|
490
490
|
<span class="keyword">return</span><span class="gtkdoc opt">;</span>
|
|
491
491
|
<span class="gtkdoc opt">}</span>
|
|
492
492
|
|
|
493
493
|
<span class="keyword">if</span> <span class="gtkdoc opt">(!</span><span class="function">cake_decorate</span> <span class="gtkdoc opt">(</span>cake<span class="gtkdoc opt">,</span> decoration<span class="gtkdoc opt">-></span>frosting<span class="gtkdoc opt">,</span> decoration<span class="gtkdoc opt">-></span>message<span class="gtkdoc opt">, &</span>error<span class="gtkdoc opt">))</span>
|
|
494
494
|
<span class="gtkdoc opt">{</span>
|
|
495
|
-
<span class="function"><a href="../gobject
|
|
495
|
+
<span class="function"><a href="../gobject-The-Base-Object-Type.html#g-object-unref">g_object_unref</a></span> <span class="gtkdoc opt">(</span>cake<span class="gtkdoc opt">);</span>
|
|
496
496
|
<span class="gtkdoc slc">// g_task_return_error() takes ownership of error</span>
|
|
497
497
|
<span class="function"><a href="GTask.html#g-task-return-error">g_task_return_error</a></span> <span class="gtkdoc opt">(</span>task<span class="gtkdoc opt">,</span> error<span class="gtkdoc opt">);</span>
|
|
498
|
-
<span class="function"><a href="../gobject
|
|
498
|
+
<span class="function"><a href="../gobject-The-Base-Object-Type.html#g-object-unref">g_object_unref</a></span> <span class="gtkdoc opt">(</span>task<span class="gtkdoc opt">);</span>
|
|
499
499
|
<span class="keyword">return</span><span class="gtkdoc opt">;</span>
|
|
500
500
|
<span class="gtkdoc opt">}</span>
|
|
501
501
|
|
|
502
502
|
<span class="function"><a href="GTask.html#g-task-return-pointer">g_task_return_pointer</a></span> <span class="gtkdoc opt">(</span>task<span class="gtkdoc opt">,</span> cake<span class="gtkdoc opt">,</span> g_object_unref<span class="gtkdoc opt">);</span>
|
|
503
|
-
<span class="function"><a href="../gobject
|
|
503
|
+
<span class="function"><a href="../gobject-The-Base-Object-Type.html#g-object-unref">g_object_unref</a></span> <span class="gtkdoc opt">(</span>task<span class="gtkdoc opt">);</span>
|
|
504
504
|
<span class="gtkdoc opt">}</span>
|
|
505
505
|
|
|
506
506
|
<span class="gtkdoc kwb">void</span>
|
|
@@ -523,7 +523,7 @@ the return value.</p>
|
|
|
523
523
|
<span class="function"><a href="GTask.html#g-task-return-new-error">g_task_return_new_error</a></span> <span class="gtkdoc opt">(</span>task<span class="gtkdoc opt">,</span> BAKER_ERROR<span class="gtkdoc opt">,</span> BAKER_ERROR_TOO_SMALL<span class="gtkdoc opt">,</span>
|
|
524
524
|
<span class="string">"%ucm radius cakes are silly"</span><span class="gtkdoc opt">,</span>
|
|
525
525
|
radius<span class="gtkdoc opt">);</span>
|
|
526
|
-
<span class="function"><a href="../gobject
|
|
526
|
+
<span class="function"><a href="../gobject-The-Base-Object-Type.html#g-object-unref">g_object_unref</a></span> <span class="gtkdoc opt">(</span>task<span class="gtkdoc opt">);</span>
|
|
527
527
|
<span class="keyword">return</span><span class="gtkdoc opt">;</span>
|
|
528
528
|
<span class="gtkdoc opt">}</span>
|
|
529
529
|
|
|
@@ -532,13 +532,13 @@ the return value.</p>
|
|
|
532
532
|
<span class="gtkdoc opt">{</span>
|
|
533
533
|
<span class="gtkdoc slc">// _baker_get_cached_cake() returns a reffed cake</span>
|
|
534
534
|
<span class="function"><a href="GTask.html#g-task-return-pointer">g_task_return_pointer</a></span> <span class="gtkdoc opt">(</span>task<span class="gtkdoc opt">,</span> cake<span class="gtkdoc opt">,</span> g_object_unref<span class="gtkdoc opt">);</span>
|
|
535
|
-
<span class="function"><a href="../gobject
|
|
535
|
+
<span class="function"><a href="../gobject-The-Base-Object-Type.html#g-object-unref">g_object_unref</a></span> <span class="gtkdoc opt">(</span>task<span class="gtkdoc opt">);</span>
|
|
536
536
|
<span class="keyword">return</span><span class="gtkdoc opt">;</span>
|
|
537
537
|
<span class="gtkdoc opt">}</span>
|
|
538
538
|
|
|
539
|
-
decoration <span class="gtkdoc opt">=</span> <span class="function"><a href="../glib
|
|
539
|
+
decoration <span class="gtkdoc opt">=</span> <span class="function"><a href="../glib-Memory-Slices.html#g-slice-new">g_slice_new</a></span> <span class="gtkdoc opt">(</span>DecorationData<span class="gtkdoc opt">);</span>
|
|
540
540
|
decoration<span class="gtkdoc opt">-></span>frosting <span class="gtkdoc opt">=</span> frosting<span class="gtkdoc opt">;</span>
|
|
541
|
-
decoration<span class="gtkdoc opt">-></span>message <span class="gtkdoc opt">=</span> <span class="function"><a href="../glib
|
|
541
|
+
decoration<span class="gtkdoc opt">-></span>message <span class="gtkdoc opt">=</span> <span class="function"><a href="../glib-String-Utility-Functions.html#g-strdup">g_strdup</a></span> <span class="gtkdoc opt">(</span>message<span class="gtkdoc opt">);</span>
|
|
542
542
|
<span class="function"><a href="GTask.html#g-task-set-task-data">g_task_set_task_data</a></span> <span class="gtkdoc opt">(</span>task<span class="gtkdoc opt">,</span> decoration<span class="gtkdoc opt">, (</span>GDestroyNotify<span class="gtkdoc opt">)</span> decoration_data_free<span class="gtkdoc opt">);</span>
|
|
543
543
|
|
|
544
544
|
<span class="function">_baker_begin_cake</span> <span class="gtkdoc opt">(</span>self<span class="gtkdoc opt">,</span> radius<span class="gtkdoc opt">,</span> flavor<span class="gtkdoc opt">,</span> cancellable<span class="gtkdoc opt">,</span> baked_cb<span class="gtkdoc opt">,</span> task<span class="gtkdoc opt">);</span>
|
|
@@ -549,7 +549,7 @@ Cake <span class="gtkdoc opt">*</span>
|
|
|
549
549
|
GAsyncResult <span class="gtkdoc opt">*</span>result<span class="gtkdoc opt">,</span>
|
|
550
550
|
GError <span class="gtkdoc opt">**</span>error<span class="gtkdoc opt">)</span>
|
|
551
551
|
<span class="gtkdoc opt">{</span>
|
|
552
|
-
<span class="function"><a href="../glib
|
|
552
|
+
<span class="function"><a href="../glib-Warnings-and-Assertions.html#g-return-val-if-fail">g_return_val_if_fail</a></span> <span class="gtkdoc opt">(</span><span class="function"><a href="GTask.html#g-task-is-valid">g_task_is_valid</a></span> <span class="gtkdoc opt">(</span>result<span class="gtkdoc opt">,</span> self<span class="gtkdoc opt">),</span> NULL<span class="gtkdoc opt">);</span>
|
|
553
553
|
|
|
554
554
|
<span class="keyword">return</span> <span class="function"><a href="GTask.html#g-task-propagate-pointer">g_task_propagate_pointer</a></span> <span class="gtkdoc opt">(</span><span class="function">G_TASK</span> <span class="gtkdoc opt">(</span>result<span class="gtkdoc opt">),</span> error<span class="gtkdoc opt">);</span>
|
|
555
555
|
<span class="gtkdoc opt">}</span></pre></td>
|
|
@@ -566,11 +566,11 @@ Cake <span class="gtkdoc opt">*</span>
|
|
|
566
566
|
internally chain together several smaller asynchronous
|
|
567
567
|
operations. <a class="link" href="GTask.html#g-task-get-cancellable" title="g_task_get_cancellable ()"><code class="function">g_task_get_cancellable()</code></a>, <a class="link" href="GTask.html#g-task-get-context" title="g_task_get_context ()"><code class="function">g_task_get_context()</code></a>,
|
|
568
568
|
and <a class="link" href="GTask.html#g-task-get-priority" title="g_task_get_priority ()"><code class="function">g_task_get_priority()</code></a> allow you to get back the task's
|
|
569
|
-
<a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a>, <a href="../glib
|
|
569
|
+
<a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a>, <a href="../glib-The-Main-Event-Loop.html#GMainContext"><span class="type">GMainContext</span></a>, and <a class="link" href="GAsyncResult.html#io-priority" title="I/O Priority">I/O priority</a>
|
|
570
570
|
when starting a new subtask, so you don't have to keep track
|
|
571
571
|
of them yourself. <a class="link" href="GTask.html#g-task-attach-source" title="g_task_attach_source ()"><code class="function">g_task_attach_source()</code></a> simplifies the case
|
|
572
572
|
of waiting for a source to fire (automatically using the correct
|
|
573
|
-
<a href="../glib
|
|
573
|
+
<a href="../glib-The-Main-Event-Loop.html#GMainContext"><span class="type">GMainContext</span></a> and priority).</p>
|
|
574
574
|
<p>Here is an example for chained asynchronous operations:</p>
|
|
575
575
|
<div class="informalexample">
|
|
576
576
|
<table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
|
|
@@ -709,9 +709,9 @@ of waiting for a source to fire (automatically using the correct
|
|
|
709
709
|
<span class="function">decoration_data_free</span> <span class="gtkdoc opt">(</span>BakingData <span class="gtkdoc opt">*</span>bd<span class="gtkdoc opt">)</span>
|
|
710
710
|
<span class="gtkdoc opt">{</span>
|
|
711
711
|
<span class="keyword">if</span> <span class="gtkdoc opt">(</span>bd<span class="gtkdoc opt">-></span>cake<span class="gtkdoc opt">)</span>
|
|
712
|
-
<span class="function"><a href="../gobject
|
|
713
|
-
<span class="function"><a href="../glib
|
|
714
|
-
<span class="function"><a href="../glib
|
|
712
|
+
<span class="function"><a href="../gobject-The-Base-Object-Type.html#g-object-unref">g_object_unref</a></span> <span class="gtkdoc opt">(</span>bd<span class="gtkdoc opt">-></span>cake<span class="gtkdoc opt">);</span>
|
|
713
|
+
<span class="function"><a href="../glib-Memory-Allocation.html#g-free">g_free</a></span> <span class="gtkdoc opt">(</span>bd<span class="gtkdoc opt">-></span>message<span class="gtkdoc opt">);</span>
|
|
714
|
+
<span class="function"><a href="../glib-Memory-Slices.html#g-slice-free">g_slice_free</a></span> <span class="gtkdoc opt">(</span>BakingData<span class="gtkdoc opt">,</span> bd<span class="gtkdoc opt">);</span>
|
|
715
715
|
<span class="gtkdoc opt">}</span>
|
|
716
716
|
|
|
717
717
|
<span class="gtkdoc kwb">static void</span>
|
|
@@ -724,16 +724,16 @@ of waiting for a source to fire (automatically using the correct
|
|
|
724
724
|
|
|
725
725
|
<span class="keyword">if</span> <span class="gtkdoc opt">(!</span><span class="function">cake_decorate_finish</span> <span class="gtkdoc opt">(</span>cake<span class="gtkdoc opt">,</span> result<span class="gtkdoc opt">, &</span>error<span class="gtkdoc opt">))</span>
|
|
726
726
|
<span class="gtkdoc opt">{</span>
|
|
727
|
-
<span class="function"><a href="../gobject
|
|
727
|
+
<span class="function"><a href="../gobject-The-Base-Object-Type.html#g-object-unref">g_object_unref</a></span> <span class="gtkdoc opt">(</span>cake<span class="gtkdoc opt">);</span>
|
|
728
728
|
<span class="function"><a href="GTask.html#g-task-return-error">g_task_return_error</a></span> <span class="gtkdoc opt">(</span>task<span class="gtkdoc opt">,</span> error<span class="gtkdoc opt">);</span>
|
|
729
|
-
<span class="function"><a href="../gobject
|
|
729
|
+
<span class="function"><a href="../gobject-The-Base-Object-Type.html#g-object-unref">g_object_unref</a></span> <span class="gtkdoc opt">(</span>task<span class="gtkdoc opt">);</span>
|
|
730
730
|
<span class="keyword">return</span><span class="gtkdoc opt">;</span>
|
|
731
731
|
<span class="gtkdoc opt">}</span>
|
|
732
732
|
|
|
733
733
|
<span class="gtkdoc slc">// baking_data_free() will drop its ref on the cake, so we have to</span>
|
|
734
734
|
<span class="gtkdoc slc">// take another here to give to the caller.</span>
|
|
735
|
-
<span class="function"><a href="GTask.html#g-task-return-pointer">g_task_return_pointer</a></span> <span class="gtkdoc opt">(</span>task<span class="gtkdoc opt">,</span> <span class="function"><a href="../gobject
|
|
736
|
-
<span class="function"><a href="../gobject
|
|
735
|
+
<span class="function"><a href="GTask.html#g-task-return-pointer">g_task_return_pointer</a></span> <span class="gtkdoc opt">(</span>task<span class="gtkdoc opt">,</span> <span class="function"><a href="../gobject-The-Base-Object-Type.html#g-object-ref">g_object_ref</a></span> <span class="gtkdoc opt">(</span>cake<span class="gtkdoc opt">),</span> g_object_unref<span class="gtkdoc opt">);</span>
|
|
736
|
+
<span class="function"><a href="../gobject-The-Base-Object-Type.html#g-object-unref">g_object_unref</a></span> <span class="gtkdoc opt">(</span>task<span class="gtkdoc opt">);</span>
|
|
737
737
|
<span class="gtkdoc opt">}</span>
|
|
738
738
|
|
|
739
739
|
<span class="gtkdoc kwb">static</span> gboolean
|
|
@@ -761,7 +761,7 @@ of waiting for a source to fire (automatically using the correct
|
|
|
761
761
|
<span class="gtkdoc opt">{</span>
|
|
762
762
|
<span class="function"><a href="GTask.html#g-task-return-new-error">g_task_return_new_error</a></span> <span class="gtkdoc opt">(</span>task<span class="gtkdoc opt">,</span> BAKER_ERROR<span class="gtkdoc opt">,</span> BAKER_ERROR_NO_FLOUR<span class="gtkdoc opt">,</span>
|
|
763
763
|
<span class="string">"Go to the supermarket"</span><span class="gtkdoc opt">);</span>
|
|
764
|
-
<span class="function"><a href="../gobject
|
|
764
|
+
<span class="function"><a href="../gobject-The-Base-Object-Type.html#g-object-unref">g_object_unref</a></span> <span class="gtkdoc opt">(</span>task<span class="gtkdoc opt">);</span>
|
|
765
765
|
<span class="keyword">return</span><span class="gtkdoc opt">;</span>
|
|
766
766
|
<span class="gtkdoc opt">}</span>
|
|
767
767
|
|
|
@@ -770,7 +770,7 @@ of waiting for a source to fire (automatically using the correct
|
|
|
770
770
|
<span class="gtkdoc slc">// Bail out now if the user has already cancelled</span>
|
|
771
771
|
<span class="keyword">if</span> <span class="gtkdoc opt">(</span><span class="function"><a href="GTask.html#g-task-return-error-if-cancelled">g_task_return_error_if_cancelled</a></span> <span class="gtkdoc opt">(</span>task<span class="gtkdoc opt">))</span>
|
|
772
772
|
<span class="gtkdoc opt">{</span>
|
|
773
|
-
<span class="function"><a href="../gobject
|
|
773
|
+
<span class="function"><a href="../gobject-The-Base-Object-Type.html#g-object-unref">g_object_unref</a></span> <span class="gtkdoc opt">(</span>task<span class="gtkdoc opt">);</span>
|
|
774
774
|
<span class="keyword">return</span><span class="gtkdoc opt">;</span>
|
|
775
775
|
<span class="gtkdoc opt">}</span>
|
|
776
776
|
|
|
@@ -784,7 +784,7 @@ of waiting for a source to fire (automatically using the correct
|
|
|
784
784
|
<span class="gtkdoc slc">// Attach @source to @task's GMainContext and have it call</span>
|
|
785
785
|
<span class="gtkdoc slc">// decorator_ready() when it is ready.</span>
|
|
786
786
|
<span class="function"><a href="GTask.html#g-task-attach-source">g_task_attach_source</a></span> <span class="gtkdoc opt">(</span>task<span class="gtkdoc opt">,</span> source<span class="gtkdoc opt">,</span> decorator_ready<span class="gtkdoc opt">);</span>
|
|
787
|
-
<span class="function"><a href="../glib
|
|
787
|
+
<span class="function"><a href="../glib-The-Main-Event-Loop.html#g-source-unref">g_source_unref</a></span> <span class="gtkdoc opt">(</span>source<span class="gtkdoc opt">);</span>
|
|
788
788
|
<span class="gtkdoc opt">}</span>
|
|
789
789
|
<span class="gtkdoc opt">}</span>
|
|
790
790
|
|
|
@@ -805,9 +805,9 @@ of waiting for a source to fire (automatically using the correct
|
|
|
805
805
|
task <span class="gtkdoc opt">=</span> <span class="function"><a href="GTask.html#g-task-new">g_task_new</a></span> <span class="gtkdoc opt">(</span>self<span class="gtkdoc opt">,</span> cancellable<span class="gtkdoc opt">,</span> callback<span class="gtkdoc opt">,</span> user_data<span class="gtkdoc opt">);</span>
|
|
806
806
|
<span class="function"><a href="GTask.html#g-task-set-priority">g_task_set_priority</a></span> <span class="gtkdoc opt">(</span>task<span class="gtkdoc opt">,</span> priority<span class="gtkdoc opt">);</span>
|
|
807
807
|
|
|
808
|
-
bd <span class="gtkdoc opt">=</span> <span class="function"><a href="../glib
|
|
808
|
+
bd <span class="gtkdoc opt">=</span> <span class="function"><a href="../glib-Memory-Slices.html#g-slice-new0">g_slice_new0</a></span> <span class="gtkdoc opt">(</span>BakingData<span class="gtkdoc opt">);</span>
|
|
809
809
|
bd<span class="gtkdoc opt">-></span>frosting <span class="gtkdoc opt">=</span> frosting<span class="gtkdoc opt">;</span>
|
|
810
|
-
bd<span class="gtkdoc opt">-></span>message <span class="gtkdoc opt">=</span> <span class="function"><a href="../glib
|
|
810
|
+
bd<span class="gtkdoc opt">-></span>message <span class="gtkdoc opt">=</span> <span class="function"><a href="../glib-String-Utility-Functions.html#g-strdup">g_strdup</a></span> <span class="gtkdoc opt">(</span>message<span class="gtkdoc opt">);</span>
|
|
811
811
|
<span class="function"><a href="GTask.html#g-task-set-task-data">g_task_set_task_data</a></span> <span class="gtkdoc opt">(</span>task<span class="gtkdoc opt">,</span> bd<span class="gtkdoc opt">, (</span>GDestroyNotify<span class="gtkdoc opt">)</span> baking_data_free<span class="gtkdoc opt">);</span>
|
|
812
812
|
|
|
813
813
|
<span class="function">_baker_begin_cake</span> <span class="gtkdoc opt">(</span>self<span class="gtkdoc opt">,</span> radius<span class="gtkdoc opt">,</span> flavor<span class="gtkdoc opt">,</span> cancellable<span class="gtkdoc opt">,</span> baked_cb<span class="gtkdoc opt">,</span> task<span class="gtkdoc opt">);</span>
|
|
@@ -818,7 +818,7 @@ Cake <span class="gtkdoc opt">*</span>
|
|
|
818
818
|
GAsyncResult <span class="gtkdoc opt">*</span>result<span class="gtkdoc opt">,</span>
|
|
819
819
|
GError <span class="gtkdoc opt">**</span>error<span class="gtkdoc opt">)</span>
|
|
820
820
|
<span class="gtkdoc opt">{</span>
|
|
821
|
-
<span class="function"><a href="../glib
|
|
821
|
+
<span class="function"><a href="../glib-Warnings-and-Assertions.html#g-return-val-if-fail">g_return_val_if_fail</a></span> <span class="gtkdoc opt">(</span><span class="function"><a href="GTask.html#g-task-is-valid">g_task_is_valid</a></span> <span class="gtkdoc opt">(</span>result<span class="gtkdoc opt">,</span> self<span class="gtkdoc opt">),</span> NULL<span class="gtkdoc opt">);</span>
|
|
822
822
|
|
|
823
823
|
<span class="keyword">return</span> <span class="function"><a href="GTask.html#g-task-propagate-pointer">g_task_propagate_pointer</a></span> <span class="gtkdoc opt">(</span><span class="function">G_TASK</span> <span class="gtkdoc opt">(</span>result<span class="gtkdoc opt">),</span> error<span class="gtkdoc opt">);</span>
|
|
824
824
|
<span class="gtkdoc opt">}</span></pre></td>
|
|
@@ -834,7 +834,7 @@ Cake <span class="gtkdoc opt">*</span>
|
|
|
834
834
|
<p>You can use <a class="link" href="GTask.html#g-task-run-in-thread" title="g_task_run_in_thread ()"><code class="function">g_task_run_in_thread()</code></a> to turn a synchronous
|
|
835
835
|
operation into an asynchronous one, by running it in a thread
|
|
836
836
|
which will then dispatch the result back to the caller's
|
|
837
|
-
<a href="../glib
|
|
837
|
+
<a href="../glib-The-Main-Event-Loop.html#GMainContext"><span class="type">GMainContext</span></a> when it completes.</p>
|
|
838
838
|
<p>Running a task in a thread:</p>
|
|
839
839
|
<div class="informalexample">
|
|
840
840
|
<table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
|
|
@@ -917,8 +917,8 @@ which will then dispatch the result back to the caller's
|
|
|
917
917
|
<span class="gtkdoc kwb">static void</span>
|
|
918
918
|
<span class="function">cake_data_free</span> <span class="gtkdoc opt">(</span>CakeData <span class="gtkdoc opt">*</span>cake_data<span class="gtkdoc opt">)</span>
|
|
919
919
|
<span class="gtkdoc opt">{</span>
|
|
920
|
-
<span class="function"><a href="../glib
|
|
921
|
-
<span class="function"><a href="../glib
|
|
920
|
+
<span class="function"><a href="../glib-Memory-Allocation.html#g-free">g_free</a></span> <span class="gtkdoc opt">(</span>cake_data<span class="gtkdoc opt">-></span>message<span class="gtkdoc opt">);</span>
|
|
921
|
+
<span class="function"><a href="../glib-Memory-Slices.html#g-slice-free">g_slice_free</a></span> <span class="gtkdoc opt">(</span>CakeData<span class="gtkdoc opt">,</span> cake_data<span class="gtkdoc opt">);</span>
|
|
922
922
|
<span class="gtkdoc opt">}</span>
|
|
923
923
|
|
|
924
924
|
<span class="gtkdoc kwb">static void</span>
|
|
@@ -954,15 +954,15 @@ which will then dispatch the result back to the caller's
|
|
|
954
954
|
CakeData <span class="gtkdoc opt">*</span>cake_data<span class="gtkdoc opt">;</span>
|
|
955
955
|
GTask <span class="gtkdoc opt">*</span>task<span class="gtkdoc opt">;</span>
|
|
956
956
|
|
|
957
|
-
cake_data <span class="gtkdoc opt">=</span> <span class="function"><a href="../glib
|
|
957
|
+
cake_data <span class="gtkdoc opt">=</span> <span class="function"><a href="../glib-Memory-Slices.html#g-slice-new">g_slice_new</a></span> <span class="gtkdoc opt">(</span>CakeData<span class="gtkdoc opt">);</span>
|
|
958
958
|
cake_data<span class="gtkdoc opt">-></span>radius <span class="gtkdoc opt">=</span> radius<span class="gtkdoc opt">;</span>
|
|
959
959
|
cake_data<span class="gtkdoc opt">-></span>flavor <span class="gtkdoc opt">=</span> flavor<span class="gtkdoc opt">;</span>
|
|
960
960
|
cake_data<span class="gtkdoc opt">-></span>frosting <span class="gtkdoc opt">=</span> frosting<span class="gtkdoc opt">;</span>
|
|
961
|
-
cake_data<span class="gtkdoc opt">-></span>message <span class="gtkdoc opt">=</span> <span class="function"><a href="../glib
|
|
961
|
+
cake_data<span class="gtkdoc opt">-></span>message <span class="gtkdoc opt">=</span> <span class="function"><a href="../glib-String-Utility-Functions.html#g-strdup">g_strdup</a></span> <span class="gtkdoc opt">(</span>message<span class="gtkdoc opt">);</span>
|
|
962
962
|
task <span class="gtkdoc opt">=</span> <span class="function"><a href="GTask.html#g-task-new">g_task_new</a></span> <span class="gtkdoc opt">(</span>self<span class="gtkdoc opt">,</span> cancellable<span class="gtkdoc opt">,</span> callback<span class="gtkdoc opt">,</span> user_data<span class="gtkdoc opt">);</span>
|
|
963
963
|
<span class="function"><a href="GTask.html#g-task-set-task-data">g_task_set_task_data</a></span> <span class="gtkdoc opt">(</span>task<span class="gtkdoc opt">,</span> cake_data<span class="gtkdoc opt">, (</span>GDestroyNotify<span class="gtkdoc opt">)</span> cake_data_free<span class="gtkdoc opt">);</span>
|
|
964
964
|
<span class="function"><a href="GTask.html#g-task-run-in-thread">g_task_run_in_thread</a></span> <span class="gtkdoc opt">(</span>task<span class="gtkdoc opt">,</span> bake_cake_thread<span class="gtkdoc opt">);</span>
|
|
965
|
-
<span class="function"><a href="../gobject
|
|
965
|
+
<span class="function"><a href="../gobject-The-Base-Object-Type.html#g-object-unref">g_object_unref</a></span> <span class="gtkdoc opt">(</span>task<span class="gtkdoc opt">);</span>
|
|
966
966
|
<span class="gtkdoc opt">}</span>
|
|
967
967
|
|
|
968
968
|
Cake <span class="gtkdoc opt">*</span>
|
|
@@ -970,7 +970,7 @@ Cake <span class="gtkdoc opt">*</span>
|
|
|
970
970
|
GAsyncResult <span class="gtkdoc opt">*</span>result<span class="gtkdoc opt">,</span>
|
|
971
971
|
GError <span class="gtkdoc opt">**</span>error<span class="gtkdoc opt">)</span>
|
|
972
972
|
<span class="gtkdoc opt">{</span>
|
|
973
|
-
<span class="function"><a href="../glib
|
|
973
|
+
<span class="function"><a href="../glib-Warnings-and-Assertions.html#g-return-val-if-fail">g_return_val_if_fail</a></span> <span class="gtkdoc opt">(</span><span class="function"><a href="GTask.html#g-task-is-valid">g_task_is_valid</a></span> <span class="gtkdoc opt">(</span>result<span class="gtkdoc opt">,</span> self<span class="gtkdoc opt">),</span> NULL<span class="gtkdoc opt">);</span>
|
|
974
974
|
|
|
975
975
|
<span class="keyword">return</span> <span class="function"><a href="GTask.html#g-task-propagate-pointer">g_task_propagate_pointer</a></span> <span class="gtkdoc opt">(</span><span class="function">G_TASK</span> <span class="gtkdoc opt">(</span>result<span class="gtkdoc opt">),</span> error<span class="gtkdoc opt">);</span>
|
|
976
976
|
<span class="gtkdoc opt">}</span></pre></td>
|
|
@@ -986,7 +986,7 @@ Cake <span class="gtkdoc opt">*</span>
|
|
|
986
986
|
<p>Finally, <a class="link" href="GTask.html#g-task-run-in-thread" title="g_task_run_in_thread ()"><code class="function">g_task_run_in_thread()</code></a> and <a class="link" href="GTask.html#g-task-run-in-thread-sync" title="g_task_run_in_thread_sync ()"><code class="function">g_task_run_in_thread_sync()</code></a>
|
|
987
987
|
can be used to turn an uncancellable operation into a
|
|
988
988
|
cancellable one. If you call <a class="link" href="GTask.html#g-task-set-return-on-cancel" title="g_task_set_return_on_cancel ()"><code class="function">g_task_set_return_on_cancel()</code></a>,
|
|
989
|
-
passing <a href="../glib
|
|
989
|
+
passing <a href="../glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, then if the task's <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> is cancelled,
|
|
990
990
|
it will return control back to the caller immediately, while
|
|
991
991
|
allowing the task thread to continue running in the background
|
|
992
992
|
(and simply discarding its result when it finally does finish).
|
|
@@ -1139,7 +1139,7 @@ synchronous variants of blocking APIs.</p>
|
|
|
1139
1139
|
CakeData <span class="gtkdoc opt">*</span>cake_data<span class="gtkdoc opt">;</span>
|
|
1140
1140
|
GTask <span class="gtkdoc opt">*</span>task<span class="gtkdoc opt">;</span>
|
|
1141
1141
|
|
|
1142
|
-
cake_data <span class="gtkdoc opt">=</span> <span class="function"><a href="../glib
|
|
1142
|
+
cake_data <span class="gtkdoc opt">=</span> <span class="function"><a href="../glib-Memory-Slices.html#g-slice-new">g_slice_new</a></span> <span class="gtkdoc opt">(</span>CakeData<span class="gtkdoc opt">);</span>
|
|
1143
1143
|
|
|
1144
1144
|
<span class="gtkdoc opt">...</span>
|
|
1145
1145
|
|
|
@@ -1162,7 +1162,7 @@ Cake <span class="gtkdoc opt">*</span>
|
|
|
1162
1162
|
GTask <span class="gtkdoc opt">*</span>task<span class="gtkdoc opt">;</span>
|
|
1163
1163
|
Cake <span class="gtkdoc opt">*</span>cake<span class="gtkdoc opt">;</span>
|
|
1164
1164
|
|
|
1165
|
-
cake_data <span class="gtkdoc opt">=</span> <span class="function"><a href="../glib
|
|
1165
|
+
cake_data <span class="gtkdoc opt">=</span> <span class="function"><a href="../glib-Memory-Slices.html#g-slice-new">g_slice_new</a></span> <span class="gtkdoc opt">(</span>CakeData<span class="gtkdoc opt">);</span>
|
|
1166
1166
|
|
|
1167
1167
|
<span class="gtkdoc opt">...</span>
|
|
1168
1168
|
|
|
@@ -1172,7 +1172,7 @@ Cake <span class="gtkdoc opt">*</span>
|
|
|
1172
1172
|
<span class="function"><a href="GTask.html#g-task-run-in-thread-sync">g_task_run_in_thread_sync</a></span> <span class="gtkdoc opt">(</span>task<span class="gtkdoc opt">,</span> bake_cake_thread<span class="gtkdoc opt">);</span>
|
|
1173
1173
|
|
|
1174
1174
|
cake <span class="gtkdoc opt">=</span> <span class="function"><a href="GTask.html#g-task-propagate-pointer">g_task_propagate_pointer</a></span> <span class="gtkdoc opt">(</span>task<span class="gtkdoc opt">,</span> error<span class="gtkdoc opt">);</span>
|
|
1175
|
-
<span class="function"><a href="../gobject
|
|
1175
|
+
<span class="function"><a href="../gobject-The-Base-Object-Type.html#g-object-unref">g_object_unref</a></span> <span class="gtkdoc opt">(</span>task<span class="gtkdoc opt">);</span>
|
|
1176
1176
|
<span class="keyword">return</span> cake<span class="gtkdoc opt">;</span>
|
|
1177
1177
|
<span class="gtkdoc opt">}</span></pre></td>
|
|
1178
1178
|
</tr>
|
|
@@ -1193,7 +1193,7 @@ abuse of <a class="link" href="GSimpleAsyncResult.html#g-simple-async-result-set
|
|
|
1193
1193
|
purpose with <a class="link" href="GSimpleAsyncResult.html" title="GSimpleAsyncResult"><span class="type">GSimpleAsyncResult</span></a>.</p></li>
|
|
1194
1194
|
<li class="listitem"><p>In addition to the task data, <a class="link" href="GTask.html" title="GTask"><span class="type">GTask</span></a> also keeps track of the
|
|
1195
1195
|
<a class="link" href="GAsyncResult.html#io-priority" title="I/O Priority">priority</a>, <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a>, and
|
|
1196
|
-
<a href="../glib
|
|
1196
|
+
<a href="../glib-The-Main-Event-Loop.html#GMainContext"><span class="type">GMainContext</span></a> associated with the task, so tasks that consist of
|
|
1197
1197
|
a chain of simpler asynchronous operations will have easy access
|
|
1198
1198
|
to those values when starting each sub-task.</p></li>
|
|
1199
1199
|
<li class="listitem"><p>g_task_return_error_if_cancelled() provides simplified
|
|
@@ -1214,8 +1214,8 @@ automatically cause the task to be "completed" as well, and
|
|
|
1214
1214
|
there is no need to worry about the "complete" vs "complete
|
|
1215
1215
|
in idle" distinction. (<a class="link" href="GTask.html" title="GTask"><span class="type">GTask</span></a> automatically figures out
|
|
1216
1216
|
whether the task's callback can be invoked directly, or
|
|
1217
|
-
if it needs to be sent to another <a href="../glib
|
|
1218
|
-
until the next iteration of the current <a href="../glib
|
|
1217
|
+
if it needs to be sent to another <a href="../glib-The-Main-Event-Loop.html#GMainContext"><span class="type">GMainContext</span></a>, or delayed
|
|
1218
|
+
until the next iteration of the current <a href="../glib-The-Main-Event-Loop.html#GMainContext"><span class="type">GMainContext</span></a>.)</p></li>
|
|
1219
1219
|
<li class="listitem"><p>The "finish" functions for <span class="type">GTask-based</span> operations are generally
|
|
1220
1220
|
much simpler than <a class="link" href="GSimpleAsyncResult.html" title="GSimpleAsyncResult"><span class="type">GSimpleAsyncResult</span></a> ones, normally consisting
|
|
1221
1221
|
of only a single call to <a class="link" href="GTask.html#g-task-propagate-pointer" title="g_task_propagate_pointer ()"><code class="function">g_task_propagate_pointer()</code></a> or the like.
|
|
@@ -1246,15 +1246,15 @@ function (for "short-circuit" results, such as when passing
|
|
|
1246
1246
|
<div class="refsect2">
|
|
1247
1247
|
<a name="g-task-new"></a><h3>g_task_new ()</h3>
|
|
1248
1248
|
<pre class="programlisting"><a class="link" href="GTask.html" title="GTask"><span class="returnvalue">GTask</span></a> *
|
|
1249
|
-
g_task_new (<em class="parameter"><code><a href="../glib
|
|
1249
|
+
g_task_new (<em class="parameter"><code><a href="../glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> source_object</code></em>,
|
|
1250
1250
|
<em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
|
|
1251
1251
|
<em class="parameter"><code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
|
|
1252
|
-
<em class="parameter"><code><a href="../glib
|
|
1252
|
+
<em class="parameter"><code><a href="../glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> callback_data</code></em>);</pre>
|
|
1253
1253
|
<p>Creates a <a class="link" href="GTask.html" title="GTask"><span class="type">GTask</span></a> acting on <em class="parameter"><code>source_object</code></em>
|
|
1254
1254
|
, which will eventually be
|
|
1255
1255
|
used to invoke <em class="parameter"><code>callback</code></em>
|
|
1256
1256
|
in the current
|
|
1257
|
-
<a href="../glib
|
|
1257
|
+
<a href="../glib-The-Main-Event-Loop.html#g-main-context-push-thread-default">thread-default main context</a>.</p>
|
|
1258
1258
|
<p>Call this in the "start" method of your asynchronous method, and
|
|
1259
1259
|
pass the <a class="link" href="GTask.html" title="GTask"><span class="type">GTask</span></a> around throughout the asynchronous operation. You
|
|
1260
1260
|
can use <a class="link" href="GTask.html#g-task-set-task-data" title="g_task_set_task_data ()"><code class="function">g_task_set_task_data()</code></a> to attach task-specific data to the
|
|
@@ -1268,7 +1268,7 @@ other objects that the task depends on have been destroyed. If you
|
|
|
1268
1268
|
do not want this behavior, you can use
|
|
1269
1269
|
<a class="link" href="GTask.html#g-task-set-check-cancellable" title="g_task_set_check_cancellable ()"><code class="function">g_task_set_check_cancellable()</code></a> to change it.</p>
|
|
1270
1270
|
<div class="refsect3">
|
|
1271
|
-
<a name="
|
|
1271
|
+
<a name="g-task-new.parameters"></a><h4>Parameters</h4>
|
|
1272
1272
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
|
1273
1273
|
<colgroup>
|
|
1274
1274
|
<col width="150px" class="parameters_name">
|
|
@@ -1278,13 +1278,13 @@ do not want this behavior, you can use
|
|
|
1278
1278
|
<tbody>
|
|
1279
1279
|
<tr>
|
|
1280
1280
|
<td class="parameter_name"><p>source_object</p></td>
|
|
1281
|
-
<td class="parameter_description"><p> the <a href="../gobject
|
|
1282
|
-
this task, or <a href="../glib
|
|
1281
|
+
<td class="parameter_description"><p> the <a href="../gobject-The-Base-Object-Type.html#GObject-struct"><span class="type">GObject</span></a> that owns
|
|
1282
|
+
this task, or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
|
|
1283
1283
|
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>][<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> GObject]</span></td>
|
|
1284
1284
|
</tr>
|
|
1285
1285
|
<tr>
|
|
1286
1286
|
<td class="parameter_name"><p>cancellable</p></td>
|
|
1287
|
-
<td class="parameter_description"><p> optional <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> object, <a href="../glib
|
|
1287
|
+
<td class="parameter_description"><p> optional <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> object, <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </p></td>
|
|
1288
1288
|
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
|
|
1289
1289
|
</tr>
|
|
1290
1290
|
<tr>
|
|
@@ -1302,7 +1302,7 @@ this task, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class=
|
|
|
1302
1302
|
</table></div>
|
|
1303
1303
|
</div>
|
|
1304
1304
|
<div class="refsect3">
|
|
1305
|
-
<a name="
|
|
1305
|
+
<a name="g-task-new.returns"></a><h4>Returns</h4>
|
|
1306
1306
|
<p> a <a class="link" href="GTask.html" title="GTask"><span class="type">GTask</span></a>.</p>
|
|
1307
1307
|
</div>
|
|
1308
1308
|
<p class="since">Since: <a class="link" href="api-index-2-36.html#api-index-2.36">2.36</a></p>
|
|
@@ -1312,12 +1312,12 @@ this task, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class=
|
|
|
1312
1312
|
<a name="g-task-set-task-data"></a><h3>g_task_set_task_data ()</h3>
|
|
1313
1313
|
<pre class="programlisting"><span class="returnvalue">void</span>
|
|
1314
1314
|
g_task_set_task_data (<em class="parameter"><code><a class="link" href="GTask.html" title="GTask"><span class="type">GTask</span></a> *task</code></em>,
|
|
1315
|
-
<em class="parameter"><code><a href="../glib
|
|
1316
|
-
<em class="parameter"><code><a href="../glib
|
|
1315
|
+
<em class="parameter"><code><a href="../glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> task_data</code></em>,
|
|
1316
|
+
<em class="parameter"><code><a href="../glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> task_data_destroy</code></em>);</pre>
|
|
1317
1317
|
<p>Sets <em class="parameter"><code>task</code></em>
|
|
1318
1318
|
's task data (freeing the existing task data, if any).</p>
|
|
1319
1319
|
<div class="refsect3">
|
|
1320
|
-
<a name="
|
|
1320
|
+
<a name="g-task-set-task-data.parameters"></a><h4>Parameters</h4>
|
|
1321
1321
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
|
1322
1322
|
<colgroup>
|
|
1323
1323
|
<col width="150px" class="parameters_name">
|
|
@@ -1337,7 +1337,7 @@ g_task_set_task_data (<em class="parameter"><code><a class="link" href="GTask.ht
|
|
|
1337
1337
|
</tr>
|
|
1338
1338
|
<tr>
|
|
1339
1339
|
<td class="parameter_name"><p>task_data_destroy</p></td>
|
|
1340
|
-
<td class="parameter_description"><p> <a href="../glib
|
|
1340
|
+
<td class="parameter_description"><p> <a href="../glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> for <em class="parameter"><code>task_data</code></em>
|
|
1341
1341
|
. </p></td>
|
|
1342
1342
|
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
|
|
1343
1343
|
</tr>
|
|
@@ -1351,16 +1351,16 @@ g_task_set_task_data (<em class="parameter"><code><a class="link" href="GTask.ht
|
|
|
1351
1351
|
<a name="g-task-set-priority"></a><h3>g_task_set_priority ()</h3>
|
|
1352
1352
|
<pre class="programlisting"><span class="returnvalue">void</span>
|
|
1353
1353
|
g_task_set_priority (<em class="parameter"><code><a class="link" href="GTask.html" title="GTask"><span class="type">GTask</span></a> *task</code></em>,
|
|
1354
|
-
<em class="parameter"><code><a href="../glib
|
|
1354
|
+
<em class="parameter"><code><a href="../glib-Basic-Types.html#gint"><span class="type">gint</span></a> priority</code></em>);</pre>
|
|
1355
1355
|
<p>Sets <em class="parameter"><code>task</code></em>
|
|
1356
1356
|
's priority. If you do not call this, it will default to
|
|
1357
|
-
<a href="../glib
|
|
1358
|
-
<p>This will affect the priority of <a href="../glib
|
|
1357
|
+
<a href="../glib-The-Main-Event-Loop.html#G-PRIORITY-DEFAULT:CAPS"><code class="literal">G_PRIORITY_DEFAULT</code></a>.</p>
|
|
1358
|
+
<p>This will affect the priority of <a href="../glib-The-Main-Event-Loop.html#GSource"><span class="type">GSources</span></a> created with
|
|
1359
1359
|
<a class="link" href="GTask.html#g-task-attach-source" title="g_task_attach_source ()"><code class="function">g_task_attach_source()</code></a> and the scheduling of tasks run in threads,
|
|
1360
1360
|
and can also be explicitly retrieved later via
|
|
1361
1361
|
<a class="link" href="GTask.html#g-task-get-priority" title="g_task_get_priority ()"><code class="function">g_task_get_priority()</code></a>.</p>
|
|
1362
1362
|
<div class="refsect3">
|
|
1363
|
-
<a name="
|
|
1363
|
+
<a name="g-task-set-priority.parameters"></a><h4>Parameters</h4>
|
|
1364
1364
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
|
1365
1365
|
<colgroup>
|
|
1366
1366
|
<col width="150px" class="parameters_name">
|
|
@@ -1388,9 +1388,9 @@ and can also be explicitly retrieved later via
|
|
|
1388
1388
|
<a name="g-task-set-check-cancellable"></a><h3>g_task_set_check_cancellable ()</h3>
|
|
1389
1389
|
<pre class="programlisting"><span class="returnvalue">void</span>
|
|
1390
1390
|
g_task_set_check_cancellable (<em class="parameter"><code><a class="link" href="GTask.html" title="GTask"><span class="type">GTask</span></a> *task</code></em>,
|
|
1391
|
-
<em class="parameter"><code><a href="../glib
|
|
1391
|
+
<em class="parameter"><code><a href="../glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> check_cancellable</code></em>);</pre>
|
|
1392
1392
|
<p>Sets or clears <em class="parameter"><code>task</code></em>
|
|
1393
|
-
's check-cancellable flag. If this is <a href="../glib
|
|
1393
|
+
's check-cancellable flag. If this is <a href="../glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>
|
|
1394
1394
|
(the default), then <a class="link" href="GTask.html#g-task-propagate-pointer" title="g_task_propagate_pointer ()"><code class="function">g_task_propagate_pointer()</code></a>, etc, and
|
|
1395
1395
|
<a class="link" href="GTask.html#g-task-had-error" title="g_task_had_error ()"><code class="function">g_task_had_error()</code></a> will check the task's <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> first, and
|
|
1396
1396
|
if it has been cancelled, then they will consider the task to have
|
|
@@ -1398,14 +1398,14 @@ returned an "Operation was cancelled" error
|
|
|
1398
1398
|
(<a class="link" href="gio-GIOError.html#G-IO-ERROR-CANCELLED:CAPS"><code class="literal">G_IO_ERROR_CANCELLED</code></a>), regardless of any other error or return
|
|
1399
1399
|
value the task may have had.</p>
|
|
1400
1400
|
<p>If <em class="parameter"><code>check_cancellable</code></em>
|
|
1401
|
-
is <a href="../glib
|
|
1401
|
+
is <a href="../glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>, then the <a class="link" href="GTask.html" title="GTask"><span class="type">GTask</span></a> will not check the
|
|
1402
1402
|
cancellable itself, and it is up to <em class="parameter"><code>task</code></em>
|
|
1403
1403
|
's owner to do this (eg,
|
|
1404
1404
|
via <a class="link" href="GTask.html#g-task-return-error-if-cancelled" title="g_task_return_error_if_cancelled ()"><code class="function">g_task_return_error_if_cancelled()</code></a>).</p>
|
|
1405
1405
|
<p>If you are using <a class="link" href="GTask.html#g-task-set-return-on-cancel" title="g_task_set_return_on_cancel ()"><code class="function">g_task_set_return_on_cancel()</code></a> as well, then
|
|
1406
|
-
you must leave check-cancellable set <a href="../glib
|
|
1406
|
+
you must leave check-cancellable set <a href="../glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>.</p>
|
|
1407
1407
|
<div class="refsect3">
|
|
1408
|
-
<a name="
|
|
1408
|
+
<a name="g-task-set-check-cancellable.parameters"></a><h4>Parameters</h4>
|
|
1409
1409
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
|
1410
1410
|
<colgroup>
|
|
1411
1411
|
<col width="150px" class="parameters_name">
|
|
@@ -1432,15 +1432,15 @@ its <a class="link" href="GCancellable.html" title="GCancellable"><span class="t
|
|
|
1432
1432
|
<hr>
|
|
1433
1433
|
<div class="refsect2">
|
|
1434
1434
|
<a name="g-task-set-return-on-cancel"></a><h3>g_task_set_return_on_cancel ()</h3>
|
|
1435
|
-
<pre class="programlisting"><a href="../glib
|
|
1435
|
+
<pre class="programlisting"><a href="../glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
|
|
1436
1436
|
g_task_set_return_on_cancel (<em class="parameter"><code><a class="link" href="GTask.html" title="GTask"><span class="type">GTask</span></a> *task</code></em>,
|
|
1437
|
-
<em class="parameter"><code><a href="../glib
|
|
1437
|
+
<em class="parameter"><code><a href="../glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> return_on_cancel</code></em>);</pre>
|
|
1438
1438
|
<p>Sets or clears <em class="parameter"><code>task</code></em>
|
|
1439
1439
|
's return-on-cancel flag. This is only
|
|
1440
1440
|
meaningful for tasks run via <a class="link" href="GTask.html#g-task-run-in-thread" title="g_task_run_in_thread ()"><code class="function">g_task_run_in_thread()</code></a> or
|
|
1441
1441
|
<a class="link" href="GTask.html#g-task-run-in-thread-sync" title="g_task_run_in_thread_sync ()"><code class="function">g_task_run_in_thread_sync()</code></a>.</p>
|
|
1442
1442
|
<p>If <em class="parameter"><code>return_on_cancel</code></em>
|
|
1443
|
-
is <a href="../glib
|
|
1443
|
+
is <a href="../glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, then cancelling <em class="parameter"><code>task</code></em>
|
|
1444
1444
|
's
|
|
1445
1445
|
<a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> will immediately cause it to return, as though the
|
|
1446
1446
|
task's <a class="link" href="GTask.html#GTaskThreadFunc" title="GTaskThreadFunc ()"><span class="type">GTaskThreadFunc</span></a> had called
|
|
@@ -1450,20 +1450,20 @@ uninterruptable function. The <a class="link" href="GTask.html#GTaskThreadFunc"
|
|
|
1450
1450
|
careful that it does not modify any externally-visible state after
|
|
1451
1451
|
it has been cancelled. To do that, the thread should call
|
|
1452
1452
|
<a class="link" href="GTask.html#g-task-set-return-on-cancel" title="g_task_set_return_on_cancel ()"><code class="function">g_task_set_return_on_cancel()</code></a> again to (atomically) set
|
|
1453
|
-
return-on-cancel <a href="../glib
|
|
1453
|
+
return-on-cancel <a href="../glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> before making externally-visible changes;
|
|
1454
1454
|
if the task gets cancelled before the return-on-cancel flag could
|
|
1455
1455
|
be changed, <a class="link" href="GTask.html#g-task-set-return-on-cancel" title="g_task_set_return_on_cancel ()"><code class="function">g_task_set_return_on_cancel()</code></a> will indicate this by
|
|
1456
|
-
returning <a href="../glib
|
|
1456
|
+
returning <a href="../glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>.</p>
|
|
1457
1457
|
<p>You can disable and re-enable this flag multiple times if you wish.
|
|
1458
1458
|
If the task's <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> is cancelled while return-on-cancel is
|
|
1459
|
-
<a href="../glib
|
|
1459
|
+
<a href="../glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>, then calling <a class="link" href="GTask.html#g-task-set-return-on-cancel" title="g_task_set_return_on_cancel ()"><code class="function">g_task_set_return_on_cancel()</code></a> to set it <a href="../glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>
|
|
1460
1460
|
again will cause the task to be cancelled at that point.</p>
|
|
1461
1461
|
<p>If the task's <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> is already cancelled before you call
|
|
1462
1462
|
<a class="link" href="GTask.html#g-task-run-in-thread" title="g_task_run_in_thread ()"><code class="function">g_task_run_in_thread()</code></a>/<a class="link" href="GTask.html#g-task-run-in-thread-sync" title="g_task_run_in_thread_sync ()"><code class="function">g_task_run_in_thread_sync()</code></a>, then the
|
|
1463
1463
|
<a class="link" href="GTask.html#GTaskThreadFunc" title="GTaskThreadFunc ()"><span class="type">GTaskThreadFunc</span></a> will still be run (for consistency), but the task
|
|
1464
1464
|
will also be completed right away.</p>
|
|
1465
1465
|
<div class="refsect3">
|
|
1466
|
-
<a name="
|
|
1466
|
+
<a name="g-task-set-return-on-cancel.parameters"></a><h4>Parameters</h4>
|
|
1467
1467
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
|
1468
1468
|
<colgroup>
|
|
1469
1469
|
<col width="150px" class="parameters_name">
|
|
@@ -1486,11 +1486,11 @@ it is cancelled.</p></td>
|
|
|
1486
1486
|
</table></div>
|
|
1487
1487
|
</div>
|
|
1488
1488
|
<div class="refsect3">
|
|
1489
|
-
<a name="
|
|
1490
|
-
<p> <a href="../glib
|
|
1489
|
+
<a name="g-task-set-return-on-cancel.returns"></a><h4>Returns</h4>
|
|
1490
|
+
<p> <a href="../glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if <em class="parameter"><code>task</code></em>
|
|
1491
1491
|
's return-on-cancel flag was changed to
|
|
1492
1492
|
match <em class="parameter"><code>return_on_cancel</code></em>
|
|
1493
|
-
. <a href="../glib
|
|
1493
|
+
. <a href="../glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if <em class="parameter"><code>task</code></em>
|
|
1494
1494
|
has already been
|
|
1495
1495
|
cancelled.</p>
|
|
1496
1496
|
</div>
|
|
@@ -1501,7 +1501,7 @@ cancelled.</p>
|
|
|
1501
1501
|
<a name="g-task-set-source-tag"></a><h3>g_task_set_source_tag ()</h3>
|
|
1502
1502
|
<pre class="programlisting"><span class="returnvalue">void</span>
|
|
1503
1503
|
g_task_set_source_tag (<em class="parameter"><code><a class="link" href="GTask.html" title="GTask"><span class="type">GTask</span></a> *task</code></em>,
|
|
1504
|
-
<em class="parameter"><code><a href="../glib
|
|
1504
|
+
<em class="parameter"><code><a href="../glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> source_tag</code></em>);</pre>
|
|
1505
1505
|
<p>Sets <em class="parameter"><code>task</code></em>
|
|
1506
1506
|
's source tag. You can use this to tag a task return
|
|
1507
1507
|
value with a particular pointer (usually a pointer to the function
|
|
@@ -1510,7 +1510,7 @@ doing the tagging) and then later check it using
|
|
|
1510
1510
|
task's "finish" function, to figure out if the response came from a
|
|
1511
1511
|
particular place.</p>
|
|
1512
1512
|
<div class="refsect3">
|
|
1513
|
-
<a name="
|
|
1513
|
+
<a name="g-task-set-source-tag.parameters"></a><h4>Parameters</h4>
|
|
1514
1514
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
|
1515
1515
|
<colgroup>
|
|
1516
1516
|
<col width="150px" class="parameters_name">
|
|
@@ -1537,11 +1537,11 @@ particular place.</p>
|
|
|
1537
1537
|
<div class="refsect2">
|
|
1538
1538
|
<a name="g-task-report-error"></a><h3>g_task_report_error ()</h3>
|
|
1539
1539
|
<pre class="programlisting"><span class="returnvalue">void</span>
|
|
1540
|
-
g_task_report_error (<em class="parameter"><code><a href="../glib
|
|
1540
|
+
g_task_report_error (<em class="parameter"><code><a href="../glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> source_object</code></em>,
|
|
1541
1541
|
<em class="parameter"><code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
|
|
1542
|
-
<em class="parameter"><code><a href="../glib
|
|
1543
|
-
<em class="parameter"><code><a href="../glib
|
|
1544
|
-
<em class="parameter"><code><a href="../glib
|
|
1542
|
+
<em class="parameter"><code><a href="../glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> callback_data</code></em>,
|
|
1543
|
+
<em class="parameter"><code><a href="../glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> source_tag</code></em>,
|
|
1544
|
+
<em class="parameter"><code><a href="../glib-Error-Reporting.html#GError"><span class="type">GError</span></a> *error</code></em>);</pre>
|
|
1545
1545
|
<p>Creates a <a class="link" href="GTask.html" title="GTask"><span class="type">GTask</span></a> and then immediately calls <a class="link" href="GTask.html#g-task-return-error" title="g_task_return_error ()"><code class="function">g_task_return_error()</code></a>
|
|
1546
1546
|
on it. Use this in the wrapper function of an asynchronous method
|
|
1547
1547
|
when you want to avoid even calling the virtual method. You can
|
|
@@ -1550,7 +1550,7 @@ check if the result there is tagged as having been created by the
|
|
|
1550
1550
|
wrapper method, and deal with it appropriately if so.</p>
|
|
1551
1551
|
<p>See also <a class="link" href="GTask.html#g-task-report-new-error" title="g_task_report_new_error ()"><code class="function">g_task_report_new_error()</code></a>.</p>
|
|
1552
1552
|
<div class="refsect3">
|
|
1553
|
-
<a name="
|
|
1553
|
+
<a name="g-task-report-error.parameters"></a><h4>Parameters</h4>
|
|
1554
1554
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
|
1555
1555
|
<colgroup>
|
|
1556
1556
|
<col width="150px" class="parameters_name">
|
|
@@ -1560,8 +1560,8 @@ wrapper method, and deal with it appropriately if so.</p>
|
|
|
1560
1560
|
<tbody>
|
|
1561
1561
|
<tr>
|
|
1562
1562
|
<td class="parameter_name"><p>source_object</p></td>
|
|
1563
|
-
<td class="parameter_description"><p> the <a href="../gobject
|
|
1564
|
-
this task, or <a href="../glib
|
|
1563
|
+
<td class="parameter_description"><p> the <a href="../gobject-The-Base-Object-Type.html#GObject-struct"><span class="type">GObject</span></a> that owns
|
|
1564
|
+
this task, or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
|
|
1565
1565
|
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>][<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> GObject]</span></td>
|
|
1566
1566
|
</tr>
|
|
1567
1567
|
<tr>
|
|
@@ -1594,12 +1594,12 @@ this task, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class=
|
|
|
1594
1594
|
<div class="refsect2">
|
|
1595
1595
|
<a name="g-task-report-new-error"></a><h3>g_task_report_new_error ()</h3>
|
|
1596
1596
|
<pre class="programlisting"><span class="returnvalue">void</span>
|
|
1597
|
-
g_task_report_new_error (<em class="parameter"><code><a href="../glib
|
|
1597
|
+
g_task_report_new_error (<em class="parameter"><code><a href="../glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> source_object</code></em>,
|
|
1598
1598
|
<em class="parameter"><code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
|
|
1599
|
-
<em class="parameter"><code><a href="../glib
|
|
1600
|
-
<em class="parameter"><code><a href="../glib
|
|
1601
|
-
<em class="parameter"><code><a href="../glib
|
|
1602
|
-
<em class="parameter"><code><a href="../glib
|
|
1599
|
+
<em class="parameter"><code><a href="../glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> callback_data</code></em>,
|
|
1600
|
+
<em class="parameter"><code><a href="../glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> source_tag</code></em>,
|
|
1601
|
+
<em class="parameter"><code><a href="../glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> domain</code></em>,
|
|
1602
|
+
<em class="parameter"><code><a href="../glib-Basic-Types.html#gint"><span class="type">gint</span></a> code</code></em>,
|
|
1603
1603
|
<em class="parameter"><code>const <span class="type">char</span> *format</code></em>,
|
|
1604
1604
|
<em class="parameter"><code>...</code></em>);</pre>
|
|
1605
1605
|
<p>Creates a <a class="link" href="GTask.html" title="GTask"><span class="type">GTask</span></a> and then immediately calls
|
|
@@ -1611,7 +1611,7 @@ having been created by the wrapper method, and deal with it
|
|
|
1611
1611
|
appropriately if so.</p>
|
|
1612
1612
|
<p>See also <a class="link" href="GTask.html#g-task-report-error" title="g_task_report_error ()"><code class="function">g_task_report_error()</code></a>.</p>
|
|
1613
1613
|
<div class="refsect3">
|
|
1614
|
-
<a name="
|
|
1614
|
+
<a name="g-task-report-new-error.parameters"></a><h4>Parameters</h4>
|
|
1615
1615
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
|
1616
1616
|
<colgroup>
|
|
1617
1617
|
<col width="150px" class="parameters_name">
|
|
@@ -1621,8 +1621,8 @@ appropriately if so.</p>
|
|
|
1621
1621
|
<tbody>
|
|
1622
1622
|
<tr>
|
|
1623
1623
|
<td class="parameter_name"><p>source_object</p></td>
|
|
1624
|
-
<td class="parameter_description"><p> the <a href="../gobject
|
|
1625
|
-
this task, or <a href="../glib
|
|
1624
|
+
<td class="parameter_description"><p> the <a href="../gobject-The-Base-Object-Type.html#GObject-struct"><span class="type">GObject</span></a> that owns
|
|
1625
|
+
this task, or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
|
|
1626
1626
|
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>][<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> GObject]</span></td>
|
|
1627
1627
|
</tr>
|
|
1628
1628
|
<tr>
|
|
@@ -1643,7 +1643,7 @@ this task, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class=
|
|
|
1643
1643
|
</tr>
|
|
1644
1644
|
<tr>
|
|
1645
1645
|
<td class="parameter_name"><p>domain</p></td>
|
|
1646
|
-
<td class="parameter_description"><p>a <a href="../glib
|
|
1646
|
+
<td class="parameter_description"><p>a <a href="../glib-Quarks.html#GQuark"><span class="type">GQuark</span></a>.</p></td>
|
|
1647
1647
|
<td class="parameter_annotations"> </td>
|
|
1648
1648
|
</tr>
|
|
1649
1649
|
<tr>
|
|
@@ -1670,12 +1670,12 @@ this task, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class=
|
|
|
1670
1670
|
<hr>
|
|
1671
1671
|
<div class="refsect2">
|
|
1672
1672
|
<a name="g-task-get-task-data"></a><h3>g_task_get_task_data ()</h3>
|
|
1673
|
-
<pre class="programlisting"><a href="../glib
|
|
1673
|
+
<pre class="programlisting"><a href="../glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a>
|
|
1674
1674
|
g_task_get_task_data (<em class="parameter"><code><a class="link" href="GTask.html" title="GTask"><span class="type">GTask</span></a> *task</code></em>);</pre>
|
|
1675
1675
|
<p>Gets <em class="parameter"><code>task</code></em>
|
|
1676
1676
|
's <code class="literal">task_data</code>.</p>
|
|
1677
1677
|
<div class="refsect3">
|
|
1678
|
-
<a name="
|
|
1678
|
+
<a name="g-task-get-task-data.parameters"></a><h4>Parameters</h4>
|
|
1679
1679
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
|
1680
1680
|
<colgroup>
|
|
1681
1681
|
<col width="150px" class="parameters_name">
|
|
@@ -1690,7 +1690,7 @@ g_task_get_task_data (<em class="parameter"><code><a class="link" href="GTask.ht
|
|
|
1690
1690
|
</table></div>
|
|
1691
1691
|
</div>
|
|
1692
1692
|
<div class="refsect3">
|
|
1693
|
-
<a name="
|
|
1693
|
+
<a name="g-task-get-task-data.returns"></a><h4>Returns</h4>
|
|
1694
1694
|
<p> <em class="parameter"><code>task</code></em>
|
|
1695
1695
|
's <code class="literal">task_data</code>. </p>
|
|
1696
1696
|
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
|
|
@@ -1700,12 +1700,12 @@ g_task_get_task_data (<em class="parameter"><code><a class="link" href="GTask.ht
|
|
|
1700
1700
|
<hr>
|
|
1701
1701
|
<div class="refsect2">
|
|
1702
1702
|
<a name="g-task-get-priority"></a><h3>g_task_get_priority ()</h3>
|
|
1703
|
-
<pre class="programlisting"><a href="../glib
|
|
1703
|
+
<pre class="programlisting"><a href="../glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
|
|
1704
1704
|
g_task_get_priority (<em class="parameter"><code><a class="link" href="GTask.html" title="GTask"><span class="type">GTask</span></a> *task</code></em>);</pre>
|
|
1705
1705
|
<p>Gets <em class="parameter"><code>task</code></em>
|
|
1706
1706
|
's priority</p>
|
|
1707
1707
|
<div class="refsect3">
|
|
1708
|
-
<a name="
|
|
1708
|
+
<a name="g-task-get-priority.parameters"></a><h4>Parameters</h4>
|
|
1709
1709
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
|
1710
1710
|
<colgroup>
|
|
1711
1711
|
<col width="150px" class="parameters_name">
|
|
@@ -1720,7 +1720,7 @@ g_task_get_priority (<em class="parameter"><code><a class="link" href="GTask.htm
|
|
|
1720
1720
|
</table></div>
|
|
1721
1721
|
</div>
|
|
1722
1722
|
<div class="refsect3">
|
|
1723
|
-
<a name="
|
|
1723
|
+
<a name="g-task-get-priority.returns"></a><h4>Returns</h4>
|
|
1724
1724
|
<p> <em class="parameter"><code>task</code></em>
|
|
1725
1725
|
's priority</p>
|
|
1726
1726
|
</div>
|
|
@@ -1734,7 +1734,7 @@ g_task_get_cancellable (<em class="parameter"><code><a class="link" href="GTask.
|
|
|
1734
1734
|
<p>Gets <em class="parameter"><code>task</code></em>
|
|
1735
1735
|
's <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a></p>
|
|
1736
1736
|
<div class="refsect3">
|
|
1737
|
-
<a name="
|
|
1737
|
+
<a name="g-task-get-cancellable.parameters"></a><h4>Parameters</h4>
|
|
1738
1738
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
|
1739
1739
|
<colgroup>
|
|
1740
1740
|
<col width="150px" class="parameters_name">
|
|
@@ -1749,7 +1749,7 @@ g_task_get_cancellable (<em class="parameter"><code><a class="link" href="GTask.
|
|
|
1749
1749
|
</table></div>
|
|
1750
1750
|
</div>
|
|
1751
1751
|
<div class="refsect3">
|
|
1752
|
-
<a name="
|
|
1752
|
+
<a name="g-task-get-cancellable.returns"></a><h4>Returns</h4>
|
|
1753
1753
|
<p> <em class="parameter"><code>task</code></em>
|
|
1754
1754
|
's <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a>. </p>
|
|
1755
1755
|
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
|
|
@@ -1759,13 +1759,13 @@ g_task_get_cancellable (<em class="parameter"><code><a class="link" href="GTask.
|
|
|
1759
1759
|
<hr>
|
|
1760
1760
|
<div class="refsect2">
|
|
1761
1761
|
<a name="g-task-get-check-cancellable"></a><h3>g_task_get_check_cancellable ()</h3>
|
|
1762
|
-
<pre class="programlisting"><a href="../glib
|
|
1762
|
+
<pre class="programlisting"><a href="../glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
|
|
1763
1763
|
g_task_get_check_cancellable (<em class="parameter"><code><a class="link" href="GTask.html" title="GTask"><span class="type">GTask</span></a> *task</code></em>);</pre>
|
|
1764
1764
|
<p>Gets <em class="parameter"><code>task</code></em>
|
|
1765
1765
|
's check-cancellable flag. See
|
|
1766
1766
|
<a class="link" href="GTask.html#g-task-set-check-cancellable" title="g_task_set_check_cancellable ()"><code class="function">g_task_set_check_cancellable()</code></a> for more details.</p>
|
|
1767
1767
|
<div class="refsect3">
|
|
1768
|
-
<a name="
|
|
1768
|
+
<a name="g-task-get-check-cancellable.parameters"></a><h4>Parameters</h4>
|
|
1769
1769
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
|
1770
1770
|
<colgroup>
|
|
1771
1771
|
<col width="150px" class="parameters_name">
|
|
@@ -1784,13 +1784,13 @@ g_task_get_check_cancellable (<em class="parameter"><code><a class="link" href="
|
|
|
1784
1784
|
<hr>
|
|
1785
1785
|
<div class="refsect2">
|
|
1786
1786
|
<a name="g-task-get-return-on-cancel"></a><h3>g_task_get_return_on_cancel ()</h3>
|
|
1787
|
-
<pre class="programlisting"><a href="../glib
|
|
1787
|
+
<pre class="programlisting"><a href="../glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
|
|
1788
1788
|
g_task_get_return_on_cancel (<em class="parameter"><code><a class="link" href="GTask.html" title="GTask"><span class="type">GTask</span></a> *task</code></em>);</pre>
|
|
1789
1789
|
<p>Gets <em class="parameter"><code>task</code></em>
|
|
1790
1790
|
's return-on-cancel flag. See
|
|
1791
1791
|
<a class="link" href="GTask.html#g-task-set-return-on-cancel" title="g_task_set_return_on_cancel ()"><code class="function">g_task_set_return_on_cancel()</code></a> for more details.</p>
|
|
1792
1792
|
<div class="refsect3">
|
|
1793
|
-
<a name="
|
|
1793
|
+
<a name="g-task-get-return-on-cancel.parameters"></a><h4>Parameters</h4>
|
|
1794
1794
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
|
1795
1795
|
<colgroup>
|
|
1796
1796
|
<col width="150px" class="parameters_name">
|
|
@@ -1809,18 +1809,18 @@ g_task_get_return_on_cancel (<em class="parameter"><code><a class="link" href="G
|
|
|
1809
1809
|
<hr>
|
|
1810
1810
|
<div class="refsect2">
|
|
1811
1811
|
<a name="g-task-get-context"></a><h3>g_task_get_context ()</h3>
|
|
1812
|
-
<pre class="programlisting"><a href="../glib
|
|
1812
|
+
<pre class="programlisting"><a href="../glib-The-Main-Event-Loop.html#GMainContext"><span class="returnvalue">GMainContext</span></a> *
|
|
1813
1813
|
g_task_get_context (<em class="parameter"><code><a class="link" href="GTask.html" title="GTask"><span class="type">GTask</span></a> *task</code></em>);</pre>
|
|
1814
|
-
<p>Gets the <a href="../glib
|
|
1814
|
+
<p>Gets the <a href="../glib-The-Main-Event-Loop.html#GMainContext"><span class="type">GMainContext</span></a> that <em class="parameter"><code>task</code></em>
|
|
1815
1815
|
will return its result in (that
|
|
1816
1816
|
is, the context that was the
|
|
1817
|
-
<a href="../glib
|
|
1817
|
+
<a href="../glib-The-Main-Event-Loop.html#g-main-context-push-thread-default">thread-default main context</a>
|
|
1818
1818
|
at the point when <em class="parameter"><code>task</code></em>
|
|
1819
1819
|
was created).</p>
|
|
1820
|
-
<p>This will always return a non-<a href="../glib
|
|
1821
|
-
context is the default <a href="../glib
|
|
1820
|
+
<p>This will always return a non-<a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> value, even if the task's
|
|
1821
|
+
context is the default <a href="../glib-The-Main-Event-Loop.html#GMainContext"><span class="type">GMainContext</span></a>.</p>
|
|
1822
1822
|
<div class="refsect3">
|
|
1823
|
-
<a name="
|
|
1823
|
+
<a name="g-task-get-context.parameters"></a><h4>Parameters</h4>
|
|
1824
1824
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
|
1825
1825
|
<colgroup>
|
|
1826
1826
|
<col width="150px" class="parameters_name">
|
|
@@ -1835,9 +1835,9 @@ context is the default <a href="../glib/glib-The-Main-Event-Loop.html#GMainConte
|
|
|
1835
1835
|
</table></div>
|
|
1836
1836
|
</div>
|
|
1837
1837
|
<div class="refsect3">
|
|
1838
|
-
<a name="
|
|
1838
|
+
<a name="g-task-get-context.returns"></a><h4>Returns</h4>
|
|
1839
1839
|
<p> <em class="parameter"><code>task</code></em>
|
|
1840
|
-
's <a href="../glib
|
|
1840
|
+
's <a href="../glib-The-Main-Event-Loop.html#GMainContext"><span class="type">GMainContext</span></a>. </p>
|
|
1841
1841
|
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
|
|
1842
1842
|
</div>
|
|
1843
1843
|
<p class="since">Since: <a class="link" href="api-index-2-36.html#api-index-2.36">2.36</a></p>
|
|
@@ -1845,13 +1845,13 @@ context is the default <a href="../glib/glib-The-Main-Event-Loop.html#GMainConte
|
|
|
1845
1845
|
<hr>
|
|
1846
1846
|
<div class="refsect2">
|
|
1847
1847
|
<a name="g-task-get-source-object"></a><h3>g_task_get_source_object ()</h3>
|
|
1848
|
-
<pre class="programlisting"><a href="../glib
|
|
1848
|
+
<pre class="programlisting"><a href="../glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a>
|
|
1849
1849
|
g_task_get_source_object (<em class="parameter"><code><a class="link" href="GTask.html" title="GTask"><span class="type">GTask</span></a> *task</code></em>);</pre>
|
|
1850
1850
|
<p>Gets the source object from <em class="parameter"><code>task</code></em>
|
|
1851
1851
|
. Like
|
|
1852
1852
|
<a class="link" href="GAsyncResult.html#g-async-result-get-source-object" title="g_async_result_get_source_object ()"><code class="function">g_async_result_get_source_object()</code></a>, but does not ref the object.</p>
|
|
1853
1853
|
<div class="refsect3">
|
|
1854
|
-
<a name="
|
|
1854
|
+
<a name="g-task-get-source-object.parameters"></a><h4>Parameters</h4>
|
|
1855
1855
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
|
1856
1856
|
<colgroup>
|
|
1857
1857
|
<col width="150px" class="parameters_name">
|
|
@@ -1866,9 +1866,9 @@ g_task_get_source_object (<em class="parameter"><code><a class="link" href="GTas
|
|
|
1866
1866
|
</table></div>
|
|
1867
1867
|
</div>
|
|
1868
1868
|
<div class="refsect3">
|
|
1869
|
-
<a name="
|
|
1869
|
+
<a name="g-task-get-source-object.returns"></a><h4>Returns</h4>
|
|
1870
1870
|
<p> <em class="parameter"><code>task</code></em>
|
|
1871
|
-
's source object, or <a href="../glib
|
|
1871
|
+
's source object, or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p>
|
|
1872
1872
|
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>][<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> GObject]</span></p>
|
|
1873
1873
|
</div>
|
|
1874
1874
|
<p class="since">Since: <a class="link" href="api-index-2-36.html#api-index-2.36">2.36</a></p>
|
|
@@ -1876,12 +1876,12 @@ g_task_get_source_object (<em class="parameter"><code><a class="link" href="GTas
|
|
|
1876
1876
|
<hr>
|
|
1877
1877
|
<div class="refsect2">
|
|
1878
1878
|
<a name="g-task-get-source-tag"></a><h3>g_task_get_source_tag ()</h3>
|
|
1879
|
-
<pre class="programlisting"><a href="../glib
|
|
1879
|
+
<pre class="programlisting"><a href="../glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a>
|
|
1880
1880
|
g_task_get_source_tag (<em class="parameter"><code><a class="link" href="GTask.html" title="GTask"><span class="type">GTask</span></a> *task</code></em>);</pre>
|
|
1881
1881
|
<p>Gets <em class="parameter"><code>task</code></em>
|
|
1882
1882
|
's source tag. See <a class="link" href="GTask.html#g-task-set-source-tag" title="g_task_set_source_tag ()"><code class="function">g_task_set_source_tag()</code></a>.</p>
|
|
1883
1883
|
<div class="refsect3">
|
|
1884
|
-
<a name="
|
|
1884
|
+
<a name="g-task-get-source-tag.parameters"></a><h4>Parameters</h4>
|
|
1885
1885
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
|
1886
1886
|
<colgroup>
|
|
1887
1887
|
<col width="150px" class="parameters_name">
|
|
@@ -1896,7 +1896,7 @@ g_task_get_source_tag (<em class="parameter"><code><a class="link" href="GTask.h
|
|
|
1896
1896
|
</table></div>
|
|
1897
1897
|
</div>
|
|
1898
1898
|
<div class="refsect3">
|
|
1899
|
-
<a name="
|
|
1899
|
+
<a name="g-task-get-source-tag.returns"></a><h4>Returns</h4>
|
|
1900
1900
|
<p> <em class="parameter"><code>task</code></em>
|
|
1901
1901
|
's source tag. </p>
|
|
1902
1902
|
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
|
|
@@ -1908,14 +1908,14 @@ g_task_get_source_tag (<em class="parameter"><code><a class="link" href="GTask.h
|
|
|
1908
1908
|
<a name="g-task-return-boolean"></a><h3>g_task_return_boolean ()</h3>
|
|
1909
1909
|
<pre class="programlisting"><span class="returnvalue">void</span>
|
|
1910
1910
|
g_task_return_boolean (<em class="parameter"><code><a class="link" href="GTask.html" title="GTask"><span class="type">GTask</span></a> *task</code></em>,
|
|
1911
|
-
<em class="parameter"><code><a href="../glib
|
|
1911
|
+
<em class="parameter"><code><a href="../glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> result</code></em>);</pre>
|
|
1912
1912
|
<p>Sets <em class="parameter"><code>task</code></em>
|
|
1913
1913
|
's result to <em class="parameter"><code>result</code></em>
|
|
1914
1914
|
and completes the task (see
|
|
1915
1915
|
<a class="link" href="GTask.html#g-task-return-pointer" title="g_task_return_pointer ()"><code class="function">g_task_return_pointer()</code></a> for more discussion of exactly what this
|
|
1916
1916
|
means).</p>
|
|
1917
1917
|
<div class="refsect3">
|
|
1918
|
-
<a name="
|
|
1918
|
+
<a name="g-task-return-boolean.parameters"></a><h4>Parameters</h4>
|
|
1919
1919
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
|
1920
1920
|
<colgroup>
|
|
1921
1921
|
<col width="150px" class="parameters_name">
|
|
@@ -1930,7 +1930,7 @@ means).</p>
|
|
|
1930
1930
|
</tr>
|
|
1931
1931
|
<tr>
|
|
1932
1932
|
<td class="parameter_name"><p>result</p></td>
|
|
1933
|
-
<td class="parameter_description"><p>the <a href="../glib
|
|
1933
|
+
<td class="parameter_description"><p>the <a href="../glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> result of a task function.</p></td>
|
|
1934
1934
|
<td class="parameter_annotations"> </td>
|
|
1935
1935
|
</tr>
|
|
1936
1936
|
</tbody>
|
|
@@ -1943,14 +1943,14 @@ means).</p>
|
|
|
1943
1943
|
<a name="g-task-return-int"></a><h3>g_task_return_int ()</h3>
|
|
1944
1944
|
<pre class="programlisting"><span class="returnvalue">void</span>
|
|
1945
1945
|
g_task_return_int (<em class="parameter"><code><a class="link" href="GTask.html" title="GTask"><span class="type">GTask</span></a> *task</code></em>,
|
|
1946
|
-
<em class="parameter"><code><a href="../glib
|
|
1946
|
+
<em class="parameter"><code><a href="../glib-Basic-Types.html#gssize"><span class="type">gssize</span></a> result</code></em>);</pre>
|
|
1947
1947
|
<p>Sets <em class="parameter"><code>task</code></em>
|
|
1948
1948
|
's result to <em class="parameter"><code>result</code></em>
|
|
1949
1949
|
and completes the task (see
|
|
1950
1950
|
<a class="link" href="GTask.html#g-task-return-pointer" title="g_task_return_pointer ()"><code class="function">g_task_return_pointer()</code></a> for more discussion of exactly what this
|
|
1951
1951
|
means).</p>
|
|
1952
1952
|
<div class="refsect3">
|
|
1953
|
-
<a name="
|
|
1953
|
+
<a name="g-task-return-int.parameters"></a><h4>Parameters</h4>
|
|
1954
1954
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
|
1955
1955
|
<colgroup>
|
|
1956
1956
|
<col width="150px" class="parameters_name">
|
|
@@ -1965,7 +1965,7 @@ means).</p>
|
|
|
1965
1965
|
</tr>
|
|
1966
1966
|
<tr>
|
|
1967
1967
|
<td class="parameter_name"><p>result</p></td>
|
|
1968
|
-
<td class="parameter_description"><p>the integer (<a href="../glib
|
|
1968
|
+
<td class="parameter_description"><p>the integer (<a href="../glib-Basic-Types.html#gssize"><span class="type">gssize</span></a>) result of a task function.</p></td>
|
|
1969
1969
|
<td class="parameter_annotations"> </td>
|
|
1970
1970
|
</tr>
|
|
1971
1971
|
</tbody>
|
|
@@ -1978,21 +1978,21 @@ means).</p>
|
|
|
1978
1978
|
<a name="g-task-return-pointer"></a><h3>g_task_return_pointer ()</h3>
|
|
1979
1979
|
<pre class="programlisting"><span class="returnvalue">void</span>
|
|
1980
1980
|
g_task_return_pointer (<em class="parameter"><code><a class="link" href="GTask.html" title="GTask"><span class="type">GTask</span></a> *task</code></em>,
|
|
1981
|
-
<em class="parameter"><code><a href="../glib
|
|
1982
|
-
<em class="parameter"><code><a href="../glib
|
|
1981
|
+
<em class="parameter"><code><a href="../glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> result</code></em>,
|
|
1982
|
+
<em class="parameter"><code><a href="../glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> result_destroy</code></em>);</pre>
|
|
1983
1983
|
<p>Sets <em class="parameter"><code>task</code></em>
|
|
1984
1984
|
's result to <em class="parameter"><code>result</code></em>
|
|
1985
1985
|
and completes the task. If <em class="parameter"><code>result</code></em>
|
|
1986
1986
|
|
|
1987
|
-
is not <a href="../glib
|
|
1987
|
+
is not <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then <em class="parameter"><code>result_destroy</code></em>
|
|
1988
1988
|
will be used to free <em class="parameter"><code>result</code></em>
|
|
1989
1989
|
if
|
|
1990
1990
|
the caller does not take ownership of it with
|
|
1991
1991
|
<a class="link" href="GTask.html#g-task-propagate-pointer" title="g_task_propagate_pointer ()"><code class="function">g_task_propagate_pointer()</code></a>.</p>
|
|
1992
1992
|
<p>"Completes the task" means that for an ordinary asynchronous task
|
|
1993
1993
|
it will either invoke the task's callback, or else queue that
|
|
1994
|
-
callback to be invoked in the proper <a href="../glib
|
|
1995
|
-
iteration of the current <a href="../glib
|
|
1994
|
+
callback to be invoked in the proper <a href="../glib-The-Main-Event-Loop.html#GMainContext"><span class="type">GMainContext</span></a>, or in the next
|
|
1995
|
+
iteration of the current <a href="../glib-The-Main-Event-Loop.html#GMainContext"><span class="type">GMainContext</span></a>. For a task run via
|
|
1996
1996
|
<a class="link" href="GTask.html#g-task-run-in-thread" title="g_task_run_in_thread ()"><code class="function">g_task_run_in_thread()</code></a> or <a class="link" href="GTask.html#g-task-run-in-thread-sync" title="g_task_run_in_thread_sync ()"><code class="function">g_task_run_in_thread_sync()</code></a>, calling this
|
|
1997
1997
|
method will save <em class="parameter"><code>result</code></em>
|
|
1998
1998
|
to be returned to the caller later, but
|
|
@@ -2004,7 +2004,7 @@ exits.</p>
|
|
|
2004
2004
|
valid after calling this, unless you are still holding another
|
|
2005
2005
|
reference on it.</p>
|
|
2006
2006
|
<div class="refsect3">
|
|
2007
|
-
<a name="
|
|
2007
|
+
<a name="g-task-return-pointer.parameters"></a><h4>Parameters</h4>
|
|
2008
2008
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
|
2009
2009
|
<colgroup>
|
|
2010
2010
|
<col width="150px" class="parameters_name">
|
|
@@ -2025,7 +2025,7 @@ function. </p></td>
|
|
|
2025
2025
|
</tr>
|
|
2026
2026
|
<tr>
|
|
2027
2027
|
<td class="parameter_name"><p>result_destroy</p></td>
|
|
2028
|
-
<td class="parameter_description"><p> a <a href="../glib
|
|
2028
|
+
<td class="parameter_description"><p> a <a href="../glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> function. </p></td>
|
|
2029
2029
|
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
|
|
2030
2030
|
</tr>
|
|
2031
2031
|
</tbody>
|
|
@@ -2038,7 +2038,7 @@ function. </p></td>
|
|
|
2038
2038
|
<a name="g-task-return-error"></a><h3>g_task_return_error ()</h3>
|
|
2039
2039
|
<pre class="programlisting"><span class="returnvalue">void</span>
|
|
2040
2040
|
g_task_return_error (<em class="parameter"><code><a class="link" href="GTask.html" title="GTask"><span class="type">GTask</span></a> *task</code></em>,
|
|
2041
|
-
<em class="parameter"><code><a href="../glib
|
|
2041
|
+
<em class="parameter"><code><a href="../glib-Error-Reporting.html#GError"><span class="type">GError</span></a> *error</code></em>);</pre>
|
|
2042
2042
|
<p>Sets <em class="parameter"><code>task</code></em>
|
|
2043
2043
|
's result to <em class="parameter"><code>error</code></em>
|
|
2044
2044
|
(which <em class="parameter"><code>task</code></em>
|
|
@@ -2050,11 +2050,11 @@ discussion of exactly what this means).</p>
|
|
|
2050
2050
|
task may be completed before returning from <a class="link" href="GTask.html#g-task-return-error" title="g_task_return_error ()"><code class="function">g_task_return_error()</code></a>,
|
|
2051
2051
|
you cannot assume that <em class="parameter"><code>error</code></em>
|
|
2052
2052
|
is still valid after calling this.
|
|
2053
|
-
Call <a href="../glib
|
|
2053
|
+
Call <a href="../glib-Error-Reporting.html#g-error-copy"><code class="function">g_error_copy()</code></a> on the error if you need to keep a local copy
|
|
2054
2054
|
as well.</p>
|
|
2055
2055
|
<p>See also <a class="link" href="GTask.html#g-task-return-new-error" title="g_task_return_new_error ()"><code class="function">g_task_return_new_error()</code></a>.</p>
|
|
2056
2056
|
<div class="refsect3">
|
|
2057
|
-
<a name="
|
|
2057
|
+
<a name="g-task-return-error.parameters"></a><h4>Parameters</h4>
|
|
2058
2058
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
|
2059
2059
|
<colgroup>
|
|
2060
2060
|
<col width="150px" class="parameters_name">
|
|
@@ -2069,7 +2069,7 @@ as well.</p>
|
|
|
2069
2069
|
</tr>
|
|
2070
2070
|
<tr>
|
|
2071
2071
|
<td class="parameter_name"><p>error</p></td>
|
|
2072
|
-
<td class="parameter_description"><p> the <a href="../glib
|
|
2072
|
+
<td class="parameter_description"><p> the <a href="../glib-Error-Reporting.html#GError"><span class="type">GError</span></a> result of a task function. </p></td>
|
|
2073
2073
|
<td class="parameter_annotations"><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></td>
|
|
2074
2074
|
</tr>
|
|
2075
2075
|
</tbody>
|
|
@@ -2082,12 +2082,12 @@ as well.</p>
|
|
|
2082
2082
|
<a name="g-task-return-new-error"></a><h3>g_task_return_new_error ()</h3>
|
|
2083
2083
|
<pre class="programlisting"><span class="returnvalue">void</span>
|
|
2084
2084
|
g_task_return_new_error (<em class="parameter"><code><a class="link" href="GTask.html" title="GTask"><span class="type">GTask</span></a> *task</code></em>,
|
|
2085
|
-
<em class="parameter"><code><a href="../glib
|
|
2086
|
-
<em class="parameter"><code><a href="../glib
|
|
2085
|
+
<em class="parameter"><code><a href="../glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> domain</code></em>,
|
|
2086
|
+
<em class="parameter"><code><a href="../glib-Basic-Types.html#gint"><span class="type">gint</span></a> code</code></em>,
|
|
2087
2087
|
<em class="parameter"><code>const <span class="type">char</span> *format</code></em>,
|
|
2088
2088
|
<em class="parameter"><code>...</code></em>);</pre>
|
|
2089
2089
|
<p>Sets <em class="parameter"><code>task</code></em>
|
|
2090
|
-
's result to a new <a href="../glib
|
|
2090
|
+
's result to a new <a href="../glib-Error-Reporting.html#GError"><span class="type">GError</span></a> created from <em class="parameter"><code>domain</code></em>
|
|
2091
2091
|
, <em class="parameter"><code>code</code></em>
|
|
2092
2092
|
,
|
|
2093
2093
|
<em class="parameter"><code>format</code></em>
|
|
@@ -2096,7 +2096,7 @@ g_task_return_new_error (<em class="parameter"><code><a class="link" href="GTask
|
|
|
2096
2096
|
means).</p>
|
|
2097
2097
|
<p>See also <a class="link" href="GTask.html#g-task-return-error" title="g_task_return_error ()"><code class="function">g_task_return_error()</code></a>.</p>
|
|
2098
2098
|
<div class="refsect3">
|
|
2099
|
-
<a name="
|
|
2099
|
+
<a name="g-task-return-new-error.parameters"></a><h4>Parameters</h4>
|
|
2100
2100
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
|
2101
2101
|
<colgroup>
|
|
2102
2102
|
<col width="150px" class="parameters_name">
|
|
@@ -2111,7 +2111,7 @@ means).</p>
|
|
|
2111
2111
|
</tr>
|
|
2112
2112
|
<tr>
|
|
2113
2113
|
<td class="parameter_name"><p>domain</p></td>
|
|
2114
|
-
<td class="parameter_description"><p>a <a href="../glib
|
|
2114
|
+
<td class="parameter_description"><p>a <a href="../glib-Quarks.html#GQuark"><span class="type">GQuark</span></a>.</p></td>
|
|
2115
2115
|
<td class="parameter_annotations"> </td>
|
|
2116
2116
|
</tr>
|
|
2117
2117
|
<tr>
|
|
@@ -2138,7 +2138,7 @@ means).</p>
|
|
|
2138
2138
|
<hr>
|
|
2139
2139
|
<div class="refsect2">
|
|
2140
2140
|
<a name="g-task-return-error-if-cancelled"></a><h3>g_task_return_error_if_cancelled ()</h3>
|
|
2141
|
-
<pre class="programlisting"><a href="../glib
|
|
2141
|
+
<pre class="programlisting"><a href="../glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
|
|
2142
2142
|
g_task_return_error_if_cancelled (<em class="parameter"><code><a class="link" href="GTask.html" title="GTask"><span class="type">GTask</span></a> *task</code></em>);</pre>
|
|
2143
2143
|
<p>Checks if <em class="parameter"><code>task</code></em>
|
|
2144
2144
|
's <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> has been cancelled, and if so, sets
|
|
@@ -2147,7 +2147,7 @@ g_task_return_error_if_cancelled (<em class="parameter"><code><a class="link" hr
|
|
|
2147
2147
|
<a class="link" href="GTask.html#g-task-return-pointer" title="g_task_return_pointer ()"><code class="function">g_task_return_pointer()</code></a> for more discussion of exactly what this
|
|
2148
2148
|
means).</p>
|
|
2149
2149
|
<div class="refsect3">
|
|
2150
|
-
<a name="
|
|
2150
|
+
<a name="g-task-return-error-if-cancelled.parameters"></a><h4>Parameters</h4>
|
|
2151
2151
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
|
2152
2152
|
<colgroup>
|
|
2153
2153
|
<col width="150px" class="parameters_name">
|
|
@@ -2162,27 +2162,27 @@ means).</p>
|
|
|
2162
2162
|
</table></div>
|
|
2163
2163
|
</div>
|
|
2164
2164
|
<div class="refsect3">
|
|
2165
|
-
<a name="
|
|
2166
|
-
<p> <a href="../glib
|
|
2167
|
-
has been cancelled, <a href="../glib
|
|
2165
|
+
<a name="g-task-return-error-if-cancelled.returns"></a><h4>Returns</h4>
|
|
2166
|
+
<p> <a href="../glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if <em class="parameter"><code>task</code></em>
|
|
2167
|
+
has been cancelled, <a href="../glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if not</p>
|
|
2168
2168
|
</div>
|
|
2169
2169
|
<p class="since">Since: <a class="link" href="api-index-2-36.html#api-index-2.36">2.36</a></p>
|
|
2170
2170
|
</div>
|
|
2171
2171
|
<hr>
|
|
2172
2172
|
<div class="refsect2">
|
|
2173
2173
|
<a name="g-task-propagate-boolean"></a><h3>g_task_propagate_boolean ()</h3>
|
|
2174
|
-
<pre class="programlisting"><a href="../glib
|
|
2174
|
+
<pre class="programlisting"><a href="../glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
|
|
2175
2175
|
g_task_propagate_boolean (<em class="parameter"><code><a class="link" href="GTask.html" title="GTask"><span class="type">GTask</span></a> *task</code></em>,
|
|
2176
|
-
<em class="parameter"><code><a href="../glib
|
|
2176
|
+
<em class="parameter"><code><a href="../glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
|
|
2177
2177
|
<p>Gets the result of <em class="parameter"><code>task</code></em>
|
|
2178
|
-
as a <a href="../glib
|
|
2178
|
+
as a <a href="../glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>.</p>
|
|
2179
2179
|
<p>If the task resulted in an error, or was cancelled, then this will
|
|
2180
|
-
instead return <a href="../glib
|
|
2180
|
+
instead return <a href="../glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> and set <em class="parameter"><code>error</code></em>
|
|
2181
2181
|
.</p>
|
|
2182
2182
|
<p>Since this method transfers ownership of the return value (or
|
|
2183
2183
|
error) to the caller, you may only call it once.</p>
|
|
2184
2184
|
<div class="refsect3">
|
|
2185
|
-
<a name="
|
|
2185
|
+
<a name="g-task-propagate-boolean.parameters"></a><h4>Parameters</h4>
|
|
2186
2186
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
|
2187
2187
|
<colgroup>
|
|
2188
2188
|
<col width="150px" class="parameters_name">
|
|
@@ -2197,33 +2197,33 @@ error) to the caller, you may only call it once.</p>
|
|
|
2197
2197
|
</tr>
|
|
2198
2198
|
<tr>
|
|
2199
2199
|
<td class="parameter_name"><p>error</p></td>
|
|
2200
|
-
<td class="parameter_description"><p>return location for a <a href="../glib
|
|
2200
|
+
<td class="parameter_description"><p>return location for a <a href="../glib-Error-Reporting.html#GError"><span class="type">GError</span></a></p></td>
|
|
2201
2201
|
<td class="parameter_annotations"> </td>
|
|
2202
2202
|
</tr>
|
|
2203
2203
|
</tbody>
|
|
2204
2204
|
</table></div>
|
|
2205
2205
|
</div>
|
|
2206
2206
|
<div class="refsect3">
|
|
2207
|
-
<a name="
|
|
2208
|
-
<p> the task result, or <a href="../glib
|
|
2207
|
+
<a name="g-task-propagate-boolean.returns"></a><h4>Returns</h4>
|
|
2208
|
+
<p> the task result, or <a href="../glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> on error</p>
|
|
2209
2209
|
</div>
|
|
2210
2210
|
<p class="since">Since: <a class="link" href="api-index-2-36.html#api-index-2.36">2.36</a></p>
|
|
2211
2211
|
</div>
|
|
2212
2212
|
<hr>
|
|
2213
2213
|
<div class="refsect2">
|
|
2214
2214
|
<a name="g-task-propagate-int"></a><h3>g_task_propagate_int ()</h3>
|
|
2215
|
-
<pre class="programlisting"><a href="../glib
|
|
2215
|
+
<pre class="programlisting"><a href="../glib-Basic-Types.html#gssize"><span class="returnvalue">gssize</span></a>
|
|
2216
2216
|
g_task_propagate_int (<em class="parameter"><code><a class="link" href="GTask.html" title="GTask"><span class="type">GTask</span></a> *task</code></em>,
|
|
2217
|
-
<em class="parameter"><code><a href="../glib
|
|
2217
|
+
<em class="parameter"><code><a href="../glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
|
|
2218
2218
|
<p>Gets the result of <em class="parameter"><code>task</code></em>
|
|
2219
|
-
as an integer (<a href="../glib
|
|
2219
|
+
as an integer (<a href="../glib-Basic-Types.html#gssize"><span class="type">gssize</span></a>).</p>
|
|
2220
2220
|
<p>If the task resulted in an error, or was cancelled, then this will
|
|
2221
2221
|
instead return -1 and set <em class="parameter"><code>error</code></em>
|
|
2222
2222
|
.</p>
|
|
2223
2223
|
<p>Since this method transfers ownership of the return value (or
|
|
2224
2224
|
error) to the caller, you may only call it once.</p>
|
|
2225
2225
|
<div class="refsect3">
|
|
2226
|
-
<a name="
|
|
2226
|
+
<a name="g-task-propagate-int.parameters"></a><h4>Parameters</h4>
|
|
2227
2227
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
|
2228
2228
|
<colgroup>
|
|
2229
2229
|
<col width="150px" class="parameters_name">
|
|
@@ -2238,14 +2238,14 @@ error) to the caller, you may only call it once.</p>
|
|
|
2238
2238
|
</tr>
|
|
2239
2239
|
<tr>
|
|
2240
2240
|
<td class="parameter_name"><p>error</p></td>
|
|
2241
|
-
<td class="parameter_description"><p>return location for a <a href="../glib
|
|
2241
|
+
<td class="parameter_description"><p>return location for a <a href="../glib-Error-Reporting.html#GError"><span class="type">GError</span></a></p></td>
|
|
2242
2242
|
<td class="parameter_annotations"> </td>
|
|
2243
2243
|
</tr>
|
|
2244
2244
|
</tbody>
|
|
2245
2245
|
</table></div>
|
|
2246
2246
|
</div>
|
|
2247
2247
|
<div class="refsect3">
|
|
2248
|
-
<a name="
|
|
2248
|
+
<a name="g-task-propagate-int.returns"></a><h4>Returns</h4>
|
|
2249
2249
|
<p> the task result, or -1 on error</p>
|
|
2250
2250
|
</div>
|
|
2251
2251
|
<p class="since">Since: <a class="link" href="api-index-2-36.html#api-index-2.36">2.36</a></p>
|
|
@@ -2253,19 +2253,19 @@ error) to the caller, you may only call it once.</p>
|
|
|
2253
2253
|
<hr>
|
|
2254
2254
|
<div class="refsect2">
|
|
2255
2255
|
<a name="g-task-propagate-pointer"></a><h3>g_task_propagate_pointer ()</h3>
|
|
2256
|
-
<pre class="programlisting"><a href="../glib
|
|
2256
|
+
<pre class="programlisting"><a href="../glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a>
|
|
2257
2257
|
g_task_propagate_pointer (<em class="parameter"><code><a class="link" href="GTask.html" title="GTask"><span class="type">GTask</span></a> *task</code></em>,
|
|
2258
|
-
<em class="parameter"><code><a href="../glib
|
|
2258
|
+
<em class="parameter"><code><a href="../glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
|
|
2259
2259
|
<p>Gets the result of <em class="parameter"><code>task</code></em>
|
|
2260
2260
|
as a pointer, and transfers ownership
|
|
2261
2261
|
of that value to the caller.</p>
|
|
2262
2262
|
<p>If the task resulted in an error, or was cancelled, then this will
|
|
2263
|
-
instead return <a href="../glib
|
|
2263
|
+
instead return <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> and set <em class="parameter"><code>error</code></em>
|
|
2264
2264
|
.</p>
|
|
2265
2265
|
<p>Since this method transfers ownership of the return value (or
|
|
2266
2266
|
error) to the caller, you may only call it once.</p>
|
|
2267
2267
|
<div class="refsect3">
|
|
2268
|
-
<a name="
|
|
2268
|
+
<a name="g-task-propagate-pointer.parameters"></a><h4>Parameters</h4>
|
|
2269
2269
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
|
2270
2270
|
<colgroup>
|
|
2271
2271
|
<col width="150px" class="parameters_name">
|
|
@@ -2280,15 +2280,15 @@ error) to the caller, you may only call it once.</p>
|
|
|
2280
2280
|
</tr>
|
|
2281
2281
|
<tr>
|
|
2282
2282
|
<td class="parameter_name"><p>error</p></td>
|
|
2283
|
-
<td class="parameter_description"><p>return location for a <a href="../glib
|
|
2283
|
+
<td class="parameter_description"><p>return location for a <a href="../glib-Error-Reporting.html#GError"><span class="type">GError</span></a></p></td>
|
|
2284
2284
|
<td class="parameter_annotations"> </td>
|
|
2285
2285
|
</tr>
|
|
2286
2286
|
</tbody>
|
|
2287
2287
|
</table></div>
|
|
2288
2288
|
</div>
|
|
2289
2289
|
<div class="refsect3">
|
|
2290
|
-
<a name="
|
|
2291
|
-
<p> the task result, or <a href="../glib
|
|
2290
|
+
<a name="g-task-propagate-pointer.returns"></a><h4>Returns</h4>
|
|
2291
|
+
<p> the task result, or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error. </p>
|
|
2292
2292
|
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
|
|
2293
2293
|
</div>
|
|
2294
2294
|
<p class="since">Since: <a class="link" href="api-index-2-36.html#api-index-2.36">2.36</a></p>
|
|
@@ -2296,12 +2296,12 @@ error) to the caller, you may only call it once.</p>
|
|
|
2296
2296
|
<hr>
|
|
2297
2297
|
<div class="refsect2">
|
|
2298
2298
|
<a name="g-task-had-error"></a><h3>g_task_had_error ()</h3>
|
|
2299
|
-
<pre class="programlisting"><a href="../glib
|
|
2299
|
+
<pre class="programlisting"><a href="../glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
|
|
2300
2300
|
g_task_had_error (<em class="parameter"><code><a class="link" href="GTask.html" title="GTask"><span class="type">GTask</span></a> *task</code></em>);</pre>
|
|
2301
2301
|
<p>Tests if <em class="parameter"><code>task</code></em>
|
|
2302
2302
|
resulted in an error.</p>
|
|
2303
2303
|
<div class="refsect3">
|
|
2304
|
-
<a name="
|
|
2304
|
+
<a name="g-task-had-error.parameters"></a><h4>Parameters</h4>
|
|
2305
2305
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
|
2306
2306
|
<colgroup>
|
|
2307
2307
|
<col width="150px" class="parameters_name">
|
|
@@ -2316,21 +2316,21 @@ g_task_had_error (<em class="parameter"><code><a class="link" href="GTask.html"
|
|
|
2316
2316
|
</table></div>
|
|
2317
2317
|
</div>
|
|
2318
2318
|
<div class="refsect3">
|
|
2319
|
-
<a name="
|
|
2320
|
-
<p> <a href="../glib
|
|
2319
|
+
<a name="g-task-had-error.returns"></a><h4>Returns</h4>
|
|
2320
|
+
<p> <a href="../glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the task resulted in an error, <a href="../glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</p>
|
|
2321
2321
|
</div>
|
|
2322
2322
|
<p class="since">Since: <a class="link" href="api-index-2-36.html#api-index-2.36">2.36</a></p>
|
|
2323
2323
|
</div>
|
|
2324
2324
|
<hr>
|
|
2325
2325
|
<div class="refsect2">
|
|
2326
2326
|
<a name="g-task-get-completed"></a><h3>g_task_get_completed ()</h3>
|
|
2327
|
-
<pre class="programlisting"><a href="../glib
|
|
2327
|
+
<pre class="programlisting"><a href="../glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
|
|
2328
2328
|
g_task_get_completed (<em class="parameter"><code><a class="link" href="GTask.html" title="GTask"><span class="type">GTask</span></a> *task</code></em>);</pre>
|
|
2329
|
-
<p>Gets the value of <a class="link" href="GTask.html#GTask--completed" title="The “completed” property"><span class="type">“completed”</span></a>. This changes from <a href="../glib
|
|
2330
|
-
the task’s callback is invoked, and will return <a href="../glib
|
|
2329
|
+
<p>Gets the value of <a class="link" href="GTask.html#GTask--completed" title="The “completed” property"><span class="type">“completed”</span></a>. This changes from <a href="../glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> to <a href="../glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> after
|
|
2330
|
+
the task’s callback is invoked, and will return <a href="../glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if called from inside
|
|
2331
2331
|
the callback.</p>
|
|
2332
2332
|
<div class="refsect3">
|
|
2333
|
-
<a name="
|
|
2333
|
+
<a name="g-task-get-completed.parameters"></a><h4>Parameters</h4>
|
|
2334
2334
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
|
2335
2335
|
<colgroup>
|
|
2336
2336
|
<col width="150px" class="parameters_name">
|
|
@@ -2345,8 +2345,8 @@ the callback.</p>
|
|
|
2345
2345
|
</table></div>
|
|
2346
2346
|
</div>
|
|
2347
2347
|
<div class="refsect3">
|
|
2348
|
-
<a name="
|
|
2349
|
-
<p> <a href="../glib
|
|
2348
|
+
<a name="g-task-get-completed.returns"></a><h4>Returns</h4>
|
|
2349
|
+
<p> <a href="../glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the task has completed, <a href="../glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</p>
|
|
2350
2350
|
</div>
|
|
2351
2351
|
<p class="since">Since: <a class="link" href="api-index-2-44.html#api-index-2.44">2.44</a></p>
|
|
2352
2352
|
</div>
|
|
@@ -2361,7 +2361,7 @@ g_task_run_in_thread (<em class="parameter"><code><a class="link" href="GTask.ht
|
|
|
2361
2361
|
returns, <em class="parameter"><code>task</code></em>
|
|
2362
2362
|
's
|
|
2363
2363
|
<a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> will be invoked in <em class="parameter"><code>task</code></em>
|
|
2364
|
-
's <a href="../glib
|
|
2364
|
+
's <a href="../glib-The-Main-Event-Loop.html#GMainContext"><span class="type">GMainContext</span></a>.</p>
|
|
2365
2365
|
<p>This takes a ref on <em class="parameter"><code>task</code></em>
|
|
2366
2366
|
until the task completes.</p>
|
|
2367
2367
|
<p>See <a class="link" href="GTask.html#GTaskThreadFunc" title="GTaskThreadFunc ()"><span class="type">GTaskThreadFunc</span></a> for more details about how <em class="parameter"><code>task_func</code></em>
|
|
@@ -2372,7 +2372,7 @@ do this. If you have a very large number of tasks to run, but don't
|
|
|
2372
2372
|
want them to all run at once, you should only queue a limited
|
|
2373
2373
|
number of them at a time.</p>
|
|
2374
2374
|
<div class="refsect3">
|
|
2375
|
-
<a name="
|
|
2375
|
+
<a name="g-task-run-in-thread.parameters"></a><h4>Parameters</h4>
|
|
2376
2376
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
|
2377
2377
|
<colgroup>
|
|
2378
2378
|
<col width="150px" class="parameters_name">
|
|
@@ -2408,18 +2408,18 @@ to get the result of <em class="parameter"><code>task_func</code></em>
|
|
|
2408
2408
|
.</p>
|
|
2409
2409
|
<p>See <a class="link" href="GTask.html#GTaskThreadFunc" title="GTaskThreadFunc ()"><span class="type">GTaskThreadFunc</span></a> for more details about how <em class="parameter"><code>task_func</code></em>
|
|
2410
2410
|
is handled.</p>
|
|
2411
|
-
<p>Normally this is used with tasks created with a <a href="../glib
|
|
2411
|
+
<p>Normally this is used with tasks created with a <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
|
|
2412
2412
|
<code class="literal">callback</code>, but note that even if the task does
|
|
2413
2413
|
have a callback, it will not be invoked when <em class="parameter"><code>task_func</code></em>
|
|
2414
2414
|
returns.
|
|
2415
|
-
<a class="link" href="GTask.html#GTask--completed" title="The “completed” property"><span class="type">“completed”</span></a> will be set to <a href="../glib
|
|
2415
|
+
<a class="link" href="GTask.html#GTask--completed" title="The “completed” property"><span class="type">“completed”</span></a> will be set to <a href="../glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> just before this function returns.</p>
|
|
2416
2416
|
<p>Although GLib currently rate-limits the tasks queued via
|
|
2417
2417
|
<a class="link" href="GTask.html#g-task-run-in-thread-sync" title="g_task_run_in_thread_sync ()"><code class="function">g_task_run_in_thread_sync()</code></a>, you should not assume that it will
|
|
2418
2418
|
always do this. If you have a very large number of tasks to run,
|
|
2419
2419
|
but don't want them to all run at once, you should only queue a
|
|
2420
2420
|
limited number of them at a time.</p>
|
|
2421
2421
|
<div class="refsect3">
|
|
2422
|
-
<a name="
|
|
2422
|
+
<a name="g-task-run-in-thread-sync.parameters"></a><h4>Parameters</h4>
|
|
2423
2423
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
|
2424
2424
|
<colgroup>
|
|
2425
2425
|
<col width="150px" class="parameters_name">
|
|
@@ -2447,8 +2447,8 @@ limited number of them at a time.</p>
|
|
|
2447
2447
|
<a name="GTaskThreadFunc"></a><h3>GTaskThreadFunc ()</h3>
|
|
2448
2448
|
<pre class="programlisting"><span class="returnvalue">void</span>
|
|
2449
2449
|
<span class="c_punctuation">(</span>*GTaskThreadFunc<span class="c_punctuation">)</span> (<em class="parameter"><code><a class="link" href="GTask.html" title="GTask"><span class="type">GTask</span></a> *task</code></em>,
|
|
2450
|
-
<em class="parameter"><code><a href="../glib
|
|
2451
|
-
<em class="parameter"><code><a href="../glib
|
|
2450
|
+
<em class="parameter"><code><a href="../glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> source_object</code></em>,
|
|
2451
|
+
<em class="parameter"><code><a href="../glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> task_data</code></em>,
|
|
2452
2452
|
<em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>);</pre>
|
|
2453
2453
|
<p>The prototype for a task function to be run in a thread via
|
|
2454
2454
|
<a class="link" href="GTask.html#g-task-run-in-thread" title="g_task_run_in_thread ()"><code class="function">g_task_run_in_thread()</code></a> or <a class="link" href="GTask.html#g-task-run-in-thread-sync" title="g_task_run_in_thread_sync ()"><code class="function">g_task_run_in_thread_sync()</code></a>.</p>
|
|
@@ -2467,7 +2467,7 @@ externally-visible state in this case. See
|
|
|
2467
2467
|
<a class="link" href="GTask.html#GTaskThreadFunc" title="GTaskThreadFunc ()"><span class="type">GTaskThreadFunc</span></a> returns, not when it calls a
|
|
2468
2468
|
<code class="literal">g_task_return_</code> function.</p>
|
|
2469
2469
|
<div class="refsect3">
|
|
2470
|
-
<a name="
|
|
2470
|
+
<a name="GTaskThreadFunc.parameters"></a><h4>Parameters</h4>
|
|
2471
2471
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
|
2472
2472
|
<colgroup>
|
|
2473
2473
|
<col width="150px" class="parameters_name">
|
|
@@ -2495,7 +2495,7 @@ externally-visible state in this case. See
|
|
|
2495
2495
|
<tr>
|
|
2496
2496
|
<td class="parameter_name"><p>cancellable</p></td>
|
|
2497
2497
|
<td class="parameter_description"><p><em class="parameter"><code>task</code></em>
|
|
2498
|
-
's <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a>, or <a href="../glib
|
|
2498
|
+
's <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a>, or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
|
|
2499
2499
|
<td class="parameter_annotations"> </td>
|
|
2500
2500
|
</tr>
|
|
2501
2501
|
</tbody>
|
|
@@ -2508,13 +2508,13 @@ externally-visible state in this case. See
|
|
|
2508
2508
|
<a name="g-task-attach-source"></a><h3>g_task_attach_source ()</h3>
|
|
2509
2509
|
<pre class="programlisting"><span class="returnvalue">void</span>
|
|
2510
2510
|
g_task_attach_source (<em class="parameter"><code><a class="link" href="GTask.html" title="GTask"><span class="type">GTask</span></a> *task</code></em>,
|
|
2511
|
-
<em class="parameter"><code><a href="../glib
|
|
2512
|
-
<em class="parameter"><code><a href="../glib
|
|
2511
|
+
<em class="parameter"><code><a href="../glib-The-Main-Event-Loop.html#GSource"><span class="type">GSource</span></a> *source</code></em>,
|
|
2512
|
+
<em class="parameter"><code><a href="../glib-The-Main-Event-Loop.html#GSourceFunc"><span class="type">GSourceFunc</span></a> callback</code></em>);</pre>
|
|
2513
2513
|
<p>A utility function for dealing with async operations where you need
|
|
2514
|
-
to wait for a <a href="../glib
|
|
2514
|
+
to wait for a <a href="../glib-The-Main-Event-Loop.html#GSource"><span class="type">GSource</span></a> to trigger. Attaches <em class="parameter"><code>source</code></em>
|
|
2515
2515
|
to <em class="parameter"><code>task</code></em>
|
|
2516
2516
|
's
|
|
2517
|
-
<a href="../glib
|
|
2517
|
+
<a href="../glib-The-Main-Event-Loop.html#GMainContext"><span class="type">GMainContext</span></a> with <em class="parameter"><code>task</code></em>
|
|
2518
2518
|
's <a class="link" href="GAsyncResult.html#io-priority" title="I/O Priority">priority</a>, and sets <em class="parameter"><code>source</code></em>
|
|
2519
2519
|
's
|
|
2520
2520
|
callback to <em class="parameter"><code>callback</code></em>
|
|
@@ -2524,7 +2524,7 @@ callback to <em class="parameter"><code>callback</code></em>
|
|
|
2524
2524
|
until <em class="parameter"><code>source</code></em>
|
|
2525
2525
|
is destroyed.</p>
|
|
2526
2526
|
<div class="refsect3">
|
|
2527
|
-
<a name="
|
|
2527
|
+
<a name="g-task-attach-source.parameters"></a><h4>Parameters</h4>
|
|
2528
2528
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
|
2529
2529
|
<colgroup>
|
|
2530
2530
|
<col width="150px" class="parameters_name">
|
|
@@ -2556,18 +2556,18 @@ triggers</p></td>
|
|
|
2556
2556
|
<hr>
|
|
2557
2557
|
<div class="refsect2">
|
|
2558
2558
|
<a name="g-task-is-valid"></a><h3>g_task_is_valid ()</h3>
|
|
2559
|
-
<pre class="programlisting"><a href="../glib
|
|
2560
|
-
g_task_is_valid (<em class="parameter"><code><a href="../glib
|
|
2561
|
-
<em class="parameter"><code><a href="../glib
|
|
2559
|
+
<pre class="programlisting"><a href="../glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
|
|
2560
|
+
g_task_is_valid (<em class="parameter"><code><a href="../glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> result</code></em>,
|
|
2561
|
+
<em class="parameter"><code><a href="../glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> source_object</code></em>);</pre>
|
|
2562
2562
|
<p>Checks that <em class="parameter"><code>result</code></em>
|
|
2563
2563
|
is a <a class="link" href="GTask.html" title="GTask"><span class="type">GTask</span></a>, and that <em class="parameter"><code>source_object</code></em>
|
|
2564
2564
|
is its
|
|
2565
2565
|
source object (or that <em class="parameter"><code>source_object</code></em>
|
|
2566
|
-
is <a href="../glib
|
|
2566
|
+
is <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> and <em class="parameter"><code>result</code></em>
|
|
2567
2567
|
has no
|
|
2568
|
-
source object). This can be used in <a href="../glib
|
|
2568
|
+
source object). This can be used in <a href="../glib-Warnings-and-Assertions.html#g-return-if-fail"><code class="function">g_return_if_fail()</code></a> checks.</p>
|
|
2569
2569
|
<div class="refsect3">
|
|
2570
|
-
<a name="
|
|
2570
|
+
<a name="g-task-is-valid.parameters"></a><h4>Parameters</h4>
|
|
2571
2571
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
|
2572
2572
|
<colgroup>
|
|
2573
2573
|
<col width="150px" class="parameters_name">
|
|
@@ -2590,10 +2590,10 @@ expected to be associated with the task. </p></td>
|
|
|
2590
2590
|
</table></div>
|
|
2591
2591
|
</div>
|
|
2592
2592
|
<div class="refsect3">
|
|
2593
|
-
<a name="
|
|
2594
|
-
<p> <a href="../glib
|
|
2593
|
+
<a name="g-task-is-valid.returns"></a><h4>Returns</h4>
|
|
2594
|
+
<p> <a href="../glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if <em class="parameter"><code>result</code></em>
|
|
2595
2595
|
and <em class="parameter"><code>source_object</code></em>
|
|
2596
|
-
are valid, <a href="../glib
|
|
2596
|
+
are valid, <a href="../glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>
|
|
2597
2597
|
if not</p>
|
|
2598
2598
|
</div>
|
|
2599
2599
|
<p class="since">Since: <a class="link" href="api-index-2-36.html#api-index-2.36">2.36</a></p>
|
|
@@ -2612,13 +2612,13 @@ and its result.</p>
|
|
|
2612
2612
|
<a name="GTask.property-details"></a><h2>Property Details</h2>
|
|
2613
2613
|
<div class="refsect2">
|
|
2614
2614
|
<a name="GTask--completed"></a><h3>The <code class="literal">“completed”</code> property</h3>
|
|
2615
|
-
<pre class="programlisting"> “completed” <a href="../glib
|
|
2615
|
+
<pre class="programlisting"> “completed” <a href="../glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></pre>
|
|
2616
2616
|
<p>Whether the task has completed, meaning its callback (if set) has been
|
|
2617
2617
|
invoked. This can only happen after <a class="link" href="GTask.html#g-task-return-pointer" title="g_task_return_pointer ()"><code class="function">g_task_return_pointer()</code></a>,
|
|
2618
2618
|
<a class="link" href="GTask.html#g-task-return-error" title="g_task_return_error ()"><code class="function">g_task_return_error()</code></a> or one of the other return functions have been called
|
|
2619
2619
|
on the task.</p>
|
|
2620
|
-
<p>This property is guaranteed to change from <a href="../glib
|
|
2621
|
-
<p>The <a href="../gobject
|
|
2620
|
+
<p>This property is guaranteed to change from <a href="../glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> to <a href="../glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> exactly once.</p>
|
|
2621
|
+
<p>The <a href="../gobject-The-Base-Object-Type.html#GObject-notify"><span class="type">“notify”</span></a> signal for this change is emitted in the same main
|
|
2622
2622
|
context as the task’s callback, immediately after that callback is invoked.</p>
|
|
2623
2623
|
<p>Flags: Read</p>
|
|
2624
2624
|
<p>Default value: FALSE</p>
|
|
@@ -2631,6 +2631,6 @@ context as the task’s callback, immediately after that callback is invoked.</p
|
|
|
2631
2631
|
</div>
|
|
2632
2632
|
</div>
|
|
2633
2633
|
<div class="footer">
|
|
2634
|
-
<hr>Generated by GTK-Doc V1.
|
|
2634
|
+
<hr>Generated by GTK-Doc V1.25.1</div>
|
|
2635
2635
|
</body>
|
|
2636
2636
|
</html>
|