glib2 3.0.8-x86-mingw32 → 3.0.9-x86-mingw32
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/Rakefile +2 -2
- data/ext/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>
|